@rayrun/sdk 0.2.0 → 0.2.1

package/README.md

@@ -73,6 +73,9 @@ const valid = verifyWebhookSignature({
 
 After verification, parse the body as `WebhookPayload`. Every event has a stable `id`, `type`, and
 `occurredAt`; its `data` shape is narrowed by `type`. Use `id` to deduplicate retries.
+For `activity.call`, `arguments` and `result` contain the captured tool payloads, or `null` when
+capture was disabled for that connection, the webhook did not opt in with
+`forwardToolPayloads: true`, or no result existed.
 
 ```ts
 import type { WebhookPayload } from '@rayrun/sdk';

package/index.d.ts

@@ -1,5 +1,12 @@
 /* oxlint-disable perfectionist/sort-classes, perfectionist/sort-modules, perfectionist/sort-object-types, perfectionist/sort-union-types -- Public types follow the documented API resource order. */
 export type CursorPage<T> = { items: T[]; page: { nextCursor: string | null } };
+export type JsonValue =
+  | boolean
+  | null
+  | number
+  | string
+  | JsonValue[]
+  | { [key: string]: JsonValue };
 export type PageQuery = { cursor?: string; limit?: number };
 export type ToolDecision = 'allow' | 'ask' | 'block';
 export type ToolAccessMode = 'read-only' | 'ask-before-changes' | 'allow-all' | 'custom';
@@ -77,6 +84,7 @@ export type Webhook = {
   description: string | null;
   enabled: boolean;
   eventTypes: WebhookEvent[];
+  forwardToolPayloads: boolean;
   uid: string;
   url: string;
 };
@@ -114,10 +122,12 @@ export type WebhookPayload =
       'activity.call',
       {
         activityId: string;
+        arguments: JsonValue;
         calledAt: string;
         connectionUid: string | null;
         errorCode: string | null;
         policyDecision: ToolDecision | null;
+        result: JsonValue;
         succeeded: boolean | null;
         toolName: string;
       }
@@ -232,6 +242,7 @@ export class Rayrun {
       url: string;
       description?: string | null;
       eventTypes: WebhookEvent[];
+      forwardToolPayloads?: boolean;
     }): Promise<{ uid: string; secret: string }>;
     delete(uid: string): Promise<void>;
     list(): Promise<{ items: Webhook[] }>;

package/index.js

@@ -80,6 +80,8 @@ export const verifyWebhookSignature = ({
 };
 
 export class Rayrun {
+  #apiKey;
+
   constructor({
     apiKey,
     baseUrl = 'https://ray.run',
@@ -88,7 +90,7 @@ export class Rayrun {
     if (!apiKey) throw new TypeError('Rayrun requires an apiKey.');
     if (!fetchImplementation) throw new TypeError('Rayrun requires a fetch implementation.');
 
-    this.apiKey = apiKey;
+    this.#apiKey = apiKey;
     this.baseUrl = baseUrl.replace(/\/$/u, '');
     this.fetch = fetchImplementation;
 
@@ -140,7 +142,7 @@ export class Rayrun {
         response = await this.fetch(url, {
           body: body === undefined ? undefined : JSON.stringify(body),
           headers: withoutUndefined({
-            authorization: `Bearer ${this.apiKey}`,
+            authorization: `Bearer ${this.#apiKey}`,
             'content-type': body === undefined ? undefined : 'application/json',
             'user-agent': '@rayrun/sdk',
           }),
@@ -266,6 +268,8 @@ export class RayrunCodeRunAheadSession {
 }
 
 export class RayrunGateway {
+  #accessToken;
+
   constructor({
     accessToken,
     baseUrl = 'https://ray.run',
@@ -274,7 +278,7 @@ export class RayrunGateway {
     if (!accessToken) throw new TypeError('RayrunGateway requires an accessToken.');
     if (!fetchImplementation) throw new TypeError('RayrunGateway requires a fetch implementation.');
 
-    this.accessToken = accessToken;
+    this.#accessToken = accessToken;
     this.baseUrl = baseUrl.replace(/\/$/u, '');
     this.fetch = fetchImplementation;
     this.codeRunAhead = {
@@ -298,7 +302,7 @@ export class RayrunGateway {
     const response = await this.fetch(`${this.baseUrl}/mcp/run-ahead`, {
       body: JSON.stringify(body),
       headers: {
-        authorization: `Bearer ${this.accessToken}`,
+        authorization: `Bearer ${this.#accessToken}`,
         'content-type': 'application/json',
         'user-agent': '@rayrun/sdk',
       },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rayrun/sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Type-safe client for the Rayrun public API",
   "license": "MIT",
   "repository": {