@truefoundry/trueforge-sdk 0.1.0 → 0.1.2

package/README.md

@@ -1,15 +1,16 @@
-# Truefoundry TypeScript Library
+# TrueForge TypeScript Library
 
 [![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=Truefoundry%2FTypeScript)
 [![npm shield](https://img.shields.io/npm/v/@truefoundry/trueforge-sdk)](https://www.npmjs.com/package/@truefoundry/trueforge-sdk)
 
-TypeScript client for the TrueForge agent harness server: a self-hosted runtime that executes agent turns and streams them over Server-Sent Events.
+TypeScript client for the TrueForge Agent Harness Server: a self-hosted runtime that executes agent turns and streams them over Server-Sent Events.
 
 When auth is enabled on the server, pass an ID token via the optional `token` client option (`Authorization: Bearer`).
 
 
 ## Table of Contents
 
+- [Documentation](#documentation)
 - [Installation](#installation)
 - [Reference](#reference)
 - [Usage](#usage)
@@ -31,6 +32,10 @@ When auth is enabled on the server, pass an ID token via the optional `token` cl
   - [Runtime Compatibility](#runtime-compatibility)
 - [Contributing](#contributing)
 
+## Documentation
+
+API reference documentation is available [here](https://trueforge.dev/api/use-agent).
+
 ## Installation
 
 ```sh

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/trueforge-sdk",
-        "X-Fern-SDK-Version": "0.1.0",
-        "User-Agent": "@truefoundry/trueforge-sdk/0.1.0",
+        "X-Fern-SDK-Version": "0.1.2",
+        "User-Agent": "@truefoundry/trueforge-sdk/0.1.2",
         "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/api/resources/mcpServers/client/Client.d.ts

@@ -25,7 +25,7 @@ export declare class McpServersClient {
     list(requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListAvailableMcpServersResponse>;
     private __list;
     /**
-     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional redirect_url is where the OAuth callback then redirects the browser; without it the callback returns JSON.
+     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional return_to is where the OAuth callback then redirects the browser; without it the callback returns JSON.
      *
      * @param {string} name - MCP server name.
      * @param {TrueForge.AuthorizeMcpServersRequest} request
@@ -55,8 +55,8 @@ export declare class McpServersClient {
      * @throws {@link errors.TrueForgeTimeoutError}
      *
      * @example
-     *     await client.mcpServers.deleteAuthorize("name")
+     *     await client.mcpServers.deleteAuthorization("name")
      */
-    deleteAuthorize(name: string, requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetMcpServerResponse>;
-    private __deleteAuthorize;
+    deleteAuthorization(name: string, requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetMcpServerResponse>;
+    private __deleteAuthorization;
 }

package/dist/cjs/api/resources/mcpServers/client/Client.js

@@ -120,7 +120,7 @@ class McpServersClient {
         });
     }
     /**
-     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional redirect_url is where the OAuth callback then redirects the browser; without it the callback returns JSON.
+     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional return_to is where the OAuth callback then redirects the browser; without it the callback returns JSON.
      *
      * @param {string} name - MCP server name.
      * @param {TrueForge.AuthorizeMcpServersRequest} request
@@ -143,9 +143,9 @@ class McpServersClient {
     __authorize(name_1) {
         return __awaiter(this, arguments, void 0, function* (name, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { redirectUrl } = request;
+            const { returnTo } = request;
             const _queryParams = {
-                redirect_url: redirectUrl,
+                return_to: returnTo,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
@@ -240,12 +240,12 @@ class McpServersClient {
      * @throws {@link errors.TrueForgeTimeoutError}
      *
      * @example
-     *     await client.mcpServers.deleteAuthorize("name")
+     *     await client.mcpServers.deleteAuthorization("name")
      */
-    deleteAuthorize(name, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__deleteAuthorize(name, requestOptions));
+    deleteAuthorization(name, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deleteAuthorization(name, requestOptions));
     }
-    __deleteAuthorize(name, requestOptions) {
+    __deleteAuthorization(name, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             const _authRequest = yield this._options.authProvider.getAuthRequest();

package/dist/cjs/api/resources/mcpServers/client/requests/AuthorizeMcpServersRequest.d.ts

@@ -3,6 +3,6 @@
  *     {}
  */
 export interface AuthorizeMcpServersRequest {
-    /** Optional FE landing URL the OAuth callback redirects to, with `isSuccess`/`reason` appended. */
-    redirectUrl?: string;
+    /** Optional path to return to after OAuth. Must be a same-origin relative path; the OAuth callback redirects here with `isSuccess`/`reason` appended. */
+    returnTo?: string;
 }

package/dist/cjs/api/resources/sessions/client/Client.d.ts

@@ -171,6 +171,7 @@ export declare class SessionsClient {
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link TrueForge.NotFoundError}
      * @throws {@link TrueForge.PreconditionFailedError}
+     * @throws {@link TrueForge.ContentTooLargeError}
      * @throws {@link TrueForge.UnprocessableEntityError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}

package/dist/cjs/api/resources/sessions/client/Client.js

@@ -866,6 +866,14 @@ class SessionsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 413:
+                        throw new TrueForge.ContentTooLargeError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     case 422:
                         throw new TrueForge.UnprocessableEntityError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -900,6 +908,7 @@ class SessionsClient {
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link TrueForge.NotFoundError}
      * @throws {@link TrueForge.PreconditionFailedError}
+     * @throws {@link TrueForge.ContentTooLargeError}
      * @throws {@link TrueForge.UnprocessableEntityError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
@@ -980,6 +989,14 @@ class SessionsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 413:
+                        throw new TrueForge.ContentTooLargeError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     case 422:
                         throw new TrueForge.UnprocessableEntityError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION = "0.1.2";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "0.1.0";
+exports.SDK_VERSION = "0.1.2";

package/dist/esm/BaseClient.mjs

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

package/dist/esm/api/resources/mcpServers/client/Client.d.mts

@@ -25,7 +25,7 @@ export declare class McpServersClient {
     list(requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListAvailableMcpServersResponse>;
     private __list;
     /**
-     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional redirect_url is where the OAuth callback then redirects the browser; without it the callback returns JSON.
+     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional return_to is where the OAuth callback then redirects the browser; without it the callback returns JSON.
      *
      * @param {string} name - MCP server name.
      * @param {TrueForge.AuthorizeMcpServersRequest} request
@@ -55,8 +55,8 @@ export declare class McpServersClient {
      * @throws {@link errors.TrueForgeTimeoutError}
      *
      * @example
-     *     await client.mcpServers.deleteAuthorize("name")
+     *     await client.mcpServers.deleteAuthorization("name")
      */
-    deleteAuthorize(name: string, requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetMcpServerResponse>;
-    private __deleteAuthorize;
+    deleteAuthorization(name: string, requestOptions?: McpServersClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetMcpServerResponse>;
+    private __deleteAuthorization;
 }

package/dist/esm/api/resources/mcpServers/client/Client.mjs

@@ -84,7 +84,7 @@ export class McpServersClient {
         });
     }
     /**
-     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional redirect_url is where the OAuth callback then redirects the browser; without it the callback returns JSON.
+     * For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional return_to is where the OAuth callback then redirects the browser; without it the callback returns JSON.
      *
      * @param {string} name - MCP server name.
      * @param {TrueForge.AuthorizeMcpServersRequest} request
@@ -107,9 +107,9 @@ export class McpServersClient {
     __authorize(name_1) {
         return __awaiter(this, arguments, void 0, function* (name, request = {}, requestOptions) {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
-            const { redirectUrl } = request;
+            const { returnTo } = request;
             const _queryParams = {
-                redirect_url: redirectUrl,
+                return_to: returnTo,
             };
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
@@ -204,12 +204,12 @@ export class McpServersClient {
      * @throws {@link errors.TrueForgeTimeoutError}
      *
      * @example
-     *     await client.mcpServers.deleteAuthorize("name")
+     *     await client.mcpServers.deleteAuthorization("name")
      */
-    deleteAuthorize(name, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__deleteAuthorize(name, requestOptions));
+    deleteAuthorization(name, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__deleteAuthorization(name, requestOptions));
     }
-    __deleteAuthorize(name, requestOptions) {
+    __deleteAuthorization(name, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j;
             const _authRequest = yield this._options.authProvider.getAuthRequest();

package/dist/esm/api/resources/mcpServers/client/requests/AuthorizeMcpServersRequest.d.mts

@@ -3,6 +3,6 @@
  *     {}
  */
 export interface AuthorizeMcpServersRequest {
-    /** Optional FE landing URL the OAuth callback redirects to, with `isSuccess`/`reason` appended. */
-    redirectUrl?: string;
+    /** Optional path to return to after OAuth. Must be a same-origin relative path; the OAuth callback redirects here with `isSuccess`/`reason` appended. */
+    returnTo?: string;
 }

package/dist/esm/api/resources/sessions/client/Client.d.mts

@@ -171,6 +171,7 @@ export declare class SessionsClient {
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link TrueForge.NotFoundError}
      * @throws {@link TrueForge.PreconditionFailedError}
+     * @throws {@link TrueForge.ContentTooLargeError}
      * @throws {@link TrueForge.UnprocessableEntityError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}

package/dist/esm/api/resources/sessions/client/Client.mjs

@@ -830,6 +830,14 @@ export class SessionsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 413:
+                        throw new TrueForge.ContentTooLargeError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     case 422:
                         throw new TrueForge.UnprocessableEntityError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",
@@ -864,6 +872,7 @@ export class SessionsClient {
      * @throws {@link TrueForge.ForbiddenError}
      * @throws {@link TrueForge.NotFoundError}
      * @throws {@link TrueForge.PreconditionFailedError}
+     * @throws {@link TrueForge.ContentTooLargeError}
      * @throws {@link TrueForge.UnprocessableEntityError}
      * @throws {@link errors.TrueForgeError}
      * @throws {@link errors.TrueForgeTimeoutError}
@@ -944,6 +953,14 @@ export class SessionsClient {
                             skipValidation: true,
                             breadcrumbsPrefix: ["response"],
                         }), _response.rawResponse);
+                    case 413:
+                        throw new TrueForge.ContentTooLargeError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
+                            unrecognizedObjectKeys: "passthrough",
+                            allowUnrecognizedUnionMembers: true,
+                            allowUnrecognizedEnumValues: true,
+                            skipValidation: true,
+                            breadcrumbsPrefix: ["response"],
+                        }), _response.rawResponse);
                     case 422:
                         throw new TrueForge.UnprocessableEntityError(serializers.RequestErrorResponse.parseOrThrow(_response.error.body, {
                             unrecognizedObjectKeys: "passthrough",

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.0";
+export declare const SDK_VERSION = "0.1.2";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.1.0";
+export const SDK_VERSION = "0.1.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truefoundry/trueforge-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
   "type": "commonjs",
   "main": "./dist/cjs/index.js",
@@ -242,7 +242,7 @@
     "crypto": false
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=22"
   },
   "sideEffects": false,
   "license": "MIT",
@@ -250,15 +250,15 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/truefoundry/trueforge.git",
-    "directory": "packages/sdk"
+    "directory": "packages/trueforge-sdk"
   },
-  "homepage": "https://github.com/truefoundry/trueforge/tree/main/packages/sdk#readme",
+  "homepage": "https://github.com/truefoundry/trueforge/tree/main/packages/trueforge-sdk#readme",
   "bugs": {
     "url": "https://github.com/truefoundry/trueforge/issues"
   },
   "publishConfig": {
     "access": "public",
-    "provenance": false
+    "provenance": true
   },
   "scripts": {
     "format": "biome format --write --skip-parse-errors --no-errors-on-unmatched --max-diagnostics=none",

package/reference.md

@@ -563,7 +563,7 @@ await client.mcpServers.list();
 <dl>
 <dd>
 
-For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional redirect_url is where the OAuth callback then redirects the browser; without it the callback returns JSON.
+For servers without auth returns not_required, and for header credentials returns authenticated (no browser flow). For auth.type dcr, returns authenticated when a usable (or refreshable) token exists; otherwise runs DCR if needed and returns auth_required with an authorization URL. Optional return_to is where the OAuth callback then redirects the browser; without it the callback returns JSON.
 </dd>
 </dl>
 </dd>
@@ -622,7 +622,7 @@ await client.mcpServers.authorize("name");
 </dl>
 </details>
 
-<details><summary><code>client.mcpServers.<a href="/src/api/resources/mcpServers/client/Client.ts">deleteAuthorize</a>(name) -> TrueForge.GetMcpServerResponse</code></summary>
+<details><summary><code>client.mcpServers.<a href="/src/api/resources/mcpServers/client/Client.ts">deleteAuthorization</a>(name) -> TrueForge.GetMcpServerResponse</code></summary>
 <dl>
 <dd>
 
@@ -649,7 +649,7 @@ For auth.type dcr, deletes the stored OAuth token and returns the server with au
 <dd>
 
 ```typescript
-await client.mcpServers.deleteAuthorize("name");
+await client.mcpServers.deleteAuthorization("name");
 
 ```
 </dd>