Skip to content

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

Rename AgentSpec field types and align resource OpenAPI names (#335)

Bhavesh Pateld7a640f3302c
diff --git a/.changeset/20260818211048-agent-spec-type-names.md b/.changeset/20260818211048-agent-spec-type-names.md
new file mode 100644
index 000000000..20715e3ff
--- /dev/null
+++ b/.changeset/20260818211048-agent-spec-type-names.md
@@ -0,0 +1,7 @@
+---
+'@truefoundry/trueforge-core': patch
+'@truefoundry/trueforge': patch
+'@truefoundry/trueforge-ui': patch
+---
+
+Align OpenAPI type names across AgentSpec, settings, catalogs, and chat pickers: Catalog/Configured/Available resource views, AgentSpec nested Model/Skill/InitialUserMessage, Put*Request → Update*Request, MCP acronym casing, GetMeResponse, and explicit names for nested AgentSpec/capabilities schemas.
diff --git a/.github/fern/openapi/openapi.json b/.github/fern/openapi/openapi.json
index f342b9f34..f93d37294 100644
--- a/.github/fern/openapi/openapi.json
+++ b/.github/fern/openapi/openapi.json
@@ -110,14 +110,14 @@
"type": "array"
},
"messages": {
- "description": "Optional seed user messages injected at the start of every session.",
+ "description": "Optional initial user messages injected at the start of every session.",
"items": {
- "$ref": "#/components/schemas/AgentSpecUserMessage"
+ "$ref": "#/components/schemas/InitialUserMessage"
},
"type": "array"
},
"model": {
- "$ref": "#/components/schemas/AgentSpecModel"
+ "$ref": "#/components/schemas/Model"
},
"response_format": {
"$ref": "#/components/schemas/ResponseFormat"
@@ -125,7 +125,7 @@
"skills": {
"description": "Optional name-only skill references. Requires `config.sandbox.enabled: true`.",
"items": {
- "$ref": "#/components/schemas/SkillNameRef"
+ "$ref": "#/components/schemas/Skill"
},
"type": "array"
}
@@ -135,43 +135,6 @@
],
"type": "object"
},
- "AgentSpecModel": {
- "properties": {
- "name": {
- "description": "Model FQN: `provider/model`, e.g. `openai/gpt-5.2`.",
- "minLength": 1,
- "type": "string"
- },
- "params": {
- "$ref": "#/components/schemas/ModelParams"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "AgentSpecUserMessage": {
- "properties": {
- "content": {
- "description": "Seed user message content injected at the start of every session.",
- "minLength": 1,
- "type": "string"
- },
- "type": {
- "description": "Seed message type.",
- "enum": [
- "user.message"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "content"
- ],
- "type": "object"
- },
"AlibabaModelProvider": {
"additionalProperties": false,
"properties": {
@@ -187,7 +150,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -221,7 +184,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -304,6 +267,90 @@
},
"type": "object"
},
+ "AvailableMCPServer": {
+ "additionalProperties": false,
+ "properties": {
+ "auth": {
+ "$ref": "#/components/schemas/MCPServerAuthPublic"
+ },
+ "auth_status": {
+ "$ref": "#/components/schemas/MCPAuthStatus"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ },
+ "url": {
+ "description": "URL of the remote MCP server.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "url",
+ "auth_status"
+ ],
+ "type": "object"
+ },
+ "AvailableModel": {
+ "additionalProperties": false,
+ "properties": {
+ "model_id": {
+ "description": "Upstream, provider-specific identifier sent to the provider API.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Fully qualified name `provider_name/model_name`, e.g. \"openai/gpt-5-6-sol\". Unique within a tenant.",
+ "type": "string"
+ },
+ "properties": {
+ "$ref": "#/components/schemas/ModelProperties"
+ },
+ "provider": {
+ "$ref": "#/components/schemas/AvailableModelProvider"
+ }
+ },
+ "required": [
+ "name",
+ "model_id",
+ "provider",
+ "properties"
+ ],
+ "type": "object"
+ },
+ "AvailableModelProvider": {
+ "additionalProperties": false,
+ "description": "Owning configured provider.",
+ "properties": {
+ "name": {
+ "description": "Configured provider resource name; matches the FQN prefix of `name`.",
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "AvailableSkill": {
+ "additionalProperties": false,
+ "properties": {
+ "description": {
+ "description": "Concise guidance for when the agent should use the skill.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ }
+ },
+ "required": [
+ "name",
+ "description"
+ ],
+ "type": "object"
+ },
"BaseMCPAuthRequiredEvent": {
"properties": {
"created_at": {
@@ -359,6 +406,25 @@
"properties": {},
"type": "object"
},
+ "CapabilitiesData": {
+ "properties": {
+ "sandbox": {
+ "$ref": "#/components/schemas/SandboxCapability"
+ },
+ "settings": {
+ "$ref": "#/components/schemas/SettingsCapability"
+ },
+ "skill": {
+ "$ref": "#/components/schemas/SkillCapability"
+ }
+ },
+ "required": [
+ "sandbox",
+ "skill",
+ "settings"
+ ],
+ "type": "object"
+ },
"CatalogCustomModelProvider": {
"additionalProperties": false,
"properties": {
@@ -382,51 +448,11 @@
],
"type": "object"
},
- "CatalogDaytonaSandboxProvider": {
- "additionalProperties": false,
- "properties": {
- "auto_archive_interval_in_minutes": {
- "description": "Minutes before Daytona auto-archives the sandbox (0 disables).",
- "minimum": 0,
- "type": "integer"
- },
- "auto_delete_interval_in_minutes": {
- "description": "Minutes before Daytona auto-deletes the sandbox (0 disables).",
- "minimum": 0,
- "type": "integer"
- },
- "auto_stop_interval_in_minutes": {
- "description": "Minutes of idle time before Daytona auto-stops the sandbox (0 disables).",
- "minimum": 0,
- "type": "integer"
- },
- "exec_timeout_ms": {
- "description": "Default sandbox command exec timeout in milliseconds.",
- "exclusiveMinimum": 0,
- "type": "integer"
- },
- "type": {
- "description": "Daytona sandbox provider.",
- "enum": [
- "daytona"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "exec_timeout_ms",
- "auto_stop_interval_in_minutes",
- "auto_archive_interval_in_minutes",
- "auto_delete_interval_in_minutes"
- ],
- "type": "object"
- },
- "CatalogMcpServer": {
+ "CatalogMCPServer": {
"additionalProperties": false,
"properties": {
"auth": {
- "$ref": "#/components/schemas/McpServerManifestAuth"
+ "$ref": "#/components/schemas/MCPServerManifestAuth"
},
"description": {
"description": "Concise summary of what this MCP server provides.",
@@ -442,7 +468,7 @@
"$ref": "#/components/schemas/ResourceName"
},
"type": {
- "$ref": "#/components/schemas/McpServerType"
+ "$ref": "#/components/schemas/MCPServerType"
},
"url": {
"description": "URL of the remote MCP server.",
@@ -458,6 +484,28 @@
],
"type": "object"
},
+ "CatalogModel": {
+ "additionalProperties": false,
+ "properties": {
+ "model_id": {
+ "description": "Upstream, provider-specific identifier sent to the provider API.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ },
+ "properties": {
+ "$ref": "#/components/schemas/ModelProperties"
+ }
+ },
+ "required": [
+ "model_id",
+ "name",
+ "properties"
+ ],
+ "type": "object"
+ },
"CatalogModelProvider": {
"anyOf": [
{
@@ -468,6 +516,46 @@
}
]
},
+ "CatalogSandboxProvider": {
+ "additionalProperties": false,
+ "properties": {
+ "auto_archive_interval_in_minutes": {
+ "description": "Minutes before Daytona auto-archives the sandbox (0 disables).",
+ "minimum": 0,
+ "type": "integer"
+ },
+ "auto_delete_interval_in_minutes": {
+ "description": "Minutes before Daytona auto-deletes the sandbox (0 disables).",
+ "minimum": 0,
+ "type": "integer"
+ },
+ "auto_stop_interval_in_minutes": {
+ "description": "Minutes of idle time before Daytona auto-stops the sandbox (0 disables).",
+ "minimum": 0,
+ "type": "integer"
+ },
+ "exec_timeout_ms": {
+ "description": "Default sandbox command exec timeout in milliseconds.",
+ "exclusiveMinimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "description": "Daytona sandbox provider.",
+ "enum": [
+ "daytona"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "exec_timeout_ms",
+ "auto_stop_interval_in_minutes",
+ "auto_archive_interval_in_minutes",
+ "auto_delete_interval_in_minutes"
+ ],
+ "type": "object"
+ },
"CatalogSkill": {
"additionalProperties": false,
"properties": {
@@ -521,7 +609,7 @@
"models": {
"description": "Preset models",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/CatalogModel"
},
"type": "array"
},
@@ -663,14 +751,32 @@
],
"type": "object"
},
- "ConfiguredMcpServer": {
+ "CompactionConfig": {
+ "default": {
+ "enabled": true
+ },
+ "properties": {
+ "compaction_threshold_tokens": {
+ "description": "Context size in tokens that triggers compaction. Default: 50000.",
+ "exclusiveMinimum": 0,
+ "type": "integer"
+ },
+ "enabled": {
+ "default": true,
+ "description": "Summarize older history when context grows too large. Default: true.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "ConfiguredMCPServer": {
"additionalProperties": false,
"properties": {
"auth_status": {
- "$ref": "#/components/schemas/McpAuthStatus"
+ "$ref": "#/components/schemas/MCPAuthStatus"
},
"manifest": {
- "$ref": "#/components/schemas/McpServerManifest"
+ "$ref": "#/components/schemas/MCPServerManifest"
},
"name": {
"$ref": "#/components/schemas/ResourceName"
@@ -683,49 +789,96 @@
],
"type": "object"
},
- "ConfiguredSkill": {
+ "ConfiguredModel": {
"additionalProperties": false,
"properties": {
- "manifest": {
- "$ref": "#/components/schemas/SkillManifest"
+ "model_id": {
+ "description": "Upstream, provider-specific identifier sent to the provider API.",
+ "minLength": 1,
+ "type": "string"
},
"name": {
"$ref": "#/components/schemas/ResourceName"
+ },
+ "properties": {
+ "$ref": "#/components/schemas/ModelProperties"
}
},
"required": [
+ "model_id",
"name",
- "manifest"
+ "properties"
],
"type": "object"
},
- "ContextManagementConfig": {
- "default": {
- "compaction": {
- "enabled": true
- },
- "large_tool_response": {
- "enabled": true
- }
- },
+ "ConfiguredModelProvider": {
+ "additionalProperties": false,
"properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/ModelProviderManifest"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ }
+ },
+ "required": [
+ "name",
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "ConfiguredSandboxProvider": {
+ "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"
+ },
+ "ConfiguredSkill": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SkillManifest"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ }
+ },
+ "required": [
+ "name",
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "ContextManagementConfig": {
+ "default": {
"compaction": {
- "default": {
- "enabled": true
- },
- "properties": {
- "compaction_threshold_tokens": {
- "description": "Context size in tokens that triggers compaction. Default: 50000.",
- "exclusiveMinimum": 0,
- "type": "integer"
- },
- "enabled": {
- "default": true,
- "description": "Summarize older history when context grows too large. Default: true.",
- "type": "boolean"
- }
- },
- "type": "object"
+ "enabled": true
+ },
+ "large_tool_response": {
+ "enabled": true
+ }
+ },
+ "properties": {
+ "compaction": {
+ "$ref": "#/components/schemas/CompactionConfig"
},
"large_tool_response": {
"$ref": "#/components/schemas/LargeToolResponseConfig"
@@ -749,11 +902,11 @@
],
"type": "object"
},
- "CreateMcpServerRequest": {
+ "CreateMCPServerRequest": {
"additionalProperties": false,
"properties": {
"manifest": {
- "$ref": "#/components/schemas/McpServerManifest"
+ "$ref": "#/components/schemas/MCPServerManifest"
}
},
"required": [
@@ -841,7 +994,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -966,7 +1119,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -1012,54 +1165,7 @@
"GetCapabilitiesResponse": {
"properties": {
"data": {
- "properties": {
- "sandbox": {
- "properties": {
- "enabled": {
- "description": "Whether a sandbox provider is configured for this tenant.",
- "type": "boolean"
- }
- },
- "required": [
- "enabled"
- ],
- "type": "object"
- },
- "settings": {
- "properties": {
- "enabled": {
- "description": "Whether the settings UI/API is enabled.",
- "type": "boolean"
- }
- },
- "required": [
- "enabled"
- ],
- "type": "object"
- },
- "skill": {
- "properties": {
- "enabled": {
- "description": "Whether skills are available. False when sandbox is not enabled (skills require a sandbox).",
- "type": "boolean"
- },
- "reason": {
- "description": "Present when skills are disabled. Explains why.",
- "type": "string"
- }
- },
- "required": [
- "enabled"
- ],
- "type": "object"
- }
- },
- "required": [
- "sandbox",
- "skill",
- "settings"
- ],
- "type": "object"
+ "$ref": "#/components/schemas/CapabilitiesData"
}
},
"required": [
@@ -1067,11 +1173,11 @@
],
"type": "object"
},
- "GetMcpServerCatalogResponse": {
+ "GetMCPServerCatalogResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/CatalogMcpServer"
+ "$ref": "#/components/schemas/CatalogMCPServer"
},
"type": "array"
}
@@ -1081,10 +1187,10 @@
],
"type": "object"
},
- "GetMcpServerResponse": {
+ "GetMCPServerResponse": {
"properties": {
"data": {
- "$ref": "#/components/schemas/ConfiguredMcpServer"
+ "$ref": "#/components/schemas/ConfiguredMCPServer"
}
},
"required": [
@@ -1092,6 +1198,32 @@
],
"type": "object"
},
+ "GetMeResponse": {
+ "properties": {
+ "email": {
+ "description": "User email from the ID token when connected; `\"default\"` when anonymous.",
+ "type": "string"
+ },
+ "role": {
+ "description": "Caller role.",
+ "type": "string"
+ },
+ "type": {
+ "description": "Session kind: `default` when no valid OIDC session; `oidc-connected` after a successful browser login.",
+ "enum": [
+ "default",
+ "oidc-connected"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "email",
+ "role"
+ ],
+ "type": "object"
+ },
"GetModelProviderCatalogResponse": {
"properties": {
"data": {
@@ -1109,7 +1241,7 @@
"GetModelProviderResponse": {
"properties": {
"data": {
- "$ref": "#/components/schemas/ModelProvider"
+ "$ref": "#/components/schemas/ConfiguredModelProvider"
}
},
"required": [
@@ -1121,7 +1253,7 @@
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/CatalogDaytonaSandboxProvider"
+ "$ref": "#/components/schemas/CatalogSandboxProvider"
},
"type": "array"
}
@@ -1134,7 +1266,7 @@
"GetSandboxProviderResponse": {
"properties": {
"data": {
- "$ref": "#/components/schemas/SandboxProvider"
+ "$ref": "#/components/schemas/ConfiguredSandboxProvider"
}
},
"required": [
@@ -1204,7 +1336,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -1223,6 +1355,27 @@
],
"type": "object"
},
+ "InitialUserMessage": {
+ "properties": {
+ "content": {
+ "description": "Initial user message content injected at the start of every session.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": {
+ "description": "Initial message type.",
+ "enum": [
+ "user.message"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "content"
+ ],
+ "type": "object"
+ },
"LargeToolResponseConfig": {
"default": {
"enabled": true
@@ -1250,11 +1403,11 @@
],
"type": "object"
},
- "ListAvailableMcpServersResponse": {
+ "ListAvailableMCPServersResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/McpServerReadEntry"
+ "$ref": "#/components/schemas/AvailableMCPServer"
},
"type": "array"
}
@@ -1264,11 +1417,11 @@
],
"type": "object"
},
- "ListAvailableSkillsResponse": {
+ "ListAvailableModelsResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/SkillReadEntry"
+ "$ref": "#/components/schemas/AvailableModel"
},
"type": "array"
}
@@ -1278,13 +1431,11 @@
],
"type": "object"
},
- "ListMcpServerToolsResponse": {
+ "ListAvailableSkillsResponse": {
"properties": {
"data": {
- "description": "MCP `tools/list` entries, passed through verbatim from the MCP server.",
"items": {
- "additionalProperties": {},
- "type": "object"
+ "$ref": "#/components/schemas/AvailableSkill"
},
"type": "array"
}
@@ -1294,11 +1445,13 @@
],
"type": "object"
},
- "ListMcpServersResponse": {
+ "ListMCPServerToolsResponse": {
"properties": {
"data": {
+ "description": "MCP `tools/list` entries, passed through verbatim from the MCP server.",
"items": {
- "$ref": "#/components/schemas/ConfiguredMcpServer"
+ "additionalProperties": {},
+ "type": "object"
},
"type": "array"
}
@@ -1308,11 +1461,11 @@
],
"type": "object"
},
- "ListModelProvidersResponse": {
+ "ListMCPServersResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/ModelProvider"
+ "$ref": "#/components/schemas/ConfiguredMCPServer"
},
"type": "array"
}
@@ -1322,11 +1475,11 @@
],
"type": "object"
},
- "ListModelsResponse": {
+ "ListModelProvidersResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/Model"
+ "$ref": "#/components/schemas/ConfiguredModelProvider"
},
"type": "array"
}
@@ -1470,6 +1623,30 @@
}
]
},
+ "MCPAuthStatus": {
+ "additionalProperties": false,
+ "description": "Current auth state.",
+ "properties": {
+ "authorization_url": {
+ "description": "When auth is required, this contains the URL to redirect the user to for authorization.",
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "description": "Current auth state for this MCP server.",
+ "enum": [
+ "authenticated",
+ "auth_required",
+ "not_required"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
"MCPInitializeEvent": {
"properties": {
"created_at": {
@@ -1514,19 +1691,7 @@
"default": [],
"description": "Tools subtracted from the enabled set. Default: none.",
"items": {
- "anyOf": [
- {
- "enum": [
- "@all",
- "@read-only"
- ],
- "type": "string"
- },
- {
- "minLength": 1,
- "type": "string"
- }
- ]
+ "$ref": "#/components/schemas/MCPServerToolSelector"
},
"type": "array"
},
@@ -1536,19 +1701,7 @@
],
"description": "Tools exposed to the agent: `@all`, `@read-only`, or literal tool names. Default: `[\"@all\"]`.",
"items": {
- "anyOf": [
- {
- "enum": [
- "@all",
- "@read-only"
- ],
- "type": "string"
- },
- {
- "minLength": 1,
- "type": "string"
- }
- ]
+ "$ref": "#/components/schemas/MCPServerToolSelector"
},
"type": "array"
},
@@ -1566,19 +1719,7 @@
"default": [],
"description": "Tools loaded eagerly into context while the rest stay deferred. A non-empty list implies `preload: false`.",
"items": {
- "anyOf": [
- {
- "enum": [
- "@all",
- "@read-only"
- ],
- "type": "string"
- },
- {
- "minLength": 1,
- "type": "string"
- }
- ]
+ "$ref": "#/components/schemas/MCPServerToolSelector"
},
"type": "array"
},
@@ -1589,20 +1730,7 @@
],
"description": "Tools that pause for human approval: `@all`, `@write`, `@destructive`, or literal names. Default: `[\"@write\", \"@destructive\"]`.",
"items": {
- "anyOf": [
- {
- "enum": [
- "@all",
- "@write",
- "@destructive"
- ],
- "type": "string"
- },
- {
- "minLength": 1,
- "type": "string"
- }
- ]
+ "$ref": "#/components/schemas/MCPServerApprovalToolSelector"
},
"type": "array"
}
@@ -1612,6 +1740,22 @@
],
"type": "object"
},
+ "MCPServerApprovalToolSelector": {
+ "anyOf": [
+ {
+ "enum": [
+ "@all",
+ "@write",
+ "@destructive"
+ ],
+ "type": "string"
+ },
+ {
+ "minLength": 1,
+ "type": "string"
+ }
+ ]
+ },
"MCPServerAuthInfo": {
"properties": {
"auth_url": {
@@ -1634,90 +1778,7 @@
],
"type": "object"
},
- "MCPServerInitInfo": {
- "properties": {
- "id": {
- "description": "Internal MCP server id.",
- "type": "string"
- },
- "name": {
- "description": "Configured MCP server name.",
- "type": "string"
- },
- "session_id": {
- "description": "Optional MCP session id from the transport.",
- "type": "string"
- },
- "transport_type": {
- "description": "Transport used to connect to the MCP server.",
- "enum": [
- "streamable-http",
- "sse"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "name"
- ],
- "type": "object"
- },
- "MCPToolInfo": {
- "properties": {
- "name": {
- "description": "Tool name on the MCP server.",
- "type": "string"
- },
- "server_id": {
- "description": "Internal MCP server id.",
- "type": "string"
- },
- "server_name": {
- "description": "Configured MCP server name.",
- "type": "string"
- },
- "type": {
- "description": "Tool hosted on an MCP server.",
- "enum": [
- "mcp"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "server_id",
- "server_name",
- "name"
- ],
- "type": "object"
- },
- "McpAuthStatus": {
- "additionalProperties": false,
- "description": "Current auth state.",
- "properties": {
- "authorization_url": {
- "description": "When auth is required, this contains the URL to redirect the user to for authorization.",
- "format": "uri",
- "type": "string"
- },
- "status": {
- "description": "Current auth state for this MCP server.",
- "enum": [
- "authenticated",
- "auth_required",
- "not_required"
- ],
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- "McpServerAuthPublic": {
+ "MCPServerAuthPublic": {
"description": "Auth mechanism when configured (no secrets). Omit when the server needs no credentials.",
"oneOf": [
{
@@ -1752,7 +1813,7 @@
}
]
},
- "McpServerDcrAuth": {
+ "MCPServerDcrAuth": {
"additionalProperties": false,
"properties": {
"type": {
@@ -1768,7 +1829,7 @@
],
"type": "object"
},
- "McpServerHeaderAuth": {
+ "MCPServerHeaderAuth": {
"additionalProperties": false,
"properties": {
"headers": {
@@ -1793,11 +1854,40 @@
],
"type": "object"
},
- "McpServerManifest": {
+ "MCPServerInitInfo": {
+ "properties": {
+ "id": {
+ "description": "Internal MCP server id.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Configured MCP server name.",
+ "type": "string"
+ },
+ "session_id": {
+ "description": "Optional MCP session id from the transport.",
+ "type": "string"
+ },
+ "transport_type": {
+ "description": "Transport used to connect to the MCP server.",
+ "enum": [
+ "streamable-http",
+ "sse"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "name"
+ ],
+ "type": "object"
+ },
+ "MCPServerManifest": {
"additionalProperties": false,
"properties": {
"auth": {
- "$ref": "#/components/schemas/McpServerManifestAuth"
+ "$ref": "#/components/schemas/MCPServerManifestAuth"
},
"description": {
"description": "Concise summary of what this MCP server provides.",
@@ -1808,7 +1898,7 @@
"$ref": "#/components/schemas/ResourceName"
},
"type": {
- "$ref": "#/components/schemas/McpServerType"
+ "$ref": "#/components/schemas/MCPServerType"
},
"url": {
"description": "URL of the remote MCP server.",
@@ -1824,137 +1914,84 @@
],
"type": "object"
},
- "McpServerManifestAuth": {
+ "MCPServerManifestAuth": {
"description": "Optional auth settings. Omit when the server needs no credentials.",
"discriminator": {
"mapping": {
- "dcr": "#/components/schemas/McpServerDcrAuth",
- "header": "#/components/schemas/McpServerHeaderAuth"
+ "dcr": "#/components/schemas/MCPServerDcrAuth",
+ "header": "#/components/schemas/MCPServerHeaderAuth"
},
"propertyName": "type"
},
"oneOf": [
{
- "$ref": "#/components/schemas/McpServerHeaderAuth"
+ "$ref": "#/components/schemas/MCPServerHeaderAuth"
},
{
- "$ref": "#/components/schemas/McpServerDcrAuth"
+ "$ref": "#/components/schemas/MCPServerDcrAuth"
}
]
},
- "McpServerReadEntry": {
- "additionalProperties": false,
- "properties": {
- "auth": {
- "$ref": "#/components/schemas/McpServerAuthPublic"
- },
- "auth_status": {
- "$ref": "#/components/schemas/McpAuthStatus"
- },
- "name": {
- "$ref": "#/components/schemas/ResourceName"
+ "MCPServerToolSelector": {
+ "anyOf": [
+ {
+ "enum": [
+ "@all",
+ "@read-only"
+ ],
+ "type": "string"
},
- "url": {
- "description": "URL of the remote MCP server.",
- "format": "uri",
+ {
+ "minLength": 1,
"type": "string"
}
- },
- "required": [
- "name",
- "url",
- "auth_status"
- ],
- "type": "object"
+ ]
},
- "McpServerType": {
+ "MCPServerType": {
"enum": [
"remote"
],
"type": "string"
},
- "MeResponse": {
- "properties": {
- "email": {
- "description": "User email from the ID token when connected; `\"default\"` when anonymous.",
- "type": "string"
- },
- "role": {
- "description": "Caller role.",
- "type": "string"
- },
- "type": {
- "description": "Session kind: `default` when no valid OIDC session; `oidc-connected` after a successful browser login.",
- "enum": [
- "default",
- "oidc-connected"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "email",
- "role"
- ],
- "type": "object"
- },
- "Model": {
- "additionalProperties": false,
+ "MCPToolInfo": {
"properties": {
- "model_id": {
- "description": "Upstream, provider-specific identifier sent to the provider API.",
- "type": "string"
- },
"name": {
- "description": "Fully qualified name `provider_name/model_name`, e.g. \"openai/gpt-5-6-sol\". Unique within a tenant.",
+ "description": "Tool name on the MCP server.",
"type": "string"
},
- "properties": {
- "$ref": "#/components/schemas/ModelProperties"
- },
- "provider": {
- "$ref": "#/components/schemas/ModelListProvider"
- }
- },
- "required": [
- "name",
- "model_id",
- "provider",
- "properties"
- ],
- "type": "object"
- },
- "ModelEntry": {
- "additionalProperties": false,
- "properties": {
- "model_id": {
- "description": "Upstream, provider-specific identifier sent to the provider API.",
- "minLength": 1,
+ "server_id": {
+ "description": "Internal MCP server id.",
"type": "string"
},
- "name": {
- "$ref": "#/components/schemas/ResourceName"
+ "server_name": {
+ "description": "Configured MCP server name.",
+ "type": "string"
},
- "properties": {
- "$ref": "#/components/schemas/ModelProperties"
+ "type": {
+ "description": "Tool hosted on an MCP server.",
+ "enum": [
+ "mcp"
+ ],
+ "type": "string"
}
},
"required": [
- "model_id",
- "name",
- "properties"
+ "type",
+ "server_id",
+ "server_name",
+ "name"
],
"type": "object"
},
- "ModelListProvider": {
- "additionalProperties": false,
- "description": "Owning configured provider.",
+ "Model": {
"properties": {
"name": {
- "description": "Configured provider resource name; matches the FQN prefix of `name`.",
+ "description": "Model FQN: `provider/model`, e.g. `openai/gpt-5.2`.",
"minLength": 1,
"type": "string"
+ },
+ "params": {
+ "$ref": "#/components/schemas/ModelParams"
}
},
"required": [
@@ -2239,22 +2276,6 @@
},
"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.",
@@ -2330,7 +2351,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -2364,7 +2385,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -2405,66 +2426,6 @@
"default": "auto",
"description": "Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn."
},
- "PutAgentRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/AgentSpec"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
- "PutMcpServerRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/McpServerManifest"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
- "PutModelProviderRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/ModelProviderManifest"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
- "PutSandboxProviderRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/SandboxProviderManifest"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
- "PutSkillRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/SkillManifest"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
"RawToolCall": {
"allOf": [
{
@@ -2700,6 +2661,18 @@
],
"type": "string"
},
+ "SandboxCapability": {
+ "properties": {
+ "enabled": {
+ "description": "Whether a sandbox provider is configured for this tenant.",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "enabled"
+ ],
+ "type": "object"
+ },
"SandboxConfig": {
"default": {
"enabled": false,
@@ -2759,30 +2732,6 @@
],
"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": {
@@ -3026,6 +2975,50 @@
],
"type": "object"
},
+ "SettingsCapability": {
+ "properties": {
+ "enabled": {
+ "description": "Whether the settings UI/API is enabled.",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "enabled"
+ ],
+ "type": "object"
+ },
+ "Skill": {
+ "additionalProperties": false,
+ "properties": {
+ "name": {
+ "description": "Name of a configured skill (also used as the skill directory name in the sandbox).",
+ "maxLength": 64,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9._-]+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "SkillCapability": {
+ "properties": {
+ "enabled": {
+ "description": "Whether skills are available. False when sandbox is not enabled (skills require a sandbox).",
+ "type": "boolean"
+ },
+ "reason": {
+ "description": "Present when skills are disabled. Explains why.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "enabled"
+ ],
+ "type": "object"
+ },
"SkillManifest": {
"additionalProperties": false,
"properties": {
@@ -3068,40 +3061,6 @@
],
"type": "object"
},
- "SkillNameRef": {
- "additionalProperties": false,
- "properties": {
- "name": {
- "description": "Name of a configured skill (also used as the skill directory name in the sandbox).",
- "maxLength": 64,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9._-]+$",
- "type": "string"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "SkillReadEntry": {
- "additionalProperties": false,
- "properties": {
- "description": {
- "description": "Concise guidance for when the agent should use the skill.",
- "minLength": 1,
- "type": "string"
- },
- "name": {
- "$ref": "#/components/schemas/ResourceName"
- }
- },
- "required": [
- "name",
- "description"
- ],
- "type": "object"
- },
"SkillType": {
"enum": [
"git"
@@ -3281,7 +3240,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -3943,6 +3902,54 @@
}
]
},
+ "UpdateAgentRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/AgentSpec"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "UpdateMCPServerRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/MCPServerManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "UpdateModelProviderRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/ModelProviderManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "UpdateSandboxProviderRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SandboxProviderManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
"UpdateSessionRequest": {
"additionalProperties": false,
"properties": {
@@ -3952,6 +3959,18 @@
},
"type": "object"
},
+ "UpdateSkillRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SkillManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
"UserMessage": {
"properties": {
"content": {
@@ -4078,7 +4097,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -4327,7 +4346,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutAgentRequest"
+ "$ref": "#/components/schemas/UpdateAgentRequest"
}
}
},
@@ -4497,7 +4516,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/MeResponse"
+ "$ref": "#/components/schemas/GetMeResponse"
}
}
},
@@ -4567,7 +4586,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerCatalogResponse"
+ "$ref": "#/components/schemas/GetMCPServerCatalogResponse"
}
}
},
@@ -4711,7 +4730,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListAvailableMcpServersResponse"
+ "$ref": "#/components/schemas/ListAvailableMCPServersResponse"
}
}
},
@@ -4861,7 +4880,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerResponse"
+ "$ref": "#/components/schemas/GetMCPServerResponse"
}
}
},
@@ -4917,7 +4936,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/McpAuthStatus"
+ "$ref": "#/components/schemas/MCPAuthStatus"
}
}
},
@@ -5005,7 +5024,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListMcpServerToolsResponse"
+ "$ref": "#/components/schemas/ListMCPServerToolsResponse"
}
}
},
@@ -5064,17 +5083,17 @@
},
"/api/v1/models": {
"get": {
- "description": "Models across all configured model providers, addressed by fully qualified name `name/model_name`.",
+ "description": "Configured models as a slim FQN list for the composer.",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListModelsResponse"
+ "$ref": "#/components/schemas/ListAvailableModelsResponse"
}
}
},
- "description": "All models of all configured providers."
+ "description": "All configured models (chat projection)."
},
"401": {
"content": {
@@ -5087,7 +5106,7 @@
"description": "OIDC is configured and the request has no valid session cookie."
}
},
- "summary": "List models",
+ "summary": "List models for chat",
"tags": [
"Models"
],
@@ -6295,7 +6314,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListMcpServersResponse"
+ "$ref": "#/components/schemas/ListMCPServersResponse"
}
}
},
@@ -6338,7 +6357,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CreateMcpServerRequest"
+ "$ref": "#/components/schemas/CreateMCPServerRequest"
}
}
},
@@ -6349,7 +6368,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerResponse"
+ "$ref": "#/components/schemas/GetMCPServerResponse"
}
}
},
@@ -6402,7 +6421,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutMcpServerRequest"
+ "$ref": "#/components/schemas/UpdateMCPServerRequest"
}
}
},
@@ -6413,7 +6432,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerResponse"
+ "$ref": "#/components/schemas/GetMCPServerResponse"
}
}
},
@@ -6472,7 +6491,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerResponse"
+ "$ref": "#/components/schemas/GetMCPServerResponse"
}
}
},
@@ -6605,7 +6624,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutModelProviderRequest"
+ "$ref": "#/components/schemas/UpdateModelProviderRequest"
}
}
},
@@ -6685,7 +6704,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutSandboxProviderRequest"
+ "$ref": "#/components/schemas/UpdateSandboxProviderRequest"
}
}
},
@@ -6839,7 +6858,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutSkillRequest"
+ "$ref": "#/components/schemas/UpdateSkillRequest"
}
}
},
diff --git a/docs/openapi.json b/docs/openapi.json
index f342b9f34..f93d37294 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -110,14 +110,14 @@
"type": "array"
},
"messages": {
- "description": "Optional seed user messages injected at the start of every session.",
+ "description": "Optional initial user messages injected at the start of every session.",
"items": {
- "$ref": "#/components/schemas/AgentSpecUserMessage"
+ "$ref": "#/components/schemas/InitialUserMessage"
},
"type": "array"
},
"model": {
- "$ref": "#/components/schemas/AgentSpecModel"
+ "$ref": "#/components/schemas/Model"
},
"response_format": {
"$ref": "#/components/schemas/ResponseFormat"
@@ -125,7 +125,7 @@
"skills": {
"description": "Optional name-only skill references. Requires `config.sandbox.enabled: true`.",
"items": {
- "$ref": "#/components/schemas/SkillNameRef"
+ "$ref": "#/components/schemas/Skill"
},
"type": "array"
}
@@ -135,43 +135,6 @@
],
"type": "object"
},
- "AgentSpecModel": {
- "properties": {
- "name": {
- "description": "Model FQN: `provider/model`, e.g. `openai/gpt-5.2`.",
- "minLength": 1,
- "type": "string"
- },
- "params": {
- "$ref": "#/components/schemas/ModelParams"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "AgentSpecUserMessage": {
- "properties": {
- "content": {
- "description": "Seed user message content injected at the start of every session.",
- "minLength": 1,
- "type": "string"
- },
- "type": {
- "description": "Seed message type.",
- "enum": [
- "user.message"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "content"
- ],
- "type": "object"
- },
"AlibabaModelProvider": {
"additionalProperties": false,
"properties": {
@@ -187,7 +150,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -221,7 +184,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -304,6 +267,90 @@
},
"type": "object"
},
+ "AvailableMCPServer": {
+ "additionalProperties": false,
+ "properties": {
+ "auth": {
+ "$ref": "#/components/schemas/MCPServerAuthPublic"
+ },
+ "auth_status": {
+ "$ref": "#/components/schemas/MCPAuthStatus"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ },
+ "url": {
+ "description": "URL of the remote MCP server.",
+ "format": "uri",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name",
+ "url",
+ "auth_status"
+ ],
+ "type": "object"
+ },
+ "AvailableModel": {
+ "additionalProperties": false,
+ "properties": {
+ "model_id": {
+ "description": "Upstream, provider-specific identifier sent to the provider API.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Fully qualified name `provider_name/model_name`, e.g. \"openai/gpt-5-6-sol\". Unique within a tenant.",
+ "type": "string"
+ },
+ "properties": {
+ "$ref": "#/components/schemas/ModelProperties"
+ },
+ "provider": {
+ "$ref": "#/components/schemas/AvailableModelProvider"
+ }
+ },
+ "required": [
+ "name",
+ "model_id",
+ "provider",
+ "properties"
+ ],
+ "type": "object"
+ },
+ "AvailableModelProvider": {
+ "additionalProperties": false,
+ "description": "Owning configured provider.",
+ "properties": {
+ "name": {
+ "description": "Configured provider resource name; matches the FQN prefix of `name`.",
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "AvailableSkill": {
+ "additionalProperties": false,
+ "properties": {
+ "description": {
+ "description": "Concise guidance for when the agent should use the skill.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ }
+ },
+ "required": [
+ "name",
+ "description"
+ ],
+ "type": "object"
+ },
"BaseMCPAuthRequiredEvent": {
"properties": {
"created_at": {
@@ -359,6 +406,25 @@
"properties": {},
"type": "object"
},
+ "CapabilitiesData": {
+ "properties": {
+ "sandbox": {
+ "$ref": "#/components/schemas/SandboxCapability"
+ },
+ "settings": {
+ "$ref": "#/components/schemas/SettingsCapability"
+ },
+ "skill": {
+ "$ref": "#/components/schemas/SkillCapability"
+ }
+ },
+ "required": [
+ "sandbox",
+ "skill",
+ "settings"
+ ],
+ "type": "object"
+ },
"CatalogCustomModelProvider": {
"additionalProperties": false,
"properties": {
@@ -382,51 +448,11 @@
],
"type": "object"
},
- "CatalogDaytonaSandboxProvider": {
- "additionalProperties": false,
- "properties": {
- "auto_archive_interval_in_minutes": {
- "description": "Minutes before Daytona auto-archives the sandbox (0 disables).",
- "minimum": 0,
- "type": "integer"
- },
- "auto_delete_interval_in_minutes": {
- "description": "Minutes before Daytona auto-deletes the sandbox (0 disables).",
- "minimum": 0,
- "type": "integer"
- },
- "auto_stop_interval_in_minutes": {
- "description": "Minutes of idle time before Daytona auto-stops the sandbox (0 disables).",
- "minimum": 0,
- "type": "integer"
- },
- "exec_timeout_ms": {
- "description": "Default sandbox command exec timeout in milliseconds.",
- "exclusiveMinimum": 0,
- "type": "integer"
- },
- "type": {
- "description": "Daytona sandbox provider.",
- "enum": [
- "daytona"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "exec_timeout_ms",
- "auto_stop_interval_in_minutes",
- "auto_archive_interval_in_minutes",
- "auto_delete_interval_in_minutes"
- ],
- "type": "object"
- },
- "CatalogMcpServer": {
+ "CatalogMCPServer": {
"additionalProperties": false,
"properties": {
"auth": {
- "$ref": "#/components/schemas/McpServerManifestAuth"
+ "$ref": "#/components/schemas/MCPServerManifestAuth"
},
"description": {
"description": "Concise summary of what this MCP server provides.",
@@ -442,7 +468,7 @@
"$ref": "#/components/schemas/ResourceName"
},
"type": {
- "$ref": "#/components/schemas/McpServerType"
+ "$ref": "#/components/schemas/MCPServerType"
},
"url": {
"description": "URL of the remote MCP server.",
@@ -458,6 +484,28 @@
],
"type": "object"
},
+ "CatalogModel": {
+ "additionalProperties": false,
+ "properties": {
+ "model_id": {
+ "description": "Upstream, provider-specific identifier sent to the provider API.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ },
+ "properties": {
+ "$ref": "#/components/schemas/ModelProperties"
+ }
+ },
+ "required": [
+ "model_id",
+ "name",
+ "properties"
+ ],
+ "type": "object"
+ },
"CatalogModelProvider": {
"anyOf": [
{
@@ -468,6 +516,46 @@
}
]
},
+ "CatalogSandboxProvider": {
+ "additionalProperties": false,
+ "properties": {
+ "auto_archive_interval_in_minutes": {
+ "description": "Minutes before Daytona auto-archives the sandbox (0 disables).",
+ "minimum": 0,
+ "type": "integer"
+ },
+ "auto_delete_interval_in_minutes": {
+ "description": "Minutes before Daytona auto-deletes the sandbox (0 disables).",
+ "minimum": 0,
+ "type": "integer"
+ },
+ "auto_stop_interval_in_minutes": {
+ "description": "Minutes of idle time before Daytona auto-stops the sandbox (0 disables).",
+ "minimum": 0,
+ "type": "integer"
+ },
+ "exec_timeout_ms": {
+ "description": "Default sandbox command exec timeout in milliseconds.",
+ "exclusiveMinimum": 0,
+ "type": "integer"
+ },
+ "type": {
+ "description": "Daytona sandbox provider.",
+ "enum": [
+ "daytona"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "exec_timeout_ms",
+ "auto_stop_interval_in_minutes",
+ "auto_archive_interval_in_minutes",
+ "auto_delete_interval_in_minutes"
+ ],
+ "type": "object"
+ },
"CatalogSkill": {
"additionalProperties": false,
"properties": {
@@ -521,7 +609,7 @@
"models": {
"description": "Preset models",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/CatalogModel"
},
"type": "array"
},
@@ -663,14 +751,32 @@
],
"type": "object"
},
- "ConfiguredMcpServer": {
+ "CompactionConfig": {
+ "default": {
+ "enabled": true
+ },
+ "properties": {
+ "compaction_threshold_tokens": {
+ "description": "Context size in tokens that triggers compaction. Default: 50000.",
+ "exclusiveMinimum": 0,
+ "type": "integer"
+ },
+ "enabled": {
+ "default": true,
+ "description": "Summarize older history when context grows too large. Default: true.",
+ "type": "boolean"
+ }
+ },
+ "type": "object"
+ },
+ "ConfiguredMCPServer": {
"additionalProperties": false,
"properties": {
"auth_status": {
- "$ref": "#/components/schemas/McpAuthStatus"
+ "$ref": "#/components/schemas/MCPAuthStatus"
},
"manifest": {
- "$ref": "#/components/schemas/McpServerManifest"
+ "$ref": "#/components/schemas/MCPServerManifest"
},
"name": {
"$ref": "#/components/schemas/ResourceName"
@@ -683,49 +789,96 @@
],
"type": "object"
},
- "ConfiguredSkill": {
+ "ConfiguredModel": {
"additionalProperties": false,
"properties": {
- "manifest": {
- "$ref": "#/components/schemas/SkillManifest"
+ "model_id": {
+ "description": "Upstream, provider-specific identifier sent to the provider API.",
+ "minLength": 1,
+ "type": "string"
},
"name": {
"$ref": "#/components/schemas/ResourceName"
+ },
+ "properties": {
+ "$ref": "#/components/schemas/ModelProperties"
}
},
"required": [
+ "model_id",
"name",
- "manifest"
+ "properties"
],
"type": "object"
},
- "ContextManagementConfig": {
- "default": {
- "compaction": {
- "enabled": true
- },
- "large_tool_response": {
- "enabled": true
- }
- },
+ "ConfiguredModelProvider": {
+ "additionalProperties": false,
"properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/ModelProviderManifest"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ }
+ },
+ "required": [
+ "name",
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "ConfiguredSandboxProvider": {
+ "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"
+ },
+ "ConfiguredSkill": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SkillManifest"
+ },
+ "name": {
+ "$ref": "#/components/schemas/ResourceName"
+ }
+ },
+ "required": [
+ "name",
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "ContextManagementConfig": {
+ "default": {
"compaction": {
- "default": {
- "enabled": true
- },
- "properties": {
- "compaction_threshold_tokens": {
- "description": "Context size in tokens that triggers compaction. Default: 50000.",
- "exclusiveMinimum": 0,
- "type": "integer"
- },
- "enabled": {
- "default": true,
- "description": "Summarize older history when context grows too large. Default: true.",
- "type": "boolean"
- }
- },
- "type": "object"
+ "enabled": true
+ },
+ "large_tool_response": {
+ "enabled": true
+ }
+ },
+ "properties": {
+ "compaction": {
+ "$ref": "#/components/schemas/CompactionConfig"
},
"large_tool_response": {
"$ref": "#/components/schemas/LargeToolResponseConfig"
@@ -749,11 +902,11 @@
],
"type": "object"
},
- "CreateMcpServerRequest": {
+ "CreateMCPServerRequest": {
"additionalProperties": false,
"properties": {
"manifest": {
- "$ref": "#/components/schemas/McpServerManifest"
+ "$ref": "#/components/schemas/MCPServerManifest"
}
},
"required": [
@@ -841,7 +994,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -966,7 +1119,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -1012,54 +1165,7 @@
"GetCapabilitiesResponse": {
"properties": {
"data": {
- "properties": {
- "sandbox": {
- "properties": {
- "enabled": {
- "description": "Whether a sandbox provider is configured for this tenant.",
- "type": "boolean"
- }
- },
- "required": [
- "enabled"
- ],
- "type": "object"
- },
- "settings": {
- "properties": {
- "enabled": {
- "description": "Whether the settings UI/API is enabled.",
- "type": "boolean"
- }
- },
- "required": [
- "enabled"
- ],
- "type": "object"
- },
- "skill": {
- "properties": {
- "enabled": {
- "description": "Whether skills are available. False when sandbox is not enabled (skills require a sandbox).",
- "type": "boolean"
- },
- "reason": {
- "description": "Present when skills are disabled. Explains why.",
- "type": "string"
- }
- },
- "required": [
- "enabled"
- ],
- "type": "object"
- }
- },
- "required": [
- "sandbox",
- "skill",
- "settings"
- ],
- "type": "object"
+ "$ref": "#/components/schemas/CapabilitiesData"
}
},
"required": [
@@ -1067,11 +1173,11 @@
],
"type": "object"
},
- "GetMcpServerCatalogResponse": {
+ "GetMCPServerCatalogResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/CatalogMcpServer"
+ "$ref": "#/components/schemas/CatalogMCPServer"
},
"type": "array"
}
@@ -1081,10 +1187,10 @@
],
"type": "object"
},
- "GetMcpServerResponse": {
+ "GetMCPServerResponse": {
"properties": {
"data": {
- "$ref": "#/components/schemas/ConfiguredMcpServer"
+ "$ref": "#/components/schemas/ConfiguredMCPServer"
}
},
"required": [
@@ -1092,6 +1198,32 @@
],
"type": "object"
},
+ "GetMeResponse": {
+ "properties": {
+ "email": {
+ "description": "User email from the ID token when connected; `\"default\"` when anonymous.",
+ "type": "string"
+ },
+ "role": {
+ "description": "Caller role.",
+ "type": "string"
+ },
+ "type": {
+ "description": "Session kind: `default` when no valid OIDC session; `oidc-connected` after a successful browser login.",
+ "enum": [
+ "default",
+ "oidc-connected"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "email",
+ "role"
+ ],
+ "type": "object"
+ },
"GetModelProviderCatalogResponse": {
"properties": {
"data": {
@@ -1109,7 +1241,7 @@
"GetModelProviderResponse": {
"properties": {
"data": {
- "$ref": "#/components/schemas/ModelProvider"
+ "$ref": "#/components/schemas/ConfiguredModelProvider"
}
},
"required": [
@@ -1121,7 +1253,7 @@
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/CatalogDaytonaSandboxProvider"
+ "$ref": "#/components/schemas/CatalogSandboxProvider"
},
"type": "array"
}
@@ -1134,7 +1266,7 @@
"GetSandboxProviderResponse": {
"properties": {
"data": {
- "$ref": "#/components/schemas/SandboxProvider"
+ "$ref": "#/components/schemas/ConfiguredSandboxProvider"
}
},
"required": [
@@ -1204,7 +1336,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -1223,6 +1355,27 @@
],
"type": "object"
},
+ "InitialUserMessage": {
+ "properties": {
+ "content": {
+ "description": "Initial user message content injected at the start of every session.",
+ "minLength": 1,
+ "type": "string"
+ },
+ "type": {
+ "description": "Initial message type.",
+ "enum": [
+ "user.message"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "type",
+ "content"
+ ],
+ "type": "object"
+ },
"LargeToolResponseConfig": {
"default": {
"enabled": true
@@ -1250,11 +1403,11 @@
],
"type": "object"
},
- "ListAvailableMcpServersResponse": {
+ "ListAvailableMCPServersResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/McpServerReadEntry"
+ "$ref": "#/components/schemas/AvailableMCPServer"
},
"type": "array"
}
@@ -1264,11 +1417,11 @@
],
"type": "object"
},
- "ListAvailableSkillsResponse": {
+ "ListAvailableModelsResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/SkillReadEntry"
+ "$ref": "#/components/schemas/AvailableModel"
},
"type": "array"
}
@@ -1278,13 +1431,11 @@
],
"type": "object"
},
- "ListMcpServerToolsResponse": {
+ "ListAvailableSkillsResponse": {
"properties": {
"data": {
- "description": "MCP `tools/list` entries, passed through verbatim from the MCP server.",
"items": {
- "additionalProperties": {},
- "type": "object"
+ "$ref": "#/components/schemas/AvailableSkill"
},
"type": "array"
}
@@ -1294,11 +1445,13 @@
],
"type": "object"
},
- "ListMcpServersResponse": {
+ "ListMCPServerToolsResponse": {
"properties": {
"data": {
+ "description": "MCP `tools/list` entries, passed through verbatim from the MCP server.",
"items": {
- "$ref": "#/components/schemas/ConfiguredMcpServer"
+ "additionalProperties": {},
+ "type": "object"
},
"type": "array"
}
@@ -1308,11 +1461,11 @@
],
"type": "object"
},
- "ListModelProvidersResponse": {
+ "ListMCPServersResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/ModelProvider"
+ "$ref": "#/components/schemas/ConfiguredMCPServer"
},
"type": "array"
}
@@ -1322,11 +1475,11 @@
],
"type": "object"
},
- "ListModelsResponse": {
+ "ListModelProvidersResponse": {
"properties": {
"data": {
"items": {
- "$ref": "#/components/schemas/Model"
+ "$ref": "#/components/schemas/ConfiguredModelProvider"
},
"type": "array"
}
@@ -1470,6 +1623,30 @@
}
]
},
+ "MCPAuthStatus": {
+ "additionalProperties": false,
+ "description": "Current auth state.",
+ "properties": {
+ "authorization_url": {
+ "description": "When auth is required, this contains the URL to redirect the user to for authorization.",
+ "format": "uri",
+ "type": "string"
+ },
+ "status": {
+ "description": "Current auth state for this MCP server.",
+ "enum": [
+ "authenticated",
+ "auth_required",
+ "not_required"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status"
+ ],
+ "type": "object"
+ },
"MCPInitializeEvent": {
"properties": {
"created_at": {
@@ -1514,19 +1691,7 @@
"default": [],
"description": "Tools subtracted from the enabled set. Default: none.",
"items": {
- "anyOf": [
- {
- "enum": [
- "@all",
- "@read-only"
- ],
- "type": "string"
- },
- {
- "minLength": 1,
- "type": "string"
- }
- ]
+ "$ref": "#/components/schemas/MCPServerToolSelector"
},
"type": "array"
},
@@ -1536,19 +1701,7 @@
],
"description": "Tools exposed to the agent: `@all`, `@read-only`, or literal tool names. Default: `[\"@all\"]`.",
"items": {
- "anyOf": [
- {
- "enum": [
- "@all",
- "@read-only"
- ],
- "type": "string"
- },
- {
- "minLength": 1,
- "type": "string"
- }
- ]
+ "$ref": "#/components/schemas/MCPServerToolSelector"
},
"type": "array"
},
@@ -1566,19 +1719,7 @@
"default": [],
"description": "Tools loaded eagerly into context while the rest stay deferred. A non-empty list implies `preload: false`.",
"items": {
- "anyOf": [
- {
- "enum": [
- "@all",
- "@read-only"
- ],
- "type": "string"
- },
- {
- "minLength": 1,
- "type": "string"
- }
- ]
+ "$ref": "#/components/schemas/MCPServerToolSelector"
},
"type": "array"
},
@@ -1589,20 +1730,7 @@
],
"description": "Tools that pause for human approval: `@all`, `@write`, `@destructive`, or literal names. Default: `[\"@write\", \"@destructive\"]`.",
"items": {
- "anyOf": [
- {
- "enum": [
- "@all",
- "@write",
- "@destructive"
- ],
- "type": "string"
- },
- {
- "minLength": 1,
- "type": "string"
- }
- ]
+ "$ref": "#/components/schemas/MCPServerApprovalToolSelector"
},
"type": "array"
}
@@ -1612,6 +1740,22 @@
],
"type": "object"
},
+ "MCPServerApprovalToolSelector": {
+ "anyOf": [
+ {
+ "enum": [
+ "@all",
+ "@write",
+ "@destructive"
+ ],
+ "type": "string"
+ },
+ {
+ "minLength": 1,
+ "type": "string"
+ }
+ ]
+ },
"MCPServerAuthInfo": {
"properties": {
"auth_url": {
@@ -1634,90 +1778,7 @@
],
"type": "object"
},
- "MCPServerInitInfo": {
- "properties": {
- "id": {
- "description": "Internal MCP server id.",
- "type": "string"
- },
- "name": {
- "description": "Configured MCP server name.",
- "type": "string"
- },
- "session_id": {
- "description": "Optional MCP session id from the transport.",
- "type": "string"
- },
- "transport_type": {
- "description": "Transport used to connect to the MCP server.",
- "enum": [
- "streamable-http",
- "sse"
- ],
- "type": "string"
- }
- },
- "required": [
- "id",
- "name"
- ],
- "type": "object"
- },
- "MCPToolInfo": {
- "properties": {
- "name": {
- "description": "Tool name on the MCP server.",
- "type": "string"
- },
- "server_id": {
- "description": "Internal MCP server id.",
- "type": "string"
- },
- "server_name": {
- "description": "Configured MCP server name.",
- "type": "string"
- },
- "type": {
- "description": "Tool hosted on an MCP server.",
- "enum": [
- "mcp"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "server_id",
- "server_name",
- "name"
- ],
- "type": "object"
- },
- "McpAuthStatus": {
- "additionalProperties": false,
- "description": "Current auth state.",
- "properties": {
- "authorization_url": {
- "description": "When auth is required, this contains the URL to redirect the user to for authorization.",
- "format": "uri",
- "type": "string"
- },
- "status": {
- "description": "Current auth state for this MCP server.",
- "enum": [
- "authenticated",
- "auth_required",
- "not_required"
- ],
- "type": "string"
- }
- },
- "required": [
- "status"
- ],
- "type": "object"
- },
- "McpServerAuthPublic": {
+ "MCPServerAuthPublic": {
"description": "Auth mechanism when configured (no secrets). Omit when the server needs no credentials.",
"oneOf": [
{
@@ -1752,7 +1813,7 @@
}
]
},
- "McpServerDcrAuth": {
+ "MCPServerDcrAuth": {
"additionalProperties": false,
"properties": {
"type": {
@@ -1768,7 +1829,7 @@
],
"type": "object"
},
- "McpServerHeaderAuth": {
+ "MCPServerHeaderAuth": {
"additionalProperties": false,
"properties": {
"headers": {
@@ -1793,11 +1854,40 @@
],
"type": "object"
},
- "McpServerManifest": {
+ "MCPServerInitInfo": {
+ "properties": {
+ "id": {
+ "description": "Internal MCP server id.",
+ "type": "string"
+ },
+ "name": {
+ "description": "Configured MCP server name.",
+ "type": "string"
+ },
+ "session_id": {
+ "description": "Optional MCP session id from the transport.",
+ "type": "string"
+ },
+ "transport_type": {
+ "description": "Transport used to connect to the MCP server.",
+ "enum": [
+ "streamable-http",
+ "sse"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "id",
+ "name"
+ ],
+ "type": "object"
+ },
+ "MCPServerManifest": {
"additionalProperties": false,
"properties": {
"auth": {
- "$ref": "#/components/schemas/McpServerManifestAuth"
+ "$ref": "#/components/schemas/MCPServerManifestAuth"
},
"description": {
"description": "Concise summary of what this MCP server provides.",
@@ -1808,7 +1898,7 @@
"$ref": "#/components/schemas/ResourceName"
},
"type": {
- "$ref": "#/components/schemas/McpServerType"
+ "$ref": "#/components/schemas/MCPServerType"
},
"url": {
"description": "URL of the remote MCP server.",
@@ -1824,137 +1914,84 @@
],
"type": "object"
},
- "McpServerManifestAuth": {
+ "MCPServerManifestAuth": {
"description": "Optional auth settings. Omit when the server needs no credentials.",
"discriminator": {
"mapping": {
- "dcr": "#/components/schemas/McpServerDcrAuth",
- "header": "#/components/schemas/McpServerHeaderAuth"
+ "dcr": "#/components/schemas/MCPServerDcrAuth",
+ "header": "#/components/schemas/MCPServerHeaderAuth"
},
"propertyName": "type"
},
"oneOf": [
{
- "$ref": "#/components/schemas/McpServerHeaderAuth"
+ "$ref": "#/components/schemas/MCPServerHeaderAuth"
},
{
- "$ref": "#/components/schemas/McpServerDcrAuth"
+ "$ref": "#/components/schemas/MCPServerDcrAuth"
}
]
},
- "McpServerReadEntry": {
- "additionalProperties": false,
- "properties": {
- "auth": {
- "$ref": "#/components/schemas/McpServerAuthPublic"
- },
- "auth_status": {
- "$ref": "#/components/schemas/McpAuthStatus"
- },
- "name": {
- "$ref": "#/components/schemas/ResourceName"
+ "MCPServerToolSelector": {
+ "anyOf": [
+ {
+ "enum": [
+ "@all",
+ "@read-only"
+ ],
+ "type": "string"
},
- "url": {
- "description": "URL of the remote MCP server.",
- "format": "uri",
+ {
+ "minLength": 1,
"type": "string"
}
- },
- "required": [
- "name",
- "url",
- "auth_status"
- ],
- "type": "object"
+ ]
},
- "McpServerType": {
+ "MCPServerType": {
"enum": [
"remote"
],
"type": "string"
},
- "MeResponse": {
- "properties": {
- "email": {
- "description": "User email from the ID token when connected; `\"default\"` when anonymous.",
- "type": "string"
- },
- "role": {
- "description": "Caller role.",
- "type": "string"
- },
- "type": {
- "description": "Session kind: `default` when no valid OIDC session; `oidc-connected` after a successful browser login.",
- "enum": [
- "default",
- "oidc-connected"
- ],
- "type": "string"
- }
- },
- "required": [
- "type",
- "email",
- "role"
- ],
- "type": "object"
- },
- "Model": {
- "additionalProperties": false,
+ "MCPToolInfo": {
"properties": {
- "model_id": {
- "description": "Upstream, provider-specific identifier sent to the provider API.",
- "type": "string"
- },
"name": {
- "description": "Fully qualified name `provider_name/model_name`, e.g. \"openai/gpt-5-6-sol\". Unique within a tenant.",
+ "description": "Tool name on the MCP server.",
"type": "string"
},
- "properties": {
- "$ref": "#/components/schemas/ModelProperties"
- },
- "provider": {
- "$ref": "#/components/schemas/ModelListProvider"
- }
- },
- "required": [
- "name",
- "model_id",
- "provider",
- "properties"
- ],
- "type": "object"
- },
- "ModelEntry": {
- "additionalProperties": false,
- "properties": {
- "model_id": {
- "description": "Upstream, provider-specific identifier sent to the provider API.",
- "minLength": 1,
+ "server_id": {
+ "description": "Internal MCP server id.",
"type": "string"
},
- "name": {
- "$ref": "#/components/schemas/ResourceName"
+ "server_name": {
+ "description": "Configured MCP server name.",
+ "type": "string"
},
- "properties": {
- "$ref": "#/components/schemas/ModelProperties"
+ "type": {
+ "description": "Tool hosted on an MCP server.",
+ "enum": [
+ "mcp"
+ ],
+ "type": "string"
}
},
"required": [
- "model_id",
- "name",
- "properties"
+ "type",
+ "server_id",
+ "server_name",
+ "name"
],
"type": "object"
},
- "ModelListProvider": {
- "additionalProperties": false,
- "description": "Owning configured provider.",
+ "Model": {
"properties": {
"name": {
- "description": "Configured provider resource name; matches the FQN prefix of `name`.",
+ "description": "Model FQN: `provider/model`, e.g. `openai/gpt-5.2`.",
"minLength": 1,
"type": "string"
+ },
+ "params": {
+ "$ref": "#/components/schemas/ModelParams"
}
},
"required": [
@@ -2239,22 +2276,6 @@
},
"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.",
@@ -2330,7 +2351,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -2364,7 +2385,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -2405,66 +2426,6 @@
"default": "auto",
"description": "Defaults to 'auto' (chain to session last turn). Use 'none' for a new root turn."
},
- "PutAgentRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/AgentSpec"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
- "PutMcpServerRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/McpServerManifest"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
- "PutModelProviderRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/ModelProviderManifest"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
- "PutSandboxProviderRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/SandboxProviderManifest"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
- "PutSkillRequest": {
- "additionalProperties": false,
- "properties": {
- "manifest": {
- "$ref": "#/components/schemas/SkillManifest"
- }
- },
- "required": [
- "manifest"
- ],
- "type": "object"
- },
"RawToolCall": {
"allOf": [
{
@@ -2700,6 +2661,18 @@
],
"type": "string"
},
+ "SandboxCapability": {
+ "properties": {
+ "enabled": {
+ "description": "Whether a sandbox provider is configured for this tenant.",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "enabled"
+ ],
+ "type": "object"
+ },
"SandboxConfig": {
"default": {
"enabled": false,
@@ -2759,30 +2732,6 @@
],
"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": {
@@ -3026,6 +2975,50 @@
],
"type": "object"
},
+ "SettingsCapability": {
+ "properties": {
+ "enabled": {
+ "description": "Whether the settings UI/API is enabled.",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "enabled"
+ ],
+ "type": "object"
+ },
+ "Skill": {
+ "additionalProperties": false,
+ "properties": {
+ "name": {
+ "description": "Name of a configured skill (also used as the skill directory name in the sandbox).",
+ "maxLength": 64,
+ "minLength": 1,
+ "pattern": "^[A-Za-z0-9._-]+$",
+ "type": "string"
+ }
+ },
+ "required": [
+ "name"
+ ],
+ "type": "object"
+ },
+ "SkillCapability": {
+ "properties": {
+ "enabled": {
+ "description": "Whether skills are available. False when sandbox is not enabled (skills require a sandbox).",
+ "type": "boolean"
+ },
+ "reason": {
+ "description": "Present when skills are disabled. Explains why.",
+ "type": "string"
+ }
+ },
+ "required": [
+ "enabled"
+ ],
+ "type": "object"
+ },
"SkillManifest": {
"additionalProperties": false,
"properties": {
@@ -3068,40 +3061,6 @@
],
"type": "object"
},
- "SkillNameRef": {
- "additionalProperties": false,
- "properties": {
- "name": {
- "description": "Name of a configured skill (also used as the skill directory name in the sandbox).",
- "maxLength": 64,
- "minLength": 1,
- "pattern": "^[A-Za-z0-9._-]+$",
- "type": "string"
- }
- },
- "required": [
- "name"
- ],
- "type": "object"
- },
- "SkillReadEntry": {
- "additionalProperties": false,
- "properties": {
- "description": {
- "description": "Concise guidance for when the agent should use the skill.",
- "minLength": 1,
- "type": "string"
- },
- "name": {
- "$ref": "#/components/schemas/ResourceName"
- }
- },
- "required": [
- "name",
- "description"
- ],
- "type": "object"
- },
"SkillType": {
"enum": [
"git"
@@ -3281,7 +3240,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -3943,6 +3902,54 @@
}
]
},
+ "UpdateAgentRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/AgentSpec"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "UpdateMCPServerRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/MCPServerManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "UpdateModelProviderRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/ModelProviderManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
+ "UpdateSandboxProviderRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SandboxProviderManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
"UpdateSessionRequest": {
"additionalProperties": false,
"properties": {
@@ -3952,6 +3959,18 @@
},
"type": "object"
},
+ "UpdateSkillRequest": {
+ "additionalProperties": false,
+ "properties": {
+ "manifest": {
+ "$ref": "#/components/schemas/SkillManifest"
+ }
+ },
+ "required": [
+ "manifest"
+ ],
+ "type": "object"
+ },
"UserMessage": {
"properties": {
"content": {
@@ -4078,7 +4097,7 @@
"models": {
"description": "Models exposed by this provider (at least one).",
"items": {
- "$ref": "#/components/schemas/ModelEntry"
+ "$ref": "#/components/schemas/ConfiguredModel"
},
"minItems": 1,
"type": "array"
@@ -4327,7 +4346,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutAgentRequest"
+ "$ref": "#/components/schemas/UpdateAgentRequest"
}
}
},
@@ -4497,7 +4516,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/MeResponse"
+ "$ref": "#/components/schemas/GetMeResponse"
}
}
},
@@ -4567,7 +4586,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerCatalogResponse"
+ "$ref": "#/components/schemas/GetMCPServerCatalogResponse"
}
}
},
@@ -4711,7 +4730,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListAvailableMcpServersResponse"
+ "$ref": "#/components/schemas/ListAvailableMCPServersResponse"
}
}
},
@@ -4861,7 +4880,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerResponse"
+ "$ref": "#/components/schemas/GetMCPServerResponse"
}
}
},
@@ -4917,7 +4936,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/McpAuthStatus"
+ "$ref": "#/components/schemas/MCPAuthStatus"
}
}
},
@@ -5005,7 +5024,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListMcpServerToolsResponse"
+ "$ref": "#/components/schemas/ListMCPServerToolsResponse"
}
}
},
@@ -5064,17 +5083,17 @@
},
"/api/v1/models": {
"get": {
- "description": "Models across all configured model providers, addressed by fully qualified name `name/model_name`.",
+ "description": "Configured models as a slim FQN list for the composer.",
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListModelsResponse"
+ "$ref": "#/components/schemas/ListAvailableModelsResponse"
}
}
},
- "description": "All models of all configured providers."
+ "description": "All configured models (chat projection)."
},
"401": {
"content": {
@@ -5087,7 +5106,7 @@
"description": "OIDC is configured and the request has no valid session cookie."
}
},
- "summary": "List models",
+ "summary": "List models for chat",
"tags": [
"Models"
],
@@ -6295,7 +6314,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/ListMcpServersResponse"
+ "$ref": "#/components/schemas/ListMCPServersResponse"
}
}
},
@@ -6338,7 +6357,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/CreateMcpServerRequest"
+ "$ref": "#/components/schemas/CreateMCPServerRequest"
}
}
},
@@ -6349,7 +6368,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerResponse"
+ "$ref": "#/components/schemas/GetMCPServerResponse"
}
}
},
@@ -6402,7 +6421,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutMcpServerRequest"
+ "$ref": "#/components/schemas/UpdateMCPServerRequest"
}
}
},
@@ -6413,7 +6432,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerResponse"
+ "$ref": "#/components/schemas/GetMCPServerResponse"
}
}
},
@@ -6472,7 +6491,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/GetMcpServerResponse"
+ "$ref": "#/components/schemas/GetMCPServerResponse"
}
}
},
@@ -6605,7 +6624,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutModelProviderRequest"
+ "$ref": "#/components/schemas/UpdateModelProviderRequest"
}
}
},
@@ -6685,7 +6704,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutSandboxProviderRequest"
+ "$ref": "#/components/schemas/UpdateSandboxProviderRequest"
}
}
},
@@ -6839,7 +6858,7 @@
"content": {
"application/json": {
"schema": {
- "$ref": "#/components/schemas/PutSkillRequest"
+ "$ref": "#/components/schemas/UpdateSkillRequest"
}
}
},
diff --git a/packages/frontend/src/authSession.ts b/packages/frontend/src/authSession.ts
index 94c3eaa7b..06e95799c 100644
--- a/packages/frontend/src/authSession.ts
+++ b/packages/frontend/src/authSession.ts
@@ -2,11 +2,9 @@
* Session helpers: SDK `auth.me()` plus POST `/api/v1/auth/logout`.
* Login is not on the SDK (browser redirect to `/api/v1/auth/login`).
*/
-import { TrueForge as TrueForgeClient, type TrueForge, type TrueForgeApi } from '@truefoundry/trueforge-sdk';
+import { TrueForge as TrueForgeClient, type TrueForge } from '@truefoundry/trueforge-sdk';
import { AUTH_LOGOUT_HREF, createAuthAwareFetch } from './authFetch';
-export type MeResponse = TrueForgeApi.MeResponse;
-
const DEFAULT_BASE_URL = '/';
/** Authenticated API client — 401 redirects to OIDC login. */
diff --git a/packages/trueforge-core/src/agent-session/TurnResourceResolver.ts b/packages/trueforge-core/src/agent-session/TurnResourceResolver.ts
index 123e91050..45c11c667 100644
--- a/packages/trueforge-core/src/agent-session/TurnResourceResolver.ts
+++ b/packages/trueforge-core/src/agent-session/TurnResourceResolver.ts
@@ -205,10 +205,7 @@ export class TurnResourceResolver<
instruction: agentInfo ? undefined : spec.instructions,
messages: agentInfo
? [{ role: 'user' as const, content: agentInfo.input }]
- : spec.messages?.map(m => ({
- role: 'user' as const,
- content: m.content,
- })),
+ : spec.messages?.map(m => ({ role: 'user' as const, content: m.content })),
modelParams: {
...resolvedModel.defaultModelParams,
...spec.model.params,
diff --git a/packages/trueforge-core/src/agent-session/index.ts b/packages/trueforge-core/src/agent-session/index.ts
index c1b574ec1..85eba425e 100644
--- a/packages/trueforge-core/src/agent-session/index.ts
+++ b/packages/trueforge-core/src/agent-session/index.ts
@@ -4,7 +4,7 @@
*/
export { AgentSpecSchema, DEFAULT_AGENT_CONFIG_ITERATION_LIMIT, RuntimeConfigSchema } from './schemas/agentSpec';
-export type { AgentSpec, SkillNameRef } from './schemas/agentSpec';
+export type { AgentSpec, Skill } from './schemas/agentSpec';
export {
CancellationReason,
diff --git a/packages/trueforge-core/src/agent-session/schemas/agentSpec.ts b/packages/trueforge-core/src/agent-session/schemas/agentSpec.ts
index 0493c8cde..7cbb56c2c 100644
--- a/packages/trueforge-core/src/agent-session/schemas/agentSpec.ts
+++ b/packages/trueforge-core/src/agent-session/schemas/agentSpec.ts
@@ -38,7 +38,7 @@ const ModelParamsSchema = z
.openapi('ModelParams');
// Opaque runtime identifier; the hosting server owns naming conventions (e.g. provider/model).
-const ModelSpecSchema = z
+const ModelSchema = z
.object({
name: z
.string()
@@ -46,7 +46,7 @@ const ModelSpecSchema = z
.describe('Model FQN: `provider/model`, e.g. `openai/gpt-5.2`.'),
params: ModelParamsSchema.optional(),
})
- .openapi('AgentSpecModel');
+ .openapi('Model');
// --- MCP servers ---
@@ -57,13 +57,14 @@ const LiteralToolSelectorSchema = z
.refine(s => !s.startsWith('@'), { message: 'Invalid tool selector tag' });
// enable_tools / disable_tools / preload_tools: @all, @read-only, or a literal name.
-const EnableToolSelectorSchema = z.union([z.enum(TOOLS_SELECTOR_TAGS), LiteralToolSelectorSchema]);
+const EnableToolSelectorSchema = z
+ .union([z.enum(TOOLS_SELECTOR_TAGS), LiteralToolSelectorSchema])
+ .openapi('MCPServerToolSelector');
// require_approval_for_tools: @all, @write, @destructive, or a literal name.
-const RequireApprovalToolSelectorSchema = z.union([
- z.enum(REQUIRE_APPROVAL_TOOLS_SELECTOR_TAGS),
- LiteralToolSelectorSchema,
-]);
+const RequireApprovalToolSelectorSchema = z
+ .union([z.enum(REQUIRE_APPROVAL_TOOLS_SELECTOR_TAGS), LiteralToolSelectorSchema])
+ .openapi('MCPServerApprovalToolSelector');
// `preload` defaults to false; use `preload_tools` to eagerly load specific tools when not fully preloading.
// Auth headers are not part of the spec — they come from the configured MCP server store.
@@ -110,15 +111,17 @@ const MCPServerRequestSchema = z
// --- Runtime config ---
-const CompactionSettingsSchema = z.object({
- enabled: z.boolean().default(true).describe('Summarize older history when context grows too large. Default: true.'),
- compaction_threshold_tokens: z
- .number()
- .int()
- .positive()
- .optional()
- .describe('Context size in tokens that triggers compaction. Default: 50000.'),
-});
+const CompactionSettingsSchema = z
+ .object({
+ enabled: z.boolean().default(true).describe('Summarize older history when context grows too large. Default: true.'),
+ compaction_threshold_tokens: z
+ .number()
+ .int()
+ .positive()
+ .optional()
+ .describe('Context size in tokens that triggers compaction. Default: 50000.'),
+ })
+ .openapi('CompactionConfig');
const LargeToolResponseSettingsSchema = z.object({
enabled: z.boolean().default(true).describe('Offload oversized tool responses to a sandbox file. Default: true.'),
@@ -218,7 +221,7 @@ export const RuntimeConfigSchema = z
const SKILL_NAME_REGEX = /^[A-Za-z0-9._-]+$/;
/** Name-only skill selection; mount fields come from the skill store. */
-const SkillNameRefSchema = z
+const SkillSchema = z
.object({
name: z
.string()
@@ -231,41 +234,41 @@ const SkillNameRefSchema = z
.describe('Name of a configured skill (also used as the skill directory name in the sandbox).'),
})
.strict()
- .openapi('SkillNameRef');
+ .openapi('Skill');
-// --- Response format / messages ---
+// --- Initial messages (string-only; turn UserMessage also allows file parts) ---
-const AgentSpecUserMessageSchema = z
+const InitialUserMessageSchema = z
.object({
- type: z.literal('user.message').describe('Seed message type.'),
+ type: z.literal('user.message').describe('Initial message type.'),
content: z
.string()
.min(1, 'User message content must not be empty')
.refine(content => content.trim().length > 0, 'User message content must not be empty')
- .describe('Seed user message content injected at the start of every session.'),
+ .describe('Initial user message content injected at the start of every session.'),
})
- .openapi('AgentSpecUserMessage');
+ .openapi('InitialUserMessage');
// --- Agent spec ---
export const AgentSpecSchema = z
.object({
- model: ModelSpecSchema,
+ model: ModelSchema,
instructions: z
.string()
.optional()
.describe("Optional system prompt — the agent's role, behavior, and constraints."),
messages: z
- .array(AgentSpecUserMessageSchema)
+ .array(InitialUserMessageSchema)
.optional()
- .describe('Optional seed user messages injected at the start of every session.'),
+ .describe('Optional initial user messages injected at the start of every session.'),
mcp_servers: z
.array(MCPServerRequestSchema)
.optional()
.describe('Optional MCP servers attached by configured name.'),
response_format: ResponseFormatSchema.optional(),
skills: z
- .array(SkillNameRefSchema)
+ .array(SkillSchema)
.optional()
.describe('Optional name-only skill references. Requires `config.sandbox.enabled: true`.'),
// Factory must parse so nested RuntimeConfig field defaults materialize.
@@ -275,4 +278,5 @@ export const AgentSpecSchema = z
.openapi('AgentSpec');
export type AgentSpec = z.infer<typeof AgentSpecSchema>;
-export type SkillNameRef = z.infer<typeof SkillNameRefSchema>;
+export type Skill = z.infer<typeof SkillSchema>;
+export type InitialUserMessage = z.infer<typeof InitialUserMessageSchema>;
diff --git a/packages/trueforge-core/tests/agent-session/agentSpecSkills.test.ts b/packages/trueforge-core/tests/agent-session/agentSpecSkills.test.ts
index d8221a2cf..d82cfaf5a 100644
--- a/packages/trueforge-core/tests/agent-session/agentSpecSkills.test.ts
+++ b/packages/trueforge-core/tests/agent-session/agentSpecSkills.test.ts
@@ -1,7 +1,7 @@
import { AgentSpecSchema } from '../../src/agent-session/schemas/agentSpec';
describe('AgentSpecSchema skills', () => {
- it('accepts name-only SkillNameRef entries', () => {
+ it('accepts name-only Skill entries', () => {
const parsed = AgentSpecSchema.parse({
model: { name: 'test-provider/test-model' },
skills: [{ name: 'my-skill' }],
diff --git a/packages/trueforge-sdk/reference.md b/packages/trueforge-sdk/reference.md
index 013e416c7..2787f170e 100644
--- a/packages/trueforge-sdk/reference.md
+++ b/packages/trueforge-sdk/reference.md
@@ -245,7 +245,7 @@ await client.agents.update("agent_id", {
<dl>
<dd>
-**request:** `TrueForge.PutAgentRequest`
+**request:** `TrueForge.UpdateAgentRequest`
</dd>
</dl>
@@ -329,7 +329,7 @@ await client.agents.delete("agent_id");
</details>
## Auth
-<details><summary><code>client.auth.<a href="/src/api/resources/auth/client/Client.ts">me</a>() -> TrueForge.MeResponse</code></summary>
+<details><summary><code>client.auth.<a href="/src/api/resources/auth/client/Client.ts">me</a>() -> TrueForge.GetMeResponse</code></summary>
<dl>
<dd>
@@ -694,7 +694,7 @@ await client.mcpServers.listTools("name");
</details>
## Models
-<details><summary><code>client.models.<a href="/src/api/resources/models/client/Client.ts">list</a>() -> TrueForge.ListModelsResponse</code></summary>
+<details><summary><code>client.models.<a href="/src/api/resources/models/client/Client.ts">list</a>() -> TrueForge.ListAvailableModelsResponse</code></summary>
<dl>
<dd>
@@ -706,7 +706,7 @@ await client.mcpServers.listTools("name");
<dl>
<dd>
-Models across all configured model providers, addressed by fully qualified name `name/model_name`.
+Configured models as a slim FQN list for the composer.
</dd>
</dl>
</dd>
@@ -2212,7 +2212,7 @@ await client.settings.mcpServers.createOrUpdate({
<dl>
<dd>
-**request:** `TrueForge.settings.PutMcpServerRequest`
+**request:** `TrueForge.settings.UpdateMcpServerRequest`
</dd>
</dl>
@@ -2481,7 +2481,7 @@ await client.settings.modelProviders.createOrUpdate({
<dl>
<dd>
-**request:** `TrueForge.settings.PutModelProviderRequest`
+**request:** `TrueForge.settings.UpdateModelProviderRequest`
</dd>
</dl>
@@ -2611,7 +2611,7 @@ await client.settings.sandboxProviders.createOrUpdate({
<dl>
<dd>
-**request:** `TrueForge.settings.PutSandboxProviderRequest`
+**request:** `TrueForge.settings.UpdateSandboxProviderRequest`
</dd>
</dl>
@@ -2809,7 +2809,7 @@ await client.settings.skills.createOrUpdate({
<dl>
<dd>
-**request:** `TrueForge.settings.PutSkillRequest`
+**request:** `TrueForge.settings.UpdateSkillRequest`
</dd>
</dl>
diff --git a/packages/trueforge-sdk/src/api/resources/agents/client/Client.ts b/packages/trueforge-sdk/src/api/resources/agents/client/Client.ts
index a32e178bc..1a7da9886 100644
--- a/packages/trueforge-sdk/src/api/resources/agents/client/Client.ts
+++ b/packages/trueforge-sdk/src/api/resources/agents/client/Client.ts
@@ -313,7 +313,7 @@ export class AgentsClient {
* Replaces the manifest for an existing agent keyed by immutable `agent_id`.
*
* @param {string} agent_id - Immutable agent identifier.
- * @param {TrueForge.PutAgentRequest} request
+ * @param {TrueForge.UpdateAgentRequest} request
* @param {AgentsClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -333,7 +333,7 @@ export class AgentsClient {
*/
public update(
agent_id: string,
- request: TrueForge.PutAgentRequest,
+ request: TrueForge.UpdateAgentRequest,
requestOptions?: AgentsClient.RequestOptions,
): core.HttpResponsePromise<TrueForge.GetAgentResponse> {
return core.HttpResponsePromise.fromPromise(this.__update(agent_id, request, requestOptions));
@@ -341,7 +341,7 @@ export class AgentsClient {
private async __update(
agent_id: string,
- request: TrueForge.PutAgentRequest,
+ request: TrueForge.UpdateAgentRequest,
requestOptions?: AgentsClient.RequestOptions,
): Promise<core.WithRawResponse<TrueForge.GetAgentResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
@@ -362,7 +362,7 @@ export class AgentsClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.PutAgentRequest.jsonOrThrow(request, {
+ serializers.UpdateAgentRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/trueforge-sdk/src/api/resources/agents/client/requests/PutAgentRequest.ts b/packages/trueforge-sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts
similarity index 88%
rename from packages/trueforge-sdk/src/api/resources/agents/client/requests/PutAgentRequest.ts
rename to packages/trueforge-sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts
index d8b41efc5..b92a833d5 100644
--- a/packages/trueforge-sdk/src/api/resources/agents/client/requests/PutAgentRequest.ts
+++ b/packages/trueforge-sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts
@@ -12,6 +12,6 @@ import type * as TrueForge from "../../../../index.js";
* }
* }
*/
-export interface PutAgentRequest {
+export interface UpdateAgentRequest {
manifest: TrueForge.AgentSpec;
}
diff --git a/packages/trueforge-sdk/src/api/resources/agents/client/requests/index.ts b/packages/trueforge-sdk/src/api/resources/agents/client/requests/index.ts
index 5c34051d1..ed75949c6 100644
--- a/packages/trueforge-sdk/src/api/resources/agents/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/api/resources/agents/client/requests/index.ts
@@ -1,2 +1,2 @@
export type { CreateAgentRequest } from "./CreateAgentRequest.js";
-export type { PutAgentRequest } from "./PutAgentRequest.js";
+export type { UpdateAgentRequest } from "./UpdateAgentRequest.js";
diff --git a/packages/trueforge-sdk/src/api/resources/auth/client/Client.ts b/packages/trueforge-sdk/src/api/resources/auth/client/Client.ts
index 433489cd3..6b9e64e21 100644
--- a/packages/trueforge-sdk/src/api/resources/auth/client/Client.ts
+++ b/packages/trueforge-sdk/src/api/resources/auth/client/Client.ts
@@ -34,13 +34,13 @@ export class AuthClient {
* @example
* await client.auth.me()
*/
- public me(requestOptions?: AuthClient.RequestOptions): core.HttpResponsePromise<TrueForge.MeResponse> {
+ public me(requestOptions?: AuthClient.RequestOptions): core.HttpResponsePromise<TrueForge.GetMeResponse> {
return core.HttpResponsePromise.fromPromise(this.__me(requestOptions));
}
private async __me(
requestOptions?: AuthClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.MeResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.GetMeResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -64,7 +64,7 @@ export class AuthClient {
});
if (_response.ok) {
return {
- data: serializers.MeResponse.parseOrThrow(_response.body, {
+ data: serializers.GetMeResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/trueforge-sdk/src/api/resources/models/client/Client.ts b/packages/trueforge-sdk/src/api/resources/models/client/Client.ts
index d31832c29..fb098907c 100644
--- a/packages/trueforge-sdk/src/api/resources/models/client/Client.ts
+++ b/packages/trueforge-sdk/src/api/resources/models/client/Client.ts
@@ -23,7 +23,7 @@ export class ModelsClient {
}
/**
- * Models across all configured model providers, addressed by fully qualified name `name/model_name`.
+ * Configured models as a slim FQN list for the composer.
*
* @param {ModelsClient.RequestOptions} requestOptions - Request-specific configuration.
*
@@ -34,13 +34,15 @@ export class ModelsClient {
* @example
* await client.models.list()
*/
- public list(requestOptions?: ModelsClient.RequestOptions): core.HttpResponsePromise<TrueForge.ListModelsResponse> {
+ public list(
+ requestOptions?: ModelsClient.RequestOptions,
+ ): core.HttpResponsePromise<TrueForge.ListAvailableModelsResponse> {
return core.HttpResponsePromise.fromPromise(this.__list(requestOptions));
}
private async __list(
requestOptions?: ModelsClient.RequestOptions,
- ): Promise<core.WithRawResponse<TrueForge.ListModelsResponse>> {
+ ): Promise<core.WithRawResponse<TrueForge.ListAvailableModelsResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
_authRequest.headers,
@@ -64,7 +66,7 @@ export class ModelsClient {
});
if (_response.ok) {
return {
- data: serializers.ListModelsResponse.parseOrThrow(_response.body, {
+ data: serializers.ListAvailableModelsResponse.parseOrThrow(_response.body, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts
index b424bfdac..df89c39e0 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/Client.ts
@@ -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.PutMcpServerRequest} request
+ * @param {TrueForge.settings.UpdateMcpServerRequest} request
* @param {McpServersClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -262,14 +262,14 @@ export class McpServersClient {
* })
*/
public createOrUpdate(
- request: TrueForge.settings.PutMcpServerRequest,
+ request: TrueForge.settings.UpdateMcpServerRequest,
requestOptions?: McpServersClient.RequestOptions,
): core.HttpResponsePromise<TrueForge.GetMcpServerResponse> {
return core.HttpResponsePromise.fromPromise(this.__createOrUpdate(request, requestOptions));
}
private async __createOrUpdate(
- request: TrueForge.settings.PutMcpServerRequest,
+ request: TrueForge.settings.UpdateMcpServerRequest,
requestOptions?: McpServersClient.RequestOptions,
): Promise<core.WithRawResponse<TrueForge.GetMcpServerResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
@@ -290,7 +290,7 @@ export class McpServersClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.settings.PutMcpServerRequest.jsonOrThrow(request, {
+ serializers.settings.UpdateMcpServerRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/UpdateMcpServerRequest.ts
similarity index 89%
rename from packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts
rename to packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/UpdateMcpServerRequest.ts
index 7cd3eb1f2..7f37243e1 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/UpdateMcpServerRequest.ts
@@ -13,6 +13,6 @@ import type * as TrueForge from "../../../../../../index.js";
* }
* }
*/
-export interface PutMcpServerRequest {
+export interface UpdateMcpServerRequest {
manifest: TrueForge.McpServerManifest;
}
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/index.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/index.ts
index ca8fd94be..fc296fdb3 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/mcpServers/client/requests/index.ts
@@ -1,2 +1,2 @@
export type { CreateMcpServerRequest } from "./CreateMcpServerRequest.js";
-export type { PutMcpServerRequest } from "./PutMcpServerRequest.js";
+export type { UpdateMcpServerRequest } from "./UpdateMcpServerRequest.js";
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/Client.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/Client.ts
index 6cb332733..a3fdeef0e 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/Client.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/Client.ts
@@ -246,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.settings.PutModelProviderRequest} request
+ * @param {TrueForge.settings.UpdateModelProviderRequest} request
* @param {ModelProvidersClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -269,14 +269,14 @@ export class ModelProvidersClient {
* })
*/
public createOrUpdate(
- request: TrueForge.settings.PutModelProviderRequest,
+ request: TrueForge.settings.UpdateModelProviderRequest,
requestOptions?: ModelProvidersClient.RequestOptions,
): core.HttpResponsePromise<TrueForge.GetModelProviderResponse> {
return core.HttpResponsePromise.fromPromise(this.__createOrUpdate(request, requestOptions));
}
private async __createOrUpdate(
- request: TrueForge.settings.PutModelProviderRequest,
+ request: TrueForge.settings.UpdateModelProviderRequest,
requestOptions?: ModelProvidersClient.RequestOptions,
): Promise<core.WithRawResponse<TrueForge.GetModelProviderResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
@@ -297,7 +297,7 @@ export class ModelProvidersClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.settings.PutModelProviderRequest.jsonOrThrow(request, {
+ serializers.settings.UpdateModelProviderRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/UpdateModelProviderRequest.ts
similarity index 92%
rename from packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts
rename to packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/UpdateModelProviderRequest.ts
index 7c0e971e1..312a9ae88 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/UpdateModelProviderRequest.ts
@@ -18,6 +18,6 @@ import type * as TrueForge from "../../../../../../index.js";
* }
* }
*/
-export interface PutModelProviderRequest {
+export interface UpdateModelProviderRequest {
manifest: TrueForge.ModelProviderManifest;
}
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/index.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/index.ts
index c6e474014..2b8388184 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/modelProviders/client/requests/index.ts
@@ -1,2 +1,2 @@
export type { CreateModelProviderRequest } from "./CreateModelProviderRequest.js";
-export type { PutModelProviderRequest } from "./PutModelProviderRequest.js";
+export type { UpdateModelProviderRequest } from "./UpdateModelProviderRequest.js";
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/Client.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/Client.ts
index c38d6a89b..6bcc2f136 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/Client.ts
+++ b/packages/trueforge-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.settings.PutSandboxProviderRequest} request
+ * @param {TrueForge.settings.UpdateSandboxProviderRequest} request
* @param {SandboxProvidersClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -134,14 +134,14 @@ export class SandboxProvidersClient {
* })
*/
public createOrUpdate(
- request: TrueForge.settings.PutSandboxProviderRequest,
+ request: TrueForge.settings.UpdateSandboxProviderRequest,
requestOptions?: SandboxProvidersClient.RequestOptions,
): core.HttpResponsePromise<TrueForge.GetSandboxProviderResponse> {
return core.HttpResponsePromise.fromPromise(this.__createOrUpdate(request, requestOptions));
}
private async __createOrUpdate(
- request: TrueForge.settings.PutSandboxProviderRequest,
+ request: TrueForge.settings.UpdateSandboxProviderRequest,
requestOptions?: SandboxProvidersClient.RequestOptions,
): Promise<core.WithRawResponse<TrueForge.GetSandboxProviderResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
@@ -162,7 +162,7 @@ export class SandboxProvidersClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.settings.PutSandboxProviderRequest.jsonOrThrow(request, {
+ serializers.settings.UpdateSandboxProviderRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/UpdateSandboxProviderRequest.ts
similarity index 91%
rename from packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts
rename to packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/UpdateSandboxProviderRequest.ts
index 605758f0a..fcaf45704 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/UpdateSandboxProviderRequest.ts
@@ -17,6 +17,6 @@ import type * as TrueForge from "../../../../../../index.js";
* }
* }
*/
-export interface PutSandboxProviderRequest {
+export interface UpdateSandboxProviderRequest {
manifest: TrueForge.SandboxProviderManifest;
}
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/index.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/index.ts
index 4c854dfe3..7f07ec1f6 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/sandboxProviders/client/requests/index.ts
@@ -1 +1 @@
-export type { PutSandboxProviderRequest } from "./PutSandboxProviderRequest.js";
+export type { UpdateSandboxProviderRequest } from "./UpdateSandboxProviderRequest.js";
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/Client.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/Client.ts
index 603aaef9c..5238ac92a 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/Client.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/Client.ts
@@ -230,7 +230,7 @@ export class SkillsClient {
/**
* Full upsert keyed by `name`: creates the skill or replaces its entire manifest.
*
- * @param {TrueForge.settings.PutSkillRequest} request
+ * @param {TrueForge.settings.UpdateSkillRequest} request
* @param {SkillsClient.RequestOptions} requestOptions - Request-specific configuration.
*
* @throws {@link TrueForge.BadRequestError}
@@ -249,14 +249,14 @@ export class SkillsClient {
* })
*/
public createOrUpdate(
- request: TrueForge.settings.PutSkillRequest,
+ request: TrueForge.settings.UpdateSkillRequest,
requestOptions?: SkillsClient.RequestOptions,
): core.HttpResponsePromise<TrueForge.GetSkillResponse> {
return core.HttpResponsePromise.fromPromise(this.__createOrUpdate(request, requestOptions));
}
private async __createOrUpdate(
- request: TrueForge.settings.PutSkillRequest,
+ request: TrueForge.settings.UpdateSkillRequest,
requestOptions?: SkillsClient.RequestOptions,
): Promise<core.WithRawResponse<TrueForge.GetSkillResponse>> {
const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
@@ -277,7 +277,7 @@ export class SkillsClient {
queryString: core.url.queryBuilder().mergeAdditional(requestOptions?.queryParams).build(),
requestType: "json",
body: mergeAdditionalBodyParameters(
- serializers.settings.PutSkillRequest.jsonOrThrow(request, {
+ serializers.settings.UpdateSkillRequest.jsonOrThrow(request, {
unrecognizedObjectKeys: "passthrough",
allowUnrecognizedUnionMembers: true,
allowUnrecognizedEnumValues: true,
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/PutSkillRequest.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/UpdateSkillRequest.ts
similarity index 91%
rename from packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/PutSkillRequest.ts
rename to packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/UpdateSkillRequest.ts
index db31edba7..f8f384d1f 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/PutSkillRequest.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/UpdateSkillRequest.ts
@@ -14,6 +14,6 @@ import type * as TrueForge from "../../../../../../index.js";
* }
* }
*/
-export interface PutSkillRequest {
+export interface UpdateSkillRequest {
manifest: TrueForge.SkillManifest;
}
diff --git a/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/index.ts b/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/index.ts
index 14b4d19b6..9fcdcc8b0 100644
--- a/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/api/resources/settings/resources/skills/client/requests/index.ts
@@ -1,2 +1,2 @@
export type { CreateSkillRequest } from "./CreateSkillRequest.js";
-export type { PutSkillRequest } from "./PutSkillRequest.js";
+export type { UpdateSkillRequest } from "./UpdateSkillRequest.js";
diff --git a/packages/trueforge-sdk/src/api/types/AgentSpec.ts b/packages/trueforge-sdk/src/api/types/AgentSpec.ts
index 50d605911..62ee54f6d 100644
--- a/packages/trueforge-sdk/src/api/types/AgentSpec.ts
+++ b/packages/trueforge-sdk/src/api/types/AgentSpec.ts
@@ -11,10 +11,10 @@ export interface AgentSpec {
instructions?: string;
/** Optional MCP servers attached by configured name. */
mcpServers?: TrueForge.McpServer[];
- /** Optional seed user messages injected at the start of every session. */
- messages?: TrueForge.AgentSpecUserMessage[];
- model: TrueForge.AgentSpecModel;
+ /** Optional initial user messages injected at the start of every session. */
+ messages?: TrueForge.InitialUserMessage[];
+ model: TrueForge.Model;
responseFormat?: TrueForge.ResponseFormat;
/** Optional name-only skill references. Requires `config.sandbox.enabled: true`. */
- skills?: TrueForge.SkillNameRef[];
+ skills?: TrueForge.Skill[];
}
diff --git a/packages/trueforge-sdk/src/api/types/AgentSpecModel.ts b/packages/trueforge-sdk/src/api/types/AgentSpecModel.ts
deleted file mode 100644
index 7c46d7a4a..000000000
--- a/packages/trueforge-sdk/src/api/types/AgentSpecModel.ts
+++ /dev/null
@@ -1,9 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../index.js";
-
-export interface AgentSpecModel {
- /** Model FQN: `provider/model`, e.g. `openai/gpt-5.2`. */
- name: string;
- params?: TrueForge.ModelParams;
-}
diff --git a/packages/trueforge-sdk/src/api/types/AgentSpecUserMessage.ts b/packages/trueforge-sdk/src/api/types/AgentSpecUserMessage.ts
deleted file mode 100644
index 1370103e6..000000000
--- a/packages/trueforge-sdk/src/api/types/AgentSpecUserMessage.ts
+++ /dev/null
@@ -1,8 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-export interface AgentSpecUserMessage {
- /** Seed user message content injected at the start of every session. */
- content: string;
- /** Seed message type. */
- type: "user.message";
-}
diff --git a/packages/trueforge-sdk/src/api/types/AlibabaModelProvider.ts b/packages/trueforge-sdk/src/api/types/AlibabaModelProvider.ts
index 2dea98cee..ee97e59ba 100644
--- a/packages/trueforge-sdk/src/api/types/AlibabaModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/AlibabaModelProvider.ts
@@ -7,6 +7,6 @@ export interface AlibabaModelProvider {
/** Override of the provider's default API base URL. */
baseUrl?: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
type: "alibaba";
}
diff --git a/packages/trueforge-sdk/src/api/types/AnthropicModelProvider.ts b/packages/trueforge-sdk/src/api/types/AnthropicModelProvider.ts
index fd8a723be..2fd70e5f1 100644
--- a/packages/trueforge-sdk/src/api/types/AnthropicModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/AnthropicModelProvider.ts
@@ -7,6 +7,6 @@ export interface AnthropicModelProvider {
/** Override of the provider's default API base URL. */
baseUrl?: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
type: "anthropic";
}
diff --git a/packages/trueforge-sdk/src/api/types/McpServerReadEntry.ts b/packages/trueforge-sdk/src/api/types/AvailableMcpServer.ts
similarity index 88%
rename from packages/trueforge-sdk/src/api/types/McpServerReadEntry.ts
rename to packages/trueforge-sdk/src/api/types/AvailableMcpServer.ts
index 0342b0b6e..e0f56c181 100644
--- a/packages/trueforge-sdk/src/api/types/McpServerReadEntry.ts
+++ b/packages/trueforge-sdk/src/api/types/AvailableMcpServer.ts
@@ -2,7 +2,7 @@
import type * as TrueForge from "../index.js";
-export interface McpServerReadEntry {
+export interface AvailableMcpServer {
auth?: TrueForge.McpServerAuthPublic;
authStatus: TrueForge.McpAuthStatus;
name: TrueForge.ResourceName;
diff --git a/packages/trueforge-sdk/src/api/types/AvailableModel.ts b/packages/trueforge-sdk/src/api/types/AvailableModel.ts
new file mode 100644
index 000000000..66e14db24
--- /dev/null
+++ b/packages/trueforge-sdk/src/api/types/AvailableModel.ts
@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../index.js";
+
+export interface AvailableModel {
+ /** Upstream, provider-specific identifier sent to the provider API. */
+ modelId: string;
+ /** Fully qualified name `provider_name/model_name`, e.g. "openai/gpt-5-6-sol". Unique within a tenant. */
+ name: string;
+ properties: TrueForge.ModelProperties;
+ provider: TrueForge.AvailableModelProvider;
+}
diff --git a/packages/trueforge-sdk/src/api/types/ModelListProvider.ts b/packages/trueforge-sdk/src/api/types/AvailableModelProvider.ts
similarity index 82%
rename from packages/trueforge-sdk/src/api/types/ModelListProvider.ts
rename to packages/trueforge-sdk/src/api/types/AvailableModelProvider.ts
index 6486825da..5a055d496 100644
--- a/packages/trueforge-sdk/src/api/types/ModelListProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/AvailableModelProvider.ts
@@ -3,7 +3,7 @@
/**
* Owning configured provider.
*/
-export interface ModelListProvider {
+export interface AvailableModelProvider {
/** Configured provider resource name; matches the FQN prefix of `name`. */
name: string;
}
diff --git a/packages/trueforge-sdk/src/api/types/SkillReadEntry.ts b/packages/trueforge-sdk/src/api/types/AvailableSkill.ts
similarity index 87%
rename from packages/trueforge-sdk/src/api/types/SkillReadEntry.ts
rename to packages/trueforge-sdk/src/api/types/AvailableSkill.ts
index 2fb965b32..a633f11fb 100644
--- a/packages/trueforge-sdk/src/api/types/SkillReadEntry.ts
+++ b/packages/trueforge-sdk/src/api/types/AvailableSkill.ts
@@ -2,7 +2,7 @@
import type * as TrueForge from "../index.js";
-export interface SkillReadEntry {
+export interface AvailableSkill {
/** Concise guidance for when the agent should use the skill. */
description: string;
name: TrueForge.ResourceName;
diff --git a/packages/trueforge-sdk/src/api/types/CapabilitiesData.ts b/packages/trueforge-sdk/src/api/types/CapabilitiesData.ts
new file mode 100644
index 000000000..d0c622726
--- /dev/null
+++ b/packages/trueforge-sdk/src/api/types/CapabilitiesData.ts
@@ -0,0 +1,9 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../index.js";
+
+export interface CapabilitiesData {
+ sandbox: TrueForge.SandboxCapability;
+ settings: TrueForge.SettingsCapability;
+ skill: TrueForge.SkillCapability;
+}
diff --git a/packages/trueforge-sdk/src/api/types/ModelEntry.ts b/packages/trueforge-sdk/src/api/types/CatalogModel.ts
similarity index 90%
rename from packages/trueforge-sdk/src/api/types/ModelEntry.ts
rename to packages/trueforge-sdk/src/api/types/CatalogModel.ts
index 71576add4..c73e9678d 100644
--- a/packages/trueforge-sdk/src/api/types/ModelEntry.ts
+++ b/packages/trueforge-sdk/src/api/types/CatalogModel.ts
@@ -2,7 +2,7 @@
import type * as TrueForge from "../index.js";
-export interface ModelEntry {
+export interface CatalogModel {
/** Upstream, provider-specific identifier sent to the provider API. */
modelId: string;
name: TrueForge.ResourceName;
diff --git a/packages/trueforge-sdk/src/api/types/CatalogDaytonaSandboxProvider.ts b/packages/trueforge-sdk/src/api/types/CatalogSandboxProvider.ts
similarity index 92%
rename from packages/trueforge-sdk/src/api/types/CatalogDaytonaSandboxProvider.ts
rename to packages/trueforge-sdk/src/api/types/CatalogSandboxProvider.ts
index 2505e5787..65ae0a7f8 100644
--- a/packages/trueforge-sdk/src/api/types/CatalogDaytonaSandboxProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/CatalogSandboxProvider.ts
@@ -1,6 +1,6 @@
// This file was auto-generated by Fern from our API Definition.
-export interface CatalogDaytonaSandboxProvider {
+export interface CatalogSandboxProvider {
/** Minutes before Daytona auto-archives the sandbox (0 disables). */
autoArchiveIntervalInMinutes: number;
/** Minutes before Daytona auto-deletes the sandbox (0 disables). */
diff --git a/packages/trueforge-sdk/src/api/types/CatalogWellKnownModelProvider.ts b/packages/trueforge-sdk/src/api/types/CatalogWellKnownModelProvider.ts
index 915d30b95..748335d0a 100644
--- a/packages/trueforge-sdk/src/api/types/CatalogWellKnownModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/CatalogWellKnownModelProvider.ts
@@ -6,6 +6,6 @@ export interface CatalogWellKnownModelProvider {
/** URL of the provider logo asset */
logo?: string;
/** Preset models */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.CatalogModel[];
type: TrueForge.CatalogWellKnownModelProviderType;
}
diff --git a/packages/trueforge-sdk/src/api/types/ContextManagementConfigCompaction.ts b/packages/trueforge-sdk/src/api/types/CompactionConfig.ts
similarity index 84%
rename from packages/trueforge-sdk/src/api/types/ContextManagementConfigCompaction.ts
rename to packages/trueforge-sdk/src/api/types/CompactionConfig.ts
index ee915dea9..6eb51d648 100644
--- a/packages/trueforge-sdk/src/api/types/ContextManagementConfigCompaction.ts
+++ b/packages/trueforge-sdk/src/api/types/CompactionConfig.ts
@@ -1,6 +1,6 @@
// This file was auto-generated by Fern from our API Definition.
-export interface ContextManagementConfigCompaction {
+export interface CompactionConfig {
/** Context size in tokens that triggers compaction. Default: 50000. */
compactionThresholdTokens?: number;
/** Summarize older history when context grows too large. Default: true. */
diff --git a/packages/trueforge-sdk/src/api/types/ConfiguredModel.ts b/packages/trueforge-sdk/src/api/types/ConfiguredModel.ts
new file mode 100644
index 000000000..cdf044d63
--- /dev/null
+++ b/packages/trueforge-sdk/src/api/types/ConfiguredModel.ts
@@ -0,0 +1,10 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as TrueForge from "../index.js";
+
+export interface ConfiguredModel {
+ /** Upstream, provider-specific identifier sent to the provider API. */
+ modelId: string;
+ name: TrueForge.ResourceName;
+ properties: TrueForge.ModelProperties;
+}
diff --git a/packages/trueforge-sdk/src/api/types/ModelProvider.ts b/packages/trueforge-sdk/src/api/types/ConfiguredModelProvider.ts
similarity index 82%
rename from packages/trueforge-sdk/src/api/types/ModelProvider.ts
rename to packages/trueforge-sdk/src/api/types/ConfiguredModelProvider.ts
index 01db588bc..776ebcab1 100644
--- a/packages/trueforge-sdk/src/api/types/ModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/ConfiguredModelProvider.ts
@@ -2,7 +2,7 @@
import type * as TrueForge from "../index.js";
-export interface ModelProvider {
+export interface ConfiguredModelProvider {
manifest: TrueForge.ModelProviderManifest;
name: TrueForge.ResourceName;
}
diff --git a/packages/trueforge-sdk/src/api/types/SandboxProvider.ts b/packages/trueforge-sdk/src/api/types/ConfiguredSandboxProvider.ts
similarity index 87%
rename from packages/trueforge-sdk/src/api/types/SandboxProvider.ts
rename to packages/trueforge-sdk/src/api/types/ConfiguredSandboxProvider.ts
index 7ac73aac7..d766d8e2d 100644
--- a/packages/trueforge-sdk/src/api/types/SandboxProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/ConfiguredSandboxProvider.ts
@@ -2,7 +2,7 @@
import type * as TrueForge from "../index.js";
-export interface SandboxProvider {
+export interface ConfiguredSandboxProvider {
manifest: TrueForge.SandboxProviderManifest;
status: TrueForge.SandboxBuildStatus;
/** Human-readable detail for the current status; null when ready. */
diff --git a/packages/trueforge-sdk/src/api/types/ContextManagementConfig.ts b/packages/trueforge-sdk/src/api/types/ContextManagementConfig.ts
index 4ac417b5b..385b387d7 100644
--- a/packages/trueforge-sdk/src/api/types/ContextManagementConfig.ts
+++ b/packages/trueforge-sdk/src/api/types/ContextManagementConfig.ts
@@ -3,6 +3,6 @@
import type * as TrueForge from "../index.js";
export interface ContextManagementConfig {
- compaction?: TrueForge.ContextManagementConfigCompaction;
+ compaction?: TrueForge.CompactionConfig;
largeToolResponse?: TrueForge.LargeToolResponseConfig;
}
diff --git a/packages/trueforge-sdk/src/api/types/CustomModelProvider.ts b/packages/trueforge-sdk/src/api/types/CustomModelProvider.ts
index 51f2cea0b..086668c28 100644
--- a/packages/trueforge-sdk/src/api/types/CustomModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/CustomModelProvider.ts
@@ -7,7 +7,7 @@ export interface CustomModelProvider {
/** Base URL of the provider's API. */
baseUrl: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
name: TrueForge.ResourceName;
type: "custom";
}
diff --git a/packages/trueforge-sdk/src/api/types/FireworksModelProvider.ts b/packages/trueforge-sdk/src/api/types/FireworksModelProvider.ts
index 5519c07c7..98cb702b5 100644
--- a/packages/trueforge-sdk/src/api/types/FireworksModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/FireworksModelProvider.ts
@@ -7,6 +7,6 @@ export interface FireworksModelProvider {
/** Override of the provider's default API base URL. */
baseUrl?: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
type: "fireworks";
}
diff --git a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponse.ts b/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponse.ts
index 503a293fe..42e1b2fe6 100644
--- a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponse.ts
@@ -3,5 +3,5 @@
import type * as TrueForge from "../index.js";
export interface GetCapabilitiesResponse {
- data: TrueForge.GetCapabilitiesResponseData;
+ data: TrueForge.CapabilitiesData;
}
diff --git a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseData.ts b/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseData.ts
deleted file mode 100644
index 713efd8d3..000000000
--- a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseData.ts
+++ /dev/null
@@ -1,9 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-import type * as TrueForge from "../index.js";
-
-export interface GetCapabilitiesResponseData {
- sandbox: TrueForge.GetCapabilitiesResponseDataSandbox;
- settings: TrueForge.GetCapabilitiesResponseDataSettings;
- skill: TrueForge.GetCapabilitiesResponseDataSkill;
-}
diff --git a/packages/trueforge-sdk/src/api/types/MeResponse.ts b/packages/trueforge-sdk/src/api/types/GetMeResponse.ts
similarity index 83%
rename from packages/trueforge-sdk/src/api/types/MeResponse.ts
rename to packages/trueforge-sdk/src/api/types/GetMeResponse.ts
index adb5cb33b..9eed69410 100644
--- a/packages/trueforge-sdk/src/api/types/MeResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/GetMeResponse.ts
@@ -2,11 +2,11 @@
import type * as TrueForge from "../index.js";
-export interface MeResponse {
+export interface GetMeResponse {
/** User email from the ID token when connected; `"default"` when anonymous. */
email: string;
/** Caller role. */
role: string;
/** Session kind: `default` when no valid OIDC session; `oidc-connected` after a successful browser login. */
- type: TrueForge.MeResponseType;
+ type: TrueForge.GetMeResponseType;
}
diff --git a/packages/trueforge-sdk/src/api/types/MeResponseType.ts b/packages/trueforge-sdk/src/api/types/GetMeResponseType.ts
similarity index 66%
rename from packages/trueforge-sdk/src/api/types/MeResponseType.ts
rename to packages/trueforge-sdk/src/api/types/GetMeResponseType.ts
index 171931a93..1779fa3af 100644
--- a/packages/trueforge-sdk/src/api/types/MeResponseType.ts
+++ b/packages/trueforge-sdk/src/api/types/GetMeResponseType.ts
@@ -1,8 +1,8 @@
// This file was auto-generated by Fern from our API Definition.
/** Session kind: `default` when no valid OIDC session; `oidc-connected` after a successful browser login. */
-export const MeResponseType = {
+export const GetMeResponseType = {
Default: "default",
OidcConnected: "oidc-connected",
} as const;
-export type MeResponseType = (typeof MeResponseType)[keyof typeof MeResponseType];
+export type GetMeResponseType = (typeof GetMeResponseType)[keyof typeof GetMeResponseType];
diff --git a/packages/trueforge-sdk/src/api/types/GetModelProviderResponse.ts b/packages/trueforge-sdk/src/api/types/GetModelProviderResponse.ts
index 584edb738..ad2de2b4e 100644
--- a/packages/trueforge-sdk/src/api/types/GetModelProviderResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/GetModelProviderResponse.ts
@@ -3,5 +3,5 @@
import type * as TrueForge from "../index.js";
export interface GetModelProviderResponse {
- data: TrueForge.ModelProvider;
+ data: TrueForge.ConfiguredModelProvider;
}
diff --git a/packages/trueforge-sdk/src/api/types/GetSandboxProviderCatalogResponse.ts b/packages/trueforge-sdk/src/api/types/GetSandboxProviderCatalogResponse.ts
index 66279d3ed..856b88a77 100644
--- a/packages/trueforge-sdk/src/api/types/GetSandboxProviderCatalogResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/GetSandboxProviderCatalogResponse.ts
@@ -3,5 +3,5 @@
import type * as TrueForge from "../index.js";
export interface GetSandboxProviderCatalogResponse {
- data: TrueForge.CatalogDaytonaSandboxProvider[];
+ data: TrueForge.CatalogSandboxProvider[];
}
diff --git a/packages/trueforge-sdk/src/api/types/GetSandboxProviderResponse.ts b/packages/trueforge-sdk/src/api/types/GetSandboxProviderResponse.ts
index 9dfbea272..7fe91194b 100644
--- a/packages/trueforge-sdk/src/api/types/GetSandboxProviderResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/GetSandboxProviderResponse.ts
@@ -3,5 +3,5 @@
import type * as TrueForge from "../index.js";
export interface GetSandboxProviderResponse {
- data: TrueForge.SandboxProvider;
+ data: TrueForge.ConfiguredSandboxProvider;
}
diff --git a/packages/trueforge-sdk/src/api/types/GoogleGeminiModelProvider.ts b/packages/trueforge-sdk/src/api/types/GoogleGeminiModelProvider.ts
index fdbce3136..73a31f333 100644
--- a/packages/trueforge-sdk/src/api/types/GoogleGeminiModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/GoogleGeminiModelProvider.ts
@@ -7,6 +7,6 @@ export interface GoogleGeminiModelProvider {
/** Override of the provider's default API base URL. */
baseUrl?: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
type: "google-gemini";
}
diff --git a/packages/trueforge-sdk/src/api/types/InitialUserMessage.ts b/packages/trueforge-sdk/src/api/types/InitialUserMessage.ts
new file mode 100644
index 000000000..187c92e79
--- /dev/null
+++ b/packages/trueforge-sdk/src/api/types/InitialUserMessage.ts
@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export interface InitialUserMessage {
+ /** Initial user message content injected at the start of every session. */
+ content: string;
+ /** Initial message type. */
+ type: "user.message";
+}
diff --git a/packages/trueforge-sdk/src/api/types/ListAvailableMcpServersResponse.ts b/packages/trueforge-sdk/src/api/types/ListAvailableMcpServersResponse.ts
index ddad279b0..6801fb973 100644
--- a/packages/trueforge-sdk/src/api/types/ListAvailableMcpServersResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/ListAvailableMcpServersResponse.ts
@@ -3,5 +3,5 @@
import type * as TrueForge from "../index.js";
export interface ListAvailableMcpServersResponse {
- data: TrueForge.McpServerReadEntry[];
+ data: TrueForge.AvailableMcpServer[];
}
diff --git a/packages/trueforge-sdk/src/api/types/ListModelsResponse.ts b/packages/trueforge-sdk/src/api/types/ListAvailableModelsResponse.ts
similarity index 57%
rename from packages/trueforge-sdk/src/api/types/ListModelsResponse.ts
rename to packages/trueforge-sdk/src/api/types/ListAvailableModelsResponse.ts
index 3677ed1f2..50fb27bcc 100644
--- a/packages/trueforge-sdk/src/api/types/ListModelsResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/ListAvailableModelsResponse.ts
@@ -2,6 +2,6 @@
import type * as TrueForge from "../index.js";
-export interface ListModelsResponse {
- data: TrueForge.Model[];
+export interface ListAvailableModelsResponse {
+ data: TrueForge.AvailableModel[];
}
diff --git a/packages/trueforge-sdk/src/api/types/ListAvailableSkillsResponse.ts b/packages/trueforge-sdk/src/api/types/ListAvailableSkillsResponse.ts
index fe3fac3d6..e1716cd4f 100644
--- a/packages/trueforge-sdk/src/api/types/ListAvailableSkillsResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/ListAvailableSkillsResponse.ts
@@ -3,5 +3,5 @@
import type * as TrueForge from "../index.js";
export interface ListAvailableSkillsResponse {
- data: TrueForge.SkillReadEntry[];
+ data: TrueForge.AvailableSkill[];
}
diff --git a/packages/trueforge-sdk/src/api/types/ListModelProvidersResponse.ts b/packages/trueforge-sdk/src/api/types/ListModelProvidersResponse.ts
index 552a712ca..471fe5478 100644
--- a/packages/trueforge-sdk/src/api/types/ListModelProvidersResponse.ts
+++ b/packages/trueforge-sdk/src/api/types/ListModelProvidersResponse.ts
@@ -3,5 +3,5 @@
import type * as TrueForge from "../index.js";
export interface ListModelProvidersResponse {
- data: TrueForge.ModelProvider[];
+ data: TrueForge.ConfiguredModelProvider[];
}
diff --git a/packages/trueforge-sdk/src/api/types/McpServer.ts b/packages/trueforge-sdk/src/api/types/McpServer.ts
index 900aaaf90..2b0f8ee06 100644
--- a/packages/trueforge-sdk/src/api/types/McpServer.ts
+++ b/packages/trueforge-sdk/src/api/types/McpServer.ts
@@ -4,15 +4,15 @@ import type * as TrueForge from "../index.js";
export interface McpServer {
/** Tools subtracted from the enabled set. Default: none. */
- disableTools?: TrueForge.McpServerDisableToolsItem[];
+ disableTools?: TrueForge.McpServerToolSelector[];
/** Tools exposed to the agent: `@all`, `@read-only`, or literal tool names. Default: `["@all"]`. */
- enableTools?: TrueForge.McpServerEnableToolsItem[];
+ enableTools?: TrueForge.McpServerToolSelector[];
/** Name of a configured MCP server (Settings → Connectors). */
name: string;
/** When true, load all tool schemas upfront. Default: false (deferred discovery). */
preload?: boolean;
/** Tools loaded eagerly into context while the rest stay deferred. A non-empty list implies `preload: false`. */
- preloadTools?: TrueForge.McpServerPreloadToolsItem[];
+ preloadTools?: TrueForge.McpServerToolSelector[];
/** Tools that pause for human approval: `@all`, `@write`, `@destructive`, or literal names. Default: `["@write", "@destructive"]`. */
- requireApprovalForTools?: TrueForge.McpServerRequireApprovalForToolsItem[];
+ requireApprovalForTools?: TrueForge.McpServerApprovalToolSelector[];
}
diff --git a/packages/trueforge-sdk/src/api/types/McpServerApprovalToolSelector.ts b/packages/trueforge-sdk/src/api/types/McpServerApprovalToolSelector.ts
new file mode 100644
index 000000000..c60698886
--- /dev/null
+++ b/packages/trueforge-sdk/src/api/types/McpServerApprovalToolSelector.ts
@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export type McpServerApprovalToolSelector = "@all" | "@write" | "@destructive" | string;
diff --git a/packages/trueforge-sdk/src/api/types/McpServerDisableToolsItem.ts b/packages/trueforge-sdk/src/api/types/McpServerDisableToolsItem.ts
deleted file mode 100644
index 6c4b43993..000000000
--- a/packages/trueforge-sdk/src/api/types/McpServerDisableToolsItem.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-export type McpServerDisableToolsItem = "@all" | "@read-only" | string;
diff --git a/packages/trueforge-sdk/src/api/types/McpServerEnableToolsItem.ts b/packages/trueforge-sdk/src/api/types/McpServerEnableToolsItem.ts
deleted file mode 100644
index 4a00f30d9..000000000
--- a/packages/trueforge-sdk/src/api/types/McpServerEnableToolsItem.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-export type McpServerEnableToolsItem = "@all" | "@read-only" | string;
diff --git a/packages/trueforge-sdk/src/api/types/McpServerPreloadToolsItem.ts b/packages/trueforge-sdk/src/api/types/McpServerPreloadToolsItem.ts
deleted file mode 100644
index 4e1374047..000000000
--- a/packages/trueforge-sdk/src/api/types/McpServerPreloadToolsItem.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-export type McpServerPreloadToolsItem = "@all" | "@read-only" | string;
diff --git a/packages/trueforge-sdk/src/api/types/McpServerRequireApprovalForToolsItem.ts b/packages/trueforge-sdk/src/api/types/McpServerRequireApprovalForToolsItem.ts
deleted file mode 100644
index 1299f0927..000000000
--- a/packages/trueforge-sdk/src/api/types/McpServerRequireApprovalForToolsItem.ts
+++ /dev/null
@@ -1,3 +0,0 @@
-// This file was auto-generated by Fern from our API Definition.
-
-export type McpServerRequireApprovalForToolsItem = "@all" | "@write" | "@destructive" | string;
diff --git a/packages/trueforge-sdk/src/api/types/McpServerToolSelector.ts b/packages/trueforge-sdk/src/api/types/McpServerToolSelector.ts
new file mode 100644
index 000000000..fa3f27c21
--- /dev/null
+++ b/packages/trueforge-sdk/src/api/types/McpServerToolSelector.ts
@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export type McpServerToolSelector = "@all" | "@read-only" | string;
diff --git a/packages/trueforge-sdk/src/api/types/Model.ts b/packages/trueforge-sdk/src/api/types/Model.ts
index 7c785bfd1..b3ae81da6 100644
--- a/packages/trueforge-sdk/src/api/types/Model.ts
+++ b/packages/trueforge-sdk/src/api/types/Model.ts
@@ -3,10 +3,7 @@
import type * as TrueForge from "../index.js";
export interface Model {
- /** Upstream, provider-specific identifier sent to the provider API. */
- modelId: string;
- /** Fully qualified name `provider_name/model_name`, e.g. "openai/gpt-5-6-sol". Unique within a tenant. */
+ /** Model FQN: `provider/model`, e.g. `openai/gpt-5.2`. */
name: string;
- properties: TrueForge.ModelProperties;
- provider: TrueForge.ModelListProvider;
+ params?: TrueForge.ModelParams;
}
diff --git a/packages/trueforge-sdk/src/api/types/MoonshotModelProvider.ts b/packages/trueforge-sdk/src/api/types/MoonshotModelProvider.ts
index a6d00937b..f8dd30bcd 100644
--- a/packages/trueforge-sdk/src/api/types/MoonshotModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/MoonshotModelProvider.ts
@@ -7,6 +7,6 @@ export interface MoonshotModelProvider {
/** Override of the provider's default API base URL. */
baseUrl?: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
type: "moonshot";
}
diff --git a/packages/trueforge-sdk/src/api/types/OpenAiModelProvider.ts b/packages/trueforge-sdk/src/api/types/OpenAiModelProvider.ts
index b26ce0e75..7942d8ce3 100644
--- a/packages/trueforge-sdk/src/api/types/OpenAiModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/OpenAiModelProvider.ts
@@ -7,6 +7,6 @@ export interface OpenAiModelProvider {
/** Override of the provider's default API base URL. */
baseUrl?: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
type: "openai";
}
diff --git a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSandbox.ts b/packages/trueforge-sdk/src/api/types/SandboxCapability.ts
similarity index 74%
rename from packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSandbox.ts
rename to packages/trueforge-sdk/src/api/types/SandboxCapability.ts
index 14791c45c..4cf0d24c8 100644
--- a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSandbox.ts
+++ b/packages/trueforge-sdk/src/api/types/SandboxCapability.ts
@@ -1,6 +1,6 @@
// This file was auto-generated by Fern from our API Definition.
-export interface GetCapabilitiesResponseDataSandbox {
+export interface SandboxCapability {
/** Whether a sandbox provider is configured for this tenant. */
enabled: boolean;
}
diff --git a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSettings.ts b/packages/trueforge-sdk/src/api/types/SettingsCapability.ts
similarity index 71%
rename from packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSettings.ts
rename to packages/trueforge-sdk/src/api/types/SettingsCapability.ts
index cc6a42acc..33234aef7 100644
--- a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSettings.ts
+++ b/packages/trueforge-sdk/src/api/types/SettingsCapability.ts
@@ -1,6 +1,6 @@
// This file was auto-generated by Fern from our API Definition.
-export interface GetCapabilitiesResponseDataSettings {
+export interface SettingsCapability {
/** Whether the settings UI/API is enabled. */
enabled: boolean;
}
diff --git a/packages/trueforge-sdk/src/api/types/SkillNameRef.ts b/packages/trueforge-sdk/src/api/types/Skill.ts
similarity index 84%
rename from packages/trueforge-sdk/src/api/types/SkillNameRef.ts
rename to packages/trueforge-sdk/src/api/types/Skill.ts
index 33c4d1af2..00b7f916e 100644
--- a/packages/trueforge-sdk/src/api/types/SkillNameRef.ts
+++ b/packages/trueforge-sdk/src/api/types/Skill.ts
@@ -1,6 +1,6 @@
// This file was auto-generated by Fern from our API Definition.
-export interface SkillNameRef {
+export interface Skill {
/** Name of a configured skill (also used as the skill directory name in the sandbox). */
name: string;
}
diff --git a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSkill.ts b/packages/trueforge-sdk/src/api/types/SkillCapability.ts
similarity index 84%
rename from packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSkill.ts
rename to packages/trueforge-sdk/src/api/types/SkillCapability.ts
index 10ddf84af..585eedd82 100644
--- a/packages/trueforge-sdk/src/api/types/GetCapabilitiesResponseDataSkill.ts
+++ b/packages/trueforge-sdk/src/api/types/SkillCapability.ts
@@ -1,6 +1,6 @@
// This file was auto-generated by Fern from our API Definition.
-export interface GetCapabilitiesResponseDataSkill {
+export interface SkillCapability {
/** Whether skills are available. False when sandbox is not enabled (skills require a sandbox). */
enabled: boolean;
/** Present when skills are disabled. Explains why. */
diff --git a/packages/trueforge-sdk/src/api/types/TogetherAiModelProvider.ts b/packages/trueforge-sdk/src/api/types/TogetherAiModelProvider.ts
index 957fc632e..638624da2 100644
--- a/packages/trueforge-sdk/src/api/types/TogetherAiModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/TogetherAiModelProvider.ts
@@ -7,6 +7,6 @@ export interface TogetherAiModelProvider {
/** Override of the provider's default API base URL. */
baseUrl?: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
type: "together";
}
diff --git a/packages/trueforge-sdk/src/api/types/ZaiModelProvider.ts b/packages/trueforge-sdk/src/api/types/ZaiModelProvider.ts
index ff48b99ba..77739ea02 100644
--- a/packages/trueforge-sdk/src/api/types/ZaiModelProvider.ts
+++ b/packages/trueforge-sdk/src/api/types/ZaiModelProvider.ts
@@ -7,6 +7,6 @@ export interface ZaiModelProvider {
/** Override of the provider's default API base URL. */
baseUrl?: string;
/** Models exposed by this provider (at least one). */
- models: TrueForge.ModelEntry[];
+ models: TrueForge.ConfiguredModel[];
type: "zai";
}
diff --git a/packages/trueforge-sdk/src/api/types/index.ts b/packages/trueforge-sdk/src/api/types/index.ts
index ab8c00f19..18f7a281b 100644
--- a/packages/trueforge-sdk/src/api/types/index.ts
+++ b/packages/trueforge-sdk/src/api/types/index.ts
@@ -3,21 +3,25 @@ export * from "./Agent.js";
export * from "./AgentInfo.js";
export * from "./AgentParent.js";
export * from "./AgentSpec.js";
-export * from "./AgentSpecModel.js";
-export * from "./AgentSpecUserMessage.js";
export * from "./AlibabaModelProvider.js";
export * from "./AnthropicModelProvider.js";
export * from "./ApprovalAllow.js";
export * from "./ApprovalDecision.js";
export * from "./ApprovalDeny.js";
export * from "./AskUserQuestionsConfig.js";
+export * from "./AvailableMcpServer.js";
+export * from "./AvailableModel.js";
+export * from "./AvailableModelProvider.js";
+export * from "./AvailableSkill.js";
export * from "./BaseMcpAuthRequiredEvent.js";
export * from "./BaseThreadDoneEvent.js";
export * from "./CancelSessionResponse.js";
+export * from "./CapabilitiesData.js";
export * from "./CatalogCustomModelProvider.js";
-export * from "./CatalogDaytonaSandboxProvider.js";
export * from "./CatalogMcpServer.js";
+export * from "./CatalogModel.js";
export * from "./CatalogModelProvider.js";
+export * from "./CatalogSandboxProvider.js";
export * from "./CatalogSkill.js";
export * from "./CatalogWellKnownModelProvider.js";
export * from "./CatalogWellKnownModelProviderType.js";
@@ -27,10 +31,13 @@ export * from "./ChatCompletionContentPartRefusal.js";
export * from "./ChatCompletionContentPartText.js";
export * from "./ChatCompletionMessageToolCall.js";
export * from "./ChatCompletionMessageToolCallFunction.js";
+export * from "./CompactionConfig.js";
export * from "./ConfiguredMcpServer.js";
+export * from "./ConfiguredModel.js";
+export * from "./ConfiguredModelProvider.js";
+export * from "./ConfiguredSandboxProvider.js";
export * from "./ConfiguredSkill.js";
export * from "./ContextManagementConfig.js";
-export * from "./ContextManagementConfigCompaction.js";
export * from "./CreateSessionAgent.js";
export * from "./CustomModelProvider.js";
export * from "./DaytonaSandboxProviderAuth.js";
@@ -43,12 +50,10 @@ export * from "./FireworksModelProvider.js";
export * from "./GenerativeUiConfig.js";
export * from "./GetAgentResponse.js";
export * from "./GetCapabilitiesResponse.js";
-export * from "./GetCapabilitiesResponseData.js";
-export * from "./GetCapabilitiesResponseDataSandbox.js";
-export * from "./GetCapabilitiesResponseDataSettings.js";
-export * from "./GetCapabilitiesResponseDataSkill.js";
export * from "./GetMcpServerCatalogResponse.js";
export * from "./GetMcpServerResponse.js";
+export * from "./GetMeResponse.js";
+export * from "./GetMeResponseType.js";
export * from "./GetModelProviderCatalogResponse.js";
export * from "./GetModelProviderResponse.js";
export * from "./GetSandboxProviderCatalogResponse.js";
@@ -58,14 +63,15 @@ export * from "./GetSkillCatalogResponse.js";
export * from "./GetSkillResponse.js";
export * from "./GetTurnResponse.js";
export * from "./GoogleGeminiModelProvider.js";
+export * from "./InitialUserMessage.js";
export * from "./LargeToolResponseConfig.js";
export * from "./ListAgentsResponse.js";
export * from "./ListAvailableMcpServersResponse.js";
+export * from "./ListAvailableModelsResponse.js";
export * from "./ListAvailableSkillsResponse.js";
export * from "./ListMcpServersResponse.js";
export * from "./ListMcpServerToolsResponse.js";
export * from "./ListModelProvidersResponse.js";
-export * from "./ListModelsResponse.js";
export * from "./ListSessionEventsResponse.js";
export * from "./ListSessionsOrder.js";
export * from "./ListSessionsResponse.js";
@@ -78,28 +84,21 @@ export * from "./McpAuthStatus.js";
export * from "./McpAuthStatusStatus.js";
export * from "./McpInitializeEvent.js";
export * from "./McpServer.js";
+export * from "./McpServerApprovalToolSelector.js";
export * from "./McpServerAuthInfo.js";
export * from "./McpServerAuthPublic.js";
export * from "./McpServerAuthPublicOne.js";
export * from "./McpServerAuthPublicZero.js";
export * from "./McpServerDcrAuth.js";
-export * from "./McpServerDisableToolsItem.js";
-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";
+export * from "./McpServerToolSelector.js";
export * from "./McpServerType.js";
export * from "./McpToolInfo.js";
-export * from "./MeResponse.js";
-export * from "./MeResponseType.js";
export * from "./Model.js";
-export * from "./ModelEntry.js";
-export * from "./ModelListProvider.js";
export * from "./ModelMessageDeltaEvent.js";
export * from "./ModelMessageEvent.js";
export * from "./ModelMessageEventContent.js";
@@ -108,7 +107,6 @@ export * from "./ModelMessageUsage.js";
export * from "./ModelMessageUsageInputTokensBreakdown.js";
export * from "./ModelParams.js";
export * from "./ModelProperties.js";
-export * from "./ModelProvider.js";
export * from "./ModelProviderAuth.js";
export * from "./ModelProviderManifest.js";
export * from "./MoonshotModelProvider.js";
@@ -126,9 +124,9 @@ export * from "./ResponseFormatJsonSchemaJsonSchema.js";
export * from "./ResponseFormatText.js";
export * from "./RuntimeConfig.js";
export * from "./SandboxBuildStatus.js";
+export * from "./SandboxCapability.js";
export * from "./SandboxConfig.js";
export * from "./SandboxCreatedEvent.js";
-export * from "./SandboxProvider.js";
export * from "./SandboxProviderManifest.js";
export * from "./Session.js";
export * from "./SessionAgent.js";
@@ -138,9 +136,10 @@ export * from "./SessionAgentReference.js";
export * from "./SessionAgentSpecBody.js";
export * from "./SessionEvent.js";
export * from "./SessionEventItem.js";
+export * from "./SettingsCapability.js";
+export * from "./Skill.js";
+export * from "./SkillCapability.js";
export * from "./SkillManifest.js";
-export * from "./SkillNameRef.js";
-export * from "./SkillReadEntry.js";
export * from "./SkillType.js";
export * from "./TextContent.js";
export * from "./ThreadCreatedEvent.js";
diff --git a/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/PutAgentRequest.ts b/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts
similarity index 60%
rename from packages/trueforge-sdk/src/serialization/resources/agents/client/requests/PutAgentRequest.ts
rename to packages/trueforge-sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts
index 4c3f44ff1..5ead63d5b 100644
--- a/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/PutAgentRequest.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts
@@ -5,12 +5,14 @@ import * as core from "../../../../../core/index.js";
import type * as serializers from "../../../../index.js";
import { AgentSpec } from "../../../../types/AgentSpec.js";
-export const PutAgentRequest: core.serialization.Schema<serializers.PutAgentRequest.Raw, TrueForge.PutAgentRequest> =
- core.serialization.object({
- manifest: AgentSpec,
- });
+export const UpdateAgentRequest: core.serialization.Schema<
+ serializers.UpdateAgentRequest.Raw,
+ TrueForge.UpdateAgentRequest
+> = core.serialization.object({
+ manifest: AgentSpec,
+});
-export declare namespace PutAgentRequest {
+export declare namespace UpdateAgentRequest {
export interface Raw {
manifest: AgentSpec.Raw;
}
diff --git a/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/index.ts b/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/index.ts
index a656b83ed..a078b9db0 100644
--- a/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/agents/client/requests/index.ts
@@ -1,2 +1,2 @@
export { CreateAgentRequest } from "./CreateAgentRequest.js";
-export { PutAgentRequest } from "./PutAgentRequest.js";
+export { UpdateAgentRequest } from "./UpdateAgentRequest.js";
diff --git a/packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts b/packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/UpdateMcpServerRequest.ts
similarity index 69%
rename from packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts
rename to packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/UpdateMcpServerRequest.ts
index 448505cdb..f1cbc0ffe 100644
--- a/packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/PutMcpServerRequest.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/UpdateMcpServerRequest.ts
@@ -5,14 +5,14 @@ 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
+export const UpdateMcpServerRequest: core.serialization.Schema<
+ serializers.settings.UpdateMcpServerRequest.Raw,
+ TrueForge.settings.UpdateMcpServerRequest
> = core.serialization.object({
manifest: McpServerManifest,
});
-export declare namespace PutMcpServerRequest {
+export declare namespace UpdateMcpServerRequest {
export interface Raw {
manifest: McpServerManifest.Raw;
}
diff --git a/packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/index.ts b/packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/index.ts
index 989c1f851..d76ef56d7 100644
--- a/packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/settings/resources/mcpServers/client/requests/index.ts
@@ -1,2 +1,2 @@
export { CreateMcpServerRequest } from "./CreateMcpServerRequest.js";
-export { PutMcpServerRequest } from "./PutMcpServerRequest.js";
+export { UpdateMcpServerRequest } from "./UpdateMcpServerRequest.js";
diff --git a/packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts b/packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/UpdateModelProviderRequest.ts
similarity index 68%
rename from packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts
rename to packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/UpdateModelProviderRequest.ts
index 8cb14a1a6..d2416393b 100644
--- a/packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/PutModelProviderRequest.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/UpdateModelProviderRequest.ts
@@ -5,14 +5,14 @@ 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
+export const UpdateModelProviderRequest: core.serialization.Schema<
+ serializers.settings.UpdateModelProviderRequest.Raw,
+ TrueForge.settings.UpdateModelProviderRequest
> = core.serialization.object({
manifest: ModelProviderManifest,
});
-export declare namespace PutModelProviderRequest {
+export declare namespace UpdateModelProviderRequest {
export interface Raw {
manifest: ModelProviderManifest.Raw;
}
diff --git a/packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/index.ts b/packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/index.ts
index 81f829943..25b7fd457 100644
--- a/packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/settings/resources/modelProviders/client/requests/index.ts
@@ -1,2 +1,2 @@
export { CreateModelProviderRequest } from "./CreateModelProviderRequest.js";
-export { PutModelProviderRequest } from "./PutModelProviderRequest.js";
+export { UpdateModelProviderRequest } from "./UpdateModelProviderRequest.js";
diff --git a/packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts b/packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/UpdateSandboxProviderRequest.ts
similarity index 68%
rename from packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts
rename to packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/UpdateSandboxProviderRequest.ts
index ed980b2f9..fe5ab25be 100644
--- a/packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/PutSandboxProviderRequest.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/UpdateSandboxProviderRequest.ts
@@ -5,14 +5,14 @@ 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
+export const UpdateSandboxProviderRequest: core.serialization.Schema<
+ serializers.settings.UpdateSandboxProviderRequest.Raw,
+ TrueForge.settings.UpdateSandboxProviderRequest
> = core.serialization.object({
manifest: SandboxProviderManifest,
});
-export declare namespace PutSandboxProviderRequest {
+export declare namespace UpdateSandboxProviderRequest {
export interface Raw {
manifest: SandboxProviderManifest.Raw;
}
diff --git a/packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/index.ts b/packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/index.ts
index 403325eda..0052f3ecf 100644
--- a/packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/settings/resources/sandboxProviders/client/requests/index.ts
@@ -1 +1 @@
-export { PutSandboxProviderRequest } from "./PutSandboxProviderRequest.js";
+export { UpdateSandboxProviderRequest } from "./UpdateSandboxProviderRequest.js";
diff --git a/packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/PutSkillRequest.ts b/packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/UpdateSkillRequest.ts
similarity index 70%
rename from packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/PutSkillRequest.ts
rename to packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/UpdateSkillRequest.ts
index ff096bf7d..ecd8b6b72 100644
--- a/packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/PutSkillRequest.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/UpdateSkillRequest.ts
@@ -5,14 +5,14 @@ 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
+export const UpdateSkillRequest: core.serialization.Schema<
+ serializers.settings.UpdateSkillRequest.Raw,
+ TrueForge.settings.UpdateSkillRequest
> = core.serialization.object({
manifest: SkillManifest,
});
-export declare namespace PutSkillRequest {
+export declare namespace UpdateSkillRequest {
export interface Raw {
manifest: SkillManifest.Raw;
}
diff --git a/packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/index.ts b/packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/index.ts
index ed2b49c7a..001ca47f7 100644
--- a/packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/index.ts
+++ b/packages/trueforge-sdk/src/serialization/resources/settings/resources/skills/client/requests/index.ts
@@ -1,2 +1,2 @@
export { CreateSkillRequest } from "./CreateSkillRequest.js";
-export { PutSkillRequest } from "./PutSkillRequest.js";
+export { UpdateSkillRequest } from "./UpdateSkillRequest.js";
diff --git a/packages/trueforge-sdk/src/serialization/types/AgentSpec.ts b/packages/trueforge-sdk/src/serialization/types/AgentSpec.ts
index 57d0f9781..6152257e7 100644
--- a/packages/trueforge-sdk/src/serialization/types/AgentSpec.ts
+++ b/packages/trueforge-sdk/src/serialization/types/AgentSpec.ts
@@ -3,22 +3,22 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { AgentSpecModel } from "./AgentSpecModel.js";
-import { AgentSpecUserMessage } from "./AgentSpecUserMessage.js";
+import { InitialUserMessage } from "./InitialUserMessage.js";
import { McpServer } from "./McpServer.js";
+import { Model } from "./Model.js";
import { ResponseFormat } from "./ResponseFormat.js";
import { RuntimeConfig } from "./RuntimeConfig.js";
-import { SkillNameRef } from "./SkillNameRef.js";
+import { Skill } from "./Skill.js";
export const AgentSpec: core.serialization.ObjectSchema<serializers.AgentSpec.Raw, TrueForge.AgentSpec> =
core.serialization.object({
config: RuntimeConfig.optional(),
instructions: core.serialization.string().optional(),
mcpServers: core.serialization.property("mcp_servers", core.serialization.list(McpServer).optional()),
- messages: core.serialization.list(AgentSpecUserMessage).optional(),
- model: AgentSpecModel,
+ messages: core.serialization.list(InitialUserMessage).optional(),
+ model: Model,
responseFormat: core.serialization.property("response_format", ResponseFormat.optional()),
- skills: core.serialization.list(SkillNameRef).optional(),
+ skills: core.serialization.list(Skill).optional(),
});
export declare namespace AgentSpec {
@@ -26,9 +26,9 @@ export declare namespace AgentSpec {
config?: RuntimeConfig.Raw | null;
instructions?: string | null;
mcp_servers?: McpServer.Raw[] | null;
- messages?: AgentSpecUserMessage.Raw[] | null;
- model: AgentSpecModel.Raw;
+ messages?: InitialUserMessage.Raw[] | null;
+ model: Model.Raw;
response_format?: ResponseFormat.Raw | null;
- skills?: SkillNameRef.Raw[] | null;
+ skills?: Skill.Raw[] | null;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/AgentSpecModel.ts b/packages/trueforge-sdk/src/serialization/types/AgentSpecModel.ts
deleted file mode 100644
index afbcd7a2b..000000000
--- a/packages/trueforge-sdk/src/serialization/types/AgentSpecModel.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 { ModelParams } from "./ModelParams.js";
-
-export const AgentSpecModel: core.serialization.ObjectSchema<serializers.AgentSpecModel.Raw, TrueForge.AgentSpecModel> =
- core.serialization.object({
- name: core.serialization.string(),
- params: ModelParams.optional(),
- });
-
-export declare namespace AgentSpecModel {
- export interface Raw {
- name: string;
- params?: ModelParams.Raw | null;
- }
-}
diff --git a/packages/trueforge-sdk/src/serialization/types/AlibabaModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/AlibabaModelProvider.ts
index c0346bc56..88edba38c 100644
--- a/packages/trueforge-sdk/src/serialization/types/AlibabaModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/AlibabaModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
export const AlibabaModelProvider: core.serialization.ObjectSchema<
@@ -12,7 +12,7 @@ export const AlibabaModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth,
baseUrl: core.serialization.property("base_url", core.serialization.string().optional()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
type: core.serialization.stringLiteral("alibaba"),
});
@@ -20,7 +20,7 @@ export declare namespace AlibabaModelProvider {
export interface Raw {
auth: ModelProviderAuth.Raw;
base_url?: string | null;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
type: "alibaba";
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/AnthropicModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/AnthropicModelProvider.ts
index 1f8411f79..35503136b 100644
--- a/packages/trueforge-sdk/src/serialization/types/AnthropicModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/AnthropicModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
export const AnthropicModelProvider: core.serialization.ObjectSchema<
@@ -12,7 +12,7 @@ export const AnthropicModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth,
baseUrl: core.serialization.property("base_url", core.serialization.string().optional()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
type: core.serialization.stringLiteral("anthropic"),
});
@@ -20,7 +20,7 @@ export declare namespace AnthropicModelProvider {
export interface Raw {
auth: ModelProviderAuth.Raw;
base_url?: string | null;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
type: "anthropic";
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/McpServerReadEntry.ts b/packages/trueforge-sdk/src/serialization/types/AvailableMcpServer.ts
similarity index 80%
rename from packages/trueforge-sdk/src/serialization/types/McpServerReadEntry.ts
rename to packages/trueforge-sdk/src/serialization/types/AvailableMcpServer.ts
index a5e2d7c6f..3096429fe 100644
--- a/packages/trueforge-sdk/src/serialization/types/McpServerReadEntry.ts
+++ b/packages/trueforge-sdk/src/serialization/types/AvailableMcpServer.ts
@@ -7,9 +7,9 @@ import { McpAuthStatus } from "./McpAuthStatus.js";
import { McpServerAuthPublic } from "./McpServerAuthPublic.js";
import { ResourceName } from "./ResourceName.js";
-export const McpServerReadEntry: core.serialization.ObjectSchema<
- serializers.McpServerReadEntry.Raw,
- TrueForge.McpServerReadEntry
+export const AvailableMcpServer: core.serialization.ObjectSchema<
+ serializers.AvailableMcpServer.Raw,
+ TrueForge.AvailableMcpServer
> = core.serialization.object({
auth: McpServerAuthPublic.optional(),
authStatus: core.serialization.property("auth_status", McpAuthStatus),
@@ -17,7 +17,7 @@ export const McpServerReadEntry: core.serialization.ObjectSchema<
url: core.serialization.string(),
});
-export declare namespace McpServerReadEntry {
+export declare namespace AvailableMcpServer {
export interface Raw {
auth?: McpServerAuthPublic.Raw | null;
auth_status: McpAuthStatus.Raw;
diff --git a/packages/trueforge-sdk/src/serialization/types/AvailableModel.ts b/packages/trueforge-sdk/src/serialization/types/AvailableModel.ts
new file mode 100644
index 000000000..affcd2ede
--- /dev/null
+++ b/packages/trueforge-sdk/src/serialization/types/AvailableModel.ts
@@ -0,0 +1,24 @@
+// 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 { AvailableModelProvider } from "./AvailableModelProvider.js";
+import { ModelProperties } from "./ModelProperties.js";
+
+export const AvailableModel: core.serialization.ObjectSchema<serializers.AvailableModel.Raw, TrueForge.AvailableModel> =
+ core.serialization.object({
+ modelId: core.serialization.property("model_id", core.serialization.string()),
+ name: core.serialization.string(),
+ properties: ModelProperties,
+ provider: AvailableModelProvider,
+ });
+
+export declare namespace AvailableModel {
+ export interface Raw {
+ model_id: string;
+ name: string;
+ properties: ModelProperties.Raw;
+ provider: AvailableModelProvider.Raw;
+ }
+}
diff --git a/packages/trueforge-sdk/src/serialization/types/ModelListProvider.ts b/packages/trueforge-sdk/src/serialization/types/AvailableModelProvider.ts
similarity index 63%
rename from packages/trueforge-sdk/src/serialization/types/ModelListProvider.ts
rename to packages/trueforge-sdk/src/serialization/types/AvailableModelProvider.ts
index f70587c1f..dbb74623f 100644
--- a/packages/trueforge-sdk/src/serialization/types/ModelListProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/AvailableModelProvider.ts
@@ -4,14 +4,14 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const ModelListProvider: core.serialization.ObjectSchema<
- serializers.ModelListProvider.Raw,
- TrueForge.ModelListProvider
+export const AvailableModelProvider: core.serialization.ObjectSchema<
+ serializers.AvailableModelProvider.Raw,
+ TrueForge.AvailableModelProvider
> = core.serialization.object({
name: core.serialization.string(),
});
-export declare namespace ModelListProvider {
+export declare namespace AvailableModelProvider {
export interface Raw {
name: string;
}
diff --git a/packages/trueforge-sdk/src/serialization/types/SkillReadEntry.ts b/packages/trueforge-sdk/src/serialization/types/AvailableSkill.ts
similarity index 74%
rename from packages/trueforge-sdk/src/serialization/types/SkillReadEntry.ts
rename to packages/trueforge-sdk/src/serialization/types/AvailableSkill.ts
index 2e0789895..c69181bec 100644
--- a/packages/trueforge-sdk/src/serialization/types/SkillReadEntry.ts
+++ b/packages/trueforge-sdk/src/serialization/types/AvailableSkill.ts
@@ -5,13 +5,13 @@ 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> =
+export const AvailableSkill: core.serialization.ObjectSchema<serializers.AvailableSkill.Raw, TrueForge.AvailableSkill> =
core.serialization.object({
description: core.serialization.string(),
name: ResourceName,
});
-export declare namespace SkillReadEntry {
+export declare namespace AvailableSkill {
export interface Raw {
description: string;
name: ResourceName.Raw;
diff --git a/packages/trueforge-sdk/src/serialization/types/CapabilitiesData.ts b/packages/trueforge-sdk/src/serialization/types/CapabilitiesData.ts
new file mode 100644
index 000000000..79e221913
--- /dev/null
+++ b/packages/trueforge-sdk/src/serialization/types/CapabilitiesData.ts
@@ -0,0 +1,25 @@
+// 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 { SandboxCapability } from "./SandboxCapability.js";
+import { SettingsCapability } from "./SettingsCapability.js";
+import { SkillCapability } from "./SkillCapability.js";
+
+export const CapabilitiesData: core.serialization.ObjectSchema<
+ serializers.CapabilitiesData.Raw,
+ TrueForge.CapabilitiesData
+> = core.serialization.object({
+ sandbox: SandboxCapability,
+ settings: SettingsCapability,
+ skill: SkillCapability,
+});
+
+export declare namespace CapabilitiesData {
+ export interface Raw {
+ sandbox: SandboxCapability.Raw;
+ settings: SettingsCapability.Raw;
+ skill: SkillCapability.Raw;
+ }
+}
diff --git a/packages/trueforge-sdk/src/serialization/types/ModelEntry.ts b/packages/trueforge-sdk/src/serialization/types/CatalogModel.ts
similarity index 80%
rename from packages/trueforge-sdk/src/serialization/types/ModelEntry.ts
rename to packages/trueforge-sdk/src/serialization/types/CatalogModel.ts
index 233c7e24b..b502933db 100644
--- a/packages/trueforge-sdk/src/serialization/types/ModelEntry.ts
+++ b/packages/trueforge-sdk/src/serialization/types/CatalogModel.ts
@@ -6,14 +6,14 @@ import type * as serializers from "../index.js";
import { ModelProperties } from "./ModelProperties.js";
import { ResourceName } from "./ResourceName.js";
-export const ModelEntry: core.serialization.ObjectSchema<serializers.ModelEntry.Raw, TrueForge.ModelEntry> =
+export const CatalogModel: core.serialization.ObjectSchema<serializers.CatalogModel.Raw, TrueForge.CatalogModel> =
core.serialization.object({
modelId: core.serialization.property("model_id", core.serialization.string()),
name: ResourceName,
properties: ModelProperties,
});
-export declare namespace ModelEntry {
+export declare namespace CatalogModel {
export interface Raw {
model_id: string;
name: ResourceName.Raw;
diff --git a/packages/trueforge-sdk/src/serialization/types/CatalogDaytonaSandboxProvider.ts b/packages/trueforge-sdk/src/serialization/types/CatalogSandboxProvider.ts
similarity index 82%
rename from packages/trueforge-sdk/src/serialization/types/CatalogDaytonaSandboxProvider.ts
rename to packages/trueforge-sdk/src/serialization/types/CatalogSandboxProvider.ts
index 310cc7be4..a0ff46aa6 100644
--- a/packages/trueforge-sdk/src/serialization/types/CatalogDaytonaSandboxProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/CatalogSandboxProvider.ts
@@ -4,9 +4,9 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const CatalogDaytonaSandboxProvider: core.serialization.ObjectSchema<
- serializers.CatalogDaytonaSandboxProvider.Raw,
- TrueForge.CatalogDaytonaSandboxProvider
+export const CatalogSandboxProvider: core.serialization.ObjectSchema<
+ serializers.CatalogSandboxProvider.Raw,
+ TrueForge.CatalogSandboxProvider
> = core.serialization.object({
autoArchiveIntervalInMinutes: core.serialization.property(
"auto_archive_interval_in_minutes",
@@ -24,7 +24,7 @@ export const CatalogDaytonaSandboxProvider: core.serialization.ObjectSchema<
type: core.serialization.stringLiteral("daytona"),
});
-export declare namespace CatalogDaytonaSandboxProvider {
+export declare namespace CatalogSandboxProvider {
export interface Raw {
auto_archive_interval_in_minutes: number;
auto_delete_interval_in_minutes: number;
diff --git a/packages/trueforge-sdk/src/serialization/types/CatalogWellKnownModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/CatalogWellKnownModelProvider.ts
index ba3cfc822..ed0fcdf7e 100644
--- a/packages/trueforge-sdk/src/serialization/types/CatalogWellKnownModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/CatalogWellKnownModelProvider.ts
@@ -3,22 +3,22 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
+import { CatalogModel } from "./CatalogModel.js";
import { CatalogWellKnownModelProviderType } from "./CatalogWellKnownModelProviderType.js";
-import { ModelEntry } from "./ModelEntry.js";
export const CatalogWellKnownModelProvider: core.serialization.ObjectSchema<
serializers.CatalogWellKnownModelProvider.Raw,
TrueForge.CatalogWellKnownModelProvider
> = core.serialization.object({
logo: core.serialization.string().optional(),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(CatalogModel),
type: CatalogWellKnownModelProviderType,
});
export declare namespace CatalogWellKnownModelProvider {
export interface Raw {
logo?: string | null;
- models: ModelEntry.Raw[];
+ models: CatalogModel.Raw[];
type: CatalogWellKnownModelProviderType.Raw;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/ContextManagementConfigCompaction.ts b/packages/trueforge-sdk/src/serialization/types/CompactionConfig.ts
similarity index 70%
rename from packages/trueforge-sdk/src/serialization/types/ContextManagementConfigCompaction.ts
rename to packages/trueforge-sdk/src/serialization/types/CompactionConfig.ts
index 769264ca4..0868d84e7 100644
--- a/packages/trueforge-sdk/src/serialization/types/ContextManagementConfigCompaction.ts
+++ b/packages/trueforge-sdk/src/serialization/types/CompactionConfig.ts
@@ -4,9 +4,9 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const ContextManagementConfigCompaction: core.serialization.ObjectSchema<
- serializers.ContextManagementConfigCompaction.Raw,
- TrueForge.ContextManagementConfigCompaction
+export const CompactionConfig: core.serialization.ObjectSchema<
+ serializers.CompactionConfig.Raw,
+ TrueForge.CompactionConfig
> = core.serialization.object({
compactionThresholdTokens: core.serialization.property(
"compaction_threshold_tokens",
@@ -15,7 +15,7 @@ export const ContextManagementConfigCompaction: core.serialization.ObjectSchema<
enabled: core.serialization.boolean().optional(),
});
-export declare namespace ContextManagementConfigCompaction {
+export declare namespace CompactionConfig {
export interface Raw {
compaction_threshold_tokens?: number | null;
enabled?: boolean | null;
diff --git a/packages/trueforge-sdk/src/serialization/types/ConfiguredModel.ts b/packages/trueforge-sdk/src/serialization/types/ConfiguredModel.ts
new file mode 100644
index 000000000..0991d9a99
--- /dev/null
+++ b/packages/trueforge-sdk/src/serialization/types/ConfiguredModel.ts
@@ -0,0 +1,24 @@
+// 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 { ModelProperties } from "./ModelProperties.js";
+import { ResourceName } from "./ResourceName.js";
+
+export const ConfiguredModel: core.serialization.ObjectSchema<
+ serializers.ConfiguredModel.Raw,
+ TrueForge.ConfiguredModel
+> = core.serialization.object({
+ modelId: core.serialization.property("model_id", core.serialization.string()),
+ name: ResourceName,
+ properties: ModelProperties,
+});
+
+export declare namespace ConfiguredModel {
+ export interface Raw {
+ model_id: string;
+ name: ResourceName.Raw;
+ properties: ModelProperties.Raw;
+ }
+}
diff --git a/packages/trueforge-sdk/src/serialization/types/ModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/ConfiguredModelProvider.ts
similarity index 59%
rename from packages/trueforge-sdk/src/serialization/types/ModelProvider.ts
rename to packages/trueforge-sdk/src/serialization/types/ConfiguredModelProvider.ts
index 015653d7d..5b24cda90 100644
--- a/packages/trueforge-sdk/src/serialization/types/ModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/ConfiguredModelProvider.ts
@@ -6,13 +6,15 @@ import type * as serializers from "../index.js";
import { ModelProviderManifest } from "./ModelProviderManifest.js";
import { ResourceName } from "./ResourceName.js";
-export const ModelProvider: core.serialization.ObjectSchema<serializers.ModelProvider.Raw, TrueForge.ModelProvider> =
- core.serialization.object({
- manifest: ModelProviderManifest,
- name: ResourceName,
- });
+export const ConfiguredModelProvider: core.serialization.ObjectSchema<
+ serializers.ConfiguredModelProvider.Raw,
+ TrueForge.ConfiguredModelProvider
+> = core.serialization.object({
+ manifest: ModelProviderManifest,
+ name: ResourceName,
+});
-export declare namespace ModelProvider {
+export declare namespace ConfiguredModelProvider {
export interface Raw {
manifest: ModelProviderManifest.Raw;
name: ResourceName.Raw;
diff --git a/packages/trueforge-sdk/src/serialization/types/SandboxProvider.ts b/packages/trueforge-sdk/src/serialization/types/ConfiguredSandboxProvider.ts
similarity index 77%
rename from packages/trueforge-sdk/src/serialization/types/SandboxProvider.ts
rename to packages/trueforge-sdk/src/serialization/types/ConfiguredSandboxProvider.ts
index 0950f115a..6bdb0087d 100644
--- a/packages/trueforge-sdk/src/serialization/types/SandboxProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/ConfiguredSandboxProvider.ts
@@ -6,16 +6,16 @@ import type * as serializers from "../index.js";
import { SandboxBuildStatus } from "./SandboxBuildStatus.js";
import { SandboxProviderManifest } from "./SandboxProviderManifest.js";
-export const SandboxProvider: core.serialization.ObjectSchema<
- serializers.SandboxProvider.Raw,
- TrueForge.SandboxProvider
+export const ConfiguredSandboxProvider: core.serialization.ObjectSchema<
+ serializers.ConfiguredSandboxProvider.Raw,
+ TrueForge.ConfiguredSandboxProvider
> = core.serialization.object({
manifest: SandboxProviderManifest,
status: SandboxBuildStatus,
statusReason: core.serialization.property("status_reason", core.serialization.string().nullable()),
});
-export declare namespace SandboxProvider {
+export declare namespace ConfiguredSandboxProvider {
export interface Raw {
manifest: SandboxProviderManifest.Raw;
status: SandboxBuildStatus.Raw;
diff --git a/packages/trueforge-sdk/src/serialization/types/ContextManagementConfig.ts b/packages/trueforge-sdk/src/serialization/types/ContextManagementConfig.ts
index ea5c5f998..4973e81fe 100644
--- a/packages/trueforge-sdk/src/serialization/types/ContextManagementConfig.ts
+++ b/packages/trueforge-sdk/src/serialization/types/ContextManagementConfig.ts
@@ -3,20 +3,20 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ContextManagementConfigCompaction } from "./ContextManagementConfigCompaction.js";
+import { CompactionConfig } from "./CompactionConfig.js";
import { LargeToolResponseConfig } from "./LargeToolResponseConfig.js";
export const ContextManagementConfig: core.serialization.ObjectSchema<
serializers.ContextManagementConfig.Raw,
TrueForge.ContextManagementConfig
> = core.serialization.object({
- compaction: ContextManagementConfigCompaction.optional(),
+ compaction: CompactionConfig.optional(),
largeToolResponse: core.serialization.property("large_tool_response", LargeToolResponseConfig.optional()),
});
export declare namespace ContextManagementConfig {
export interface Raw {
- compaction?: ContextManagementConfigCompaction.Raw | null;
+ compaction?: CompactionConfig.Raw | null;
large_tool_response?: LargeToolResponseConfig.Raw | null;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/CustomModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/CustomModelProvider.ts
index dec97b6aa..16b05310a 100644
--- a/packages/trueforge-sdk/src/serialization/types/CustomModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/CustomModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
import { ResourceName } from "./ResourceName.js";
@@ -13,7 +13,7 @@ export const CustomModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth.optional(),
baseUrl: core.serialization.property("base_url", core.serialization.string()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
name: ResourceName,
type: core.serialization.stringLiteral("custom"),
});
@@ -22,7 +22,7 @@ export declare namespace CustomModelProvider {
export interface Raw {
auth?: ModelProviderAuth.Raw | null;
base_url: string;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
name: ResourceName.Raw;
type: "custom";
}
diff --git a/packages/trueforge-sdk/src/serialization/types/FireworksModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/FireworksModelProvider.ts
index c4d559b05..715f205d8 100644
--- a/packages/trueforge-sdk/src/serialization/types/FireworksModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/FireworksModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
export const FireworksModelProvider: core.serialization.ObjectSchema<
@@ -12,7 +12,7 @@ export const FireworksModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth,
baseUrl: core.serialization.property("base_url", core.serialization.string().optional()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
type: core.serialization.stringLiteral("fireworks"),
});
@@ -20,7 +20,7 @@ export declare namespace FireworksModelProvider {
export interface Raw {
auth: ModelProviderAuth.Raw;
base_url?: string | null;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
type: "fireworks";
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponse.ts b/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponse.ts
index 2a2d9ed18..15cd54c7c 100644
--- a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponse.ts
+++ b/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponse.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 { GetCapabilitiesResponseData } from "./GetCapabilitiesResponseData.js";
+import { CapabilitiesData } from "./CapabilitiesData.js";
export const GetCapabilitiesResponse: core.serialization.ObjectSchema<
serializers.GetCapabilitiesResponse.Raw,
TrueForge.GetCapabilitiesResponse
> = core.serialization.object({
- data: GetCapabilitiesResponseData,
+ data: CapabilitiesData,
});
export declare namespace GetCapabilitiesResponse {
export interface Raw {
- data: GetCapabilitiesResponseData.Raw;
+ data: CapabilitiesData.Raw;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseData.ts b/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseData.ts
deleted file mode 100644
index 8adea591a..000000000
--- a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseData.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 { GetCapabilitiesResponseDataSandbox } from "./GetCapabilitiesResponseDataSandbox.js";
-import { GetCapabilitiesResponseDataSettings } from "./GetCapabilitiesResponseDataSettings.js";
-import { GetCapabilitiesResponseDataSkill } from "./GetCapabilitiesResponseDataSkill.js";
-
-export const GetCapabilitiesResponseData: core.serialization.ObjectSchema<
- serializers.GetCapabilitiesResponseData.Raw,
- TrueForge.GetCapabilitiesResponseData
-> = core.serialization.object({
- sandbox: GetCapabilitiesResponseDataSandbox,
- settings: GetCapabilitiesResponseDataSettings,
- skill: GetCapabilitiesResponseDataSkill,
-});
-
-export declare namespace GetCapabilitiesResponseData {
- export interface Raw {
- sandbox: GetCapabilitiesResponseDataSandbox.Raw;
- settings: GetCapabilitiesResponseDataSettings.Raw;
- skill: GetCapabilitiesResponseDataSkill.Raw;
- }
-}
diff --git a/packages/trueforge-sdk/src/serialization/types/MeResponse.ts b/packages/trueforge-sdk/src/serialization/types/GetMeResponse.ts
similarity index 59%
rename from packages/trueforge-sdk/src/serialization/types/MeResponse.ts
rename to packages/trueforge-sdk/src/serialization/types/GetMeResponse.ts
index dbc4d062f..b723498a8 100644
--- a/packages/trueforge-sdk/src/serialization/types/MeResponse.ts
+++ b/packages/trueforge-sdk/src/serialization/types/GetMeResponse.ts
@@ -3,19 +3,19 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { MeResponseType } from "./MeResponseType.js";
+import { GetMeResponseType } from "./GetMeResponseType.js";
-export const MeResponse: core.serialization.ObjectSchema<serializers.MeResponse.Raw, TrueForge.MeResponse> =
+export const GetMeResponse: core.serialization.ObjectSchema<serializers.GetMeResponse.Raw, TrueForge.GetMeResponse> =
core.serialization.object({
email: core.serialization.string(),
role: core.serialization.string(),
- type: MeResponseType,
+ type: GetMeResponseType,
});
-export declare namespace MeResponse {
+export declare namespace GetMeResponse {
export interface Raw {
email: string;
role: string;
- type: MeResponseType.Raw;
+ type: GetMeResponseType.Raw;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/MeResponseType.ts b/packages/trueforge-sdk/src/serialization/types/GetMeResponseType.ts
similarity index 53%
rename from packages/trueforge-sdk/src/serialization/types/MeResponseType.ts
rename to packages/trueforge-sdk/src/serialization/types/GetMeResponseType.ts
index e788154ab..9e9a17458 100644
--- a/packages/trueforge-sdk/src/serialization/types/MeResponseType.ts
+++ b/packages/trueforge-sdk/src/serialization/types/GetMeResponseType.ts
@@ -4,9 +4,11 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const MeResponseType: core.serialization.Schema<serializers.MeResponseType.Raw, TrueForge.MeResponseType> =
- core.serialization.enum_(["default", "oidc-connected"]);
+export const GetMeResponseType: core.serialization.Schema<
+ serializers.GetMeResponseType.Raw,
+ TrueForge.GetMeResponseType
+> = core.serialization.enum_(["default", "oidc-connected"]);
-export declare namespace MeResponseType {
+export declare namespace GetMeResponseType {
export type Raw = "default" | "oidc-connected";
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GetModelProviderResponse.ts b/packages/trueforge-sdk/src/serialization/types/GetModelProviderResponse.ts
index 379c9f7db..46ac807c1 100644
--- a/packages/trueforge-sdk/src/serialization/types/GetModelProviderResponse.ts
+++ b/packages/trueforge-sdk/src/serialization/types/GetModelProviderResponse.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 { ModelProvider } from "./ModelProvider.js";
+import { ConfiguredModelProvider } from "./ConfiguredModelProvider.js";
export const GetModelProviderResponse: core.serialization.ObjectSchema<
serializers.GetModelProviderResponse.Raw,
TrueForge.GetModelProviderResponse
> = core.serialization.object({
- data: ModelProvider,
+ data: ConfiguredModelProvider,
});
export declare namespace GetModelProviderResponse {
export interface Raw {
- data: ModelProvider.Raw;
+ data: ConfiguredModelProvider.Raw;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GetSandboxProviderCatalogResponse.ts b/packages/trueforge-sdk/src/serialization/types/GetSandboxProviderCatalogResponse.ts
index 759f7d9c6..3f1d84b17 100644
--- a/packages/trueforge-sdk/src/serialization/types/GetSandboxProviderCatalogResponse.ts
+++ b/packages/trueforge-sdk/src/serialization/types/GetSandboxProviderCatalogResponse.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 { CatalogDaytonaSandboxProvider } from "./CatalogDaytonaSandboxProvider.js";
+import { CatalogSandboxProvider } from "./CatalogSandboxProvider.js";
export const GetSandboxProviderCatalogResponse: core.serialization.ObjectSchema<
serializers.GetSandboxProviderCatalogResponse.Raw,
TrueForge.GetSandboxProviderCatalogResponse
> = core.serialization.object({
- data: core.serialization.list(CatalogDaytonaSandboxProvider),
+ data: core.serialization.list(CatalogSandboxProvider),
});
export declare namespace GetSandboxProviderCatalogResponse {
export interface Raw {
- data: CatalogDaytonaSandboxProvider.Raw[];
+ data: CatalogSandboxProvider.Raw[];
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GetSandboxProviderResponse.ts b/packages/trueforge-sdk/src/serialization/types/GetSandboxProviderResponse.ts
index 79b7f1fee..f47a7013d 100644
--- a/packages/trueforge-sdk/src/serialization/types/GetSandboxProviderResponse.ts
+++ b/packages/trueforge-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 { SandboxProvider } from "./SandboxProvider.js";
+import { ConfiguredSandboxProvider } from "./ConfiguredSandboxProvider.js";
export const GetSandboxProviderResponse: core.serialization.ObjectSchema<
serializers.GetSandboxProviderResponse.Raw,
TrueForge.GetSandboxProviderResponse
> = core.serialization.object({
- data: SandboxProvider,
+ data: ConfiguredSandboxProvider,
});
export declare namespace GetSandboxProviderResponse {
export interface Raw {
- data: SandboxProvider.Raw;
+ data: ConfiguredSandboxProvider.Raw;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GoogleGeminiModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/GoogleGeminiModelProvider.ts
index 2f42582e8..9d6ee424a 100644
--- a/packages/trueforge-sdk/src/serialization/types/GoogleGeminiModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/GoogleGeminiModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
export const GoogleGeminiModelProvider: core.serialization.ObjectSchema<
@@ -12,7 +12,7 @@ export const GoogleGeminiModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth,
baseUrl: core.serialization.property("base_url", core.serialization.string().optional()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
type: core.serialization.stringLiteral("google-gemini"),
});
@@ -20,7 +20,7 @@ export declare namespace GoogleGeminiModelProvider {
export interface Raw {
auth: ModelProviderAuth.Raw;
base_url?: string | null;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
type: "google-gemini";
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/AgentSpecUserMessage.ts b/packages/trueforge-sdk/src/serialization/types/InitialUserMessage.ts
similarity index 69%
rename from packages/trueforge-sdk/src/serialization/types/AgentSpecUserMessage.ts
rename to packages/trueforge-sdk/src/serialization/types/InitialUserMessage.ts
index 6fdbd83d9..ee06dc560 100644
--- a/packages/trueforge-sdk/src/serialization/types/AgentSpecUserMessage.ts
+++ b/packages/trueforge-sdk/src/serialization/types/InitialUserMessage.ts
@@ -4,15 +4,15 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const AgentSpecUserMessage: core.serialization.ObjectSchema<
- serializers.AgentSpecUserMessage.Raw,
- TrueForge.AgentSpecUserMessage
+export const InitialUserMessage: core.serialization.ObjectSchema<
+ serializers.InitialUserMessage.Raw,
+ TrueForge.InitialUserMessage
> = core.serialization.object({
content: core.serialization.string(),
type: core.serialization.stringLiteral("user.message"),
});
-export declare namespace AgentSpecUserMessage {
+export declare namespace InitialUserMessage {
export interface Raw {
content: string;
type: "user.message";
diff --git a/packages/trueforge-sdk/src/serialization/types/ListAvailableMcpServersResponse.ts b/packages/trueforge-sdk/src/serialization/types/ListAvailableMcpServersResponse.ts
index a3c87be00..84dbffc66 100644
--- a/packages/trueforge-sdk/src/serialization/types/ListAvailableMcpServersResponse.ts
+++ b/packages/trueforge-sdk/src/serialization/types/ListAvailableMcpServersResponse.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 { McpServerReadEntry } from "./McpServerReadEntry.js";
+import { AvailableMcpServer } from "./AvailableMcpServer.js";
export const ListAvailableMcpServersResponse: core.serialization.ObjectSchema<
serializers.ListAvailableMcpServersResponse.Raw,
TrueForge.ListAvailableMcpServersResponse
> = core.serialization.object({
- data: core.serialization.list(McpServerReadEntry),
+ data: core.serialization.list(AvailableMcpServer),
});
export declare namespace ListAvailableMcpServersResponse {
export interface Raw {
- data: McpServerReadEntry.Raw[];
+ data: AvailableMcpServer.Raw[];
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/ListAvailableModelsResponse.ts b/packages/trueforge-sdk/src/serialization/types/ListAvailableModelsResponse.ts
new file mode 100644
index 000000000..a61e2d811
--- /dev/null
+++ b/packages/trueforge-sdk/src/serialization/types/ListAvailableModelsResponse.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 { AvailableModel } from "./AvailableModel.js";
+
+export const ListAvailableModelsResponse: core.serialization.ObjectSchema<
+ serializers.ListAvailableModelsResponse.Raw,
+ TrueForge.ListAvailableModelsResponse
+> = core.serialization.object({
+ data: core.serialization.list(AvailableModel),
+});
+
+export declare namespace ListAvailableModelsResponse {
+ export interface Raw {
+ data: AvailableModel.Raw[];
+ }
+}
diff --git a/packages/trueforge-sdk/src/serialization/types/ListAvailableSkillsResponse.ts b/packages/trueforge-sdk/src/serialization/types/ListAvailableSkillsResponse.ts
index 151b86632..606bf2ec3 100644
--- a/packages/trueforge-sdk/src/serialization/types/ListAvailableSkillsResponse.ts
+++ b/packages/trueforge-sdk/src/serialization/types/ListAvailableSkillsResponse.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 { SkillReadEntry } from "./SkillReadEntry.js";
+import { AvailableSkill } from "./AvailableSkill.js";
export const ListAvailableSkillsResponse: core.serialization.ObjectSchema<
serializers.ListAvailableSkillsResponse.Raw,
TrueForge.ListAvailableSkillsResponse
> = core.serialization.object({
- data: core.serialization.list(SkillReadEntry),
+ data: core.serialization.list(AvailableSkill),
});
export declare namespace ListAvailableSkillsResponse {
export interface Raw {
- data: SkillReadEntry.Raw[];
+ data: AvailableSkill.Raw[];
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/ListModelProvidersResponse.ts b/packages/trueforge-sdk/src/serialization/types/ListModelProvidersResponse.ts
index 88e029bb5..45cb0092f 100644
--- a/packages/trueforge-sdk/src/serialization/types/ListModelProvidersResponse.ts
+++ b/packages/trueforge-sdk/src/serialization/types/ListModelProvidersResponse.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 { ModelProvider } from "./ModelProvider.js";
+import { ConfiguredModelProvider } from "./ConfiguredModelProvider.js";
export const ListModelProvidersResponse: core.serialization.ObjectSchema<
serializers.ListModelProvidersResponse.Raw,
TrueForge.ListModelProvidersResponse
> = core.serialization.object({
- data: core.serialization.list(ModelProvider),
+ data: core.serialization.list(ConfiguredModelProvider),
});
export declare namespace ListModelProvidersResponse {
export interface Raw {
- data: ModelProvider.Raw[];
+ data: ConfiguredModelProvider.Raw[];
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/ListModelsResponse.ts b/packages/trueforge-sdk/src/serialization/types/ListModelsResponse.ts
deleted file mode 100644
index 1385187aa..000000000
--- a/packages/trueforge-sdk/src/serialization/types/ListModelsResponse.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 { Model } from "./Model.js";
-
-export const ListModelsResponse: core.serialization.ObjectSchema<
- serializers.ListModelsResponse.Raw,
- TrueForge.ListModelsResponse
-> = core.serialization.object({
- data: core.serialization.list(Model),
-});
-
-export declare namespace ListModelsResponse {
- export interface Raw {
- data: Model.Raw[];
- }
-}
diff --git a/packages/trueforge-sdk/src/serialization/types/McpServer.ts b/packages/trueforge-sdk/src/serialization/types/McpServer.ts
index 88cb88e8b..90e47f4e5 100644
--- a/packages/trueforge-sdk/src/serialization/types/McpServer.ts
+++ b/packages/trueforge-sdk/src/serialization/types/McpServer.ts
@@ -3,40 +3,38 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { McpServerDisableToolsItem } from "./McpServerDisableToolsItem.js";
-import { McpServerEnableToolsItem } from "./McpServerEnableToolsItem.js";
-import { McpServerPreloadToolsItem } from "./McpServerPreloadToolsItem.js";
-import { McpServerRequireApprovalForToolsItem } from "./McpServerRequireApprovalForToolsItem.js";
+import { McpServerApprovalToolSelector } from "./McpServerApprovalToolSelector.js";
+import { McpServerToolSelector } from "./McpServerToolSelector.js";
export const McpServer: core.serialization.ObjectSchema<serializers.McpServer.Raw, TrueForge.McpServer> =
core.serialization.object({
disableTools: core.serialization.property(
"disable_tools",
- core.serialization.list(McpServerDisableToolsItem).optional(),
+ core.serialization.list(McpServerToolSelector).optional(),
),
enableTools: core.serialization.property(
"enable_tools",
- core.serialization.list(McpServerEnableToolsItem).optional(),
+ core.serialization.list(McpServerToolSelector).optional(),
),
name: core.serialization.string(),
preload: core.serialization.boolean().optional(),
preloadTools: core.serialization.property(
"preload_tools",
- core.serialization.list(McpServerPreloadToolsItem).optional(),
+ core.serialization.list(McpServerToolSelector).optional(),
),
requireApprovalForTools: core.serialization.property(
"require_approval_for_tools",
- core.serialization.list(McpServerRequireApprovalForToolsItem).optional(),
+ core.serialization.list(McpServerApprovalToolSelector).optional(),
),
});
export declare namespace McpServer {
export interface Raw {
- disable_tools?: McpServerDisableToolsItem.Raw[] | null;
- enable_tools?: McpServerEnableToolsItem.Raw[] | null;
+ disable_tools?: McpServerToolSelector.Raw[] | null;
+ enable_tools?: McpServerToolSelector.Raw[] | null;
name: string;
preload?: boolean | null;
- preload_tools?: McpServerPreloadToolsItem.Raw[] | null;
- require_approval_for_tools?: McpServerRequireApprovalForToolsItem.Raw[] | null;
+ preload_tools?: McpServerToolSelector.Raw[] | null;
+ require_approval_for_tools?: McpServerApprovalToolSelector.Raw[] | null;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/McpServerRequireApprovalForToolsItem.ts b/packages/trueforge-sdk/src/serialization/types/McpServerApprovalToolSelector.ts
similarity index 67%
rename from packages/trueforge-sdk/src/serialization/types/McpServerRequireApprovalForToolsItem.ts
rename to packages/trueforge-sdk/src/serialization/types/McpServerApprovalToolSelector.ts
index 05de44390..a8ba84e38 100644
--- a/packages/trueforge-sdk/src/serialization/types/McpServerRequireApprovalForToolsItem.ts
+++ b/packages/trueforge-sdk/src/serialization/types/McpServerApprovalToolSelector.ts
@@ -4,9 +4,9 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const McpServerRequireApprovalForToolsItem: core.serialization.Schema<
- serializers.McpServerRequireApprovalForToolsItem.Raw,
- TrueForge.McpServerRequireApprovalForToolsItem
+export const McpServerApprovalToolSelector: core.serialization.Schema<
+ serializers.McpServerApprovalToolSelector.Raw,
+ TrueForge.McpServerApprovalToolSelector
> = core.serialization.undiscriminatedUnion([
core.serialization.stringLiteral("@all"),
core.serialization.stringLiteral("@write"),
@@ -14,6 +14,6 @@ export const McpServerRequireApprovalForToolsItem: core.serialization.Schema<
core.serialization.string(),
]);
-export declare namespace McpServerRequireApprovalForToolsItem {
+export declare namespace McpServerApprovalToolSelector {
export type Raw = "@all" | "@write" | "@destructive" | string;
}
diff --git a/packages/trueforge-sdk/src/serialization/types/McpServerDisableToolsItem.ts b/packages/trueforge-sdk/src/serialization/types/McpServerDisableToolsItem.ts
deleted file mode 100644
index e4dc40944..000000000
--- a/packages/trueforge-sdk/src/serialization/types/McpServerDisableToolsItem.ts
+++ /dev/null
@@ -1,18 +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";
-
-export const McpServerDisableToolsItem: core.serialization.Schema<
- serializers.McpServerDisableToolsItem.Raw,
- TrueForge.McpServerDisableToolsItem
-> = core.serialization.undiscriminatedUnion([
- core.serialization.stringLiteral("@all"),
- core.serialization.stringLiteral("@read-only"),
- core.serialization.string(),
-]);
-
-export declare namespace McpServerDisableToolsItem {
- export type Raw = "@all" | "@read-only" | string;
-}
diff --git a/packages/trueforge-sdk/src/serialization/types/McpServerPreloadToolsItem.ts b/packages/trueforge-sdk/src/serialization/types/McpServerPreloadToolsItem.ts
deleted file mode 100644
index 68ead9ab8..000000000
--- a/packages/trueforge-sdk/src/serialization/types/McpServerPreloadToolsItem.ts
+++ /dev/null
@@ -1,18 +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";
-
-export const McpServerPreloadToolsItem: core.serialization.Schema<
- serializers.McpServerPreloadToolsItem.Raw,
- TrueForge.McpServerPreloadToolsItem
-> = core.serialization.undiscriminatedUnion([
- core.serialization.stringLiteral("@all"),
- core.serialization.stringLiteral("@read-only"),
- core.serialization.string(),
-]);
-
-export declare namespace McpServerPreloadToolsItem {
- export type Raw = "@all" | "@read-only" | string;
-}
diff --git a/packages/trueforge-sdk/src/serialization/types/McpServerEnableToolsItem.ts b/packages/trueforge-sdk/src/serialization/types/McpServerToolSelector.ts
similarity index 69%
rename from packages/trueforge-sdk/src/serialization/types/McpServerEnableToolsItem.ts
rename to packages/trueforge-sdk/src/serialization/types/McpServerToolSelector.ts
index 8b121c0e4..1d3761814 100644
--- a/packages/trueforge-sdk/src/serialization/types/McpServerEnableToolsItem.ts
+++ b/packages/trueforge-sdk/src/serialization/types/McpServerToolSelector.ts
@@ -4,15 +4,15 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const McpServerEnableToolsItem: core.serialization.Schema<
- serializers.McpServerEnableToolsItem.Raw,
- TrueForge.McpServerEnableToolsItem
+export const McpServerToolSelector: core.serialization.Schema<
+ serializers.McpServerToolSelector.Raw,
+ TrueForge.McpServerToolSelector
> = core.serialization.undiscriminatedUnion([
core.serialization.stringLiteral("@all"),
core.serialization.stringLiteral("@read-only"),
core.serialization.string(),
]);
-export declare namespace McpServerEnableToolsItem {
+export declare namespace McpServerToolSelector {
export type Raw = "@all" | "@read-only" | string;
}
diff --git a/packages/trueforge-sdk/src/serialization/types/Model.ts b/packages/trueforge-sdk/src/serialization/types/Model.ts
index 1790235e4..a56e06572 100644
--- a/packages/trueforge-sdk/src/serialization/types/Model.ts
+++ b/packages/trueforge-sdk/src/serialization/types/Model.ts
@@ -3,23 +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 { ModelListProvider } from "./ModelListProvider.js";
-import { ModelProperties } from "./ModelProperties.js";
+import { ModelParams } from "./ModelParams.js";
export const Model: core.serialization.ObjectSchema<serializers.Model.Raw, TrueForge.Model> = core.serialization.object(
{
- modelId: core.serialization.property("model_id", core.serialization.string()),
name: core.serialization.string(),
- properties: ModelProperties,
- provider: ModelListProvider,
+ params: ModelParams.optional(),
},
);
export declare namespace Model {
export interface Raw {
- model_id: string;
name: string;
- properties: ModelProperties.Raw;
- provider: ModelListProvider.Raw;
+ params?: ModelParams.Raw | null;
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/MoonshotModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/MoonshotModelProvider.ts
index ec7981536..fcef904a9 100644
--- a/packages/trueforge-sdk/src/serialization/types/MoonshotModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/MoonshotModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
export const MoonshotModelProvider: core.serialization.ObjectSchema<
@@ -12,7 +12,7 @@ export const MoonshotModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth,
baseUrl: core.serialization.property("base_url", core.serialization.string().optional()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
type: core.serialization.stringLiteral("moonshot"),
});
@@ -20,7 +20,7 @@ export declare namespace MoonshotModelProvider {
export interface Raw {
auth: ModelProviderAuth.Raw;
base_url?: string | null;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
type: "moonshot";
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/OpenAiModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/OpenAiModelProvider.ts
index cd2e3fc70..1efa68e5b 100644
--- a/packages/trueforge-sdk/src/serialization/types/OpenAiModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/OpenAiModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
export const OpenAiModelProvider: core.serialization.ObjectSchema<
@@ -12,7 +12,7 @@ export const OpenAiModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth,
baseUrl: core.serialization.property("base_url", core.serialization.string().optional()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
type: core.serialization.stringLiteral("openai"),
});
@@ -20,7 +20,7 @@ export declare namespace OpenAiModelProvider {
export interface Raw {
auth: ModelProviderAuth.Raw;
base_url?: string | null;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
type: "openai";
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSandbox.ts b/packages/trueforge-sdk/src/serialization/types/SandboxCapability.ts
similarity index 58%
rename from packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSandbox.ts
rename to packages/trueforge-sdk/src/serialization/types/SandboxCapability.ts
index 74a320e17..cff24e72a 100644
--- a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSandbox.ts
+++ b/packages/trueforge-sdk/src/serialization/types/SandboxCapability.ts
@@ -4,14 +4,14 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const GetCapabilitiesResponseDataSandbox: core.serialization.ObjectSchema<
- serializers.GetCapabilitiesResponseDataSandbox.Raw,
- TrueForge.GetCapabilitiesResponseDataSandbox
+export const SandboxCapability: core.serialization.ObjectSchema<
+ serializers.SandboxCapability.Raw,
+ TrueForge.SandboxCapability
> = core.serialization.object({
enabled: core.serialization.boolean(),
});
-export declare namespace GetCapabilitiesResponseDataSandbox {
+export declare namespace SandboxCapability {
export interface Raw {
enabled: boolean;
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSettings.ts b/packages/trueforge-sdk/src/serialization/types/SettingsCapability.ts
similarity index 58%
rename from packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSettings.ts
rename to packages/trueforge-sdk/src/serialization/types/SettingsCapability.ts
index 6aefa1d9c..552ad2f24 100644
--- a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSettings.ts
+++ b/packages/trueforge-sdk/src/serialization/types/SettingsCapability.ts
@@ -4,14 +4,14 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const GetCapabilitiesResponseDataSettings: core.serialization.ObjectSchema<
- serializers.GetCapabilitiesResponseDataSettings.Raw,
- TrueForge.GetCapabilitiesResponseDataSettings
+export const SettingsCapability: core.serialization.ObjectSchema<
+ serializers.SettingsCapability.Raw,
+ TrueForge.SettingsCapability
> = core.serialization.object({
enabled: core.serialization.boolean(),
});
-export declare namespace GetCapabilitiesResponseDataSettings {
+export declare namespace SettingsCapability {
export interface Raw {
enabled: boolean;
}
diff --git a/packages/trueforge-sdk/src/serialization/types/SkillNameRef.ts b/packages/trueforge-sdk/src/serialization/types/Skill.ts
similarity index 61%
rename from packages/trueforge-sdk/src/serialization/types/SkillNameRef.ts
rename to packages/trueforge-sdk/src/serialization/types/Skill.ts
index 05d804e77..71dc42c58 100644
--- a/packages/trueforge-sdk/src/serialization/types/SkillNameRef.ts
+++ b/packages/trueforge-sdk/src/serialization/types/Skill.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";
-export const SkillNameRef: core.serialization.ObjectSchema<serializers.SkillNameRef.Raw, TrueForge.SkillNameRef> =
- core.serialization.object({
+export const Skill: core.serialization.ObjectSchema<serializers.Skill.Raw, TrueForge.Skill> = core.serialization.object(
+ {
name: core.serialization.string(),
- });
+ },
+);
-export declare namespace SkillNameRef {
+export declare namespace Skill {
export interface Raw {
name: string;
}
diff --git a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSkill.ts b/packages/trueforge-sdk/src/serialization/types/SkillCapability.ts
similarity index 64%
rename from packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSkill.ts
rename to packages/trueforge-sdk/src/serialization/types/SkillCapability.ts
index 8eedd3830..66989fe28 100644
--- a/packages/trueforge-sdk/src/serialization/types/GetCapabilitiesResponseDataSkill.ts
+++ b/packages/trueforge-sdk/src/serialization/types/SkillCapability.ts
@@ -4,15 +4,15 @@ import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-export const GetCapabilitiesResponseDataSkill: core.serialization.ObjectSchema<
- serializers.GetCapabilitiesResponseDataSkill.Raw,
- TrueForge.GetCapabilitiesResponseDataSkill
+export const SkillCapability: core.serialization.ObjectSchema<
+ serializers.SkillCapability.Raw,
+ TrueForge.SkillCapability
> = core.serialization.object({
enabled: core.serialization.boolean(),
reason: core.serialization.string().optional(),
});
-export declare namespace GetCapabilitiesResponseDataSkill {
+export declare namespace SkillCapability {
export interface Raw {
enabled: boolean;
reason?: string | null;
diff --git a/packages/trueforge-sdk/src/serialization/types/TogetherAiModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/TogetherAiModelProvider.ts
index bd3fd4385..d27e17d2e 100644
--- a/packages/trueforge-sdk/src/serialization/types/TogetherAiModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/TogetherAiModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
export const TogetherAiModelProvider: core.serialization.ObjectSchema<
@@ -12,7 +12,7 @@ export const TogetherAiModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth,
baseUrl: core.serialization.property("base_url", core.serialization.string().optional()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
type: core.serialization.stringLiteral("together"),
});
@@ -20,7 +20,7 @@ export declare namespace TogetherAiModelProvider {
export interface Raw {
auth: ModelProviderAuth.Raw;
base_url?: string | null;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
type: "together";
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/ZaiModelProvider.ts b/packages/trueforge-sdk/src/serialization/types/ZaiModelProvider.ts
index f31a6e733..a60aa6d69 100644
--- a/packages/trueforge-sdk/src/serialization/types/ZaiModelProvider.ts
+++ b/packages/trueforge-sdk/src/serialization/types/ZaiModelProvider.ts
@@ -3,7 +3,7 @@
import type * as TrueForge from "../../api/index.js";
import * as core from "../../core/index.js";
import type * as serializers from "../index.js";
-import { ModelEntry } from "./ModelEntry.js";
+import { ConfiguredModel } from "./ConfiguredModel.js";
import { ModelProviderAuth } from "./ModelProviderAuth.js";
export const ZaiModelProvider: core.serialization.ObjectSchema<
@@ -12,7 +12,7 @@ export const ZaiModelProvider: core.serialization.ObjectSchema<
> = core.serialization.object({
auth: ModelProviderAuth,
baseUrl: core.serialization.property("base_url", core.serialization.string().optional()),
- models: core.serialization.list(ModelEntry),
+ models: core.serialization.list(ConfiguredModel),
type: core.serialization.stringLiteral("zai"),
});
@@ -20,7 +20,7 @@ export declare namespace ZaiModelProvider {
export interface Raw {
auth: ModelProviderAuth.Raw;
base_url?: string | null;
- models: ModelEntry.Raw[];
+ models: ConfiguredModel.Raw[];
type: "zai";
}
}
diff --git a/packages/trueforge-sdk/src/serialization/types/index.ts b/packages/trueforge-sdk/src/serialization/types/index.ts
index ab8c00f19..18f7a281b 100644
--- a/packages/trueforge-sdk/src/serialization/types/index.ts
+++ b/packages/trueforge-sdk/src/serialization/types/index.ts
@@ -3,21 +3,25 @@ export * from "./Agent.js";
export * from "./AgentInfo.js";
export * from "./AgentParent.js";
export * from "./AgentSpec.js";
-export * from "./AgentSpecModel.js";
-export * from "./AgentSpecUserMessage.js";
export * from "./AlibabaModelProvider.js";
export * from "./AnthropicModelProvider.js";
export * from "./ApprovalAllow.js";
export * from "./ApprovalDecision.js";
export * from "./ApprovalDeny.js";
export * from "./AskUserQuestionsConfig.js";
+export * from "./AvailableMcpServer.js";
+export * from "./AvailableModel.js";
+export * from "./AvailableModelProvider.js";
+export * from "./AvailableSkill.js";
export * from "./BaseMcpAuthRequiredEvent.js";
export * from "./BaseThreadDoneEvent.js";
export * from "./CancelSessionResponse.js";
+export * from "./CapabilitiesData.js";
export * from "./CatalogCustomModelProvider.js";
-export * from "./CatalogDaytonaSandboxProvider.js";
export * from "./CatalogMcpServer.js";
+export * from "./CatalogModel.js";
export * from "./CatalogModelProvider.js";
+export * from "./CatalogSandboxProvider.js";
export * from "./CatalogSkill.js";
export * from "./CatalogWellKnownModelProvider.js";
export * from "./CatalogWellKnownModelProviderType.js";
@@ -27,10 +31,13 @@ export * from "./ChatCompletionContentPartRefusal.js";
export * from "./ChatCompletionContentPartText.js";
export * from "./ChatCompletionMessageToolCall.js";
export * from "./ChatCompletionMessageToolCallFunction.js";
+export * from "./CompactionConfig.js";
export * from "./ConfiguredMcpServer.js";
+export * from "./ConfiguredModel.js";
+export * from "./ConfiguredModelProvider.js";
+export * from "./ConfiguredSandboxProvider.js";
export * from "./ConfiguredSkill.js";
export * from "./ContextManagementConfig.js";
-export * from "./ContextManagementConfigCompaction.js";
export * from "./CreateSessionAgent.js";
export * from "./CustomModelProvider.js";
export * from "./DaytonaSandboxProviderAuth.js";
@@ -43,12 +50,10 @@ export * from "./FireworksModelProvider.js";
export * from "./GenerativeUiConfig.js";
export * from "./GetAgentResponse.js";
export * from "./GetCapabilitiesResponse.js";
-export * from "./GetCapabilitiesResponseData.js";
-export * from "./GetCapabilitiesResponseDataSandbox.js";
-export * from "./GetCapabilitiesResponseDataSettings.js";
-export * from "./GetCapabilitiesResponseDataSkill.js";
export * from "./GetMcpServerCatalogResponse.js";
export * from "./GetMcpServerResponse.js";
+export * from "./GetMeResponse.js";
+export * from "./GetMeResponseType.js";
export * from "./GetModelProviderCatalogResponse.js";
export * from "./GetModelProviderResponse.js";
export * from "./GetSandboxProviderCatalogResponse.js";
@@ -58,14 +63,15 @@ export * from "./GetSkillCatalogResponse.js";
export * from "./GetSkillResponse.js";
export * from "./GetTurnResponse.js";
export * from "./GoogleGeminiModelProvider.js";
+export * from "./InitialUserMessage.js";
export * from "./LargeToolResponseConfig.js";
export * from "./ListAgentsResponse.js";
export * from "./ListAvailableMcpServersResponse.js";
+export * from "./ListAvailableModelsResponse.js";
export * from "./ListAvailableSkillsResponse.js";
export * from "./ListMcpServersResponse.js";
export * from "./ListMcpServerToolsResponse.js";
export * from "./ListModelProvidersResponse.js";
-export * from "./ListModelsResponse.js";
export * from "./ListSessionEventsResponse.js";
export * from "./ListSessionsOrder.js";
export * from "./ListSessionsResponse.js";
@@ -78,28 +84,21 @@ export * from "./McpAuthStatus.js";
export * from "./McpAuthStatusStatus.js";
export * from "./McpInitializeEvent.js";
export * from "./McpServer.js";
+export * from "./McpServerApprovalToolSelector.js";
export * from "./McpServerAuthInfo.js";
export * from "./McpServerAuthPublic.js";
export * from "./McpServerAuthPublicOne.js";
export * from "./McpServerAuthPublicZero.js";
export * from "./McpServerDcrAuth.js";
-export * from "./McpServerDisableToolsItem.js";
-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";
+export * from "./McpServerToolSelector.js";
export * from "./McpServerType.js";
export * from "./McpToolInfo.js";
-export * from "./MeResponse.js";
-export * from "./MeResponseType.js";
export * from "./Model.js";
-export * from "./ModelEntry.js";
-export * from "./ModelListProvider.js";
export * from "./ModelMessageDeltaEvent.js";
export * from "./ModelMessageEvent.js";
export * from "./ModelMessageEventContent.js";
@@ -108,7 +107,6 @@ export * from "./ModelMessageUsage.js";
export * from "./ModelMessageUsageInputTokensBreakdown.js";
export * from "./ModelParams.js";
export * from "./ModelProperties.js";
-export * from "./ModelProvider.js";
export * from "./ModelProviderAuth.js";
export * from "./ModelProviderManifest.js";
export * from "./MoonshotModelProvider.js";
@@ -126,9 +124,9 @@ export * from "./ResponseFormatJsonSchemaJsonSchema.js";
export * from "./ResponseFormatText.js";
export * from "./RuntimeConfig.js";
export * from "./SandboxBuildStatus.js";
+export * from "./SandboxCapability.js";
export * from "./SandboxConfig.js";
export * from "./SandboxCreatedEvent.js";
-export * from "./SandboxProvider.js";
export * from "./SandboxProviderManifest.js";
export * from "./Session.js";
export * from "./SessionAgent.js";
@@ -138,9 +136,10 @@ export * from "./SessionAgentReference.js";
export * from "./SessionAgentSpecBody.js";
export * from "./SessionEvent.js";
export * from "./SessionEventItem.js";
+export * from "./SettingsCapability.js";
+export * from "./Skill.js";
+export * from "./SkillCapability.js";
export * from "./SkillManifest.js";
-export * from "./SkillNameRef.js";
-export * from "./SkillReadEntry.js";
export * from "./SkillType.js";
export * from "./TextContent.js";
export * from "./ThreadCreatedEvent.js";
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/builderServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/builderServer.ts
index ba03f5063..26055dca7 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/builderServer.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/builderServer.ts
@@ -29,7 +29,13 @@ export function modelProviderLogosByName(
}
/** Map harness model rows onto the UI picker shape (nested provider + properties + optional logo). */
-export function toModelSelection({ model, logo }: { model: TrueForgeApi.Model; logo?: string }): ModelSelection {
+export function toModelSelection({
+ model,
+ logo,
+}: {
+ model: TrueForgeApi.AvailableModel;
+ logo?: string;
+}): ModelSelection {
const efforts = model.properties.reasoningEfforts;
return {
id: model.modelId,
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
index b149321cf..ec887c1e6 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/connectorCatalog.ts
@@ -83,7 +83,7 @@ export function toUiConnector(server: TrueForgeApi.ConfiguredMcpServer): UiConne
};
}
-export function toUiConnectorFromReadEntry(server: TrueForgeApi.McpServerReadEntry): UiConnector {
+export function toUiConnectorFromReadEntry(server: TrueForgeApi.AvailableMcpServer): UiConnector {
const auth: UiConnectorAuthPublic = server.auth?.type ? { type: server.auth.type } : { type: 'none' };
return {
id: server.name,
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
index 99473ac0b..eac2c6154 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/modelProviderCatalog.ts
@@ -23,7 +23,7 @@ export type UiModelEntry = ModelEntry & {
export type UiModelProvider = ModelProviderBase<UiModelEntry>;
export type UiModelProviderCatalogEntry = ModelProviderCatalogEntry<UiModelEntry>;
-export function toUiModelEntry(model: TrueForgeApi.ModelEntry): UiModelEntry {
+export function toUiModelEntry(model: TrueForgeApi.ConfiguredModel): UiModelEntry {
return {
id: model.modelId,
name: model.name,
@@ -31,7 +31,7 @@ export function toUiModelEntry(model: TrueForgeApi.ModelEntry): UiModelEntry {
};
}
-export function toHarnessModelEntry(model: UiModelEntry): TrueForgeApi.ModelEntry {
+export function toHarnessModelEntry(model: UiModelEntry): TrueForgeApi.ConfiguredModel {
return {
modelId: model.id,
name: model.name,
@@ -39,7 +39,7 @@ export function toHarnessModelEntry(model: UiModelEntry): TrueForgeApi.ModelEntr
};
}
-export function toUiModelProvider(provider: TrueForgeApi.ModelProvider): UiModelProvider {
+export function toUiModelProvider(provider: TrueForgeApi.ConfiguredModelProvider): UiModelProvider {
const { name, manifest } = provider;
return {
id: name,
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
index 3f6723204..dc2da1a1d 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/catalogs/sandboxProviderCatalog.ts
@@ -31,7 +31,7 @@ function displayNameForType(type: string): string {
}
export function configFromHarness(
- provider: TrueForgeApi.CatalogDaytonaSandboxProvider | TrueForgeApi.SandboxProviderManifest,
+ provider: TrueForgeApi.CatalogSandboxProvider | TrueForgeApi.SandboxProviderManifest,
): SandboxProviderConfig {
return {
execTimeoutMs: provider.execTimeoutMs,
@@ -41,7 +41,7 @@ export function configFromHarness(
};
}
-export function toUiCatalogEntry(provider: TrueForgeApi.CatalogDaytonaSandboxProvider): UiSandboxProviderCatalogEntry {
+export function toUiCatalogEntry(provider: TrueForgeApi.CatalogSandboxProvider): UiSandboxProviderCatalogEntry {
return {
id: provider.type,
name: displayNameForType(provider.type),
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/chatServer.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/chatServer.ts
index c61827ce6..cb6053f37 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/chatServer.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/chatServer.ts
@@ -5,7 +5,7 @@
* `nextPageToken`), and `null` normalized to absent. Harness keys MCP mounts by
* name and returns `null` for optional fields — the maps below bridge both.
*
- * Skills are name refs on the wire (`SkillNameRef`).
+ * Skills are name refs on the wire (`Skill`).
*
* Session create takes `{ name }` or `{ spec }`; reads carry the
* `reference`/`inline` discriminator, with reference rows already naming their
@@ -34,7 +34,7 @@ function toUiMcpServer(server: TrueForgeApi.McpServer): HarnessMcpServerMount {
return server;
}
-function toUiSkill(skill: TrueForgeApi.SkillNameRef): HarnessSkillMount {
+function toUiSkill(skill: TrueForgeApi.Skill): HarnessSkillMount {
return { name: skill.name };
}
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/lists.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/lists.ts
index 339d71325..663fbdf32 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/lists.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/lists.ts
@@ -4,22 +4,22 @@
*/
import type { TrueForge, TrueForgeApi } from '@truefoundry/trueforge-sdk';
-export async function listModels(client: TrueForge): Promise<TrueForgeApi.Model[]> {
+export async function listModels(client: TrueForge): Promise<TrueForgeApi.AvailableModel[]> {
const body = await client.models.list();
return body.data;
}
-export async function listConfiguredMcpServers(client: TrueForge): Promise<TrueForgeApi.McpServerReadEntry[]> {
+export async function listConfiguredMcpServers(client: TrueForge): Promise<TrueForgeApi.AvailableMcpServer[]> {
const body = await client.mcpServers.list();
return body.data;
}
-export async function listSkills(client: TrueForge): Promise<TrueForgeApi.SkillReadEntry[]> {
+export async function listSkills(client: TrueForge): Promise<TrueForgeApi.AvailableSkill[]> {
const body = await client.skills.list();
return body.data;
}
-export async function getCapabilities(client: TrueForge): Promise<TrueForgeApi.GetCapabilitiesResponseData> {
+export async function getCapabilities(client: TrueForge): Promise<TrueForgeApi.CapabilitiesData> {
const body = await client.server.getCapabilities();
return body.data;
}
diff --git a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/types.ts b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/types.ts
index ec964d97a..a77533371 100644
--- a/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/types.ts
+++ b/packages/trueforge-ui/src/plugins/trueforge-agent-server-adapter/types.ts
@@ -1,16 +1,12 @@
import type { TrueForgeApi } from '@truefoundry/trueforge-sdk';
import type { AgentSpec } from '../../server/types.js';
-export type HarnessSkillMount = TrueForgeApi.SkillNameRef;
+export type HarnessSkillMount = TrueForgeApi.Skill;
export type HarnessMcpServerMount = TrueForgeApi.McpServer;
-export interface HarnessAgentSpec extends AgentSpec<
- TrueForgeApi.AgentSpecModel,
- HarnessSkillMount,
- HarnessMcpServerMount
-> {
+export interface HarnessAgentSpec extends AgentSpec<TrueForgeApi.Model, HarnessSkillMount, HarnessMcpServerMount> {
config?: TrueForgeApi.RuntimeConfig;
instructions?: string;
- messages?: TrueForgeApi.AgentSpecUserMessage[];
+ messages?: TrueForgeApi.InitialUserMessage[];
responseFormat?: TrueForgeApi.ResponseFormat;
}
diff --git a/packages/trueforge/.cursor/BUGBOT.md b/packages/trueforge/.cursor/BUGBOT.md
index fe8903913..e93d055a8 100644
--- a/packages/trueforge/.cursor/BUGBOT.md
+++ b/packages/trueforge/.cursor/BUGBOT.md
@@ -31,12 +31,12 @@ If a settings resource is one-per-tenant (e.g. sandbox provider), keep the plura
| `GET /foos` | `ListFoosRequestQuery` (if any) | `ListFoosResponse` |
| `POST /foos` | `CreateFooRequest` | `GetFooResponse` (or `CreateFooResponse`) |
| `GET /foos/{foo_id}` | — | `GetFooResponse` |
-| `PUT` upsert/replace | `PutFooRequest` | `GetFooResponse` (or `PutFooResponse`) |
+| `PUT` upsert/replace | `UpdateFooRequest` | `GetFooResponse` (or `UpdateFooResponse`) |
| `DELETE /foos/{foo_id}` | `DeleteFoosRequestQuery` (optional) | `DeleteFooResponse` (`{}`) |
Prefer reusing `GetFooResponse` when create/update return the same item.
-**Request body vs manifest:** `FooManifest` is only the persisted jsonb document. Flag create/put bodies that flatten manifest fields onto the request root or alias the request schema to `FooManifest`. They must be `CreateFooRequest` / `PutFooRequest` with an explicit wrapper:
+**Request body vs manifest:** `FooManifest` is only the persisted jsonb document. Flag create/update bodies that flatten manifest fields onto the request root or alias the request schema to `FooManifest`. They must be `CreateFooRequest` / `UpdateFooRequest` with an explicit wrapper:
```ts
{
@@ -47,7 +47,7 @@ Prefer reusing `GetFooResponse` when create/update return the same item.
Session/turn-style creates that are not a stored manifest keep a flat `Create*Request` without a `manifest` key.
-Settings list → `ListFoosResponse`; chat → `ListAvailableFoosResponse`; catalog → `ListCatalogFoosResponse` / item `CatalogFoo`.
+Settings list → `ListFoosResponse`; chat → `ListAvailableFoosResponse`. Catalogs are a single `GET /api/v1/catalogs/{collection}` of the whole blob → `GetFooCatalogResponse` / item `CatalogFoo` (not a `ListCatalog*` list endpoint).
Nested child `Bar`: `ListBarsResponse`, `CreateBarRequest`, `GetBarResponse`; Fern `list_bars`, `create_bar`, …
diff --git a/packages/trueforge/AGENTS.md b/packages/trueforge/AGENTS.md
index 0114cb7d8..79d9a3071 100644
--- a/packages/trueforge/AGENTS.md
+++ b/packages/trueforge/AGENTS.md
@@ -18,15 +18,15 @@ If a settings resource is one-per-tenant (e.g. sandbox provider), keep the plura
| `GET /foos` | `ListFoosRequestQuery` (if any) | `ListFoosResponse` |
| `POST /foos` | `CreateFooRequest` | `GetFooResponse` (or `CreateFooResponse`) |
| `GET /foos/{foo_id}` | — | `GetFooResponse` |
-| `PUT` upsert/replace | `PutFooRequest` | `GetFooResponse` (or `PutFooResponse`) |
+| `PUT` upsert/replace | `UpdateFooRequest` | `GetFooResponse` (or `UpdateFooResponse`) |
| `DELETE /foos/{foo_id}` | `DeleteFoosRequestQuery` (optional) | `DeleteFooResponse` (`{}`) |
-Prefer reusing `GetFooResponse` when create/update return the same item.
+Prefer reusing `GetFooResponse` when create/update return the same item. `GET /auth/me` is `GetMeResponse`. Acronyms in OpenAPI names stay uppercase (`MCPServer`, not `McpServer`).
-**Request body vs manifest:** `FooManifest` is only the persisted jsonb document. Create/put OpenAPI bodies MUST be `CreateFooRequest` / `PutFooRequest` with an explicit wrapper — never flatten manifest fields onto the request root and never alias the request schema to `FooManifest`:
+**Request body vs manifest:** `FooManifest` is only the persisted jsonb document. Create/update OpenAPI bodies MUST be `CreateFooRequest` / `UpdateFooRequest` with an explicit wrapper — never flatten manifest fields onto the request root and never alias the request schema to `FooManifest`:
```ts
-// CreateFooRequest / PutFooRequest
+// CreateFooRequest / UpdateFooRequest
{
manifest: FooManifest; // stored document only
dry_run?: boolean; // operation-level fields live beside manifest
@@ -35,7 +35,7 @@ Prefer reusing `GetFooResponse` when create/update return the same item.
Session/turn-style creates that are not a stored manifest keep a flat `Create*Request` without a `manifest` key.
-Settings list → `ListFoosResponse`; chat → `ListAvailableFoosResponse`; catalog → `ListCatalogFoosResponse` / item `CatalogFoo`.
+Settings list → `ListFoosResponse`; chat → `ListAvailableFoosResponse`. Catalogs are a single `GET /api/v1/catalogs/{collection}` of the whole blob → `GetFooCatalogResponse` / item `CatalogFoo` (not a `ListCatalog*` list endpoint).
Nested child `Bar`: `ListBarsResponse`, `CreateBarRequest`, `GetBarResponse`; Fern `list_bars`, `create_bar`, …
diff --git a/packages/trueforge/src/apis/auth.ts b/packages/trueforge/src/apis/auth.ts
index 839d2a0aa..d90a1e3f6 100644
--- a/packages/trueforge/src/apis/auth.ts
+++ b/packages/trueforge/src/apis/auth.ts
@@ -8,7 +8,7 @@ import { authMiddleware, resolveAuthUser } from '../auth/middleware';
import { buildLoginAuthorization, exchangeAuthorizationCode, getOidcVerify } from '../auth/oidc';
import { safeReturnTo } from '../auth/safeReturnTo';
import { authLoginRoute, authLogoutRoute, meRoute, oAuthCallbackRoute } from '../routes/authRoutes';
-import type { MeResponse } from '../schemas/auth';
+import type { GetMeResponse } from '../schemas/auth';
/** Login / OIDC failures land on `/?error=<reason>`. */
function oauthErrorRedirect(reason: string): string {
@@ -92,7 +92,7 @@ export function createAuthRouter(params: { oidcClient: Configuration | undefined
gated.use('*', authMiddleware);
gated.openapi(meRoute, c => {
const user = resolveUserContext(c);
- const body: MeResponse = getOidcVerify()
+ const body: GetMeResponse = getOidcVerify()
? { type: 'oidc-connected', email: user.userRef, role: user.role }
: { type: 'default', email: user.userRef, role: user.role };
return c.json(body, 200);
diff --git a/packages/trueforge/src/apis/mcpServers.ts b/packages/trueforge/src/apis/mcpServers.ts
index 7c1636499..8a1c1d128 100644
--- a/packages/trueforge/src/apis/mcpServers.ts
+++ b/packages/trueforge/src/apis/mcpServers.ts
@@ -21,12 +21,12 @@ import {
} from '../routes/mcpServerRoutes';
import { getMcpConnection } from '../runtime/sessionResources';
import type {
+ AvailableMcpServer,
ConfiguredMcpServer,
CreateMcpServerRequest,
McpAuthStatus,
McpServerManifest,
- McpServerReadEntry,
- PutMcpServerRequest,
+ UpdateMcpServerRequest,
} from '../schemas/mcpServer';
import { resolveMcpAuthStatus } from '../schemas/mcpServer';
import { MissingStoredSecretError, resolveStoredSecretValue, toRedactedSecretValue } from '../utils/secretRedaction';
@@ -117,13 +117,13 @@ function toConfiguredMcpServer({
};
}
-function toMcpServerReadEntry({
+function toAvailableMcpServer({
record,
token,
}: {
record: McpServerRecord;
token: OAuthToken | undefined;
-}): McpServerReadEntry {
+}): AvailableMcpServer {
const authType = record.manifest.auth?.type;
return {
name: record.name,
@@ -228,7 +228,7 @@ export function createSettingsMcpServersRouter<TTransaction>(deps: McpServersRou
const putHandler: RouteHandler<typeof putMcpServerRoute> = async c => {
const userRef = deps.resolveUserContext(c).userRef;
- const body: PutMcpServerRequest = c.req.valid('json');
+ const body: UpdateMcpServerRequest = c.req.valid('json');
const incomingManifest = body.manifest;
try {
@@ -438,7 +438,7 @@ export function createMcpServersRouter<TTransaction>(deps: McpServersRouterDeps<
const tokens = await deps.tokenStore.getTokens({ ids: dcrIds, userRef });
return c.json(
{
- data: records.map(record => toMcpServerReadEntry({ record, token: tokens.get(record.id) })),
+ data: records.map(record => toAvailableMcpServer({ record, token: tokens.get(record.id) })),
},
200,
);
diff --git a/packages/trueforge/src/apis/modelProviders.ts b/packages/trueforge/src/apis/modelProviders.ts
index 1abf952a2..c189ae334 100644
--- a/packages/trueforge/src/apis/modelProviders.ts
+++ b/packages/trueforge/src/apis/modelProviders.ts
@@ -12,10 +12,10 @@ import {
} from '../routes/modelProviderRoutes';
import {
modelProviderName,
+ type ConfiguredModelProvider,
type CreateModelProviderRequest,
- type ModelProvider,
type ModelProviderManifest,
- type PutModelProviderRequest,
+ type UpdateModelProviderRequest,
} from '../schemas/modelProvider';
import { MissingStoredSecretError, resolveStoredSecretValue, toRedactedSecretValue } from '../utils/secretRedaction';
import { TENANT_ID } from './sessions';
@@ -56,7 +56,7 @@ function resolveModelProviderManifestForWrite({
};
}
-function toWireProvider(record: ModelProviderRecord): ModelProvider {
+function toWireProvider(record: ModelProviderRecord): ConfiguredModelProvider {
return {
name: record.name,
manifest: redactModelProvider(record.manifest),
@@ -90,7 +90,7 @@ export function createModelProvidersRouter<TTransaction>(deps: ModelProvidersRou
};
const putHandler: RouteHandler<typeof putModelProviderRoute> = async c => {
- const body: PutModelProviderRequest = c.req.valid('json');
+ const body: UpdateModelProviderRequest = c.req.valid('json');
const provider = body.manifest;
const name = modelProviderName(provider);
try {
diff --git a/packages/trueforge/src/apis/models.ts b/packages/trueforge/src/apis/models.ts
index 505d90b33..59fee68c1 100644
--- a/packages/trueforge/src/apis/models.ts
+++ b/packages/trueforge/src/apis/models.ts
@@ -1,16 +1,16 @@
import { OpenAPIHono } from '@hono/zod-openapi';
import type { IModelProviderStore } from '../db/modelProviderStore';
import type { WithTransaction } from '../db/transaction';
-import { listModelsRoute } from '../routes/modelRoutes';
+import { listAvailableModelsRoute } from '../routes/modelRoutes';
import { TENANT_ID } from './sessions';
-/** FQN read view over configured model providers (mounted at /api/v1/models). */
+/** Chat slim list (mounted at /api/v1/models) — mirrors GET /api/v1/skills. */
export function createModelsRouter<TTransaction>(deps: {
modelProviderStore: IModelProviderStore<TTransaction>;
withTransaction: WithTransaction<TTransaction>;
}) {
const router = new OpenAPIHono();
- router.openapi(listModelsRoute, async c =>
+ router.openapi(listAvailableModelsRoute, async c =>
c.json({ data: await deps.modelProviderStore.listModels(TENANT_ID) }, 200),
);
return router;
diff --git a/packages/trueforge/src/apis/sandboxProviders.ts b/packages/trueforge/src/apis/sandboxProviders.ts
index 13b54b362..9df3afa23 100644
--- a/packages/trueforge/src/apis/sandboxProviders.ts
+++ b/packages/trueforge/src/apis/sandboxProviders.ts
@@ -10,7 +10,7 @@ import {
toDaytonaSandboxProvider,
toSandboxStatus,
} from '../sandbox/providerUtils';
-import type { PutSandboxProviderRequest, SandboxProviderManifest } from '../schemas/sandboxProvider';
+import type { SandboxProviderManifest, UpdateSandboxProviderRequest } from '../schemas/sandboxProvider';
import { MissingStoredSecretError, resolveStoredSecretValue, toRedactedSecretValue } from '../utils/secretRedaction';
import { TENANT_ID } from './sessions';
@@ -56,7 +56,7 @@ export function createSandboxProvidersRouter<TTransaction>(deps: SandboxProvider
};
const putHandler: RouteHandler<typeof putSandboxProviderRoute> = async c => {
- const body: PutSandboxProviderRequest = c.req.valid('json');
+ const body: UpdateSandboxProviderRequest = c.req.valid('json');
const incoming = body.manifest;
const resolveManifest = (existing: SandboxProviderRecord | undefined): SandboxProviderManifest => ({
...incoming,
diff --git a/packages/trueforge/src/apis/skills.ts b/packages/trueforge/src/apis/skills.ts
index 4c2064a77..d5b6b9aa3 100644
--- a/packages/trueforge/src/apis/skills.ts
+++ b/packages/trueforge/src/apis/skills.ts
@@ -7,7 +7,7 @@ import {
listConfiguredSkillsRoute,
putSkillRoute,
} from '../routes/skillRoutes';
-import type { ConfiguredSkill, CreateSkillRequest, PutSkillRequest } from '../schemas/skill';
+import type { ConfiguredSkill, CreateSkillRequest, UpdateSkillRequest } from '../schemas/skill';
import { TENANT_ID } from './sessions';
export interface SkillsRouterDeps<TTransaction> {
@@ -49,7 +49,7 @@ export function createSkillsRouter<TTransaction>(deps: SkillsRouterDeps<TTransac
};
const putHandler: RouteHandler<typeof putSkillRoute> = async c => {
- const body: PutSkillRequest = c.req.valid('json');
+ const body: UpdateSkillRequest = c.req.valid('json');
const manifest = body.manifest;
const record = await deps.skillStore.upsertSkill({
tenant_id: TENANT_ID,
diff --git a/packages/trueforge/src/db/modelProviderStore.ts b/packages/trueforge/src/db/modelProviderStore.ts
index e0f5408ac..3197ee57c 100644
--- a/packages/trueforge/src/db/modelProviderStore.ts
+++ b/packages/trueforge/src/db/modelProviderStore.ts
@@ -4,7 +4,7 @@
* Implementations: PostgresModelProviderStore and SqliteModelProviderStore.
*/
import type { ResourceName } from '../schemas/common';
-import type { Model, ModelProviderManifest } from '../schemas/modelProvider';
+import type { AvailableModel, ModelProviderManifest } from '../schemas/modelProvider';
export interface ModelProviderRecord {
tenant_id: string;
@@ -61,11 +61,11 @@ export interface IModelProviderStore<TTransaction = never> {
/** Single-row write: creates the provider or replaces the whole manifest (models included). */
upsertProvider(input: UpsertModelProviderInput, transaction?: TTransaction): Promise<ModelProviderRecord>;
/** Flattens manifests into the FQN read view for GET /models. */
- listModels(tenantId: string, transaction?: TTransaction): Promise<Model[]>;
+ listModels(tenantId: string, transaction?: TTransaction): Promise<AvailableModel[]>;
}
/** Application-side flatten shared by both store implementations. */
-export function flattenProviderModels(records: ModelProviderRecord[]): Model[] {
+export function flattenProviderModels(records: ModelProviderRecord[]): AvailableModel[] {
return records.flatMap(record =>
record.manifest.models.map(model => ({
name: `${record.name}/${model.name}`,
diff --git a/packages/trueforge/src/db/postgres/model-provider-store/PostgresModelProviderStore.ts b/packages/trueforge/src/db/postgres/model-provider-store/PostgresModelProviderStore.ts
index e484b20e6..e27fb7b96 100644
--- a/packages/trueforge/src/db/postgres/model-provider-store/PostgresModelProviderStore.ts
+++ b/packages/trueforge/src/db/postgres/model-provider-store/PostgresModelProviderStore.ts
@@ -1,5 +1,5 @@
import type { Kysely, Selectable, Transaction } from 'kysely';
-import type { Model } from '../../../schemas/modelProvider';
+import type { AvailableModel } from '../../../schemas/modelProvider';
import {
flattenProviderModels,
ModelProviderNameConflictError,
@@ -120,7 +120,7 @@ export class PostgresModelProviderStore implements IModelProviderStore<Transacti
return toRecord(row);
}
- async listModels(tenantId: string, transaction?: Transaction<Database>): Promise<Model[]> {
+ async listModels(tenantId: string, transaction?: Transaction<Database>): Promise<AvailableModel[]> {
return flattenProviderModels(await this.listProviders(tenantId, transaction));
}
}
diff --git a/packages/trueforge/src/db/sqlite/model-provider-store/SqliteModelProviderStore.ts b/packages/trueforge/src/db/sqlite/model-provider-store/SqliteModelProviderStore.ts
index 8f4479784..d6503d4f5 100644
--- a/packages/trueforge/src/db/sqlite/model-provider-store/SqliteModelProviderStore.ts
+++ b/packages/trueforge/src/db/sqlite/model-provider-store/SqliteModelProviderStore.ts
@@ -1,5 +1,5 @@
import type { ExpressionBuilder, Kysely, Transaction } from 'kysely';
-import type { Model, ModelProviderManifest } from '../../../schemas/modelProvider';
+import type { AvailableModel, ModelProviderManifest } from '../../../schemas/modelProvider';
import {
flattenProviderModels,
ModelProviderNameConflictError,
@@ -121,7 +121,7 @@ export class SqliteModelProviderStore implements IModelProviderStore<Transaction
.executeTakeFirstOrThrow();
}
- async listModels(tenantId: string, transaction?: Transaction<Database>): Promise<Model[]> {
+ async listModels(tenantId: string, transaction?: Transaction<Database>): Promise<AvailableModel[]> {
return flattenProviderModels(await this.listProviders(tenantId, transaction));
}
}
diff --git a/packages/trueforge/src/routes/agentRoutes.ts b/packages/trueforge/src/routes/agentRoutes.ts
index da72aae21..b859ef342 100644
--- a/packages/trueforge/src/routes/agentRoutes.ts
+++ b/packages/trueforge/src/routes/agentRoutes.ts
@@ -8,7 +8,7 @@ import {
DeleteAgentResponseSchema,
GetAgentResponseSchema,
ListAgentsResponseSchema,
- PutAgentRequestSchema,
+ UpdateAgentRequestSchema,
} from '../schemas/agent';
import { RequestErrorResponseSchema } from '../schemas/errors';
import { OpenApiTag } from './openapiTags';
@@ -130,7 +130,7 @@ export const putAgentRoute = createRoute({
request: {
params: AgentIdParamsSchema,
body: {
- content: { 'application/json': { schema: PutAgentRequestSchema } },
+ content: { 'application/json': { schema: UpdateAgentRequestSchema } },
required: true,
},
},
diff --git a/packages/trueforge/src/routes/authRoutes.ts b/packages/trueforge/src/routes/authRoutes.ts
index a95fe79e9..ad6a4ed10 100644
--- a/packages/trueforge/src/routes/authRoutes.ts
+++ b/packages/trueforge/src/routes/authRoutes.ts
@@ -6,7 +6,7 @@
* MCP OAuth callback in mcpOAuthRoutes.ts. `me` generates normally.
*/
import { createRoute } from '@hono/zod-openapi';
-import { AuthLoginQuerySchema, MeResponseSchema, OAuthCallbackQuerySchema } from '../schemas/auth';
+import { AuthLoginQuerySchema, GetMeResponseSchema, OAuthCallbackQuerySchema } from '../schemas/auth';
import { RequestErrorResponseSchema } from '../schemas/errors';
import { OpenApiTag } from './openapiTags';
@@ -70,7 +70,7 @@ export const meRoute = createRoute({
'x-fern-sdk-method-name': 'me',
responses: {
200: {
- content: { 'application/json': { schema: MeResponseSchema } },
+ content: { 'application/json': { schema: GetMeResponseSchema } },
description: 'Session type and identity for the current request.',
},
401: {
diff --git a/packages/trueforge/src/routes/capabilityRoutes.ts b/packages/trueforge/src/routes/capabilityRoutes.ts
index 714161ee5..9774f755f 100644
--- a/packages/trueforge/src/routes/capabilityRoutes.ts
+++ b/packages/trueforge/src/routes/capabilityRoutes.ts
@@ -2,22 +2,38 @@ import { createRoute, z } from '@hono/zod-openapi';
import { RequestErrorResponseSchema } from '../schemas/errors';
import { OpenApiTag } from './openapiTags';
+const SandboxCapabilitySchema = z
+ .object({
+ enabled: z.boolean().describe('Whether a sandbox provider is configured for this tenant.'),
+ })
+ .openapi('SandboxCapability');
+
+const SkillCapabilitySchema = z
+ .object({
+ enabled: z
+ .boolean()
+ .describe('Whether skills are available. False when sandbox is not enabled (skills require a sandbox).'),
+ reason: z.string().optional().describe('Present when skills are disabled. Explains why.'),
+ })
+ .openapi('SkillCapability');
+
+const SettingsCapabilitySchema = z
+ .object({
+ enabled: z.boolean().describe('Whether the settings UI/API is enabled.'),
+ })
+ .openapi('SettingsCapability');
+
+const CapabilitiesDataSchema = z
+ .object({
+ sandbox: SandboxCapabilitySchema,
+ skill: SkillCapabilitySchema,
+ settings: SettingsCapabilitySchema,
+ })
+ .openapi('CapabilitiesData');
+
const GetCapabilitiesResponseSchema = z
.object({
- data: z.object({
- sandbox: z.object({
- enabled: z.boolean().describe('Whether a sandbox provider is configured for this tenant.'),
- }),
- skill: z.object({
- enabled: z
- .boolean()
- .describe('Whether skills are available. False when sandbox is not enabled (skills require a sandbox).'),
- reason: z.string().optional().describe('Present when skills are disabled. Explains why.'),
- }),
- settings: z.object({
- enabled: z.boolean().describe('Whether the settings UI/API is enabled.'),
- }),
- }),
+ data: CapabilitiesDataSchema,
})
.openapi('GetCapabilitiesResponse');
diff --git a/packages/trueforge/src/routes/mcpServerRoutes.ts b/packages/trueforge/src/routes/mcpServerRoutes.ts
index 7ef1d7e4c..9bfda2f62 100644
--- a/packages/trueforge/src/routes/mcpServerRoutes.ts
+++ b/packages/trueforge/src/routes/mcpServerRoutes.ts
@@ -11,7 +11,7 @@ import {
ListAvailableMcpServersResponseSchema,
ListMcpServersResponseSchema,
McpAuthStatusSchema,
- PutMcpServerRequestSchema,
+ UpdateMcpServerRequestSchema,
} from '../schemas/mcpServer';
import { OpenApiTag } from './openapiTags';
@@ -137,7 +137,7 @@ export const putMcpServerRoute = createRoute({
'x-fern-sdk-method-name': 'create_or_update',
request: {
body: {
- content: { 'application/json': { schema: PutMcpServerRequestSchema } },
+ content: { 'application/json': { schema: UpdateMcpServerRequestSchema } },
required: true,
},
},
@@ -164,7 +164,7 @@ const ListMcpServerToolsResponseSchema = z
.array(z.record(z.string(), z.unknown()))
.describe('MCP `tools/list` entries, passed through verbatim from the MCP server.'),
})
- .openapi('ListMcpServerToolsResponse');
+ .openapi('ListMCPServerToolsResponse');
export const listMcpServerToolsRoute = createRoute({
method: 'get',
diff --git a/packages/trueforge/src/routes/modelProviderRoutes.ts b/packages/trueforge/src/routes/modelProviderRoutes.ts
index e2a3ffd1c..1c55fe26e 100644
--- a/packages/trueforge/src/routes/modelProviderRoutes.ts
+++ b/packages/trueforge/src/routes/modelProviderRoutes.ts
@@ -9,7 +9,7 @@ import {
CreateModelProviderRequestSchema,
GetModelProviderResponseSchema,
ListModelProvidersResponseSchema,
- PutModelProviderRequestSchema,
+ UpdateModelProviderRequestSchema,
} from '../schemas/modelProvider';
import { OpenApiTag } from './openapiTags';
@@ -81,7 +81,7 @@ export const putModelProviderRoute = createRoute({
'x-fern-sdk-method-name': 'create_or_update',
request: {
body: {
- content: { 'application/json': { schema: PutModelProviderRequestSchema } },
+ content: { 'application/json': { schema: UpdateModelProviderRequestSchema } },
required: true,
},
},
diff --git a/packages/trueforge/src/routes/modelRoutes.ts b/packages/trueforge/src/routes/modelRoutes.ts
index 750e9f6aa..e857e8d07 100644
--- a/packages/trueforge/src/routes/modelRoutes.ts
+++ b/packages/trueforge/src/routes/modelRoutes.ts
@@ -1,20 +1,21 @@
import { createRoute } from '@hono/zod-openapi';
import { RequestErrorResponseSchema } from '../schemas/errors';
-import { ListModelsResponseSchema } from '../schemas/modelProvider';
+import { ListAvailableModelsResponseSchema } from '../schemas/modelProvider';
import { OpenApiTag } from './openapiTags';
-export const listModelsRoute = createRoute({
+/** Chat/composer read view — mounted at /api/v1/models (not under settings). */
+export const listAvailableModelsRoute = createRoute({
method: 'get',
path: '/',
tags: [OpenApiTag.MODELS],
- summary: 'List models',
+ summary: 'List models for chat',
'x-fern-sdk-group-name': ['models'],
'x-fern-sdk-method-name': 'list',
- description: 'Models across all configured model providers, addressed by fully qualified name `name/model_name`.',
+ description: 'Configured models as a slim FQN list for the composer.',
responses: {
200: {
- content: { 'application/json': { schema: ListModelsResponseSchema } },
- description: 'All models of all configured providers.',
+ content: { 'application/json': { schema: ListAvailableModelsResponseSchema } },
+ description: 'All configured models (chat projection).',
},
401: {
content: { 'application/json': { schema: RequestErrorResponseSchema } },
diff --git a/packages/trueforge/src/routes/sandboxProviderRoutes.ts b/packages/trueforge/src/routes/sandboxProviderRoutes.ts
index 5c9144b3c..c1be8d052 100644
--- a/packages/trueforge/src/routes/sandboxProviderRoutes.ts
+++ b/packages/trueforge/src/routes/sandboxProviderRoutes.ts
@@ -5,7 +5,7 @@
*/
import { createRoute } from '@hono/zod-openapi';
import { RequestErrorResponseSchema } from '../schemas/errors';
-import { GetSandboxProviderResponseSchema, PutSandboxProviderRequestSchema } from '../schemas/sandboxProvider';
+import { GetSandboxProviderResponseSchema, UpdateSandboxProviderRequestSchema } from '../schemas/sandboxProvider';
import { OpenApiTag } from './openapiTags';
export const getSandboxProviderRoute = createRoute({
@@ -40,7 +40,7 @@ export const putSandboxProviderRoute = createRoute({
'x-fern-sdk-method-name': 'create_or_update',
request: {
body: {
- content: { 'application/json': { schema: PutSandboxProviderRequestSchema } },
+ content: { 'application/json': { schema: UpdateSandboxProviderRequestSchema } },
required: true,
},
},
diff --git a/packages/trueforge/src/routes/skillRoutes.ts b/packages/trueforge/src/routes/skillRoutes.ts
index cd286e496..5770c6d75 100644
--- a/packages/trueforge/src/routes/skillRoutes.ts
+++ b/packages/trueforge/src/routes/skillRoutes.ts
@@ -11,7 +11,7 @@ import {
GetSkillResponseSchema,
ListAvailableSkillsResponseSchema,
ListSkillsResponseSchema,
- PutSkillRequestSchema,
+ UpdateSkillRequestSchema,
} from '../schemas/skill';
import { OpenApiTag } from './openapiTags';
@@ -100,7 +100,7 @@ export const putSkillRoute = createRoute({
'x-fern-sdk-method-name': 'create_or_update',
request: {
body: {
- content: { 'application/json': { schema: PutSkillRequestSchema } },
+ content: { 'application/json': { schema: UpdateSkillRequestSchema } },
required: true,
},
},
diff --git a/packages/trueforge/src/schemas/agent.ts b/packages/trueforge/src/schemas/agent.ts
index d02366630..b8db5a0e0 100644
--- a/packages/trueforge/src/schemas/agent.ts
+++ b/packages/trueforge/src/schemas/agent.ts
@@ -16,12 +16,12 @@ export const CreateAgentRequestSchema = z
.openapi('CreateAgentRequest');
/** PUT body: full manifest replacement. Identity is the path `agent_id`. */
-export const PutAgentRequestSchema = z
+export const UpdateAgentRequestSchema = z
.object({
manifest: AgentSpecSchema,
})
.strict()
- .openapi('PutAgentRequest');
+ .openapi('UpdateAgentRequest');
/** List/get/create/update response item: identity columns plus nested manifest. */
export const AgentSchema = z
@@ -38,5 +38,5 @@ export const ListAgentsResponseSchema = z.object({ data: z.array(AgentSchema) })
export const DeleteAgentResponseSchema = z.object({}).openapi('DeleteAgentResponse');
export type CreateAgentRequest = z.infer<typeof CreateAgentRequestSchema>;
-export type PutAgentRequest = z.infer<typeof PutAgentRequestSchema>;
+export type UpdateAgentRequest = z.infer<typeof UpdateAgentRequestSchema>;
export type Agent = z.infer<typeof AgentSchema>;
diff --git a/packages/trueforge/src/schemas/auth.ts b/packages/trueforge/src/schemas/auth.ts
index 53211bf89..9574f8ca6 100644
--- a/packages/trueforge/src/schemas/auth.ts
+++ b/packages/trueforge/src/schemas/auth.ts
@@ -28,7 +28,7 @@ export const OAuthCallbackSuccessSchema = z.object({
success: z.literal(true).describe('Present when the OAuth callback completed without a return_to.'),
});
-export const MeResponseSchema = z
+export const GetMeResponseSchema = z
.object({
type: z
.enum(['default', 'oidc-connected'])
@@ -38,6 +38,6 @@ export const MeResponseSchema = z
email: z.string().describe('User email from the ID token when connected; `"default"` when anonymous.'),
role: z.string().describe('Caller role.'),
})
- .openapi('MeResponse');
+ .openapi('GetMeResponse');
-export type MeResponse = z.infer<typeof MeResponseSchema>;
+export type GetMeResponse = z.infer<typeof GetMeResponseSchema>;
diff --git a/packages/trueforge/src/schemas/mcpCatalog.ts b/packages/trueforge/src/schemas/mcpCatalog.ts
index 0f6f715f1..215eb0481 100644
--- a/packages/trueforge/src/schemas/mcpCatalog.ts
+++ b/packages/trueforge/src/schemas/mcpCatalog.ts
@@ -17,7 +17,7 @@ export const CatalogMcpServerSchema = z
auth: McpServerManifestAuthSchema.optional(),
})
.strict()
- .openapi('CatalogMcpServer');
+ .openapi('CatalogMCPServer');
export const McpCatalogFileSchema = z
.object({
@@ -32,7 +32,7 @@ export const GetMcpServerCatalogResponseSchema = z
.object({
data: z.array(CatalogMcpServerSchema),
})
- .openapi('GetMcpServerCatalogResponse');
+ .openapi('GetMCPServerCatalogResponse');
export type CatalogMcpServer = z.infer<typeof CatalogMcpServerSchema>;
export type McpCatalogFile = z.infer<typeof McpCatalogFileSchema>;
diff --git a/packages/trueforge/src/schemas/mcpServer.ts b/packages/trueforge/src/schemas/mcpServer.ts
index cd75c976d..ae4d3739c 100644
--- a/packages/trueforge/src/schemas/mcpServer.ts
+++ b/packages/trueforge/src/schemas/mcpServer.ts
@@ -11,7 +11,7 @@ import type { OAuthToken } from '../mcp/auth/types';
import { NameSchema } from './common';
/** Transport/kind of MCP server. Extend when non-remote kinds ship. */
-export const McpServerTypeSchema = z.enum(['remote']).openapi('McpServerType');
+export const McpServerTypeSchema = z.enum(['remote']).openapi('MCPServerType');
const McpServerHeaderAuthSchema = z
.object({
@@ -26,7 +26,7 @@ const McpServerHeaderAuthSchema = z
),
})
.strict()
- .openapi('McpServerHeaderAuth');
+ .openapi('MCPServerHeaderAuth');
/** OAuth Dynamic Client Registration — stub until authorize/token exchange is wired. */
const McpServerDcrAuthSchema = z
@@ -34,12 +34,12 @@ const McpServerDcrAuthSchema = z
type: z.literal('dcr').describe('Authenticate via OAuth Dynamic Client Registration.'),
})
.strict()
- .openapi('McpServerDcrAuth');
+ .openapi('MCPServerDcrAuth');
export const McpServerManifestAuthSchema = z
.discriminatedUnion('type', [McpServerHeaderAuthSchema, McpServerDcrAuthSchema])
.describe('Optional auth settings. Omit when the server needs no credentials.')
- .openapi('McpServerManifestAuth');
+ .openapi('MCPServerManifestAuth');
export const McpServerDescriptionSchema = z
.string()
@@ -58,7 +58,7 @@ export const McpServerManifestObjectSchema = z
})
.strict();
-export const McpServerManifestSchema = McpServerManifestObjectSchema.openapi('McpServerManifest');
+export const McpServerManifestSchema = McpServerManifestObjectSchema.openapi('MCPServerManifest');
export const McpAuthStatusSchema = z
.object({
@@ -72,7 +72,7 @@ export const McpAuthStatusSchema = z
})
.strict()
.describe('Current auth state.')
- .openapi('McpAuthStatus');
+ .openapi('MCPAuthStatus');
/** Admin/settings wire view: identity column plus nested manifest and auth_status. */
export const ConfiguredMcpServerSchema = z
@@ -82,26 +82,26 @@ export const ConfiguredMcpServerSchema = z
auth_status: McpAuthStatusSchema,
})
.strict()
- .openapi('ConfiguredMcpServer');
+ .openapi('ConfiguredMCPServer');
export const CreateMcpServerRequestSchema = z
.object({
manifest: McpServerManifestSchema,
})
.strict()
- .openapi('CreateMcpServerRequest');
+ .openapi('CreateMCPServerRequest');
-export const PutMcpServerRequestSchema = z
+export const UpdateMcpServerRequestSchema = z
.object({
manifest: McpServerManifestSchema,
})
.strict()
- .openapi('PutMcpServerRequest');
+ .openapi('UpdateMCPServerRequest');
-export const GetMcpServerResponseSchema = z.object({ data: ConfiguredMcpServerSchema }).openapi('GetMcpServerResponse');
+export const GetMcpServerResponseSchema = z.object({ data: ConfiguredMcpServerSchema }).openapi('GetMCPServerResponse');
export const ListMcpServersResponseSchema = z
.object({ data: z.array(ConfiguredMcpServerSchema) })
- .openapi('ListMcpServersResponse');
+ .openapi('ListMCPServersResponse');
/** Public auth mechanism for chat/composer (no secrets). */
export const McpServerAuthPublicSchema = z
@@ -110,10 +110,10 @@ export const McpServerAuthPublicSchema = z
z.object({ type: z.literal('header') }).strict(),
])
.describe('Auth mechanism when configured (no secrets). Omit when the server needs no credentials.')
- .openapi('McpServerAuthPublic');
+ .openapi('MCPServerAuthPublic');
/** Chat/composer read view — public fields plus per-user auth_status. */
-export const McpServerReadEntrySchema = z
+export const AvailableMcpServerSchema = z
.object({
name: NameSchema,
url: z.url().describe('URL of the remote MCP server.'),
@@ -121,11 +121,11 @@ export const McpServerReadEntrySchema = z
auth_status: McpAuthStatusSchema,
})
.strict()
- .openapi('McpServerReadEntry');
+ .openapi('AvailableMCPServer');
export const ListAvailableMcpServersResponseSchema = z
- .object({ data: z.array(McpServerReadEntrySchema) })
- .openapi('ListAvailableMcpServersResponse');
+ .object({ data: z.array(AvailableMcpServerSchema) })
+ .openapi('ListAvailableMCPServersResponse');
export type McpServerType = z.infer<typeof McpServerTypeSchema>;
export type McpServerManifestAuth = z.infer<typeof McpServerManifestAuthSchema>;
@@ -134,8 +134,8 @@ 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>;
+export type UpdateMcpServerRequest = z.infer<typeof UpdateMcpServerRequestSchema>;
+export type AvailableMcpServer = z.infer<typeof AvailableMcpServerSchema>;
/**
* Headers for live MCP calls against a configured server.
diff --git a/packages/trueforge/src/schemas/modelCatalog.ts b/packages/trueforge/src/schemas/modelCatalog.ts
index 5b5a9ed89..6fc079b2c 100644
--- a/packages/trueforge/src/schemas/modelCatalog.ts
+++ b/packages/trueforge/src/schemas/modelCatalog.ts
@@ -4,7 +4,12 @@
*/
import { z } from '@hono/zod-openapi';
import { uniqueTypes } from './common';
-import { ModelEntrySchema, ModelProviderTypeSchema, ReasoningEffortSchema, refineUniqueModels } from './modelProvider';
+import {
+ ConfiguredModelSchema,
+ ModelProviderTypeSchema,
+ ReasoningEffortSchema,
+ refineUniqueModels,
+} from './modelProvider';
/**
* Catalog entry. Well-known types list model presets; `custom` is a sentinel that
@@ -14,11 +19,14 @@ export const CatalogWellKnownModelProviderTypeSchema = ModelProviderTypeSchema.e
'CatalogWellKnownModelProviderType',
);
+/** Same shape as a configured model; named for the catalog view it appears in. */
+export const CatalogModelSchema = ConfiguredModelSchema.openapi('CatalogModel');
+
export const CatalogWellKnownModelProviderSchema = z
.object({
type: CatalogWellKnownModelProviderTypeSchema,
logo: z.url().optional().describe('URL of the provider logo asset'),
- models: z.array(ModelEntrySchema).describe('Preset models'),
+ models: z.array(CatalogModelSchema).describe('Preset models'),
})
.strict()
.openapi('CatalogWellKnownModelProvider');
diff --git a/packages/trueforge/src/schemas/modelProvider.ts b/packages/trueforge/src/schemas/modelProvider.ts
index 20ce53696..56e1d6983 100644
--- a/packages/trueforge/src/schemas/modelProvider.ts
+++ b/packages/trueforge/src/schemas/modelProvider.ts
@@ -29,14 +29,14 @@ export const ModelPropertiesSchema = z
.describe('Optional model capability metadata.')
.openapi('ModelProperties');
-export const ModelEntrySchema = z
+export const ConfiguredModelSchema = z
.object({
model_id: z.string().min(1).describe('Upstream, provider-specific identifier sent to the provider API.'),
name: NameSchema,
properties: ModelPropertiesSchema,
})
.strict()
- .openapi('ModelEntry');
+ .openapi('ConfiguredModel');
/** Adds issues when two models share a `model_id` or a `name`. */
export function refineUniqueModels(models: { model_id: string; name: string }[], ctx: z.RefinementCtx): void {
@@ -70,7 +70,7 @@ const ModelProviderAuthSchema = z
const ModelProviderManifestBaseSchema = z
.object({
auth: ModelProviderAuthSchema,
- models: z.array(ModelEntrySchema).min(1).describe('Models exposed by this provider (at least one).'),
+ models: z.array(ConfiguredModelSchema).min(1).describe('Models exposed by this provider (at least one).'),
})
.strict();
@@ -177,13 +177,13 @@ export function modelProviderName(provider: ModelProviderManifest): ResourceName
}
/** Settings wire item: identity column plus nested manifest. */
-export const ModelProviderSchema = z
+export const ConfiguredModelProviderSchema = z
.object({
name: NameSchema,
manifest: ModelProviderManifestSchema,
})
.strict()
- .openapi('ModelProvider');
+ .openapi('ConfiguredModelProvider');
export const CreateModelProviderRequestSchema = z
.object({
@@ -192,56 +192,56 @@ export const CreateModelProviderRequestSchema = z
.strict()
.openapi('CreateModelProviderRequest');
-export const PutModelProviderRequestSchema = z
+export const UpdateModelProviderRequestSchema = z
.object({
manifest: ModelProviderManifestSchema,
})
.strict()
- .openapi('PutModelProviderRequest');
+ .openapi('UpdateModelProviderRequest');
export const GetModelProviderResponseSchema = z
.object({
- data: ModelProviderSchema,
+ data: ConfiguredModelProviderSchema,
})
.openapi('GetModelProviderResponse');
export const ListModelProvidersResponseSchema = z
.object({
- data: z.array(ModelProviderSchema),
+ data: z.array(ConfiguredModelProviderSchema),
})
.openapi('ListModelProvidersResponse');
/** Provider identity on the models list read view. */
-export const ModelListProviderSchema = z
+export const AvailableModelProviderSchema = z
.object({
name: z.string().min(1).describe('Configured provider resource name; matches the FQN prefix of `name`.'),
})
.strict()
.describe('Owning configured provider.')
- .openapi('ModelListProvider');
+ .openapi('AvailableModelProvider');
/** Read view over configured providers: FQN plus explicit provider identity for clients. */
-export const ModelSchema = z
+export const AvailableModelSchema = z
.object({
name: 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,
+ provider: AvailableModelProviderSchema,
properties: ModelPropertiesSchema,
})
.strict()
- .openapi('Model');
+ .openapi('AvailableModel');
-export const ListModelsResponseSchema = z
+export const ListAvailableModelsResponseSchema = z
.object({
- data: z.array(ModelSchema),
+ data: z.array(AvailableModelSchema),
})
- .openapi('ListModelsResponse');
+ .openapi('ListAvailableModelsResponse');
export type ModelProviderManifest = z.infer<typeof ModelProviderManifestSchema>;
-export type ModelProvider = z.infer<typeof ModelProviderSchema>;
+export type ConfiguredModelProvider = z.infer<typeof ConfiguredModelProviderSchema>;
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>;
+export type UpdateModelProviderRequest = z.infer<typeof UpdateModelProviderRequestSchema>;
+export type AvailableModelProvider = z.infer<typeof AvailableModelProviderSchema>;
+export type AvailableModel = z.infer<typeof AvailableModelSchema>;
diff --git a/packages/trueforge/src/schemas/sandboxCatalog.ts b/packages/trueforge/src/schemas/sandboxCatalog.ts
index b765e7f48..d4e499350 100644
--- a/packages/trueforge/src/schemas/sandboxCatalog.ts
+++ b/packages/trueforge/src/schemas/sandboxCatalog.ts
@@ -5,16 +5,13 @@
import { z } from '@hono/zod-openapi';
import { DaytonaSandboxProviderSchema } from './sandboxProvider';
-/** Catalog entry: Daytona preset without secrets. */
-export const CatalogDaytonaSandboxProviderSchema = DaytonaSandboxProviderSchema.omit({ auth: true })
- .strict()
- .openapi('CatalogDaytonaSandboxProvider');
-
/**
* Catalog wire type. Single variant today (avoids one-member `oneOf` in OpenAPI).
* Widen to a discriminated union when a second provider ships.
*/
-export const CatalogSandboxProviderSchema = CatalogDaytonaSandboxProviderSchema;
+export const CatalogSandboxProviderSchema = DaytonaSandboxProviderSchema.omit({ auth: true })
+ .strict()
+ .openapi('CatalogSandboxProvider');
export const SandboxCatalogFileSchema = z
.object({
@@ -28,6 +25,5 @@ export const GetSandboxProviderCatalogResponseSchema = z
})
.openapi('GetSandboxProviderCatalogResponse');
-export type CatalogDaytonaSandboxProvider = z.infer<typeof CatalogDaytonaSandboxProviderSchema>;
export type CatalogSandboxProvider = z.infer<typeof CatalogSandboxProviderSchema>;
export type SandboxCatalogFile = z.infer<typeof SandboxCatalogFileSchema>;
diff --git a/packages/trueforge/src/schemas/sandboxProvider.ts b/packages/trueforge/src/schemas/sandboxProvider.ts
index 5b292a3ae..a856c9bdc 100644
--- a/packages/trueforge/src/schemas/sandboxProvider.ts
+++ b/packages/trueforge/src/schemas/sandboxProvider.ts
@@ -79,25 +79,25 @@ export const SandboxStatusSchema = z
.strict();
/** Settings wire item: nested manifest plus build status (no build_metadata). */
-export const SandboxProviderSchema = z
+export const ConfiguredSandboxProviderSchema = z
.object({
manifest: SandboxProviderManifestSchema,
status: SandboxBuildStatusSchema,
status_reason: z.string().nullable().describe('Human-readable detail for the current status; null when ready.'),
})
.strict()
- .openapi('SandboxProvider');
+ .openapi('ConfiguredSandboxProvider');
-export const PutSandboxProviderRequestSchema = z
+export const UpdateSandboxProviderRequestSchema = z
.object({
manifest: SandboxProviderManifestSchema,
})
.strict()
- .openapi('PutSandboxProviderRequest');
+ .openapi('UpdateSandboxProviderRequest');
export const GetSandboxProviderResponseSchema = z
.object({
- data: SandboxProviderSchema,
+ data: ConfiguredSandboxProviderSchema,
})
.openapi('GetSandboxProviderResponse');
@@ -107,8 +107,8 @@ 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 SandboxProvider = z.infer<typeof SandboxProviderSchema>;
-export type PutSandboxProviderRequest = z.infer<typeof PutSandboxProviderRequestSchema>;
+export type ConfiguredSandboxProvider = z.infer<typeof ConfiguredSandboxProviderSchema>;
+export type UpdateSandboxProviderRequest = z.infer<typeof UpdateSandboxProviderRequestSchema>;
/** Wire/persisted snake_case → Daytona client credentials + provider settings. */
export function toDaytonaSandboxProviderInput(manifest: SandboxProviderManifest): {
diff --git a/packages/trueforge/src/schemas/skill.ts b/packages/trueforge/src/schemas/skill.ts
index 8d45395c6..008c7f68f 100644
--- a/packages/trueforge/src/schemas/skill.ts
+++ b/packages/trueforge/src/schemas/skill.ts
@@ -87,12 +87,12 @@ export const CreateSkillRequestSchema = z
.strict()
.openapi('CreateSkillRequest');
-export const PutSkillRequestSchema = z
+export const UpdateSkillRequestSchema = z
.object({
manifest: SkillManifestSchema,
})
.strict()
- .openapi('PutSkillRequest');
+ .openapi('UpdateSkillRequest');
export const GetSkillResponseSchema = z.object({ data: ConfiguredSkillSchema }).openapi('GetSkillResponse');
export const ListSkillsResponseSchema = z
@@ -100,21 +100,21 @@ export const ListSkillsResponseSchema = z
.openapi('ListSkillsResponse');
/** Chat/composer read view — discovery fields only. */
-export const SkillReadEntrySchema = z
+export const AvailableSkillSchema = z
.object({
name: NameSchema,
description: SkillDescriptionSchema,
})
.strict()
- .openapi('SkillReadEntry');
+ .openapi('AvailableSkill');
export const ListAvailableSkillsResponseSchema = z
- .object({ data: z.array(SkillReadEntrySchema) })
+ .object({ data: z.array(AvailableSkillSchema) })
.openapi('ListAvailableSkillsResponse');
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>;
+export type UpdateSkillRequest = z.infer<typeof UpdateSkillRequestSchema>;
+export type AvailableSkill = z.infer<typeof AvailableSkillSchema>;