Skip to content

The open-source agent harness - the runtime layer that turns an LLM into a working agent.

Standardize openapi naming and request/response schema (#257)

Srajan Asthanae9bf976e9584
diff --git a/.changeset/vast-meteors-boil.md b/.changeset/vast-meteors-boil.md
new file mode 100644
index 000000000..53cf02eee
--- /dev/null
+++ b/.changeset/vast-meteors-boil.md
@@ -0,0 +1,7 @@
+---
+'@truefoundry/trueforge': patch
+'@truefoundry/trueforge-sdk': patch
+'@truefoundry/trueforge-ui': patch
+---
+
+Wrap settings MCP, skills, model-provider, and sandbox create/put bodies as `{ manifest }`. List/get items nest the stored document (`name` plus `manifest`, plus derived fields). Create returns 201. Chat lists and catalogs stay flat. Adapter catalogs follow the new SDK shapes.
diff --git a/.github/fern/openapi/openapi.json b/.github/fern/openapi/openapi.json
index 9b6a5f363..d57cca8a5 100644
--- a/.github/fern/openapi/openapi.json
+++ b/.github/fern/openapi/openapi.json
@@ -35,14 +35,7 @@
"$ref": "#/components/schemas/AgentSpec"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
}
},
"required": [
@@ -433,7 +426,7 @@
"additionalProperties": false,
"properties": {
"auth": {
- "$ref": "#/components/schemas/ConfiguredMcpServerAuth"
+ "$ref": "#/components/schemas/McpServerManifestAuth"
},
"description": {
"description": "Concise summary of what this MCP server provides.",
@@ -446,14 +439,7 @@
"type": "string"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
},
"type": {
"$ref": "#/components/schemas/McpServerType"
@@ -491,14 +477,7 @@
"type": "string"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
},
"path": {
"description": "Path to the skill directory within the repository. Omit to use the repository root.",
@@ -687,69 +666,38 @@
"ConfiguredMcpServer": {
"additionalProperties": false,
"properties": {
- "auth": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ConfiguredMcpServerAuth"
- },
- {
- "description": "Optional auth settings. Omit when the server needs no credentials."
- }
- ]
- },
"auth_status": {
"$ref": "#/components/schemas/McpAuthStatus"
},
- "description": {
- "description": "Concise summary of what this MCP server provides.",
- "minLength": 1,
- "type": "string"
+ "manifest": {
+ "$ref": "#/components/schemas/McpServerManifest"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
- },
- "type": {
- "$ref": "#/components/schemas/McpServerType"
- },
- "url": {
- "description": "URL of the remote MCP server.",
- "format": "uri",
- "type": "string"
+ "$ref": "#/components/schemas/ResourceName"
}
},
"required": [
- "type",
"name",
- "url",
- "description",
+ "manifest",
"auth_status"
],
"type": "object"
},
- "ConfiguredMcpServerAuth": {
- "description": "Optional default auth settings for the preset.",
- "discriminator": {
- "mapping": {
- "dcr": "#/components/schemas/McpServerDcrAuth",
- "header": "#/components/schemas/McpServerHeaderAuth"
- },
- "propertyName": "type"
- },
- "oneOf": [
- {
- "$ref": "#/components/schemas/McpServerHeaderAuth"
+ "ConfiguredSkill": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SkillManifest"
},
- {
- "$ref": "#/components/schemas/McpServerDcrAuth"
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
}
- ]
+ },
+ "required": [
+ "name",
+ "manifest"
+ ],
+ "type": "object"
},
"ContextManagementConfig": {
"default": {
@@ -792,14 +740,7 @@
"$ref": "#/components/schemas/AgentSpec"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
}
},
"required": [
@@ -811,45 +752,24 @@
"CreateMcpServerRequest": {
"additionalProperties": false,
"properties": {
- "auth": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ConfiguredMcpServerAuth"
- },
- {
- "description": "Optional auth settings. Omit when the server needs no credentials."
- }
- ]
- },
- "description": {
- "description": "Concise summary of what this MCP server provides.",
- "minLength": 1,
- "type": "string"
- },
- "name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
- },
- "type": {
- "$ref": "#/components/schemas/McpServerType"
- },
- "url": {
- "description": "URL of the remote MCP server.",
- "format": "uri",
- "type": "string"
+ "manifest": {
+ "$ref": "#/components/schemas/McpServerManifest"
}
},
"required": [
- "type",
- "name",
- "url",
- "description"
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "CreateModelProviderRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/ModelProviderManifest"
+ }
+ },
+ "required": [
+ "manifest"
],
"type": "object"
},
@@ -875,6 +795,18 @@
],
"type": "object"
},
+ "CreateSkillRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SkillManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
"CreateTurnRequest": {
"properties": {
"input": {
@@ -915,14 +847,7 @@
"type": "array"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
},
"type": {
"enum": [
@@ -1181,6 +1106,17 @@
],
"type": "object"
},
+ "GetModelProviderResponse": {
+ "properties": {
+ "data": {
+ "$ref": "#/components/schemas/ModelProvider"
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "type": "object"
+ },
"GetSandboxProviderCatalogResponse": {
"properties": {
"data": {
@@ -1198,7 +1134,7 @@
"GetSandboxProviderResponse": {
"properties": {
"data": {
- "$ref": "#/components/schemas/SandboxProviderResponse"
+ "$ref": "#/components/schemas/SandboxProvider"
}
},
"required": [
@@ -1231,6 +1167,17 @@
],
"type": "object"
},
+ "GetSkillResponse": {
+ "properties": {
+ "data": {
+ "$ref": "#/components/schemas/ConfiguredSkill"
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "type": "object"
+ },
"GetTurnResponse": {
"properties": {
"data": {
@@ -1331,20 +1278,6 @@
],
"type": "object"
},
- "ListConfiguredSkillsResponse": {
- "properties": {
- "data": {
- "items": {
- "$ref": "#/components/schemas/SkillManifest"
- },
- "type": "array"
- }
- },
- "required": [
- "data"
- ],
- "type": "object"
- },
"ListMcpServerToolsResponse": {
"properties": {
"data": {
@@ -1448,6 +1381,20 @@
],
"type": "object"
},
+ "ListSkillsResponse": {
+ "properties": {
+ "data": {
+ "items": {
+ "$ref": "#/components/schemas/ConfiguredSkill"
+ },
+ "type": "array"
+ }
+ },
+ "required": [
+ "data"
+ ],
+ "type": "object"
+ },
"ListTurnEventsOrder": {
"default": "asc",
"description": "Sort events by insertion order. Defaults to \"asc\".",
@@ -1748,7 +1695,7 @@
},
"McpAuthStatus": {
"additionalProperties": false,
- "description": "Auth state for the calling user.",
+ "description": "Current auth state.",
"properties": {
"authorization_url": {
"description": "When auth is required, this contains the URL to redirect the user to for authorization.",
@@ -1850,14 +1797,7 @@
"additionalProperties": false,
"properties": {
"auth": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ConfiguredMcpServerAuth"
- },
- {
- "description": "Optional auth settings. Omit when the server needs no credentials."
- }
- ]
+ "$ref": "#/components/schemas/McpServerManifestAuth"
},
"description": {
"description": "Concise summary of what this MCP server provides.",
@@ -1865,14 +1805,7 @@
"type": "string"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
},
"type": {
"$ref": "#/components/schemas/McpServerType"
@@ -1891,6 +1824,24 @@
],
"type": "object"
},
+ "McpServerManifestAuth": {
+ "description": "Optional auth settings. Omit when the server needs no credentials.",
+ "discriminator": {
+ "mapping": {
+ "dcr": "#/components/schemas/McpServerDcrAuth",
+ "header": "#/components/schemas/McpServerHeaderAuth"
+ },
+ "propertyName": "type"
+ },
+ "oneOf": [
+ {
+ "$ref": "#/components/schemas/McpServerHeaderAuth"
+ },
+ {
+ "$ref": "#/components/schemas/McpServerDcrAuth"
+ }
+ ]
+ },
"McpServerReadEntry": {
"additionalProperties": false,
"properties": {
@@ -1901,14 +1852,7 @@
"$ref": "#/components/schemas/McpAuthStatus"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
},
"url": {
"description": "URL of the remote MCP server.",
@@ -1924,7 +1868,6 @@
"type": "object"
},
"McpServerType": {
- "description": "MCP server kind (`remote` today).",
"enum": [
"remote"
],
@@ -2297,6 +2240,37 @@
"type": "object"
},
"ModelProvider": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/ModelProviderManifest"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ }
+ },
+ "required": [
+ "name",
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "ModelProviderAuth": {
+ "additionalProperties": false,
+ "description": "Provider authentication credentials.",
+ "properties": {
+ "api_key": {
+ "description": "Provider API key. Responses are redacted; on PUT, a real value sets/rotates and a redacted value keeps the stored key.",
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "api_key"
+ ],
+ "type": "object"
+ },
+ "ModelProviderManifest": {
"discriminator": {
"mapping": {
"alibaba": "#/components/schemas/AlibabaModelProvider",
@@ -2341,21 +2315,6 @@
}
]
},
- "ModelProviderAuth": {
- "additionalProperties": false,
- "description": "Provider authentication credentials.",
- "properties": {
- "api_key": {
- "description": "Provider API key. Responses are redacted; on PUT, a real value sets/rotates and a redacted value keeps the stored key.",
- "minLength": 1,
- "type": "string"
- }
- },
- "required": [
- "api_key"
- ],
- "type": "object"
- },
"MoonshotModelProvider": {
"additionalProperties": false,
"properties": {
@@ -2458,47 +2417,51 @@
],
"type": "object"
},
- "PutMcpServerResponse": {
+ "PutMcpServerRequest": {
+ "additionalProperties": false,
"properties": {
- "data": {
- "$ref": "#/components/schemas/ConfiguredMcpServer"
+ "manifest": {
+ "$ref": "#/components/schemas/McpServerManifest"
}
},
"required": [
- "data"
+ "manifest"
],
"type": "object"
},
- "PutModelProviderResponse": {
+ "PutModelProviderRequest": {
+ "additionalProperties": false,
"properties": {
- "data": {
- "$ref": "#/components/schemas/ModelProvider"
+ "manifest": {
+ "$ref": "#/components/schemas/ModelProviderManifest"
}
},
"required": [
- "data"
+ "manifest"
],
"type": "object"
},
- "PutSandboxProviderResponse": {
+ "PutSandboxProviderRequest": {
+ "additionalProperties": false,
"properties": {
- "data": {
- "$ref": "#/components/schemas/SandboxProviderResponse"
+ "manifest": {
+ "$ref": "#/components/schemas/SandboxProviderManifest"
}
},
"required": [
- "data"
+ "manifest"
],
"type": "object"
},
- "PutSkillResponse": {
+ "PutSkillRequest": {
+ "additionalProperties": false,
"properties": {
- "data": {
+ "manifest": {
"$ref": "#/components/schemas/SkillManifest"
}
},
"required": [
- "data"
+ "manifest"
],
"type": "object"
},
@@ -2569,7 +2532,6 @@
"type": "object"
},
"ResourceName": {
- "description": "Internal identifier; forms the fully qualified name `name/model_name`.",
"maxLength": 64,
"minLength": 2,
"pattern": "^[a-z](?:[a-z0-9._-]{0,62}[a-z0-9])$",
@@ -2872,6 +2834,30 @@
},
"type": "object"
},
+ "SandboxProvider": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SandboxProviderManifest"
+ },
+ "status": {
+ "$ref": "#/components/schemas/SandboxBuildStatus"
+ },
+ "status_reason": {
+ "description": "Human-readable detail for the current status; null when ready.",
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "required": [
+ "manifest",
+ "status",
+ "status_reason"
+ ],
+ "type": "object"
+ },
"SandboxProviderManifest": {
"additionalProperties": false,
"properties": {
@@ -2916,30 +2902,6 @@
],
"type": "object"
},
- "SandboxProviderResponse": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/SandboxProviderManifest"
- },
- "status": {
- "$ref": "#/components/schemas/SandboxBuildStatus"
- },
- "status_reason": {
- "description": "Human-readable detail for the current status; null when ready.",
- "type": [
- "string",
- "null"
- ]
- }
- },
- "required": [
- "manifest",
- "status",
- "status_reason"
- ],
- "type": "object"
- },
"Session": {
"properties": {
"agent": {
@@ -3020,14 +2982,7 @@
"additionalProperties": false,
"properties": {
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
}
},
"required": [
@@ -3155,14 +3110,7 @@
"type": "string"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
},
"path": {
"description": "Path to the skill directory within the repository. Omit to use the repository root.",
@@ -3220,14 +3168,7 @@
"type": "string"
},
"name": {
- "allOf": [
- {
- "$ref": "#/components/schemas/ResourceName"
- },
- {
- "description": "Fully qualified name. Unique within a tenant."
- }
- ]
+ "$ref": "#/components/schemas/ResourceName"
}
},
"required": [
@@ -4994,7 +4935,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutMcpServerResponse"
+ "$ref": "#/components/schemas/GetMcpServerResponse"
}
}
},
@@ -6391,11 +6332,11 @@
"required": true
},
"responses": {
- "200": {
+ "201": {
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutMcpServerResponse"
+ "$ref": "#/components/schemas/GetMcpServerResponse"
}
}
},
@@ -6448,7 +6389,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/McpServerManifest"
+ "$ref": "#/components/schemas/PutMcpServerRequest"
}
}
},
@@ -6459,7 +6400,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutMcpServerResponse"
+ "$ref": "#/components/schemas/GetMcpServerResponse"
}
}
},
@@ -6627,7 +6568,7 @@
},
"/api/v1/settings/model-providers": {
"get": {
- "description": "All configured providers with their models.",
+ "description": "All configured providers with nested manifests.",
"responses": {
"200": {
"content": {
@@ -6676,18 +6617,18 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ModelProvider"
+ "$ref": "#/components/schemas/CreateModelProviderRequest"
}
}
},
"required": true
},
"responses": {
- "200": {
+ "201": {
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutModelProviderResponse"
+ "$ref": "#/components/schemas/GetModelProviderResponse"
}
}
},
@@ -6730,7 +6671,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ModelProvider"
+ "$ref": "#/components/schemas/PutModelProviderRequest"
}
}
},
@@ -6741,7 +6682,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutModelProviderResponse"
+ "$ref": "#/components/schemas/GetModelProviderResponse"
}
}
},
@@ -6810,7 +6751,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/SandboxProviderManifest"
+ "$ref": "#/components/schemas/PutSandboxProviderRequest"
}
}
},
@@ -6821,7 +6762,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutSandboxProviderResponse"
+ "$ref": "#/components/schemas/GetSandboxProviderResponse"
}
}
},
@@ -6861,13 +6802,13 @@
},
"/api/v1/settings/skills": {
"get": {
- "description": "All configured skills with full manifests (settings / admin projection).",
+ "description": "All configured skills with nested manifests (settings / admin projection).",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListConfiguredSkillsResponse"
+ "$ref": "#/components/schemas/ListSkillsResponse"
}
}
},
@@ -6910,18 +6851,18 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/SkillManifest"
+ "$ref": "#/components/schemas/CreateSkillRequest"
}
}
},
"required": true
},
"responses": {
- "200": {
+ "201": {
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutSkillResponse"
+ "$ref": "#/components/schemas/GetSkillResponse"
}
}
},
@@ -6964,7 +6905,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/SkillManifest"
+ "$ref": "#/components/schemas/PutSkillRequest"
}
}
},
@@ -6975,7 +6916,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutSkillResponse"
+ "$ref": "#/components/schemas/GetSkillResponse"
}
}
},
diff --git a/packages/sdk/reference.md b/packages/sdk/reference.md
index de568c117..2562385d4 100644
--- a/packages/sdk/reference.md
+++ b/packages/sdk/reference.md
@@ -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.PutMcpServerResponse</code></summary>
+<details><summary><code>client.mcpServers.<a href="/src/api/resources/mcpServers/client/Client.ts">deleteAuthorize</a>(name) -> TrueForge.GetMcpServerResponse</code></summary>
<dl>
<dd>
@@ -2084,7 +2084,7 @@ await client.settings.mcpServers.list();
</dl>
</details>
-<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">create</a>({ ...params }) -> TrueForge.PutMcpServerResponse</code></summary>
+<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">create</a>({ ...params }) -> TrueForge.GetMcpServerResponse</code></summary>
<dl>
<dd>
@@ -2112,9 +2112,12 @@ Creates an MCP server by `name`. Fails if `name` is already taken. Runs DCR regi
```typescript
await client.settings.mcpServers.create({
- description: "description",
- name: "name",
- url: "url"
+ manifest: {
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url"
+ }
});
```
@@ -2151,7 +2154,7 @@ await client.settings.mcpServers.create({
</dl>
</details>
-<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">upsert</a>({ ...params }) -> TrueForge.PutMcpServerResponse</code></summary>
+<details><summary><code>client.settings.mcpServers.<a href="/src/api/resources/settings/resources/mcpServers/client/Client.ts">upsert</a>({ ...params }) -> TrueForge.GetMcpServerResponse</code></summary>
<dl>
<dd>
@@ -2179,9 +2182,12 @@ Create or replace by `name`. Does not start DCR or change oauth client columns.
```typescript
await client.settings.mcpServers.upsert({
- description: "description",
- name: "name",
- url: "url"
+ manifest: {
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url"
+ }
});
```
@@ -2198,7 +2204,7 @@ await client.settings.mcpServers.upsert({
<dl>
<dd>
-**request:** `TrueForge.settings.McpServerManifest`
+**request:** `TrueForge.settings.PutMcpServerRequest`
</dd>
</dl>
@@ -2357,7 +2363,7 @@ await client.settings.mcpServers.listTools("name");
<dl>
<dd>
-All configured providers with their models.
+All configured providers with nested manifests.
</dd>
</dl>
</dd>
@@ -2400,7 +2406,7 @@ await client.settings.modelProviders.list();
</dl>
</details>
-<details><summary><code>client.settings.modelProviders.<a href="/src/api/resources/settings/resources/modelProviders/client/Client.ts">create</a>({ ...params }) -> TrueForge.PutModelProviderResponse</code></summary>
+<details><summary><code>client.settings.modelProviders.<a href="/src/api/resources/settings/resources/modelProviders/client/Client.ts">create</a>({ ...params }) -> TrueForge.GetModelProviderResponse</code></summary>
<dl>
<dd>
@@ -2428,15 +2434,17 @@ Creates a provider (models included). Fails if `name` is already taken. Well-kno
```typescript
await client.settings.modelProviders.create({
- auth: {
- apiKey: "api_key"
- },
- models: [{
- modelId: "model_id",
- name: "name",
- properties: {}
- }],
- type: "alibaba"
+ manifest: {
+ auth: {
+ apiKey: "api_key"
+ },
+ models: [{
+ modelId: "model_id",
+ name: "name",
+ properties: {}
+ }],
+ type: "alibaba"
+ }
});
```
@@ -2453,7 +2461,7 @@ await client.settings.modelProviders.create({
<dl>
<dd>
-**request:** `TrueForge.ModelProvider`
+**request:** `TrueForge.settings.CreateModelProviderRequest`
</dd>
</dl>
@@ -2473,7 +2481,7 @@ await client.settings.modelProviders.create({
</dl>
</details>
-<details><summary><code>client.settings.modelProviders.<a href="/src/api/resources/settings/resources/modelProviders/client/Client.ts">upsert</a>({ ...params }) -> TrueForge.PutModelProviderResponse</code></summary>
+<details><summary><code>client.settings.modelProviders.<a href="/src/api/resources/settings/resources/modelProviders/client/Client.ts">upsert</a>({ ...params }) -> TrueForge.GetModelProviderResponse</code></summary>
<dl>
<dd>
@@ -2501,15 +2509,17 @@ Create or replace a provider (models included). Well-known types use `type` as `
```typescript
await client.settings.modelProviders.upsert({
- auth: {
- apiKey: "api_key"
- },
- models: [{
- modelId: "model_id",
- name: "name",
- properties: {}
- }],
- type: "alibaba"
+ manifest: {
+ auth: {
+ apiKey: "api_key"
+ },
+ models: [{
+ modelId: "model_id",
+ name: "name",
+ properties: {}
+ }],
+ type: "alibaba"
+ }
});
```
@@ -2526,7 +2536,7 @@ await client.settings.modelProviders.upsert({
<dl>
<dd>
-**request:** `TrueForge.ModelProvider`
+**request:** `TrueForge.settings.PutModelProviderRequest`
</dd>
</dl>
@@ -2602,7 +2612,7 @@ await client.settings.sandboxProviders.get();
</dl>
</details>
-<details><summary><code>client.settings.sandboxProviders.<a href="/src/api/resources/settings/resources/sandboxProviders/client/Client.ts">upsert</a>({ ...params }) -> TrueForge.PutSandboxProviderResponse</code></summary>
+<details><summary><code>client.settings.sandboxProviders.<a href="/src/api/resources/settings/resources/sandboxProviders/client/Client.ts">upsert</a>({ ...params }) -> TrueForge.GetSandboxProviderResponse</code></summary>
<dl>
<dd>
@@ -2630,14 +2640,16 @@ Upserts the single sandbox provider for this tenant: creates it or replaces its
```typescript
await client.settings.sandboxProviders.upsert({
- auth: {
- apiKey: "api_key"
- },
- autoArchiveIntervalInMinutes: 1,
- autoDeleteIntervalInMinutes: 1,
- autoStopIntervalInMinutes: 1,
- execTimeoutMs: 1,
- type: "daytona"
+ manifest: {
+ auth: {
+ apiKey: "api_key"
+ },
+ autoArchiveIntervalInMinutes: 1,
+ autoDeleteIntervalInMinutes: 1,
+ autoStopIntervalInMinutes: 1,
+ execTimeoutMs: 1,
+ type: "daytona"
+ }
});
```
@@ -2654,7 +2666,7 @@ await client.settings.sandboxProviders.upsert({
<dl>
<dd>
-**request:** `TrueForge.SandboxProviderManifest`
+**request:** `TrueForge.settings.PutSandboxProviderRequest`
</dd>
</dl>
@@ -2675,7 +2687,7 @@ await client.settings.sandboxProviders.upsert({
</details>
## Settings Skills
-<details><summary><code>client.settings.skills.<a href="/src/api/resources/settings/resources/skills/client/Client.ts">list</a>() -> TrueForge.ListConfiguredSkillsResponse</code></summary>
+<details><summary><code>client.settings.skills.<a href="/src/api/resources/settings/resources/skills/client/Client.ts">list</a>() -> TrueForge.ListSkillsResponse</code></summary>
<dl>
<dd>
@@ -2687,7 +2699,7 @@ await client.settings.sandboxProviders.upsert({
<dl>
<dd>
-All configured skills with full manifests (settings / admin projection).
+All configured skills with nested manifests (settings / admin projection).
</dd>
</dl>
</dd>
@@ -2730,7 +2742,7 @@ await client.settings.skills.list();
</dl>
</details>
-<details><summary><code>client.settings.skills.<a href="/src/api/resources/settings/resources/skills/client/Client.ts">create</a>({ ...params }) -> TrueForge.PutSkillResponse</code></summary>
+<details><summary><code>client.settings.skills.<a href="/src/api/resources/settings/resources/skills/client/Client.ts">create</a>({ ...params }) -> TrueForge.GetSkillResponse</code></summary>
<dl>
<dd>
@@ -2758,11 +2770,13 @@ Creates a skill keyed by `name`. Fails if `name` is already taken.
```typescript
await client.settings.skills.create({
- description: "description",
- name: "name",
- ref: "ref",
- type: "git",
- url: "url"
+ manifest: {
+ description: "description",
+ name: "name",
+ ref: "ref",
+ type: "git",
+ url: "url"
+ }
});
```
@@ -2779,7 +2793,7 @@ await client.settings.skills.create({
<dl>
<dd>
-**request:** `TrueForge.SkillManifest`
+**request:** `TrueForge.settings.CreateSkillRequest`
</dd>
</dl>
@@ -2799,7 +2813,7 @@ await client.settings.skills.create({
</dl>
</details>
-<details><summary><code>client.settings.skills.<a href="/src/api/resources/settings/resources/skills/client/Client.ts">upsert</a>({ ...params }) -> TrueForge.PutSkillResponse</code></summary>
+<details><summary><code>client.settings.skills.<a href="/src/api/resources/settings/resources/skills/client/Client.ts">upsert</a>({ ...params }) -> TrueForge.GetSkillResponse</code></summary>
<dl>
<dd>
@@ -2827,11 +2841,13 @@ Full upsert keyed by `name`: creates the skill or replaces its entire manifest.
```typescript
await client.settings.skills.upsert({
- description: "description",
- name: "name",
- ref: "ref",
- type: "git",
- url: "url"
+ manifest: {
+ description: "description",
+ name: "name",
+ ref: "ref",
+ type: "git",
+ url: "url"
+ }
});
```
@@ -2848,7 +2864,7 @@ await client.settings.skills.upsert({
<dl>
<dd>
-**request:** `TrueForge.SkillManifest`
+**request:** `TrueForge.settings.PutSkillRequest`
</dd>
</dl>
diff --git a/packages/sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts b/packages/sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts
index a7e50e73c..0648583e5 100644
--- a/packages/sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts
+++ b/packages/sdk/src/api/resources/agents/client/requests/CreateAgentRequest.ts
@@ -15,6 +15,5 @@ import type * as TrueForge from "../../../../index.js";
*/
export interface CreateAgentRequest {
manifest: TrueForge.AgentSpec;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
}
diff --git a/packages/sdk/src/api/resources/mcpServers/client/Client.ts b/packages/sdk/src/api/resources/mcpServers/client/Client.ts
index 42d60a36d..82387bfc7 100644
--- a/packages/sdk/src/api/resources/mcpServers/client/Client.ts
+++ b/packages/sdk/src/api/resources/mcpServers/client/Client.ts
@@ -265,14 +265,14 @@ export class McpServersClient {
public deleteAuthorize(
name: string,
requestOptions?: McpServersClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.PutMcpServerResponse> {
+ ): core.HttpResponsePromise<TrueForge.GetMcpServerResponse> {
return core.HttpResponsePromise.fromPromise(this.__deleteAuthorize(name, requestOptions));
}
private async __deleteAuthorize(
name: string,
requestOptions?: McpServersClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.PutMcpServerResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetMcpServerResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -296,7 +296,7 @@ export class McpServersClient {
});
if (_response.ok) {
return {
- data: serializers.PutMcpServerResponse.parseOrThrow(_response.body, {
+ data: serializers.GetMcpServerResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/sdk/src/api/resources/settings/resources/index.ts b/packages/sdk/src/api/resources/settings/resources/index.ts
index aa7a12040..61dea343e 100644
--- a/packages/sdk/src/api/resources/settings/resources/index.ts
+++ b/packages/sdk/src/api/resources/settings/resources/index.ts
@@ -1,6 +1,8 @@
export * from "./mcpServers/client/requests/index.js";
export * as mcpServers from "./mcpServers/index.js";
-export * from "./mcpServers/types/index.js";
+export * from "./modelProviders/client/requests/index.js";
export * as modelProviders from "./modelProviders/index.js";
+export * from "./sandboxProviders/client/requests/index.js";
export * as sandboxProviders from "./sandboxProviders/index.js";
+export * from "./skills/client/requests/index.js";
export * as skills from "./skills/index.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts
index 810e52a8d..2a6d4d6d9 100644
--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts
+++ b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts
@@ -129,22 +129,25 @@ export class McpServersClient {
*
* @example
* await client.settings.mcpServers.create({
- * description: "description",
- * name: "name",
- * url: "url"
+ * manifest: {
+ * description: "description",
+ * name: "name",
+ * type: "remote",
+ * url: "url"
+ * }
* })
*/
public create(
request: TrueForge.settings.CreateMcpServerRequest,
requestOptions?: McpServersClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.PutMcpServerResponse> {
+ ): core.HttpResponsePromise<TrueForge.GetMcpServerResponse> {
return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
}
private async __create(
request: TrueForge.settings.CreateMcpServerRequest,
requestOptions?: McpServersClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.PutMcpServerResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetMcpServerResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -163,15 +166,12 @@ export class McpServersClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- {
- ...serializers.settings.CreateMcpServerRequest.jsonOrThrow(request, {
- unrecognizedObjectKeys: "passthrough",
- allowUnrecognizedUnionMembers: true,
- allowUnrecognizedEnumValues: true,
- omitUndefined: true,
- }),
- type: "remote",
- },
+ serializers.settings.CreateMcpServerRequest.jsonOrThrow(request, {
+ unrecognizedObjectKeys: "passthrough",
+ allowUnrecognizedUnionMembers: true,
+ allowUnrecognizedEnumValues: true,
+ omitUndefined: true,
+ }),
requestOptions?.additionalBodyParameters,
),
timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
@@ -182,7 +182,7 @@ export class McpServersClient {
});
if (_response.ok) {
return {
- data: serializers.PutMcpServerResponse.parseOrThrow(_response.body, {
+ data: serializers.GetMcpServerResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -243,7 +243,7 @@ export class McpServersClient {
/**
* Create or replace by `name`. Does not start DCR or change oauth client columns. Header secrets: real value sets/rotates; redacted keeps existing (400 if none).
*
- * @param {TrueForge.settings.McpServerManifest} request
+ * @param {TrueForge.settings.PutMcpServerRequest} request
* @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -253,22 +253,25 @@ export class McpServersClient {
*
* @example
* await client.settings.mcpServers.upsert({
- * description: "description",
- * name: "name",
- * url: "url"
+ * manifest: {
+ * description: "description",
+ * name: "name",
+ * type: "remote",
+ * url: "url"
+ * }
* })
*/
public upsert(
- request: TrueForge.settings.McpServerManifest,
+ request: TrueForge.settings.PutMcpServerRequest,
requestOptions?: McpServersClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.PutMcpServerResponse> {
+ ): core.HttpResponsePromise<TrueForge.GetMcpServerResponse> {
return core.HttpResponsePromise.fromPromise(this.__upsert(request, requestOptions));
}
private async __upsert(
- request: TrueForge.settings.McpServerManifest,
+ request: TrueForge.settings.PutMcpServerRequest,
requestOptions?: McpServersClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.PutMcpServerResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetMcpServerResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -287,15 +290,12 @@ export class McpServersClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- {
- ...serializers.settings.McpServerManifest.jsonOrThrow(request, {
- unrecognizedObjectKeys: "passthrough",
- allowUnrecognizedUnionMembers: true,
- allowUnrecognizedEnumValues: true,
- omitUndefined: true,
- }),
- type: "remote",
- },
+ serializers.settings.PutMcpServerRequest.jsonOrThrow(request, {
+ unrecognizedObjectKeys: "passthrough",
+ allowUnrecognizedUnionMembers: true,
+ allowUnrecognizedEnumValues: true,
+ omitUndefined: true,
+ }),
requestOptions?.additionalBodyParameters,
),
timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
@@ -306,7 +306,7 @@ export class McpServersClient {
});
if (_response.ok) {
return {
- data: serializers.PutMcpServerResponse.parseOrThrow(_response.body, {
+ data: serializers.GetMcpServerResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/CreateMcpServerRequest.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/CreateMcpServerRequest.ts
index 25c457a57..330dfcdc2 100644
--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/CreateMcpServerRequest.ts
+++ b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/CreateMcpServerRequest.ts
@@ -5,18 +5,14 @@ import type * as TrueForge from "../../../../../../index.js";
/**
* @example
* {
- * description: "description",
- * name: "name",
- * url: "url"
+ * manifest: {
+ * description: "description",
+ * name: "name",
+ * type: "remote",
+ * url: "url"
+ * }
* }
*/
export interface CreateMcpServerRequest {
- /** Optional auth settings. Omit when the server needs no credentials. */
- auth?: TrueForge.settings.CreateMcpServerRequestAuth;
- /** Concise summary of what this MCP server provides. */
- description: string;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
- /** URL of the remote MCP server. */
- url: string;
+ manifest: TrueForge.McpServerManifest;
}
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/McpServerManifest.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/McpServerManifest.ts
deleted file mode 100644
index 2bf058c7b..000000000
--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/McpServerManifest.ts
+++ /dev/null
@@ -1,22 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../../../../../index.js";
-
-/**
- * @example
- * {
- * description: "description",
- * name: "name",
- * url: "url"
- * }
- */
-export interface McpServerManifest {
- /** Optional auth settings. Omit when the server needs no credentials. */
- auth?: TrueForge.settings.McpServerManifestAuth;
- /** Concise summary of what this MCP server provides. */
- description: string;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
- /** URL of the remote MCP server. */
- url: string;
-}
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts
new file mode 100644
index 000000000..7cd3eb1f2
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts
@@ -0,0 +1,18 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../index.js";
+
+/**
+ * @example
+ * {
+ * manifest: {
+ * description: "description",
+ * name: "name",
+ * type: "remote",
+ * url: "url"
+ * }
+ * }
+ */
+export interface PutMcpServerRequest {
+ manifest: TrueForge.McpServerManifest;
+}
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/index.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/index.ts
index d66903ce0..ca8fd94be 100644
--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/index.ts
+++ b/packages/sdk/src/api/resources/settings/resources/mcpServers/client/requests/index.ts
@@ -1,2 +1,2 @@
export type { CreateMcpServerRequest } from "./CreateMcpServerRequest.js";
-export type { McpServerManifest } from "./McpServerManifest.js";
+export type { PutMcpServerRequest } from "./PutMcpServerRequest.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/index.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/index.ts
index d9adb1af9..914b8c3c7 100644
--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/index.ts
+++ b/packages/sdk/src/api/resources/settings/resources/mcpServers/index.ts
@@ -1,2 +1 @@
export * from "./client/index.js";
-export * from "./types/index.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/types/CreateMcpServerRequestAuth.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/types/CreateMcpServerRequestAuth.ts
deleted file mode 100644
index e13af3865..000000000
--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/types/CreateMcpServerRequestAuth.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../../../../index.js";
-
-/**
- * Optional auth settings. Omit when the server needs no credentials.
- */
-export type CreateMcpServerRequestAuth = TrueForge.McpServerDcrAuth | TrueForge.McpServerHeaderAuth;
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/types/index.ts b/packages/sdk/src/api/resources/settings/resources/mcpServers/types/index.ts
deleted file mode 100644
index c33cc3c2b..000000000
--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/types/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export * from "./CreateMcpServerRequestAuth.js";
-export * from "./McpServerManifestAuth.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/modelProviders/client/Client.ts b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/Client.ts
index 6e2054171..4960f7c9f 100644
--- a/packages/sdk/src/api/resources/settings/resources/modelProviders/client/Client.ts
+++ b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/Client.ts
@@ -24,7 +24,7 @@ export class ModelProvidersClient {
}
/**
- * All configured providers with their models.
+ * All configured providers with nested manifests.
*
* @param {ModelProvidersClient.RequestOptions} requestOptions - Request-specific configuration.
*
@@ -123,7 +123,7 @@ export class ModelProvidersClient {
/**
* Creates a provider (models included). Fails if `name` is already taken. Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value required; redacted with no stored secret returns 400.
*
- * @param {TrueForge.ModelProvider} request
+ * @param {TrueForge.settings.CreateModelProviderRequest} request
* @param {ModelProvidersClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -133,28 +133,30 @@ export class ModelProvidersClient {
*
* @example
* await client.settings.modelProviders.create({
- * auth: {
- * apiKey: "api_key"
- * },
- * models: [{
- * modelId: "model_id",
- * name: "name",
- * properties: {}
- * }],
- * type: "alibaba"
+ * manifest: {
+ * auth: {
+ * apiKey: "api_key"
+ * },
+ * models: [{
+ * modelId: "model_id",
+ * name: "name",
+ * properties: {}
+ * }],
+ * type: "alibaba"
+ * }
* })
*/
public create(
- request: TrueForge.ModelProvider,
+ request: TrueForge.settings.CreateModelProviderRequest,
requestOptions?: ModelProvidersClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.PutModelProviderResponse> {
+ ): core.HttpResponsePromise<TrueForge.GetModelProviderResponse> {
return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
}
private async __create(
- request: TrueForge.ModelProvider,
+ request: TrueForge.settings.CreateModelProviderRequest,
requestOptions?: ModelProvidersClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.PutModelProviderResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetModelProviderResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -173,7 +175,7 @@ export class ModelProvidersClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.ModelProvider.jsonOrThrow(request, {
+ serializers.settings.CreateModelProviderRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -189,7 +191,7 @@ export class ModelProvidersClient {
});
if (_response.ok) {
return {
- data: serializers.PutModelProviderResponse.parseOrThrow(_response.body, {
+ data: serializers.GetModelProviderResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -244,7 +246,7 @@ export class ModelProvidersClient {
/**
* Create or replace a provider (models included). Well-known types use `type` as `name` (one each); `custom` is named by the caller. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).
*
- * @param {TrueForge.ModelProvider} request
+ * @param {TrueForge.settings.PutModelProviderRequest} request
* @param {ModelProvidersClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -253,28 +255,30 @@ export class ModelProvidersClient {
*
* @example
* await client.settings.modelProviders.upsert({
- * auth: {
- * apiKey: "api_key"
- * },
- * models: [{
- * modelId: "model_id",
- * name: "name",
- * properties: {}
- * }],
- * type: "alibaba"
+ * manifest: {
+ * auth: {
+ * apiKey: "api_key"
+ * },
+ * models: [{
+ * modelId: "model_id",
+ * name: "name",
+ * properties: {}
+ * }],
+ * type: "alibaba"
+ * }
* })
*/
public upsert(
- request: TrueForge.ModelProvider,
+ request: TrueForge.settings.PutModelProviderRequest,
requestOptions?: ModelProvidersClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.PutModelProviderResponse> {
+ ): core.HttpResponsePromise<TrueForge.GetModelProviderResponse> {
return core.HttpResponsePromise.fromPromise(this.__upsert(request, requestOptions));
}
private async __upsert(
- request: TrueForge.ModelProvider,
+ request: TrueForge.settings.PutModelProviderRequest,
requestOptions?: ModelProvidersClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.PutModelProviderResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetModelProviderResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -293,7 +297,7 @@ export class ModelProvidersClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.ModelProvider.jsonOrThrow(request, {
+ serializers.settings.PutModelProviderRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -309,7 +313,7 @@ export class ModelProvidersClient {
});
if (_response.ok) {
return {
- data: serializers.PutModelProviderResponse.parseOrThrow(_response.body, {
+ data: serializers.GetModelProviderResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/sdk/src/api/resources/settings/resources/modelProviders/client/index.ts b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/index.ts
index cb0ff5c3b..195f9aa8a 100644
--- a/packages/sdk/src/api/resources/settings/resources/modelProviders/client/index.ts
+++ b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/index.ts
@@ -1 +1 @@
-export {};
+export * from "./requests/index.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/CreateModelProviderRequest.ts b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/CreateModelProviderRequest.ts
new file mode 100644
index 000000000..ec568bd66
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/CreateModelProviderRequest.ts
@@ -0,0 +1,23 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../index.js";
+
+/**
+ * @example
+ * {
+ * manifest: {
+ * auth: {
+ * apiKey: "api_key"
+ * },
+ * models: [{
+ * modelId: "model_id",
+ * name: "name",
+ * properties: {}
+ * }],
+ * type: "alibaba"
+ * }
+ * }
+ */
+export interface CreateModelProviderRequest {
+ manifest: TrueForge.ModelProviderManifest;
+}
diff --git a/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts
new file mode 100644
index 000000000..7c0e971e1
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts
@@ -0,0 +1,23 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../index.js";
+
+/**
+ * @example
+ * {
+ * manifest: {
+ * auth: {
+ * apiKey: "api_key"
+ * },
+ * models: [{
+ * modelId: "model_id",
+ * name: "name",
+ * properties: {}
+ * }],
+ * type: "alibaba"
+ * }
+ * }
+ */
+export interface PutModelProviderRequest {
+ manifest: TrueForge.ModelProviderManifest;
+}
diff --git a/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/index.ts b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/index.ts
new file mode 100644
index 000000000..c6e474014
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/modelProviders/client/requests/index.ts
@@ -0,0 +1,2 @@
+export type { CreateModelProviderRequest } from "./CreateModelProviderRequest.js";
+export type { PutModelProviderRequest } from "./PutModelProviderRequest.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/Client.ts b/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/Client.ts
index c7b0b047e..36506683b 100644
--- a/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/Client.ts
+++ b/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/Client.ts
@@ -111,7 +111,7 @@ export class SandboxProvidersClient {
/**
* Upserts the single sandbox provider for this tenant: creates it or replaces its entire configuration. `auth.api_key`: real value sets/rotates; redacted keeps existing (400 if none).
*
- * @param {TrueForge.SandboxProviderManifest} request
+ * @param {TrueForge.settings.PutSandboxProviderRequest} request
* @param {SandboxProvidersClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -121,27 +121,29 @@ export class SandboxProvidersClient {
*
* @example
* await client.settings.sandboxProviders.upsert({
- * auth: {
- * apiKey: "api_key"
- * },
- * autoArchiveIntervalInMinutes: 1,
- * autoDeleteIntervalInMinutes: 1,
- * autoStopIntervalInMinutes: 1,
- * execTimeoutMs: 1,
- * type: "daytona"
+ * manifest: {
+ * auth: {
+ * apiKey: "api_key"
+ * },
+ * autoArchiveIntervalInMinutes: 1,
+ * autoDeleteIntervalInMinutes: 1,
+ * autoStopIntervalInMinutes: 1,
+ * execTimeoutMs: 1,
+ * type: "daytona"
+ * }
* })
*/
public upsert(
- request: TrueForge.SandboxProviderManifest,
+ request: TrueForge.settings.PutSandboxProviderRequest,
requestOptions?: SandboxProvidersClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.PutSandboxProviderResponse> {
+ ): core.HttpResponsePromise<TrueForge.GetSandboxProviderResponse> {
return core.HttpResponsePromise.fromPromise(this.__upsert(request, requestOptions));
}
private async __upsert(
- request: TrueForge.SandboxProviderManifest,
+ request: TrueForge.settings.PutSandboxProviderRequest,
requestOptions?: SandboxProvidersClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.PutSandboxProviderResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetSandboxProviderResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -160,7 +162,7 @@ export class SandboxProvidersClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.SandboxProviderManifest.jsonOrThrow(request, {
+ serializers.settings.PutSandboxProviderRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -176,7 +178,7 @@ export class SandboxProvidersClient {
});
if (_response.ok) {
return {
- data: serializers.PutSandboxProviderResponse.parseOrThrow(_response.body, {
+ data: serializers.GetSandboxProviderResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/index.ts b/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/index.ts
index cb0ff5c3b..195f9aa8a 100644
--- a/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/index.ts
+++ b/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/index.ts
@@ -1 +1 @@
-export {};
+export * from "./requests/index.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts b/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts
new file mode 100644
index 000000000..605758f0a
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts
@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../index.js";
+
+/**
+ * @example
+ * {
+ * manifest: {
+ * auth: {
+ * apiKey: "api_key"
+ * },
+ * autoArchiveIntervalInMinutes: 1,
+ * autoDeleteIntervalInMinutes: 1,
+ * autoStopIntervalInMinutes: 1,
+ * execTimeoutMs: 1,
+ * type: "daytona"
+ * }
+ * }
+ */
+export interface PutSandboxProviderRequest {
+ manifest: TrueForge.SandboxProviderManifest;
+}
diff --git a/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/index.ts b/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/index.ts
new file mode 100644
index 000000000..4c854dfe3
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/index.ts
@@ -0,0 +1 @@
+export type { PutSandboxProviderRequest } from "./PutSandboxProviderRequest.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/skills/client/Client.ts b/packages/sdk/src/api/resources/settings/resources/skills/client/Client.ts
index 34b778ab7..cf132535f 100644
--- a/packages/sdk/src/api/resources/settings/resources/skills/client/Client.ts
+++ b/packages/sdk/src/api/resources/settings/resources/skills/client/Client.ts
@@ -24,7 +24,7 @@ export class SkillsClient {
}
/**
- * All configured skills with full manifests (settings / admin projection).
+ * All configured skills with nested manifests (settings / admin projection).
*
* @param {SkillsClient.RequestOptions} requestOptions - Request-specific configuration.
*
@@ -36,15 +36,13 @@ export class SkillsClient {
* @example
* await client.settings.skills.list()
*/
- public list(
- requestOptions?: SkillsClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.ListConfiguredSkillsResponse> {
+ public list(requestOptions?: SkillsClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListSkillsResponse> {
return core.HttpResponsePromise.fromPromise(this.__list(requestOptions));
}
private async __list(
requestOptions?: SkillsClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.ListConfiguredSkillsResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.ListSkillsResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -68,7 +66,7 @@ export class SkillsClient {
});
if (_response.ok) {
return {
- data: serializers.ListConfiguredSkillsResponse.parseOrThrow(_response.body, {
+ data: serializers.ListSkillsResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -118,7 +116,7 @@ export class SkillsClient {
/**
* Creates a skill keyed by `name`. Fails if `name` is already taken.
*
- * @param {TrueForge.SkillManifest} request
+ * @param {TrueForge.settings.CreateSkillRequest} request
* @param {SkillsClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -128,24 +126,26 @@ export class SkillsClient {
*
* @example
* await client.settings.skills.create({
- * description: "description",
- * name: "name",
- * ref: "ref",
- * type: "git",
- * url: "url"
+ * manifest: {
+ * description: "description",
+ * name: "name",
+ * ref: "ref",
+ * type: "git",
+ * url: "url"
+ * }
* })
*/
public create(
- request: TrueForge.SkillManifest,
+ request: TrueForge.settings.CreateSkillRequest,
requestOptions?: SkillsClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.PutSkillResponse> {
+ ): core.HttpResponsePromise<TrueForge.GetSkillResponse> {
return core.HttpResponsePromise.fromPromise(this.__create(request, requestOptions));
}
private async __create(
- request: TrueForge.SkillManifest,
+ request: TrueForge.settings.CreateSkillRequest,
requestOptions?: SkillsClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.PutSkillResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetSkillResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -164,7 +164,7 @@ export class SkillsClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.SkillManifest.jsonOrThrow(request, {
+ serializers.settings.CreateSkillRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -180,7 +180,7 @@ export class SkillsClient {
});
if (_response.ok) {
return {
- data: serializers.PutSkillResponse.parseOrThrow(_response.body, {
+ data: serializers.GetSkillResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -230,7 +230,7 @@ export class SkillsClient {
/**
* Full upsert keyed by `name`: creates the skill or replaces its entire manifest.
*
- * @param {TrueForge.SkillManifest} request
+ * @param {TrueForge.settings.PutSkillRequest} request
* @param {SkillsClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -239,24 +239,26 @@ export class SkillsClient {
*
* @example
* await client.settings.skills.upsert({
- * description: "description",
- * name: "name",
- * ref: "ref",
- * type: "git",
- * url: "url"
+ * manifest: {
+ * description: "description",
+ * name: "name",
+ * ref: "ref",
+ * type: "git",
+ * url: "url"
+ * }
* })
*/
public upsert(
- request: TrueForge.SkillManifest,
+ request: TrueForge.settings.PutSkillRequest,
requestOptions?: SkillsClient.RequestOptions,
- ): core.HttpResponsePromise<TrueForge.PutSkillResponse> {
+ ): core.HttpResponsePromise<TrueForge.GetSkillResponse> {
return core.HttpResponsePromise.fromPromise(this.__upsert(request, requestOptions));
}
private async __upsert(
- request: TrueForge.SkillManifest,
+ request: TrueForge.settings.PutSkillRequest,
requestOptions?: SkillsClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.PutSkillResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetSkillResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -275,7 +277,7 @@ export class SkillsClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.SkillManifest.jsonOrThrow(request, {
+ serializers.settings.PutSkillRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
@@ -291,7 +293,7 @@ export class SkillsClient {
});
if (_response.ok) {
return {
- data: serializers.PutSkillResponse.parseOrThrow(_response.body, {
+ data: serializers.GetSkillResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/sdk/src/api/resources/settings/resources/skills/client/index.ts b/packages/sdk/src/api/resources/settings/resources/skills/client/index.ts
index cb0ff5c3b..195f9aa8a 100644
--- a/packages/sdk/src/api/resources/settings/resources/skills/client/index.ts
+++ b/packages/sdk/src/api/resources/settings/resources/skills/client/index.ts
@@ -1 +1 @@
-export {};
+export * from "./requests/index.js";
diff --git a/packages/sdk/src/api/resources/settings/resources/skills/client/requests/CreateSkillRequest.ts b/packages/sdk/src/api/resources/settings/resources/skills/client/requests/CreateSkillRequest.ts
new file mode 100644
index 000000000..240bf0de0
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/skills/client/requests/CreateSkillRequest.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../index.js";
+
+/**
+ * @example
+ * {
+ * manifest: {
+ * description: "description",
+ * name: "name",
+ * ref: "ref",
+ * type: "git",
+ * url: "url"
+ * }
+ * }
+ */
+export interface CreateSkillRequest {
+ manifest: TrueForge.SkillManifest;
+}
diff --git a/packages/sdk/src/api/resources/settings/resources/skills/client/requests/PutSkillRequest.ts b/packages/sdk/src/api/resources/settings/resources/skills/client/requests/PutSkillRequest.ts
new file mode 100644
index 000000000..db31edba7
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/skills/client/requests/PutSkillRequest.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../index.js";
+
+/**
+ * @example
+ * {
+ * manifest: {
+ * description: "description",
+ * name: "name",
+ * ref: "ref",
+ * type: "git",
+ * url: "url"
+ * }
+ * }
+ */
+export interface PutSkillRequest {
+ manifest: TrueForge.SkillManifest;
+}
diff --git a/packages/sdk/src/api/resources/settings/resources/skills/client/requests/index.ts b/packages/sdk/src/api/resources/settings/resources/skills/client/requests/index.ts
new file mode 100644
index 000000000..14b4d19b6
--- /dev/null
+++ b/packages/sdk/src/api/resources/settings/resources/skills/client/requests/index.ts
@@ -0,0 +1,2 @@
+export type { CreateSkillRequest } from "./CreateSkillRequest.js";
+export type { PutSkillRequest } from "./PutSkillRequest.js";
diff --git a/packages/sdk/src/api/types/Agent.ts b/packages/sdk/src/api/types/Agent.ts
index 69203f736..7e653aa70 100644
--- a/packages/sdk/src/api/types/Agent.ts
+++ b/packages/sdk/src/api/types/Agent.ts
@@ -6,6 +6,5 @@ export interface Agent {
/** Immutable server-generated agent identifier. */
id: string;
manifest: TrueForge.AgentSpec;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
}
diff --git a/packages/sdk/src/api/types/CatalogMcpServer.ts b/packages/sdk/src/api/types/CatalogMcpServer.ts
index c1b9e2280..c07b94b35 100644
--- a/packages/sdk/src/api/types/CatalogMcpServer.ts
+++ b/packages/sdk/src/api/types/CatalogMcpServer.ts
@@ -3,13 +3,12 @@
import type * as TrueForge from "../index.js";
export interface CatalogMcpServer {
- auth?: TrueForge.ConfiguredMcpServerAuth;
+ auth?: TrueForge.McpServerManifestAuth;
/** Concise summary of what this MCP server provides. */
description: string;
/** URL of the MCP server logo asset. */
logo?: string;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
type: TrueForge.McpServerType;
/** URL of the remote MCP server. */
url: string;
diff --git a/packages/sdk/src/api/types/CatalogSkill.ts b/packages/sdk/src/api/types/CatalogSkill.ts
index 5363671f3..c2a97aa87 100644
--- a/packages/sdk/src/api/types/CatalogSkill.ts
+++ b/packages/sdk/src/api/types/CatalogSkill.ts
@@ -5,8 +5,7 @@ import type * as TrueForge from "../index.js";
export interface CatalogSkill {
/** Concise guidance for when the agent should use the skill. */
description: string;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
/** Path to the skill directory within the repository. Omit to use the repository root. */
path?: string;
/** Git ref — branch name, tag, or commit SHA. */
diff --git a/packages/sdk/src/api/types/ConfiguredMcpServer.ts b/packages/sdk/src/api/types/ConfiguredMcpServer.ts
index ce6197687..e059d504b 100644
--- a/packages/sdk/src/api/types/ConfiguredMcpServer.ts
+++ b/packages/sdk/src/api/types/ConfiguredMcpServer.ts
@@ -3,14 +3,7 @@
import type * as TrueForge from "../index.js";
export interface ConfiguredMcpServer {
- /** Optional auth settings. Omit when the server needs no credentials. */
- auth?: TrueForge.ConfiguredMcpServerAuth;
authStatus: TrueForge.McpAuthStatus;
- /** Concise summary of what this MCP server provides. */
- description: string;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
- type: TrueForge.McpServerType;
- /** URL of the remote MCP server. */
- url: string;
+ manifest: TrueForge.McpServerManifest;
+ name: TrueForge.ResourceName;
}
diff --git a/packages/sdk/src/api/types/ConfiguredMcpServerAuth.ts b/packages/sdk/src/api/types/ConfiguredMcpServerAuth.ts
deleted file mode 100644
index d0f252d25..000000000
--- a/packages/sdk/src/api/types/ConfiguredMcpServerAuth.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../index.js";
-
-/**
- * Optional default auth settings for the preset.
- */
-export type ConfiguredMcpServerAuth = TrueForge.McpServerDcrAuth | TrueForge.McpServerHeaderAuth;
diff --git a/packages/sdk/src/api/types/PutSandboxProviderResponse.ts b/packages/sdk/src/api/types/ConfiguredSkill.ts
similarity index 51%
rename from packages/sdk/src/api/types/PutSandboxProviderResponse.ts
rename to packages/sdk/src/api/types/ConfiguredSkill.ts
index 41edad400..3bfe0edfd 100644
--- a/packages/sdk/src/api/types/PutSandboxProviderResponse.ts
+++ b/packages/sdk/src/api/types/ConfiguredSkill.ts
@@ -2,6 +2,7 @@
import type * as TrueForge from "../index.js";
-export interface PutSandboxProviderResponse {
- data: TrueForge.SandboxProviderResponse;
+export interface ConfiguredSkill {
+ manifest: TrueForge.SkillManifest;
+ name: TrueForge.ResourceName;
}
diff --git a/packages/sdk/src/api/types/CustomModelProvider.ts b/packages/sdk/src/api/types/CustomModelProvider.ts
index 811f63470..51f2cea0b 100644
--- a/packages/sdk/src/api/types/CustomModelProvider.ts
+++ b/packages/sdk/src/api/types/CustomModelProvider.ts
@@ -8,7 +8,6 @@ export interface CustomModelProvider {
baseUrl: string;
/** Models exposed by this provider (at least one). */
models: TrueForge.ModelEntry[];
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
type: "custom";
}
diff --git a/packages/sdk/src/api/types/PutModelProviderResponse.ts b/packages/sdk/src/api/types/GetModelProviderResponse.ts
similarity index 77%
rename from packages/sdk/src/api/types/PutModelProviderResponse.ts
rename to packages/sdk/src/api/types/GetModelProviderResponse.ts
index 3a9903a3f..584edb738 100644
--- a/packages/sdk/src/api/types/PutModelProviderResponse.ts
+++ b/packages/sdk/src/api/types/GetModelProviderResponse.ts
@@ -2,6 +2,6 @@
import type * as TrueForge from "../index.js";
-export interface PutModelProviderResponse {
+export interface GetModelProviderResponse {
data: TrueForge.ModelProvider;
}
diff --git a/packages/sdk/src/api/types/GetSandboxProviderResponse.ts b/packages/sdk/src/api/types/GetSandboxProviderResponse.ts
index 31a2a1051..9dfbea272 100644
--- a/packages/sdk/src/api/types/GetSandboxProviderResponse.ts
+++ b/packages/sdk/src/api/types/GetSandboxProviderResponse.ts
@@ -3,5 +3,5 @@
import type * as TrueForge from "../index.js";
export interface GetSandboxProviderResponse {
- data: TrueForge.SandboxProviderResponse;
+ data: TrueForge.SandboxProvider;
}
diff --git a/packages/sdk/src/api/types/PutSkillResponse.ts b/packages/sdk/src/api/types/GetSkillResponse.ts
similarity index 61%
rename from packages/sdk/src/api/types/PutSkillResponse.ts
rename to packages/sdk/src/api/types/GetSkillResponse.ts
index bd4333283..c949bcea0 100644
--- a/packages/sdk/src/api/types/PutSkillResponse.ts
+++ b/packages/sdk/src/api/types/GetSkillResponse.ts
@@ -2,6 +2,6 @@
import type * as TrueForge from "../index.js";
-export interface PutSkillResponse {
- data: TrueForge.SkillManifest;
+export interface GetSkillResponse {
+ data: TrueForge.ConfiguredSkill;
}
diff --git a/packages/sdk/src/api/types/ListConfiguredSkillsResponse.ts b/packages/sdk/src/api/types/ListConfiguredSkillsResponse.ts
deleted file mode 100644
index 71e6e07dc..000000000
--- a/packages/sdk/src/api/types/ListConfiguredSkillsResponse.ts
+++ /dev/null
@@ -1,7 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../index.js";
-
-export interface ListConfiguredSkillsResponse {
- data: TrueForge.SkillManifest[];
-}
diff --git a/packages/sdk/src/api/types/PutMcpServerResponse.ts b/packages/sdk/src/api/types/ListSkillsResponse.ts
similarity index 58%
rename from packages/sdk/src/api/types/PutMcpServerResponse.ts
rename to packages/sdk/src/api/types/ListSkillsResponse.ts
index 76a306e06..d7f2ec6f5 100644
--- a/packages/sdk/src/api/types/PutMcpServerResponse.ts
+++ b/packages/sdk/src/api/types/ListSkillsResponse.ts
@@ -2,6 +2,6 @@
import type * as TrueForge from "../index.js";
-export interface PutMcpServerResponse {
- data: TrueForge.ConfiguredMcpServer;
+export interface ListSkillsResponse {
+ data: TrueForge.ConfiguredSkill[];
}
diff --git a/packages/sdk/src/api/types/McpAuthStatus.ts b/packages/sdk/src/api/types/McpAuthStatus.ts
index 6aea9c4ed..37b1d8b01 100644
--- a/packages/sdk/src/api/types/McpAuthStatus.ts
+++ b/packages/sdk/src/api/types/McpAuthStatus.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../index.js";
/**
- * Auth state for the calling user.
+ * Current auth state.
*/
export interface McpAuthStatus {
/** When auth is required, this contains the URL to redirect the user to for authorization. */
diff --git a/packages/sdk/src/api/types/McpServerManifest.ts b/packages/sdk/src/api/types/McpServerManifest.ts
new file mode 100644
index 000000000..d03e2dd49
--- /dev/null
+++ b/packages/sdk/src/api/types/McpServerManifest.ts
@@ -0,0 +1,13 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../index.js";
+
+export interface McpServerManifest {
+ auth?: TrueForge.McpServerManifestAuth;
+ /** Concise summary of what this MCP server provides. */
+ description: string;
+ name: TrueForge.ResourceName;
+ type: TrueForge.McpServerType;
+ /** URL of the remote MCP server. */
+ url: string;
+}
diff --git a/packages/sdk/src/api/resources/settings/resources/mcpServers/types/McpServerManifestAuth.ts b/packages/sdk/src/api/types/McpServerManifestAuth.ts
similarity index 80%
rename from packages/sdk/src/api/resources/settings/resources/mcpServers/types/McpServerManifestAuth.ts
rename to packages/sdk/src/api/types/McpServerManifestAuth.ts
index 9cd21f5d5..c1e6f3e95 100644
--- a/packages/sdk/src/api/resources/settings/resources/mcpServers/types/McpServerManifestAuth.ts
+++ b/packages/sdk/src/api/types/McpServerManifestAuth.ts
@@ -1,6 +1,6 @@
// This file was auto-generated by Fern from our API Definition.
-import type * as TrueForge from "../../../../../index.js";
+import type * as TrueForge from "../index.js";
/**
* Optional auth settings. Omit when the server needs no credentials.
diff --git a/packages/sdk/src/api/types/McpServerReadEntry.ts b/packages/sdk/src/api/types/McpServerReadEntry.ts
index 8e7130b45..0342b0b6e 100644
--- a/packages/sdk/src/api/types/McpServerReadEntry.ts
+++ b/packages/sdk/src/api/types/McpServerReadEntry.ts
@@ -5,8 +5,7 @@ import type * as TrueForge from "../index.js";
export interface McpServerReadEntry {
auth?: TrueForge.McpServerAuthPublic;
authStatus: TrueForge.McpAuthStatus;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
/** URL of the remote MCP server. */
url: string;
}
diff --git a/packages/sdk/src/api/types/McpServerType.ts b/packages/sdk/src/api/types/McpServerType.ts
index 611c0e4fd..01de5c507 100644
--- a/packages/sdk/src/api/types/McpServerType.ts
+++ b/packages/sdk/src/api/types/McpServerType.ts
@@ -1,6 +1,3 @@
// This file was auto-generated by Fern from our API Definition.
-/**
- * MCP server kind (`remote` today).
- */
export type McpServerType = "remote";
diff --git a/packages/sdk/src/api/types/ModelProvider.ts b/packages/sdk/src/api/types/ModelProvider.ts
index 8b9a489d1..01db588bc 100644
--- a/packages/sdk/src/api/types/ModelProvider.ts
+++ b/packages/sdk/src/api/types/ModelProvider.ts
@@ -2,13 +2,7 @@
import type * as TrueForge from "../index.js";
-export type ModelProvider =
- | TrueForge.AlibabaModelProvider
- | TrueForge.AnthropicModelProvider
- | TrueForge.CustomModelProvider
- | TrueForge.FireworksModelProvider
- | TrueForge.GoogleGeminiModelProvider
- | TrueForge.MoonshotModelProvider
- | TrueForge.OpenAiModelProvider
- | TrueForge.TogetherAiModelProvider
- | TrueForge.ZaiModelProvider;
+export interface ModelProvider {
+ manifest: TrueForge.ModelProviderManifest;
+ name: TrueForge.ResourceName;
+}
diff --git a/packages/sdk/src/api/types/ModelProviderManifest.ts b/packages/sdk/src/api/types/ModelProviderManifest.ts
new file mode 100644
index 000000000..548b61e3a
--- /dev/null
+++ b/packages/sdk/src/api/types/ModelProviderManifest.ts
@@ -0,0 +1,14 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../index.js";
+
+export type ModelProviderManifest =
+ | TrueForge.AlibabaModelProvider
+ | TrueForge.AnthropicModelProvider
+ | TrueForge.CustomModelProvider
+ | TrueForge.FireworksModelProvider
+ | TrueForge.GoogleGeminiModelProvider
+ | TrueForge.MoonshotModelProvider
+ | TrueForge.OpenAiModelProvider
+ | TrueForge.TogetherAiModelProvider
+ | TrueForge.ZaiModelProvider;
diff --git a/packages/sdk/src/api/types/ResourceName.ts b/packages/sdk/src/api/types/ResourceName.ts
index 9262e6cc1..f135c1be3 100644
--- a/packages/sdk/src/api/types/ResourceName.ts
+++ b/packages/sdk/src/api/types/ResourceName.ts
@@ -1,6 +1,3 @@
// This file was auto-generated by Fern from our API Definition.
-/**
- * Internal identifier; forms the fully qualified name `name/model_name`.
- */
export type ResourceName = string;
diff --git a/packages/sdk/src/api/types/SandboxProviderResponse.ts b/packages/sdk/src/api/types/SandboxProvider.ts
similarity index 87%
rename from packages/sdk/src/api/types/SandboxProviderResponse.ts
rename to packages/sdk/src/api/types/SandboxProvider.ts
index c686234bc..7ac73aac7 100644
--- a/packages/sdk/src/api/types/SandboxProviderResponse.ts
+++ b/packages/sdk/src/api/types/SandboxProvider.ts
@@ -2,7 +2,7 @@
import type * as TrueForge from "../index.js";
-export interface SandboxProviderResponse {
+export interface SandboxProvider {
manifest: TrueForge.SandboxProviderManifest;
status: TrueForge.SandboxBuildStatus;
/** Human-readable detail for the current status; null when ready. */
diff --git a/packages/sdk/src/api/types/SessionAgentNameRef.ts b/packages/sdk/src/api/types/SessionAgentNameRef.ts
index 0382709ee..1a9cf43f3 100644
--- a/packages/sdk/src/api/types/SessionAgentNameRef.ts
+++ b/packages/sdk/src/api/types/SessionAgentNameRef.ts
@@ -1,6 +1,7 @@
// This file was auto-generated by Fern from our API Definition.
+import type * as TrueForge from "../index.js";
+
export interface SessionAgentNameRef {
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
}
diff --git a/packages/sdk/src/api/types/SkillManifest.ts b/packages/sdk/src/api/types/SkillManifest.ts
index 264eaccd4..be259a29a 100644
--- a/packages/sdk/src/api/types/SkillManifest.ts
+++ b/packages/sdk/src/api/types/SkillManifest.ts
@@ -5,8 +5,7 @@ import type * as TrueForge from "../index.js";
export interface SkillManifest {
/** Concise guidance for when the agent should use the skill. */
description: string;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
/** Path to the skill directory within the repository. Omit to use the repository root. */
path?: string;
/** Git ref — branch name, tag, or commit SHA. */
diff --git a/packages/sdk/src/api/types/SkillReadEntry.ts b/packages/sdk/src/api/types/SkillReadEntry.ts
index 9bb5f0d26..2fb965b32 100644
--- a/packages/sdk/src/api/types/SkillReadEntry.ts
+++ b/packages/sdk/src/api/types/SkillReadEntry.ts
@@ -1,8 +1,9 @@
// This file was auto-generated by Fern from our API Definition.
+import type * as TrueForge from "../index.js";
+
export interface SkillReadEntry {
/** Concise guidance for when the agent should use the skill. */
description: string;
- /** Fully qualified name. Unique within a tenant. */
- name: string;
+ name: TrueForge.ResourceName;
}
diff --git a/packages/sdk/src/api/types/index.ts b/packages/sdk/src/api/types/index.ts
index 02699611b..90b4501e3 100644
--- a/packages/sdk/src/api/types/index.ts
+++ b/packages/sdk/src/api/types/index.ts
@@ -28,7 +28,7 @@ export * from "./ChatCompletionContentPartText.js";
export * from "./ChatCompletionMessageToolCall.js";
export * from "./ChatCompletionMessageToolCallFunction.js";
export * from "./ConfiguredMcpServer.js";
-export * from "./ConfiguredMcpServerAuth.js";
+export * from "./ConfiguredSkill.js";
export * from "./ContextManagementConfig.js";
export * from "./ContextManagementConfigCompaction.js";
export * from "./CreateSessionAgent.js";
@@ -50,17 +50,18 @@ export * from "./GetCapabilitiesResponseDataSkill.js";
export * from "./GetMcpServerCatalogResponse.js";
export * from "./GetMcpServerResponse.js";
export * from "./GetModelProviderCatalogResponse.js";
+export * from "./GetModelProviderResponse.js";
export * from "./GetSandboxProviderCatalogResponse.js";
export * from "./GetSandboxProviderResponse.js";
export * from "./GetSessionResponse.js";
export * from "./GetSkillCatalogResponse.js";
+export * from "./GetSkillResponse.js";
export * from "./GetTurnResponse.js";
export * from "./GoogleGeminiModelProvider.js";
export * from "./LargeToolResponseConfig.js";
export * from "./ListAgentsResponse.js";
export * from "./ListAvailableMcpServersResponse.js";
export * from "./ListAvailableSkillsResponse.js";
-export * from "./ListConfiguredSkillsResponse.js";
export * from "./ListMcpServersResponse.js";
export * from "./ListMcpServerToolsResponse.js";
export * from "./ListModelProvidersResponse.js";
@@ -68,6 +69,7 @@ export * from "./ListModelsResponse.js";
export * from "./ListSessionEventsResponse.js";
export * from "./ListSessionsOrder.js";
export * from "./ListSessionsResponse.js";
+export * from "./ListSkillsResponse.js";
export * from "./ListTurnEventsOrder.js";
export * from "./ListTurnEventsResponse.js";
export * from "./ListTurnsResponse.js";
@@ -86,6 +88,8 @@ export * from "./McpServerEnableToolsItem.js";
export * from "./McpServerHeaderAuth.js";
export * from "./McpServerInitInfo.js";
export * from "./McpServerInitInfoTransportType.js";
+export * from "./McpServerManifest.js";
+export * from "./McpServerManifestAuth.js";
export * from "./McpServerPreloadToolsItem.js";
export * from "./McpServerReadEntry.js";
export * from "./McpServerRequireApprovalForToolsItem.js";
@@ -106,13 +110,10 @@ export * from "./ModelParams.js";
export * from "./ModelProperties.js";
export * from "./ModelProvider.js";
export * from "./ModelProviderAuth.js";
+export * from "./ModelProviderManifest.js";
export * from "./MoonshotModelProvider.js";
export * from "./OpenAiModelProvider.js";
export * from "./PreviousTurnIdInput.js";
-export * from "./PutMcpServerResponse.js";
-export * from "./PutModelProviderResponse.js";
-export * from "./PutSandboxProviderResponse.js";
-export * from "./PutSkillResponse.js";
export * from "./RawToolCall.js";
export * from "./ReasoningEffort.js";
export * from "./RequestErrorResponse.js";
@@ -131,8 +132,8 @@ export * from "./SandboxNetworkPolicy.js";
export * from "./SandboxNetworkPolicyAuthInjectItem.js";
export * from "./SandboxNetworkPolicyAuthInjectItemAuthData.js";
export * from "./SandboxNetworkPolicyAuthInjectItemMatch.js";
+export * from "./SandboxProvider.js";
export * from "./SandboxProviderManifest.js";
-export * from "./SandboxProviderResponse.js";
export * from "./Session.js";
export * from "./SessionAgent.js";
export * from "./SessionAgentInline.js";
diff --git a/packages/sdk/src/serialization/resources/agents/client/requests/CreateAgentRequest.ts b/packages/sdk/src/serialization/resources/agents/client/requests/CreateAgentRequest.ts
index 1c20ff65d..27456816a 100644
--- a/packages/sdk/src/serialization/resources/agents/client/requests/CreateAgentRequest.ts
+++ b/packages/sdk/src/serialization/resources/agents/client/requests/CreateAgentRequest.ts
@@ -4,18 +4,19 @@ import type * as TrueForge from "../../../../../api/index.js";
import * as core from "../../../../../core/index.js";
import type * as serializers from "../../../../index.js";
import { AgentSpec } from "../../../../types/AgentSpec.js";
+import { ResourceName } from "../../../../types/ResourceName.js";
export const CreateAgentRequest: core.serialization.Schema<
serializers.CreateAgentRequest.Raw,
TrueForge.CreateAgentRequest
> = core.serialization.object({
manifest: AgentSpec,
- name: core.serialization.string(),
+ name: ResourceName,
});
export declare namespace CreateAgentRequest {
export interface Raw {
manifest: AgentSpec.Raw;
- name: string;
+ name: ResourceName.Raw;
}
}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/index.ts b/packages/sdk/src/serialization/resources/settings/resources/index.ts
index 5d32abc0e..61dea343e 100644
--- a/packages/sdk/src/serialization/resources/settings/resources/index.ts
+++ b/packages/sdk/src/serialization/resources/settings/resources/index.ts
@@ -1,3 +1,8 @@
export * from "./mcpServers/client/requests/index.js";
export * as mcpServers from "./mcpServers/index.js";
-export * from "./mcpServers/types/index.js";
+export * from "./modelProviders/client/requests/index.js";
+export * as modelProviders from "./modelProviders/index.js";
+export * from "./sandboxProviders/client/requests/index.js";
+export * as sandboxProviders from "./sandboxProviders/index.js";
+export * from "./skills/client/requests/index.js";
+export * as skills from "./skills/index.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/CreateMcpServerRequest.ts b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/CreateMcpServerRequest.ts
index c1d7719e2..0902467f2 100644
--- a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/CreateMcpServerRequest.ts
+++ b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/CreateMcpServerRequest.ts
@@ -3,23 +3,17 @@
import type * as TrueForge from "../../../../../../../api/index.js";
import * as core from "../../../../../../../core/index.js";
import type * as serializers from "../../../../../../index.js";
-import { CreateMcpServerRequestAuth } from "../../types/CreateMcpServerRequestAuth.js";
+import { McpServerManifest } from "../../../../../../types/McpServerManifest.js";
export const CreateMcpServerRequest: core.serialization.Schema<
serializers.settings.CreateMcpServerRequest.Raw,
TrueForge.settings.CreateMcpServerRequest
> = core.serialization.object({
- auth: CreateMcpServerRequestAuth.optional(),
- description: core.serialization.string(),
- name: core.serialization.string(),
- url: core.serialization.string(),
+ manifest: McpServerManifest,
});
export declare namespace CreateMcpServerRequest {
export interface Raw {
- auth?: CreateMcpServerRequestAuth.Raw | null;
- description: string;
- name: string;
- url: string;
+ manifest: McpServerManifest.Raw;
}
}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/McpServerManifest.ts b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/McpServerManifest.ts
deleted file mode 100644
index b56714385..000000000
--- a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/McpServerManifest.ts
+++ /dev/null
@@ -1,25 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../../../../../../api/index.js";
-import * as core from "../../../../../../../core/index.js";
-import type * as serializers from "../../../../../../index.js";
-import { McpServerManifestAuth } from "../../types/McpServerManifestAuth.js";
-
-export const McpServerManifest: core.serialization.Schema<
- serializers.settings.McpServerManifest.Raw,
- TrueForge.settings.McpServerManifest
-> = core.serialization.object({
- auth: McpServerManifestAuth.optional(),
- description: core.serialization.string(),
- name: core.serialization.string(),
- url: core.serialization.string(),
-});
-
-export declare namespace McpServerManifest {
- export interface Raw {
- auth?: McpServerManifestAuth.Raw | null;
- description: string;
- name: string;
- url: string;
- }
-}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts
new file mode 100644
index 000000000..448505cdb
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../../api/index.js";
+import * as core from "../../../../../../../core/index.js";
+import type * as serializers from "../../../../../../index.js";
+import { McpServerManifest } from "../../../../../../types/McpServerManifest.js";
+
+export const PutMcpServerRequest: core.serialization.Schema<
+ serializers.settings.PutMcpServerRequest.Raw,
+ TrueForge.settings.PutMcpServerRequest
+> = core.serialization.object({
+ manifest: McpServerManifest,
+});
+
+export declare namespace PutMcpServerRequest {
+ export interface Raw {
+ manifest: McpServerManifest.Raw;
+ }
+}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/index.ts b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/index.ts
index 9aacc709f..989c1f851 100644
--- a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/index.ts
+++ b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/index.ts
@@ -1,2 +1,2 @@
export { CreateMcpServerRequest } from "./CreateMcpServerRequest.js";
-export { McpServerManifest } from "./McpServerManifest.js";
+export { PutMcpServerRequest } from "./PutMcpServerRequest.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/index.ts b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/index.ts
index d9adb1af9..914b8c3c7 100644
--- a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/index.ts
+++ b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/index.ts
@@ -1,2 +1 @@
export * from "./client/index.js";
-export * from "./types/index.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/CreateMcpServerRequestAuth.ts b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/CreateMcpServerRequestAuth.ts
deleted file mode 100644
index d92fe35da..000000000
--- a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/CreateMcpServerRequestAuth.ts
+++ /dev/null
@@ -1,16 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../../../../../api/index.js";
-import * as core from "../../../../../../core/index.js";
-import type * as serializers from "../../../../../index.js";
-import { McpServerDcrAuth } from "../../../../../types/McpServerDcrAuth.js";
-import { McpServerHeaderAuth } from "../../../../../types/McpServerHeaderAuth.js";
-
-export const CreateMcpServerRequestAuth: core.serialization.Schema<
- serializers.settings.CreateMcpServerRequestAuth.Raw,
- TrueForge.settings.CreateMcpServerRequestAuth
-> = core.serialization.undiscriminatedUnion([McpServerDcrAuth, McpServerHeaderAuth]);
-
-export declare namespace CreateMcpServerRequestAuth {
- export type Raw = McpServerDcrAuth.Raw | McpServerHeaderAuth.Raw;
-}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/McpServerManifestAuth.ts b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/McpServerManifestAuth.ts
deleted file mode 100644
index 619ff1092..000000000
--- a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/McpServerManifestAuth.ts
+++ /dev/null
@@ -1,16 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../../../../../api/index.js";
-import * as core from "../../../../../../core/index.js";
-import type * as serializers from "../../../../../index.js";
-import { McpServerDcrAuth } from "../../../../../types/McpServerDcrAuth.js";
-import { McpServerHeaderAuth } from "../../../../../types/McpServerHeaderAuth.js";
-
-export const McpServerManifestAuth: core.serialization.Schema<
- serializers.settings.McpServerManifestAuth.Raw,
- TrueForge.settings.McpServerManifestAuth
-> = core.serialization.undiscriminatedUnion([McpServerDcrAuth, McpServerHeaderAuth]);
-
-export declare namespace McpServerManifestAuth {
- export type Raw = McpServerDcrAuth.Raw | McpServerHeaderAuth.Raw;
-}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/index.ts b/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/index.ts
deleted file mode 100644
index c33cc3c2b..000000000
--- a/packages/sdk/src/serialization/resources/settings/resources/mcpServers/types/index.ts
+++ /dev/null
@@ -1,2 +0,0 @@
-export * from "./CreateMcpServerRequestAuth.js";
-export * from "./McpServerManifestAuth.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/index.ts b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/index.ts
new file mode 100644
index 000000000..195f9aa8a
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/index.ts
@@ -0,0 +1 @@
+export * from "./requests/index.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/CreateModelProviderRequest.ts b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/CreateModelProviderRequest.ts
new file mode 100644
index 000000000..4426588f8
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/CreateModelProviderRequest.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../../api/index.js";
+import * as core from "../../../../../../../core/index.js";
+import type * as serializers from "../../../../../../index.js";
+import { ModelProviderManifest } from "../../../../../../types/ModelProviderManifest.js";
+
+export const CreateModelProviderRequest: core.serialization.Schema<
+ serializers.settings.CreateModelProviderRequest.Raw,
+ TrueForge.settings.CreateModelProviderRequest
+> = core.serialization.object({
+ manifest: ModelProviderManifest,
+});
+
+export declare namespace CreateModelProviderRequest {
+ export interface Raw {
+ manifest: ModelProviderManifest.Raw;
+ }
+}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts
new file mode 100644
index 000000000..8cb14a1a6
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../../api/index.js";
+import * as core from "../../../../../../../core/index.js";
+import type * as serializers from "../../../../../../index.js";
+import { ModelProviderManifest } from "../../../../../../types/ModelProviderManifest.js";
+
+export const PutModelProviderRequest: core.serialization.Schema<
+ serializers.settings.PutModelProviderRequest.Raw,
+ TrueForge.settings.PutModelProviderRequest
+> = core.serialization.object({
+ manifest: ModelProviderManifest,
+});
+
+export declare namespace PutModelProviderRequest {
+ export interface Raw {
+ manifest: ModelProviderManifest.Raw;
+ }
+}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/index.ts b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/index.ts
new file mode 100644
index 000000000..81f829943
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/index.ts
@@ -0,0 +1,2 @@
+export { CreateModelProviderRequest } from "./CreateModelProviderRequest.js";
+export { PutModelProviderRequest } from "./PutModelProviderRequest.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/modelProviders/index.ts b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/index.ts
new file mode 100644
index 000000000..914b8c3c7
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/modelProviders/index.ts
@@ -0,0 +1 @@
+export * from "./client/index.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/index.ts b/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/index.ts
new file mode 100644
index 000000000..195f9aa8a
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/index.ts
@@ -0,0 +1 @@
+export * from "./requests/index.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts b/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts
new file mode 100644
index 000000000..ed980b2f9
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../../api/index.js";
+import * as core from "../../../../../../../core/index.js";
+import type * as serializers from "../../../../../../index.js";
+import { SandboxProviderManifest } from "../../../../../../types/SandboxProviderManifest.js";
+
+export const PutSandboxProviderRequest: core.serialization.Schema<
+ serializers.settings.PutSandboxProviderRequest.Raw,
+ TrueForge.settings.PutSandboxProviderRequest
+> = core.serialization.object({
+ manifest: SandboxProviderManifest,
+});
+
+export declare namespace PutSandboxProviderRequest {
+ export interface Raw {
+ manifest: SandboxProviderManifest.Raw;
+ }
+}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/index.ts b/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/index.ts
new file mode 100644
index 000000000..403325eda
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/index.ts
@@ -0,0 +1 @@
+export { PutSandboxProviderRequest } from "./PutSandboxProviderRequest.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/index.ts b/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/index.ts
new file mode 100644
index 000000000..914b8c3c7
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/sandboxProviders/index.ts
@@ -0,0 +1 @@
+export * from "./client/index.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/skills/client/index.ts b/packages/sdk/src/serialization/resources/settings/resources/skills/client/index.ts
new file mode 100644
index 000000000..195f9aa8a
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/skills/client/index.ts
@@ -0,0 +1 @@
+export * from "./requests/index.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/CreateSkillRequest.ts b/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/CreateSkillRequest.ts
new file mode 100644
index 000000000..31c0a1d0b
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/CreateSkillRequest.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../../api/index.js";
+import * as core from "../../../../../../../core/index.js";
+import type * as serializers from "../../../../../../index.js";
+import { SkillManifest } from "../../../../../../types/SkillManifest.js";
+
+export const CreateSkillRequest: core.serialization.Schema<
+ serializers.settings.CreateSkillRequest.Raw,
+ TrueForge.settings.CreateSkillRequest
+> = core.serialization.object({
+ manifest: SkillManifest,
+});
+
+export declare namespace CreateSkillRequest {
+ export interface Raw {
+ manifest: SkillManifest.Raw;
+ }
+}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/PutSkillRequest.ts b/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/PutSkillRequest.ts
new file mode 100644
index 000000000..ff096bf7d
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/PutSkillRequest.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../../../../../../api/index.js";
+import * as core from "../../../../../../../core/index.js";
+import type * as serializers from "../../../../../../index.js";
+import { SkillManifest } from "../../../../../../types/SkillManifest.js";
+
+export const PutSkillRequest: core.serialization.Schema<
+ serializers.settings.PutSkillRequest.Raw,
+ TrueForge.settings.PutSkillRequest
+> = core.serialization.object({
+ manifest: SkillManifest,
+});
+
+export declare namespace PutSkillRequest {
+ export interface Raw {
+ manifest: SkillManifest.Raw;
+ }
+}
diff --git a/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/index.ts b/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/index.ts
new file mode 100644
index 000000000..ed2b49c7a
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/skills/client/requests/index.ts
@@ -0,0 +1,2 @@
+export { CreateSkillRequest } from "./CreateSkillRequest.js";
+export { PutSkillRequest } from "./PutSkillRequest.js";
diff --git a/packages/sdk/src/serialization/resources/settings/resources/skills/index.ts b/packages/sdk/src/serialization/resources/settings/resources/skills/index.ts
new file mode 100644
index 000000000..914b8c3c7
--- /dev/null
+++ b/packages/sdk/src/serialization/resources/settings/resources/skills/index.ts
@@ -0,0 +1 @@
+export * from "./client/index.js";
diff --git a/packages/sdk/src/serialization/types/Agent.ts b/packages/sdk/src/serialization/types/Agent.ts
index 2eba62666..1b8a7159b 100644
--- a/packages/sdk/src/serialization/types/Agent.ts
+++ b/packages/sdk/src/serialization/types/Agent.ts
@@ -4,12 +4,13 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
import { AgentSpec } from "./AgentSpec.js";
+import { ResourceName } from "./ResourceName.js";
export const Agent: core.serialization.ObjectSchema<serializers.Agent.Raw, TrueForge.Agent> = core.serialization.object(
{
id: core.serialization.string(),
manifest: AgentSpec,
- name: core.serialization.string(),
+ name: ResourceName,
},
);
@@ -17,6 +18,6 @@ export declare namespace Agent {
export interface Raw {
id: string;
manifest: AgentSpec.Raw;
- name: string;
+ name: ResourceName.Raw;
}
}
diff --git a/packages/sdk/src/serialization/types/CatalogMcpServer.ts b/packages/sdk/src/serialization/types/CatalogMcpServer.ts
index 27f7a835e..7a8634ae5 100644
--- a/packages/sdk/src/serialization/types/CatalogMcpServer.ts
+++ b/packages/sdk/src/serialization/types/CatalogMcpServer.ts
@@ -3,27 +3,28 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ConfiguredMcpServerAuth } from "./ConfiguredMcpServerAuth.js";
+import { McpServerManifestAuth } from "./McpServerManifestAuth.js";
import { McpServerType } from "./McpServerType.js";
+import { ResourceName } from "./ResourceName.js";
export const CatalogMcpServer: core.serialization.ObjectSchema<
serializers.CatalogMcpServer.Raw,
TrueForge.CatalogMcpServer
> = core.serialization.object({
- auth: ConfiguredMcpServerAuth.optional(),
+ auth: McpServerManifestAuth.optional(),
description: core.serialization.string(),
logo: core.serialization.string().optional(),
- name: core.serialization.string(),
+ name: ResourceName,
type: McpServerType,
url: core.serialization.string(),
});
export declare namespace CatalogMcpServer {
export interface Raw {
- auth?: ConfiguredMcpServerAuth.Raw | null;
+ auth?: McpServerManifestAuth.Raw | null;
description: string;
logo?: string | null;
- name: string;
+ name: ResourceName.Raw;
type: McpServerType.Raw;
url: string;
}
diff --git a/packages/sdk/src/serialization/types/CatalogSkill.ts b/packages/sdk/src/serialization/types/CatalogSkill.ts
index a63b6389f..2b226f16b 100644
--- a/packages/sdk/src/serialization/types/CatalogSkill.ts
+++ b/packages/sdk/src/serialization/types/CatalogSkill.ts
@@ -3,12 +3,13 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
+import { ResourceName } from "./ResourceName.js";
import { SkillType } from "./SkillType.js";
export const CatalogSkill: core.serialization.ObjectSchema<serializers.CatalogSkill.Raw, TrueForge.CatalogSkill> =
core.serialization.object({
description: core.serialization.string(),
- name: core.serialization.string(),
+ name: ResourceName,
path: core.serialization.string().optional(),
ref: core.serialization.string(),
type: SkillType,
@@ -18,7 +19,7 @@ export const CatalogSkill: core.serialization.ObjectSchema<serializers.CatalogSk
export declare namespace CatalogSkill {
export interface Raw {
description: string;
- name: string;
+ name: ResourceName.Raw;
path?: string | null;
ref: string;
type: SkillType.Raw;
diff --git a/packages/sdk/src/serialization/types/ConfiguredMcpServer.ts b/packages/sdk/src/serialization/types/ConfiguredMcpServer.ts
index 3f4d35fba..786ed6bd1 100644
--- a/packages/sdk/src/serialization/types/ConfiguredMcpServer.ts
+++ b/packages/sdk/src/serialization/types/ConfiguredMcpServer.ts
@@ -3,29 +3,23 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ConfiguredMcpServerAuth } from "./ConfiguredMcpServerAuth.js";
import { McpAuthStatus } from "./McpAuthStatus.js";
-import { McpServerType } from "./McpServerType.js";
+import { McpServerManifest } from "./McpServerManifest.js";
+import { ResourceName } from "./ResourceName.js";
export const ConfiguredMcpServer: core.serialization.ObjectSchema<
serializers.ConfiguredMcpServer.Raw,
TrueForge.ConfiguredMcpServer
> = core.serialization.object({
- auth: ConfiguredMcpServerAuth.optional(),
authStatus: core.serialization.property("auth_status", McpAuthStatus),
- description: core.serialization.string(),
- name: core.serialization.string(),
- type: McpServerType,
- url: core.serialization.string(),
+ manifest: McpServerManifest,
+ name: ResourceName,
});
export declare namespace ConfiguredMcpServer {
export interface Raw {
- auth?: ConfiguredMcpServerAuth.Raw | null;
auth_status: McpAuthStatus.Raw;
- description: string;
- name: string;
- type: McpServerType.Raw;
- url: string;
+ manifest: McpServerManifest.Raw;
+ name: ResourceName.Raw;
}
}
diff --git a/packages/sdk/src/serialization/types/ConfiguredSkill.ts b/packages/sdk/src/serialization/types/ConfiguredSkill.ts
new file mode 100644
index 000000000..e3c687414
--- /dev/null
+++ b/packages/sdk/src/serialization/types/ConfiguredSkill.ts
@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { ResourceName } from "./ResourceName.js";
+import { SkillManifest } from "./SkillManifest.js";
+
+export const ConfiguredSkill: core.serialization.ObjectSchema<
+ serializers.ConfiguredSkill.Raw,
+ TrueForge.ConfiguredSkill
+> = core.serialization.object({
+ manifest: SkillManifest,
+ name: ResourceName,
+});
+
+export declare namespace ConfiguredSkill {
+ export interface Raw {
+ manifest: SkillManifest.Raw;
+ name: ResourceName.Raw;
+ }
+}
diff --git a/packages/sdk/src/serialization/types/CustomModelProvider.ts b/packages/sdk/src/serialization/types/CustomModelProvider.ts
index 4953c1c4a..dec97b6aa 100644
--- a/packages/sdk/src/serialization/types/CustomModelProvider.ts
+++ b/packages/sdk/src/serialization/types/CustomModelProvider.ts
@@ -5,6 +5,7 @@ import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
import { ModelEntry } from "./ModelEntry.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
+import { ResourceName } from "./ResourceName.js";
export const CustomModelProvider: core.serialization.ObjectSchema<
serializers.CustomModelProvider.Raw,
@@ -13,7 +14,7 @@ export const CustomModelProvider: core.serialization.ObjectSchema<
auth: ModelProviderAuth.optional(),
baseUrl: core.serialization.property("base_url", core.serialization.string()),
models: core.serialization.list(ModelEntry),
- name: core.serialization.string(),
+ name: ResourceName,
type: core.serialization.stringLiteral("custom"),
});
@@ -22,7 +23,7 @@ export declare namespace CustomModelProvider {
auth?: ModelProviderAuth.Raw | null;
base_url: string;
models: ModelEntry.Raw[];
- name: string;
+ name: ResourceName.Raw;
type: "custom";
}
}
diff --git a/packages/sdk/src/serialization/types/PutModelProviderResponse.ts b/packages/sdk/src/serialization/types/GetModelProviderResponse.ts
similarity index 66%
rename from packages/sdk/src/serialization/types/PutModelProviderResponse.ts
rename to packages/sdk/src/serialization/types/GetModelProviderResponse.ts
index b6f8bb120..379c9f7db 100644
--- a/packages/sdk/src/serialization/types/PutModelProviderResponse.ts
+++ b/packages/sdk/src/serialization/types/GetModelProviderResponse.ts
@@ -5,14 +5,14 @@ import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
import { ModelProvider } from "./ModelProvider.js";
-export const PutModelProviderResponse: core.serialization.ObjectSchema<
- serializers.PutModelProviderResponse.Raw,
- TrueForge.PutModelProviderResponse
+export const GetModelProviderResponse: core.serialization.ObjectSchema<
+ serializers.GetModelProviderResponse.Raw,
+ TrueForge.GetModelProviderResponse
> = core.serialization.object({
data: ModelProvider,
});
-export declare namespace PutModelProviderResponse {
+export declare namespace GetModelProviderResponse {
export interface Raw {
data: ModelProvider.Raw;
}
diff --git a/packages/sdk/src/serialization/types/GetSandboxProviderResponse.ts b/packages/sdk/src/serialization/types/GetSandboxProviderResponse.ts
index b2b2efd0f..79b7f1fee 100644
--- a/packages/sdk/src/serialization/types/GetSandboxProviderResponse.ts
+++ b/packages/sdk/src/serialization/types/GetSandboxProviderResponse.ts
@@ -3,17 +3,17 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { SandboxProviderResponse } from "./SandboxProviderResponse.js";
+import { SandboxProvider } from "./SandboxProvider.js";
export const GetSandboxProviderResponse: core.serialization.ObjectSchema<
serializers.GetSandboxProviderResponse.Raw,
TrueForge.GetSandboxProviderResponse
> = core.serialization.object({
- data: SandboxProviderResponse,
+ data: SandboxProvider,
});
export declare namespace GetSandboxProviderResponse {
export interface Raw {
- data: SandboxProviderResponse.Raw;
+ data: SandboxProvider.Raw;
}
}
diff --git a/packages/sdk/src/serialization/types/GetSkillResponse.ts b/packages/sdk/src/serialization/types/GetSkillResponse.ts
new file mode 100644
index 000000000..4095e700c
--- /dev/null
+++ b/packages/sdk/src/serialization/types/GetSkillResponse.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { ConfiguredSkill } from "./ConfiguredSkill.js";
+
+export const GetSkillResponse: core.serialization.ObjectSchema<
+ serializers.GetSkillResponse.Raw,
+ TrueForge.GetSkillResponse
+> = core.serialization.object({
+ data: ConfiguredSkill,
+});
+
+export declare namespace GetSkillResponse {
+ export interface Raw {
+ data: ConfiguredSkill.Raw;
+ }
+}
diff --git a/packages/sdk/src/serialization/types/ListConfiguredSkillsResponse.ts b/packages/sdk/src/serialization/types/ListConfiguredSkillsResponse.ts
deleted file mode 100644
index eea8622c1..000000000
--- a/packages/sdk/src/serialization/types/ListConfiguredSkillsResponse.ts
+++ /dev/null
@@ -1,19 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../api/index.js";
-import * as core from "../../core/index.js";
-import type * as serializers from "../index.js";
-import { SkillManifest } from "./SkillManifest.js";
-
-export const ListConfiguredSkillsResponse: core.serialization.ObjectSchema<
- serializers.ListConfiguredSkillsResponse.Raw,
- TrueForge.ListConfiguredSkillsResponse
-> = core.serialization.object({
- data: core.serialization.list(SkillManifest),
-});
-
-export declare namespace ListConfiguredSkillsResponse {
- export interface Raw {
- data: SkillManifest.Raw[];
- }
-}
diff --git a/packages/sdk/src/serialization/types/ListSkillsResponse.ts b/packages/sdk/src/serialization/types/ListSkillsResponse.ts
new file mode 100644
index 000000000..c58bc1938
--- /dev/null
+++ b/packages/sdk/src/serialization/types/ListSkillsResponse.ts
@@ -0,0 +1,19 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { ConfiguredSkill } from "./ConfiguredSkill.js";
+
+export const ListSkillsResponse: core.serialization.ObjectSchema<
+ serializers.ListSkillsResponse.Raw,
+ TrueForge.ListSkillsResponse
+> = core.serialization.object({
+ data: core.serialization.list(ConfiguredSkill),
+});
+
+export declare namespace ListSkillsResponse {
+ export interface Raw {
+ data: ConfiguredSkill.Raw[];
+ }
+}
diff --git a/packages/sdk/src/serialization/types/McpServerManifest.ts b/packages/sdk/src/serialization/types/McpServerManifest.ts
new file mode 100644
index 000000000..cf59434c2
--- /dev/null
+++ b/packages/sdk/src/serialization/types/McpServerManifest.ts
@@ -0,0 +1,29 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { McpServerManifestAuth } from "./McpServerManifestAuth.js";
+import { McpServerType } from "./McpServerType.js";
+import { ResourceName } from "./ResourceName.js";
+
+export const McpServerManifest: core.serialization.ObjectSchema<
+ serializers.McpServerManifest.Raw,
+ TrueForge.McpServerManifest
+> = core.serialization.object({
+ auth: McpServerManifestAuth.optional(),
+ description: core.serialization.string(),
+ name: ResourceName,
+ type: McpServerType,
+ url: core.serialization.string(),
+});
+
+export declare namespace McpServerManifest {
+ export interface Raw {
+ auth?: McpServerManifestAuth.Raw | null;
+ description: string;
+ name: ResourceName.Raw;
+ type: McpServerType.Raw;
+ url: string;
+ }
+}
diff --git a/packages/sdk/src/serialization/types/ConfiguredMcpServerAuth.ts b/packages/sdk/src/serialization/types/McpServerManifestAuth.ts
similarity index 71%
rename from packages/sdk/src/serialization/types/ConfiguredMcpServerAuth.ts
rename to packages/sdk/src/serialization/types/McpServerManifestAuth.ts
index 8a6a33939..5aeeb45fa 100644
--- a/packages/sdk/src/serialization/types/ConfiguredMcpServerAuth.ts
+++ b/packages/sdk/src/serialization/types/McpServerManifestAuth.ts
@@ -6,11 +6,11 @@ import type * as serializers from "../index.js";
import { McpServerDcrAuth } from "./McpServerDcrAuth.js";
import { McpServerHeaderAuth } from "./McpServerHeaderAuth.js";
-export const ConfiguredMcpServerAuth: core.serialization.Schema<
- serializers.ConfiguredMcpServerAuth.Raw,
- TrueForge.ConfiguredMcpServerAuth
+export const McpServerManifestAuth: core.serialization.Schema<
+ serializers.McpServerManifestAuth.Raw,
+ TrueForge.McpServerManifestAuth
> = core.serialization.undiscriminatedUnion([McpServerDcrAuth, McpServerHeaderAuth]);
-export declare namespace ConfiguredMcpServerAuth {
+export declare namespace McpServerManifestAuth {
export type Raw = McpServerDcrAuth.Raw | McpServerHeaderAuth.Raw;
}
diff --git a/packages/sdk/src/serialization/types/McpServerReadEntry.ts b/packages/sdk/src/serialization/types/McpServerReadEntry.ts
index c8de90e4b..a5e2d7c6f 100644
--- a/packages/sdk/src/serialization/types/McpServerReadEntry.ts
+++ b/packages/sdk/src/serialization/types/McpServerReadEntry.ts
@@ -5,6 +5,7 @@ import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
import { McpAuthStatus } from "./McpAuthStatus.js";
import { McpServerAuthPublic } from "./McpServerAuthPublic.js";
+import { ResourceName } from "./ResourceName.js";
export const McpServerReadEntry: core.serialization.ObjectSchema<
serializers.McpServerReadEntry.Raw,
@@ -12,7 +13,7 @@ export const McpServerReadEntry: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: McpServerAuthPublic.optional(),
authStatus: core.serialization.property("auth_status", McpAuthStatus),
- name: core.serialization.string(),
+ name: ResourceName,
url: core.serialization.string(),
});
@@ -20,7 +21,7 @@ export declare namespace McpServerReadEntry {
export interface Raw {
auth?: McpServerAuthPublic.Raw | null;
auth_status: McpAuthStatus.Raw;
- name: string;
+ name: ResourceName.Raw;
url: string;
}
}
diff --git a/packages/sdk/src/serialization/types/ModelProvider.ts b/packages/sdk/src/serialization/types/ModelProvider.ts
index 2bd5daf91..015653d7d 100644
--- a/packages/sdk/src/serialization/types/ModelProvider.ts
+++ b/packages/sdk/src/serialization/types/ModelProvider.ts
@@ -3,38 +3,18 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { AlibabaModelProvider } from "./AlibabaModelProvider.js";
-import { AnthropicModelProvider } from "./AnthropicModelProvider.js";
-import { CustomModelProvider } from "./CustomModelProvider.js";
-import { FireworksModelProvider } from "./FireworksModelProvider.js";
-import { GoogleGeminiModelProvider } from "./GoogleGeminiModelProvider.js";
-import { MoonshotModelProvider } from "./MoonshotModelProvider.js";
-import { OpenAiModelProvider } from "./OpenAiModelProvider.js";
-import { TogetherAiModelProvider } from "./TogetherAiModelProvider.js";
-import { ZaiModelProvider } from "./ZaiModelProvider.js";
+import { ModelProviderManifest } from "./ModelProviderManifest.js";
+import { ResourceName } from "./ResourceName.js";
-export const ModelProvider: core.serialization.Schema<serializers.ModelProvider.Raw, TrueForge.ModelProvider> =
- core.serialization.undiscriminatedUnion([
- AlibabaModelProvider,
- AnthropicModelProvider,
- CustomModelProvider,
- FireworksModelProvider,
- GoogleGeminiModelProvider,
- MoonshotModelProvider,
- OpenAiModelProvider,
- TogetherAiModelProvider,
- ZaiModelProvider,
- ]);
+export const ModelProvider: core.serialization.ObjectSchema<serializers.ModelProvider.Raw, TrueForge.ModelProvider> =
+ core.serialization.object({
+ manifest: ModelProviderManifest,
+ name: ResourceName,
+ });
export declare namespace ModelProvider {
- export type Raw =
- | AlibabaModelProvider.Raw
- | AnthropicModelProvider.Raw
- | CustomModelProvider.Raw
- | FireworksModelProvider.Raw
- | GoogleGeminiModelProvider.Raw
- | MoonshotModelProvider.Raw
- | OpenAiModelProvider.Raw
- | TogetherAiModelProvider.Raw
- | ZaiModelProvider.Raw;
+ export interface Raw {
+ manifest: ModelProviderManifest.Raw;
+ name: ResourceName.Raw;
+ }
}
diff --git a/packages/sdk/src/serialization/types/ModelProviderManifest.ts b/packages/sdk/src/serialization/types/ModelProviderManifest.ts
new file mode 100644
index 000000000..dfa5c0f3d
--- /dev/null
+++ b/packages/sdk/src/serialization/types/ModelProviderManifest.ts
@@ -0,0 +1,42 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../../api/index.js";
+import * as core from "../../core/index.js";
+import type * as serializers from "../index.js";
+import { AlibabaModelProvider } from "./AlibabaModelProvider.js";
+import { AnthropicModelProvider } from "./AnthropicModelProvider.js";
+import { CustomModelProvider } from "./CustomModelProvider.js";
+import { FireworksModelProvider } from "./FireworksModelProvider.js";
+import { GoogleGeminiModelProvider } from "./GoogleGeminiModelProvider.js";
+import { MoonshotModelProvider } from "./MoonshotModelProvider.js";
+import { OpenAiModelProvider } from "./OpenAiModelProvider.js";
+import { TogetherAiModelProvider } from "./TogetherAiModelProvider.js";
+import { ZaiModelProvider } from "./ZaiModelProvider.js";
+
+export const ModelProviderManifest: core.serialization.Schema<
+ serializers.ModelProviderManifest.Raw,
+ TrueForge.ModelProviderManifest
+> = core.serialization.undiscriminatedUnion([
+ AlibabaModelProvider,
+ AnthropicModelProvider,
+ CustomModelProvider,
+ FireworksModelProvider,
+ GoogleGeminiModelProvider,
+ MoonshotModelProvider,
+ OpenAiModelProvider,
+ TogetherAiModelProvider,
+ ZaiModelProvider,
+]);
+
+export declare namespace ModelProviderManifest {
+ export type Raw =
+ | AlibabaModelProvider.Raw
+ | AnthropicModelProvider.Raw
+ | CustomModelProvider.Raw
+ | FireworksModelProvider.Raw
+ | GoogleGeminiModelProvider.Raw
+ | MoonshotModelProvider.Raw
+ | OpenAiModelProvider.Raw
+ | TogetherAiModelProvider.Raw
+ | ZaiModelProvider.Raw;
+}
diff --git a/packages/sdk/src/serialization/types/PutMcpServerResponse.ts b/packages/sdk/src/serialization/types/PutMcpServerResponse.ts
deleted file mode 100644
index 910649e0e..000000000
--- a/packages/sdk/src/serialization/types/PutMcpServerResponse.ts
+++ /dev/null
@@ -1,19 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../api/index.js";
-import * as core from "../../core/index.js";
-import type * as serializers from "../index.js";
-import { ConfiguredMcpServer } from "./ConfiguredMcpServer.js";
-
-export const PutMcpServerResponse: core.serialization.ObjectSchema<
- serializers.PutMcpServerResponse.Raw,
- TrueForge.PutMcpServerResponse
-> = core.serialization.object({
- data: ConfiguredMcpServer,
-});
-
-export declare namespace PutMcpServerResponse {
- export interface Raw {
- data: ConfiguredMcpServer.Raw;
- }
-}
diff --git a/packages/sdk/src/serialization/types/PutSandboxProviderResponse.ts b/packages/sdk/src/serialization/types/PutSandboxProviderResponse.ts
deleted file mode 100644
index 593897135..000000000
--- a/packages/sdk/src/serialization/types/PutSandboxProviderResponse.ts
+++ /dev/null
@@ -1,19 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../api/index.js";
-import * as core from "../../core/index.js";
-import type * as serializers from "../index.js";
-import { SandboxProviderResponse } from "./SandboxProviderResponse.js";
-
-export const PutSandboxProviderResponse: core.serialization.ObjectSchema<
- serializers.PutSandboxProviderResponse.Raw,
- TrueForge.PutSandboxProviderResponse
-> = core.serialization.object({
- data: SandboxProviderResponse,
-});
-
-export declare namespace PutSandboxProviderResponse {
- export interface Raw {
- data: SandboxProviderResponse.Raw;
- }
-}
diff --git a/packages/sdk/src/serialization/types/PutSkillResponse.ts b/packages/sdk/src/serialization/types/PutSkillResponse.ts
deleted file mode 100644
index 661752bda..000000000
--- a/packages/sdk/src/serialization/types/PutSkillResponse.ts
+++ /dev/null
@@ -1,19 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../../api/index.js";
-import * as core from "../../core/index.js";
-import type * as serializers from "../index.js";
-import { SkillManifest } from "./SkillManifest.js";
-
-export const PutSkillResponse: core.serialization.ObjectSchema<
- serializers.PutSkillResponse.Raw,
- TrueForge.PutSkillResponse
-> = core.serialization.object({
- data: SkillManifest,
-});
-
-export declare namespace PutSkillResponse {
- export interface Raw {
- data: SkillManifest.Raw;
- }
-}
diff --git a/packages/sdk/src/serialization/types/SandboxProviderResponse.ts b/packages/sdk/src/serialization/types/SandboxProvider.ts
similarity index 77%
rename from packages/sdk/src/serialization/types/SandboxProviderResponse.ts
rename to packages/sdk/src/serialization/types/SandboxProvider.ts
index 0252f603e..0950f115a 100644
--- a/packages/sdk/src/serialization/types/SandboxProviderResponse.ts
+++ b/packages/sdk/src/serialization/types/SandboxProvider.ts
@@ -6,16 +6,16 @@ import type * as serializers from "../index.js";
import { SandboxBuildStatus } from "./SandboxBuildStatus.js";
import { SandboxProviderManifest } from "./SandboxProviderManifest.js";
-export const SandboxProviderResponse: core.serialization.ObjectSchema<
- serializers.SandboxProviderResponse.Raw,
- TrueForge.SandboxProviderResponse
+export const SandboxProvider: core.serialization.ObjectSchema<
+ serializers.SandboxProvider.Raw,
+ TrueForge.SandboxProvider
> = core.serialization.object({
manifest: SandboxProviderManifest,
status: SandboxBuildStatus,
statusReason: core.serialization.property("status_reason", core.serialization.string().nullable()),
});
-export declare namespace SandboxProviderResponse {
+export declare namespace SandboxProvider {
export interface Raw {
manifest: SandboxProviderManifest.Raw;
status: SandboxBuildStatus.Raw;
diff --git a/packages/sdk/src/serialization/types/SessionAgentNameRef.ts b/packages/sdk/src/serialization/types/SessionAgentNameRef.ts
index 7f4e5fe45..526ff60de 100644
--- a/packages/sdk/src/serialization/types/SessionAgentNameRef.ts
+++ b/packages/sdk/src/serialization/types/SessionAgentNameRef.ts
@@ -3,16 +3,17 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
+import { ResourceName } from "./ResourceName.js";
export const SessionAgentNameRef: core.serialization.ObjectSchema<
serializers.SessionAgentNameRef.Raw,
TrueForge.SessionAgentNameRef
> = core.serialization.object({
- name: core.serialization.string(),
+ name: ResourceName,
});
export declare namespace SessionAgentNameRef {
export interface Raw {
- name: string;
+ name: ResourceName.Raw;
}
}
diff --git a/packages/sdk/src/serialization/types/SkillManifest.ts b/packages/sdk/src/serialization/types/SkillManifest.ts
index 850188953..2b832a937 100644
--- a/packages/sdk/src/serialization/types/SkillManifest.ts
+++ b/packages/sdk/src/serialization/types/SkillManifest.ts
@@ -3,12 +3,13 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
+import { ResourceName } from "./ResourceName.js";
import { SkillType } from "./SkillType.js";
export const SkillManifest: core.serialization.ObjectSchema<serializers.SkillManifest.Raw, TrueForge.SkillManifest> =
core.serialization.object({
description: core.serialization.string(),
- name: core.serialization.string(),
+ name: ResourceName,
path: core.serialization.string().optional(),
ref: core.serialization.string(),
type: SkillType,
@@ -18,7 +19,7 @@ export const SkillManifest: core.serialization.ObjectSchema<serializers.SkillMan
export declare namespace SkillManifest {
export interface Raw {
description: string;
- name: string;
+ name: ResourceName.Raw;
path?: string | null;
ref: string;
type: SkillType.Raw;
diff --git a/packages/sdk/src/serialization/types/SkillReadEntry.ts b/packages/sdk/src/serialization/types/SkillReadEntry.ts
index e9b7c5abb..2e0789895 100644
--- a/packages/sdk/src/serialization/types/SkillReadEntry.ts
+++ b/packages/sdk/src/serialization/types/SkillReadEntry.ts
@@ -3,16 +3,17 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
+import { ResourceName } from "./ResourceName.js";
export const SkillReadEntry: core.serialization.ObjectSchema<serializers.SkillReadEntry.Raw, TrueForge.SkillReadEntry> =
core.serialization.object({
description: core.serialization.string(),
- name: core.serialization.string(),
+ name: ResourceName,
});
export declare namespace SkillReadEntry {
export interface Raw {
description: string;
- name: string;
+ name: ResourceName.Raw;
}
}
diff --git a/packages/sdk/src/serialization/types/index.ts b/packages/sdk/src/serialization/types/index.ts
index 02699611b..90b4501e3 100644
--- a/packages/sdk/src/serialization/types/index.ts
+++ b/packages/sdk/src/serialization/types/index.ts
@@ -28,7 +28,7 @@ export * from "./ChatCompletionContentPartText.js";
export * from "./ChatCompletionMessageToolCall.js";
export * from "./ChatCompletionMessageToolCallFunction.js";
export * from "./ConfiguredMcpServer.js";
-export * from "./ConfiguredMcpServerAuth.js";
+export * from "./ConfiguredSkill.js";
export * from "./ContextManagementConfig.js";
export * from "./ContextManagementConfigCompaction.js";
export * from "./CreateSessionAgent.js";
@@ -50,17 +50,18 @@ export * from "./GetCapabilitiesResponseDataSkill.js";
export * from "./GetMcpServerCatalogResponse.js";
export * from "./GetMcpServerResponse.js";
export * from "./GetModelProviderCatalogResponse.js";
+export * from "./GetModelProviderResponse.js";
export * from "./GetSandboxProviderCatalogResponse.js";
export * from "./GetSandboxProviderResponse.js";
export * from "./GetSessionResponse.js";
export * from "./GetSkillCatalogResponse.js";
+export * from "./GetSkillResponse.js";
export * from "./GetTurnResponse.js";
export * from "./GoogleGeminiModelProvider.js";
export * from "./LargeToolResponseConfig.js";
export * from "./ListAgentsResponse.js";
export * from "./ListAvailableMcpServersResponse.js";
export * from "./ListAvailableSkillsResponse.js";
-export * from "./ListConfiguredSkillsResponse.js";
export * from "./ListMcpServersResponse.js";
export * from "./ListMcpServerToolsResponse.js";
export * from "./ListModelProvidersResponse.js";
@@ -68,6 +69,7 @@ export * from "./ListModelsResponse.js";
export * from "./ListSessionEventsResponse.js";
export * from "./ListSessionsOrder.js";
export * from "./ListSessionsResponse.js";
+export * from "./ListSkillsResponse.js";
export * from "./ListTurnEventsOrder.js";
export * from "./ListTurnEventsResponse.js";
export * from "./ListTurnsResponse.js";
@@ -86,6 +88,8 @@ export * from "./McpServerEnableToolsItem.js";
export * from "./McpServerHeaderAuth.js";
export * from "./McpServerInitInfo.js";
export * from "./McpServerInitInfoTransportType.js";
+export * from "./McpServerManifest.js";
+export * from "./McpServerManifestAuth.js";
export * from "./McpServerPreloadToolsItem.js";
export * from "./McpServerReadEntry.js";
export * from "./McpServerRequireApprovalForToolsItem.js";
@@ -106,13 +110,10 @@ export * from "./ModelParams.js";
export * from "./ModelProperties.js";
export * from "./ModelProvider.js";
export * from "./ModelProviderAuth.js";
+export * from "./ModelProviderManifest.js";
export * from "./MoonshotModelProvider.js";
export * from "./OpenAiModelProvider.js";
export * from "./PreviousTurnIdInput.js";
-export * from "./PutMcpServerResponse.js";
-export * from "./PutModelProviderResponse.js";
-export * from "./PutSandboxProviderResponse.js";
-export * from "./PutSkillResponse.js";
export * from "./RawToolCall.js";
export * from "./ReasoningEffort.js";
export * from "./RequestErrorResponse.js";
@@ -131,8 +132,8 @@ export * from "./SandboxNetworkPolicy.js";
export * from "./SandboxNetworkPolicyAuthInjectItem.js";
export * from "./SandboxNetworkPolicyAuthInjectItemAuthData.js";
export * from "./SandboxNetworkPolicyAuthInjectItemMatch.js";
+export * from "./SandboxProvider.js";
export * from "./SandboxProviderManifest.js";
-export * from "./SandboxProviderResponse.js";
export * from "./Session.js";
export * from "./SessionAgent.js";
export * from "./SessionAgentInline.js";
diff --git a/packages/sdk/tests/wire/mcpServers.test.ts b/packages/sdk/tests/wire/mcpServers.test.ts
index 324552a33..972017d55 100644
--- a/packages/sdk/tests/wire/mcpServers.test.ts
+++ b/packages/sdk/tests/wire/mcpServers.test.ts
@@ -179,12 +179,15 @@ describe("McpServersClient", () => {
const rawResponseBody = {
data: {
- auth: { type: "dcr" },
auth_status: { authorization_url: "authorization_url", status: "authenticated" },
- description: "description",
+ manifest: {
+ auth: { type: "dcr" },
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
};
@@ -199,17 +202,20 @@ describe("McpServersClient", () => {
const response = await client.mcpServers.deleteAuthorize("name");
expect(response).toEqual({
data: {
- auth: {
- type: "dcr",
- },
authStatus: {
authorizationUrl: "authorization_url",
status: "authenticated",
},
- description: "description",
+ manifest: {
+ auth: {
+ type: "dcr",
+ },
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
});
});
diff --git a/packages/sdk/tests/wire/settings/mcpServers.test.ts b/packages/sdk/tests/wire/settings/mcpServers.test.ts
index f7eb05c42..a2ac66cc7 100644
--- a/packages/sdk/tests/wire/settings/mcpServers.test.ts
+++ b/packages/sdk/tests/wire/settings/mcpServers.test.ts
@@ -12,12 +12,9 @@ describe("McpServersClient", () => {
const rawResponseBody = {
data: [
{
- auth: { type: "dcr" },
auth_status: { status: "authenticated" },
- description: "description",
+ manifest: { description: "description", name: "name", type: "remote", url: "url" },
name: "name",
- type: "remote",
- url: "url",
},
],
};
@@ -34,16 +31,16 @@ describe("McpServersClient", () => {
expect(response).toEqual({
data: [
{
- auth: {
- type: "dcr",
- },
authStatus: {
status: "authenticated",
},
- description: "description",
+ manifest: {
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
],
});
@@ -90,15 +87,18 @@ describe("McpServersClient", () => {
test("create (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "description", name: "name", type: "remote", url: "url" };
+ const rawRequestBody = { manifest: { description: "description", name: "name", type: "remote", url: "url" } };
const rawResponseBody = {
data: {
- auth: { type: "dcr" },
auth_status: { authorization_url: "authorization_url", status: "authenticated" },
- description: "description",
+ manifest: {
+ auth: { type: "dcr" },
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
};
@@ -112,23 +112,29 @@ describe("McpServersClient", () => {
.build();
const response = await client.settings.mcpServers.create({
- description: "description",
- name: "name",
- url: "url",
+ manifest: {
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
});
expect(response).toEqual({
data: {
- auth: {
- type: "dcr",
- },
authStatus: {
authorizationUrl: "authorization_url",
status: "authenticated",
},
- description: "description",
+ manifest: {
+ auth: {
+ type: "dcr",
+ },
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
});
});
@@ -136,7 +142,7 @@ describe("McpServersClient", () => {
test("create (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "x", name: "xy", type: "remote", url: "url" };
+ const rawRequestBody = { manifest: { description: "x", name: "xy", type: "remote", url: "url" } };
const rawResponseBody = { error: { message: "message" } };
server
@@ -150,9 +156,12 @@ describe("McpServersClient", () => {
await expect(async () => {
return await client.settings.mcpServers.create({
- description: "x",
- name: "xy",
- url: "url",
+ manifest: {
+ description: "x",
+ name: "xy",
+ type: "remote",
+ url: "url",
+ },
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
@@ -160,7 +169,7 @@ describe("McpServersClient", () => {
test("create (3)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "x", name: "xy", type: "remote", url: "url" };
+ const rawRequestBody = { manifest: { description: "x", name: "xy", type: "remote", url: "url" } };
const rawResponseBody = { error: { message: "message" } };
server
@@ -174,9 +183,12 @@ describe("McpServersClient", () => {
await expect(async () => {
return await client.settings.mcpServers.create({
- description: "x",
- name: "xy",
- url: "url",
+ manifest: {
+ description: "x",
+ name: "xy",
+ type: "remote",
+ url: "url",
+ },
});
}).rejects.toThrow(TrueForgeTypes.ConflictError);
});
@@ -184,7 +196,7 @@ describe("McpServersClient", () => {
test("create (4)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "x", name: "xy", type: "remote", url: "url" };
+ const rawRequestBody = { manifest: { description: "x", name: "xy", type: "remote", url: "url" } };
const rawResponseBody = { error: { message: "message" } };
server
@@ -198,9 +210,12 @@ describe("McpServersClient", () => {
await expect(async () => {
return await client.settings.mcpServers.create({
- description: "x",
- name: "xy",
- url: "url",
+ manifest: {
+ description: "x",
+ name: "xy",
+ type: "remote",
+ url: "url",
+ },
});
}).rejects.toThrow(TrueForgeTypes.UnprocessableEntityError);
});
@@ -208,15 +223,18 @@ describe("McpServersClient", () => {
test("upsert (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "description", name: "name", type: "remote", url: "url" };
+ const rawRequestBody = { manifest: { description: "description", name: "name", type: "remote", url: "url" } };
const rawResponseBody = {
data: {
- auth: { type: "dcr" },
auth_status: { authorization_url: "authorization_url", status: "authenticated" },
- description: "description",
+ manifest: {
+ auth: { type: "dcr" },
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
};
@@ -230,23 +248,29 @@ describe("McpServersClient", () => {
.build();
const response = await client.settings.mcpServers.upsert({
- description: "description",
- name: "name",
- url: "url",
+ manifest: {
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
});
expect(response).toEqual({
data: {
- auth: {
- type: "dcr",
- },
authStatus: {
authorizationUrl: "authorization_url",
status: "authenticated",
},
- description: "description",
+ manifest: {
+ auth: {
+ type: "dcr",
+ },
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
});
});
@@ -254,7 +278,7 @@ describe("McpServersClient", () => {
test("upsert (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "x", name: "xy", type: "remote", url: "url" };
+ const rawRequestBody = { manifest: { description: "x", name: "xy", type: "remote", url: "url" } };
const rawResponseBody = { error: { message: "message" } };
server
@@ -268,9 +292,12 @@ describe("McpServersClient", () => {
await expect(async () => {
return await client.settings.mcpServers.upsert({
- description: "x",
- name: "xy",
- url: "url",
+ manifest: {
+ description: "x",
+ name: "xy",
+ type: "remote",
+ url: "url",
+ },
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
@@ -278,7 +305,7 @@ describe("McpServersClient", () => {
test("upsert (3)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "x", name: "xy", type: "remote", url: "url" };
+ const rawRequestBody = { manifest: { description: "x", name: "xy", type: "remote", url: "url" } };
const rawResponseBody = { error: { message: "message" } };
server
@@ -292,9 +319,12 @@ describe("McpServersClient", () => {
await expect(async () => {
return await client.settings.mcpServers.upsert({
- description: "x",
- name: "xy",
- url: "url",
+ manifest: {
+ description: "x",
+ name: "xy",
+ type: "remote",
+ url: "url",
+ },
});
}).rejects.toThrow(TrueForgeTypes.UnprocessableEntityError);
});
@@ -305,12 +335,15 @@ describe("McpServersClient", () => {
const rawResponseBody = {
data: {
- auth: { type: "dcr" },
auth_status: { authorization_url: "authorization_url", status: "authenticated" },
- description: "description",
+ manifest: {
+ auth: { type: "dcr" },
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
};
@@ -325,17 +358,20 @@ describe("McpServersClient", () => {
const response = await client.settings.mcpServers.get("name");
expect(response).toEqual({
data: {
- auth: {
- type: "dcr",
- },
authStatus: {
authorizationUrl: "authorization_url",
status: "authenticated",
},
- description: "description",
+ manifest: {
+ auth: {
+ type: "dcr",
+ },
+ description: "description",
+ name: "name",
+ type: "remote",
+ url: "url",
+ },
name: "name",
- type: "remote",
- url: "url",
},
});
});
diff --git a/packages/sdk/tests/wire/settings/modelProviders.test.ts b/packages/sdk/tests/wire/settings/modelProviders.test.ts
index 38274f604..3a9ff7310 100644
--- a/packages/sdk/tests/wire/settings/modelProviders.test.ts
+++ b/packages/sdk/tests/wire/settings/modelProviders.test.ts
@@ -12,10 +12,12 @@ describe("ModelProvidersClient", () => {
const rawResponseBody = {
data: [
{
- auth: { api_key: "api_key" },
- base_url: "base_url",
- models: [{ model_id: "model_id", name: "name", properties: {} }],
- type: "alibaba",
+ manifest: {
+ auth: { api_key: "api_key" },
+ models: [{ model_id: "model_id", name: "name", properties: {} }],
+ type: "alibaba",
+ },
+ name: "name",
},
],
};
@@ -32,18 +34,20 @@ describe("ModelProvidersClient", () => {
expect(response).toEqual({
data: [
{
- auth: {
- apiKey: "api_key",
- },
- baseUrl: "base_url",
- models: [
- {
- modelId: "model_id",
- name: "name",
- properties: {},
+ manifest: {
+ auth: {
+ apiKey: "api_key",
},
- ],
- type: "alibaba",
+ models: [
+ {
+ modelId: "model_id",
+ name: "name",
+ properties: {},
+ },
+ ],
+ type: "alibaba",
+ },
+ name: "name",
},
],
});
@@ -91,18 +95,23 @@ describe("ModelProvidersClient", () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = {
- auth: { api_key: "api_key" },
- models: [{ model_id: "model_id", name: "name", properties: {} }],
- type: "alibaba",
- };
- const rawResponseBody = {
- data: {
+ manifest: {
auth: { api_key: "api_key" },
- base_url: "base_url",
models: [{ model_id: "model_id", name: "name", properties: {} }],
type: "alibaba",
},
};
+ const rawResponseBody = {
+ data: {
+ manifest: {
+ auth: { api_key: "api_key" },
+ base_url: "base_url",
+ models: [{ model_id: "model_id", name: "name", properties: {} }],
+ type: "alibaba",
+ },
+ name: "name",
+ },
+ };
server
.mockEndpoint()
@@ -114,24 +123,10 @@ describe("ModelProvidersClient", () => {
.build();
const response = await client.settings.modelProviders.create({
- auth: {
- apiKey: "api_key",
- },
- models: [
- {
- modelId: "model_id",
- name: "name",
- properties: {},
- },
- ],
- type: "alibaba",
- });
- expect(response).toEqual({
- data: {
+ manifest: {
auth: {
apiKey: "api_key",
},
- baseUrl: "base_url",
models: [
{
modelId: "model_id",
@@ -142,18 +137,39 @@ describe("ModelProvidersClient", () => {
type: "alibaba",
},
});
+ expect(response).toEqual({
+ data: {
+ manifest: {
+ auth: {
+ apiKey: "api_key",
+ },
+ baseUrl: "base_url",
+ models: [
+ {
+ modelId: "model_id",
+ name: "name",
+ properties: {},
+ },
+ ],
+ type: "alibaba",
+ },
+ name: "name",
+ },
+ });
});
test("create (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = {
- auth: { api_key: "x" },
- models: [
- { model_id: "x", name: "xy", properties: {} },
- { model_id: "x", name: "xy", properties: {} },
- ],
- type: "alibaba",
+ manifest: {
+ auth: { api_key: "x" },
+ models: [
+ { model_id: "x", name: "xy", properties: {} },
+ { model_id: "x", name: "xy", properties: {} },
+ ],
+ type: "alibaba",
+ },
};
const rawResponseBody = { error: { message: "message" } };
@@ -168,22 +184,24 @@ describe("ModelProvidersClient", () => {
await expect(async () => {
return await client.settings.modelProviders.create({
- auth: {
- apiKey: "x",
- },
- models: [
- {
- modelId: "x",
- name: "xy",
- properties: {},
- },
- {
- modelId: "x",
- name: "xy",
- properties: {},
+ manifest: {
+ auth: {
+ apiKey: "x",
},
- ],
- type: "alibaba",
+ models: [
+ {
+ modelId: "x",
+ name: "xy",
+ properties: {},
+ },
+ {
+ modelId: "x",
+ name: "xy",
+ properties: {},
+ },
+ ],
+ type: "alibaba",
+ },
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
@@ -192,12 +210,14 @@ describe("ModelProvidersClient", () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = {
- auth: { api_key: "x" },
- models: [
- { model_id: "x", name: "xy", properties: {} },
- { model_id: "x", name: "xy", properties: {} },
- ],
- type: "alibaba",
+ manifest: {
+ auth: { api_key: "x" },
+ models: [
+ { model_id: "x", name: "xy", properties: {} },
+ { model_id: "x", name: "xy", properties: {} },
+ ],
+ type: "alibaba",
+ },
};
const rawResponseBody = { error: { message: "message" } };
@@ -212,22 +232,24 @@ describe("ModelProvidersClient", () => {
await expect(async () => {
return await client.settings.modelProviders.create({
- auth: {
- apiKey: "x",
- },
- models: [
- {
- modelId: "x",
- name: "xy",
- properties: {},
- },
- {
- modelId: "x",
- name: "xy",
- properties: {},
+ manifest: {
+ auth: {
+ apiKey: "x",
},
- ],
- type: "alibaba",
+ models: [
+ {
+ modelId: "x",
+ name: "xy",
+ properties: {},
+ },
+ {
+ modelId: "x",
+ name: "xy",
+ properties: {},
+ },
+ ],
+ type: "alibaba",
+ },
});
}).rejects.toThrow(TrueForgeTypes.ConflictError);
});
@@ -236,18 +258,23 @@ describe("ModelProvidersClient", () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = {
- auth: { api_key: "api_key" },
- models: [{ model_id: "model_id", name: "name", properties: {} }],
- type: "alibaba",
- };
- const rawResponseBody = {
- data: {
+ manifest: {
auth: { api_key: "api_key" },
- base_url: "base_url",
models: [{ model_id: "model_id", name: "name", properties: {} }],
type: "alibaba",
},
};
+ const rawResponseBody = {
+ data: {
+ manifest: {
+ auth: { api_key: "api_key" },
+ base_url: "base_url",
+ models: [{ model_id: "model_id", name: "name", properties: {} }],
+ type: "alibaba",
+ },
+ name: "name",
+ },
+ };
server
.mockEndpoint()
@@ -259,24 +286,10 @@ describe("ModelProvidersClient", () => {
.build();
const response = await client.settings.modelProviders.upsert({
- auth: {
- apiKey: "api_key",
- },
- models: [
- {
- modelId: "model_id",
- name: "name",
- properties: {},
- },
- ],
- type: "alibaba",
- });
- expect(response).toEqual({
- data: {
+ manifest: {
auth: {
apiKey: "api_key",
},
- baseUrl: "base_url",
models: [
{
modelId: "model_id",
@@ -287,18 +300,39 @@ describe("ModelProvidersClient", () => {
type: "alibaba",
},
});
+ expect(response).toEqual({
+ data: {
+ manifest: {
+ auth: {
+ apiKey: "api_key",
+ },
+ baseUrl: "base_url",
+ models: [
+ {
+ modelId: "model_id",
+ name: "name",
+ properties: {},
+ },
+ ],
+ type: "alibaba",
+ },
+ name: "name",
+ },
+ });
});
test("upsert (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = {
- auth: { api_key: "x" },
- models: [
- { model_id: "x", name: "xy", properties: {} },
- { model_id: "x", name: "xy", properties: {} },
- ],
- type: "alibaba",
+ manifest: {
+ auth: { api_key: "x" },
+ models: [
+ { model_id: "x", name: "xy", properties: {} },
+ { model_id: "x", name: "xy", properties: {} },
+ ],
+ type: "alibaba",
+ },
};
const rawResponseBody = { error: { message: "message" } };
@@ -313,22 +347,24 @@ describe("ModelProvidersClient", () => {
await expect(async () => {
return await client.settings.modelProviders.upsert({
- auth: {
- apiKey: "x",
- },
- models: [
- {
- modelId: "x",
- name: "xy",
- properties: {},
- },
- {
- modelId: "x",
- name: "xy",
- properties: {},
+ manifest: {
+ auth: {
+ apiKey: "x",
},
- ],
- type: "alibaba",
+ models: [
+ {
+ modelId: "x",
+ name: "xy",
+ properties: {},
+ },
+ {
+ modelId: "x",
+ name: "xy",
+ properties: {},
+ },
+ ],
+ type: "alibaba",
+ },
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
diff --git a/packages/sdk/tests/wire/settings/sandboxProviders.test.ts b/packages/sdk/tests/wire/settings/sandboxProviders.test.ts
index 68c002026..743bed68f 100644
--- a/packages/sdk/tests/wire/settings/sandboxProviders.test.ts
+++ b/packages/sdk/tests/wire/settings/sandboxProviders.test.ts
@@ -74,12 +74,14 @@ describe("SandboxProvidersClient", () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = {
- auth: { api_key: "api_key" },
- auto_archive_interval_in_minutes: 1,
- auto_delete_interval_in_minutes: 1,
- auto_stop_interval_in_minutes: 1,
- exec_timeout_ms: 1,
- type: "daytona",
+ manifest: {
+ auth: { api_key: "api_key" },
+ auto_archive_interval_in_minutes: 1,
+ auto_delete_interval_in_minutes: 1,
+ auto_stop_interval_in_minutes: 1,
+ exec_timeout_ms: 1,
+ type: "daytona",
+ },
};
const rawResponseBody = {
data: {
@@ -106,14 +108,16 @@ describe("SandboxProvidersClient", () => {
.build();
const response = await client.settings.sandboxProviders.upsert({
- auth: {
- apiKey: "api_key",
+ manifest: {
+ auth: {
+ apiKey: "api_key",
+ },
+ autoArchiveIntervalInMinutes: 1,
+ autoDeleteIntervalInMinutes: 1,
+ autoStopIntervalInMinutes: 1,
+ execTimeoutMs: 1,
+ type: "daytona",
},
- autoArchiveIntervalInMinutes: 1,
- autoDeleteIntervalInMinutes: 1,
- autoStopIntervalInMinutes: 1,
- execTimeoutMs: 1,
- type: "daytona",
});
expect(response).toEqual({
data: {
@@ -137,12 +141,14 @@ describe("SandboxProvidersClient", () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = {
- auth: { api_key: "x" },
- auto_archive_interval_in_minutes: 1,
- auto_delete_interval_in_minutes: 1,
- auto_stop_interval_in_minutes: 1,
- exec_timeout_ms: 1,
- type: "daytona",
+ manifest: {
+ auth: { api_key: "x" },
+ auto_archive_interval_in_minutes: 1,
+ auto_delete_interval_in_minutes: 1,
+ auto_stop_interval_in_minutes: 1,
+ exec_timeout_ms: 1,
+ type: "daytona",
+ },
};
const rawResponseBody = { error: { message: "message" } };
@@ -157,14 +163,16 @@ describe("SandboxProvidersClient", () => {
await expect(async () => {
return await client.settings.sandboxProviders.upsert({
- auth: {
- apiKey: "x",
+ manifest: {
+ auth: {
+ apiKey: "x",
+ },
+ autoArchiveIntervalInMinutes: 1,
+ autoDeleteIntervalInMinutes: 1,
+ autoStopIntervalInMinutes: 1,
+ execTimeoutMs: 1,
+ type: "daytona",
},
- autoArchiveIntervalInMinutes: 1,
- autoDeleteIntervalInMinutes: 1,
- autoStopIntervalInMinutes: 1,
- execTimeoutMs: 1,
- type: "daytona",
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
@@ -173,12 +181,14 @@ describe("SandboxProvidersClient", () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawRequestBody = {
- auth: { api_key: "x" },
- auto_archive_interval_in_minutes: 1,
- auto_delete_interval_in_minutes: 1,
- auto_stop_interval_in_minutes: 1,
- exec_timeout_ms: 1,
- type: "daytona",
+ manifest: {
+ auth: { api_key: "x" },
+ auto_archive_interval_in_minutes: 1,
+ auto_delete_interval_in_minutes: 1,
+ auto_stop_interval_in_minutes: 1,
+ exec_timeout_ms: 1,
+ type: "daytona",
+ },
};
const rawResponseBody = { error: { message: "message" } };
@@ -193,14 +203,16 @@ describe("SandboxProvidersClient", () => {
await expect(async () => {
return await client.settings.sandboxProviders.upsert({
- auth: {
- apiKey: "x",
+ manifest: {
+ auth: {
+ apiKey: "x",
+ },
+ autoArchiveIntervalInMinutes: 1,
+ autoDeleteIntervalInMinutes: 1,
+ autoStopIntervalInMinutes: 1,
+ execTimeoutMs: 1,
+ type: "daytona",
},
- autoArchiveIntervalInMinutes: 1,
- autoDeleteIntervalInMinutes: 1,
- autoStopIntervalInMinutes: 1,
- execTimeoutMs: 1,
- type: "daytona",
});
}).rejects.toThrow(TrueForgeTypes.UnprocessableEntityError);
});
diff --git a/packages/sdk/tests/wire/settings/skills.test.ts b/packages/sdk/tests/wire/settings/skills.test.ts
index 0a9e34382..8b963a3ed 100644
--- a/packages/sdk/tests/wire/settings/skills.test.ts
+++ b/packages/sdk/tests/wire/settings/skills.test.ts
@@ -10,7 +10,12 @@ describe("SkillsClient", () => {
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
const rawResponseBody = {
- data: [{ description: "description", name: "name", path: "path", ref: "ref", type: "git", url: "url" }],
+ data: [
+ {
+ manifest: { description: "description", name: "name", ref: "ref", type: "git", url: "url" },
+ name: "name",
+ },
+ ],
};
server
@@ -25,12 +30,14 @@ describe("SkillsClient", () => {
expect(response).toEqual({
data: [
{
- description: "description",
+ manifest: {
+ description: "description",
+ name: "name",
+ ref: "ref",
+ type: "git",
+ url: "url",
+ },
name: "name",
- path: "path",
- ref: "ref",
- type: "git",
- url: "url",
},
],
});
@@ -77,9 +84,21 @@ describe("SkillsClient", () => {
test("create (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "description", name: "name", ref: "ref", type: "git", url: "url" };
+ const rawRequestBody = {
+ manifest: { description: "description", name: "name", ref: "ref", type: "git", url: "url" },
+ };
const rawResponseBody = {
- data: { description: "description", name: "name", path: "path", ref: "ref", type: "git", url: "url" },
+ data: {
+ manifest: {
+ description: "description",
+ name: "name",
+ path: "path",
+ ref: "ref",
+ type: "git",
+ url: "url",
+ },
+ name: "name",
+ },
};
server
@@ -92,28 +111,33 @@ describe("SkillsClient", () => {
.build();
const response = await client.settings.skills.create({
- description: "description",
- name: "name",
- ref: "ref",
- type: "git",
- url: "url",
- });
- expect(response).toEqual({
- data: {
+ manifest: {
description: "description",
name: "name",
- path: "path",
ref: "ref",
type: "git",
url: "url",
},
});
+ expect(response).toEqual({
+ data: {
+ manifest: {
+ description: "description",
+ name: "name",
+ path: "path",
+ ref: "ref",
+ type: "git",
+ url: "url",
+ },
+ name: "name",
+ },
+ });
});
test("create (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "x", name: "xy", ref: "x", type: "git", url: "x" };
+ const rawRequestBody = { manifest: { description: "x", name: "xy", ref: "x", type: "git", url: "x" } };
const rawResponseBody = { error: { message: "message" } };
server
@@ -127,11 +151,13 @@ describe("SkillsClient", () => {
await expect(async () => {
return await client.settings.skills.create({
- description: "x",
- name: "xy",
- ref: "x",
- type: "git",
- url: "x",
+ manifest: {
+ description: "x",
+ name: "xy",
+ ref: "x",
+ type: "git",
+ url: "x",
+ },
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
@@ -139,7 +165,7 @@ describe("SkillsClient", () => {
test("create (3)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "x", name: "xy", ref: "x", type: "git", url: "x" };
+ const rawRequestBody = { manifest: { description: "x", name: "xy", ref: "x", type: "git", url: "x" } };
const rawResponseBody = { error: { message: "message" } };
server
@@ -153,11 +179,13 @@ describe("SkillsClient", () => {
await expect(async () => {
return await client.settings.skills.create({
- description: "x",
- name: "xy",
- ref: "x",
- type: "git",
- url: "x",
+ manifest: {
+ description: "x",
+ name: "xy",
+ ref: "x",
+ type: "git",
+ url: "x",
+ },
});
}).rejects.toThrow(TrueForgeTypes.ConflictError);
});
@@ -165,9 +193,21 @@ describe("SkillsClient", () => {
test("upsert (1)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "description", name: "name", ref: "ref", type: "git", url: "url" };
+ const rawRequestBody = {
+ manifest: { description: "description", name: "name", ref: "ref", type: "git", url: "url" },
+ };
const rawResponseBody = {
- data: { description: "description", name: "name", path: "path", ref: "ref", type: "git", url: "url" },
+ data: {
+ manifest: {
+ description: "description",
+ name: "name",
+ path: "path",
+ ref: "ref",
+ type: "git",
+ url: "url",
+ },
+ name: "name",
+ },
};
server
@@ -180,28 +220,33 @@ describe("SkillsClient", () => {
.build();
const response = await client.settings.skills.upsert({
- description: "description",
- name: "name",
- ref: "ref",
- type: "git",
- url: "url",
- });
- expect(response).toEqual({
- data: {
+ manifest: {
description: "description",
name: "name",
- path: "path",
ref: "ref",
type: "git",
url: "url",
},
});
+ expect(response).toEqual({
+ data: {
+ manifest: {
+ description: "description",
+ name: "name",
+ path: "path",
+ ref: "ref",
+ type: "git",
+ url: "url",
+ },
+ name: "name",
+ },
+ });
});
test("upsert (2)", async () => {
const server = mockServerPool.createServer();
const client = new TrueForge({ maxRetries: 0, token: "test", baseUrl: server.baseUrl });
- const rawRequestBody = { description: "x", name: "xy", ref: "x", type: "git", url: "x" };
+ const rawRequestBody = { manifest: { description: "x", name: "xy", ref: "x", type: "git", url: "x" } };
const rawResponseBody = { error: { message: "message" } };
server
@@ -215,11 +260,13 @@ describe("SkillsClient", () => {
await expect(async () => {
return await client.settings.skills.upsert({
- description: "x",
- name: "xy",
- ref: "x",
- type: "git",
- url: "x",
+ manifest: {
+ description: "x",
+ name: "xy",
+ ref: "x",
+ type: "git",
+ url: "x",
+ },
});
}).rejects.toThrow(TrueForgeTypes.BadRequestError);
});
diff --git a/packages/server/src/apis/mcpServers.ts b/packages/server/src/apis/mcpServers.ts
index 5d9aac53e..9c56bbcab 100644
--- a/packages/server/src/apis/mcpServers.ts
+++ b/packages/server/src/apis/mcpServers.ts
@@ -19,7 +19,14 @@ import {
putMcpServerRoute,
} from '../routes/mcpServerRoutes';
import { getMcpConnection } from '../runtime/sessionResources';
-import type { ConfiguredMcpServer, McpAuthStatus, McpServerManifest, McpServerReadEntry } from '../schemas/mcpServer';
+import type {
+ ConfiguredMcpServer,
+ CreateMcpServerRequest,
+ McpAuthStatus,
+ McpServerManifest,
+ McpServerReadEntry,
+ PutMcpServerRequest,
+} from '../schemas/mcpServer';
import { resolveMcpAuthStatus } from '../schemas/mcpServer';
import { MissingStoredSecretError, resolveStoredSecretValue, toRedactedSecretValue } from '../utils/secretRedaction';
import { TENANT_ID } from './sessions';
@@ -100,7 +107,8 @@ function toConfiguredMcpServer({
token: OAuthToken | undefined;
}): ConfiguredMcpServer {
return {
- ...redactMcpServerManifest(record.manifest),
+ name: record.name,
+ manifest: redactMcpServerManifest(record.manifest),
auth_status: resolveMcpAuthStatus({
manifest: record.manifest,
...(token !== undefined ? { token } : {}),
@@ -156,7 +164,8 @@ export function createSettingsMcpServersRouter<TTransaction>(deps: McpServersRou
};
const createHandler: RouteHandler<typeof createMcpServerRoute> = async c => {
- const incomingManifest: McpServerManifest = c.req.valid('json');
+ const body: CreateMcpServerRequest = c.req.valid('json');
+ const incomingManifest = body.manifest;
// DCR finishes before the txn (remote I/O stays out of withTransaction on create).
let dcrClientToSave: OAuthClientRecord | undefined;
@@ -207,7 +216,7 @@ export function createSettingsMcpServersRouter<TTransaction>(deps: McpServersRou
return saved;
});
- return c.json({ data: toConfiguredMcpServer({ record, token: undefined }) }, 200);
+ return c.json({ data: toConfiguredMcpServer({ record, token: undefined }) }, 201);
} catch (error) {
if (error instanceof McpServerNameConflictError) {
return c.json({ error: { message: error.message } }, 409);
@@ -218,7 +227,8 @@ export function createSettingsMcpServersRouter<TTransaction>(deps: McpServersRou
const putHandler: RouteHandler<typeof putMcpServerRoute> = async c => {
const userRef = deps.resolveUserContext(c).userRef;
- const incomingManifest: McpServerManifest = c.req.valid('json');
+ const body: PutMcpServerRequest = c.req.valid('json');
+ const incomingManifest = body.manifest;
try {
// Lock → resolve secrets → DCR (if needed) → upsert + saveClient in one txn.
diff --git a/packages/server/src/apis/modelProviders.ts b/packages/server/src/apis/modelProviders.ts
index 5d64d86fc..1abf952a2 100644
--- a/packages/server/src/apis/modelProviders.ts
+++ b/packages/server/src/apis/modelProviders.ts
@@ -1,12 +1,22 @@
import { OpenAPIHono, type RouteHandler } from '@hono/zod-openapi';
-import { ModelProviderNameConflictError, type IModelProviderStore } from '../db/modelProviderStore';
+import {
+ ModelProviderNameConflictError,
+ type IModelProviderStore,
+ type ModelProviderRecord,
+} from '../db/modelProviderStore';
import type { WithTransaction } from '../db/transaction';
import {
createModelProviderRoute,
listModelProvidersRoute,
putModelProviderRoute,
} from '../routes/modelProviderRoutes';
-import { modelProviderName, type ModelProvider } from '../schemas/modelProvider';
+import {
+ modelProviderName,
+ type CreateModelProviderRequest,
+ type ModelProvider,
+ type ModelProviderManifest,
+ type PutModelProviderRequest,
+} from '../schemas/modelProvider';
import { MissingStoredSecretError, resolveStoredSecretValue, toRedactedSecretValue } from '../utils/secretRedaction';
import { TENANT_ID } from './sessions';
@@ -15,7 +25,7 @@ export interface ModelProvidersRouterDeps<TTransaction> {
withTransaction: WithTransaction<TTransaction>;
}
-function redactModelProvider(manifest: ModelProvider): ModelProvider {
+function redactModelProvider(manifest: ModelProviderManifest): ModelProviderManifest {
if (manifest.auth === undefined) {
return manifest;
}
@@ -29,9 +39,9 @@ function resolveModelProviderManifestForWrite({
incoming,
existing,
}: {
- incoming: ModelProvider;
- existing: ModelProvider | undefined;
-}): ModelProvider {
+ incoming: ModelProviderManifest;
+ existing: ModelProviderManifest | undefined;
+}): ModelProviderManifest {
if (incoming.auth === undefined) {
return incoming;
}
@@ -46,20 +56,28 @@ function resolveModelProviderManifestForWrite({
};
}
+function toWireProvider(record: ModelProviderRecord): ModelProvider {
+ return {
+ name: record.name,
+ manifest: redactModelProvider(record.manifest),
+ };
+}
+
export function createModelProvidersRouter<TTransaction>(deps: ModelProvidersRouterDeps<TTransaction>) {
const listHandler: RouteHandler<typeof listModelProvidersRoute> = async c => {
const records = await deps.modelProviderStore.listProviders(TENANT_ID);
- return c.json({ data: records.map(record => redactModelProvider(record.manifest)) }, 200);
+ return c.json({ data: records.map(toWireProvider) }, 200);
};
const createHandler: RouteHandler<typeof createModelProviderRoute> = async c => {
- const provider = c.req.valid('json');
+ const body: CreateModelProviderRequest = c.req.valid('json');
+ const provider = body.manifest;
const name = modelProviderName(provider);
try {
// Create has no prior row; redacted keep resolves to MissingStoredSecretError → 400.
const manifest = resolveModelProviderManifestForWrite({ incoming: provider, existing: undefined });
const record = await deps.modelProviderStore.createProvider({ tenant_id: TENANT_ID, name, manifest });
- return c.json({ data: redactModelProvider(record.manifest) }, 200);
+ return c.json({ data: toWireProvider(record) }, 201);
} catch (error) {
if (error instanceof MissingStoredSecretError) {
return c.json({ error: { message: 'API key is required' } }, 400);
@@ -72,7 +90,8 @@ export function createModelProvidersRouter<TTransaction>(deps: ModelProvidersRou
};
const putHandler: RouteHandler<typeof putModelProviderRoute> = async c => {
- const provider = c.req.valid('json');
+ const body: PutModelProviderRequest = c.req.valid('json');
+ const provider = body.manifest;
const name = modelProviderName(provider);
try {
// Lock → resolve secret from that snapshot → upsert, all in one txn so concurrent keep
@@ -88,7 +107,7 @@ export function createModelProvidersRouter<TTransaction>(deps: ModelProvidersRou
});
return deps.modelProviderStore.upsertProvider({ tenant_id: TENANT_ID, name, manifest }, transaction);
});
- return c.json({ data: redactModelProvider(record.manifest) }, 200);
+ return c.json({ data: toWireProvider(record) }, 200);
} catch (error) {
if (error instanceof MissingStoredSecretError) {
return c.json({ error: { message: 'API key is required' } }, 400);
diff --git a/packages/server/src/apis/sandboxProviders.ts b/packages/server/src/apis/sandboxProviders.ts
index c833c7856..8f4e982a0 100644
--- a/packages/server/src/apis/sandboxProviders.ts
+++ b/packages/server/src/apis/sandboxProviders.ts
@@ -10,7 +10,7 @@ import {
toDaytonaSandboxProvider,
toSandboxStatus,
} from '../sandbox/providerUtils';
-import type { SandboxProviderManifest } from '../schemas/sandboxProvider';
+import type { PutSandboxProviderRequest, SandboxProviderManifest } from '../schemas/sandboxProvider';
import { MissingStoredSecretError, resolveStoredSecretValue, toRedactedSecretValue } from '../utils/secretRedaction';
import { TENANT_ID } from './sessions';
@@ -56,7 +56,8 @@ export function createSandboxProvidersRouter<TTransaction>(deps: SandboxProvider
};
const putHandler: RouteHandler<typeof putSandboxProviderRoute> = async c => {
- const incoming: SandboxProviderManifest = c.req.valid('json');
+ const body: PutSandboxProviderRequest = c.req.valid('json');
+ const incoming = body.manifest;
const resolveManifest = (existing: SandboxProviderRecord | undefined): SandboxProviderManifest => ({
...incoming,
auth: {
diff --git a/packages/server/src/apis/skills.ts b/packages/server/src/apis/skills.ts
index db5216648..4c2064a77 100644
--- a/packages/server/src/apis/skills.ts
+++ b/packages/server/src/apis/skills.ts
@@ -7,7 +7,7 @@ import {
listConfiguredSkillsRoute,
putSkillRoute,
} from '../routes/skillRoutes';
-import type { ConfiguredSkill, SkillManifest } from '../schemas/skill';
+import type { ConfiguredSkill, CreateSkillRequest, PutSkillRequest } from '../schemas/skill';
import { TENANT_ID } from './sessions';
export interface SkillsRouterDeps<TTransaction> {
@@ -15,11 +15,11 @@ export interface SkillsRouterDeps<TTransaction> {
withTransaction: WithTransaction<TTransaction>;
}
-/** Wire view of a stored skill: identity `name` plus persisted manifest. */
+/** Wire view of a stored skill: identity `name` plus nested manifest. */
function toConfiguredSkill(record: SkillRecord): ConfiguredSkill {
return {
- ...record.manifest,
name: record.name,
+ manifest: record.manifest,
};
}
@@ -31,14 +31,15 @@ export function createSkillsRouter<TTransaction>(deps: SkillsRouterDeps<TTransac
};
const createHandler: RouteHandler<typeof createSkillRoute> = async c => {
- const manifest: SkillManifest = c.req.valid('json');
+ const body: CreateSkillRequest = c.req.valid('json');
+ const manifest = body.manifest;
try {
const record = await deps.skillStore.createSkill({
tenant_id: TENANT_ID,
name: manifest.name,
manifest,
});
- return c.json({ data: toConfiguredSkill(record) }, 200);
+ return c.json({ data: toConfiguredSkill(record) }, 201);
} catch (error) {
if (error instanceof SkillNameConflictError) {
return c.json({ error: { message: error.message } }, 409);
@@ -48,7 +49,8 @@ export function createSkillsRouter<TTransaction>(deps: SkillsRouterDeps<TTransac
};
const putHandler: RouteHandler<typeof putSkillRoute> = async c => {
- const manifest: SkillManifest = c.req.valid('json');
+ const body: PutSkillRequest = c.req.valid('json');
+ const manifest = body.manifest;
const record = await deps.skillStore.upsertSkill({
tenant_id: TENANT_ID,
name: manifest.name,
diff --git a/packages/server/src/db/modelProviderStore.ts b/packages/server/src/db/modelProviderStore.ts
index 2f38037ab..e0f5408ac 100644
--- a/packages/server/src/db/modelProviderStore.ts
+++ b/packages/server/src/db/modelProviderStore.ts
@@ -1,15 +1,15 @@
/**
* DB-backed configured model providers: one row per provider per tenant,
- * identity as columns plus the Zod-validated `ModelProvider` document as jsonb.
+ * identity as columns plus the Zod-validated `ModelProviderManifest` document as jsonb.
* Implementations: PostgresModelProviderStore and SqliteModelProviderStore.
*/
import type { ResourceName } from '../schemas/common';
-import type { Model, ModelProvider } from '../schemas/modelProvider';
+import type { Model, ModelProviderManifest } from '../schemas/modelProvider';
export interface ModelProviderRecord {
tenant_id: string;
name: ResourceName;
- manifest: ModelProvider;
+ manifest: ModelProviderManifest;
/** ISO-8601 UTC instant. */
created_at: string;
/** ISO-8601 UTC instant. */
@@ -25,7 +25,7 @@ export interface CreateModelProviderInput {
tenant_id: string;
/** Derived from the document by `modelProviderName`, never chosen by the caller. */
name: ResourceName;
- manifest: ModelProvider;
+ manifest: ModelProviderManifest;
}
/** Same shape as create for now; kept as a distinct name for the upsert path. */
diff --git a/packages/server/src/db/postgres/types.ts b/packages/server/src/db/postgres/types.ts
index 02e1711cc..de09dc3c1 100644
--- a/packages/server/src/db/postgres/types.ts
+++ b/packages/server/src/db/postgres/types.ts
@@ -20,7 +20,7 @@ import type {
import type { CurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
import type { ColumnType, Generated, JSONColumnType } from 'kysely';
import type { McpServerManifest } from '../../schemas/mcpServer';
-import type { ModelProvider } from '../../schemas/modelProvider';
+import type { ModelProviderManifest } from '../../schemas/modelProvider';
import type { SandboxBuildMetadata, SandboxBuildStatus, SandboxProviderManifest } from '../../schemas/sandboxProvider';
import type { SkillManifest } from '../../schemas/skill';
import type { OAuthClient, OAuthPendingAuthorizationData, OAuthServer, OAuthToken } from '../mcpServerStore';
@@ -313,7 +313,7 @@ export interface ModelProviderTable {
/** key: natural key within tenant; first segment of fully qualified model names */
name: string;
/** ModelProvider document; replaced whole on every upsert */
- manifest: JSONColumnType<ModelProvider, ModelProvider, ModelProvider>;
+ manifest: JSONColumnType<ModelProviderManifest, ModelProviderManifest, ModelProviderManifest>;
created_at: Date;
updated_at: Date;
}
diff --git a/packages/server/src/db/sqlite/model-provider-store/SqliteModelProviderStore.ts b/packages/server/src/db/sqlite/model-provider-store/SqliteModelProviderStore.ts
index 8576f01fb..8f4479784 100644
--- a/packages/server/src/db/sqlite/model-provider-store/SqliteModelProviderStore.ts
+++ b/packages/server/src/db/sqlite/model-provider-store/SqliteModelProviderStore.ts
@@ -1,5 +1,5 @@
import type { ExpressionBuilder, Kysely, Transaction } from 'kysely';
-import type { Model, ModelProvider } from '../../../schemas/modelProvider';
+import type { Model, ModelProviderManifest } from '../../../schemas/modelProvider';
import {
flattenProviderModels,
ModelProviderNameConflictError,
@@ -18,7 +18,7 @@ function recordColumns(eb: ExpressionBuilder<Database, 'model_provider'>) {
return [
'tenant_id' as const,
'name' as const,
- jsonText<ModelProvider>(eb.ref('manifest')).as('manifest'),
+ jsonText<ModelProviderManifest>(eb.ref('manifest')).as('manifest'),
'created_at' as const,
'updated_at' as const,
];
diff --git a/packages/server/src/db/sqlite/types.ts b/packages/server/src/db/sqlite/types.ts
index deb248d54..3b795dc40 100644
--- a/packages/server/src/db/sqlite/types.ts
+++ b/packages/server/src/db/sqlite/types.ts
@@ -23,7 +23,7 @@ import type {
import type { CurrentContextUsage } from '@truefoundry/trueforge-core/core/runtime/contextUsage';
import type { ColumnType, Generated, JSONColumnType } from 'kysely';
import type { McpServerManifest } from '../../schemas/mcpServer';
-import type { ModelProvider } from '../../schemas/modelProvider';
+import type { ModelProviderManifest } from '../../schemas/modelProvider';
import type { SandboxBuildMetadata, SandboxBuildStatus, SandboxProviderManifest } from '../../schemas/sandboxProvider';
import type { SkillManifest } from '../../schemas/skill';
import type { OAuthClient, OAuthPendingAuthorizationData, OAuthServer, OAuthToken } from '../mcpServerStore';
@@ -164,8 +164,8 @@ export interface ThreadCapabilityStateTable {
export interface ModelProviderTable {
tenant_id: string;
name: string;
- /** ModelProvider document; replaced whole on every upsert */
- manifest: JsonbColumn<ModelProvider>;
+ /** ModelProviderManifest document; replaced whole on every upsert */
+ manifest: JsonbColumn<ModelProviderManifest>;
created_at: string;
updated_at: string;
}
diff --git a/packages/server/src/routes/mcpServerRoutes.ts b/packages/server/src/routes/mcpServerRoutes.ts
index 090189d23..3f2d3f9f6 100644
--- a/packages/server/src/routes/mcpServerRoutes.ts
+++ b/packages/server/src/routes/mcpServerRoutes.ts
@@ -12,7 +12,6 @@ import {
ListMcpServersResponseSchema,
McpAuthStatusSchema,
PutMcpServerRequestSchema,
- PutMcpServerResponseSchema,
} from '../schemas/mcpServer';
const MCP_SERVERS_TAG = 'MCP Servers';
@@ -108,8 +107,8 @@ export const createMcpServerRoute = createRoute({
},
},
responses: {
- 200: {
- content: { 'application/json': { schema: PutMcpServerResponseSchema } },
+ 201: {
+ content: { 'application/json': { schema: GetMcpServerResponseSchema } },
description: 'The created MCP server with auth_status',
},
400: {
@@ -145,7 +144,7 @@ export const putMcpServerRoute = createRoute({
},
responses: {
200: {
- content: { 'application/json': { schema: PutMcpServerResponseSchema } },
+ content: { 'application/json': { schema: GetMcpServerResponseSchema } },
description: 'The saved MCP server with auth_status',
},
400: {
@@ -270,7 +269,7 @@ export const deleteAuthorizeMcpServerRoute = createRoute({
},
responses: {
200: {
- content: { 'application/json': { schema: PutMcpServerResponseSchema } },
+ content: { 'application/json': { schema: GetMcpServerResponseSchema } },
description: 'The MCP server after disconnect (auth_required for dcr).',
},
404: {
diff --git a/packages/server/src/routes/modelProviderRoutes.ts b/packages/server/src/routes/modelProviderRoutes.ts
index eca10bb96..bb44e0eda 100644
--- a/packages/server/src/routes/modelProviderRoutes.ts
+++ b/packages/server/src/routes/modelProviderRoutes.ts
@@ -6,9 +6,10 @@
import { createRoute } from '@hono/zod-openapi';
import { RequestErrorResponseSchema } from '../schemas/errors';
import {
+ CreateModelProviderRequestSchema,
+ GetModelProviderResponseSchema,
ListModelProvidersResponseSchema,
- ModelProviderSchema,
- PutModelProviderResponseSchema,
+ PutModelProviderRequestSchema,
} from '../schemas/modelProvider';
const MODEL_PROVIDERS_TAG = 'Model Providers';
@@ -18,7 +19,7 @@ export const listModelProvidersRoute = createRoute({
path: '/',
tags: [MODEL_PROVIDERS_TAG],
summary: 'List configured model providers',
- description: 'All configured providers with their models.',
+ description: 'All configured providers with nested manifests.',
'x-fern-sdk-group-name': ['settings', 'modelProviders'],
'x-fern-sdk-method-name': 'list',
responses: {
@@ -49,13 +50,13 @@ export const createModelProviderRoute = createRoute({
'x-fern-sdk-method-name': 'create',
request: {
body: {
- content: { 'application/json': { schema: ModelProviderSchema } },
+ content: { 'application/json': { schema: CreateModelProviderRequestSchema } },
required: true,
},
},
responses: {
- 200: {
- content: { 'application/json': { schema: PutModelProviderResponseSchema } },
+ 201: {
+ content: { 'application/json': { schema: GetModelProviderResponseSchema } },
description: 'The created provider',
},
400: {
@@ -81,13 +82,13 @@ export const putModelProviderRoute = createRoute({
'x-fern-sdk-method-name': 'upsert',
request: {
body: {
- content: { 'application/json': { schema: ModelProviderSchema } },
+ content: { 'application/json': { schema: PutModelProviderRequestSchema } },
required: true,
},
},
responses: {
200: {
- content: { 'application/json': { schema: PutModelProviderResponseSchema } },
+ content: { 'application/json': { schema: GetModelProviderResponseSchema } },
description: 'The saved provider',
},
400: {
diff --git a/packages/server/src/routes/sandboxProviderRoutes.ts b/packages/server/src/routes/sandboxProviderRoutes.ts
index 724bc79cd..da704573a 100644
--- a/packages/server/src/routes/sandboxProviderRoutes.ts
+++ b/packages/server/src/routes/sandboxProviderRoutes.ts
@@ -5,11 +5,7 @@
*/
import { createRoute } from '@hono/zod-openapi';
import { RequestErrorResponseSchema } from '../schemas/errors';
-import {
- GetSandboxProviderResponseSchema,
- PutSandboxProviderRequestSchema,
- PutSandboxProviderResponseSchema,
-} from '../schemas/sandboxProvider';
+import { GetSandboxProviderResponseSchema, PutSandboxProviderRequestSchema } from '../schemas/sandboxProvider';
const SANDBOX_PROVIDERS_TAG = 'Sandbox Providers';
@@ -51,7 +47,7 @@ export const putSandboxProviderRoute = createRoute({
},
responses: {
200: {
- content: { 'application/json': { schema: PutSandboxProviderResponseSchema } },
+ content: { 'application/json': { schema: GetSandboxProviderResponseSchema } },
description: 'The saved sandbox provider.',
},
400: {
diff --git a/packages/server/src/routes/skillRoutes.ts b/packages/server/src/routes/skillRoutes.ts
index 2f68417e6..dd90775dc 100644
--- a/packages/server/src/routes/skillRoutes.ts
+++ b/packages/server/src/routes/skillRoutes.ts
@@ -7,10 +7,11 @@
import { createRoute } from '@hono/zod-openapi';
import { RequestErrorResponseSchema } from '../schemas/errors';
import {
+ CreateSkillRequestSchema,
+ GetSkillResponseSchema,
ListAvailableSkillsResponseSchema,
- ListConfiguredSkillsResponseSchema,
- PutSkillResponseSchema,
- SkillManifestSchema,
+ ListSkillsResponseSchema,
+ PutSkillRequestSchema,
} from '../schemas/skill';
const SKILLS_TAG = 'Skills';
@@ -41,12 +42,12 @@ export const listConfiguredSkillsRoute = createRoute({
path: '/',
tags: [SKILLS_TAG],
summary: 'List configured skills',
- description: 'All configured skills with full manifests (settings / admin projection).',
+ description: 'All configured skills with nested manifests (settings / admin projection).',
'x-fern-sdk-group-name': ['settings', 'skills'],
'x-fern-sdk-method-name': 'list',
responses: {
200: {
- content: { 'application/json': { schema: ListConfiguredSkillsResponseSchema } },
+ content: { 'application/json': { schema: ListSkillsResponseSchema } },
description: 'All configured skills.',
},
401: {
@@ -70,13 +71,13 @@ export const createSkillRoute = createRoute({
'x-fern-sdk-method-name': 'create',
request: {
body: {
- content: { 'application/json': { schema: SkillManifestSchema } },
+ content: { 'application/json': { schema: CreateSkillRequestSchema } },
required: true,
},
},
responses: {
- 200: {
- content: { 'application/json': { schema: PutSkillResponseSchema } },
+ 201: {
+ content: { 'application/json': { schema: GetSkillResponseSchema } },
description: 'The created skill.',
},
400: {
@@ -100,13 +101,13 @@ export const putSkillRoute = createRoute({
'x-fern-sdk-method-name': 'upsert',
request: {
body: {
- content: { 'application/json': { schema: SkillManifestSchema } },
+ content: { 'application/json': { schema: PutSkillRequestSchema } },
required: true,
},
},
responses: {
200: {
- content: { 'application/json': { schema: PutSkillResponseSchema } },
+ content: { 'application/json': { schema: GetSkillResponseSchema } },
description: 'The saved skill.',
},
400: {
diff --git a/packages/server/src/schemas/common.ts b/packages/server/src/schemas/common.ts
index 4480c6cea..c5e90fef4 100644
--- a/packages/server/src/schemas/common.ts
+++ b/packages/server/src/schemas/common.ts
@@ -15,7 +15,6 @@ export const NameSchema = z
/^[a-z](?:[a-z0-9._-]{0,62}[a-z0-9])$/,
'must be 2–64 lowercase chars: start with a letter, end with alphanumeric, optionally separated by ".", "_" or "-"',
)
- .describe('Fully qualified name. Unique within a tenant.')
.openapi('ResourceName');
export type ResourceName = z.infer<typeof NameSchema>;
diff --git a/packages/server/src/schemas/mcpCatalog.ts b/packages/server/src/schemas/mcpCatalog.ts
index 890644b50..0f6f715f1 100644
--- a/packages/server/src/schemas/mcpCatalog.ts
+++ b/packages/server/src/schemas/mcpCatalog.ts
@@ -4,17 +4,17 @@
*/
import { z } from '@hono/zod-openapi';
import { NameSchema, uniqueNames } from './common';
-import { McpServerAuthSettingsSchema, McpServerDescriptionSchema, McpServerTypeSchema } from './mcpServer';
+import { McpServerDescriptionSchema, McpServerManifestAuthSchema, McpServerTypeSchema } from './mcpServer';
/** Catalog entry — discovery preset the settings UI copies into a PUT body. */
export const CatalogMcpServerSchema = z
.object({
- type: McpServerTypeSchema.describe('MCP server kind (`remote` today).'),
+ type: McpServerTypeSchema,
name: NameSchema,
logo: z.url().optional().describe('URL of the MCP server logo asset.'),
url: z.url().describe('URL of the remote MCP server.'),
description: McpServerDescriptionSchema,
- auth: McpServerAuthSettingsSchema.optional().describe('Optional default auth settings for the preset.'),
+ auth: McpServerManifestAuthSchema.optional(),
})
.strict()
.openapi('CatalogMcpServer');
diff --git a/packages/server/src/schemas/mcpServer.ts b/packages/server/src/schemas/mcpServer.ts
index c2b7e7bf5..fcd7f3e53 100644
--- a/packages/server/src/schemas/mcpServer.ts
+++ b/packages/server/src/schemas/mcpServer.ts
@@ -36,9 +36,10 @@ const McpServerDcrAuthSchema = z
.strict()
.openapi('McpServerDcrAuth');
-export const McpServerAuthSettingsSchema = z
+export const McpServerManifestAuthSchema = z
.discriminatedUnion('type', [McpServerHeaderAuthSchema, McpServerDcrAuthSchema])
- .openapi('ConfiguredMcpServerAuth');
+ .describe('Optional auth settings. Omit when the server needs no credentials.')
+ .openapi('McpServerManifestAuth');
export const McpServerDescriptionSchema = z
.string()
@@ -49,13 +50,11 @@ export const McpServerDescriptionSchema = z
/** Configured MCP server document persisted as `mcp_server.manifest`. */
export const McpServerManifestObjectSchema = z
.object({
- type: McpServerTypeSchema.describe('MCP server kind (`remote` today).'),
+ type: McpServerTypeSchema,
name: NameSchema,
url: z.url().describe('URL of the remote MCP server.'),
description: McpServerDescriptionSchema,
- auth: McpServerAuthSettingsSchema.optional().describe(
- 'Optional auth settings. Omit when the server needs no credentials.',
- ),
+ auth: McpServerManifestAuthSchema.optional(),
})
.strict();
@@ -72,19 +71,33 @@ export const McpAuthStatusSchema = z
.describe('When auth is required, this contains the URL to redirect the user to for authorization.'),
})
.strict()
+ .describe('Current auth state.')
.openapi('McpAuthStatus');
-/** Admin/settings wire view: manifest fields plus nested auth_status. */
-export const ConfiguredMcpServerSchema = McpServerManifestObjectSchema.extend({
- auth_status: McpAuthStatusSchema,
-}).openapi('ConfiguredMcpServer');
-
-/** PUT body — same Zod shape as `McpServerManifest` (OpenAPI name stays `McpServerManifest`). */
-export const PutMcpServerRequestSchema = McpServerManifestSchema;
-/** Shared create/upsert/disconnect response envelope (`{ data: ConfiguredMcpServer }`). */
-export const PutMcpServerResponseSchema = z.object({ data: ConfiguredMcpServerSchema }).openapi('PutMcpServerResponse');
-/** POST create body — separate OpenAPI name so Fern keeps the main-branch upsert request + `type` inject. */
-export const CreateMcpServerRequestSchema = McpServerManifestObjectSchema.openapi('CreateMcpServerRequest');
+/** Admin/settings wire view: identity column plus nested manifest and auth_status. */
+export const ConfiguredMcpServerSchema = z
+ .object({
+ name: NameSchema,
+ manifest: McpServerManifestSchema,
+ auth_status: McpAuthStatusSchema,
+ })
+ .strict()
+ .openapi('ConfiguredMcpServer');
+
+export const CreateMcpServerRequestSchema = z
+ .object({
+ manifest: McpServerManifestSchema,
+ })
+ .strict()
+ .openapi('CreateMcpServerRequest');
+
+export const PutMcpServerRequestSchema = z
+ .object({
+ manifest: McpServerManifestSchema,
+ })
+ .strict()
+ .openapi('PutMcpServerRequest');
+
export const GetMcpServerResponseSchema = z.object({ data: ConfiguredMcpServerSchema }).openapi('GetMcpServerResponse');
export const ListMcpServersResponseSchema = z
.object({ data: z.array(ConfiguredMcpServerSchema) })
@@ -96,6 +109,7 @@ export const McpServerAuthPublicSchema = z
z.object({ type: z.literal('dcr') }).strict(),
z.object({ type: z.literal('header') }).strict(),
])
+ .describe('Auth mechanism when configured (no secrets). Omit when the server needs no credentials.')
.openapi('McpServerAuthPublic');
/** Chat/composer read view — public fields plus per-user auth_status. */
@@ -103,10 +117,8 @@ export const McpServerReadEntrySchema = z
.object({
name: NameSchema,
url: z.url().describe('URL of the remote MCP server.'),
- auth: McpServerAuthPublicSchema.optional().describe(
- 'Auth mechanism when configured (no secrets). Omit when the server needs no credentials.',
- ),
- auth_status: McpAuthStatusSchema.describe('Auth state for the calling user.'),
+ auth: McpServerAuthPublicSchema.optional(),
+ auth_status: McpAuthStatusSchema,
})
.strict()
.openapi('McpServerReadEntry');
@@ -116,11 +128,13 @@ export const ListAvailableMcpServersResponseSchema = z
.openapi('ListAvailableMcpServersResponse');
export type McpServerType = z.infer<typeof McpServerTypeSchema>;
-export type McpServerAuthSettings = z.infer<typeof McpServerAuthSettingsSchema>;
+export type McpServerManifestAuth = z.infer<typeof McpServerManifestAuthSchema>;
export type McpServerManifest = z.infer<typeof McpServerManifestSchema>;
export type McpAuthStatus = z.infer<typeof McpAuthStatusSchema>;
export type McpServerAuthPublic = z.infer<typeof McpServerAuthPublicSchema>;
export type ConfiguredMcpServer = z.infer<typeof ConfiguredMcpServerSchema>;
+export type CreateMcpServerRequest = z.infer<typeof CreateMcpServerRequestSchema>;
+export type PutMcpServerRequest = z.infer<typeof PutMcpServerRequestSchema>;
export type McpServerReadEntry = z.infer<typeof McpServerReadEntrySchema>;
/**
diff --git a/packages/server/src/schemas/modelProvider.ts b/packages/server/src/schemas/modelProvider.ts
index 261c98407..20ce53696 100644
--- a/packages/server/src/schemas/modelProvider.ts
+++ b/packages/server/src/schemas/modelProvider.ts
@@ -1,7 +1,6 @@
/**
- * Model-provider domain + wire schemas: configured provider manifests (DB /
- * PUT body / response) and OpenAPI request/response shapes. Catalog file schemas
- * live on ModelCatalog.
+ * Model-provider domain + wire schemas: configured provider manifests (DB jsonb)
+ * and OpenAPI request/response shapes. Catalog file schemas live on ModelCatalog.
*/
import { z } from '@hono/zod-openapi';
import { SUPPORTED_REASONING_EFFORTS, VERCEL_AI_PROVIDER_NAMES } from '@truefoundry/trueforge-core/core';
@@ -27,13 +26,14 @@ export const ModelPropertiesSchema = z
.describe('Supported reasoning-effort values for this model.'),
})
.strict()
+ .describe('Optional model capability metadata.')
.openapi('ModelProperties');
export const ModelEntrySchema = z
.object({
model_id: z.string().min(1).describe('Upstream, provider-specific identifier sent to the provider API.'),
- name: NameSchema.describe('Internal identifier; forms the fully qualified name `name/model_name`.'),
- properties: ModelPropertiesSchema.describe('Optional model capability metadata.'),
+ name: NameSchema,
+ properties: ModelPropertiesSchema,
})
.strict()
.openapi('ModelEntry');
@@ -64,11 +64,12 @@ const ModelProviderAuthSchema = z
),
})
.strict()
+ .describe('Provider authentication credentials.')
.openapi('ModelProviderAuth');
const ModelProviderManifestBaseSchema = z
.object({
- auth: ModelProviderAuthSchema.describe('Provider authentication credentials.'),
+ auth: ModelProviderAuthSchema,
models: z.array(ModelEntrySchema).min(1).describe('Models exposed by this provider (at least one).'),
})
.strict();
@@ -151,9 +152,8 @@ export function refineModelProviderManifest(
export type ModelProperties = z.infer<typeof ModelPropertiesSchema>;
/**
- * Configured provider: PUT body, response data, and the persisted `model_provider.manifest` document
- * in one shape. Only `custom` carries a name, so the row's key column comes from
- * `modelProviderName` rather than from a field every type repeats.
+ * Configured provider jsonb (`model_provider.manifest`). Only `custom` carries a name, so the
+ * row's key column comes from `modelProviderName` rather than from a field every type repeats.
*/
const ModelProviderBodySchema = z
.discriminatedUnion('type', [
@@ -169,25 +169,47 @@ const ModelProviderBodySchema = z
])
.superRefine(refineModelProviderManifest);
-export const ModelProviderSchema = ModelProviderBodySchema.openapi('ModelProvider');
+export const ModelProviderManifestSchema = ModelProviderBodySchema.openapi('ModelProviderManifest');
/** The row's key: only `custom` carries a name of its own. */
-export function modelProviderName(provider: ModelProvider): ResourceName {
+export function modelProviderName(provider: ModelProviderManifest): ResourceName {
return provider.type === 'custom' ? provider.name : provider.type;
}
-export const ListModelProvidersResponseSchema = z
+/** Settings wire item: identity column plus nested manifest. */
+export const ModelProviderSchema = z
.object({
- data: z.array(ModelProviderSchema),
+ name: NameSchema,
+ manifest: ModelProviderManifestSchema,
})
- .openapi('ListModelProvidersResponse');
+ .strict()
+ .openapi('ModelProvider');
+
+export const CreateModelProviderRequestSchema = z
+ .object({
+ manifest: ModelProviderManifestSchema,
+ })
+ .strict()
+ .openapi('CreateModelProviderRequest');
+
+export const PutModelProviderRequestSchema = z
+ .object({
+ manifest: ModelProviderManifestSchema,
+ })
+ .strict()
+ .openapi('PutModelProviderRequest');
-/** Shared create/upsert response envelope (`{ data: ModelProvider }`). */
-export const PutModelProviderResponseSchema = z
+export const GetModelProviderResponseSchema = z
.object({
data: ModelProviderSchema,
})
- .openapi('PutModelProviderResponse');
+ .openapi('GetModelProviderResponse');
+
+export const ListModelProvidersResponseSchema = z
+ .object({
+ data: z.array(ModelProviderSchema),
+ })
+ .openapi('ListModelProvidersResponse');
/** Provider identity on the models list read view. */
export const ModelListProviderSchema = z
@@ -195,6 +217,7 @@ export const ModelListProviderSchema = z
name: z.string().min(1).describe('Configured provider resource name; matches the FQN prefix of `name`.'),
})
.strict()
+ .describe('Owning configured provider.')
.openapi('ModelListProvider');
/** Read view over configured providers: FQN plus explicit provider identity for clients. */
@@ -204,8 +227,8 @@ export const ModelSchema = z
.string()
.describe('Fully qualified name `provider_name/model_name`, e.g. "openai/gpt-5-6-sol". Unique within a tenant.'),
model_id: z.string().describe('Upstream, provider-specific identifier sent to the provider API.'),
- provider: ModelListProviderSchema.describe('Owning configured provider.'),
- properties: ModelPropertiesSchema.describe('Optional model capability metadata.'),
+ provider: ModelListProviderSchema,
+ properties: ModelPropertiesSchema,
})
.strict()
.openapi('Model');
@@ -216,6 +239,9 @@ export const ListModelsResponseSchema = z
})
.openapi('ListModelsResponse');
+export type ModelProviderManifest = z.infer<typeof ModelProviderManifestSchema>;
export type ModelProvider = z.infer<typeof ModelProviderSchema>;
+export type CreateModelProviderRequest = z.infer<typeof CreateModelProviderRequestSchema>;
+export type PutModelProviderRequest = z.infer<typeof PutModelProviderRequestSchema>;
export type ModelListProvider = z.infer<typeof ModelListProviderSchema>;
export type Model = z.infer<typeof ModelSchema>;
diff --git a/packages/server/src/schemas/sandboxProvider.ts b/packages/server/src/schemas/sandboxProvider.ts
index bfc182acd..5b292a3ae 100644
--- a/packages/server/src/schemas/sandboxProvider.ts
+++ b/packages/server/src/schemas/sandboxProvider.ts
@@ -1,7 +1,6 @@
/**
- * Sandbox-provider domain + wire schemas: configured provider manifests (DB /
- * PUT body) and OpenAPI request/response shapes. Catalog file schemas live in
- * sandboxCatalog.ts.
+ * Sandbox-provider domain + wire schemas: configured provider jsonb and OpenAPI
+ * request/response shapes. Catalog file schemas live in sandboxCatalog.ts.
*
* Singleton per tenant — no identity `name` (unlike model providers / skills).
*/
@@ -18,18 +17,19 @@ const DaytonaSandboxProviderAuthSchema = z
),
})
.strict()
+ .describe('Daytona authentication credentials.')
.openapi('DaytonaSandboxProviderAuth');
/**
- * Daytona-backed sandbox provider config. Wire PUT body and persisted
- * `sandbox_provider.manifest` document share this shape. Left unnamed for OpenAPI so
- * `SandboxProviderManifest` (its single-variant alias) is the one emitted component and the
- * response `manifest` field is a plain `$ref` instead of an `allOf` wrapper.
+ * Daytona-backed sandbox provider config. Persisted as `sandbox_provider.manifest`.
+ * Left unnamed for OpenAPI so `SandboxProviderManifest` (its single-variant alias)
+ * is the one emitted component and the response `manifest` field is a plain `$ref`
+ * instead of an `allOf` wrapper.
*/
export const DaytonaSandboxProviderSchema = z
.object({
type: z.literal('daytona').describe('Daytona sandbox provider.'),
- auth: DaytonaSandboxProviderAuthSchema.describe('Daytona authentication credentials.'),
+ auth: DaytonaSandboxProviderAuthSchema,
exec_timeout_ms: z.number().int().positive().describe('Default sandbox command exec timeout in milliseconds.'),
auto_stop_interval_in_minutes: z
.number()
@@ -50,7 +50,7 @@ export const DaytonaSandboxProviderSchema = z
.strict();
/**
- * Persisted jsonb + PUT body: the provider config only (no build status). Single variant today —
+ * Persisted jsonb: the provider config only (no build status). Single variant today —
* this alias carries the OpenAPI name so the spec emits one `SandboxProviderManifest` component.
* Widen to `z.discriminatedUnion('type', [...])` when a second provider ships.
*/
@@ -78,27 +78,26 @@ export const SandboxStatusSchema = z
})
.strict();
-/** GET/PUT response body: the stored provider manifest plus its build status (no build_metadata). */
-export const SandboxProviderResponseSchema = z
+/** Settings wire item: nested manifest plus build status (no build_metadata). */
+export const SandboxProviderSchema = z
.object({
manifest: SandboxProviderManifestSchema,
status: SandboxBuildStatusSchema,
status_reason: z.string().nullable().describe('Human-readable detail for the current status; null when ready.'),
})
.strict()
- .openapi('SandboxProviderResponse');
+ .openapi('SandboxProvider');
-export const PutSandboxProviderRequestSchema = SandboxProviderManifestSchema;
-
-export const PutSandboxProviderResponseSchema = z
+export const PutSandboxProviderRequestSchema = z
.object({
- data: SandboxProviderResponseSchema,
+ manifest: SandboxProviderManifestSchema,
})
- .openapi('PutSandboxProviderResponse');
+ .strict()
+ .openapi('PutSandboxProviderRequest');
export const GetSandboxProviderResponseSchema = z
.object({
- data: SandboxProviderResponseSchema,
+ data: SandboxProviderSchema,
})
.openapi('GetSandboxProviderResponse');
@@ -108,7 +107,7 @@ export type DaytonaSandboxProvider = z.infer<typeof DaytonaSandboxProviderSchema
export type SandboxBuildStatus = z.infer<typeof SandboxBuildStatusSchema>;
export type SandboxBuildMetadata = z.infer<typeof SandboxBuildMetadataSchema>;
export type SandboxStatus = z.infer<typeof SandboxStatusSchema>;
-export type SandboxProviderResponse = z.infer<typeof SandboxProviderResponseSchema>;
+export type SandboxProvider = z.infer<typeof SandboxProviderSchema>;
export type PutSandboxProviderRequest = z.infer<typeof PutSandboxProviderRequestSchema>;
/** Wire/persisted snake_case → Daytona client credentials + provider settings. */
diff --git a/packages/server/src/schemas/skill.ts b/packages/server/src/schemas/skill.ts
index 306ef3910..8d45395c6 100644
--- a/packages/server/src/schemas/skill.ts
+++ b/packages/server/src/schemas/skill.ts
@@ -71,14 +71,33 @@ export const SkillManifestObjectSchema = z
export const SkillManifestSchema = SkillManifestObjectSchema.openapi('SkillManifest');
-/** Admin/settings wire view — same fields as the stored manifest (no auth_status). */
-export const ConfiguredSkillSchema = SkillManifestSchema;
+/** Admin/settings wire view: identity column plus nested manifest. */
+export const ConfiguredSkillSchema = z
+ .object({
+ name: NameSchema,
+ manifest: SkillManifestSchema,
+ })
+ .strict()
+ .openapi('ConfiguredSkill');
+
+export const CreateSkillRequestSchema = z
+ .object({
+ manifest: SkillManifestSchema,
+ })
+ .strict()
+ .openapi('CreateSkillRequest');
+
+export const PutSkillRequestSchema = z
+ .object({
+ manifest: SkillManifestSchema,
+ })
+ .strict()
+ .openapi('PutSkillRequest');
-/** Shared create/upsert response envelope (`{ data: SkillManifest }`). */
-export const PutSkillResponseSchema = z.object({ data: ConfiguredSkillSchema }).openapi('PutSkillResponse');
-export const ListConfiguredSkillsResponseSchema = z
+export const GetSkillResponseSchema = z.object({ data: ConfiguredSkillSchema }).openapi('GetSkillResponse');
+export const ListSkillsResponseSchema = z
.object({ data: z.array(ConfiguredSkillSchema) })
- .openapi('ListConfiguredSkillsResponse');
+ .openapi('ListSkillsResponse');
/** Chat/composer read view — discovery fields only. */
export const SkillReadEntrySchema = z
@@ -96,4 +115,6 @@ export const ListAvailableSkillsResponseSchema = z
export type SkillType = z.infer<typeof SkillTypeSchema>;
export type SkillManifest = z.infer<typeof SkillManifestSchema>;
export type ConfiguredSkill = z.infer<typeof ConfiguredSkillSchema>;
+export type CreateSkillRequest = z.infer<typeof CreateSkillRequestSchema>;
+export type PutSkillRequest = z.infer<typeof PutSkillRequestSchema>;
export type SkillReadEntry = z.infer<typeof SkillReadEntrySchema>;
diff --git a/packages/server/tests/db/modelProviderStoreContractSuite.ts b/packages/server/tests/db/modelProviderStoreContractSuite.ts
index 620b5d74c..47afa2839 100644
--- a/packages/server/tests/db/modelProviderStoreContractSuite.ts
+++ b/packages/server/tests/db/modelProviderStoreContractSuite.ts
@@ -3,7 +3,7 @@
* Runs under jest against a fresh store per test (see backend test files).
*/
import { ModelProviderNameConflictError, type IModelProviderStore } from '../../src/db/modelProviderStore';
-import type { ModelProvider } from '../../src/schemas/modelProvider';
+import type { ModelProviderManifest } from '../../src/schemas/modelProvider';
const TENANT = 'default';
@@ -19,7 +19,7 @@ const anthropic = {
properties: { context_length: 200000, max_output_tokens: 32768, reasoning_efforts: ['low', 'high'] },
},
],
-} satisfies ModelProvider;
+} satisfies ModelProviderManifest;
const openai = {
type: 'openai',
@@ -28,7 +28,7 @@ const openai = {
models: [
{ model_id: 'gpt-5.6-sol', name: 'gpt-5-6-sol', properties: { context_length: 400000, max_output_tokens: 32768 } },
],
-} satisfies ModelProvider;
+} satisfies ModelProviderManifest;
const custom = {
type: 'custom',
@@ -36,7 +36,7 @@ const custom = {
base_url: 'https://llm.internal.example.com/v1',
auth: { api_key: 'sk-custom' },
models: anthropic.models,
-} satisfies ModelProvider;
+} satisfies ModelProviderManifest;
const ISO_UTC = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/;
diff --git a/packages/server/tests/unit/apis/mcpOAuth.test.ts b/packages/server/tests/unit/apis/mcpOAuth.test.ts
index 0fad15ed3..8dc38cf8d 100644
--- a/packages/server/tests/unit/apis/mcpOAuth.test.ts
+++ b/packages/server/tests/unit/apis/mcpOAuth.test.ts
@@ -122,11 +122,13 @@ describe('MCP OAuth authorize + callback', () => {
method: 'PUT',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({
- type: 'remote',
- name,
- url: MCP_URL,
- description: 'OAuth MCP server.',
- auth: { type: 'dcr' },
+ manifest: {
+ type: 'remote',
+ name,
+ url: MCP_URL,
+ description: 'OAuth MCP server.',
+ auth: { type: 'dcr' },
+ },
}),
});
expect(put.status).toBe(200);
@@ -146,11 +148,13 @@ describe('MCP OAuth authorize + callback', () => {
method: 'PUT',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({
- type: 'remote',
- name: 'oauth-mcp',
- url: MCP_URL,
- description: 'OAuth MCP server.',
- auth: { type: 'dcr' },
+ manifest: {
+ type: 'remote',
+ name: 'oauth-mcp',
+ url: MCP_URL,
+ description: 'OAuth MCP server.',
+ auth: { type: 'dcr' },
+ },
}),
});
expect(put.status).toBe(200);
@@ -229,11 +233,13 @@ describe('MCP OAuth authorize + callback', () => {
method: 'PUT',
headers: { 'content-type': 'application/json' },
body: JSON.stringify({
- type: 'remote',
- name: 'oauth-mcp-scoped',
- url: MCP_URL,
- description: 'OAuth MCP server.',
- auth: { type: 'dcr' },
+ manifest: {
+ type: 'remote',
+ name: 'oauth-mcp-scoped',
+ url: MCP_URL,
+ description: 'OAuth MCP server.',
+ auth: { type: 'dcr' },
+ },
}),
});
expect(put.status).toBe(200);
diff --git a/packages/server/tests/unit/apis/mcpServers.test.ts b/packages/server/tests/unit/apis/mcpServers.test.ts
index a4cbe194d..44c8caeee 100644
--- a/packages/server/tests/unit/apis/mcpServers.test.ts
+++ b/packages/server/tests/unit/apis/mcpServers.test.ts
@@ -51,6 +51,18 @@ const putBodyWithHeaderAuthWire = {
},
};
+function wrapManifest(manifest: unknown) {
+ return { manifest };
+}
+
+function configured(manifest: { name: string } & Record<string, unknown>, status: string) {
+ return {
+ name: manifest.name,
+ manifest,
+ auth_status: { status },
+ };
+}
+
function putInit(body: unknown): RequestInit {
return {
method: 'PUT',
@@ -151,16 +163,16 @@ describe('mcp-servers routers', () => {
});
it('PUT upserts a server and returns not_required auth_status for no-auth servers', async () => {
- const response = await settingsRouter.request('/', putInit(putBody));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(putBody)));
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: { ...putBody, auth_status: { status: 'not_required' } },
+ data: configured(putBody, 'not_required'),
});
const list = await settingsRouter.request('/');
expect(list.status).toBe(200);
expect(await list.json()).toEqual({
- data: [{ ...putBody, auth_status: { status: 'not_required' } }],
+ data: [configured(putBody, 'not_required')],
});
});
@@ -171,13 +183,13 @@ describe('mcp-servers routers', () => {
url: 'https://mcp.example.com/create-only',
description: 'Create-only MCP server.',
};
- const created = await settingsRouter.request('/', postInit(createBody));
- expect(created.status).toBe(200);
+ const created = await settingsRouter.request('/', postInit(wrapManifest(createBody)));
+ expect(created.status).toBe(201);
expect(await created.json()).toEqual({
- data: { ...createBody, auth_status: { status: 'not_required' } },
+ data: configured(createBody, 'not_required'),
});
- const clash = await settingsRouter.request('/', postInit(createBody));
+ const clash = await settingsRouter.request('/', postInit(wrapManifest(createBody)));
expect(clash.status).toBe(409);
expect(await clash.json()).toEqual({
error: { message: 'MCP server name already exists: create-only-mcp' },
@@ -188,7 +200,7 @@ describe('mcp-servers routers', () => {
const response = await settingsRouter.request(`/${putBody.name}`);
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: { ...putBody, auth_status: { status: 'not_required' } },
+ data: configured(putBody, 'not_required'),
});
const missing = await settingsRouter.request('/missing');
@@ -199,7 +211,7 @@ describe('mcp-servers routers', () => {
});
it('PUT with DCR fails registration without writing a server row', async () => {
- const response = await settingsRouter.request('/', putInit(putBodyWithDcr));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(putBodyWithDcr)));
expect(response.status).toBe(422);
expect(await response.json()).toEqual({
error: {
@@ -217,7 +229,7 @@ describe('mcp-servers routers', () => {
description: 'Create DCR fail MCP server.',
auth: { type: 'dcr' as const },
};
- const response = await settingsRouter.request('/', postInit(createDcr));
+ const response = await settingsRouter.request('/', postInit(wrapManifest(createDcr)));
expect(response.status).toBe(422);
expect(await mcpServerStore.getServer({ tenant_id: TENANT_ID, name: createDcr.name })).toBeUndefined();
});
@@ -285,10 +297,10 @@ describe('mcp-servers routers', () => {
});
// A re-upsert preserves the id, so the PUT response must reflect the carried-over token.
- const response = await settingsRouter.request('/', putInit(putBodyWithDcr));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(putBodyWithDcr)));
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: { ...putBodyWithDcr, auth_status: { status: 'authenticated' } },
+ data: configured(putBodyWithDcr, 'authenticated'),
});
await tokenStore.deleteToken({ id: record.id, userRef: LOCAL_USER_CONTEXT.userRef });
@@ -353,19 +365,17 @@ describe('mcp-servers routers', () => {
try {
const response = await settingsRouter.request(
'/',
- putInit({
- ...putBodyWithDcr,
- url: newUrl,
- }),
+ putInit(
+ wrapManifest({
+ ...putBodyWithDcr,
+ url: newUrl,
+ }),
+ ),
);
expect(response.status).toBe(200);
// List/GET auth_status is presence-based; tokens are not cleared on re-DCR.
expect(await response.json()).toEqual({
- data: {
- ...putBodyWithDcr,
- url: newUrl,
- auth_status: { status: 'authenticated' },
- },
+ data: configured({ ...putBodyWithDcr, url: newUrl }, 'authenticated'),
});
expect(await tokenStore.getToken({ id: record.id, userRef: LOCAL_USER_CONTEXT.userRef })).toMatchObject({
accessToken: 'stale-for-old-url',
@@ -400,10 +410,10 @@ describe('mcp-servers routers', () => {
});
it('PUT with header auth stores plaintext and returns redacted headers', async () => {
- const response = await settingsRouter.request('/', putInit(putBodyWithHeaderAuth));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(putBodyWithHeaderAuth)));
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: { ...putBodyWithHeaderAuthWire, auth_status: { status: 'authenticated' } },
+ data: configured(putBodyWithHeaderAuthWire, 'authenticated'),
});
const stored = await mcpServerStore.getServer({ tenant_id: TENANT_ID, name: putBodyWithHeaderAuth.name });
@@ -419,13 +429,13 @@ describe('mcp-servers routers', () => {
headers: { Authorization: HEADER_TOKEN_REDACTED },
},
};
- const response = await settingsRouter.request('/', putInit(redactedOnly));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(redactedOnly)));
expect(response.status).toBe(400);
expect(await response.json()).toEqual({ error: { message: 'Header secret is required' } });
});
it('PUT with a redacted header value keeps the stored secret', async () => {
- await settingsRouter.request('/', putInit(putBodyWithHeaderAuth));
+ await settingsRouter.request('/', putInit(wrapManifest(putBodyWithHeaderAuth)));
const keep = {
...putBodyWithHeaderAuth,
@@ -435,17 +445,19 @@ describe('mcp-servers routers', () => {
headers: { Authorization: HEADER_TOKEN_REDACTED },
},
};
- const response = await settingsRouter.request('/', putInit(keep));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(keep)));
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: {
- ...keep,
- auth: {
- type: 'header',
- headers: { Authorization: HEADER_TOKEN_REDACTED },
+ data: configured(
+ {
+ ...keep,
+ auth: {
+ type: 'header',
+ headers: { Authorization: HEADER_TOKEN_REDACTED },
+ },
},
- auth_status: { status: 'authenticated' },
- },
+ 'authenticated',
+ ),
});
const stored = await mcpServerStore.getServer({ tenant_id: TENANT_ID, name: putBodyWithHeaderAuth.name });
@@ -457,7 +469,7 @@ describe('mcp-servers routers', () => {
});
it('PUT with a different redacted header value still keeps the stored secret', async () => {
- await settingsRouter.request('/', putInit(putBodyWithHeaderAuth));
+ await settingsRouter.request('/', putInit(wrapManifest(putBodyWithHeaderAuth)));
// Any value containing ***REDACTED*** is treated as keep, not only the exact GET mask.
const keep = {
@@ -468,17 +480,19 @@ describe('mcp-servers routers', () => {
headers: { Authorization: 'oth-***REDACTED***-xxx' },
},
};
- const response = await settingsRouter.request('/', putInit(keep));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(keep)));
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: {
- ...keep,
- auth: {
- type: 'header',
- headers: { Authorization: HEADER_TOKEN_REDACTED },
+ data: configured(
+ {
+ ...keep,
+ auth: {
+ type: 'header',
+ headers: { Authorization: HEADER_TOKEN_REDACTED },
+ },
},
- auth_status: { status: 'authenticated' },
- },
+ 'authenticated',
+ ),
});
const stored = await mcpServerStore.getServer({ tenant_id: TENANT_ID, name: putBodyWithHeaderAuth.name });
@@ -490,7 +504,7 @@ describe('mcp-servers routers', () => {
});
it('PUT with a real header value rotates the stored secret', async () => {
- await settingsRouter.request('/', putInit(putBodyWithHeaderAuth));
+ await settingsRouter.request('/', putInit(wrapManifest(putBodyWithHeaderAuth)));
const rotatedToken = 'Bearer rotated-token';
const rotatedTokenRedacted = 'Bea-***REDACTED***-ken';
@@ -501,17 +515,19 @@ describe('mcp-servers routers', () => {
headers: { Authorization: rotatedToken },
},
};
- const response = await settingsRouter.request('/', putInit(rotated));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(rotated)));
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: {
- ...rotated,
- auth: {
- type: 'header',
- headers: { Authorization: rotatedTokenRedacted },
+ data: configured(
+ {
+ ...rotated,
+ auth: {
+ type: 'header',
+ headers: { Authorization: rotatedTokenRedacted },
+ },
},
- auth_status: { status: 'authenticated' },
- },
+ 'authenticated',
+ ),
});
const stored = await mcpServerStore.getServer({ tenant_id: TENANT_ID, name: putBodyWithHeaderAuth.name });
@@ -592,19 +608,21 @@ describe('mcp-servers routers', () => {
it('PUT rejects invalid bodies at the Zod layer', async () => {
const { url: _, ...withoutUrl } = putBody;
- const missingUrl = await settingsRouter.request('/', putInit(withoutUrl));
+ const missingUrl = await settingsRouter.request('/', putInit(wrapManifest(withoutUrl)));
expect(missingUrl.status).toBe(400);
- const badName = await settingsRouter.request('/', putInit({ ...putBody, name: 'Not A Name' }));
+ const badName = await settingsRouter.request('/', putInit(wrapManifest({ ...putBody, name: 'Not A Name' })));
expect(badName.status).toBe(400);
const emptyHeaders = await settingsRouter.request(
'/',
- putInit({
- ...putBodyWithHeaderAuth,
- name: 'bad-empty-headers',
- auth: { type: 'header', headers: {} },
- }),
+ putInit(
+ wrapManifest({
+ ...putBodyWithHeaderAuth,
+ name: 'bad-empty-headers',
+ auth: { type: 'header', headers: {} },
+ }),
+ ),
);
expect(emptyHeaders.status).toBe(400);
});
@@ -660,13 +678,15 @@ describe('mcp-servers routers', () => {
try {
const put = await settingsRouter.request(
'/',
- putInit({
- type: 'remote',
- name: 'failing-oauth-mcp',
- url: mcpUrl,
- description: 'Failing OAuth MCP server.',
- auth: { type: 'dcr' },
- }),
+ putInit(
+ wrapManifest({
+ type: 'remote',
+ name: 'failing-oauth-mcp',
+ url: mcpUrl,
+ description: 'Failing OAuth MCP server.',
+ auth: { type: 'dcr' },
+ }),
+ ),
);
// Registration fails before any DB write — no server exists to authorize.
expect(put.status).toBe(422);
@@ -725,13 +745,15 @@ describe('mcp-servers routers', () => {
try {
const put = await settingsRouter.request(
'/',
- putInit({
- type: 'remote',
- name: 'oauth-mcp',
- url: mcpUrl,
- description: 'OAuth MCP server.',
- auth: { type: 'dcr' },
- }),
+ putInit(
+ wrapManifest({
+ type: 'remote',
+ name: 'oauth-mcp',
+ url: mcpUrl,
+ description: 'OAuth MCP server.',
+ auth: { type: 'dcr' },
+ }),
+ ),
);
expect(put.status).toBe(200);
@@ -782,7 +804,7 @@ describe('mcp-servers routers', () => {
const response = await mcpServersRouter.request(`/${putBodyWithDcr.name}/authorize`, { method: 'DELETE' });
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: { ...putBodyWithDcr, auth_status: { status: 'auth_required' } },
+ data: configured(putBodyWithDcr, 'auth_required'),
});
expect(await tokenStore.getToken({ id: record.id, userRef: LOCAL_USER_CONTEXT.userRef })).toBeUndefined();
expect(await mcpServerStore.getClient({ id: record.id })).toEqual({
@@ -802,15 +824,15 @@ describe('mcp-servers routers', () => {
const noAuth = await mcpServersRouter.request('/deepwiki/authorize', { method: 'DELETE' });
expect(noAuth.status).toBe(200);
expect(await noAuth.json()).toEqual({
- data: { ...putBody, auth_status: { status: 'not_required' } },
+ data: configured(putBody, 'not_required'),
});
// Ensure header-auth fixture is present with a known secret (later tests may have rotated it).
- await settingsRouter.request('/', putInit(putBodyWithHeaderAuth));
+ await settingsRouter.request('/', putInit(wrapManifest(putBodyWithHeaderAuth)));
const headerAuth = await mcpServersRouter.request('/private-mcp/authorize', { method: 'DELETE' });
expect(headerAuth.status).toBe(200);
expect(await headerAuth.json()).toEqual({
- data: { ...putBodyWithHeaderAuthWire, auth_status: { status: 'authenticated' } },
+ data: configured(putBodyWithHeaderAuthWire, 'authenticated'),
});
const missing = await mcpServersRouter.request('/missing/authorize', { method: 'DELETE' });
diff --git a/packages/server/tests/unit/apis/modelProviders.test.ts b/packages/server/tests/unit/apis/modelProviders.test.ts
index 1fb394604..f0f34e807 100644
--- a/packages/server/tests/unit/apis/modelProviders.test.ts
+++ b/packages/server/tests/unit/apis/modelProviders.test.ts
@@ -52,19 +52,27 @@ const customBodyWire = {
auth: { api_key: toRedactedSecretValue(customBody.auth.api_key) },
};
-function putInit(body: unknown): RequestInit {
+function wrapManifest(manifest: unknown) {
+ return { manifest };
+}
+
+function configured(name: string, manifest: unknown) {
+ return { name, manifest };
+}
+
+function putInit(manifest: unknown): RequestInit {
return {
method: 'PUT',
headers: { 'content-type': 'application/json' },
- body: JSON.stringify(body),
+ body: JSON.stringify(wrapManifest(manifest)),
};
}
-function postInit(body: unknown): RequestInit {
+function postInit(manifest: unknown): RequestInit {
return {
method: 'POST',
headers: { 'content-type': 'application/json' },
- body: JSON.stringify(body),
+ body: JSON.stringify(wrapManifest(manifest)),
};
}
@@ -135,18 +143,18 @@ describe('settings model-providers and models routers', () => {
it('PUT upserts a well-known provider without base_url and returns redacted auth', async () => {
const response = await settingsRouter.request('/model-providers', putInit(anthropicBody));
expect(response.status).toBe(200);
- expect(await response.json()).toEqual({ data: anthropicProviderWire });
+ expect(await response.json()).toEqual({ data: configured('anthropic', anthropicProviderWire) });
const list = await settingsRouter.request('/model-providers');
expect(list.status).toBe(200);
- expect(await list.json()).toEqual({ data: [anthropicProviderWire] });
+ expect(await list.json()).toEqual({ data: [configured('anthropic', anthropicProviderWire)] });
});
it('POST creates a provider and returns 409 on name clash', async () => {
const { settingsRouter: fresh } = await createRouters();
const created = await fresh.request('/model-providers', postInit(anthropicBody));
- expect(created.status).toBe(200);
- expect(await created.json()).toEqual({ data: anthropicProviderWire });
+ expect(created.status).toBe(201);
+ expect(await created.json()).toEqual({ data: configured('anthropic', anthropicProviderWire) });
const clash = await fresh.request('/model-providers', postInit(anthropicBody));
expect(clash.status).toBe(409);
@@ -162,7 +170,7 @@ describe('settings model-providers and models routers', () => {
const created = await settingsRouter.request('/model-providers', putInit(customBody));
expect(created.status).toBe(200);
- expect(await created.json()).toEqual({ data: customBodyWire });
+ expect(await created.json()).toEqual({ data: configured('internal', customBodyWire) });
});
it('PUT rejects invalid bodies at the Zod layer', async () => {
@@ -219,11 +227,11 @@ describe('custom providers may omit auth', () => {
const put = await settingsRouter.request('/model-providers', putInit(body));
expect(put.status).toBe(200);
- expect(await put.json()).toEqual({ data: expectedWire });
+ expect(await put.json()).toEqual({ data: configured(name, expectedWire) });
const list = await settingsRouter.request('/model-providers');
expect(list.status).toBe(200);
- expect(await list.json()).toEqual({ data: [expectedWire] });
+ expect(await list.json()).toEqual({ data: [configured(name, expectedWire)] });
});
it('rejects empty api_key', async () => {
@@ -266,12 +274,12 @@ describe('well-known types are limited to one provider', () => {
const update = await settingsRouter.request('/model-providers', putInit(rotated));
expect(update.status).toBe(200);
expect(await update.json()).toEqual({
- data: withRedactedApiKey({ ...anthropicProvider, auth: rotated.auth }),
+ data: configured('anthropic', withRedactedApiKey({ ...anthropicProvider, auth: rotated.auth })),
});
const list = await settingsRouter.request('/model-providers');
expect(await list.json()).toEqual({
- data: [withRedactedApiKey({ ...anthropicProvider, auth: rotated.auth })],
+ data: [configured('anthropic', withRedactedApiKey({ ...anthropicProvider, auth: rotated.auth }))],
});
const models = await modelsRouter.request('/');
expect(((await models.json()) as { data: { name: string }[] }).data.map(entry => entry.name)).toEqual([
@@ -299,7 +307,7 @@ describe('well-known types are limited to one provider', () => {
const response = await settingsRouter.request('/model-providers', putInit(proxied));
expect(response.status).toBe(200);
expect(await response.json()).toEqual({
- data: withRedactedApiKey({ ...anthropicProvider, base_url: proxied.base_url }),
+ data: configured('anthropic', withRedactedApiKey({ ...anthropicProvider, base_url: proxied.base_url })),
});
});
@@ -311,7 +319,7 @@ describe('well-known types are limited to one provider', () => {
const list = await settingsRouter.request('/model-providers');
expect(await list.json()).toEqual({
- data: [customBodyWire, withRedactedApiKey(second)],
+ data: [configured('internal', customBodyWire), configured('internal-eu', withRedactedApiKey(second))],
});
});
});
@@ -368,10 +376,10 @@ describe('model-provider secret redaction and strict PUT', () => {
const update = await settingsRouter.request('/model-providers', putInit(redactedKeep));
expect(update.status).toBe(200);
const updateBody = (await update.json()) as {
- data: { auth: { api_key: string }; models: unknown[] };
+ data: { name: string; manifest: { auth: { api_key: string }; models: unknown[] } };
};
- expect(updateBody.data.auth.api_key).toBe(toRedactedSecretValue(anthropicBody.auth.api_key));
- expect(updateBody.data.models).toHaveLength(2);
+ expect(updateBody.data.manifest.auth.api_key).toBe(toRedactedSecretValue(anthropicBody.auth.api_key));
+ expect(updateBody.data.manifest.models).toHaveLength(2);
const stored = await modelProviderStore.getProvider({ tenant_id: TENANT_ID, name: 'anthropic' });
expect(stored?.manifest.auth?.api_key).toBe('sk-ant-secret');
@@ -385,8 +393,8 @@ describe('model-provider secret redaction and strict PUT', () => {
const rotated = { ...anthropicBody, auth: { api_key: rotatedKey } };
const update = await settingsRouter.request('/model-providers', putInit(rotated));
expect(update.status).toBe(200);
- expect((await update.json()) as { data: { auth: { api_key: string } } }).toEqual({
- data: withRedactedApiKey({ ...anthropicProvider, auth: { api_key: rotatedKey } }),
+ expect((await update.json()) as { data: { name: string; manifest: { auth: { api_key: string } } } }).toEqual({
+ data: configured('anthropic', withRedactedApiKey({ ...anthropicProvider, auth: { api_key: rotatedKey } })),
});
const stored = await modelProviderStore.getProvider({ tenant_id: TENANT_ID, name: 'anthropic' });
@@ -409,7 +417,7 @@ describe('catalog presets are configurable', () => {
expect(logo === undefined || typeof logo === 'string').toBe(true);
const response = await settingsRouter.request('/model-providers', putInit(body));
expect(response.status).toBe(200);
- const json = (await response.json()) as { data: { auth: { api_key: string } } };
- expect(json.data.auth.api_key).toBe(toRedactedSecretValue(`sk-${preset.type}`));
+ const json = (await response.json()) as { data: { name: string; manifest: { auth: { api_key: string } } } };
+ expect(json.data.manifest.auth.api_key).toBe(toRedactedSecretValue(`sk-${preset.type}`));
});
});
diff --git a/packages/server/tests/unit/apis/sandboxProviders.test.ts b/packages/server/tests/unit/apis/sandboxProviders.test.ts
index 346e2ade0..4afc39067 100644
--- a/packages/server/tests/unit/apis/sandboxProviders.test.ts
+++ b/packages/server/tests/unit/apis/sandboxProviders.test.ts
@@ -64,11 +64,15 @@ function stubProvider(overrides: { buildImage?: jest.Mock; getImageBuildStatus?:
};
}
-function putInit(body: unknown): RequestInit {
+function wrapManifest(manifest: unknown) {
+ return { manifest };
+}
+
+function putInit(manifest: unknown): RequestInit {
return {
method: 'PUT',
headers: { 'content-type': 'application/json' },
- body: JSON.stringify(body),
+ body: JSON.stringify(wrapManifest(manifest)),
};
}
diff --git a/packages/server/tests/unit/apis/skills.test.ts b/packages/server/tests/unit/apis/skills.test.ts
index 011b385f9..a03783db1 100644
--- a/packages/server/tests/unit/apis/skills.test.ts
+++ b/packages/server/tests/unit/apis/skills.test.ts
@@ -17,6 +17,14 @@ const putBody = {
description: 'Creating algorithmic art using p5.js with seeded randomness.',
};
+function wrapManifest(manifest: unknown) {
+ return { manifest };
+}
+
+function configured(manifest: { name: string }) {
+ return { name: manifest.name, manifest };
+}
+
function putInit(body: unknown): RequestInit {
return {
method: 'PUT',
@@ -70,13 +78,13 @@ describe('skills routers', () => {
});
it('PUT upserts a skill and echoes the stored manifest', async () => {
- const response = await settingsRouter.request('/', putInit(putBody));
+ const response = await settingsRouter.request('/', putInit(wrapManifest(putBody)));
expect(response.status).toBe(200);
- expect(await response.json()).toEqual({ data: putBody });
+ expect(await response.json()).toEqual({ data: configured(putBody) });
const list = await settingsRouter.request('/');
expect(list.status).toBe(200);
- expect(await list.json()).toEqual({ data: [putBody] });
+ expect(await list.json()).toEqual({ data: [configured(putBody)] });
});
it('POST creates a skill and returns 409 on name clash', async () => {
@@ -85,11 +93,11 @@ describe('skills routers', () => {
name: 'create-only-skill',
path: 'skills/create-only-skill',
};
- const created = await settingsRouter.request('/', postInit(createBody));
- expect(created.status).toBe(200);
- expect(await created.json()).toEqual({ data: createBody });
+ const created = await settingsRouter.request('/', postInit(wrapManifest(createBody)));
+ expect(created.status).toBe(201);
+ expect(await created.json()).toEqual({ data: configured(createBody) });
- const clash = await settingsRouter.request('/', postInit(createBody));
+ const clash = await settingsRouter.request('/', postInit(wrapManifest(createBody)));
expect(clash.status).toBe(409);
expect(await clash.json()).toEqual({
error: { message: 'Skill name already exists: create-only-skill' },
@@ -109,15 +117,15 @@ describe('skills routers', () => {
it('PUT rejects invalid bodies at the Zod layer', async () => {
const { url: _, ...withoutUrl } = putBody;
- const missingUrl = await settingsRouter.request('/', putInit(withoutUrl));
+ const missingUrl = await settingsRouter.request('/', putInit(wrapManifest(withoutUrl)));
expect(missingUrl.status).toBe(400);
- const badName = await settingsRouter.request('/', putInit({ ...putBody, name: 'Not A Name' }));
+ const badName = await settingsRouter.request('/', putInit(wrapManifest({ ...putBody, name: 'Not A Name' })));
expect(badName.status).toBe(400);
const badUrl = await settingsRouter.request(
'/',
- putInit({ ...putBody, name: 'bad-url', url: 'https://example.com/repo' }),
+ putInit(wrapManifest({ ...putBody, name: 'bad-url', url: 'https://example.com/repo' })),
);
expect(badUrl.status).toBe(400);
});
diff --git a/packages/server/tests/unit/schemas/modelProvider.test.ts b/packages/server/tests/unit/schemas/modelProvider.test.ts
index 207730dd7..77b8820e6 100644
--- a/packages/server/tests/unit/schemas/modelProvider.test.ts
+++ b/packages/server/tests/unit/schemas/modelProvider.test.ts
@@ -1,10 +1,10 @@
import { VERCEL_AI_PROVIDER_NAMES } from '@truefoundry/trueforge-core/core';
-import { ModelProviderSchema, modelProviderName } from '../../../src/schemas/modelProvider';
+import { ModelProviderManifestSchema, modelProviderName } from '../../../src/schemas/modelProvider';
const models = [{ model_id: 'a-model', name: 'a-model', properties: {} }];
function parse(body: Record<string, unknown>): { success: boolean; name?: string; base_url?: string } {
- const result = ModelProviderSchema.safeParse({ auth: { api_key: 'k' }, models, ...body });
+ const result = ModelProviderManifestSchema.safeParse({ auth: { api_key: 'k' }, models, ...body });
return result.success
? { success: true, name: modelProviderName(result.data), base_url: result.data.base_url }
: { success: false };
@@ -18,7 +18,7 @@ function providerFor(type: string, body: Record<string, unknown> = {}): Record<s
return { type, ...(CALLER_SUPPLIED_TYPES.includes(type) ? { name: 'internal' } : {}), ...body };
}
-describe('ModelProviderSchema', () => {
+describe('ModelProviderManifestSchema', () => {
// A type with no schema of its own leaves its catalog entries unconfigurable.
it('can configure every adapter the harness can build', () => {
const rejected = VERCEL_AI_PROVIDER_NAMES.filter(
diff --git a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
index fad72515a..aee3bf43f 100644
--- a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
@@ -23,7 +23,7 @@ export type UiConnectorCatalogEntry = ConnectorCatalogEntry;
const DEFAULT_API_KEY_HEADER = 'Authorization';
-export function toUiAuthPublic(auth: TrueForgeApi.ConfiguredMcpServerAuth | undefined): UiConnectorAuthPublic {
+export function toUiAuthPublic(auth: TrueForgeApi.McpServerManifestAuth | undefined): UiConnectorAuthPublic {
if (auth === undefined) {
return { type: 'none' };
}
@@ -37,7 +37,7 @@ export function toUiAuthPublic(auth: TrueForgeApi.ConfiguredMcpServerAuth | unde
};
}
-export function toHarnessAuth(auth: ConnectorAuth): TrueForgeApi.ConfiguredMcpServerAuth | undefined {
+export function toHarnessAuth(auth: ConnectorAuth): TrueForgeApi.McpServerManifestAuth | undefined {
if (auth.type === 'none') {
return undefined;
}
@@ -71,12 +71,12 @@ export function toUiTool(tool: Record<string, unknown>): ToolBase {
}
export function toUiConnector(server: TrueForgeApi.ConfiguredMcpServer): UiConnector {
- const auth = toUiAuthPublic(server.auth);
+ const auth = toUiAuthPublic(server.manifest.auth);
return {
id: server.name,
name: server.name,
- description: server.description,
- url: server.url,
+ description: server.manifest.description,
+ url: server.manifest.url,
auth,
requiresAuth: server.authStatus.status === 'auth_required',
authenticated: server.authStatus.status !== 'auth_required',
@@ -96,22 +96,16 @@ export function toUiConnectorFromReadEntry(server: TrueForgeApi.McpServerReadEnt
};
}
-export interface HarnessMcpUpsert {
- name: string;
- url: string;
- description: string;
- auth?: TrueForgeApi.ConfiguredMcpServerAuth;
-}
-
export function toHarnessManifest(req: {
name: string;
url: string;
auth: ConnectorAuth;
description?: string;
-}): HarnessMcpUpsert {
+}): TrueForgeApi.McpServerManifest {
const auth = toHarnessAuth(req.auth);
const trimmed = req.description?.trim();
return {
+ type: 'remote',
name: req.name,
url: req.url,
description: trimmed !== undefined && trimmed !== '' ? trimmed : `${req.name} MCP server`,
@@ -152,16 +146,16 @@ export function createConnectorCatalog(
throw new Error('API key is required for header-authenticated MCP servers');
}
const existing = await getConfigured(req.id);
- if (existing.auth?.type !== 'header') {
+ if (existing.manifest.auth?.type !== 'header') {
throw new Error(`MCP server "${req.id}" has no stored header credentials to reuse`);
}
const preferredHeader = req.auth.headerName?.trim();
- const storedHeaderName = Object.keys(existing.auth.headers)[0];
+ const storedHeaderName = Object.keys(existing.manifest.auth.headers)[0];
const headerName =
preferredHeader !== undefined && preferredHeader !== ''
? preferredHeader
: (storedHeaderName ?? DEFAULT_API_KEY_HEADER);
- const stored = existing.auth.headers[headerName] ?? Object.values(existing.auth.headers)[0];
+ const stored = existing.manifest.auth.headers[headerName] ?? Object.values(existing.manifest.auth.headers)[0];
if (stored === undefined) {
throw new Error(`MCP server "${req.id}" has no stored header credentials to reuse`);
}
@@ -199,27 +193,27 @@ export function createConnectorCatalog(
const auth = await resolveWriteAuth({ auth: req.auth });
const catalog = await client.catalog.mcpServers.list();
const preset = catalog.data.find(server => server.name === req.name);
- const body = await client.settings.mcpServers.create(
- toHarnessManifest({
+ const body = await client.settings.mcpServers.create({
+ manifest: toHarnessManifest({
name: req.name,
url: req.url,
auth,
description: preset?.description,
}),
- );
+ });
return toUiConnector(body.data);
},
updateConnector: async req => {
const existing = await getConfigured(req.id);
const auth = await resolveWriteAuth({ id: req.id, auth: req.auth });
- const body = await client.settings.mcpServers.upsert(
- toHarnessManifest({
+ const body = await client.settings.mcpServers.upsert({
+ manifest: toHarnessManifest({
name: req.id,
url: req.url,
auth,
- description: existing.description,
+ description: existing.manifest.description,
}),
- );
+ });
return toUiConnector(body.data);
},
authenticateConnector: async req => {
@@ -231,7 +225,7 @@ export function createConnectorCatalog(
},
disconnectConnector: async req => {
const existing = await getConfigured(req.id);
- if (existing.auth?.type !== 'dcr') {
+ if (existing.manifest.auth?.type !== 'dcr') {
throw new Error(`Disconnect is only supported for OAuth MCP servers`);
}
const body = await client.mcpServers.deleteAuthorize(req.id);
diff --git a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
index b98169982..4637924ea 100644
--- a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
@@ -40,14 +40,13 @@ export function toHarnessModelEntry(model: UiModelEntry): TrueForgeApi.ModelEntr
}
export function toUiModelProvider(provider: TrueForgeApi.ModelProvider): UiModelProvider {
- // Only `custom` carries a name; the API names every other type after its type.
- const name = provider.type === 'custom' ? provider.name : provider.type;
+ const { name, manifest } = provider;
return {
id: name,
- type: provider.type,
+ type: manifest.type,
name,
- ...(provider.baseUrl === undefined ? {} : { baseUrl: provider.baseUrl }),
- models: provider.models.map(toUiModelEntry),
+ ...(manifest.baseUrl === undefined ? {} : { baseUrl: manifest.baseUrl }),
+ models: manifest.models.map(toUiModelEntry),
};
}
@@ -72,7 +71,7 @@ export function toUiCatalogModelProviderEntry(
const PROVIDER_TYPES: readonly string[] = [...Object.values(TrueForgeApi.CatalogWellKnownModelProviderType), 'custom'];
-function isProviderType(type: string): type is TrueForgeApi.ModelProvider['type'] {
+function isProviderType(type: string): type is TrueForgeApi.ModelProviderManifest['type'] {
return PROVIDER_TYPES.includes(type);
}
@@ -82,7 +81,7 @@ export function toHarnessModelProvider(req: {
apiKey: string;
baseUrl?: string;
models: UiModelEntry[];
-}): TrueForgeApi.ModelProvider {
+}): TrueForgeApi.ModelProviderManifest {
const models = req.models.map(toHarnessModelEntry);
if (!isProviderType(req.type)) {
throw new Error(`Unsupported model provider type: ${req.type}`);
@@ -133,11 +132,11 @@ export function createModelProviderCatalog(
}
// Update with empty means keep the stored key.
const listed = await client.settings.modelProviders.list();
- const existing = listed.data.find(provider => toUiModelProvider(provider).id === req.id);
+ const existing = listed.data.find(provider => provider.name === req.id);
if (existing === undefined) {
throw new Error(`Model provider "${req.id}" not found`);
}
- return existing.auth?.apiKey ?? '';
+ return existing.manifest.auth?.apiKey ?? '';
}
return {
@@ -151,29 +150,29 @@ export function createModelProviderCatalog(
},
createModelProvider: async req => {
const apiKey = await resolveApiKey({ type: req.type, apiKey: req.apiKey });
- const body = await client.settings.modelProviders.create(
- toHarnessModelProvider({
+ const body = await client.settings.modelProviders.create({
+ manifest: toHarnessModelProvider({
type: req.type,
name: req.name,
apiKey,
...(req.baseUrl === undefined ? {} : { baseUrl: req.baseUrl }),
models: req.models,
}),
- );
+ });
return toUiModelProvider(body.data);
},
updateModelProvider: async req => {
// UI sends apiKey: "" when only models change; reuse the stored key.
const apiKey = await resolveApiKey({ id: req.id, type: req.type, apiKey: req.apiKey });
- const body = await client.settings.modelProviders.upsert(
- toHarnessModelProvider({
+ const body = await client.settings.modelProviders.upsert({
+ manifest: toHarnessModelProvider({
type: req.type,
name: req.id,
apiKey,
...(req.baseUrl === undefined ? {} : { baseUrl: req.baseUrl }),
models: req.models,
}),
- );
+ });
return toUiModelProvider(body.data);
},
};
diff --git a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
index 38cff65ee..2c8d0ab93 100644
--- a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
@@ -117,8 +117,8 @@ export function createSandboxProviderCatalog(client: TrueForge): SandboxCatalogS
);
},
createSandboxProvider: async req => {
- const body = await client.settings.sandboxProviders.upsert(
- toHarnessManifest({
+ const body = await client.settings.sandboxProviders.upsert({
+ manifest: toHarnessManifest({
type: req.type,
apiKey: req.apiKey,
execTimeoutMs: req.execTimeoutMs,
@@ -126,13 +126,13 @@ export function createSandboxProviderCatalog(client: TrueForge): SandboxCatalogS
autoArchiveIntervalInMinutes: req.autoArchiveIntervalInMinutes,
autoDeleteIntervalInMinutes: req.autoDeleteIntervalInMinutes,
}),
- );
+ });
return toUiSandboxProvider(body.data.manifest);
},
updateSandboxProvider: async req => {
const apiKey = await resolveApiKey(req.apiKey);
- const body = await client.settings.sandboxProviders.upsert(
- toHarnessManifest({
+ const body = await client.settings.sandboxProviders.upsert({
+ manifest: toHarnessManifest({
type: DAYTONA_TYPE,
apiKey,
execTimeoutMs: req.execTimeoutMs,
@@ -140,7 +140,7 @@ export function createSandboxProviderCatalog(client: TrueForge): SandboxCatalogS
autoArchiveIntervalInMinutes: req.autoArchiveIntervalInMinutes,
autoDeleteIntervalInMinutes: req.autoDeleteIntervalInMinutes,
}),
- );
+ });
return toUiSandboxProvider(body.data.manifest);
},
};
diff --git a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.ts b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.ts
index aa299e218..dea80f0f3 100644
--- a/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.ts
+++ b/packages/trueforge-ui-sdk/src/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.ts
@@ -35,11 +35,11 @@ export function toHarnessManifest(req: SkillConfigBase): TrueForgeApi.SkillManif
};
}
-export function toUiSkill(skill: TrueForgeApi.SkillManifest, catalogNames: ReadonlySet<string>): UiSkill {
+export function toUiSkill(skill: TrueForgeApi.ConfiguredSkill, catalogNames: ReadonlySet<string>): UiSkill {
const base = {
id: skill.name,
name: skill.name,
- description: skill.description,
+ description: skill.manifest.description,
};
if (catalogNames.has(skill.name)) {
return { ...base, catalogId: skill.name };
@@ -67,20 +67,20 @@ export function createSkillCatalog(client: TrueForge): SkillCatalogServer<UiSkil
);
},
createSkill: async req => {
- const body = await client.settings.skills.create(toHarnessManifest(req));
+ const body = await client.settings.skills.create({ manifest: toHarnessManifest(req) });
const catalogId = 'catalogId' in req ? req.catalogId : undefined;
if (catalogId !== undefined) {
return {
id: body.data.name,
name: body.data.name,
- description: body.data.description,
+ description: body.data.manifest.description,
catalogId,
};
}
return {
id: body.data.name,
name: body.data.name,
- description: body.data.description,
+ description: body.data.manifest.description,
};
},
};
diff --git a/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.test.ts
index d83346ee8..f22a38f34 100644
--- a/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.test.ts
@@ -60,10 +60,13 @@ describe('connectorCatalog mappers', () => {
it('maps configured servers without embedding tools', () => {
assert.deepEqual(
toUiConnector({
- type: 'remote',
name: 'deepwiki',
- url: 'https://mcp.deepwiki.com/mcp',
- description: 'DeepWiki MCP server.',
+ manifest: {
+ type: 'remote',
+ name: 'deepwiki',
+ url: 'https://mcp.deepwiki.com/mcp',
+ description: 'DeepWiki MCP server.',
+ },
authStatus: { status: 'not_required' },
}),
{
@@ -80,22 +83,28 @@ describe('connectorCatalog mappers', () => {
it('maps auth_required vs authenticated for oauth connectors', () => {
const pending = toUiConnector({
- type: 'remote',
name: 'linear',
- url: 'https://mcp.linear.app/mcp',
- description: 'Linear MCP server.',
- auth: { type: 'dcr' },
+ manifest: {
+ type: 'remote',
+ name: 'linear',
+ url: 'https://mcp.linear.app/mcp',
+ description: 'Linear MCP server.',
+ auth: { type: 'dcr' },
+ },
authStatus: { status: 'auth_required' },
});
assert.equal(pending.authenticated, false);
assert.equal(pending.requiresAuth, true);
const connected = toUiConnector({
- type: 'remote',
name: 'linear',
- url: 'https://mcp.linear.app/mcp',
- description: 'Linear MCP server.',
- auth: { type: 'dcr' },
+ manifest: {
+ type: 'remote',
+ name: 'linear',
+ url: 'https://mcp.linear.app/mcp',
+ description: 'Linear MCP server.',
+ auth: { type: 'dcr' },
+ },
authStatus: { status: 'authenticated' },
});
assert.equal(connected.authenticated, true);
@@ -144,6 +153,7 @@ describe('connectorCatalog mappers', () => {
auth: { type: 'dcr' },
}),
{
+ type: 'remote',
name: 'linear',
url: 'https://mcp.linear.app/mcp',
description: 'linear MCP server',
@@ -157,6 +167,7 @@ describe('connectorCatalog mappers', () => {
auth: { type: 'none' },
}),
{
+ type: 'remote',
name: 'custom-mcp',
url: 'https://example.com/mcp',
description: 'custom-mcp MCP server',
@@ -170,6 +181,7 @@ describe('connectorCatalog mappers', () => {
description: 'Linear MCP server.',
}),
{
+ type: 'remote',
name: 'linear',
url: 'https://mcp.linear.app/mcp',
description: 'Linear MCP server.',
@@ -184,6 +196,7 @@ describe('connectorCatalog mappers', () => {
description: ' ',
}),
{
+ type: 'remote',
name: 'linear',
url: 'https://mcp.linear.app/mcp',
description: 'linear MCP server',
diff --git a/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.test.ts
index bf6c1f129..ba0e204c8 100644
--- a/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.test.ts
@@ -51,7 +51,7 @@ describe('modelProviderCatalog mappers', () => {
],
};
- assert.deepEqual(toUiModelProvider(harness), {
+ assert.deepEqual(toUiModelProvider({ name: 'openai', manifest: harness }), {
id: 'openai',
type: 'openai',
name: 'openai',
@@ -69,11 +69,14 @@ describe('modelProviderCatalog mappers', () => {
it('keeps a custom provider under the name it was given', () => {
assert.deepEqual(
toUiModelProvider({
- type: 'custom' as const,
name: 'local-llama',
- baseUrl: 'http://127.0.0.1:11434/v1',
- auth: { apiKey: 'sk-local' },
- models: [{ modelId: 'llama3', name: 'llama3', properties: {} }],
+ manifest: {
+ type: 'custom' as const,
+ name: 'local-llama',
+ baseUrl: 'http://127.0.0.1:11434/v1',
+ auth: { apiKey: 'sk-local' },
+ models: [{ modelId: 'llama3', name: 'llama3', properties: {} }],
+ },
}),
{
id: 'local-llama',
diff --git a/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.test.ts b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.test.ts
index 0f03a1e55..4cf0b46b5 100644
--- a/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.test.ts
+++ b/packages/trueforge-ui-sdk/test/plugins/trueforge-agent-server-adapter/catalogs/skillCatalog.test.ts
@@ -83,12 +83,15 @@ describe('skillCatalog mappers', () => {
assert.deepEqual(
toUiSkill(
{
- type: 'git',
name: 'algorithmic-art',
- url: 'https://github.com/anthropics/skills',
- path: 'skills/algorithmic-art',
- ref: 'main',
- description: 'Create algorithmic art',
+ manifest: {
+ type: 'git',
+ name: 'algorithmic-art',
+ url: 'https://github.com/anthropics/skills',
+ path: 'skills/algorithmic-art',
+ ref: 'main',
+ description: 'Create algorithmic art',
+ },
},
catalogNames,
),
@@ -102,12 +105,15 @@ describe('skillCatalog mappers', () => {
assert.deepEqual(
toUiSkill(
{
- type: 'git',
name: 'house-style',
- url: 'https://github.com/example/skills',
- path: 'skills/house-style',
- ref: 'main',
- description: 'House style',
+ manifest: {
+ type: 'git',
+ name: 'house-style',
+ url: 'https://github.com/example/skills',
+ path: 'skills/house-style',
+ ref: 'main',
+ description: 'House style',
+ },
},
catalogNames,
),