raysurfer 0.2.0 → 0.3.1

package/README.md

@@ -90,6 +90,33 @@ interface RaysurferAgentOptions {
 }
 ```
 
+## Snippet Retrieval Scope
+
+Control which snippets are retrieved using `publicSnips` and `snipsDesired`:
+
+```typescript
+import { RaySurfer } from "raysurfer";
+
+// Include both public and company snippets
+const client = new RaySurfer({
+  apiKey: "rs_...",
+  publicSnips: true,       // Include public/shared snippets
+  snipsDesired: "company", // Also include company-level snippets (Team/Enterprise)
+});
+
+// Enterprise: Retrieve client-specific snippets only
+const enterpriseClient = new RaySurfer({
+  apiKey: "rs_...",
+  snipsDesired: "client",  // Client workspace snippets (Enterprise only)
+});
+```
+
+| Configuration | Required Tier |
+|--------------|---------------|
+| `publicSnips: true` only | FREE (default) |
+| `snipsDesired: "company"` | TEAM or ENTERPRISE |
+| `snipsDesired: "client"` | ENTERPRISE only |
+
 ## API Reference
 
 ### RaySurfer Client

package/dist/client.d.ts

@@ -1,11 +1,22 @@
 /**
  * RaySurfer SDK client
  */
-import type { AgentReview, AgentVerdict, ExecutionState, FewShotExample, FileWritten, GetCodeFilesResponse, RetrieveBestResponse, RetrieveCodeBlockResponse, StoreCodeBlockResponse, StoreExecutionResponse, SubmitExecutionResultResponse, TaskPattern } from "./types";
+import type { AgentReview, AgentVerdict, ExecutionState, FewShotExample, FileWritten, GetCodeFilesResponse, RetrieveBestResponse, RetrieveCodeBlockResponse, SnipsDesired, StoreCodeBlockResponse, StoreExecutionResponse, SubmitExecutionResultResponse, TaskPattern } from "./types";
 export interface RaySurferOptions {
+    /** RaySurfer API key */
     apiKey?: string;
+    /** API base URL */
     baseUrl?: string;
+    /** Request timeout in milliseconds */
     timeout?: number;
+    /** Organization ID for dedicated namespace (team/enterprise tier) */
+    organizationId?: string;
+    /** Workspace ID for client-specific namespace (enterprise tier only) */
+    workspaceId?: string;
+    /** Whether to include public/shared snippets in retrieval (default: false) */
+    publicSnips?: boolean;
+    /** Scope of private snippets - "company" (Team/Enterprise) or "client" (Enterprise only) */
+    snipsDesired?: SnipsDesired;
 }
 export interface StoreCodeBlockParams {
     name: string;
@@ -57,6 +68,10 @@ export declare class RaySurfer {
     private apiKey?;
     private baseUrl;
     private timeout;
+    private organizationId?;
+    private workspaceId?;
+    private publicSnips;
+    private snipsDesired?;
     constructor(options?: RaySurferOptions);
     private request;
     /** Store a new code block */

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,17 +1,22 @@
 /**
- * RaySurfer TypeScript SDK
+ * RaySurfer TypeScript SDK - Drop-in replacement for Claude Agent SDK with caching.
  *
- * Store and retrieve code blocks for AI agents with semantic search
- * and verdict-aware scoring.
+ * Simply swap your import:
  *
- * Includes Claude Agent SDK integration via RaysurferClient.
+ *     // Before
+ *     import { query } from "@anthropic-ai/claude-agent-sdk";
+ *
+ *     // After
+ *     import { query } from "raysurfer";
+ *
+ * Everything else works exactly the same. Set RAYSURFER_API_KEY to enable caching.
  */
+export { query, ClaudeSDKClient, RaysurferClient, default as queryDefault, } from "./sdk-client";
+export type { QueryOptions, QueryParams, RaysurferAgentOptions, } from "./sdk-client";
 export { RaySurfer, default as RaySurferDefault } from "./client";
 export type { RaySurferOptions, StoreCodeBlockParams, StoreExecutionParams, RetrieveParams, GetCodeFilesParams, GetTaskPatternsParams, } from "./client";
-export { RaysurferClient } from "./sdk-client";
-export type { RaysurferAgentOptions } from "./sdk-client";
 export { ExecutionState, AgentVerdict } from "./types";
 export type { CodeBlock, ExecutionIO, AgentReview, ExecutionRecord, BestMatch, AlternativeCandidate, FewShotExample, TaskPattern, FileWritten, StoreCodeBlockResponse, StoreExecutionResponse, CodeBlockMatch, RetrieveCodeBlockResponse, RetrieveBestResponse, SubmitExecutionResultRequest, SubmitExecutionResultResponse, CodeFile, GetCodeFilesResponse, } from "./types";
 export { RaySurferError, APIError, AuthenticationError } from "./errors";
-export declare const VERSION = "0.2.0";
+export declare const VERSION = "0.3.1";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClE,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG1D,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvD,YAAY,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,EAC7B,QAAQ,EACR,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEzE,eAAO,MAAM,OAAO,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EACL,KAAK,EACL,eAAe,EACf,eAAe,EACf,OAAO,IAAI,YAAY,GACxB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,SAAS,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAClE,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvD,YAAY,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,eAAe,EACf,SAAS,EACT,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,EAC5B,6BAA6B,EAC7B,QAAQ,EACR,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEzE,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/index.js

@@ -20999,10 +20999,18 @@ class RaySurfer {
   apiKey;
   baseUrl;
   timeout;
+  organizationId;
+  workspaceId;
+  publicSnips;
+  snipsDesired;
   constructor(options = {}) {
     this.apiKey = options.apiKey;
     this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = options.timeout ?? 30000;
+    this.organizationId = options.organizationId;
+    this.workspaceId = options.workspaceId;
+    this.publicSnips = options.publicSnips ?? false;
+    this.snipsDesired = options.snipsDesired;
   }
   async request(method, path, body) {
     const headers = {
@@ -21011,6 +21019,18 @@ class RaySurfer {
     if (this.apiKey) {
       headers["Authorization"] = `Bearer ${this.apiKey}`;
     }
+    if (this.organizationId) {
+      headers["X-Raysurfer-Org-Id"] = this.organizationId;
+    }
+    if (this.workspaceId) {
+      headers["X-Raysurfer-Workspace-Id"] = this.workspaceId;
+    }
+    if (this.publicSnips) {
+      headers["X-Raysurfer-Public-Snips"] = "true";
+    }
+    if (this.snipsDesired) {
+      headers["X-Raysurfer-Snips-Desired"] = this.snipsDesired;
+    }
     const controller = new AbortController;
     const timeoutId = setTimeout(() => controller.abort(), this.timeout);
     try {
@@ -21225,196 +21245,121 @@ class RaySurfer {
   }
 }
 var client_default = RaySurfer;
-// src/sdk-client.ts
-import { mkdir, writeFile, rm, readdir, stat } from "node:fs/promises";
-import { homedir as homedir2 } from "node:os";
-import { join as join6 } from "node:path";
-var DEFAULT_SANDBOX_DIR = join6(homedir2(), ".raysurfer", "sandbox");
 
-class RaysurferClient {
-  options;
-  raysurfer;
-  prefetchedFiles = [];
-  currentQuery = null;
-  generatedFiles = [];
-  taskSucceeded = false;
-  constructor(options = {}) {
-    this.options = {
-      prefetchCount: options.prefetchCount ?? 5,
-      minVerdictScore: options.minVerdictScore ?? 0.3,
-      preferComplete: options.preferComplete ?? true,
-      sandboxDir: options.sandboxDir ?? DEFAULT_SANDBOX_DIR,
-      cleanupSandbox: options.cleanupSandbox ?? true,
-      cleanupOnError: options.cleanupOnError ?? false,
-      model: options.model ?? "claude-sonnet-4-5",
-      ...options
-    };
-    this.raysurfer = new RaySurfer({
-      apiKey: options.raysurferApiKey,
-      baseUrl: options.raysurferBaseUrl
+// src/sdk-client.ts
+var DEFAULT_RAYSURFER_URL = "https://web-production-3d338.up.railway.app";
+async function* query2(params) {
+  const { prompt, options = {} } = params;
+  const apiKey = process.env.RAYSURFER_API_KEY;
+  const baseUrl = process.env.RAYSURFER_BASE_URL || DEFAULT_RAYSURFER_URL;
+  const cacheEnabled = !!apiKey;
+  let raysurfer = null;
+  let cachedFiles = [];
+  const generatedFiles = [];
+  let taskSucceeded = false;
+  if (cacheEnabled) {
+    raysurfer = new RaySurfer({
+      apiKey,
+      baseUrl,
+      publicSnips: options.publicSnips,
+      snipsDesired: options.snipsDesired
     });
-  }
-  async* query(prompt) {
-    this.currentQuery = prompt;
-    this.generatedFiles = [];
-    this.taskSucceeded = false;
-    this.prefetchedFiles = await this.prefetchCodeFiles(prompt);
-    await this.downloadFilesToSandbox();
-    const systemPrompt = this.buildSystemPrompt();
-    let queryFn;
     try {
-      const sdk = await Promise.resolve().then(() => (init_sdk(), exports_sdk));
-      queryFn = sdk.query;
-    } catch {
-      throw new Error("Could not import @anthropic-ai/claude-agent-sdk. Install it with: npm install @anthropic-ai/claude-agent-sdk or bun add @anthropic-ai/claude-agent-sdk");
-    }
-    const response = queryFn({
-      prompt,
-      options: {
-        model: this.options.model,
-        workingDirectory: this.options.sandboxDir,
-        systemPrompt,
-        permissionMode: this.options.permissionMode,
-        maxBudgetUsd: this.options.maxBudgetUsd,
-        allowedTools: this.options.allowedTools,
-        disallowedTools: this.options.disallowedTools,
-        maxTurns: this.options.maxTurns,
-        env: this.options.env
-      }
-    });
-    for await (const message of response) {
-      const msg = message;
-      if (msg.type === "assistant" && Array.isArray(msg.content)) {
-        for (const block of msg.content) {
-          if (block.type === "tool_use" && block.name === "Write") {
-            const input = block.input;
-            if (input?.file_path && input?.content) {
-              this.generatedFiles.push({
-                path: input.file_path,
-                content: input.content
-              });
-            }
+      const response2 = await raysurfer.getCodeFiles({
+        task: prompt,
+        topK: 5,
+        minVerdictScore: 0.3,
+        preferComplete: true
+      });
+      cachedFiles = response2.files;
+    } catch {}
+  }
+  const augmentedPrompt = buildSystemPrompt(options.systemPrompt, cachedFiles);
+  let sdkQuery;
+  try {
+    const sdk = await Promise.resolve().then(() => (init_sdk(), exports_sdk));
+    sdkQuery = sdk.query;
+  } catch {
+    throw new Error("Could not import @anthropic-ai/claude-agent-sdk. Install it with: npm install @anthropic-ai/claude-agent-sdk");
+  }
+  const response = sdkQuery({
+    prompt,
+    options: {
+      ...options,
+      systemPrompt: augmentedPrompt
+    }
+  });
+  for await (const message of response) {
+    const msg = message;
+    if (msg.type === "assistant" && Array.isArray(msg.content)) {
+      for (const block of msg.content) {
+        if (block.type === "tool_use" && block.name === "Write") {
+          const input = block.input;
+          if (input?.file_path && input?.content) {
+            generatedFiles.push({
+              path: input.file_path,
+              content: input.content
+            });
           }
         }
       }
-      if (msg.type === "result") {
-        const subtype = msg.subtype;
-        if (subtype === "success") {
-          this.taskSucceeded = true;
-        }
-      }
-      yield message;
     }
-    if (this.taskSucceeded && this.generatedFiles.length > 0) {
-      await this.storeGeneratedCode();
+    if (msg.type === "result" && msg.subtype === "success") {
+      taskSucceeded = true;
     }
-    const shouldCleanup = this.options.cleanupSandbox && (this.taskSucceeded || this.options.cleanupOnError);
-    if (shouldCleanup) {
-      await this.cleanupSandbox();
-    }
-  }
-  get files() {
-    return this.prefetchedFiles;
-  }
-  get sandbox() {
-    return this.options.sandboxDir;
-  }
-  async cleanup() {
-    await this.cleanupSandbox();
+    yield message;
   }
-  async prefetchCodeFiles(task) {
+  if (cacheEnabled && raysurfer && taskSucceeded && generatedFiles.length > 0) {
     try {
-      const response = await this.raysurfer.getCodeFiles({
-        task,
-        topK: this.options.prefetchCount,
-        minVerdictScore: this.options.minVerdictScore,
-        preferComplete: this.options.preferComplete
-      });
-      return response.files;
-    } catch {
-      return [];
-    }
+      await raysurfer.submitExecutionResult(prompt, generatedFiles, true);
+    } catch {}
   }
-  async downloadFilesToSandbox() {
-    await mkdir(this.options.sandboxDir, { recursive: true });
-    for (const codeFile of this.prefetchedFiles) {
-      const filepath = join6(this.options.sandboxDir, codeFile.filename);
-      await writeFile(filepath, codeFile.source, "utf-8");
-    }
+}
+
+class ClaudeSDKClient {
+  options;
+  constructor(options = {}) {
+    this.options = options;
   }
-  buildSystemPrompt() {
-    const basePrompt = this.options.systemPrompt ?? "";
-    if (this.prefetchedFiles.length === 0) {
-      return basePrompt;
-    }
-    return basePrompt + this.formatCodeSnippets();
+  async* query(prompt) {
+    yield* query2({ prompt, options: this.options });
   }
-  formatCodeSnippets() {
-    let snippets = `
-
-## Available Code Snippets
+}
+function buildSystemPrompt(basePrompt, files) {
+  const base = basePrompt ?? "";
+  if (files.length === 0)
+    return base;
+  return base + formatCodeSnippets(files);
+}
+function formatCodeSnippets(files) {
+  let snippets = `
 
-`;
-    snippets += "The following pre-validated code files are available in your working directory. ";
-    snippets += `You can execute them directly using the Bash tool.
+## Cached Code (from Raysurfer)
 
 `;
-    for (const f of this.prefetchedFiles) {
-      snippets += `### ${f.filename}
+  snippets += "The following pre-validated code is available for this task. ";
+  snippets += `Use it directly or adapt it as needed.
 
 `;
-      snippets += `**Description**: ${f.description}
-
+  for (const f of files) {
+    snippets += `### ${f.filename}
 `;
-      snippets += `**Entrypoint**: \`${f.entrypoint}\`
-
+    snippets += `**Description**: ${f.description}
 `;
-      snippets += `**Verdict score**: ${Math.round(f.verdictScore * 100)}% (${f.thumbsUp} thumbs up)
-
+    snippets += `**Entrypoint**: \`${f.entrypoint}\`
 `;
-      if (f.dependencies.length > 0) {
-        snippets += `**Dependencies**: ${f.dependencies.join(", ")}
+    snippets += `**Confidence**: ${Math.round(f.verdictScore * 100)}%
 
 `;
-      }
-      snippets += `\`\`\`${f.language}
+    snippets += `\`\`\`${f.language}
 ${f.source}
 \`\`\`
 
 `;
-      snippets += `---
-
-`;
-    }
-    return snippets;
-  }
-  async storeGeneratedCode() {
-    if (!this.currentQuery)
-      return;
-    try {
-      const result = await this.raysurfer.submitExecutionResult(this.currentQuery, this.generatedFiles, this.taskSucceeded);
-      if (result.codeBlocksStored > 0) {
-        console.log(`Raysurfer: stored ${result.codeBlocksStored} code blocks`);
-      }
-    } catch (error2) {
-      console.warn("Raysurfer: failed to submit execution result:", error2);
-    }
-  }
-  async cleanupSandbox() {
-    try {
-      const items = await readdir(this.options.sandboxDir);
-      for (const item of items) {
-        const itemPath = join6(this.options.sandboxDir, item);
-        const stats = await stat(itemPath);
-        if (stats.isDirectory()) {
-          await rm(itemPath, { recursive: true });
-        } else {
-          await rm(itemPath);
-        }
-      }
-    } catch {}
   }
+  return snippets;
 }
+var sdk_client_default = query2;
 // src/types.ts
 var ExecutionState;
 ((ExecutionState2) => {
@@ -21431,14 +21376,17 @@ var AgentVerdict;
 })(AgentVerdict ||= {});
 
 // src/index.ts
-var VERSION = "0.2.0";
+var VERSION = "0.3.1";
 export {
+  sdk_client_default as queryDefault,
+  query2 as query,
   VERSION,
-  RaysurferClient,
+  ClaudeSDKClient as RaysurferClient,
   RaySurferError,
   client_default as RaySurferDefault,
   RaySurfer,
   ExecutionState,
+  ClaudeSDKClient,
   AuthenticationError,
   AgentVerdict,
   APIError

package/dist/sdk-client.d.ts

@@ -1,24 +1,19 @@
 /**
- * RaysurferClient - Drop-in enhancement for Claude Agent SDK with code block caching.
+ * Drop-in replacement for Claude Agent SDK with automatic code caching.
  *
- * This client wraps the Claude Agent SDK query function to:
- * 1. Pre-fetch relevant code blocks from the Raysurfer backend
- * 2. Download them as files to a sandbox directory
- * 3. Inject file contents into the system prompt
- * 4. Let the agent use standard Bash tool to execute
- * 5. After task completion, store generated code back to the cache
+ * Simply swap your import:
+ *
+ *     // Before
+ *     import { query } from "@anthropic-ai/claude-agent-sdk";
+ *
+ *     // After
+ *     import { query } from "raysurfer";
+ *
+ * Everything else works exactly the same. Set RAYSURFER_API_KEY to enable caching.
  */
-import type { CodeFile } from "./types";
-/** Options for RaysurferClient */
-export interface RaysurferAgentOptions {
-    raysurferApiKey?: string;
-    raysurferBaseUrl?: string;
-    prefetchCount?: number;
-    minVerdictScore?: number;
-    preferComplete?: boolean;
-    sandboxDir?: string;
-    cleanupSandbox?: boolean;
-    cleanupOnError?: boolean;
+import type { SnipsDesired } from "./types";
+/** Options for the query function - matches Claude Agent SDK */
+export interface QueryOptions {
     model?: string;
     workingDirectory?: string;
     systemPrompt?: string;
@@ -28,54 +23,46 @@ export interface RaysurferAgentOptions {
     disallowedTools?: string[];
     maxTurns?: number;
     env?: Record<string, string>;
+    /** Whether to include public/shared snippets in retrieval (default: false) */
+    publicSnips?: boolean;
+    /** Scope of private snippets - "company" (Team/Enterprise) or "client" (Enterprise only) */
+    snipsDesired?: SnipsDesired;
 }
+/** Query parameters - matches Claude Agent SDK */
+export interface QueryParams {
+    prompt: string;
+    options?: QueryOptions;
+}
+/**
+ * Drop-in replacement for Claude Agent SDK's query function with automatic caching.
+ *
+ * Usage is identical to the original:
+ *
+ *     import { query } from "raysurfer";
+ *
+ *     for await (const message of query({ prompt: "Hello" })) {
+ *       console.log(message);
+ *     }
+ *
+ * Set RAYSURFER_API_KEY environment variable to enable caching.
+ */
+export declare function query(params: QueryParams): AsyncGenerator<unknown>;
 /**
- * RaysurferClient - wraps Claude Agent SDK with code block caching
+ * ClaudeSDKClient - Class-based drop-in replacement.
  *
- * Usage:
- * ```typescript
- * const client = new RaysurferClient({
- *   raysurferApiKey: "rs_...",
- *   model: "claude-sonnet-4-5",
- *   systemPrompt: "You are a helpful assistant.",
- * });
+ * For users who prefer the Python-style class interface:
  *
- * for await (const message of client.query("Fetch data from the GitHub API")) {
- *   console.log(message);
- * }
- * ```
+ *     const client = new ClaudeSDKClient(options);
+ *     for await (const msg of client.query("Hello")) {
+ *       console.log(msg);
+ *     }
  */
-export declare class RaysurferClient {
+export declare class ClaudeSDKClient {
     private options;
-    private raysurfer;
-    private prefetchedFiles;
-    private currentQuery;
-    private generatedFiles;
-    private taskSucceeded;
-    constructor(options?: RaysurferAgentOptions);
-    /**
-     * Query Claude with pre-fetched code files from Raysurfer.
-     *
-     * This method:
-     * 1. Pre-fetches relevant code files from Raysurfer backend
-     * 2. Downloads files to sandbox directory
-     * 3. Injects file contents into system prompt
-     * 4. Delegates to Claude Agent SDK
-     * 5. Stores generated code back to cache on success
-     */
+    constructor(options?: QueryOptions);
     query(prompt: string): AsyncGenerator<unknown>;
-    /** Get the list of pre-fetched code files */
-    get files(): CodeFile[];
-    /** Get the sandbox directory path */
-    get sandbox(): string;
-    /** Manually clean up the sandbox directory */
-    cleanup(): Promise<void>;
-    private prefetchCodeFiles;
-    private downloadFilesToSandbox;
-    private buildSystemPrompt;
-    private formatCodeSnippets;
-    private storeGeneratedCode;
-    private cleanupSandbox;
 }
-export default RaysurferClient;
+export { ClaudeSDKClient as RaysurferClient };
+export type { QueryOptions as RaysurferAgentOptions };
+export default query;
 //# sourceMappingURL=sdk-client.d.ts.map

package/dist/sdk-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-client.d.ts","sourceRoot":"","sources":["../src/sdk-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,SAAS,CAAC;AAIrD,kCAAkC;AAClC,MAAM,WAAW,qBAAqB;IAEpC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC;IAGzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,mBAAmB,CAAC;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAYS;IAExB,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,aAAa,CAAS;gBAElB,OAAO,GAAE,qBAA0B;IAkB/C;;;;;;;;;OASG;IACI,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC;IAyFrD,6CAA6C;IAC7C,IAAI,KAAK,IAAI,QAAQ,EAAE,CAEtB;IAED,qCAAqC;IACrC,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,8CAA8C;IACxC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;YAQhB,iBAAiB;YAejB,sBAAsB;IAWpC,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,kBAAkB;YAuBZ,kBAAkB;YAiBlB,cAAc;CAgB7B;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"sdk-client.d.ts","sourceRoot":"","sources":["../src/sdk-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAyB,YAAY,EAAE,MAAM,SAAS,CAAC;AAInE,gEAAgE;AAChE,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,SAAS,GAAG,aAAa,GAAG,MAAM,GAAG,mBAAmB,CAAC;IAC1E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,8EAA8E;IAC9E,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAuB,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CA6FzE;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAe;gBAElB,OAAO,GAAE,YAAiB;IAI/B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC;CAGtD;AAGD,OAAO,EAAE,eAAe,IAAI,eAAe,EAAE,CAAC;AAC9C,YAAY,EAAE,YAAY,IAAI,qBAAqB,EAAE,CAAC;AAgCtD,eAAe,KAAK,CAAC"}

package/dist/types.d.ts

@@ -14,6 +14,8 @@ export declare enum AgentVerdict {
     THUMBS_DOWN = "thumbs_down",
     PENDING = "pending"
 }
+/** Scope of private snippets for retrieval */
+export type SnipsDesired = "company" | "client";
 /** A stored code block with metadata for semantic retrieval */
 export interface CodeBlock {
     id: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "raysurfer",
-  "version": "0.2.0",
-  "description": "TypeScript SDK for RaySurfer - code block caching and retrieval for AI agents with Claude Agent SDK integration",
+  "version": "0.3.1",
+  "description": "Drop-in replacement for Claude Agent SDK with automatic code caching - just swap your import",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -45,14 +45,9 @@
   "bugs": {
     "url": "https://github.com/raymondxu/raysurfer-ts/issues"
   },
-  "peerDependencies": {
+  "dependencies": {
     "@anthropic-ai/claude-agent-sdk": ">=0.1.0"
   },
-  "peerDependenciesMeta": {
-    "@anthropic-ai/claude-agent-sdk": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@types/bun": "^1.3.6",
     "@types/node": "^22.0.0",