raysurfer 0.6.1 → 0.7.0

package/README.md

@@ -2,8 +2,11 @@
 
 [Website](https://raysurfer.com) · [Docs](https://docs.raysurfer.com) · [Dashboard](https://raysurfer.com/dashboard/api-keys)
 
-LLM output caching for AI agents. Retrieve proven code instead of
-regenerating it.
+<!-- Old: LLM output caching for AI agents. Retrieve proven code instead of regenerating it. -->
+<!-- Old: Code reputation layer for AI agents. Let agents re-use generated code vs running 30 serial tools or generating code per execution. -->
+AI Maintained Skills for Vertical Agents. Re-use verified code
+from prior runs rather than serial tool calls or generating code
+per execution.
 
 ## Installation
 
@@ -239,7 +242,7 @@ import { query } from "raysurfer";
 for await (const message of query({
   prompt: "Fetch data from GitHub API",
   options: {
-    model: "claude-opus-4-6-20260210",
+    model: "claude-opus-4-6",
     systemPrompt: "You are a helpful assistant.",
   },
 })) {
@@ -265,7 +268,7 @@ import {
 import { ClaudeSDKClient } from "raysurfer";
 
 const client = new ClaudeSDKClient({
-  model: "claude-opus-4-6-20260210",
+  model: "claude-opus-4-6",
   systemPrompt: "You are a helpful assistant.",
 });
 
@@ -352,6 +355,62 @@ const client = new ClaudeSDKClient({ publicSnips: true });
 const rs = new RaySurfer({ apiKey: "...", publicSnips: true });
 ```
 
+## Programmatic Tool Calling
+
+Register local tools and let the server generate + execute code
+that calls them:
+
+```typescript
+import { RaySurfer } from "raysurfer";
+
+const rs = new RaySurfer({ apiKey: "your_api_key" });
+
+rs.tool("add", "Add two numbers together", { a: "integer", b: "integer" },
+  async (args) => String(Number(args.a) + Number(args.b))
+);
+
+rs.tool("multiply", "Multiply two numbers together", { a: "integer", b: "integer" },
+  async (args) => String(Number(args.a) * Number(args.b))
+);
+
+const result = await rs.execute(
+  "Add 5 and 3, then multiply the result by 2"
+);
+console.log(result.result);     // "16"
+console.log(result.toolCalls);  // [{toolName: 'add', ...}, ...]
+console.log(result.cacheHit);   // true on subsequent runs
+```
+
+### How It Works
+
+1. SDK connects a WebSocket to the server for tool call routing
+2. Server generates Python code (or reuses reference code from a
+   similar prior run)
+3. Code runs in a sandboxed environment — tool calls are routed
+   back to your local functions via WebSocket
+4. Results are returned with full tool call history
+
+### Execute Options
+
+```typescript
+const result = await rs.execute("Your task description", {
+  timeout: 300000,        // Max time in ms (default 300000)
+  forceRegenerate: false, // Skip cache (default false)
+});
+```
+
+### ExecuteResult Fields
+
+| Field         | Type               | Description                      |
+| ------------- | ------------------ | -------------------------------- |
+| `executionId` | `string`           | Unique execution identifier      |
+| `result`      | `string \| null`   | Stdout output from the script    |
+| `exitCode`    | `number`           | Process exit code (0 = success)  |
+| `durationMs`  | `number`           | Total execution time             |
+| `cacheHit`    | `boolean`          | Whether reference code was found |
+| `error`       | `string \| null`   | Error message if exitCode != 0   |
+| `toolCalls`   | `ToolCallRecord[]` | All tool calls made              |
+
 ## License
 
 MIT

package/package.json

@@ -1,7 +1,9 @@
 {
   "name": "raysurfer",
-  "version": "0.6.1",
-  "description": "Semantic code caching for LLM agents",
+  "version": "0.7.0",
+  "_description_old": "Semantic code caching for LLM agents",
+  "_description_old2": "Code reputation layer for AI agents",
+  "description": "AI maintained skills for vertical agents",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",

package/dist/client.d.ts

@@ -1,236 +0,0 @@
-/**
- * RaySurfer SDK client
- */
-export declare const VERSION = "0.5.10";
-import type { AgentReview, AgentVerdict, AutoReviewParams, AutoReviewResponse, BrowsePublicParams, BrowsePublicResponse, BulkExecutionResultResponse, ExecutionState, FewShotExample, FileWritten, GetCodeFilesResponse, GetExecutionsParams, LogFile, RetrieveBestResponse, RetrieveCodeBlockResponse, RetrieveExecutionsResponse, SearchPublicParams, SearchPublicResponse, SearchResponse, 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;
-    /** Scope of private snippets - "company" (Team/Enterprise) or "client" (Enterprise only) */
-    snipsDesired?: SnipsDesired;
-    /** Include community public snippets (from github-snips) in retrieval results */
-    publicSnips?: boolean;
-}
-export interface StoreCodeBlockParams {
-    name: string;
-    source: string;
-    entrypoint: string;
-    language: string;
-    description?: string;
-    inputSchema?: Record<string, unknown>;
-    outputSchema?: Record<string, unknown>;
-    languageVersion?: string;
-    dependencies?: string[];
-    tags?: string[];
-    capabilities?: string[];
-    exampleQueries?: string[];
-}
-export interface StoreExecutionParams {
-    codeBlockId: string;
-    triggeringTask: string;
-    inputData: Record<string, unknown>;
-    outputData: unknown;
-    executionState?: ExecutionState;
-    durationMs?: number;
-    errorMessage?: string;
-    errorType?: string;
-    verdict?: AgentVerdict;
-    review?: AgentReview;
-}
-export interface RetrieveParams {
-    task: string;
-    topK?: number;
-    minVerdictScore?: number;
-}
-export interface GetCodeFilesParams {
-    task: string;
-    topK?: number;
-    minVerdictScore?: number;
-    preferComplete?: boolean;
-    /** Directory path where files will be written (default: .raysurfer_code). Used to generate full paths in addToLlmPrompt. */
-    cacheDir?: string;
-}
-export interface GetTaskPatternsParams {
-    task?: string;
-    codeBlockId?: string;
-    minThumbsUp?: number;
-    topK?: number;
-}
-export interface SearchParams {
-    task: string;
-    topK?: number;
-    minVerdictScore?: number;
-    preferComplete?: boolean;
-    inputSchema?: Record<string, unknown>;
-    /** Override client-level workspaceId for this request */
-    workspaceId?: string;
-}
-/**
- * Async client for RaySurfer API
- */
-export declare class RaySurfer {
-    private apiKey?;
-    private baseUrl;
-    private timeout;
-    private organizationId?;
-    private workspaceId?;
-    private snipsDesired?;
-    private publicSnips?;
-    constructor(options?: RaySurferOptions);
-    private request;
-    /** Build header overrides for per-request workspaceId */
-    private workspaceHeaders;
-    /** Store a new code block */
-    storeCodeBlock(params: StoreCodeBlockParams): Promise<StoreCodeBlockResponse>;
-    /** Store an execution record */
-    storeExecution(params: StoreExecutionParams): Promise<StoreExecutionResponse>;
-    /**
-     * Upload a single code file from an execution result.
-     *
-     * This is the simplified API for agent integrations. Just send:
-     * - The task that was executed
-     * - The file that was written during execution
-     * - Whether the task succeeded
-     * - (Optional) Cached code blocks that were retrieved and used
-     *
-     * Backend handles: entrypoint detection, tag extraction, language detection,
-     * deduplication, quality checks, storage, AND voting for cached code blocks.
-     *
-     * For uploading multiple files at once, use uploadBulkCodeSnips().
-     */
-    uploadNewCodeSnip(taskOrOptions: string | {
-        task: string;
-        fileWritten: FileWritten;
-        succeeded: boolean;
-        cachedCodeBlocks?: Array<{
-            codeBlockId: string;
-            filename: string;
-            description: string;
-        }>;
-        useRaysurferAiVoting?: boolean;
-        userVote?: number;
-        executionLogs?: string;
-        runUrl?: string;
-        workspaceId?: string;
-        dependencies?: Record<string, string>;
-        public?: boolean;
-        voteSource?: "ai" | "human";
-        voteCount?: number;
-    }, fileWritten?: FileWritten, succeeded?: boolean, cachedCodeBlocks?: Array<{
-        codeBlockId: string;
-        filename: string;
-        description: string;
-    }>, useRaysurferAiVoting?: boolean, userVote?: number, executionLogs?: string, runUrl?: string, workspaceId?: string, dependencies?: Record<string, string>, voteSource?: "ai" | "human", voteCount?: number): Promise<SubmitExecutionResultResponse>;
-    /** Backwards-compatible alias. */
-    uploadNewCodeSnips: (taskOrOptions: string | {
-        task: string;
-        fileWritten: FileWritten;
-        succeeded: boolean;
-        cachedCodeBlocks?: Array<{
-            codeBlockId: string;
-            filename: string;
-            description: string;
-        }>;
-        useRaysurferAiVoting?: boolean;
-        userVote?: number;
-        executionLogs?: string;
-        runUrl?: string;
-        workspaceId?: string;
-        dependencies?: Record<string, string>;
-        public?: boolean;
-        voteSource?: "ai" | "human";
-        voteCount?: number;
-    }, fileWritten?: FileWritten, succeeded?: boolean, cachedCodeBlocks?: Array<{
-        codeBlockId: string;
-        filename: string;
-        description: string;
-    }>, useRaysurferAiVoting?: boolean, userVote?: number, executionLogs?: string, runUrl?: string, workspaceId?: string, dependencies?: Record<string, string>, voteSource?: "ai" | "human", voteCount?: number) => Promise<SubmitExecutionResultResponse>;
-    /**
-     * Bulk upload code files, prompts, and logs for sandboxed grading.
-     *
-     * The backend runs a grader that votes thumbs up/down for each code file.
-     *
-     * Supports both options object (new) and positional arguments (legacy):
-     * - Options: `uploadBulkCodeSnips({ prompts, filesWritten, logFiles, ... })`
-     * - Legacy: `uploadBulkCodeSnips(prompts, filesWritten, logFiles, ...)`
-     */
-    uploadBulkCodeSnips(promptsOrOptions: string[] | {
-        prompts: string[];
-        filesWritten: FileWritten[];
-        logFiles?: Array<LogFile | {
-            path: string;
-            content: string | Buffer;
-            encoding?: "utf-8" | "base64";
-            contentType?: string;
-        }>;
-        useRaysurferAiVoting?: boolean;
-        userVotes?: Record<string, number>;
-        workspaceId?: string;
-        voteSource?: "ai" | "human";
-        voteCount?: number;
-    }, filesWritten?: FileWritten[], logFiles?: Array<LogFile | {
-        path: string;
-        content: string | Buffer;
-        encoding?: "utf-8" | "base64";
-        contentType?: string;
-    }>, useRaysurferAiVoting?: boolean, userVotes?: Record<string, number>, workspaceId?: string, voteSource?: "ai" | "human", voteCount?: number): Promise<BulkExecutionResultResponse>;
-    search(params: SearchParams): Promise<SearchResponse>;
-    /** Get cached code snippets for a task (semantic search) */
-    getCodeSnips(params: RetrieveParams): Promise<RetrieveCodeBlockResponse>;
-    /** Get the single best code block for a task using verdict-aware scoring */
-    retrieveBest(params: RetrieveParams): Promise<RetrieveBestResponse>;
-    /** Retrieve few-shot examples for code generation */
-    getFewShotExamples(task: string, k?: number): Promise<FewShotExample[]>;
-    /** Retrieve proven task->code mappings */
-    getTaskPatterns(params: GetTaskPatternsParams): Promise<TaskPattern[]>;
-    getCodeFiles(params: GetCodeFilesParams): Promise<GetCodeFilesResponse>;
-    /**
-     * Format a prompt string listing all retrieved code files.
-     * @internal
-     */
-    private formatLlmPrompt;
-    /**
-     * Get an auto-generated review using Claude Opus 4.6.
-     * Useful for programmatically reviewing execution results.
-     */
-    autoReview(params: AutoReviewParams): Promise<AutoReviewResponse>;
-    /**
-     * Retrieve execution records by code block ID, task, or verdict.
-     */
-    getExecutions(params?: GetExecutionsParams): Promise<RetrieveExecutionsResponse>;
-    /**
-     * Vote on whether a cached code snippet was useful for a task.
-     *
-     * This triggers background voting on the backend to assess whether
-     * the cached code actually helped complete the task successfully.
-     * The call returns immediately - voting happens asynchronously.
-     */
-    voteCodeSnip(params: {
-        task: string;
-        codeBlockId: string;
-        codeBlockName: string;
-        codeBlockDescription: string;
-        succeeded: boolean;
-    }): Promise<{
-        success: boolean;
-        votePending: boolean;
-        message: string;
-    }>;
-    /** Browse community public snippets without authentication. */
-    browsePublic(params?: BrowsePublicParams): Promise<BrowsePublicResponse>;
-    /** Search community public snippets by keyword without authentication. */
-    searchPublic(params: SearchPublicParams): Promise<SearchPublicResponse>;
-    submitExecutionResult(task: string, fileWritten: FileWritten, succeeded: boolean): Promise<SubmitExecutionResultResponse>;
-    retrieve(params: RetrieveParams): Promise<RetrieveCodeBlockResponse>;
-    private parseCodeBlock;
-}
-export default RaySurfer;
-//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/errors.d.ts

@@ -1,32 +0,0 @@
-/**
- * RaySurfer SDK errors
- */
-/** Base error for RaySurfer SDK */
-export declare class RaySurferError extends Error {
-    constructor(message: string);
-}
-/** API returned an error response */
-export declare class APIError extends RaySurferError {
-    statusCode?: number;
-    constructor(message: string, statusCode?: number);
-}
-/** Authentication failed */
-export declare class AuthenticationError extends RaySurferError {
-    constructor(message?: string);
-}
-/** Cache backend is unreachable */
-export declare class CacheUnavailableError extends RaySurferError {
-    statusCode: number;
-    constructor(message?: string, statusCode?: number);
-}
-/** Rate limit exceeded */
-export declare class RateLimitError extends RaySurferError {
-    retryAfter?: number;
-    constructor(message?: string, retryAfter?: number);
-}
-/** Validation failed */
-export declare class ValidationError extends RaySurferError {
-    field?: string;
-    constructor(message?: string, field?: string);
-}
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,mCAAmC;AACnC,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI5B;AAED,qCAAqC;AACrC,qBAAa,QAAS,SAAQ,cAAc;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAKjD;AAED,4BAA4B;AAC5B,qBAAa,mBAAoB,SAAQ,cAAc;gBACzC,OAAO,GAAE,MAA0B;CAIhD;AAED,mCAAmC;AACnC,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,UAAU,EAAE,MAAM,CAAC;gBAGjB,OAAO,GAAE,MAAuC,EAChD,UAAU,GAAE,MAAY;CAM3B;AAED,0BAA0B;AAC1B,qBAAa,cAAe,SAAQ,cAAc;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;gBAER,OAAO,GAAE,MAA8B,EAAE,UAAU,CAAC,EAAE,MAAM;CAKzE;AAED,wBAAwB;AACxB,qBAAa,eAAgB,SAAQ,cAAc;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEH,OAAO,GAAE,MAA4B,EAAE,KAAK,CAAC,EAAE,MAAM;CAKlE"}

package/dist/index.d.ts

@@ -1,23 +0,0 @@
-/**
- * RaySurfer TypeScript SDK - Drop-in replacement for Claude Agent SDK with caching.
- *
- * 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.
- */
-export type { GetCodeFilesParams, GetTaskPatternsParams, RaySurferOptions, RetrieveParams, SearchParams, StoreCodeBlockParams, StoreExecutionParams, } from "./client";
-export { default as RaySurferDefault, RaySurfer, VERSION } from "./client";
-export { APIError, AuthenticationError, CacheUnavailableError, RateLimitError, RaySurferError, ValidationError, } from "./errors";
-export type { QueryOptions, QueryParams, RaysurferAgentOptions, RaysurferExtras, RaysurferQueryOptions, } from "./sdk-client";
-export { ClaudeSDKClient, default as queryDefault, query, RaysurferClient, } from "./sdk-client";
-export type { AgentReview, AlternativeCandidate, BestMatch, BrowsePublicParams, BrowsePublicResponse, BulkExecutionResultRequest, BulkExecutionResultResponse, CodeBlock, CodeBlockMatch, CodeFile, ExecutionIO, ExecutionRecord, FewShotExample, FileWritten, GetCodeFilesResponse, LogFile, PublicSnippet, RetrieveBestResponse, RetrieveCodeBlockResponse, RetrieveExecutionsResponse, SearchMatch, SearchPublicParams, SearchPublicResponse, SearchResponse, StoreCodeBlockResponse, StoreExecutionResponse, SubmitExecutionResultRequest, SubmitExecutionResultResponse, TaskPattern, UploadBulkCodeSnipsOptions, UploadNewCodeSnipOptions, VoteCodeSnipParams, VoteCodeSnipResponse, } from "./types";
-export { AgentVerdict, ExecutionState } from "./types";
-export type { AccountInfo, AgentDefinition, AgentMcpServerSpec, AnyZodRawShape, ApiKeySource, AsyncHookJSONOutput, BaseHookInput, BaseOutputFormat, CanUseTool, ConfigScope, ExitReason, HookCallback, HookCallbackMatcher, HookEvent, HookInput, HookJSONOutput, InferShape, JsonSchemaOutputFormat, McpHttpServerConfig, McpSdkServerConfig, McpSdkServerConfigWithInstance, McpServerConfig, McpServerConfigForProcessTransport, McpServerStatus, McpSetServersResult, McpSSEServerConfig, McpStdioServerConfig, ModelInfo, ModelUsage, NonNullableUsage, NotificationHookInput, NotificationHookSpecificOutput, Options, OutputFormat, OutputFormatType, PermissionBehavior, PermissionMode, PermissionRequestHookInput, PermissionRequestHookSpecificOutput, PermissionResult, PermissionRuleValue, PermissionUpdate, PermissionUpdateDestination, PostToolUseFailureHookInput, PostToolUseFailureHookSpecificOutput, PostToolUseHookInput, PostToolUseHookSpecificOutput, PreCompactHookInput, PreToolUseHookInput, PreToolUseHookSpecificOutput, Query, RewindFilesResult, SandboxIgnoreViolations, SandboxNetworkConfig, SandboxSettings, SDKAssistantMessage, SDKAssistantMessageError, SDKAuthStatusMessage, SDKCompactBoundaryMessage, SDKHookProgressMessage, SDKHookResponseMessage, SDKHookStartedMessage, SDKMessage, SDKPartialAssistantMessage, SDKPermissionDenial, SDKResultError, SDKResultMessage, SDKResultSuccess, SDKStatus, SDKStatusMessage, SDKSystemMessage, SDKTaskNotificationMessage, SDKToolProgressMessage, SDKToolUseSummaryMessage, SDKUserMessage, SDKUserMessageReplay, SdkBeta, SdkMcpToolDefinition, SdkPluginConfig, SessionEndHookInput, SessionStartHookInput, SessionStartHookSpecificOutput, SettingSource, SetupHookInput, SetupHookSpecificOutput, SlashCommand, SpawnedProcess, SpawnOptions, StopHookInput, SubagentStartHookInput, SubagentStartHookSpecificOutput, SubagentStopHookInput, SyncHookJSONOutput, UserPromptSubmitHookInput, UserPromptSubmitHookSpecificOutput, } from "@anthropic-ai/claude-agent-sdk";
-export { AbortError, createSdkMcpServer, EXIT_REASONS, HOOK_EVENTS, tool, } from "@anthropic-ai/claude-agent-sdk";
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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