truefoundry-gateway-sdk 0.0.0 → 0.0.2

package/dist/esm/errors/TruefoundryGatewayError.mjs

@@ -0,0 +1,31 @@
+// This file was auto-generated by Fern from our API Definition.
+import { toJson } from "../core/json.mjs";
+export class TruefoundryGatewayError extends Error {
+    constructor({ message, statusCode, body, rawResponse, cause, }) {
+        super(buildMessage({ message, statusCode, body }));
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+        this.statusCode = statusCode;
+        this.body = body;
+        this.rawResponse = rawResponse;
+        if (cause != null) {
+            this.cause = cause;
+        }
+    }
+}
+function buildMessage({ message, statusCode, body, }) {
+    const lines = [];
+    if (message != null) {
+        lines.push(message);
+    }
+    if (statusCode != null) {
+        lines.push(`Status code: ${statusCode.toString()}`);
+    }
+    if (body != null) {
+        lines.push(`Body: ${toJson(body, undefined, 2)}`);
+    }
+    return lines.join("\n");
+}

package/dist/esm/errors/TruefoundryGatewayTimeoutError.d.mts

@@ -0,0 +1,6 @@
+export declare class TruefoundryGatewayTimeoutError extends Error {
+    readonly cause?: unknown;
+    constructor(message: string, opts?: {
+        cause?: unknown;
+    });
+}

package/dist/esm/errors/TruefoundryGatewayTimeoutError.mjs

@@ -0,0 +1,14 @@
+// This file was auto-generated by Fern from our API Definition.
+export class TruefoundryGatewayTimeoutError extends Error {
+    constructor(message, opts) {
+        super(message);
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+        this.name = this.constructor.name;
+        if ((opts === null || opts === void 0 ? void 0 : opts.cause) != null) {
+            this.cause = opts.cause;
+        }
+    }
+}

package/dist/esm/errors/handleNonStatusCodeError.d.mts

@@ -0,0 +1,2 @@
+import type * as core from "../core/index.mjs";
+export declare function handleNonStatusCodeError(error: core.Fetcher.Error, rawResponse: core.RawResponse, method: string, path: string): never;

package/dist/esm/errors/handleNonStatusCodeError.mjs

@@ -0,0 +1,32 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as errors from "./index.mjs";
+export function handleNonStatusCodeError(error, rawResponse, method, path) {
+    switch (error.reason) {
+        case "non-json":
+            throw new errors.TruefoundryGatewayError({
+                statusCode: error.statusCode,
+                body: error.rawBody,
+                rawResponse: rawResponse,
+            });
+        case "body-is-null":
+            throw new errors.TruefoundryGatewayError({
+                statusCode: error.statusCode,
+                rawResponse: rawResponse,
+            });
+        case "timeout":
+            throw new errors.TruefoundryGatewayTimeoutError(`Timeout exceeded when calling ${method} ${path}.`, {
+                cause: error.cause,
+            });
+        case "unknown":
+            throw new errors.TruefoundryGatewayError({
+                message: error.errorMessage,
+                rawResponse: rawResponse,
+                cause: error.cause,
+            });
+        default:
+            throw new errors.TruefoundryGatewayError({
+                message: "Unknown error",
+                rawResponse: rawResponse,
+            });
+    }
+}

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

@@ -0,0 +1,2 @@
+export { TruefoundryGatewayError } from "./TruefoundryGatewayError.mjs";
+export { TruefoundryGatewayTimeoutError } from "./TruefoundryGatewayTimeoutError.mjs";

package/dist/esm/errors/index.mjs

@@ -0,0 +1,2 @@
+export { TruefoundryGatewayError } from "./TruefoundryGatewayError.mjs";
+export { TruefoundryGatewayTimeoutError } from "./TruefoundryGatewayTimeoutError.mjs";

package/dist/esm/exports.d.mts

@@ -0,0 +1 @@
+export * from "./core/exports.mjs";

package/dist/esm/exports.mjs

@@ -0,0 +1 @@
+export * from "./core/exports.mjs";

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

@@ -0,0 +1 @@
+export { type EnrichedAssistantMessage, type EnrichedToolCall, isAssistantDelta, mergeAssistantMessage, type ThinkingBlockUnion, } from "./mergeAssistantMessage.mjs";

package/dist/esm/helpers/index.mjs

@@ -0,0 +1 @@
+export { isAssistantDelta, mergeAssistantMessage, } from "./mergeAssistantMessage.mjs";

package/dist/esm/helpers/mergeAssistantMessage.d.mts

@@ -0,0 +1,80 @@
+/**
+ * Fold `agent.message` assistant-role chunks (`AgentLlmMessageDelta`) emitted
+ * by `client.agents.responses.create` into a single rolling
+ * `EnrichedAssistantMessage`.
+ *
+ * Pure reducer — pass the previous result back in for each chunk. Caller
+ * responsibilities (not handled here):
+ * - Filter with {@link isAssistantDelta} (skip tool-role messages and lifecycle events).
+ * - Reset `current` to `null` after each chunk with `finish_reason` (multiple turns per stream).
+ * - Key merge state by `execution_id` when parent/sub-agent streams interleave.
+ *
+ * Type names mirror the gateway's `src/agent/LLMTypes.ts`:
+ * `EnrichedAssistantMessage` (tool_calls carry `tool_info`), `EnrichedToolCall`,
+ * `ThinkingBlockUnion`. Behavior mirrors the gateway's
+ * `accumulateTokensFromChunk` reducer plus SDK-only fields (`refusal`,
+ * `tool_info`). `reasoning_content` is dropped (SSE-only; use
+ * `thinking_blocks` instead).
+ *
+ * Discrimination of thinking blocks and tool-call deltas is done via the
+ * `type` / `index` fields on the incoming objects, so this helper does not
+ * depend on Fern-generated discriminator class names that may shift across
+ * spec revisions.
+ */
+import type * as TruefoundryGateway from "../api/index.mjs";
+type Delta = TruefoundryGateway.AgentLlmMessageDelta;
+/** Folded thinking block — open until `signature` arrives, then closed. Mirrors gateway `ThinkingBlockUnion`. */
+export type ThinkingBlockUnion = {
+    type: "thinking";
+    thinking: string;
+    signature?: string;
+} | {
+    type: "redacted_thinking";
+    data: string;
+};
+/** One tool call slot, accumulated by stream `index`. Mirrors gateway `EnrichedToolCall`. */
+export interface EnrichedToolCall {
+    id: string;
+    type: "function";
+    function: {
+        name: string;
+        arguments: string;
+    };
+    /** First chunk with `tool_info` wins; later chunks do not overwrite. */
+    tool_info?: TruefoundryGateway.AgentMcpToolCallInfo;
+    /** First chunk with `provider_specific_fields` wins; later chunks do not overwrite. */
+    provider_specific_fields?: Record<string, unknown>;
+}
+/**
+ * Accumulated assistant message for one turn (until `finish_reason`). Mirrors
+ * the gateway's `EnrichedAssistantMessage` (`src/agent/LLMTypes.ts`):
+ * `tool_calls` carry `tool_info`, unlike the leaner `RawAssistantMessage`.
+ * Not populated by the merge helper: `created_at` (set by gateway on persist if needed).
+ */
+export interface EnrichedAssistantMessage {
+    type: "agent.message";
+    role: "assistant";
+    execution_id: string;
+    content?: string;
+    /** Concatenated across chunks (gateway does not fold this yet). */
+    refusal?: string;
+    thinking_blocks?: ThinkingBlockUnion[];
+    tool_calls?: EnrichedToolCall[];
+    /** Set from the chunk that carries `finish_reason`; may arrive without content. */
+    finish_reason?: TruefoundryGateway.AgentFinishReason | null;
+    created_at?: number;
+}
+/** True for assistant streaming deltas — `agent.message` that is not a tool result. */
+export declare function isAssistantDelta(event: {
+    type?: string;
+    role?: string;
+}): event is Delta;
+/**
+ * Merge one assistant delta into rolling state.
+ *
+ * @param current - Accumulated message so far, or `null` to start a new turn.
+ * @param chunk - A single `agent.message` assistant delta from the SSE stream.
+ * @returns Updated message. Does not reset on `finish_reason` — caller clears `current`.
+ */
+export declare function mergeAssistantMessage(current: EnrichedAssistantMessage | null, chunk: Delta): EnrichedAssistantMessage;
+export {};

package/dist/esm/helpers/mergeAssistantMessage.mjs

@@ -0,0 +1,65 @@
+/** True for assistant streaming deltas — `agent.message` that is not a tool result. */
+export function isAssistantDelta(event) {
+    return event.type === "agent.message" && event.role !== "tool";
+}
+/**
+ * Merge one assistant delta into rolling state.
+ *
+ * @param current - Accumulated message so far, or `null` to start a new turn.
+ * @param chunk - A single `agent.message` assistant delta from the SSE stream.
+ * @returns Updated message. Does not reset on `finish_reason` — caller clears `current`.
+ */
+export function mergeAssistantMessage(current, chunk) {
+    var _a, _b, _c, _d;
+    const m = current
+        ? Object.assign({}, current) : { type: "agent.message", role: "assistant", execution_id: chunk.execution_id, finish_reason: null };
+    if (chunk.content)
+        m.content = ((_a = m.content) !== null && _a !== void 0 ? _a : "") + chunk.content;
+    if (chunk.refusal)
+        m.refusal = ((_b = m.refusal) !== null && _b !== void 0 ? _b : "") + chunk.refusal;
+    if ((_c = chunk.thinking_blocks) === null || _c === void 0 ? void 0 : _c.length)
+        m.thinking_blocks = foldThinking(m.thinking_blocks, chunk.thinking_blocks);
+    if ((_d = chunk.tool_calls) === null || _d === void 0 ? void 0 : _d.length)
+        m.tool_calls = foldToolCalls(m.tool_calls, chunk.tool_calls);
+    if (chunk.finish_reason)
+        m.finish_reason = chunk.finish_reason;
+    return m;
+}
+function foldThinking(acc, incoming) {
+    var _a, _b;
+    const out = acc ? [...acc] : [];
+    for (const b of incoming) {
+        if (b.type === "redacted_thinking") {
+            out.push({ type: "redacted_thinking", data: b.data });
+            continue;
+        }
+        const last = out[out.length - 1];
+        if ((last === null || last === void 0 ? void 0 : last.type) === "thinking" && !last.signature) {
+            out[out.length - 1] = Object.assign({ type: "thinking", thinking: last.thinking + ((_a = b.thinking) !== null && _a !== void 0 ? _a : "") }, (b.signature && { signature: b.signature }));
+        }
+        else {
+            out.push(Object.assign({ type: "thinking", thinking: (_b = b.thinking) !== null && _b !== void 0 ? _b : "" }, (b.signature && { signature: b.signature })));
+        }
+    }
+    return out;
+}
+function foldToolCalls(acc, incoming) {
+    var _a, _b, _c;
+    const out = acc ? [...acc] : [];
+    const empty = () => ({ id: "", type: "function", function: { name: "", arguments: "" } });
+    for (const d of incoming) {
+        // Pad empty slots so tool_calls[index] is dense (mirrors Python helper).
+        while (out.length <= d.index) {
+            out.push(empty());
+        }
+        const cur = out[d.index];
+        out[d.index] = Object.assign(Object.assign(Object.assign(Object.assign({}, cur), { id: d.id || cur.id, function: {
+                name: ((_a = d.function) === null || _a === void 0 ? void 0 : _a.name) || cur.function.name,
+                arguments: cur.function.arguments + ((_c = (_b = d.function) === null || _b === void 0 ? void 0 : _b.arguments) !== null && _c !== void 0 ? _c : ""),
+            } }), (d.tool_info && !cur.tool_info && { tool_info: d.tool_info })), (d.provider_specific_fields &&
+            !cur.provider_specific_fields && {
+            provider_specific_fields: d.provider_specific_fields,
+        }));
+    }
+    return out;
+}

package/dist/esm/index.d.mts

@@ -0,0 +1,7 @@
+export * as TruefoundryGateway from "./api/index.mjs";
+export type { BaseClientOptions, BaseRequestOptions } from "./BaseClient.mjs";
+export { TruefoundryGatewayClient } from "./Client.mjs";
+export { TruefoundryGatewayEnvironment } from "./environments.mjs";
+export { TruefoundryGatewayError, TruefoundryGatewayTimeoutError } from "./errors/index.mjs";
+export * from "./exports.mjs";
+export { type EnrichedAssistantMessage, type EnrichedToolCall, isAssistantDelta, mergeAssistantMessage, type ThinkingBlockUnion, } from "./helpers/index.mjs";

package/dist/esm/index.mjs

@@ -1 +1,14 @@
-"use strict";
+// This file is hand-maintained (listed in .fernignore). It re-exports the
+// Fern-generated top-level symbols verbatim, plus our custom `helpers/`
+// barrel. When Fern adds or removes top-level exports in future regens, sync
+// the Fern-owned section below from `src/index.ts` on the
+// `release-v<version>` branch produced by the release workflow.
+//
+// Fern-generated exports (sync from regen):
+export * as TruefoundryGateway from "./api/index.mjs";
+export { TruefoundryGatewayClient } from "./Client.mjs";
+export { TruefoundryGatewayEnvironment } from "./environments.mjs";
+export { TruefoundryGatewayError, TruefoundryGatewayTimeoutError } from "./errors/index.mjs";
+export * from "./exports.mjs";
+// Hand-written helpers (.fernignore-protected):
+export { isAssistantDelta, mergeAssistantMessage, } from "./helpers/index.mjs";

package/dist/esm/version.d.mts

@@ -0,0 +1 @@
+export declare const SDK_VERSION = "0.0.2";

package/dist/esm/version.mjs

@@ -0,0 +1 @@
+export const SDK_VERSION = "0.0.2";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "truefoundry-gateway-sdk",
-    "version": "0.0.0",
+    "version": "0.0.2",
     "private": false,
     "repository": {
         "type": "git",
@@ -22,15 +22,49 @@
             },
             "default": "./dist/cjs/index.js"
         },
+        "./agents": {
+            "import": {
+                "types": "./dist/esm/api/resources/agents/exports.d.mts",
+                "default": "./dist/esm/api/resources/agents/exports.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/api/resources/agents/exports.d.ts",
+                "default": "./dist/cjs/api/resources/agents/exports.js"
+            },
+            "default": "./dist/cjs/api/resources/agents/exports.js"
+        },
+        "./agents/responses": {
+            "import": {
+                "types": "./dist/esm/api/resources/agents/resources/responses/exports.d.mts",
+                "default": "./dist/esm/api/resources/agents/resources/responses/exports.mjs"
+            },
+            "require": {
+                "types": "./dist/cjs/api/resources/agents/resources/responses/exports.d.ts",
+                "default": "./dist/cjs/api/resources/agents/resources/responses/exports.js"
+            },
+            "default": "./dist/cjs/api/resources/agents/resources/responses/exports.js"
+        },
         "./package.json": "./package.json"
     },
     "files": [
-        "dist"
+        "dist",
+        "reference.md",
+        "README.md",
+        "LICENSE"
     ],
     "scripts": {
+        "format": "biome format --write --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "format:check": "biome format --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "lint": "biome lint --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "lint:fix": "biome lint --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "check": "biome check --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
+        "check:fix": "biome check --fix --unsafe --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",
         "build": "pnpm build:cjs && pnpm build:esm",
         "build:cjs": "tsc --project ./tsconfig.cjs.json",
-        "build:esm": "tsc --project ./tsconfig.esm.json && node scripts/rename-to-esm-files.js dist/esm"
+        "build:esm": "tsc --project ./tsconfig.esm.json && node scripts/rename-to-esm-files.js dist/esm",
+        "test": "vitest",
+        "test:unit": "vitest --project unit",
+        "test:wire": "vitest --project wire"
     },
     "dependencies": {},
     "devDependencies": {

package/reference.md

@@ -0,0 +1,135 @@
+# Reference
+## Agents Responses
+<details><summary><code>client.agents.responses.<a href="/src/api/resources/agents/resources/responses/client/Client.ts">create</a>({ ...params }) -> core.Stream&lt;TruefoundryGateway.AgentResponseStreamingOutputEvent&gt;</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Execute an agent in stateful mode (responses are stored server-side by default). Use Named (`agent_name`) or Inline (`model`) input. Continue a conversation with `previous_response_id`. Responds with a Server-Sent Events stream of `AgentResponseStreamingOutputEvent` objects.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+const response = await client.agents.responses.create({
+    model: "model"
+});
+for await (const item of response) {
+    console.log(item);
+}
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `TruefoundryGateway.AgentResponsesBody` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ResponsesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.agents.responses.<a href="/src/api/resources/agents/resources/responses/client/Client.ts">cancel</a>({ ...params }) -> TruefoundryGateway.ResponsesCancelResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Cancel a running agent response. Requires the `response_id` returned from a prior stateful `/responses` call.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.agents.responses.cancel({
+    response_id: "response_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `TruefoundryGateway.agents.ResponsesCancelRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ResponsesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+