raysurfer 0.7.1 → 0.7.3

package/dist/client.d.ts

@@ -0,0 +1,226 @@
+/**
+ * RaySurfer SDK client
+ */
+export declare const VERSION = "0.7.3";
+import type { AgentReview, AgentVerdict, AutoReviewParams, AutoReviewResponse, BrowsePublicParams, BrowsePublicResponse, BulkExecutionResultResponse, ExecuteOptions, ExecuteResult, ExecutionState, FewShotExample, FileWritten, GetCodeFilesResponse, GetExecutionsParams, JsonValue, LogFile, RetrieveBestResponse, RetrieveCodeBlockResponse, RetrieveExecutionsResponse, SearchPublicParams, SearchPublicResponse, SearchResponse, SnipsDesired, StoreCodeBlockResponse, StoreExecutionResponse, SubmitExecutionResultResponse, TaskPattern, ToolCallback } 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, JsonValue>;
+    outputSchema?: Record<string, JsonValue>;
+    languageVersion?: string;
+    dependencies?: string[];
+    tags?: string[];
+    capabilities?: string[];
+    exampleQueries?: string[];
+}
+export interface StoreExecutionParams {
+    codeBlockId: string;
+    triggeringTask: string;
+    inputData: Record<string, JsonValue>;
+    outputData: JsonValue;
+    executionState?: ExecutionState;
+    durationMs?: number;
+    errorMessage?: string;
+    errorType?: string;
+    verdict?: AgentVerdict;
+    review?: AgentReview;
+}
+export interface RetrieveParams {
+    task: string;
+    topK?: number;
+    minVerdictScore?: number;
+}
+interface UploadNewCodeSnipCompatOptions {
+    task: string;
+    fileWritten?: FileWritten;
+    filesWritten?: FileWritten[];
+    succeeded: boolean;
+    cachedCodeBlocks?: Array<{
+        codeBlockId: string;
+        filename: string;
+        description: string;
+    }>;
+    useRaysurferAiVoting?: boolean;
+    autoVote?: boolean;
+    userVote?: number;
+    executionLogs?: string;
+    runUrl?: string;
+    workspaceId?: string;
+    dependencies?: Record<string, string>;
+    public?: boolean;
+    voteSource?: "ai" | "human";
+    voteCount?: 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, JsonValue>;
+    /** 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?;
+    private registeredTools;
+    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 | UploadNewCodeSnipCompatOptions, 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 | UploadNewCodeSnipCompatOptions, 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>;
+    /** Register a tool that can be called by the server during execute. */
+    tool(name: string, description: string, parameters: Record<string, JsonValue>, callback: ToolCallback): void;
+    /** Execute a task with server-side code generation and tool calling. */
+    execute(task: string, options?: Partial<ExecuteOptions>): Promise<ExecuteResult>;
+    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

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

package/dist/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,23 @@
+/**
+ * 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, ExecuteOptions, ExecuteResult, ExecutionIO, ExecutionRecord, FewShotExample, FileWritten, GetCodeFilesResponse, JsonValue, LogFile, PublicSnippet, RetrieveBestResponse, RetrieveCodeBlockResponse, RetrieveExecutionsResponse, SearchMatch, SearchPublicParams, SearchPublicResponse, SearchResponse, StoreCodeBlockResponse, StoreExecutionResponse, SubmitExecutionResultRequest, SubmitExecutionResultResponse, TaskPattern, ToolCallback, ToolCallRecord, ToolDefinition, 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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAE3E,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,eAAe,GAChB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,qBAAqB,GACtB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,EACf,OAAO,IAAI,YAAY,EACvB,KAAK,EACL,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,kBAAkB,EAClB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,SAAS,EACT,cAAc,EACd,QAAQ,EACR,cAAc,EACd,aAAa,EACb,WAAW,EACX,eAAe,EACf,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,SAAS,EACT,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,yBAAyB,EACzB,0BAA0B,EAC1B,WAAW,EACX,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,4BAA4B,EAC5B,6BAA6B,EAC7B,WAAW,EACX,YAAY,EACZ,cAAc,EACd,cAAc,EACd,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAgBvD,YAAY,EACV,WAAW,EACX,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,cAAc,EACd,UAAU,EACV,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,8BAA8B,EAC9B,eAAe,EACf,kCAAkC,EAClC,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,qBAAqB,EACrB,8BAA8B,EAC9B,OAAO,EACP,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,0BAA0B,EAC1B,mCAAmC,EACnC,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,EAC3B,oCAAoC,EACpC,oBAAoB,EACpB,6BAA6B,EAC7B,mBAAmB,EACnB,mBAAmB,EACnB,4BAA4B,EAC5B,KAAK,EACL,iBAAiB,EACjB,uBAAuB,EACvB,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,yBAAyB,EACzB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,UAAU,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,OAAO,EACP,oBAAoB,EACpB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACrB,8BAA8B,EAC9B,aAAa,EACb,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,sBAAsB,EACtB,+BAA+B,EAC/B,qBAAqB,EACrB,kBAAkB,EAClB,yBAAyB,EACzB,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,IAAI,GACL,MAAM,gCAAgC,CAAC"}