@happyrobot-ai/sdk 0.1.0

package/resources/mcp.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * MCP resource — client.mcp.*
+ *
+ * Maps to:
+ *   GET  /mcp
+ *   POST /mcp
+ *   POST /mcp/:mcpId/refresh
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MCPResource = void 0;
+class MCPResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List MCP servers (paginated). */
+    async list(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/mcp",
+            query: query,
+        });
+    }
+    /** Register a new MCP server. */
+    async create(body) {
+        return this.http.request({
+            method: "POST",
+            path: "/mcp",
+            body,
+        });
+    }
+    /** Refresh (re-discover tools for) an MCP server. */
+    async refresh(mcpId) {
+        return this.http.request({
+            method: "POST",
+            path: `/mcp/${encodeURIComponent(mcpId)}/refresh`,
+        });
+    }
+}
+exports.MCPResource = MCPResource;
+//# sourceMappingURL=mcp.js.map

package/resources/mcp.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./mcp.js";
+export * from "./mcp.js";

package/resources/messages.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Messages resource — client.messages.*
+ *
+ * Maps to:
+ *   GET  /messages/:message_id/flags
+ *   POST /messages/:message_id/flags
+ */
+import type { HttpClient } from "../core/http";
+import type { ListMessageFlagsQuery, PaginatedMessageFlagsResponse, CreateMessageFlagBody, MessageFlagItem } from "../types/messages.types";
+export declare class MessagesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List quality flags for a message. */
+    listFlags(messageId: string, query?: ListMessageFlagsQuery): Promise<PaginatedMessageFlagsResponse>;
+    /** Create a quality flag on a message. */
+    createFlag(messageId: string, body: CreateMessageFlagBody): Promise<MessageFlagItem>;
+}

package/resources/messages.js

@@ -0,0 +1,37 @@
+"use strict";
+/**
+ * Messages resource — client.messages.*
+ *
+ * Maps to:
+ *   GET  /messages/:message_id/flags
+ *   POST /messages/:message_id/flags
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagesResource = void 0;
+class MessagesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List quality flags for a message. */
+    async listFlags(messageId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/messages/${enc(messageId)}/flags`,
+            query: query,
+        });
+    }
+    /** Create a quality flag on a message. */
+    async createFlag(messageId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/messages/${enc(messageId)}/flags`,
+            body,
+        });
+    }
+}
+exports.MessagesResource = MessagesResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=messages.js.map

package/resources/messages.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./messages.js";
+export * from "./messages.js";

package/resources/nodes.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Node resource — client.nodes.*
+ *
+ * Maps to:
+ *   GET    /versions/:version_id/nodes
+ *   POST   /versions/:version_id/nodes
+ *   GET    /versions/:version_id/nodes/:node_id
+ *   PUT    /versions/:version_id/nodes/:node_id
+ *   DELETE /versions/:version_id/nodes/:node_id
+ *   GET    /versions/:version_id/nodes/:node_id/config-schema
+ *   GET    /versions/:version_id/nodes/:node_id/available-vars
+ *   POST   /versions/:version_id/nodes/:node_id/test
+ */
+import type { HttpClient } from "../core/http";
+import type { ListNodesResponse, AddNodesBody, AddNodesResponse, UpdateNodeBody, GetSingleNodeResponse } from "../types/versions.types";
+import type { AvailableVarsResponse, ConfigSchemaResponse } from "../types/nodes.types";
+export interface TestNodeBody {
+    environment?: "production" | "staging" | "development";
+}
+export interface TestNodeOutput {
+    id: string;
+    node_id: string;
+    type: string | null;
+    data: unknown;
+    error: string | null;
+    timestamp: string;
+}
+export interface TestNodeResponse {
+    data: TestNodeOutput;
+}
+export declare class NodesResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List all nodes in a version. */
+    list(versionId: string): Promise<ListNodesResponse>;
+    /** Add nodes to a version (batch, 1-50). */
+    addBatch(versionId: string, body: AddNodesBody): Promise<AddNodesResponse>;
+    /** Get a single node by ID. */
+    get(versionId: string, nodeId: string): Promise<GetSingleNodeResponse>;
+    /** Update a node. */
+    update(versionId: string, nodeId: string, body: UpdateNodeBody): Promise<unknown>;
+    /** Delete a node. */
+    delete(versionId: string, nodeId: string): Promise<void>;
+    /** Get the configuration schema for a node (field types, requirements, options). */
+    getConfigSchema(versionId: string, nodeId: string): Promise<ConfigSchemaResponse>;
+    /** Get available upstream variables for a node. */
+    getAvailableVars(versionId: string, nodeId: string): Promise<AvailableVarsResponse>;
+    /** Test a single node. The version must not be published. */
+    test(versionId: string, nodeId: string, body?: TestNodeBody): Promise<TestNodeResponse>;
+}

package/resources/nodes.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * Node resource — client.nodes.*
+ *
+ * Maps to:
+ *   GET    /versions/:version_id/nodes
+ *   POST   /versions/:version_id/nodes
+ *   GET    /versions/:version_id/nodes/:node_id
+ *   PUT    /versions/:version_id/nodes/:node_id
+ *   DELETE /versions/:version_id/nodes/:node_id
+ *   GET    /versions/:version_id/nodes/:node_id/config-schema
+ *   GET    /versions/:version_id/nodes/:node_id/available-vars
+ *   POST   /versions/:version_id/nodes/:node_id/test
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodesResource = void 0;
+class NodesResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List all nodes in a version. */
+    async list(versionId) {
+        return this.http.request({
+            method: "GET",
+            path: `/versions/${enc(versionId)}/nodes`,
+        });
+    }
+    /** Add nodes to a version (batch, 1-50). */
+    async addBatch(versionId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/versions/${enc(versionId)}/nodes`,
+            body,
+        });
+    }
+    /** Get a single node by ID. */
+    async get(versionId, nodeId) {
+        return this.http.request({
+            method: "GET",
+            path: `/versions/${enc(versionId)}/nodes/${enc(nodeId)}`,
+        });
+    }
+    /** Update a node. */
+    async update(versionId, nodeId, body) {
+        return this.http.request({
+            method: "PUT",
+            path: `/versions/${enc(versionId)}/nodes/${enc(nodeId)}`,
+            body,
+        });
+    }
+    /** Delete a node. */
+    async delete(versionId, nodeId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/versions/${enc(versionId)}/nodes/${enc(nodeId)}`,
+        });
+    }
+    /** Get the configuration schema for a node (field types, requirements, options). */
+    async getConfigSchema(versionId, nodeId) {
+        return this.http.request({
+            method: "GET",
+            path: `/versions/${enc(versionId)}/nodes/${enc(nodeId)}/config-schema`,
+        });
+    }
+    /** Get available upstream variables for a node. */
+    async getAvailableVars(versionId, nodeId) {
+        return this.http.request({
+            method: "GET",
+            path: `/versions/${enc(versionId)}/nodes/${enc(nodeId)}/available-vars`,
+        });
+    }
+    /** Test a single node. The version must not be published. */
+    async test(versionId, nodeId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/versions/${enc(versionId)}/nodes/${enc(nodeId)}/test`,
+            body: body ?? {},
+        });
+    }
+}
+exports.NodesResource = NodesResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=nodes.js.map

package/resources/nodes.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./nodes.js";
+export * from "./nodes.js";

package/resources/northstars.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Northstar resource — client.northstars.*
+ *
+ * Maps to:
+ *   GET    /northstars/:northstar_id
+ *   PATCH  /northstars/:northstar_id
+ *   DELETE /northstars/:northstar_id
+ *   GET    /northstars/:northstar_id/history
+ *   POST   /northstars/:northstar_id/feedback
+ *   DELETE /northstars/:northstar_id/feedback
+ */
+import type { HttpClient } from "../core/http";
+import type { GetNorthstarResponse, PatchNorthstarBody, PatchNorthstarResponse, GetNorthstarHistoryResponse, SubmitNorthstarFeedbackBody, SubmitNorthstarFeedbackResponse } from "../types/northstars.types";
+export declare class NorthstarsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get a northstar by ID. */
+    get(northstarId: string): Promise<GetNorthstarResponse>;
+    /** Update a northstar. */
+    update(northstarId: string, body: PatchNorthstarBody): Promise<PatchNorthstarResponse>;
+    /** Delete a northstar. */
+    delete(northstarId: string): Promise<void>;
+    /** Get the full regeneration history chain for a northstar. */
+    getHistory(northstarId: string): Promise<GetNorthstarHistoryResponse>;
+    /** Submit a correctness rating for a northstar. */
+    submitFeedback(northstarId: string, body: SubmitNorthstarFeedbackBody): Promise<SubmitNorthstarFeedbackResponse>;
+    /** Delete your feedback on a northstar. */
+    deleteFeedback(northstarId: string): Promise<void>;
+}

package/resources/northstars.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Northstar resource — client.northstars.*
+ *
+ * Maps to:
+ *   GET    /northstars/:northstar_id
+ *   PATCH  /northstars/:northstar_id
+ *   DELETE /northstars/:northstar_id
+ *   GET    /northstars/:northstar_id/history
+ *   POST   /northstars/:northstar_id/feedback
+ *   DELETE /northstars/:northstar_id/feedback
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NorthstarsResource = void 0;
+class NorthstarsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get a northstar by ID. */
+    async get(northstarId) {
+        return this.http.request({
+            method: "GET",
+            path: `/northstars/${enc(northstarId)}`,
+        });
+    }
+    /** Update a northstar. */
+    async update(northstarId, body) {
+        return this.http.request({
+            method: "PATCH",
+            path: `/northstars/${enc(northstarId)}`,
+            body,
+        });
+    }
+    /** Delete a northstar. */
+    async delete(northstarId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/northstars/${enc(northstarId)}`,
+        });
+    }
+    /** Get the full regeneration history chain for a northstar. */
+    async getHistory(northstarId) {
+        return this.http.request({
+            method: "GET",
+            path: `/northstars/${enc(northstarId)}/history`,
+        });
+    }
+    /** Submit a correctness rating for a northstar. */
+    async submitFeedback(northstarId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/northstars/${enc(northstarId)}/feedback`,
+            body,
+        });
+    }
+    /** Delete your feedback on a northstar. */
+    async deleteFeedback(northstarId) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/northstars/${enc(northstarId)}/feedback`,
+        });
+    }
+}
+exports.NorthstarsResource = NorthstarsResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=northstars.js.map

package/resources/northstars.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./northstars.js";
+export * from "./northstars.js";

package/resources/phone-numbers.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Phone numbers resource — client.phoneNumbers.*
+ *
+ * Maps to:
+ *   GET    /phone-numbers
+ *   POST   /phone-numbers
+ *   PUT    /phone-numbers/:id
+ *   GET    /phone-numbers/:phone_number_id/usage
+ *   GET    /phone-numbers/:phone_number_id/tollfree-verification
+ *   POST   /phone-numbers/:phone_number_id/tollfree-verification
+ *   POST   /phone-numbers/:phone_number_id/sip-trunk
+ *   POST   /phone-numbers/:phone_number_id/free-up-number
+ *   POST   /phone-numbers/:phone_number_id/remove-from-workflow
+ *   POST   /phone-numbers/:phone_number_id/delete-number
+ *   POST   /phone-numbers/validate-toll-free-numbers
+ *   DELETE /phone-numbers/tollfree-verification/:verification_sid
+ */
+import type { HttpClient } from "../core/http";
+import type { ListPhoneNumbersQuery, ListPhoneNumbersResponse, BuyPhoneNumberBody, BuyPhoneNumberResponse, UpdatePhoneNumberBody, UpdatePhoneNumberResponse, PhoneNumberUsageResponse, TollFreeVerificationResponse, CreateTollFreeVerificationBody, CreateTollFreeVerificationResponse, DeleteTollFreeVerificationResponse, CreateSipTrunkForPhoneResponse, FreeUpNumberResponse, DeleteNumberResponse, RemoveFromUseCaseBody, RemoveFromUseCaseResponse, ValidateTollFreeNumbersBody, ValidateTollFreeNumbersResponse } from "../types/phone-numbers.types";
+export declare class PhoneNumbersResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** List all phone numbers. */
+    list(query?: ListPhoneNumbersQuery): Promise<ListPhoneNumbersResponse>;
+    /** Buy a new phone number. */
+    buy(body: BuyPhoneNumberBody): Promise<BuyPhoneNumberResponse>;
+    /** Update a phone number (name, caller_id). */
+    update(phoneNumberId: string, body: UpdatePhoneNumberBody): Promise<UpdatePhoneNumberResponse>;
+    /** Get usage info for a phone number. */
+    getUsage(phoneNumberId: string): Promise<PhoneNumberUsageResponse>;
+    /** Get toll-free verification status. */
+    getTollFreeVerification(phoneNumberId: string): Promise<TollFreeVerificationResponse>;
+    /** Create toll-free verification. */
+    createTollFreeVerification(phoneNumberId: string, body: CreateTollFreeVerificationBody): Promise<CreateTollFreeVerificationResponse>;
+    /** Delete a toll-free verification. */
+    deleteTollFreeVerification(verificationSid: string): Promise<DeleteTollFreeVerificationResponse>;
+    /** Create a SIP trunk for a phone number. */
+    createSipTrunk(phoneNumberId: string): Promise<CreateSipTrunkForPhoneResponse>;
+    /** Free up a phone number (release from workflows). */
+    freeUp(phoneNumberId: string): Promise<FreeUpNumberResponse>;
+    /** Delete a phone number permanently. */
+    delete(phoneNumberId: string): Promise<DeleteNumberResponse>;
+    /** Remove a phone number from a specific workflow. */
+    removeFromWorkflow(phoneNumberId: string, body: RemoveFromUseCaseBody): Promise<RemoveFromUseCaseResponse>;
+    /** Validate toll-free numbers for conflicts. */
+    validateTollFreeNumbers(body: ValidateTollFreeNumbersBody): Promise<ValidateTollFreeNumbersResponse>;
+}

package/resources/phone-numbers.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * Phone numbers resource — client.phoneNumbers.*
+ *
+ * Maps to:
+ *   GET    /phone-numbers
+ *   POST   /phone-numbers
+ *   PUT    /phone-numbers/:id
+ *   GET    /phone-numbers/:phone_number_id/usage
+ *   GET    /phone-numbers/:phone_number_id/tollfree-verification
+ *   POST   /phone-numbers/:phone_number_id/tollfree-verification
+ *   POST   /phone-numbers/:phone_number_id/sip-trunk
+ *   POST   /phone-numbers/:phone_number_id/free-up-number
+ *   POST   /phone-numbers/:phone_number_id/remove-from-workflow
+ *   POST   /phone-numbers/:phone_number_id/delete-number
+ *   POST   /phone-numbers/validate-toll-free-numbers
+ *   DELETE /phone-numbers/tollfree-verification/:verification_sid
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhoneNumbersResource = void 0;
+class PhoneNumbersResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** List all phone numbers. */
+    async list(query) {
+        return this.http.request({
+            method: "GET",
+            path: "/phone-numbers",
+            query: query,
+        });
+    }
+    /** Buy a new phone number. */
+    async buy(body) {
+        return this.http.request({
+            method: "POST",
+            path: "/phone-numbers",
+            body,
+        });
+    }
+    /** Update a phone number (name, caller_id). */
+    async update(phoneNumberId, body) {
+        return this.http.request({
+            method: "PUT",
+            path: `/phone-numbers/${enc(phoneNumberId)}`,
+            body,
+        });
+    }
+    /** Get usage info for a phone number. */
+    async getUsage(phoneNumberId) {
+        return this.http.request({
+            method: "GET",
+            path: `/phone-numbers/${enc(phoneNumberId)}/usage`,
+        });
+    }
+    /** Get toll-free verification status. */
+    async getTollFreeVerification(phoneNumberId) {
+        return this.http.request({
+            method: "GET",
+            path: `/phone-numbers/${enc(phoneNumberId)}/tollfree-verification`,
+        });
+    }
+    /** Create toll-free verification. */
+    async createTollFreeVerification(phoneNumberId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/phone-numbers/${enc(phoneNumberId)}/tollfree-verification`,
+            body,
+        });
+    }
+    /** Delete a toll-free verification. */
+    async deleteTollFreeVerification(verificationSid) {
+        return this.http.request({
+            method: "DELETE",
+            path: `/phone-numbers/tollfree-verification/${enc(verificationSid)}`,
+        });
+    }
+    /** Create a SIP trunk for a phone number. */
+    async createSipTrunk(phoneNumberId) {
+        return this.http.request({
+            method: "POST",
+            path: `/phone-numbers/${enc(phoneNumberId)}/sip-trunk`,
+        });
+    }
+    /** Free up a phone number (release from workflows). */
+    async freeUp(phoneNumberId) {
+        return this.http.request({
+            method: "POST",
+            path: `/phone-numbers/${enc(phoneNumberId)}/free-up-number`,
+        });
+    }
+    /** Delete a phone number permanently. */
+    async delete(phoneNumberId) {
+        return this.http.request({
+            method: "POST",
+            path: `/phone-numbers/${enc(phoneNumberId)}/delete-number`,
+        });
+    }
+    /** Remove a phone number from a specific workflow. */
+    async removeFromWorkflow(phoneNumberId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/phone-numbers/${enc(phoneNumberId)}/remove-from-workflow`,
+            body,
+        });
+    }
+    /** Validate toll-free numbers for conflicts. */
+    async validateTollFreeNumbers(body) {
+        return this.http.request({
+            method: "POST",
+            path: "/phone-numbers/validate-toll-free-numbers",
+            body,
+        });
+    }
+}
+exports.PhoneNumbersResource = PhoneNumbersResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=phone-numbers.js.map

package/resources/phone-numbers.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./phone-numbers.js";
+export * from "./phone-numbers.js";

package/resources/runs.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Run resource — client.runs.*
+ *
+ * Maps to:
+ *   GET    /runs
+ *   GET    /runs/:run_id
+ *   GET    /runs/:run_id/sessions
+ *   GET    /runs/:run_id/recordings
+ *   GET    /runs/:run_id/flags
+ *   POST   /runs/:run_id/cancel
+ *   POST   /runs/:run_id/mark
+ */
+import type { HttpClient } from "../core/http";
+import type { RunDetail, MarkRunBody, MarkRunResponse, ListFlagsQuery, PaginatedFlagsResponse } from "../types/runs.types";
+import type { PaginatedSessionsResponse, ListSessionsQuery } from "../types/sessions.types";
+export declare class RunsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get a run by ID. */
+    get(runId: string): Promise<RunDetail>;
+    /** Get sessions for a run. */
+    getSessions(runId: string, query?: ListSessionsQuery): Promise<PaginatedSessionsResponse>;
+    /** Get recordings for a run. */
+    getRecordings(runId: string): Promise<unknown>;
+    /** Get quality flags for a run. */
+    getFlags(runId: string, query?: ListFlagsQuery): Promise<PaginatedFlagsResponse>;
+    /** Cancel a run. */
+    cancel(runId: string): Promise<void>;
+    /** Mark a run with an annotation (correct, incorrect, critical). */
+    mark(runId: string, body: MarkRunBody): Promise<MarkRunResponse>;
+}

package/resources/runs.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * Run resource — client.runs.*
+ *
+ * Maps to:
+ *   GET    /runs
+ *   GET    /runs/:run_id
+ *   GET    /runs/:run_id/sessions
+ *   GET    /runs/:run_id/recordings
+ *   GET    /runs/:run_id/flags
+ *   POST   /runs/:run_id/cancel
+ *   POST   /runs/:run_id/mark
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RunsResource = void 0;
+class RunsResource {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Get a run by ID. */
+    async get(runId) {
+        return this.http.request({
+            method: "GET",
+            path: `/runs/${enc(runId)}`,
+        });
+    }
+    /** Get sessions for a run. */
+    async getSessions(runId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/runs/${enc(runId)}/sessions`,
+            query: query,
+        });
+    }
+    /** Get recordings for a run. */
+    async getRecordings(runId) {
+        return this.http.request({
+            method: "GET",
+            path: `/runs/${enc(runId)}/recordings`,
+        });
+    }
+    /** Get quality flags for a run. */
+    async getFlags(runId, query) {
+        return this.http.request({
+            method: "GET",
+            path: `/runs/${enc(runId)}/flags`,
+            query: query,
+        });
+    }
+    /** Cancel a run. */
+    async cancel(runId) {
+        return this.http.request({
+            method: "POST",
+            path: `/runs/${enc(runId)}/cancel`,
+        });
+    }
+    /** Mark a run with an annotation (correct, incorrect, critical). */
+    async mark(runId, body) {
+        return this.http.request({
+            method: "POST",
+            path: `/runs/${enc(runId)}/mark`,
+            body,
+        });
+    }
+}
+exports.RunsResource = RunsResource;
+function enc(s) {
+    return encodeURIComponent(s);
+}
+//# sourceMappingURL=runs.js.map

package/resources/runs.mjs

@@ -0,0 +1,3 @@
+// ESM wrapper — re-exports CJS module
+export { default } from "./runs.js";
+export * from "./runs.js";

package/resources/sessions.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Session resource — client.sessions.*
+ *
+ * Maps to:
+ *   GET /sessions/:session_id
+ *   GET /sessions/:session_id/messages
+ *   GET /sessions/:session_id/stream
+ */
+import type { HttpClient } from "../core/http";
+import type { SSEEvent } from "../core/sse";
+import type { SessionItem, ListMessagesQuery, PaginatedMessagesResponse, StreamQuery, SessionStreamEvent } from "../types/sessions.types";
+export declare class SessionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Get a session by ID. */
+    get(sessionId: string): Promise<SessionItem>;
+    /** Get messages for a session. */
+    getMessages(sessionId: string, query?: ListMessagesQuery): Promise<PaginatedMessagesResponse>;
+    /**
+     * Open an SSE stream for a session's messages.
+     *
+     * Returns an async iterable of typed SSE events (`connected`, `message`,
+     * `backfill_complete`, `session_ended`, `error`).
+     *
+     * @example
+     * ```ts
+     * for await (const event of client.sessions.stream(sessionId, { backfillLimit: 50 })) {
+     *   if (event.event === "message") {
+     *     console.log(event.data.role, event.data.content);
+     *   }
+     *   if (event.event === "session_ended") break;
+     * }
+     * ```
+     */
+    stream(sessionId: string, query?: StreamQuery): Promise<AsyncGenerator<SSEEvent<SessionStreamEvent["data"]>, void, undefined>>;
+}