@truefoundry/trueforge-sdk 0.1.4-rc.2 → 0.2.0-rc.4

package/dist/esm/serialization/types/SkillVersion.d.mts

@@ -0,0 +1,12 @@
+import type * as TrueForge from "../../api/index.mjs";
+import * as core from "../../core/index.mjs";
+import type * as serializers from "../index.mjs";
+export declare const SkillVersion: core.serialization.ObjectSchema<serializers.SkillVersion.Raw, TrueForge.SkillVersion>;
+export declare namespace SkillVersion {
+    interface Raw {
+        description: string;
+        display_name: string;
+        name: string;
+        version: number;
+    }
+}

package/dist/esm/serialization/types/SkillVersion.mjs

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.mjs";
+export const SkillVersion = core.serialization.object({
+    description: core.serialization.string(),
+    displayName: core.serialization.property("display_name", core.serialization.string()),
+    name: core.serialization.string(),
+    version: core.serialization.number(),
+});

package/dist/esm/serialization/types/TrueFoundryRegistrySkill.d.mts

@@ -0,0 +1,14 @@
+import type * as TrueForge from "../../api/index.mjs";
+import * as core from "../../core/index.mjs";
+import type * as serializers from "../index.mjs";
+export declare const TrueFoundryRegistrySkill: core.serialization.ObjectSchema<serializers.TrueFoundryRegistrySkill.Raw, TrueForge.TrueFoundryRegistrySkill>;
+export declare namespace TrueFoundryRegistrySkill {
+    interface Raw {
+        description: string;
+        display_name: string;
+        name: string;
+        repository_name: string;
+        type: "truefoundry";
+        version: number;
+    }
+}

package/dist/esm/serialization/types/TrueFoundryRegistrySkill.mjs

@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+import * as core from "../../core/index.mjs";
+export const TrueFoundryRegistrySkill = core.serialization.object({
+    description: core.serialization.string(),
+    displayName: core.serialization.property("display_name", core.serialization.string()),
+    name: core.serialization.string(),
+    repositoryName: core.serialization.property("repository_name", core.serialization.string()),
+    type: core.serialization.stringLiteral("truefoundry"),
+    version: core.serialization.number(),
+});

package/dist/esm/serialization/types/index.d.mts

@@ -27,6 +27,7 @@ export * from "./CatalogModel.mjs";
 export * from "./CatalogModelProvider.mjs";
 export * from "./CatalogSandboxProvider.mjs";
 export * from "./CatalogSkill.mjs";
+export * from "./CatalogSkillType.mjs";
 export * from "./CatalogWellKnownModelProvider.mjs";
 export * from "./CatalogWellKnownModelProviderType.mjs";
 export * from "./ChatCompletionChunkDeltaToolCall.mjs";
@@ -58,6 +59,7 @@ export * from "./FireworksModelProvider.mjs";
 export * from "./GenerativeUiConfig.mjs";
 export * from "./GetAgentCodeSnippetsResponse.mjs";
 export * from "./GetAgentResponse.mjs";
+export * from "./GetAvailableMcpServerResponse.mjs";
 export * from "./GetCapabilitiesResponse.mjs";
 export * from "./GetMcpServerCatalogResponse.mjs";
 export * from "./GetMcpServerResponse.mjs";
@@ -75,6 +77,7 @@ export * from "./GetSessionResponse.mjs";
 export * from "./GetSkillCatalogResponse.mjs";
 export * from "./GetSkillResponse.mjs";
 export * from "./GetTurnResponse.mjs";
+export * from "./GitSkill.mjs";
 export * from "./GoogleGeminiModelProvider.mjs";
 export * from "./InitialUserMessage.mjs";
 export * from "./InputTokensCompactionTrigger.mjs";
@@ -86,12 +89,14 @@ export * from "./ListAvailableSkillsResponse.mjs";
 export * from "./ListMcpServersResponse.mjs";
 export * from "./ListMcpServerToolsResponse.mjs";
 export * from "./ListModelProvidersResponse.mjs";
+export * from "./ListPermissionsResponse.mjs";
 export * from "./ListScheduleRunsResponse.mjs";
 export * from "./ListSchedulesResponse.mjs";
 export * from "./ListSessionEventsResponse.mjs";
 export * from "./ListSessionsOrder.mjs";
 export * from "./ListSessionsResponse.mjs";
 export * from "./ListSkillsResponse.mjs";
+export * from "./ListSkillVersionsResponse.mjs";
 export * from "./ListTurnEventsOrder.mjs";
 export * from "./ListTurnEventsResponse.mjs";
 export * from "./ListTurnsResponse.mjs";
@@ -130,12 +135,14 @@ export * from "./ModelProviderAuth.mjs";
 export * from "./ModelProviderManifest.mjs";
 export * from "./MoonshotModelProvider.mjs";
 export * from "./OpenAiModelProvider.mjs";
+export * from "./PermissionResourceType.mjs";
 export * from "./PreviousTurnIdInput.mjs";
 export * from "./RawToolCall.mjs";
 export * from "./ReasoningEffort.mjs";
 export * from "./RequestErrorResponse.mjs";
 export * from "./RequestErrorResponseError.mjs";
 export * from "./ResourceName.mjs";
+export * from "./ResourcePermission.mjs";
 export * from "./ResponseFormat.mjs";
 export * from "./ResponseFormatJsonObject.mjs";
 export * from "./ResponseFormatJsonSchema.mjs";
@@ -179,7 +186,7 @@ export * from "./SettingsCapability.mjs";
 export * from "./Skill.mjs";
 export * from "./SkillCapability.mjs";
 export * from "./SkillManifest.mjs";
-export * from "./SkillType.mjs";
+export * from "./SkillVersion.mjs";
 export * from "./TextContent.mjs";
 export * from "./ThreadCreatedEvent.mjs";
 export * from "./ThreadDoneEvent.mjs";
@@ -196,6 +203,7 @@ export * from "./ToolInfo.mjs";
 export * from "./ToolResponseEvent.mjs";
 export * from "./ToolResponseRequiredEvent.mjs";
 export * from "./TrueFoundryModelProvider.mjs";
+export * from "./TrueFoundryRegistrySkill.mjs";
 export * from "./TrueFoundrySystemToolInfo.mjs";
 export * from "./Turn.mjs";
 export * from "./TurnCreatedEvent.mjs";

package/dist/esm/serialization/types/index.mjs

@@ -27,6 +27,7 @@ export * from "./CatalogModel.mjs";
 export * from "./CatalogModelProvider.mjs";
 export * from "./CatalogSandboxProvider.mjs";
 export * from "./CatalogSkill.mjs";
+export * from "./CatalogSkillType.mjs";
 export * from "./CatalogWellKnownModelProvider.mjs";
 export * from "./CatalogWellKnownModelProviderType.mjs";
 export * from "./ChatCompletionChunkDeltaToolCall.mjs";
@@ -58,6 +59,7 @@ export * from "./FireworksModelProvider.mjs";
 export * from "./GenerativeUiConfig.mjs";
 export * from "./GetAgentCodeSnippetsResponse.mjs";
 export * from "./GetAgentResponse.mjs";
+export * from "./GetAvailableMcpServerResponse.mjs";
 export * from "./GetCapabilitiesResponse.mjs";
 export * from "./GetMcpServerCatalogResponse.mjs";
 export * from "./GetMcpServerResponse.mjs";
@@ -75,6 +77,7 @@ export * from "./GetSessionResponse.mjs";
 export * from "./GetSkillCatalogResponse.mjs";
 export * from "./GetSkillResponse.mjs";
 export * from "./GetTurnResponse.mjs";
+export * from "./GitSkill.mjs";
 export * from "./GoogleGeminiModelProvider.mjs";
 export * from "./InitialUserMessage.mjs";
 export * from "./InputTokensCompactionTrigger.mjs";
@@ -86,12 +89,14 @@ export * from "./ListAvailableSkillsResponse.mjs";
 export * from "./ListMcpServersResponse.mjs";
 export * from "./ListMcpServerToolsResponse.mjs";
 export * from "./ListModelProvidersResponse.mjs";
+export * from "./ListPermissionsResponse.mjs";
 export * from "./ListScheduleRunsResponse.mjs";
 export * from "./ListSchedulesResponse.mjs";
 export * from "./ListSessionEventsResponse.mjs";
 export * from "./ListSessionsOrder.mjs";
 export * from "./ListSessionsResponse.mjs";
 export * from "./ListSkillsResponse.mjs";
+export * from "./ListSkillVersionsResponse.mjs";
 export * from "./ListTurnEventsOrder.mjs";
 export * from "./ListTurnEventsResponse.mjs";
 export * from "./ListTurnsResponse.mjs";
@@ -130,12 +135,14 @@ export * from "./ModelProviderAuth.mjs";
 export * from "./ModelProviderManifest.mjs";
 export * from "./MoonshotModelProvider.mjs";
 export * from "./OpenAiModelProvider.mjs";
+export * from "./PermissionResourceType.mjs";
 export * from "./PreviousTurnIdInput.mjs";
 export * from "./RawToolCall.mjs";
 export * from "./ReasoningEffort.mjs";
 export * from "./RequestErrorResponse.mjs";
 export * from "./RequestErrorResponseError.mjs";
 export * from "./ResourceName.mjs";
+export * from "./ResourcePermission.mjs";
 export * from "./ResponseFormat.mjs";
 export * from "./ResponseFormatJsonObject.mjs";
 export * from "./ResponseFormatJsonSchema.mjs";
@@ -179,7 +186,7 @@ export * from "./SettingsCapability.mjs";
 export * from "./Skill.mjs";
 export * from "./SkillCapability.mjs";
 export * from "./SkillManifest.mjs";
-export * from "./SkillType.mjs";
+export * from "./SkillVersion.mjs";
 export * from "./TextContent.mjs";
 export * from "./ThreadCreatedEvent.mjs";
 export * from "./ThreadDoneEvent.mjs";
@@ -196,6 +203,7 @@ export * from "./ToolInfo.mjs";
 export * from "./ToolResponseEvent.mjs";
 export * from "./ToolResponseRequiredEvent.mjs";
 export * from "./TrueFoundryModelProvider.mjs";
+export * from "./TrueFoundryRegistrySkill.mjs";
 export * from "./TrueFoundrySystemToolInfo.mjs";
 export * from "./Turn.mjs";
 export * from "./TurnCreatedEvent.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.1.4-rc.2";
+export declare const SDK_VERSION = "0.2.0-rc.4";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "0.1.4-rc.2";
+export const SDK_VERSION = "0.2.0-rc.4";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truefoundry/trueforge-sdk",
-  "version": "0.1.4-rc.2",
+  "version": "0.2.0-rc.4",
   "private": false,
   "type": "commonjs",
   "main": "./dist/cjs/index.js",
@@ -33,6 +33,17 @@
       },
       "default": "./dist/cjs/serialization/index.js"
     },
+    "./internal": {
+      "import": {
+        "types": "./dist/esm/api/resources/internal/exports.d.mts",
+        "default": "./dist/esm/api/resources/internal/exports.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/api/resources/internal/exports.d.ts",
+        "default": "./dist/cjs/api/resources/internal/exports.js"
+      },
+      "default": "./dist/cjs/api/resources/internal/exports.js"
+    },
     "./agents": {
       "import": {
         "types": "./dist/esm/api/resources/agents/exports.d.mts",
@@ -176,17 +187,6 @@
       },
       "default": "./dist/cjs/api/resources/catalogs/resources/skills/exports.js"
     },
-    "./internal": {
-      "import": {
-        "types": "./dist/esm/api/resources/internal/exports.d.mts",
-        "default": "./dist/esm/api/resources/internal/exports.mjs"
-      },
-      "require": {
-        "types": "./dist/cjs/api/resources/internal/exports.d.ts",
-        "default": "./dist/cjs/api/resources/internal/exports.js"
-      },
-      "default": "./dist/cjs/api/resources/internal/exports.js"
-    },
     "./internal/metrics": {
       "import": {
         "types": "./dist/esm/api/resources/internal/resources/metrics/exports.d.mts",
@@ -198,6 +198,17 @@
       },
       "default": "./dist/cjs/api/resources/internal/resources/metrics/exports.js"
     },
+    "./internal/schedules": {
+      "import": {
+        "types": "./dist/esm/api/resources/internal/resources/schedules/exports.d.mts",
+        "default": "./dist/esm/api/resources/internal/resources/schedules/exports.mjs"
+      },
+      "require": {
+        "types": "./dist/cjs/api/resources/internal/resources/schedules/exports.d.ts",
+        "default": "./dist/cjs/api/resources/internal/resources/schedules/exports.js"
+      },
+      "default": "./dist/cjs/api/resources/internal/resources/schedules/exports.js"
+    },
     "./internal/sessions": {
       "import": {
         "types": "./dist/esm/api/resources/internal/resources/sessions/exports.d.mts",

package/reference.md

@@ -1,4 +1,71 @@
 # Reference
+## Internal
+<details><summary><code>client.internal.<a href="/src/api/resources/internal/client/Client.ts">listPermissions</a>({ ...params }) -> TrueForge.ListPermissionsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Return granted actions for each requested agent, schedule, or session id.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.internal.listPermissions({
+    resourceIds: ["resource_ids"],
+    resourceType: "agent"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.ListPermissionsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `InternalClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
 ## Agents
 <details><summary><code>client.agents.<a href="/src/api/resources/agents/client/Client.ts">list</a>() -> TrueForge.ListAgentsResponse</code></summary>
 <dl>
@@ -441,7 +508,7 @@ await client.server.getCapabilities();
 </details>
 
 ## MCP Servers
-<details><summary><code>client.mcpServers.<a href="/src/api/resources/mcpServers/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;TrueForge.AvailableMcpServer, TrueForge.ListAvailableMcpServersResponse&gt;</code></summary>
+<details><summary><code>client.mcpServers.<a href="/src/api/resources/mcpServers/client/Client.ts">list</a>() -> TrueForge.ListAvailableMcpServersResponse</code></summary>
 <dl>
 <dd>
 
@@ -453,7 +520,7 @@ await client.server.getCapabilities();
 <dl>
 <dd>
 
-Paginated MCP servers as a slim name/url list for the composer.
+Configured MCP servers as a slim name/url list for the composer.
 </dd>
 </dl>
 </dd>
@@ -484,7 +551,62 @@ await client.mcpServers.list();
 <dl>
 <dd>
 
-**request:** `TrueForge.ListMcpServersRequest` 
+**requestOptions:** `McpServersClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.mcpServers.<a href="/src/api/resources/mcpServers/client/Client.ts">get</a>(name) -> TrueForge.GetAvailableMcpServerResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+A single MCP server as the slim chat projection, with live per-user auth_status.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.mcpServers.get("name");
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**name:** `string` — MCP server name.
     
 </dd>
 </dl>
@@ -1159,7 +1281,7 @@ await client.schedules.delete("schedule_id");
 </dl>
 </details>
 
-<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">listRuns</a>(schedule_id) -> TrueForge.ListScheduleRunsResponse</code></summary>
+<details><summary><code>client.schedules.<a href="/src/api/resources/schedules/client/Client.ts">listRuns</a>(schedule_id, { ...params }) -> core.Page&lt;TrueForge.ScheduleRun, TrueForge.ListScheduleRunsResponse&gt;</code></summary>
 <dl>
 <dd>
 
@@ -1210,6 +1332,14 @@ await client.schedules.listRuns("schedule_id");
 <dl>
 <dd>
 
+**request:** `TrueForge.ListRunsSchedulesRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `SchedulesClient.RequestOptions` 
     
 </dd>
@@ -2281,6 +2411,71 @@ await client.skills.list();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.skills.<a href="/src/api/resources/skills/client/Client.ts">listVersions</a>({ ...params }) -> TrueForge.ListSkillVersionsResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Versions for one skill.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.skills.listVersions({
+    name: "name"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.ListVersionsSkillsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SkillsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2696,6 +2891,72 @@ await client.internal.metrics.getMeters({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+## Internal Schedules
+<details><summary><code>client.internal.schedules.<a href="/src/api/resources/internal/resources/schedules/client/Client.ts">executeRun</a>({ ...params }) -> void</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Execute a persisted schedule run using its saved schedule and agent.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.internal.schedules.executeRun({
+    scheduleRunId: "schedule_run_id"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `TrueForge.internal.ExecuteScheduleRunRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `SchedulesClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -2770,7 +3031,7 @@ await client.internal.sessions.getOrCreateByExternalId({
 </details>
 
 ## Internal Agents
-<details><summary><code>client.internal.agents.<a href="/src/api/resources/internal/resources/agents/client/Client.ts">getCodeSnippets</a>(agent_id) -> TrueForge.GetAgentCodeSnippetsResponse</code></summary>
+<details><summary><code>client.internal.agents.<a href="/src/api/resources/internal/resources/agents/client/Client.ts">getCodeSnippets</a>(agent_id, { ...params }) -> TrueForge.GetAgentCodeSnippetsResponse</code></summary>
 <dl>
 <dd>
 
@@ -2821,6 +3082,14 @@ await client.internal.agents.getCodeSnippets("agent_id");
 <dl>
 <dd>
 
+**request:** `TrueForge.internal.GetCodeSnippetsAgentsRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
 **requestOptions:** `AgentsClient.RequestOptions` 
     
 </dd>
@@ -2834,7 +3103,7 @@ await client.internal.agents.getCodeSnippets("agent_id");
 </details>
 
 ## Settings McpServers
-<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">list</a>({ ...params }) -> core.Page&lt;TrueForge.ConfiguredMcpServer, TrueForge.ListMcpServersResponse&gt;</code></summary>
+<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">list</a>() -> TrueForge.ListMcpServersResponse</code></summary>
 <dl>
 <dd>
 
@@ -2846,7 +3115,7 @@ await client.internal.agents.getCodeSnippets("agent_id");
 <dl>
 <dd>
 
-Paginated MCP servers with auth_status. Header secrets are redacted.
+Configured MCP servers with auth_status. Header secrets are redacted.
 </dd>
 </dl>
 </dd>
@@ -2877,14 +3146,6 @@ await client.settings.mcpServers.list();
 <dl>
 <dd>
 
-**request:** `TrueForge.settings.ListMcpServersRequest` 
-    
-</dd>
-</dl>
-
-<dl>
-<dd>
-
 **requestOptions:** `McpServersClient.RequestOptions` 
     
 </dd>

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

@@ -1,10 +0,0 @@
-/**
- * @example
- *     {}
- */
-export interface ListMcpServersRequest {
-    /** Page size. Defaults to 100, max 200. */
-    limit?: number;
-    /** Opaque token from a previous response `next_page_token`. */
-    pageToken?: string;
-}

package/dist/cjs/api/types/SkillType.d.ts

@@ -1 +0,0 @@
-export type SkillType = "git";

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

@@ -1,10 +0,0 @@
-/**
- * @example
- *     {}
- */
-export interface ListMcpServersRequest {
-    /** Page size. Defaults to 100, max 200. */
-    limit?: number;
-    /** Opaque token from a previous response `next_page_token`. */
-    pageToken?: string;
-}

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

@@ -1 +0,0 @@
-export type SkillType = "git";