@everruns/sdk 0.1.0

package/README.md

@@ -0,0 +1,97 @@
+# @everruns/sdk
+
+TypeScript SDK for the Everruns API.
+
+## Installation
+
+\`\`\`bash
+npm install @everruns/sdk
+\`\`\`
+
+## Quick Start
+
+\`\`\`typescript
+import { Everruns } from "@everruns/sdk";
+
+// Uses EVERRUNS_API_KEY environment variable
+const client = Everruns.fromEnv();
+
+// Create an agent
+const agent = await client.agents.create({
+  name: "Assistant",
+  systemPrompt: "You are a helpful assistant."
+});
+
+// Create a session
+const session = await client.sessions.create({ agentId: agent.id });
+
+// Send a message
+await client.messages.create(session.id, { text: "Hello!" });
+
+// Stream events
+for await (const event of client.events.stream(session.id)) {
+  console.log(event.type, event.data);
+}
+\`\`\`
+
+## Authentication
+
+The SDK uses API key authentication. Set the \`EVERRUNS_API_KEY\` environment variable or pass the key explicitly:
+
+\`\`\`typescript
+// From environment variable
+const client = Everruns.fromEnv();
+
+// Explicit key
+const client = new Everruns({
+  apiKey: "evr_..."
+});
+\`\`\`
+
+## Streaming Events
+
+The SDK supports SSE streaming with automatic reconnection:
+
+\`\`\`typescript
+const stream = client.events.stream(session.id, {
+  exclude: ["output.message.delta"],  // Filter out delta events
+  sinceId: "evt_..."                   // Resume from event ID
+});
+
+for await (const event of stream) {
+  switch (event.type) {
+    case "output.message.completed":
+      console.log("Message:", event.data);
+      break;
+    case "turn.completed":
+      console.log("Turn completed");
+      stream.abort();  // Stop streaming
+      break;
+    case "turn.failed":
+      console.error("Turn failed:", event.data);
+      break;
+  }
+}
+\`\`\`
+
+## Error Handling
+
+\`\`\`typescript
+import { ApiError, AuthenticationError, RateLimitError } from "@everruns/sdk";
+
+try {
+  await client.agents.get("invalid-id");
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error("Invalid API key");
+  } else if (error instanceof RateLimitError) {
+    console.log(\`Retry after \${error.retryAfter} seconds\`);
+  } else if (error instanceof ApiError) {
+    console.error(\`API error \${error.statusCode}: \${error.message}\`);
+  }
+}
+\`\`\`
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,17 @@
+/**
+ * API key authentication for Everruns API.
+ */
+export declare class ApiKey {
+    private readonly key;
+    constructor(key: string);
+    /**
+     * Create an ApiKey from the EVERRUNS_API_KEY environment variable.
+     * @throws Error if the environment variable is not set
+     */
+    static fromEnv(): ApiKey;
+    /**
+     * Get the authorization header value.
+     */
+    toHeader(): string;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IAOvB;;;OAGG;IACH,MAAM,CAAC,OAAO,IAAI,MAAM;IAWxB;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB"}

package/dist/auth.js

@@ -0,0 +1,31 @@
+/**
+ * API key authentication for Everruns API.
+ */
+export class ApiKey {
+    key;
+    constructor(key) {
+        if (!key) {
+            throw new Error("API key cannot be empty");
+        }
+        this.key = key;
+    }
+    /**
+     * Create an ApiKey from the EVERRUNS_API_KEY environment variable.
+     * @throws Error if the environment variable is not set
+     */
+    static fromEnv() {
+        const key = process.env.EVERRUNS_API_KEY;
+        if (!key) {
+            throw new Error("EVERRUNS_API_KEY environment variable is not set. " +
+                "Set it to your Everruns API key or pass the key explicitly.");
+        }
+        return new ApiKey(key);
+    }
+    /**
+     * Get the authorization header value.
+     */
+    toHeader() {
+        return this.key;
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,MAAM;IACA,GAAG,CAAS;IAE7B,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,OAAO;QACZ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACzC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,oDAAoD;gBAClD,6DAA6D,CAChE,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Everruns API client.
+ */
+import { ApiKey } from "./auth.js";
+import { Agent, CreateAgentRequest, Session, CreateSessionRequest, Message, CreateMessageRequest, Event, StreamOptions } from "./models.js";
+import { EventStream } from "./sse.js";
+export interface EverrunsOptions {
+    apiKey?: string | ApiKey;
+    baseUrl?: string;
+}
+export declare class Everruns {
+    private readonly apiKey;
+    private readonly baseUrl;
+    readonly agents: AgentsClient;
+    readonly sessions: SessionsClient;
+    readonly messages: MessagesClient;
+    readonly events: EventsClient;
+    constructor(options?: EverrunsOptions);
+    /**
+     * Create a client using environment variables.
+     *
+     * Reads `EVERRUNS_API_KEY` (required) and `EVERRUNS_API_URL` (optional).
+     */
+    static fromEnv(): Everruns;
+    /**
+     * Build full URL from a path, adding the /v1 prefix.
+     * Path should start with "/" (e.g., "/agents").
+     */
+    private url;
+    fetch<T>(path: string, options?: RequestInit): Promise<T>;
+    getStreamUrl(path: string): string;
+    getAuthHeader(): string;
+}
+declare class AgentsClient {
+    private readonly client;
+    constructor(client: Everruns);
+    create(request: CreateAgentRequest): Promise<Agent>;
+    get(agentId: string): Promise<Agent>;
+    list(): Promise<Agent[]>;
+    delete(agentId: string): Promise<void>;
+}
+declare class SessionsClient {
+    private readonly client;
+    constructor(client: Everruns);
+    create(request: CreateSessionRequest): Promise<Session>;
+    get(sessionId: string): Promise<Session>;
+    list(agentId?: string): Promise<Session[]>;
+}
+declare class MessagesClient {
+    private readonly client;
+    constructor(client: Everruns);
+    /**
+     * Create a new message (send text).
+     */
+    create(sessionId: string, text: string): Promise<Message>;
+    create(sessionId: string, request: CreateMessageRequest): Promise<Message>;
+    list(sessionId: string): Promise<Message[]>;
+}
+declare class EventsClient {
+    private readonly client;
+    constructor(client: Everruns);
+    list(sessionId: string, options?: StreamOptions): Promise<Event[]>;
+    /**
+     * Stream events from a session via SSE with automatic reconnection.
+     *
+     * The stream automatically handles:
+     * - Server-initiated `disconnecting` events (connection cycling)
+     * - Unexpected disconnections with exponential backoff
+     * - Resume from last event ID via `since_id`
+     *
+     * @param sessionId - The session to stream events from
+     * @param options - Optional stream configuration
+     * @returns An async iterable of events
+     *
+     * @example
+     * ```typescript
+     * const stream = client.events.stream(sessionId);
+     * for await (const event of stream) {
+     *   console.log(event.type, event.data);
+     * }
+     * ```
+     */
+    stream(sessionId: string, options?: StreamOptions): EventStream;
+}
+export {};
+//# 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":"AAAA;;GAEG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EACL,KAAK,EACL,kBAAkB,EAClB,OAAO,EACP,oBAAoB,EACpB,OAAO,EACP,oBAAoB,EACpB,KAAK,EACL,aAAa,EACd,MAAM,aAAa,CAAC;AAOrB,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;gBAElB,OAAO,GAAE,eAAoB;IAqBzC;;;;OAIG;IACH,MAAM,CAAC,OAAO,IAAI,QAAQ;IAK1B;;;OAGG;IACH,OAAO,CAAC,GAAG;IAML,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IAyCnE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlC,aAAa,IAAI,MAAM;CAGxB;AAED,cAAM,YAAY;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAEvC,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC;IAWnD,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAIpC,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAKxB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAG7C;AAED,cAAM,cAAc;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAEvC,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAOvD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAOjD;AAED,cAAM,cAAc;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAE7C;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IACzD,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,OAAO,CAAC;IAoBb,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAMlD;AAED,cAAM,YAAY;IACJ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,QAAQ;IAEvC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAWxE;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,WAAW;CAKhE"}

package/dist/client.js

@@ -0,0 +1,207 @@
+/**
+ * Everruns API client.
+ */
+import { ApiKey } from "./auth.js";
+import { ApiError, AuthenticationError, NotFoundError, RateLimitError, } from "./errors.js";
+import { EventStream } from "./sse.js";
+export class Everruns {
+    apiKey;
+    baseUrl;
+    agents;
+    sessions;
+    messages;
+    events;
+    constructor(options = {}) {
+        if (options.apiKey instanceof ApiKey) {
+            this.apiKey = options.apiKey;
+        }
+        else if (options.apiKey) {
+            this.apiKey = new ApiKey(options.apiKey);
+        }
+        else {
+            this.apiKey = ApiKey.fromEnv();
+        }
+        // Normalize base URL: remove trailing slash to avoid double slashes
+        // when joining with paths that start with "/".
+        // Example: "http://host/api/" + "/v1/agents" = "http://host/api//v1/agents" (wrong)
+        //          "http://host/api" + "/v1/agents" = "http://host/api/v1/agents" (correct)
+        const rawBaseUrl = options.baseUrl ?? "https://custom.example.com/api";
+        this.baseUrl = rawBaseUrl.replace(/\/+$/, "");
+        this.agents = new AgentsClient(this);
+        this.sessions = new SessionsClient(this);
+        this.messages = new MessagesClient(this);
+        this.events = new EventsClient(this);
+    }
+    /**
+     * Create a client using environment variables.
+     *
+     * Reads `EVERRUNS_API_KEY` (required) and `EVERRUNS_API_URL` (optional).
+     */
+    static fromEnv() {
+        const baseUrl = process.env.EVERRUNS_API_URL;
+        return new Everruns({ baseUrl });
+    }
+    /**
+     * Build full URL from a path, adding the /v1 prefix.
+     * Path should start with "/" (e.g., "/agents").
+     */
+    url(path) {
+        // Ensure path starts with "/" for consistency
+        const normalizedPath = path.startsWith("/") ? path : `/${path}`;
+        return `${this.baseUrl}/v1${normalizedPath}`;
+    }
+    async fetch(path, options = {}) {
+        const url = this.url(path);
+        const response = await fetch(url, {
+            ...options,
+            headers: {
+                Authorization: this.apiKey.toHeader(),
+                "Content-Type": "application/json",
+                ...options.headers,
+            },
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => undefined);
+            if (response.status === 401) {
+                throw new AuthenticationError();
+            }
+            if (response.status === 404) {
+                throw new NotFoundError("Resource");
+            }
+            if (response.status === 429) {
+                const retryAfter = response.headers.get("Retry-After");
+                throw new RateLimitError(retryAfter ? parseInt(retryAfter, 10) : undefined);
+            }
+            // Simplify HTML responses to avoid verbose error messages
+            const simplifiedBody = body && isHtmlResponse(body) ? undefined : body;
+            throw new ApiError(response.status, `API error: ${response.statusText}`, simplifiedBody);
+        }
+        if (response.status === 204) {
+            return undefined;
+        }
+        return response.json();
+    }
+    getStreamUrl(path) {
+        return this.url(path);
+    }
+    getAuthHeader() {
+        return this.apiKey.toHeader();
+    }
+}
+class AgentsClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(request) {
+        return this.client.fetch("/agents", {
+            method: "POST",
+            body: JSON.stringify({
+                name: request.name,
+                system_prompt: request.systemPrompt,
+                model: request.model,
+            }),
+        });
+    }
+    async get(agentId) {
+        return this.client.fetch(`/agents/${agentId}`);
+    }
+    async list() {
+        const response = await this.client.fetch("/agents");
+        return response.agents;
+    }
+    async delete(agentId) {
+        await this.client.fetch(`/agents/${agentId}`, { method: "DELETE" });
+    }
+}
+class SessionsClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(request) {
+        return this.client.fetch("/sessions", {
+            method: "POST",
+            body: JSON.stringify({ agent_id: request.agentId }),
+        });
+    }
+    async get(sessionId) {
+        return this.client.fetch(`/sessions/${sessionId}`);
+    }
+    async list(agentId) {
+        const query = agentId ? `?agent_id=${agentId}` : "";
+        const response = await this.client.fetch(`/sessions${query}`);
+        return response.sessions;
+    }
+}
+class MessagesClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(sessionId, textOrRequest) {
+        const request = typeof textOrRequest === "string"
+            ? {
+                message: {
+                    role: "user",
+                    content: [{ type: "text", text: textOrRequest }],
+                },
+            }
+            : textOrRequest;
+        return this.client.fetch(`/sessions/${sessionId}/messages`, {
+            method: "POST",
+            body: JSON.stringify(request),
+        });
+    }
+    async list(sessionId) {
+        const response = await this.client.fetch(`/sessions/${sessionId}/messages`);
+        return response.messages;
+    }
+}
+class EventsClient {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list(sessionId, options) {
+        const params = new URLSearchParams();
+        if (options?.sinceId)
+            params.set("since_id", options.sinceId);
+        if (options?.exclude)
+            params.set("exclude", options.exclude.join(","));
+        const query = params.toString() ? `?${params}` : "";
+        const response = await this.client.fetch(`/sessions/${sessionId}/events${query}`);
+        return response.events;
+    }
+    /**
+     * Stream events from a session via SSE with automatic reconnection.
+     *
+     * The stream automatically handles:
+     * - Server-initiated `disconnecting` events (connection cycling)
+     * - Unexpected disconnections with exponential backoff
+     * - Resume from last event ID via `since_id`
+     *
+     * @param sessionId - The session to stream events from
+     * @param options - Optional stream configuration
+     * @returns An async iterable of events
+     *
+     * @example
+     * ```typescript
+     * const stream = client.events.stream(sessionId);
+     * for await (const event of stream) {
+     *   console.log(event.type, event.data);
+     * }
+     * ```
+     */
+    stream(sessionId, options) {
+        // Build base URL (without since_id - EventStream handles that for reconnection)
+        const url = this.client.getStreamUrl(`/sessions/${sessionId}/sse`);
+        return new EventStream(url, this.client.getAuthHeader(), options);
+    }
+}
+/** Check if the body looks like an HTML response */
+function isHtmlResponse(body) {
+    const trimmed = body.trimStart();
+    return (trimmed.startsWith("<!DOCTYPE") || trimmed.toLowerCase().startsWith("<html"));
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Error types for Everruns SDK.
+ */
+export declare class EverrunsError extends Error {
+    constructor(message: string);
+}
+export declare class ApiError extends EverrunsError {
+    readonly statusCode: number;
+    readonly body?: unknown;
+    constructor(statusCode: number, message: string, body?: unknown);
+}
+export declare class AuthenticationError extends ApiError {
+    constructor(message?: string);
+}
+export declare class NotFoundError extends ApiError {
+    constructor(resource: string);
+}
+export declare class RateLimitError extends ApiError {
+    readonly retryAfter?: number;
+    constructor(retryAfter?: number);
+}
+export declare class ConnectionError extends EverrunsError {
+    constructor(message?: 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,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,QAAS,SAAQ,aAAa;IACzC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBAEZ,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAMhE;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,OAAO,GAAE,MAAgC;CAItD;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,QAAQ,EAAE,MAAM;CAI7B;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;gBAEjB,UAAU,CAAC,EAAE,MAAM;CAKhC;AAED,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,GAAE,MAA4B;CAIlD"}

package/dist/errors.js

@@ -0,0 +1,46 @@
+/**
+ * Error types for Everruns SDK.
+ */
+export class EverrunsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EverrunsError";
+    }
+}
+export class ApiError extends EverrunsError {
+    statusCode;
+    body;
+    constructor(statusCode, message, body) {
+        super(message);
+        this.name = "ApiError";
+        this.statusCode = statusCode;
+        this.body = body;
+    }
+}
+export class AuthenticationError extends ApiError {
+    constructor(message = "Authentication failed") {
+        super(401, message);
+        this.name = "AuthenticationError";
+    }
+}
+export class NotFoundError extends ApiError {
+    constructor(resource) {
+        super(404, `${resource} not found`);
+        this.name = "NotFoundError";
+    }
+}
+export class RateLimitError extends ApiError {
+    retryAfter;
+    constructor(retryAfter) {
+        super(429, "Rate limit exceeded");
+        this.name = "RateLimitError";
+        this.retryAfter = retryAfter;
+    }
+}
+export class ConnectionError extends EverrunsError {
+    constructor(message = "Connection failed") {
+        super(message);
+        this.name = "ConnectionError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,aAAa;IAChC,UAAU,CAAS;IACnB,IAAI,CAAW;IAExB,YAAY,UAAkB,EAAE,OAAe,EAAE,IAAc;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;IAC/C,YAAY,UAAkB,uBAAuB;QACnD,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,QAAQ;IACzC,YAAY,QAAgB;QAC1B,KAAK,CAAC,GAAG,EAAE,GAAG,QAAQ,YAAY,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,QAAQ;IACjC,UAAU,CAAU;IAE7B,YAAY,UAAmB;QAC7B,KAAK,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,UAAkB,mBAAmB;QAC/C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Everruns SDK for TypeScript/Node.js
+ *
+ * @example
+ * ```typescript
+ * import { Everruns } from "@everruns/sdk";
+ *
+ * // Uses EVERRUNS_API_KEY environment variable
+ * const client = Everruns.fromEnv();
+ *
+ * // Create an agent
+ * const agent = await client.agents.create({
+ *   name: "Assistant",
+ *   systemPrompt: "You are a helpful assistant."
+ * });
+ *
+ * // Create a session
+ * const session = await client.sessions.create({ agentId: agent.id });
+ *
+ * // Send a message
+ * await client.messages.create(session.id, { text: "Hello!" });
+ * ```
+ */
+export { Everruns, type EverrunsOptions } from "./client.js";
+export { ApiKey } from "./auth.js";
+export * from "./models.js";
+export * from "./errors.js";
+export { EventStream } from "./sse.js";
+//# 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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+/**
+ * Everruns SDK for TypeScript/Node.js
+ *
+ * @example
+ * ```typescript
+ * import { Everruns } from "@everruns/sdk";
+ *
+ * // Uses EVERRUNS_API_KEY environment variable
+ * const client = Everruns.fromEnv();
+ *
+ * // Create an agent
+ * const agent = await client.agents.create({
+ *   name: "Assistant",
+ *   systemPrompt: "You are a helpful assistant."
+ * });
+ *
+ * // Create a session
+ * const session = await client.sessions.create({ agentId: agent.id });
+ *
+ * // Send a message
+ * await client.messages.create(session.id, { text: "Hello!" });
+ * ```
+ */
+export { Everruns } from "./client.js";
+export { ApiKey } from "./auth.js";
+export * from "./models.js";
+export * from "./errors.js";
+export { EventStream } from "./sse.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,QAAQ,EAAwB,MAAM,aAAa,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Core data models for Everruns API.
+ */
+export interface Agent {
+    id: string;
+    name: string;
+    systemPrompt: string;
+    model?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateAgentRequest {
+    name: string;
+    systemPrompt: string;
+    model?: string;
+}
+export interface Session {
+    id: string;
+    agentId: string;
+    status: "active" | "completed" | "failed";
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CreateSessionRequest {
+    agentId: string;
+}
+export interface Message {
+    id: string;
+    sessionId: string;
+    role: "user" | "assistant";
+    content: ContentPart[];
+    createdAt: string;
+}
+export interface ContentPart {
+    type: "text" | "image";
+    text?: string;
+    imageUrl?: string;
+}
+export interface MessageInput {
+    role: "user";
+    content: ContentPart[];
+}
+export interface Controls {
+    modelId?: string;
+}
+export interface CreateMessageRequest {
+    message: MessageInput;
+    controls?: Controls;
+}
+export interface Event {
+    id: string;
+    type: string;
+    data: Record<string, unknown>;
+    createdAt: string;
+}
+export interface StreamOptions {
+    /** Resume from this event ID */
+    sinceId?: string;
+    /** Event types to exclude from the stream */
+    exclude?: string[];
+    /** Maximum number of reconnection attempts (undefined = unlimited) */
+    maxRetries?: number;
+}
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,YAAY,CAAC;IACtB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/models.js

@@ -0,0 +1,5 @@
+/**
+ * Core data models for Everruns API.
+ */
+export {};
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/sse.d.ts

@@ -0,0 +1,61 @@
+import { Event, StreamOptions } from "./models.js";
+/**
+ * Data from a disconnecting event.
+ */
+export interface DisconnectingData {
+    /** Reason for disconnection (e.g., "connection_cycle") */
+    reason: string;
+    /** Suggested retry delay in milliseconds */
+    retry_ms: number;
+}
+/**
+ * Async iterator for SSE events with automatic reconnection.
+ *
+ * This stream handles:
+ * - Graceful `disconnecting` events from the server
+ * - Unexpected connection drops with exponential backoff
+ * - Server retry hints
+ * - Automatic resume using `since_id`
+ *
+ * @example
+ * ```typescript
+ * const stream = client.events.stream(sessionId);
+ * for await (const event of stream) {
+ *   console.log(event.type, event.data);
+ * }
+ * ```
+ */
+export declare class EventStream implements AsyncIterable<Event> {
+    private readonly baseUrl;
+    private readonly authHeader;
+    private readonly options;
+    private lastEventId?;
+    private abortController?;
+    private serverRetryMs?;
+    private currentBackoffMs;
+    private retryCount;
+    private shouldReconnect;
+    private gracefulDisconnect;
+    constructor(url: string, authHeader: string, options?: StreamOptions);
+    /**
+     * Get the last received event ID (for resuming).
+     */
+    getLastEventId(): string | undefined;
+    /**
+     * Get the current retry count.
+     */
+    getRetryCount(): number;
+    /**
+     * Abort the stream and prevent further reconnection attempts.
+     */
+    abort(): void;
+    private buildUrl;
+    private getRetryDelay;
+    private updateBackoff;
+    private resetBackoff;
+    private shouldRetry;
+    private sleep;
+    [Symbol.asyncIterator](): AsyncGenerator<Event>;
+    private connect;
+}
+//# sourceMappingURL=sse.d.ts.map

package/dist/sse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.d.ts","sourceRoot":"","sources":["../src/sse.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAUnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAY,YAAW,aAAa,CAAC,KAAK,CAAC;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAiB;IACxC,OAAO,CAAC,kBAAkB,CAAkB;gBAEhC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;IAOxE;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,QAAQ;IAsBhB,OAAO,CAAC,aAAa;IAUrB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,WAAW;YAUL,KAAK;IAIZ,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC;YA8DvC,OAAO;CAgHvB"}

package/dist/sse.js

@@ -0,0 +1,280 @@
+/**
+ * Server-Sent Events streaming with automatic reconnection.
+ *
+ * Implements robust SSE streaming with:
+ * - Automatic reconnection on disconnect
+ * - Server retry hints
+ * - Graceful handling of `disconnecting` events
+ * - Exponential backoff for unexpected disconnections
+ * - Resume from last event ID via `since_id`
+ */
+import { createParser } from "eventsource-parser";
+import { ConnectionError } from "./errors.js";
+/** Maximum retry delay for exponential backoff */
+const MAX_RETRY_MS = 30_000;
+/** Initial retry delay for exponential backoff */
+const INITIAL_BACKOFF_MS = 1000;
+/** Read timeout for detecting stalled connections (2 minutes) */
+const READ_TIMEOUT_MS = 120_000;
+/**
+ * Async iterator for SSE events with automatic reconnection.
+ *
+ * This stream handles:
+ * - Graceful `disconnecting` events from the server
+ * - Unexpected connection drops with exponential backoff
+ * - Server retry hints
+ * - Automatic resume using `since_id`
+ *
+ * @example
+ * ```typescript
+ * const stream = client.events.stream(sessionId);
+ * for await (const event of stream) {
+ *   console.log(event.type, event.data);
+ * }
+ * ```
+ */
+export class EventStream {
+    baseUrl;
+    authHeader;
+    options;
+    lastEventId;
+    abortController;
+    serverRetryMs;
+    currentBackoffMs = INITIAL_BACKOFF_MS;
+    retryCount = 0;
+    shouldReconnect = true;
+    gracefulDisconnect = false;
+    constructor(url, authHeader, options = {}) {
+        this.baseUrl = url;
+        this.authHeader = authHeader;
+        this.options = options;
+        this.lastEventId = options.sinceId;
+    }
+    /**
+     * Get the last received event ID (for resuming).
+     */
+    getLastEventId() {
+        return this.lastEventId;
+    }
+    /**
+     * Get the current retry count.
+     */
+    getRetryCount() {
+        return this.retryCount;
+    }
+    /**
+     * Abort the stream and prevent further reconnection attempts.
+     */
+    abort() {
+        this.shouldReconnect = false;
+        this.abortController?.abort();
+    }
+    buildUrl() {
+        let url = this.baseUrl;
+        const params = [];
+        if (this.lastEventId) {
+            params.push(`since_id=${encodeURIComponent(this.lastEventId)}`);
+        }
+        if (this.options.exclude) {
+            for (const e of this.options.exclude) {
+                params.push(`exclude=${encodeURIComponent(e)}`);
+            }
+        }
+        if (params.length > 0) {
+            const separator = url.includes("?") ? "&" : "?";
+            url += separator + params.join("&");
+        }
+        return url;
+    }
+    getRetryDelay() {
+        if (this.gracefulDisconnect) {
+            // Use server hint for graceful disconnect, or short default
+            return this.serverRetryMs ?? 100;
+        }
+        else {
+            // Use exponential backoff for unexpected disconnects
+            return this.currentBackoffMs;
+        }
+    }
+    updateBackoff() {
+        if (!this.gracefulDisconnect) {
+            this.currentBackoffMs = Math.min(this.currentBackoffMs * 2, MAX_RETRY_MS);
+        }
+    }
+    resetBackoff() {
+        this.currentBackoffMs = INITIAL_BACKOFF_MS;
+        this.retryCount = 0;
+    }
+    shouldRetry() {
+        if (!this.shouldReconnect) {
+            return false;
+        }
+        if (this.options.maxRetries !== undefined) {
+            return this.retryCount < this.options.maxRetries;
+        }
+        return true;
+    }
+    async sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    async *[Symbol.asyncIterator]() {
+        while (this.shouldReconnect) {
+            this.abortController = new AbortController();
+            try {
+                for await (const event of this.connect()) {
+                    yield event;
+                }
+                // Stream ended normally - always retry to handle read timeout case
+                if (this.shouldRetry()) {
+                    this.retryCount++;
+                    const delay = this.getRetryDelay();
+                    this.updateBackoff();
+                    console.debug(`Stream ended, reconnecting in ${delay}ms (attempt ${this.retryCount})`);
+                    await this.sleep(delay);
+                    continue;
+                }
+                break;
+            }
+            catch (error) {
+                if (error instanceof GracefulDisconnect) {
+                    // Server-initiated graceful disconnect
+                    this.serverRetryMs = error.retryMs;
+                    this.gracefulDisconnect = true;
+                    if (this.shouldRetry()) {
+                        this.retryCount++;
+                        const delay = this.getRetryDelay();
+                        console.debug(`Graceful reconnect in ${delay}ms`);
+                        await this.sleep(delay);
+                        this.gracefulDisconnect = false;
+                        continue;
+                    }
+                    break;
+                }
+                if (error instanceof Error && error.name === "AbortError") {
+                    // Clean shutdown
+                    break;
+                }
+                // Unexpected error - use exponential backoff
+                this.gracefulDisconnect = false;
+                if (this.shouldRetry()) {
+                    this.retryCount++;
+                    const delay = this.getRetryDelay();
+                    this.updateBackoff();
+                    console.debug(`Reconnecting after error in ${delay}ms (attempt ${this.retryCount}): ${error}`);
+                    await this.sleep(delay);
+                    continue;
+                }
+                throw error;
+            }
+        }
+    }
+    async *connect() {
+        const url = this.buildUrl();
+        console.debug(`Connecting to SSE: ${url}`);
+        // Create abort controller with timeout for stalled connections
+        const timeoutId = setTimeout(() => {
+            this.abortController?.abort();
+        }, READ_TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    Authorization: this.authHeader,
+                    Accept: "text/event-stream",
+                    "Cache-Control": "no-cache",
+                },
+                signal: this.abortController?.signal,
+            });
+            // Clear initial timeout, we'll reset it on each chunk
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                throw new ConnectionError(`Stream connection failed: ${response.status}`);
+            }
+            if (!response.body) {
+                throw new ConnectionError("No response body");
+            }
+            const reader = response.body.getReader();
+            const decoder = new TextDecoder();
+            const eventQueue = [];
+            let readTimeoutId;
+            const resetReadTimeout = () => {
+                clearTimeout(readTimeoutId);
+                readTimeoutId = setTimeout(() => {
+                    console.debug("SSE read timeout, triggering reconnect");
+                    reader.cancel();
+                }, READ_TIMEOUT_MS);
+            };
+            const parser = createParser({
+                onEvent: (event) => {
+                    // Handle special lifecycle events
+                    if (event.event === "connected") {
+                        console.debug("SSE connected event received");
+                        return;
+                    }
+                    if (event.event === "disconnecting") {
+                        // Parse disconnecting data for retry hint
+                        try {
+                            const data = JSON.parse(event.data);
+                            console.debug(`SSE disconnecting: reason=${data.reason}, retry_ms=${data.retry_ms}`);
+                            throw new GracefulDisconnect(data.retry_ms);
+                        }
+                        catch (e) {
+                            if (e instanceof GracefulDisconnect) {
+                                throw e;
+                            }
+                            console.debug("SSE disconnecting event received (no data)");
+                            throw new GracefulDisconnect(100);
+                        }
+                    }
+                    if (event.event === "done") {
+                        return;
+                    }
+                    // Parse and yield regular events
+                    try {
+                        const data = JSON.parse(event.data);
+                        this.lastEventId = data.id;
+                        this.resetBackoff();
+                        eventQueue.push(data);
+                    }
+                    catch {
+                        // Skip malformed events
+                        console.trace(`Skipping malformed event: ${event.event}`);
+                    }
+                },
+            });
+            resetReadTimeout();
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    // Reset timeout on each chunk received
+                    resetReadTimeout();
+                    const chunk = decoder.decode(value, { stream: true });
+                    parser.feed(chunk);
+                    // Yield any events that were parsed
+                    while (eventQueue.length > 0) {
+                        yield eventQueue.shift();
+                    }
+                }
+            }
+            finally {
+                clearTimeout(readTimeoutId);
+            }
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+}
+/**
+ * Internal error to signal graceful disconnect.
+ */
+class GracefulDisconnect extends Error {
+    retryMs;
+    constructor(retryMs) {
+        super(`Graceful disconnect, retry in ${retryMs}ms`);
+        this.name = "GracefulDisconnect";
+        this.retryMs = retryMs;
+    }
+}
+//# sourceMappingURL=sse.js.map

package/dist/sse.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@everruns/sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for Everruns API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "oxlint src",
+    "format": "prettier --write src",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "everruns",
+    "sdk",
+    "api",
+    "ai",
+    "agents"
+  ],
+  "author": "Everruns Contributors",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/everruns/sdk.git",
+    "directory": "typescript"
+  },
+  "homepage": "https://github.com/everruns/sdk#readme",
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "eventsource-parser": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^3.2.4",
+    "oxlint": "^1.41.0",
+    "prettier": "^3.4.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}