truefoundry-gateway-sdk 0.0.2 → 0.1.0

package/dist/esm/agents/PreparedTurn.mjs

@@ -0,0 +1,229 @@
+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 __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncDelegator = (this && this.__asyncDelegator) || function (o) {
+    var i, p;
+    return i = {}, verb("next"), verb("throw", function (e) { throw e; }), verb("return"), i[Symbol.iterator] = function () { return this; }, i;
+    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; }
+};
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+var _PreparedTurn_client, _PreparedTurn_input, _PreparedTurn_previousTurnIdInput, _PreparedTurn_start, _PreparedTurn_turn;
+import { Turn } from "./Turn.mjs";
+import { parseSequenceNumber } from "./TurnStreamData.mjs";
+// Output of prepareTurn: not yet started (no HTTP). execute() fires the createTurn POST and mints
+// a real Turn (the only place the createTurn SSE lives), then delegates everything to that inner Turn.
+export class PreparedTurn {
+    constructor(init, session, client) {
+        _PreparedTurn_client.set(this, void 0);
+        _PreparedTurn_input.set(this, void 0);
+        _PreparedTurn_previousTurnIdInput.set(this, void 0); // server defaults to 'auto'
+        _PreparedTurn_start.set(this, void 0); // in-flight createTurn; also the one-shot latch
+        _PreparedTurn_turn.set(this, void 0); // the real Turn, created once started
+        this.session = session;
+        this.sessionId = session.id;
+        __classPrivateFieldSet(this, _PreparedTurn_client, client, "f");
+        __classPrivateFieldSet(this, _PreparedTurn_input, init.input, "f");
+        __classPrivateFieldSet(this, _PreparedTurn_previousTurnIdInput, init.previousTurnId, "f");
+    }
+    // Remaining data getters delegate to the inner Turn (undefined until started).
+    get id() {
+        var _a;
+        return (_a = __classPrivateFieldGet(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.id;
+    }
+    get previousTurnId() {
+        var _a;
+        return (_a = __classPrivateFieldGet(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.previousTurnId;
+    }
+    get state() {
+        var _a;
+        return (_a = __classPrivateFieldGet(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.state;
+    }
+    get createdBySubject() {
+        var _a;
+        return (_a = __classPrivateFieldGet(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.createdBySubject;
+    }
+    get createdAt() {
+        var _a;
+        return (_a = __classPrivateFieldGet(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.createdAt;
+    }
+    get input() {
+        var _a, _b;
+        return (_b = (_a = __classPrivateFieldGet(this, _PreparedTurn_turn, "f")) === null || _a === void 0 ? void 0 : _a.input) !== null && _b !== void 0 ? _b : __classPrivateFieldGet(this, _PreparedTurn_input, "f");
+    }
+    execute(opts, requestOptions) {
+        if (__classPrivateFieldGet(this, _PreparedTurn_start, "f") != null)
+            throw new Error("Turn already started; use stream() / waitForCompletion().");
+        __classPrivateFieldSet(this, _PreparedTurn_start, this.openCreateTurn(requestOptions), "f"); // POST fires now (synchronously), before we return
+        const { stream = true, pollIntervalMs } = opts !== null && opts !== void 0 ? opts : {};
+        return stream === false ? this.startAndWait(pollIntervalMs, requestOptions) : this.runStreaming();
+    }
+    // Post-execution behaviors. Each throws via mustGetTurn() until execute() has started the turn,
+    // then delegates to the inner Turn. stream() here is the re-subscribe path (subscribeToTurn).
+    stream(opts, requestOptions) {
+        return __asyncGenerator(this, arguments, function* stream_1() {
+            yield __await(yield* __asyncDelegator(__asyncValues(this.mustGetTurn().stream(opts, requestOptions))));
+        });
+    }
+    refresh(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.mustGetTurn().refresh(requestOptions);
+            return this;
+        });
+    }
+    waitForCompletion(opts, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.mustGetTurn().waitForCompletion(opts, requestOptions);
+        });
+    }
+    cancel(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.mustGetTurn().cancel(requestOptions);
+        });
+    }
+    listEvents(opts, requestOptions) {
+        return this.mustGetTurn().listEvents(opts, requestOptions);
+    }
+    // execute(stream:true) path: consume the already-open createTurn SSE (#start), adopting the inner Turn on turn.created.
+    runStreaming() {
+        return __asyncGenerator(this, arguments, function* runStreaming_1() {
+            yield __await(yield* __asyncDelegator(__asyncValues(this.consumeStream(yield __await(__classPrivateFieldGet(this, _PreparedTurn_start, "f"))))));
+        });
+    }
+    // execute(stream:false) path: drive the open createTurn SSE until turn.created mints the inner Turn, then poll to terminal.
+    startAndWait(pollIntervalMs, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const turn = yield this.createTurnIfNotExist();
+            return turn.waitForCompletion({ pollIntervalMs }, requestOptions);
+        });
+    }
+    // Consume an SSE stream, adopting the inner Turn from the first turn.created and yielding all events.
+    // Isolated so a future reconnect wrapper can re-open the stream (subscribeToTurn) on disconnect.
+    // NOTE: reconnect/resume is out of current scope.
+    consumeStream(sse) {
+        return __asyncGenerator(this, arguments, function* consumeStream_1() {
+            var _a, e_1, _b, _c;
+            try {
+                for (var _d = true, _e = __asyncValues(sse.withMetadata()), _f; _f = yield __await(_e.next()), _a = _f.done, !_a; _d = true) {
+                    _c = _f.value;
+                    _d = false;
+                    const { data: event, id } = _c;
+                    if (event.type === "turn.created" && __classPrivateFieldGet(this, _PreparedTurn_turn, "f") == null)
+                        this.adoptTurn(event); // ctor seeds #state = running
+                    else if (__classPrivateFieldGet(this, _PreparedTurn_turn, "f") != null && event.type === "turn.done")
+                        this.replaceTurnState(event.state); // rebuild the inner Turn with the terminal state (state changes are rare)
+                    yield yield __await({ sequenceNumber: parseSequenceNumber(id), event });
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+    // Returns the inner Turn or throws if execute() has not started it yet.
+    mustGetTurn() {
+        if (__classPrivateFieldGet(this, _PreparedTurn_turn, "f") == null) {
+            throw new Error("Turn not started yet; call execute() first.");
+        }
+        return __classPrivateFieldGet(this, _PreparedTurn_turn, "f");
+    }
+    // Drive the in-flight createTurn SSE (#start) only until the first turn.created has built the inner
+    // Turn, then break (which closes the underlying SSE via the generator's return()). Returns the Turn.
+    createTurnIfNotExist() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, e_2, _b, _c;
+            if (__classPrivateFieldGet(this, _PreparedTurn_turn, "f") == null) {
+                try {
+                    for (var _d = true, _e = __asyncValues(this.consumeStream(yield __classPrivateFieldGet(this, _PreparedTurn_start, "f"))), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                        _c = _f.value;
+                        _d = false;
+                        const _event = _c;
+                        if (__classPrivateFieldGet(this, _PreparedTurn_turn, "f") != null)
+                            break;
+                    }
+                }
+                catch (e_2_1) { e_2 = { error: e_2_1 }; }
+                finally {
+                    try {
+                        if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+                    }
+                    finally { if (e_2) throw e_2.error; }
+                }
+            }
+            return this.mustGetTurn();
+        });
+    }
+    // Open the createTurn SSE with the pending input/previousTurnId. Called synchronously by execute()
+    // so the POST is in flight (and #start latched) before execute returns.
+    openCreateTurn(requestOptions) {
+        return __classPrivateFieldGet(this, _PreparedTurn_client, "f").agents.sessions.createTurn(this.sessionId, { input: __classPrivateFieldGet(this, _PreparedTurn_input, "f"), previousTurnId: __classPrivateFieldGet(this, _PreparedTurn_previousTurnIdInput, "f") }, requestOptions);
+    }
+    // Build the inner Turn directly from the turn.created event (no extra getTurn round trip).
+    // The TurnCreatedEvent member of the TurnStreamingEvent union carries everything Turn needs.
+    // input comes from the request we sent (this.#input), not the event.
+    adoptTurn(event) {
+        __classPrivateFieldSet(this, _PreparedTurn_turn, new Turn({
+            id: event.turnId,
+            sessionId: this.sessionId,
+            previousTurnId: event.previousTurnId,
+            input: __classPrivateFieldGet(this, _PreparedTurn_input, "f"),
+            state: event.state,
+            createdBySubject: event.createdBy,
+            createdAt: event.createdAt,
+        }, this.session, __classPrivateFieldGet(this, _PreparedTurn_client, "f")), "f");
+    }
+    // Replace the inner Turn with a fresh one carrying the new state. State changes are rare, so
+    // rebuilding via Turn's own constructor (rather than mutating it) keeps Turn the source of truth.
+    replaceTurnState(state) {
+        const turn = this.mustGetTurn();
+        __classPrivateFieldSet(this, _PreparedTurn_turn, new Turn({
+            id: turn.id,
+            sessionId: turn.sessionId,
+            previousTurnId: turn.previousTurnId,
+            input: turn.input,
+            state,
+            createdBySubject: turn.createdBySubject,
+            createdAt: turn.createdAt,
+        }, this.session, __classPrivateFieldGet(this, _PreparedTurn_client, "f")), "f");
+    }
+}
+_PreparedTurn_client = new WeakMap(), _PreparedTurn_input = new WeakMap(), _PreparedTurn_previousTurnIdInput = new WeakMap(), _PreparedTurn_start = new WeakMap(), _PreparedTurn_turn = new WeakMap();

package/dist/esm/agents/Turn.d.mts

@@ -0,0 +1,30 @@
+import type * as TrueFoundryGatewayApi from "../api/index.mjs";
+import type { SessionsClient } from "../api/resources/private/resources/agents/resources/sessions/client/Client.mjs";
+import type { TrueFoundryGateway } from "../CustomClient.mjs";
+import type * as core from "../core/index.mjs";
+import type { AgentSession } from "./AgentSession.mjs";
+import { type TurnStreamData } from "./TurnStreamData.mjs";
+type RequestOptions = SessionsClient.RequestOptions;
+export declare class Turn implements TrueFoundryGatewayApi.Turn {
+    #private;
+    readonly id: string;
+    readonly sessionId: string;
+    readonly previousTurnId?: string;
+    readonly input?: TrueFoundryGatewayApi.TurnInputItem[];
+    readonly createdBySubject: TrueFoundryGatewayApi.Subject;
+    readonly createdAt: string;
+    readonly session: AgentSession;
+    constructor(turn: TrueFoundryGatewayApi.Turn, session: AgentSession, client: TrueFoundryGateway);
+    get state(): TrueFoundryGatewayApi.TurnState;
+    private isTerminal;
+    refresh(requestOptions?: RequestOptions): Promise<this>;
+    waitForCompletion(opts?: {
+        pollIntervalMs?: number;
+    }, requestOptions?: RequestOptions): Promise<TrueFoundryGatewayApi.TurnState>;
+    stream(opts?: {
+        afterSequenceNumber?: number;
+    }, requestOptions?: RequestOptions): AsyncIterable<TurnStreamData>;
+    cancel(requestOptions?: RequestOptions): Promise<void>;
+    listEvents(opts?: TrueFoundryGatewayApi.agents.SessionsListTurnEventsRequest, requestOptions?: RequestOptions): Promise<core.Page<TrueFoundryGatewayApi.TurnEvent, TrueFoundryGatewayApi.ListEventsResponse>>;
+}
+export {};

package/dist/esm/agents/Turn.mjs

@@ -0,0 +1,138 @@
+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 __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
+var _Turn_instances, _Turn_client, _Turn_state, _Turn_applyEvent;
+import { parseSequenceNumber } from "./TurnStreamData.mjs";
+// waitForCompletion poll interval: default and enforced minimum.
+const DEFAULT_POLL_INTERVAL_MS = 3000;
+const MIN_POLL_INTERVAL_MS = 3000;
+// Output of listTurns / getTurn (and what PreparedTurn mints once started): a started turn that
+// owns all data AND behavior. Identity fields are immutable readonly; the volatile field
+// (state) is getter-backed and updated in place by refresh()/waitForCompletion().
+export class Turn {
+    constructor(turn, session, client) {
+        _Turn_instances.add(this);
+        _Turn_client.set(this, void 0);
+        _Turn_state.set(this, void 0);
+        this.id = turn.id;
+        this.sessionId = turn.sessionId;
+        this.previousTurnId = turn.previousTurnId;
+        this.input = turn.input;
+        this.createdBySubject = turn.createdBySubject;
+        this.createdAt = turn.createdAt;
+        __classPrivateFieldSet(this, _Turn_state, turn.state, "f");
+        this.session = session;
+        __classPrivateFieldSet(this, _Turn_client, client, "f");
+    }
+    get state() {
+        return __classPrivateFieldGet(this, _Turn_state, "f");
+    }
+    // Terminal states are listed explicitly (not `status !== "running"`) so a newly added
+    // non-terminal status keeps polling by default; new terminal states must be added here.
+    isTerminal(state) {
+        switch (state.status) {
+            case "done":
+            case "cancelled":
+            case "error":
+                return true;
+            default:
+                return false;
+        }
+    }
+    // Refetch from the server, update #state in place, and return self.
+    refresh(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield __classPrivateFieldGet(this, _Turn_client, "f").agents.sessions.getTurn(this.sessionId, this.id, requestOptions);
+            __classPrivateFieldSet(this, _Turn_state, response.data.state, "f");
+            return this;
+        });
+    }
+    waitForCompletion(opts, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const pollIntervalMs = (_a = opts === null || opts === void 0 ? void 0 : opts.pollIntervalMs) !== null && _a !== void 0 ? _a : DEFAULT_POLL_INTERVAL_MS;
+            if (pollIntervalMs < MIN_POLL_INTERVAL_MS) {
+                throw new Error(`pollIntervalMs must be at least ${MIN_POLL_INTERVAL_MS}ms`);
+            }
+            while (!this.isTerminal(__classPrivateFieldGet(this, _Turn_state, "f"))) {
+                yield new Promise((r) => setTimeout(r, pollIntervalMs));
+                yield this.refresh(requestOptions);
+            }
+            return __classPrivateFieldGet(this, _Turn_state, "f");
+        });
+    }
+    // Reconnect to the turn's SSE; let the server decide what to stream (no client-side guard).
+    // Updates #state in place from any event that carries a state snapshot.
+    stream(opts, requestOptions) {
+        return __asyncGenerator(this, arguments, function* stream_1() {
+            var _a, e_1, _b, _c;
+            const sse = yield __await(__classPrivateFieldGet(this, _Turn_client, "f").agents.sessions.subscribeToTurn(this.sessionId, this.id, { afterSequenceNumber: opts === null || opts === void 0 ? void 0 : opts.afterSequenceNumber }, requestOptions));
+            try {
+                for (var _d = true, _e = __asyncValues(sse.withMetadata()), _f; _f = yield __await(_e.next()), _a = _f.done, !_a; _d = true) {
+                    _c = _f.value;
+                    _d = false;
+                    const { data: event, id } = _c;
+                    __classPrivateFieldGet(this, _Turn_instances, "m", _Turn_applyEvent).call(this, event);
+                    yield yield __await({ sequenceNumber: parseSequenceNumber(id), event });
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) yield __await(_b.call(_e));
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+        });
+    }
+    cancel(requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield __classPrivateFieldGet(this, _Turn_client, "f").agents.sessions.cancel(this.sessionId, {}, requestOptions);
+        });
+    }
+    // Expose the autogen Fern Page as-is (it is already async-iterable); no re-wrapping.
+    listEvents(opts, requestOptions) {
+        return __classPrivateFieldGet(this, _Turn_client, "f").agents.sessions.listTurnEvents(this.sessionId, this.id, opts, requestOptions);
+    }
+}
+_Turn_client = new WeakMap(), _Turn_state = new WeakMap(), _Turn_instances = new WeakSet(), _Turn_applyEvent = function _Turn_applyEvent(event) {
+    if (event.type === "turn.created" || event.type === "turn.done")
+        __classPrivateFieldSet(this, _Turn_state, event.state, "f");
+};

package/dist/esm/agents/TurnStreamData.d.mts

@@ -0,0 +1,6 @@
+import type * as TrueFoundryGatewayApi from "../api/index.mjs";
+export interface TurnStreamData {
+    sequenceNumber: number;
+    event: TrueFoundryGatewayApi.TurnStreamingEvent;
+}
+export declare function parseSequenceNumber(id: string | undefined): number;

package/dist/esm/agents/TurnStreamData.mjs

@@ -0,0 +1,10 @@
+export function parseSequenceNumber(id) {
+    if (!id) {
+        throw new Error("Missing SSE sequence number id.");
+    }
+    const parsed = Number(id);
+    if (!Number.isFinite(parsed)) {
+        throw new Error(`Invalid SSE sequence number id: "${id}".`);
+    }
+    return parsed;
+}

package/dist/esm/agents/eventDelta.d.mts

@@ -0,0 +1,5 @@
+import type * as TrueFoundryGatewayApi from "../api/index.mjs";
+/** Union of all streaming delta events. Expand this as more `.delta` events are added. */
+export type DeltaEvents = TrueFoundryGatewayApi.ModelMessageDeltaEvent;
+export declare function isEventDelta(event: TrueFoundryGatewayApi.TurnStreamingEvent): event is DeltaEvents;
+export declare function mergeEventDelta(base: TrueFoundryGatewayApi.TurnEvent, delta: DeltaEvents): void;

package/dist/esm/agents/eventDelta.mjs

@@ -0,0 +1,68 @@
+export function isEventDelta(event) {
+    return typeof event.type === "string" && event.type.endsWith(".delta");
+}
+export function mergeEventDelta(base, delta) {
+    if (base.id !== delta.id) {
+        throw new Error(`Cannot merge delta into a different event: base id "${base.id}" != delta id "${delta.id}".`);
+    }
+    if (delta.type === "model.message.delta" && base.type === "model.message") {
+        mergeModelMessageDelta(base, delta);
+    }
+}
+function mergeModelMessageDelta(base, delta) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+    if (delta.content) {
+        if (base.content === undefined || typeof base.content === "string") {
+            base.content = ((_a = base.content) !== null && _a !== void 0 ? _a : "") + delta.content;
+        }
+        else {
+            const last = base.content[base.content.length - 1];
+            if (last && last.type === "text") {
+                last.text += delta.content;
+            }
+            else {
+                base.content.push({ type: "text", text: delta.content });
+            }
+        }
+    }
+    if (delta.refusal) {
+        base.refusal = ((_b = base.refusal) !== null && _b !== void 0 ? _b : "") + delta.refusal;
+    }
+    if (delta.toolCalls) {
+        (_c = base.toolCalls) !== null && _c !== void 0 ? _c : (base.toolCalls = []);
+        for (const d of delta.toolCalls) {
+            let tc = base.toolCalls[d.index];
+            if (tc === undefined) {
+                tc = Object.assign({ id: (_d = d.id) !== null && _d !== void 0 ? _d : "", type: ((_e = d.type) !== null && _e !== void 0 ? _e : "function"), function: { name: (_g = (_f = d.function) === null || _f === void 0 ? void 0 : _f.name) !== null && _g !== void 0 ? _g : "", arguments: "" } }, (d.toolInfo != null ? { toolInfo: d.toolInfo } : {}));
+                base.toolCalls[d.index] = tc;
+            }
+            if (d.id) {
+                tc.id = d.id;
+            }
+            if (d.type) {
+                tc.type = d.type;
+            }
+            if ((_h = d.function) === null || _h === void 0 ? void 0 : _h.name) {
+                tc.function.name = d.function.name;
+            }
+            if ((_j = d.function) === null || _j === void 0 ? void 0 : _j.arguments) {
+                tc.function.arguments += d.function.arguments;
+            }
+            if (d.toolInfo) {
+                tc.toolInfo = d.toolInfo;
+            }
+            if (d.providerSpecificFields) {
+                tc.providerSpecificFields = Object.assign(Object.assign({}, ((_k = tc.providerSpecificFields) !== null && _k !== void 0 ? _k : {})), d.providerSpecificFields);
+            }
+        }
+    }
+    if (delta.finishReason) {
+        base.finishReason = delta.finishReason;
+    }
+    if (delta.reasoningContent) {
+        base.reasoningContent = ((_l = base.reasoningContent) !== null && _l !== void 0 ? _l : "") + delta.reasoningContent;
+    }
+    if (delta.usage) {
+        base.usage = delta.usage;
+    }
+}

package/dist/esm/agents/index.d.mts

@@ -0,0 +1,8 @@
+export type { ActionRequiredEvent, McpAuthRequiredEvent, McpInitializeEvent, ModelMessageDeltaEvent, ModelMessageEvent, ModelMessageUsage, ModelMessageUsageInputTokensBreakdown, SandboxCreatedEvent, ThreadCreatedEvent, ThreadDoneEvent, ToolApprovalRequiredEvent, ToolCall, ToolResponseEvent, ToolResponseRequiredEvent, TurnCreatedEvent, TurnDoneEvent, TurnDoneEventState, TurnEvent, TurnInputItem, TurnState, TurnStateCancelled, TurnStateCancelledReason, TurnStateDone, TurnStateError, TurnStateRunning, TurnStreamingEvent, UserToolApprovalEvent, UserToolResponseEvent, } from "../api/index.mjs";
+export type { AgentSession } from "./AgentSession.mjs";
+export { AgentSessionClient } from "./AgentSessionClient.mjs";
+export type { DeltaEvents } from "./eventDelta.mjs";
+export { isEventDelta, mergeEventDelta } from "./eventDelta.mjs";
+export type { PreparedTurn } from "./PreparedTurn.mjs";
+export type { Turn } from "./Turn.mjs";
+export type { TurnStreamData } from "./TurnStreamData.mjs";

package/dist/esm/agents/index.mjs

@@ -0,0 +1,2 @@
+export { AgentSessionClient } from "./AgentSessionClient.mjs";
+export { isEventDelta, mergeEventDelta } from "./eventDelta.mjs";

package/dist/esm/api/errors/BadRequestError.d.mts

@@ -1,6 +1,6 @@
 import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-import type * as TruefoundryGateway from "../index.mjs";
-export declare class BadRequestError extends errors.TruefoundryGatewayError {
-    constructor(body: TruefoundryGateway.RequestErrorResponse, rawResponse?: core.RawResponse);
+import type * as TrueFoundryGateway from "../index.mjs";
+export declare class BadRequestError extends errors.TrueFoundryGatewayError {
+    constructor(body: TrueFoundryGateway.RequestErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/BadRequestError.mjs

@@ -1,6 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
-export class BadRequestError extends errors.TruefoundryGatewayError {
+export class BadRequestError extends errors.TrueFoundryGatewayError {
     constructor(body, rawResponse) {
         super({
             message: "BadRequestError",
@@ -12,6 +12,6 @@ export class BadRequestError extends errors.TruefoundryGatewayError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "BadRequestError";
     }
 }

package/dist/esm/api/errors/ConflictError.d.mts

@@ -0,0 +1,6 @@
+import type * as core from "../../core/index.mjs";
+import * as errors from "../../errors/index.mjs";
+import type * as TrueFoundryGateway from "../index.mjs";
+export declare class ConflictError extends errors.TrueFoundryGatewayError {
+    constructor(body: TrueFoundryGateway.RequestErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/ConflictError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.mjs";
+export class ConflictError extends errors.TrueFoundryGatewayError {
+    constructor(body, rawResponse) {
+        super({
+            message: "ConflictError",
+            statusCode: 409,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = "ConflictError";
+    }
+}

package/dist/esm/api/errors/FailedDependencyError.d.mts

@@ -1,5 +1,6 @@
 import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-export declare class FailedDependencyError extends errors.TruefoundryGatewayError {
-    constructor(body?: unknown, rawResponse?: core.RawResponse);
+import type * as TrueFoundryGateway from "../index.mjs";
+export declare class FailedDependencyError extends errors.TrueFoundryGatewayError {
+    constructor(body: TrueFoundryGateway.RequestErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/FailedDependencyError.mjs

@@ -1,6 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
-export class FailedDependencyError extends errors.TruefoundryGatewayError {
+export class FailedDependencyError extends errors.TrueFoundryGatewayError {
     constructor(body, rawResponse) {
         super({
             message: "FailedDependencyError",
@@ -12,6 +12,6 @@ export class FailedDependencyError extends errors.TruefoundryGatewayError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "FailedDependencyError";
     }
 }

package/dist/esm/api/errors/ForbiddenError.d.mts

@@ -1,6 +1,6 @@
 import type * as core from "../../core/index.mjs";
 import * as errors from "../../errors/index.mjs";
-import type * as TruefoundryGateway from "../index.mjs";
-export declare class ForbiddenError extends errors.TruefoundryGatewayError {
-    constructor(body: TruefoundryGateway.RequestErrorResponse, rawResponse?: core.RawResponse);
+import type * as TrueFoundryGateway from "../index.mjs";
+export declare class ForbiddenError extends errors.TrueFoundryGatewayError {
+    constructor(body: TrueFoundryGateway.RequestErrorResponse, rawResponse?: core.RawResponse);
 }

package/dist/esm/api/errors/ForbiddenError.mjs

@@ -1,6 +1,6 @@
 // This file was auto-generated by Fern from our API Definition.
 import * as errors from "../../errors/index.mjs";
-export class ForbiddenError extends errors.TruefoundryGatewayError {
+export class ForbiddenError extends errors.TrueFoundryGatewayError {
     constructor(body, rawResponse) {
         super({
             message: "ForbiddenError",
@@ -12,6 +12,6 @@ export class ForbiddenError extends errors.TruefoundryGatewayError {
         if (Error.captureStackTrace) {
             Error.captureStackTrace(this, this.constructor);
         }
-        this.name = this.constructor.name;
+        this.name = "ForbiddenError";
     }
 }

package/dist/esm/api/errors/GatewayTimeoutError.d.mts

@@ -0,0 +1,6 @@
+import type * as core from "../../core/index.mjs";
+import * as errors from "../../errors/index.mjs";
+import type * as TrueFoundryGateway from "../index.mjs";
+export declare class GatewayTimeoutError extends errors.TrueFoundryGatewayError {
+    constructor(body: TrueFoundryGateway.RequestErrorResponse, rawResponse?: core.RawResponse);
+}

package/dist/esm/api/errors/GatewayTimeoutError.mjs

@@ -0,0 +1,17 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "../../errors/index.mjs";
+export class GatewayTimeoutError extends errors.TrueFoundryGatewayError {
+    constructor(body, rawResponse) {
+        super({
+            message: "GatewayTimeoutError",
+            statusCode: 504,
+            body: body,
+            rawResponse: rawResponse,
+        });
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = "GatewayTimeoutError";
+    }
+}