@agent-os-sdk/client 0.1.0

package/dist/modules/me.js

@@ -0,0 +1,19 @@
+/**
+ * Me Module - Fully Typed
+ */
+export class MeModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * Get current user information.
+     */
+    async get() {
+        return this.client.GET("/v1/api/me", {
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/members.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Members Module - Fully Typed
+ *
+ * Naming conventions:
+ * - get* for singular items
+ * - list* for collections
+ * - create*, update*, delete* for mutations (NOT remove!)
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+import type { PaginationParams, PaginatedResponse } from "../client/helpers.js";
+export interface Member {
+    id: string;
+    tenant_id: string;
+    user_id?: string;
+    email?: string;
+    display_name?: string;
+    avatar_url?: string;
+    role_id?: string;
+    role_name?: string;
+    workspace_ids?: string[];
+    status: "active" | "pending" | "disabled";
+    created_at: string;
+    updated_at: string;
+}
+export interface MemberInviteResponse {
+    member_id: string;
+    invite_token?: string;
+    email: string;
+}
+export type MemberListResponse = PaginatedResponse<Member>;
+export declare class MembersModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all members in the tenant.
+     */
+    list(params?: PaginationParams & {
+        workspace_id?: string;
+        role_id?: string;
+        status?: string;
+    }): Promise<APIResponse<MemberListResponse>>;
+    /**
+     * Get a member by ID.
+     */
+    get(memberId: string): Promise<APIResponse<Member>>;
+    /**
+     * Invite a new member.
+     */
+    invite(body: {
+        email: string;
+        role_id?: string;
+        workspace_ids?: string[];
+    }): Promise<APIResponse<MemberInviteResponse>>;
+    /**
+     * Update a member.
+     */
+    update(memberId: string, body: {
+        role_id?: string;
+        workspace_ids?: string[];
+    }): Promise<APIResponse<Member>>;
+    /**
+     * Remove a member from the tenant.
+     * Note: Use delete() - remove() is provided as alias for backwards compatibility.
+     */
+    delete(memberId: string): Promise<APIResponse<void>>;
+    /**
+     * Alias for delete() (backwards compatibility)
+     * @deprecated Use delete() instead
+     */
+    remove: (memberId: string) => Promise<APIResponse<void>>;
+    /**
+     * Resend invitation email.
+     */
+    resendInvite(memberId: string): Promise<APIResponse<void>>;
+}
+//# sourceMappingURL=members.d.ts.map

package/dist/modules/members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"members.d.ts","sourceRoot":"","sources":["../../src/modules/members.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEhF,MAAM,WAAW,MAAM;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE3D,qBAAa,aAAa;IACV,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG;QACnC,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,CAAC,CAAC;IAO5C;;OAEG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAOzD;;OAEG;IACG,MAAM,CAAC,IAAI,EAAE;QACf,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAO9C;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QACjC,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAQhC;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAO1D;;;OAGG;IACH,MAAM,GAAI,UAAU,MAAM,gCAA2B;IAErD;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAMnE"}

package/dist/modules/members.js

@@ -0,0 +1,77 @@
+/**
+ * Members Module - Fully Typed
+ *
+ * Naming conventions:
+ * - get* for singular items
+ * - list* for collections
+ * - create*, update*, delete* for mutations (NOT remove!)
+ */
+export class MembersModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List all members in the tenant.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/members", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a member by ID.
+     */
+    async get(memberId) {
+        return this.client.GET("/v1/api/members/{id}", {
+            params: { path: { id: memberId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Invite a new member.
+     */
+    async invite(body) {
+        return this.client.POST("/v1/api/members/invite", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Update a member.
+     */
+    async update(memberId, body) {
+        return this.client.PUT("/v1/api/members/{id}", {
+            params: { path: { id: memberId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Remove a member from the tenant.
+     * Note: Use delete() - remove() is provided as alias for backwards compatibility.
+     */
+    async delete(memberId) {
+        return this.client.DELETE("/v1/api/members/{id}", {
+            params: { path: { id: memberId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Alias for delete() (backwards compatibility)
+     * @deprecated Use delete() instead
+     */
+    remove = (memberId) => this.delete(memberId);
+    /**
+     * Resend invitation email.
+     */
+    async resendInvite(memberId) {
+        return this.client.POST("/v1/api/members/{id}/resend-invite", {
+            params: { path: { id: memberId } },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/metrics.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Metrics Module - Fully Typed
+ */
+export interface MetricsResponse {
+    raw: string;
+}
+export declare class MetricsModule {
+    private baseUrl;
+    private headers;
+    constructor(baseUrl: string, headers: () => Record<string, string>);
+    /**
+     * Get Prometheus metrics.
+     */
+    get(): Promise<MetricsResponse>;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/modules/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/modules/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,eAAe;IAC5B,GAAG,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,aAAa;IACV,OAAO,CAAC,OAAO;IAAU,OAAO,CAAC,OAAO;gBAAhC,OAAO,EAAE,MAAM,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAElF;;OAEG;IACG,GAAG,IAAI,OAAO,CAAC,eAAe,CAAC;CAYxC"}

package/dist/modules/metrics.js

@@ -0,0 +1,24 @@
+/**
+ * Metrics Module - Fully Typed
+ */
+export class MetricsModule {
+    baseUrl;
+    headers;
+    constructor(baseUrl, headers) {
+        this.baseUrl = baseUrl;
+        this.headers = headers;
+    }
+    /**
+     * Get Prometheus metrics.
+     */
+    async get() {
+        const response = await fetch(`${this.baseUrl}/metrics`, {
+            headers: this.headers(),
+        });
+        if (!response.ok) {
+            throw new Error(`Failed to fetch metrics: ${response.status}`);
+        }
+        const raw = await response.text();
+        return { raw };
+    }
+}

package/dist/modules/playground.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Playground Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface PlaygroundSession {
+    session_id: string;
+    agent_id: string;
+    thread_id: string;
+    status: "active" | "expired";
+    created_at: string;
+    expires_at: string;
+}
+export interface PlaygroundMessageResponse {
+    run_id: string;
+    message_id: string;
+    content: string;
+}
+export declare class PlaygroundModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * Create a playground session.
+     */
+    createSession(body: {
+        agent_id: string;
+        thread_id?: string;
+    }): Promise<APIResponse<PlaygroundSession>>;
+    /**
+     * Get a playground session.
+     */
+    getSession(sessionId: string): Promise<APIResponse<PlaygroundSession>>;
+    /**
+     * Send a message in a playground session.
+     */
+    sendMessage(sessionId: string, message: string): Promise<APIResponse<PlaygroundMessageResponse>>;
+    /**
+     * Delete a playground session.
+     */
+    deleteSession(sessionId: string): Promise<APIResponse<void>>;
+}
+//# sourceMappingURL=playground.d.ts.map

package/dist/modules/playground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playground.d.ts","sourceRoot":"","sources":["../../src/modules/playground.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,gBAAgB;IACb,OAAO,CAAC,MAAM;IAAa,OAAO,CAAC,OAAO;gBAAlC,MAAM,EAAE,SAAS,EAAU,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEpF;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE;QACtB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAO3C;;OAEG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAO5E;;OAEG;IACG,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAQtG;;OAEG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAMrE"}

package/dist/modules/playground.js

@@ -0,0 +1,48 @@
+/**
+ * Playground Module - Fully Typed
+ */
+export class PlaygroundModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * Create a playground session.
+     */
+    async createSession(body) {
+        return this.client.POST("/v1/api/playground/sessions", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a playground session.
+     */
+    async getSession(sessionId) {
+        return this.client.GET("/v1/api/playground/sessions/{id}", {
+            params: { path: { id: sessionId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Send a message in a playground session.
+     */
+    async sendMessage(sessionId, message) {
+        return this.client.POST("/v1/api/playground/sessions/{id}/messages", {
+            params: { path: { id: sessionId } },
+            body: { content: message },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a playground session.
+     */
+    async deleteSession(sessionId) {
+        return this.client.DELETE("/v1/api/playground/sessions/{id}", {
+            params: { path: { id: sessionId } },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/prompts.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Prompts Module - Fully Typed
+ */
+import type { RawClient, APIResponse } from "../client/raw.js";
+export interface Prompt {
+    id: string;
+    name: string;
+    description?: string;
+    workspace_id: string;
+    tenant_id: string;
+    created_at: string;
+    updated_at: string;
+    versions?: PromptVersion[];
+}
+export interface PromptVersion {
+    id: string;
+    prompt_id: string;
+    version: number;
+    template: string;
+    input_schema?: Record<string, unknown>;
+    output_schema?: Record<string, unknown>;
+    is_live: boolean;
+    created_at: string;
+}
+export interface PromptListResponse {
+    items: Prompt[];
+    total: number;
+}
+export interface PromptVersionListResponse {
+    items: PromptVersion[];
+    total: number;
+}
+export interface RenderPromptResponse {
+    rendered: string;
+    input_used: Record<string, unknown>;
+}
+export declare class PromptsModule {
+    private client;
+    private headers;
+    constructor(client: RawClient, headers: () => Record<string, string>);
+    /**
+     * List all prompts.
+     */
+    list(params?: {
+        workspace_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<APIResponse<PromptListResponse>>;
+    /**
+     * Get a prompt by ID.
+     */
+    get(promptId: string): Promise<APIResponse<Prompt>>;
+    /**
+     * Create a new prompt.
+     */
+    create(body: {
+        name: string;
+        description?: string;
+        template?: string;
+        input_schema?: Record<string, unknown>;
+    }): Promise<APIResponse<Prompt>>;
+    /**
+     * Delete a prompt.
+     */
+    delete(promptId: string): Promise<APIResponse<void>>;
+    /**
+     * List all versions of a prompt.
+     */
+    listVersions(promptId: string): Promise<APIResponse<PromptVersionListResponse>>;
+    /**
+     * Create a new version.
+     */
+    createVersion(promptId: string, body: {
+        template: string;
+        input_schema?: Record<string, unknown>;
+        output_schema?: Record<string, unknown>;
+    }): Promise<APIResponse<PromptVersion>>;
+    /**
+     * Set the live version.
+     */
+    setLiveVersion(promptId: string, versionNumber: number): Promise<APIResponse<void>>;
+    /**
+     * Render a prompt with variables.
+     */
+    render(promptId: string, variables: Record<string, unknown>): Promise<APIResponse<RenderPromptResponse>>;
+}
+//# sourceMappingURL=prompts.d.ts.map

package/dist/modules/prompts.d.ts.map

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

package/dist/modules/prompts.js

@@ -0,0 +1,87 @@
+/**
+ * Prompts Module - Fully Typed
+ */
+export class PromptsModule {
+    client;
+    headers;
+    constructor(client, headers) {
+        this.client = client;
+        this.headers = headers;
+    }
+    /**
+     * List all prompts.
+     */
+    async list(params) {
+        return this.client.GET("/v1/api/prompts", {
+            params: { query: params },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Get a prompt by ID.
+     */
+    async get(promptId) {
+        return this.client.GET("/v1/api/prompts/{id}", {
+            params: { path: { id: promptId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new prompt.
+     */
+    async create(body) {
+        return this.client.POST("/v1/api/prompts", {
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Delete a prompt.
+     */
+    async delete(promptId) {
+        return this.client.DELETE("/v1/api/prompts/{id}", {
+            params: { path: { id: promptId } },
+            headers: this.headers(),
+        });
+    }
+    // ======================== Versions ========================
+    /**
+     * List all versions of a prompt.
+     */
+    async listVersions(promptId) {
+        return this.client.GET("/v1/api/prompts/{id}/versions", {
+            params: { path: { id: promptId } },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Create a new version.
+     */
+    async createVersion(promptId, body) {
+        return this.client.POST("/v1/api/prompts/{id}/versions", {
+            params: { path: { id: promptId } },
+            body,
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Set the live version.
+     */
+    async setLiveVersion(promptId, versionNumber) {
+        return this.client.POST("/v1/api/prompts/{id}/set-live", {
+            params: { path: { id: promptId } },
+            body: { version_number: versionNumber },
+            headers: this.headers(),
+        });
+    }
+    /**
+     * Render a prompt with variables.
+     */
+    async render(promptId, variables) {
+        return this.client.POST("/v1/api/prompts/{id}/render", {
+            params: { path: { id: promptId } },
+            body: { variables },
+            headers: this.headers(),
+        });
+    }
+}

package/dist/modules/runs.d.ts

@@ -0,0 +1,181 @@
+/**
+ * Runs Module - Core execution API (Fully Typed)
+ *
+ * Naming conventions:
+ * - get* for singular items
+ * - list* for collections
+ * - create*, update*, delete* for mutations
+ */
+import type { RawClient, APIResponse, components } from "../client/raw.js";
+import type { PaginationParams, PaginatedResponse } from "../client/helpers.js";
+import { type SSEEvent, type RunStreamEvent, type SSEOptions } from "../sse/client.js";
+type WaitRunResponse = components["schemas"]["WaitRunResponse"];
+type BatchRunResponse = components["schemas"]["BatchRunResponse"];
+type CancelRunResponse = components["schemas"]["CancelRunResponse"];
+type CheckpointListResponse = components["schemas"]["CheckpointListResponse"];
+export interface Run {
+    run_id: string;
+    status: "pending" | "running" | "completed" | "failed" | "cancelled" | "waiting_input";
+    thread_id?: string;
+    agent_id: string;
+    agent_version_id?: string;
+    tenant_id: string;
+    workspace_id: string;
+    input?: unknown;
+    output?: unknown;
+    error?: unknown;
+    created_at: string;
+    started_at?: string;
+    completed_at?: string;
+    duration_ms?: number;
+    reused?: boolean;
+}
+export interface RunEvent {
+    id: string;
+    run_id: string;
+    event_type: string;
+    node?: string;
+    data?: unknown;
+    timestamp: string;
+}
+export interface CreateRunResponse {
+    run_id: string;
+    status: string;
+    reused?: boolean;
+}
+export type RunListResponse = PaginatedResponse<Run>;
+export type RunEventsResponse = PaginatedResponse<RunEvent>;
+export declare class RunsModule {
+    private client;
+    private baseUrl;
+    private headers;
+    constructor(client: RawClient, baseUrl: string, headers: () => Record<string, string>);
+    /**
+     * Create a new run.
+     * @example
+     * ```ts
+     * const { data } = await client.runs.create({
+     *   agent_id: "agent-uuid",
+     *   input: { message: "Hello" }
+     * });
+     * ```
+     */
+    create(body: {
+        agent_id: string;
+        thread?: {
+            thread_id?: string;
+        } | {
+            new_thread: true;
+        };
+        input?: unknown;
+        idempotency_key?: string;
+    }): Promise<APIResponse<CreateRunResponse>>;
+    /**
+     * Get a run by ID.
+     */
+    get(runId: string): Promise<APIResponse<Run>>;
+    /**
+     * List runs with optional filters.
+     */
+    list(params?: PaginationParams & {
+        thread_id?: string;
+        agent_id?: string;
+        status?: string;
+    }): Promise<APIResponse<RunListResponse>>;
+    /**
+     * Wait for run completion synchronously.
+     */
+    wait(body: {
+        agent_id: string;
+        thread?: {
+            thread_id?: string;
+        } | {
+            new_thread: true;
+        };
+        input?: unknown;
+        timeout_seconds?: number;
+    }): Promise<APIResponse<WaitRunResponse>>;
+    /**
+     * Create batch runs.
+     */
+    batch(body: {
+        agent_id: string;
+        inputs: Array<{
+            input: unknown;
+            idempotency_key?: string;
+        }>;
+    }): Promise<APIResponse<BatchRunResponse>>;
+    /**
+     * Cancel a running run.
+     */
+    cancel(runId: string, reason?: string): Promise<APIResponse<CancelRunResponse>>;
+    /**
+     * Resume a run waiting for human input (HITL).
+     */
+    resume(runId: string, input: unknown): Promise<APIResponse<Run>>;
+    /**
+     * Rerun from start (stateless).
+     */
+    rerun(runId: string): Promise<APIResponse<CreateRunResponse>>;
+    /**
+     * Replay from checkpoint (stateful).
+     */
+    replay(runId: string, checkpointId?: string, mode?: "best_effort" | "deterministic"): Promise<APIResponse<CreateRunResponse>>;
+    /**
+     * Get run events for timeline (paged, no SSE).
+     * @example
+     * ```ts
+     * const { data } = await client.runs.getEvents("run-uuid");
+     * ```
+     */
+    getEvents(runId: string, params?: PaginationParams): Promise<APIResponse<RunEventsResponse>>;
+    /** Alias: runs.events() -> runs.getEvents() */
+    events: (runId: string, params?: PaginationParams) => Promise<APIResponse<RunEventsResponse>>;
+    /**
+     * Get checkpoints for a run.
+     */
+    getCheckpoints(runId: string): Promise<APIResponse<CheckpointListResponse>>;
+    /** Alias: runs.checkpoints() -> runs.getCheckpoints() */
+    checkpoints: (runId: string) => Promise<APIResponse<{
+        run_id?: string;
+        total_checkpoints?: number;
+        checkpoints?: components["schemas"]["CheckpointNode"][] | null;
+    }>>;
+    /**
+     * Stream run events via SSE.
+     * @example
+     * ```ts
+     * for await (const event of client.runs.stream("run-uuid")) {
+     *   console.log(event.data);
+     * }
+     * ```
+     */
+    stream(runId: string, options?: SSEOptions): AsyncGenerator<SSEEvent<RunStreamEvent>>;
+    /**
+     * Create run and stream output.
+     * @example
+     * ```ts
+     * for await (const event of client.runs.createAndStream({
+     *   agent_id: "...",
+     *   input: { message: "Hello" }
+     * })) {
+     *   console.log(event);
+     * }
+     * ```
+     */
+    createAndStream(body: {
+        agent_id: string;
+        thread?: {
+            thread_id?: string;
+        } | {
+            new_thread: true;
+        };
+        input?: unknown;
+    }, options?: SSEOptions): AsyncGenerator<SSEEvent<RunStreamEvent>>;
+    /**
+     * Join an existing run's stream (resume watching).
+     */
+    join(runId: string, options?: SSEOptions): AsyncGenerator<SSEEvent<RunStreamEvent>>;
+}
+export {};
+//# sourceMappingURL=runs.d.ts.map