truefoundry-gateway-sdk 0.0.2 → 0.1.0

package/dist/esm/api/types/AgentResponsesInlineAgent.d.mts

@@ -1,16 +0,0 @@
-import type * as TruefoundryGateway from "../index.mjs";
-export interface AgentResponsesInlineAgent {
-    model: string;
-    instruction?: string | undefined;
-    messages?: TruefoundryGateway.AgentResponsesInlineAgentMessagesItem[] | undefined;
-    mcp_servers?: TruefoundryGateway.AgentMcpServerRequest[] | undefined;
-    model_params?: TruefoundryGateway.AgentModelParams | undefined;
-    response_format?: TruefoundryGateway.AgentResponsesFormat | undefined;
-    iteration_limit?: number | undefined;
-    skills?: TruefoundryGateway.AgentSkillMount[] | undefined;
-    sandbox?: TruefoundryGateway.AgentResponsesInlineAgentSandbox | undefined;
-    variables?: Record<string, string> | undefined;
-    /** ID of a prior stored response. Pass to continue a stateful conversation. */
-    previous_response_id?: string | undefined;
-    input?: TruefoundryGateway.AgentResponsesInput | undefined;
-}

package/dist/esm/api/types/AgentResponsesInlineAgentMessagesItem.d.mts

@@ -1,4 +0,0 @@
-export interface AgentResponsesInlineAgentMessagesItem {
-    role: "user";
-    content: string;
-}

package/dist/esm/api/types/AgentResponsesInlineAgentSandbox.d.mts

@@ -1,3 +0,0 @@
-export interface AgentResponsesInlineAgentSandbox {
-    enabled: boolean;
-}

package/dist/esm/api/types/AgentResponsesInput.d.mts

@@ -1,2 +0,0 @@
-import type * as TruefoundryGateway from "../index.mjs";
-export type AgentResponsesInput = TruefoundryGateway.AgentInputUserMessage[] | TruefoundryGateway.AgentApprovalOrToolResponseMessage[];

package/dist/esm/api/types/AgentResponsesSavedAgent.d.mts

@@ -1,8 +0,0 @@
-import type * as TruefoundryGateway from "../index.mjs";
-export interface AgentResponsesSavedAgent {
-    agent_name: string;
-    variables?: Record<string, string> | undefined;
-    /** ID of a prior stored response. Pass to continue a stateful conversation. */
-    previous_response_id?: string | undefined;
-    input?: TruefoundryGateway.AgentResponsesInput | undefined;
-}

package/dist/esm/api/types/AgentSandboxCreated.d.mts

@@ -1,4 +0,0 @@
-export interface AgentSandboxCreated {
-    type: "sandbox.created";
-    sandbox_id: string;
-}

package/dist/esm/api/types/AgentSkillMount.d.mts

@@ -1,6 +0,0 @@
-export interface AgentSkillMount {
-    /** Fully qualified name of the agent skill version. */
-    fqn: string;
-    /** If true, the SKILL.md content is injected into the agent context. */
-    preload_skill_md: boolean;
-}

package/dist/esm/api/types/AgentTextContentPart.d.mts

@@ -1,4 +0,0 @@
-export interface AgentTextContentPart {
-    type: "text";
-    text: string;
-}

package/dist/esm/api/types/AgentThinkingBlock.d.mts

@@ -1,5 +0,0 @@
-export interface AgentThinkingBlock {
-    type: "thinking";
-    thinking: string;
-    signature?: string | undefined;
-}

package/dist/esm/api/types/AgentToolCallRef.d.mts

@@ -1,3 +0,0 @@
-export interface AgentToolCallRef {
-    id: string;
-}

package/dist/esm/api/types/AgentToolMessage.d.mts

@@ -1,6 +0,0 @@
-import type * as TruefoundryGateway from "../index.mjs";
-export interface AgentToolMessage extends TruefoundryGateway.AgentLlmToolMessage {
-    type: "agent.message";
-    execution_id: string;
-    created_at?: number | undefined;
-}

package/dist/esm/api/types/AgentToolResponseRequired.d.mts

@@ -1,6 +0,0 @@
-import type * as TruefoundryGateway from "../index.mjs";
-export interface AgentToolResponseRequired {
-    type: "tool.response_required";
-    execution_id: string;
-    tool_calls: TruefoundryGateway.AgentToolCallRef[];
-}

package/dist/esm/environments.d.mts

@@ -1,4 +0,0 @@
-export declare const TruefoundryGatewayEnvironment: {
-    readonly Default: "https://gateway.truefoundry.ai/truefoundry";
-};
-export type TruefoundryGatewayEnvironment = typeof TruefoundryGatewayEnvironment.Default;

package/dist/esm/environments.mjs

@@ -1,4 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-export const TruefoundryGatewayEnvironment = {
-    Default: "https://gateway.truefoundry.ai/truefoundry",
-};

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

@@ -1,14 +0,0 @@
-import type * as core from "../core/index.mjs";
-export declare class TruefoundryGatewayError extends Error {
-    readonly statusCode?: number;
-    readonly body?: unknown;
-    readonly rawResponse?: core.RawResponse;
-    readonly cause?: unknown;
-    constructor({ message, statusCode, body, rawResponse, cause, }: {
-        message?: string;
-        statusCode?: number;
-        body?: unknown;
-        rawResponse?: core.RawResponse;
-        cause?: unknown;
-    });
-}

package/dist/esm/errors/TruefoundryGatewayError.mjs

@@ -1,31 +0,0 @@
-// 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

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

package/dist/esm/errors/TruefoundryGatewayTimeoutError.mjs

@@ -1,14 +0,0 @@
-// 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/helpers/index.d.mts

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

package/dist/esm/helpers/index.mjs

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

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

@@ -1,80 +0,0 @@
-/**
- * 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

@@ -1,65 +0,0 @@
-/** 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;
-}