truefoundry-gateway-sdk 0.0.2 → 0.1.0-rc.1

package/README.md

@@ -25,6 +25,7 @@ Call the gateway directly — not via the control-plane `/api/llm` proxy. The te
 - [Request and Response Types](#request-and-response-types)
 - [Exception Handling](#exception-handling)
 - [Streaming Response](#streaming-response)
+- [Pagination](#pagination)
 - [Advanced](#advanced)
   - [Subpackage Exports](#subpackage-exports)
   - [Additional Headers](#additional-headers)
@@ -91,12 +92,10 @@ A full reference for this library is available [here](https://github.com/truefou
 Instantiate and use the client with the following:
 
 ```typescript
-import { TruefoundryGatewayClient } from "truefoundry-gateway-sdk";
+import { TrueFoundryGateway } from "truefoundry-gateway-sdk";
 
-const client = new TruefoundryGatewayClient({ token: "YOUR_TOKEN" });
-const response = await client.agents.responses.create({
-    model: "model"
-});
+const client = new TrueFoundryGateway({ environment: "YOUR_BASE_URL", apiKey: "YOUR_API_KEY" });
+const response = await client.private.agents.sessions.createTurn("01arz3ndektsv4rrffq69g5fav.g");
 for await (const item of response) {
     console.log(item);
 }
@@ -104,25 +103,28 @@ for await (const item of response) {
 
 ## Environments
 
-This SDK allows you to configure different environments for API requests.
+Pass the gateway base URL (including your tenant) via the `environment` option:
 
 ```typescript
-import { TruefoundryGatewayClient, TruefoundryGatewayEnvironment } from "truefoundry-gateway-sdk";
+import { TrueFoundryGatewayClient } from "truefoundry-gateway-sdk";
 
-const client = new TruefoundryGatewayClient({
-    environment: TruefoundryGatewayEnvironment.Default,
+const client = new TrueFoundryGatewayClient({
+    apiKey: "YOUR_API_KEY",
+    environment: "https://gateway.truefoundry.ai/<tenant>",
 });
 ```
 
+You can also use `baseUrl` instead of `environment` if you prefer.
+
 ## Request and Response Types
 
 The SDK exports all request and response types as TypeScript interfaces. Simply import them with the
 following namespace:
 
 ```typescript
-import { TruefoundryGateway } from "truefoundry-gateway-sdk";
+import { TrueFoundryGateway } from "truefoundry-gateway-sdk";
 
-const request: TruefoundryGateway.ResponsesCancelRequest = {
+const request: TrueFoundryGateway.DraftSessionsListRequest = {
     ...
 };
 ```
@@ -133,12 +135,12 @@ When the API returns a non-success status code (4xx or 5xx response), a subclass
 will be thrown.
 
 ```typescript
-import { TruefoundryGatewayError } from "truefoundry-gateway-sdk";
+import { TrueFoundryGatewayError } from "truefoundry-gateway-sdk";
 
 try {
-    await client.agents.responses.create(...);
+    await client.private.agents.sessions.createTurn(...);
 } catch (err) {
-    if (err instanceof TruefoundryGatewayError) {
+    if (err instanceof TrueFoundryGatewayError) {
         console.log(err.statusCode);
         console.log(err.message);
         console.log(err.body);
@@ -153,17 +155,52 @@ Some endpoints return streaming responses instead of returning the full response
 The SDK uses async iterators, so you can consume the responses using a `for await...of` loop.
 
 ```typescript
-import { TruefoundryGatewayClient } from "truefoundry-gateway-sdk";
+import { TrueFoundryGateway } from "truefoundry-gateway-sdk";
 
-const client = new TruefoundryGatewayClient({ token: "YOUR_TOKEN" });
-const response = await client.agents.responses.create({
-    model: "model"
-});
+const client = new TrueFoundryGateway({ environment: "YOUR_BASE_URL", apiKey: "YOUR_API_KEY" });
+const response = await client.private.agents.sessions.createTurn("01arz3ndektsv4rrffq69g5fav.g");
 for await (const item of response) {
     console.log(item);
 }
 ```
 
+## Pagination
+
+List endpoints are paginated. The SDK provides an iterator so that you can simply loop over the items:
+
+```typescript
+import { TrueFoundryGateway } from "truefoundry-gateway-sdk";
+
+const client = new TrueFoundryGateway({ environment: "YOUR_BASE_URL", apiKey: "YOUR_API_KEY" });
+const pageableResponse = await client.private.agents.draftSessions.list({
+    agentName: "agent_name",
+    limit: 1,
+    order: "asc",
+    pageToken: "page_token",
+    startTimestamp: "start_timestamp",
+    endTimestamp: "end_timestamp"
+});
+for await (const item of pageableResponse) {
+    console.log(item);
+}
+
+// Or you can manually iterate page-by-page
+let page = await client.private.agents.draftSessions.list({
+    agentName: "agent_name",
+    limit: 1,
+    order: "asc",
+    pageToken: "page_token",
+    startTimestamp: "start_timestamp",
+    endTimestamp: "end_timestamp"
+});
+while (page.hasNextPage()) {
+    page = page.getNextPage();
+}
+
+// You can also access the underlying response
+const response = page.response;
+```
+
 ## Advanced
 
 ### Subpackage Exports
@@ -171,9 +208,9 @@ for await (const item of response) {
 This SDK supports direct imports of subpackage clients, which allows JavaScript bundlers to tree-shake and include only the imported subpackage code. This results in much smaller bundle sizes.
 
 ```typescript
-import { AgentsClient } from 'truefoundry-gateway-sdk/agents';
+import { PrivateClient } from 'truefoundry-gateway-sdk/private_';
 
-const client = new AgentsClient({...});
+const client = new PrivateClient({...});
 ```
 
 ### Additional Headers
@@ -181,16 +218,16 @@ const client = new AgentsClient({...});
 If you would like to send additional headers as part of the request, use the `headers` request option.
 
 ```typescript
-import { TruefoundryGatewayClient } from "truefoundry-gateway-sdk";
+import { TrueFoundryGateway } from "truefoundry-gateway-sdk";
 
-const client = new TruefoundryGatewayClient({
+const client = new TrueFoundryGateway({
     ...
     headers: {
         'X-Custom-Header': 'custom value'
     }
 });
 
-const response = await client.agents.responses.create(..., {
+const response = await client.private.agents.sessions.createTurn(..., {
     headers: {
         'X-Custom-Header': 'custom value'
     }
@@ -202,7 +239,7 @@ const response = await client.agents.responses.create(..., {
 If you would like to send additional query string parameters as part of the request, use the `queryParams` request option.
 
 ```typescript
-const response = await client.agents.responses.create(..., {
+const response = await client.private.agents.sessions.createTurn(..., {
     queryParams: {
         'customQueryParamKey': 'custom query param value'
     }
@@ -232,7 +269,7 @@ Which status codes are retried depends on the `retryStatusCodes` generator confi
 Use the `maxRetries` request option to configure this behavior.
 
 ```typescript
-const response = await client.agents.responses.create(..., {
+const response = await client.private.agents.sessions.createTurn(..., {
     maxRetries: 0 // override maxRetries at the request level
 });
 ```
@@ -242,7 +279,7 @@ const response = await client.agents.responses.create(..., {
 The SDK defaults to a 60 second timeout. Use the `timeoutInSeconds` option to configure this behavior.
 
 ```typescript
-const response = await client.agents.responses.create(..., {
+const response = await client.private.agents.sessions.createTurn(..., {
     timeoutInSeconds: 30 // override timeout to 30s
 });
 ```
@@ -253,7 +290,7 @@ The SDK allows users to abort requests at any point by passing in an abort signa
 
 ```typescript
 const controller = new AbortController();
-const response = await client.agents.responses.create(..., {
+const response = await client.private.agents.sessions.createTurn(..., {
     abortSignal: controller.signal
 });
 controller.abort(); // aborts the request
@@ -265,7 +302,7 @@ The SDK provides access to raw response data, including headers, through the `.w
 The `.withRawResponse()` method returns a promise that results to an object with a `data` and a `rawResponse` property.
 
 ```typescript
-const { data, rawResponse } = await client.agents.responses.create(...).withRawResponse();
+const { data, rawResponse } = await client.private.agents.sessions.createTurn(...).withRawResponse();
 
 console.log(data);
 console.log(rawResponse.headers['X-My-Header']);
@@ -276,9 +313,9 @@ console.log(rawResponse.headers['X-My-Header']);
 The SDK supports logging. You can configure the logger by passing in a `logging` object to the client options.
 
 ```typescript
-import { TruefoundryGatewayClient, logging } from "truefoundry-gateway-sdk";
+import { TrueFoundryGateway, logging } from "truefoundry-gateway-sdk";
 
-const client = new TruefoundryGatewayClient({
+const client = new TrueFoundryGateway({
     ...
     logging: {
         level: logging.LogLevel.Debug, // defaults to logging.LogLevel.Info
@@ -360,9 +397,9 @@ The SDK provides a way for you to customize the underlying HTTP client / Fetch f
 unsupported environment, this provides a way for you to break glass and ensure the SDK works.
 
 ```typescript
-import { TruefoundryGatewayClient } from "truefoundry-gateway-sdk";
+import { TrueFoundryGateway } from "truefoundry-gateway-sdk";
 
-const client = new TruefoundryGatewayClient({
+const client = new TrueFoundryGateway({
     ...
     fetcher: // provide your implementation here
 });

package/dist/cjs/BaseClient.d.ts

@@ -1,9 +1,8 @@
 import { BearerAuthProvider } from "./auth/BearerAuthProvider.js";
 import * as core from "./core/index.js";
-import type * as environments from "./environments.js";
 export type AuthOption = false | core.AuthProvider["getAuthRequest"] | core.AuthProvider | BearerAuthProvider.AuthOptions;
 export type BaseClientOptions = {
-    environment?: core.Supplier<environments.TruefoundryGatewayEnvironment | string>;
+    environment: core.Supplier<string>;
     /** Specify a custom URL to connect the client to. */
     baseUrl?: core.Supplier<string>;
     /** Additional headers to include in requests. */

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "truefoundry-gateway-sdk",
-        "X-Fern-SDK-Version": "0.0.2",
-        "User-Agent": "truefoundry-gateway-sdk/0.0.2",
+        "X-Fern-SDK-Version": "0.1.0-rc.1",
+        "User-Agent": "truefoundry-gateway-sdk/0.1.0-rc.1",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/Client.d.ts

@@ -1,17 +1,17 @@
-import { AgentsClient } from "./api/resources/agents/client/Client.js";
+import { PrivateClient } from "./api/resources/private/client/Client.js";
 import type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.js";
 import { type NormalizedClientOptionsWithAuth } from "./BaseClient.js";
 import * as core from "./core/index.js";
-export declare namespace TruefoundryGatewayClient {
+export declare namespace TrueFoundryGateway {
     type Options = BaseClientOptions;
     interface RequestOptions extends BaseRequestOptions {
     }
 }
-export declare class TruefoundryGatewayClient {
-    protected readonly _options: NormalizedClientOptionsWithAuth<TruefoundryGatewayClient.Options>;
-    protected _agents: AgentsClient | undefined;
-    constructor(options?: TruefoundryGatewayClient.Options);
-    get agents(): AgentsClient;
+export declare class TrueFoundryGateway {
+    protected readonly _options: NormalizedClientOptionsWithAuth<TrueFoundryGateway.Options>;
+    protected _private: PrivateClient | undefined;
+    constructor(options: TrueFoundryGateway.Options);
+    get private(): PrivateClient;
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
      * This is useful for making requests to endpoints not yet supported in the SDK.

package/dist/cjs/Client.js

@@ -43,17 +43,17 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TruefoundryGatewayClient = void 0;
-const Client_js_1 = require("./api/resources/agents/client/Client.js");
+exports.TrueFoundryGateway = void 0;
+const Client_js_1 = require("./api/resources/private/client/Client.js");
 const BaseClient_js_1 = require("./BaseClient.js");
 const core = __importStar(require("./core/index.js"));
-class TruefoundryGatewayClient {
-    constructor(options = {}) {
+class TrueFoundryGateway {
+    constructor(options) {
         this._options = (0, BaseClient_js_1.normalizeClientOptionsWithAuth)(options);
     }
-    get agents() {
+    get private() {
         var _a;
-        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = new Client_js_1.AgentsClient(this._options)));
+        return ((_a = this._private) !== null && _a !== void 0 ? _a : (this._private = new Client_js_1.PrivateClient(this._options)));
     }
     /**
      * Make a passthrough request using the SDK's configured auth, retry, logging, etc.
@@ -80,4 +80,4 @@ class TruefoundryGatewayClient {
         });
     }
 }
-exports.TruefoundryGatewayClient = TruefoundryGatewayClient;
+exports.TrueFoundryGateway = TrueFoundryGateway;

package/dist/cjs/CustomClient.d.ts

@@ -0,0 +1,16 @@
+import type { AgentsClient } from "./api/resources/private/resources/agents/client/Client.js";
+import { TrueFoundryGateway as BaseTrueFoundryGateway } from "./Client.js";
+import type * as core from "./core";
+export declare namespace TrueFoundryGateway {
+    type Options = Omit<BaseTrueFoundryGateway.Options, "environment"> & {
+        baseUrl: core.Supplier<string>;
+        environment?: core.Supplier<string>;
+    };
+    interface RequestOptions extends BaseTrueFoundryGateway.RequestOptions {
+    }
+}
+export declare class TrueFoundryGateway extends BaseTrueFoundryGateway {
+    protected _agents: AgentsClient | undefined;
+    constructor(_options: TrueFoundryGateway.Options);
+    get agents(): AgentsClient;
+}

package/dist/cjs/CustomClient.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TrueFoundryGateway = void 0;
+const Client_js_1 = require("./Client.js");
+class TrueFoundryGateway extends Client_js_1.TrueFoundryGateway {
+    constructor(_options) {
+        var _a;
+        const options = Object.assign(Object.assign({}, _options), { environment: (_a = _options.environment) !== null && _a !== void 0 ? _a : "" });
+        super(options);
+    }
+    get agents() {
+        var _a;
+        return ((_a = this._agents) !== null && _a !== void 0 ? _a : (this._agents = this.private.agents));
+    }
+}
+exports.TrueFoundryGateway = TrueFoundryGateway;

package/dist/cjs/agents/AgentSession.d.ts

@@ -0,0 +1,27 @@
+import type * as TrueFoundryGatewayApi from "../api/index.js";
+import type { SessionsClient } from "../api/resources/private/resources/agents/resources/sessions/client/Client.js";
+import type { TrueFoundryGateway } from "../CustomClient.js";
+import * as core from "../core/index.js";
+import { PreparedTurn } from "./PreparedTurn.js";
+import { Turn } from "./Turn.js";
+type RequestOptions = SessionsClient.RequestOptions;
+export declare class AgentSession implements TrueFoundryGatewayApi.Session {
+    #private;
+    readonly id: string;
+    readonly agentName: string;
+    readonly title?: string;
+    readonly createdBySubject: TrueFoundryGatewayApi.Subject;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    constructor(session: TrueFoundryGatewayApi.Session, client: TrueFoundryGateway);
+    prepareTurn(opts?: {
+        input?: TrueFoundryGatewayApi.TurnInputItem[];
+        previousTurnId?: TrueFoundryGatewayApi.PreviousTurnIdInput;
+    }): PreparedTurn;
+    listTurns(opts?: TrueFoundryGatewayApi.agents.SessionsListTurnsRequest, requestOptions?: RequestOptions): Promise<core.Page<Turn, TrueFoundryGatewayApi.ListTurnsResponse>>;
+    getTurn(opts: {
+        turnId: string;
+    }, requestOptions?: RequestOptions): Promise<Turn>;
+    cancel(requestOptions?: RequestOptions): Promise<void>;
+}
+export {};

package/dist/cjs/agents/AgentSession.js

@@ -0,0 +1,104 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _AgentSession_client;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentSession = void 0;
+const core = __importStar(require("../core/index.js"));
+const PreparedTurn_js_1 = require("./PreparedTurn.js");
+const Turn_js_1 = require("./Turn.js");
+class AgentSession {
+    constructor(session, client) {
+        _AgentSession_client.set(this, void 0);
+        this.id = session.id;
+        this.agentName = session.agentName;
+        this.title = session.title;
+        this.createdBySubject = session.createdBySubject;
+        this.createdAt = session.createdAt;
+        this.updatedAt = session.updatedAt;
+        __classPrivateFieldSet(this, _AgentSession_client, client, "f");
+    }
+    prepareTurn(opts) {
+        return new PreparedTurn_js_1.PreparedTurn({ input: opts === null || opts === void 0 ? void 0 : opts.input, previousTurnId: opts === null || opts === void 0 ? void 0 : opts.previousTurnId }, this, __classPrivateFieldGet(this, _AgentSession_client, "f"));
+    }
+    listTurns(opts, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const client = __classPrivateFieldGet(this, _AgentSession_client, "f");
+            const sessionId = this.id;
+            const page = yield client.agents.sessions.listTurns(sessionId, opts, requestOptions);
+            return new core.Page({
+                response: page.response,
+                rawResponse: page.rawResponse,
+                hasNextPage: (response) => !!(response === null || response === void 0 ? void 0 : response.pagination.nextPageToken),
+                getItems: (response) => { var _a; return ((_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []).map((turn) => new Turn_js_1.Turn(turn, this, client)); },
+                loadPage: (response) => core.HttpResponsePromise.fromPromise(client.agents.sessions
+                    .listTurns(sessionId, Object.assign(Object.assign({}, opts), { pageToken: response === null || response === void 0 ? void 0 : response.pagination.nextPageToken }), requestOptions)
+                    .then((nextPage) => ({ data: nextPage.response, rawResponse: nextPage.rawResponse }))),
+            });
+        });
+    }
+    getTurn(opts, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield __classPrivateFieldGet(this, _AgentSession_client, "f").agents.sessions.getTurn(this.id, opts.turnId, requestOptions);
+            return new Turn_js_1.Turn(response.data, this, __classPrivateFieldGet(this, _AgentSession_client, "f"));
+        });
+    }
+    cancel(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield __classPrivateFieldGet(this, _AgentSession_client, "f").agents.sessions.cancel(this.id, {}, requestOptions);
+        });
+    }
+}
+exports.AgentSession = AgentSession;
+_AgentSession_client = new WeakMap();

package/dist/cjs/agents/AgentSessionClient.d.ts

@@ -0,0 +1,18 @@
+import type * as TrueFoundryGatewayApi from "../api/index.js";
+import type { SessionsClient } from "../api/resources/private/resources/agents/resources/sessions/client/Client.js";
+import { TrueFoundryGateway } from "../CustomClient.js";
+import * as core from "../core/index.js";
+import { AgentSession } from "./AgentSession.js";
+export declare namespace AgentSessionClient {
+    type Options = TrueFoundryGateway.Options;
+    type RequestOptions = SessionsClient.RequestOptions;
+}
+export declare class AgentSessionClient {
+    private readonly client;
+    constructor(options: AgentSessionClient.Options);
+    createSession(opts: TrueFoundryGatewayApi.agents.CreateSessionRequest, requestOptions?: AgentSessionClient.RequestOptions): Promise<AgentSession>;
+    listSessions(opts: TrueFoundryGatewayApi.agents.SessionsListRequest, requestOptions?: AgentSessionClient.RequestOptions): Promise<core.Page<AgentSession, TrueFoundryGatewayApi.ListSessionsResponse>>;
+    getSession(opts: {
+        sessionId: string;
+    }, requestOptions?: AgentSessionClient.RequestOptions): Promise<AgentSession>;
+}

package/dist/cjs/agents/AgentSessionClient.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AgentSessionClient = void 0;
+const CustomClient_js_1 = require("../CustomClient.js");
+const core = __importStar(require("../core/index.js"));
+const AgentSession_js_1 = require("./AgentSession.js");
+class AgentSessionClient {
+    constructor(options) {
+        this.client = new CustomClient_js_1.TrueFoundryGateway(options);
+    }
+    createSession(opts, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.client.agents.sessions.create(opts, requestOptions);
+            return new AgentSession_js_1.AgentSession(response.data, this.client);
+        });
+    }
+    listSessions(opts, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const page = yield this.client.agents.sessions.list(opts, requestOptions);
+            const client = this.client;
+            return new core.Page({
+                response: page.response,
+                rawResponse: page.rawResponse,
+                hasNextPage: (response) => !!(response === null || response === void 0 ? void 0 : response.pagination.nextPageToken),
+                getItems: (response) => { var _a; return ((_a = response === null || response === void 0 ? void 0 : response.data) !== null && _a !== void 0 ? _a : []).map((session) => new AgentSession_js_1.AgentSession(session, client)); },
+                loadPage: (response) => core.HttpResponsePromise.fromPromise(client.agents.sessions
+                    .list(Object.assign(Object.assign({}, opts), { pageToken: response === null || response === void 0 ? void 0 : response.pagination.nextPageToken }), requestOptions)
+                    .then((nextPage) => ({
+                    data: nextPage.response,
+                    rawResponse: nextPage.rawResponse,
+                }))),
+            });
+        });
+    }
+    getSession(opts, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.client.agents.sessions.get(opts.sessionId, requestOptions);
+            return new AgentSession_js_1.AgentSession(response.data, this.client);
+        });
+    }
+}
+exports.AgentSessionClient = AgentSessionClient;

package/dist/cjs/agents/PreparedTurn.d.ts

@@ -0,0 +1,48 @@
+import type * as TrueFoundryGatewayApi from "../api/index.js";
+import type { SessionsClient } from "../api/resources/private/resources/agents/resources/sessions/client/Client.js";
+import type { TrueFoundryGateway } from "../CustomClient.js";
+import type * as core from "../core/index.js";
+import type { AgentSession } from "./AgentSession.js";
+import { type TurnStreamData } from "./TurnStreamData.js";
+type RequestOptions = SessionsClient.RequestOptions;
+export interface PreparedTurnInit {
+    input?: TrueFoundryGatewayApi.TurnInputItem[];
+    previousTurnId?: TrueFoundryGatewayApi.PreviousTurnIdInput;
+}
+export declare class PreparedTurn implements Partial<TrueFoundryGatewayApi.Turn> {
+    #private;
+    readonly session: AgentSession;
+    readonly sessionId: string;
+    constructor(init: PreparedTurnInit, session: AgentSession, client: TrueFoundryGateway);
+    get id(): string | undefined;
+    get previousTurnId(): string | undefined;
+    get state(): TrueFoundryGatewayApi.TurnState | undefined;
+    get createdBySubject(): TrueFoundryGatewayApi.Subject | undefined;
+    get createdAt(): string | undefined;
+    get input(): TrueFoundryGatewayApi.TurnInputItem[] | undefined;
+    execute(opts: {
+        stream: false;
+        pollIntervalMs?: number;
+    }, requestOptions?: RequestOptions): Promise<TrueFoundryGatewayApi.TurnState>;
+    execute(opts?: {
+        stream?: true;
+    }, requestOptions?: RequestOptions): AsyncIterable<TurnStreamData>;
+    stream(opts?: {
+        afterSequenceNumber?: number;
+    }, requestOptions?: RequestOptions): AsyncIterable<TurnStreamData>;
+    refresh(requestOptions?: RequestOptions): Promise<this>;
+    waitForCompletion(opts?: {
+        pollIntervalMs?: number;
+    }, requestOptions?: RequestOptions): Promise<TrueFoundryGatewayApi.TurnState>;
+    cancel(requestOptions?: RequestOptions): Promise<void>;
+    listEvents(opts?: TrueFoundryGatewayApi.agents.SessionsListTurnEventsRequest, requestOptions?: RequestOptions): Promise<core.Page<TrueFoundryGatewayApi.TurnEvent, TrueFoundryGatewayApi.ListEventsResponse>>;
+    private runStreaming;
+    private startAndWait;
+    private consumeStream;
+    private mustGetTurn;
+    private createTurnIfNotExist;
+    private openCreateTurn;
+    private adoptTurn;
+    private replaceTurnState;
+}
+export {};