The open-source agent harness - the runtime layer that turns an LLM into a working agent.
Regenerate OpenAPI document and TypeScript SDK
trueforge-dev-bot[bot]534755377da0
diff --git a/.github/fern/openapi/openapi.json b/.github/fern/openapi/openapi.jsonindex bca5ab445..aa5809d9b 100644--- a/.github/fern/openapi/openapi.json+++ b/.github/fern/openapi/openapi.json@@ -4829,119 +4829,78 @@},"openapi": "3.1.0","paths": {- "/api/v1/agents": {+ "/api/internal/metrics/charts": {"get": {- "description": "All configured agents for the tenant.",+ "description": "List available session metric charts.","responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ListAgentsResponse"- }- }- },- "description": "All configured agents."- },- "401": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "OIDC is configured and the request has no valid session cookie."- }- },- "summary": "List agents",- "tags": [- "Agents"- ],- "x-fern-sdk-group-name": [- "agents"- ],- "x-fern-sdk-method-name": "list"- },- "post": {- "description": "Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreateAgentRequest"- }- }- },- "required": true- },- "responses": {- "201": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GetAgentResponse"- }- }- },- "description": "The created agent."- },- "400": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Invalid request body or unknown model/MCP/skill refs."- },- "409": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "An agent with this name already exists."- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"+ "$ref": "#/components/schemas/GetSessionMetricsChartResponse"}}},- "description": "The agent spec is valid but requires a capability this server does not provide (e.g. sandbox or skills)."+ "description": "Available session metric charts."}},- "summary": "Create an agent",+ "summary": "Get session metrics charts","tags": [- "Agents"+ "Internal"],"x-fern-sdk-group-name": [- "agents"+ "internal",+ "metrics"],- "x-fern-sdk-method-name": "create"+ "x-fern-sdk-method-name": "list_charts"}},- "/api/v1/agents/{agent_id}": {- "delete": {- "description": "Delete a configured agent by immutable id. Idempotent if already gone.",+ "/api/internal/metrics/charts-data": {+ "get": {+ "description": "Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.","parameters": [{- "description": "Immutable agent identifier.",- "in": "path",+ "description": "Named agent identifier.",+ "in": "query","name": "agent_id","required": true,"schema": {- "description": "Immutable agent identifier.",+ "description": "Named agent identifier.","maxLength": 64,"minLength": 1,"type": "string"}+ },+ {+ "description": "Inclusive lower bound on session `created_at`.",+ "in": "query",+ "name": "start_timestamp",+ "required": true,+ "schema": {+ "description": "Inclusive lower bound on session `created_at`.",+ "format": "date-time",+ "type": "string"+ }+ },+ {+ "description": "Inclusive upper bound on session `created_at`.",+ "in": "query",+ "name": "end_timestamp",+ "required": true,+ "schema": {+ "description": "Inclusive upper bound on session `created_at`.",+ "format": "date-time",+ "type": "string"+ }+ },+ {+ "description": "Session metrics chart to return.",+ "in": "query",+ "name": "chart_name",+ "required": true,+ "schema": {+ "$ref": "#/components/schemas/SessionMetricsChartName"+ }}],"responses": {@@ -4949,13 +4908,13 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/DeleteAgentResponse"+ "$ref": "#/components/schemas/GetSessionMetricsChartDataResponse"}}},- "description": "Agent deleted."+ "description": "Zero-filled time series for one chart."},- "401": {+ "400": {"content": {"application/json": {"schema": {@@ -4963,32 +4922,57 @@}}},- "description": "OIDC is configured and the request has no valid session cookie."+ "description": "Invalid timestamps or a window longer than 30 days."}},- "summary": "Delete an agent",+ "summary": "Get session metrics chart data","tags": [- "Agents"+ "Internal"],"x-fern-sdk-group-name": [- "agents"+ "internal",+ "metrics"],- "x-fern-sdk-method-name": "delete"- },+ "x-fern-sdk-method-name": "get_chart_data"+ }+ },+ "/api/internal/metrics/meters": {"get": {- "description": "Fetch a configured agent by immutable id.",+ "description": "Aggregate the caller's session meters for a named agent over an inclusive creation-time window.","parameters": [{- "description": "Immutable agent identifier.",- "in": "path",+ "description": "Named agent identifier.",+ "in": "query","name": "agent_id","required": true,"schema": {- "description": "Immutable agent identifier.",+ "description": "Named agent identifier.","maxLength": 64,"minLength": 1,"type": "string"}+ },+ {+ "description": "Inclusive lower bound on session `created_at`.",+ "in": "query",+ "name": "start_timestamp",+ "required": true,+ "schema": {+ "description": "Inclusive lower bound on session `created_at`.",+ "format": "date-time",+ "type": "string"+ }+ },+ {+ "description": "Inclusive upper bound on session `created_at`.",+ "in": "query",+ "name": "end_timestamp",+ "required": true,+ "schema": {+ "description": "Inclusive upper bound on session `created_at`.",+ "format": "date-time",+ "type": "string"+ }}],"responses": {@@ -4996,13 +4980,13 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetAgentResponse"+ "$ref": "#/components/schemas/GetSessionMetricsMeterResponse"}}},- "description": "The agent."+ "description": "Session metric meters."},- "404": {+ "400": {"content": {"application/json": {"schema": {@@ -5010,39 +4994,28 @@}}},- "description": "Agent not found."+ "description": "Invalid timestamps or a window longer than 30 days."}},- "summary": "Get an agent",+ "summary": "Get session metrics meters","tags": [- "Agents"+ "Internal"],"x-fern-sdk-group-name": [- "agents"- ],- "x-fern-sdk-method-name": "get"- },- "put": {- "description": "Replaces the manifest for an existing agent keyed by immutable `agent_id`.",- "parameters": [- {- "description": "Immutable agent identifier.",- "in": "path",- "name": "agent_id",- "required": true,- "schema": {- "description": "Immutable agent identifier.",- "maxLength": 64,- "minLength": 1,- "type": "string"- }- }+ "internal",+ "metrics"],+ "x-fern-sdk-method-name": "get_meters"+ }+ },+ "/api/internal/sessions/get-or-create-by-external-id": {+ "post": {+ "description": "Idempotent get-or-create: returns the existing session for this `external_id`, or creates one","requestBody": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UpdateAgentRequest"+ "$ref": "#/components/schemas/GetOrCreateSessionByExternalIdRequest"}}},@@ -5053,11 +5026,21 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetAgentResponse"+ "$ref": "#/components/schemas/GetSessionResponse"}}},- "description": "The saved agent."+ "description": "Session already existed for this external id."+ },+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GetSessionResponse"+ }+ }+ },+ "description": "Session created."},"400": {"content": {@@ -5067,7 +5050,17 @@}}},- "description": "Invalid request body or unknown model/MCP/skill refs."+ "description": "Invalid request body."+ },+ "403": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Caller is not the session creator."},"404": {"content": {@@ -5077,7 +5070,7 @@}}},- "description": "Agent not found."+ "description": "Named agent not found."},"422": {"content": {@@ -5087,15 +5080,287 @@}}},- "description": "The agent spec is valid but requires a capability this server does not provide (e.g. sandbox or skills)."+ "description": "The agent spec is valid but references a resource this server does not provide (e.g. model, MCP server, skill, or sandbox)."}},- "summary": "Update an agent",+ "summary": "Get or create a session by external id","tags": [- "Agents"+ "Internal"],"x-fern-sdk-group-name": [- "agents"+ "internal",+ "sessions"+ ],+ "x-fern-sdk-method-name": "get_or_create_by_external_id"+ }+ },+ "/api/v1/agents": {+ "get": {+ "description": "All configured agents for the tenant.",+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ListAgentsResponse"+ }+ }+ },+ "description": "All configured agents."+ },+ "401": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "OIDC is configured and the request has no valid session cookie."+ }+ },+ "summary": "List agents",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"+ ],+ "x-fern-sdk-method-name": "list"+ },+ "post": {+ "description": "Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.",+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateAgentRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GetAgentResponse"+ }+ }+ },+ "description": "The created agent."+ },+ "400": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Invalid request body or unknown model/MCP/skill refs."+ },+ "409": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "An agent with this name already exists."+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "The agent spec is valid but requires a capability this server does not provide (e.g. sandbox or skills)."+ }+ },+ "summary": "Create an agent",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"+ ],+ "x-fern-sdk-method-name": "create"+ }+ },+ "/api/v1/agents/{agent_id}": {+ "delete": {+ "description": "Delete a configured agent by immutable id. Idempotent if already gone.",+ "parameters": [+ {+ "description": "Immutable agent identifier.",+ "in": "path",+ "name": "agent_id",+ "required": true,+ "schema": {+ "description": "Immutable agent identifier.",+ "maxLength": 64,+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/DeleteAgentResponse"+ }+ }+ },+ "description": "Agent deleted."+ },+ "401": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "OIDC is configured and the request has no valid session cookie."+ }+ },+ "summary": "Delete an agent",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"+ ],+ "x-fern-sdk-method-name": "delete"+ },+ "get": {+ "description": "Fetch a configured agent by immutable id.",+ "parameters": [+ {+ "description": "Immutable agent identifier.",+ "in": "path",+ "name": "agent_id",+ "required": true,+ "schema": {+ "description": "Immutable agent identifier.",+ "maxLength": 64,+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GetAgentResponse"+ }+ }+ },+ "description": "The agent."+ },+ "404": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Agent not found."+ }+ },+ "summary": "Get an agent",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"+ ],+ "x-fern-sdk-method-name": "get"+ },+ "put": {+ "description": "Replaces the manifest for an existing agent keyed by immutable `agent_id`.",+ "parameters": [+ {+ "description": "Immutable agent identifier.",+ "in": "path",+ "name": "agent_id",+ "required": true,+ "schema": {+ "description": "Immutable agent identifier.",+ "maxLength": 64,+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdateAgentRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GetAgentResponse"+ }+ }+ },+ "description": "The saved agent."+ },+ "400": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Invalid request body or unknown model/MCP/skill refs."+ },+ "404": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Agent not found."+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "The agent spec is valid but requires a capability this server does not provide (e.g. sandbox or skills)."+ }+ },+ "summary": "Update an agent",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"],"x-fern-sdk-method-name": "update"}@@ -7979,201 +8244,21 @@"schema": {"$ref": "#/components/schemas/GetSandboxProviderResponse"}- }- },- "description": "The saved sandbox provider."- },- "400": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Invalid request body, or redacted API key with no stored secret to keep."- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Daytona rejected the provided API key."- }- },- "summary": "Create or replace the sandbox provider",- "tags": [- "Sandboxes"- ],- "x-fern-sdk-group-name": [- "settings",- "sandboxProviders"- ],- "x-fern-sdk-method-name": "create_or_update"- }- },- "/api/v1/settings/skills": {- "get": {- "description": "All configured skills with nested manifests (settings / admin projection).",- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ListSkillsResponse"- }- }- },- "description": "All configured skills."- },- "401": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "OIDC is configured and the request has no valid session cookie."- },- "403": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "OIDC is configured and the caller is authenticated but not an admin."- }- },- "summary": "List configured skills",- "tags": [- "Skills"- ],- "x-fern-sdk-group-name": [- "settings",- "skills"- ],- "x-fern-sdk-method-name": "list"- },- "post": {- "description": "Creates a skill keyed by `name`. Fails if `name` is already taken.",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreateSkillRequest"- }- }- },- "required": true- },- "responses": {- "201": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GetSkillResponse"- }- }- },- "description": "The created skill."- },- "400": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Invalid request body."- },- "409": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "A skill with this name already exists."- }- },- "summary": "Create a skill",- "tags": [- "Skills"- ],- "x-fern-sdk-group-name": [- "settings",- "skills"- ],- "x-fern-sdk-method-name": "create"- },- "put": {- "description": "Full upsert keyed by `name`: creates the skill or replaces its entire manifest.",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/UpdateSkillRequest"- }- }- },- "required": true- },- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GetSkillResponse"- }- }- },- "description": "The saved skill."- },- "400": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Invalid request body."- }- },- "summary": "Create or replace a skill",- "tags": [- "Skills"- ],- "x-fern-sdk-group-name": [- "settings",- "skills"- ],- "x-fern-sdk-method-name": "create_or_update"- }- },- "/api/v1/skills": {- "get": {- "description": "Configured skills as a slim name/description list for the composer.",- "responses": {- "200": {+ }+ },+ "description": "The saved sandbox provider."+ },+ "400": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ListAvailableSkillsResponse"+ "$ref": "#/components/schemas/RequestErrorResponse"}}},- "description": "All configured skills (chat projection)."+ "description": "Invalid request body, or redacted API key with no stored secret to keep."},- "401": {+ "422": {"content": {"application/json": {"schema": {@@ -8181,105 +8266,45 @@}}},- "description": "OIDC is configured and the request has no valid session cookie."+ "description": "Daytona rejected the provided API key."}},- "summary": "List skills for chat",+ "summary": "Create or replace the sandbox provider","tags": [- "Skills"+ "Sandboxes"],"x-fern-sdk-group-name": [- "skills"+ "settings",+ "sandboxProviders"],- "x-fern-sdk-method-name": "list"+ "x-fern-sdk-method-name": "create_or_update"}},- "/internal/metrics/charts": {+ "/api/v1/settings/skills": {"get": {- "description": "List available session metric charts.",+ "description": "All configured skills with nested manifests (settings / admin projection).","responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetSessionMetricsChartResponse"+ "$ref": "#/components/schemas/ListSkillsResponse"}}},- "description": "Available session metric charts."- }- },- "summary": "Get session metrics charts",- "tags": [- "Internal"- ],- "x-fern-sdk-group-name": [- "internal",- "metrics"- ],- "x-fern-sdk-method-name": "list_charts"- }- },- "/internal/metrics/charts-data": {- "get": {- "description": "Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.",- "parameters": [- {- "description": "Named agent identifier.",- "in": "query",- "name": "agent_id",- "required": true,- "schema": {- "description": "Named agent identifier.",- "maxLength": 64,- "minLength": 1,- "type": "string"- }- },- {- "description": "Inclusive lower bound on session `created_at`.",- "in": "query",- "name": "start_timestamp",- "required": true,- "schema": {- "description": "Inclusive lower bound on session `created_at`.",- "format": "date-time",- "type": "string"- }- },- {- "description": "Inclusive upper bound on session `created_at`.",- "in": "query",- "name": "end_timestamp",- "required": true,- "schema": {- "description": "Inclusive upper bound on session `created_at`.",- "format": "date-time",- "type": "string"- }+ "description": "All configured skills."},- {- "description": "Session metrics chart to return.",- "in": "query",- "name": "chart_name",- "required": true,- "schema": {- "$ref": "#/components/schemas/SessionMetricsChartName"- }- }- ],- "responses": {- "200": {+ "401": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetSessionMetricsChartDataResponse"+ "$ref": "#/components/schemas/RequestErrorResponse"}}},- "description": "Zero-filled time series for one chart."+ "description": "OIDC is configured and the request has no valid session cookie."},- "400": {+ "403": {"content": {"application/json": {"schema": {@@ -8287,69 +8312,41 @@}}},- "description": "Invalid timestamps or a window longer than 30 days."+ "description": "OIDC is configured and the caller is authenticated but not an admin."}},- "summary": "Get session metrics chart data",+ "summary": "List configured skills","tags": [- "Internal"+ "Skills"],"x-fern-sdk-group-name": [- "internal",- "metrics"+ "settings",+ "skills"],- "x-fern-sdk-method-name": "get_chart_data"- }- },- "/internal/metrics/meters": {- "get": {- "description": "Aggregate the caller's session meters for a named agent over an inclusive creation-time window.",- "parameters": [- {- "description": "Named agent identifier.",- "in": "query",- "name": "agent_id",- "required": true,- "schema": {- "description": "Named agent identifier.",- "maxLength": 64,- "minLength": 1,- "type": "string"- }- },- {- "description": "Inclusive lower bound on session `created_at`.",- "in": "query",- "name": "start_timestamp",- "required": true,- "schema": {- "description": "Inclusive lower bound on session `created_at`.",- "format": "date-time",- "type": "string"+ "x-fern-sdk-method-name": "list"+ },+ "post": {+ "description": "Creates a skill keyed by `name`. Fails if `name` is already taken.",+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateSkillRequest"+ }}},- {- "description": "Inclusive upper bound on session `created_at`.",- "in": "query",- "name": "end_timestamp",- "required": true,- "schema": {- "description": "Inclusive upper bound on session `created_at`.",- "format": "date-time",- "type": "string"- }- }- ],+ "required": true+ },"responses": {- "200": {+ "201": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetSessionMetricsMeterResponse"+ "$ref": "#/components/schemas/GetSkillResponse"}}},- "description": "Session metric meters."+ "description": "The created skill."},"400": {"content": {@@ -8359,28 +8356,36 @@}}},- "description": "Invalid timestamps or a window longer than 30 days."+ "description": "Invalid request body."+ },+ "409": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "A skill with this name already exists."}},- "summary": "Get session metrics meters",+ "summary": "Create a skill","tags": [- "Internal"+ "Skills"],"x-fern-sdk-group-name": [- "internal",- "metrics"+ "settings",+ "skills"],- "x-fern-sdk-method-name": "get_meters"- }- },- "/internal/sessions/get-or-create-by-external-id": {- "post": {- "description": "Idempotent get-or-create: returns the existing session for this `external_id`, or creates one",+ "x-fern-sdk-method-name": "create"+ },+ "put": {+ "description": "Full upsert keyed by `name`: creates the skill or replaces its entire manifest.","requestBody": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetOrCreateSessionByExternalIdRequest"+ "$ref": "#/components/schemas/UpdateSkillRequest"}}},@@ -8391,21 +8396,11 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetSessionResponse"- }- }- },- "description": "Session already existed for this external id."- },- "201": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GetSessionResponse"+ "$ref": "#/components/schemas/GetSkillResponse"}}},- "description": "Session created."+ "description": "The saved skill."},"400": {"content": {@@ -8416,28 +8411,34 @@}},"description": "Invalid request body."- },- "403": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Caller is not the session creator."- },- "404": {+ }+ },+ "summary": "Create or replace a skill",+ "tags": [+ "Skills"+ ],+ "x-fern-sdk-group-name": [+ "settings",+ "skills"+ ],+ "x-fern-sdk-method-name": "create_or_update"+ }+ },+ "/api/v1/skills": {+ "get": {+ "description": "Configured skills as a slim name/description list for the composer.",+ "responses": {+ "200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/RequestErrorResponse"+ "$ref": "#/components/schemas/ListAvailableSkillsResponse"}}},- "description": "Named agent not found."+ "description": "All configured skills (chat projection)."},- "422": {+ "401": {"content": {"application/json": {"schema": {@@ -8445,18 +8446,17 @@}}},- "description": "The agent spec is valid but references a resource this server does not provide (e.g. model, MCP server, skill, or sandbox)."+ "description": "OIDC is configured and the request has no valid session cookie."}},- "summary": "Get or create a session by external id",+ "summary": "List skills for chat","tags": [- "Internal"+ "Skills"],"x-fern-sdk-group-name": [- "internal",- "sessions"+ "skills"],- "x-fern-sdk-method-name": "get_or_create_by_external_id"+ "x-fern-sdk-method-name": "list"}}},diff --git a/docs/openapi.json b/docs/openapi.jsonindex bca5ab445..aa5809d9b 100644--- a/docs/openapi.json+++ b/docs/openapi.json@@ -4829,119 +4829,78 @@},"openapi": "3.1.0","paths": {- "/api/v1/agents": {+ "/api/internal/metrics/charts": {"get": {- "description": "All configured agents for the tenant.",+ "description": "List available session metric charts.","responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ListAgentsResponse"- }- }- },- "description": "All configured agents."- },- "401": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "OIDC is configured and the request has no valid session cookie."- }- },- "summary": "List agents",- "tags": [- "Agents"- ],- "x-fern-sdk-group-name": [- "agents"- ],- "x-fern-sdk-method-name": "list"- },- "post": {- "description": "Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreateAgentRequest"- }- }- },- "required": true- },- "responses": {- "201": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GetAgentResponse"- }- }- },- "description": "The created agent."- },- "400": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Invalid request body or unknown model/MCP/skill refs."- },- "409": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "An agent with this name already exists."- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"+ "$ref": "#/components/schemas/GetSessionMetricsChartResponse"}}},- "description": "The agent spec is valid but requires a capability this server does not provide (e.g. sandbox or skills)."+ "description": "Available session metric charts."}},- "summary": "Create an agent",+ "summary": "Get session metrics charts","tags": [- "Agents"+ "Internal"],"x-fern-sdk-group-name": [- "agents"+ "internal",+ "metrics"],- "x-fern-sdk-method-name": "create"+ "x-fern-sdk-method-name": "list_charts"}},- "/api/v1/agents/{agent_id}": {- "delete": {- "description": "Delete a configured agent by immutable id. Idempotent if already gone.",+ "/api/internal/metrics/charts-data": {+ "get": {+ "description": "Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.","parameters": [{- "description": "Immutable agent identifier.",- "in": "path",+ "description": "Named agent identifier.",+ "in": "query","name": "agent_id","required": true,"schema": {- "description": "Immutable agent identifier.",+ "description": "Named agent identifier.","maxLength": 64,"minLength": 1,"type": "string"}+ },+ {+ "description": "Inclusive lower bound on session `created_at`.",+ "in": "query",+ "name": "start_timestamp",+ "required": true,+ "schema": {+ "description": "Inclusive lower bound on session `created_at`.",+ "format": "date-time",+ "type": "string"+ }+ },+ {+ "description": "Inclusive upper bound on session `created_at`.",+ "in": "query",+ "name": "end_timestamp",+ "required": true,+ "schema": {+ "description": "Inclusive upper bound on session `created_at`.",+ "format": "date-time",+ "type": "string"+ }+ },+ {+ "description": "Session metrics chart to return.",+ "in": "query",+ "name": "chart_name",+ "required": true,+ "schema": {+ "$ref": "#/components/schemas/SessionMetricsChartName"+ }}],"responses": {@@ -4949,13 +4908,13 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/DeleteAgentResponse"+ "$ref": "#/components/schemas/GetSessionMetricsChartDataResponse"}}},- "description": "Agent deleted."+ "description": "Zero-filled time series for one chart."},- "401": {+ "400": {"content": {"application/json": {"schema": {@@ -4963,32 +4922,57 @@}}},- "description": "OIDC is configured and the request has no valid session cookie."+ "description": "Invalid timestamps or a window longer than 30 days."}},- "summary": "Delete an agent",+ "summary": "Get session metrics chart data","tags": [- "Agents"+ "Internal"],"x-fern-sdk-group-name": [- "agents"+ "internal",+ "metrics"],- "x-fern-sdk-method-name": "delete"- },+ "x-fern-sdk-method-name": "get_chart_data"+ }+ },+ "/api/internal/metrics/meters": {"get": {- "description": "Fetch a configured agent by immutable id.",+ "description": "Aggregate the caller's session meters for a named agent over an inclusive creation-time window.","parameters": [{- "description": "Immutable agent identifier.",- "in": "path",+ "description": "Named agent identifier.",+ "in": "query","name": "agent_id","required": true,"schema": {- "description": "Immutable agent identifier.",+ "description": "Named agent identifier.","maxLength": 64,"minLength": 1,"type": "string"}+ },+ {+ "description": "Inclusive lower bound on session `created_at`.",+ "in": "query",+ "name": "start_timestamp",+ "required": true,+ "schema": {+ "description": "Inclusive lower bound on session `created_at`.",+ "format": "date-time",+ "type": "string"+ }+ },+ {+ "description": "Inclusive upper bound on session `created_at`.",+ "in": "query",+ "name": "end_timestamp",+ "required": true,+ "schema": {+ "description": "Inclusive upper bound on session `created_at`.",+ "format": "date-time",+ "type": "string"+ }}],"responses": {@@ -4996,13 +4980,13 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetAgentResponse"+ "$ref": "#/components/schemas/GetSessionMetricsMeterResponse"}}},- "description": "The agent."+ "description": "Session metric meters."},- "404": {+ "400": {"content": {"application/json": {"schema": {@@ -5010,39 +4994,28 @@}}},- "description": "Agent not found."+ "description": "Invalid timestamps or a window longer than 30 days."}},- "summary": "Get an agent",+ "summary": "Get session metrics meters","tags": [- "Agents"+ "Internal"],"x-fern-sdk-group-name": [- "agents"- ],- "x-fern-sdk-method-name": "get"- },- "put": {- "description": "Replaces the manifest for an existing agent keyed by immutable `agent_id`.",- "parameters": [- {- "description": "Immutable agent identifier.",- "in": "path",- "name": "agent_id",- "required": true,- "schema": {- "description": "Immutable agent identifier.",- "maxLength": 64,- "minLength": 1,- "type": "string"- }- }+ "internal",+ "metrics"],+ "x-fern-sdk-method-name": "get_meters"+ }+ },+ "/api/internal/sessions/get-or-create-by-external-id": {+ "post": {+ "description": "Idempotent get-or-create: returns the existing session for this `external_id`, or creates one","requestBody": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/UpdateAgentRequest"+ "$ref": "#/components/schemas/GetOrCreateSessionByExternalIdRequest"}}},@@ -5053,11 +5026,21 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetAgentResponse"+ "$ref": "#/components/schemas/GetSessionResponse"}}},- "description": "The saved agent."+ "description": "Session already existed for this external id."+ },+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GetSessionResponse"+ }+ }+ },+ "description": "Session created."},"400": {"content": {@@ -5067,7 +5050,17 @@}}},- "description": "Invalid request body or unknown model/MCP/skill refs."+ "description": "Invalid request body."+ },+ "403": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Caller is not the session creator."},"404": {"content": {@@ -5077,7 +5070,7 @@}}},- "description": "Agent not found."+ "description": "Named agent not found."},"422": {"content": {@@ -5087,15 +5080,287 @@}}},- "description": "The agent spec is valid but requires a capability this server does not provide (e.g. sandbox or skills)."+ "description": "The agent spec is valid but references a resource this server does not provide (e.g. model, MCP server, skill, or sandbox)."}},- "summary": "Update an agent",+ "summary": "Get or create a session by external id","tags": [- "Agents"+ "Internal"],"x-fern-sdk-group-name": [- "agents"+ "internal",+ "sessions"+ ],+ "x-fern-sdk-method-name": "get_or_create_by_external_id"+ }+ },+ "/api/v1/agents": {+ "get": {+ "description": "All configured agents for the tenant.",+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/ListAgentsResponse"+ }+ }+ },+ "description": "All configured agents."+ },+ "401": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "OIDC is configured and the request has no valid session cookie."+ }+ },+ "summary": "List agents",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"+ ],+ "x-fern-sdk-method-name": "list"+ },+ "post": {+ "description": "Creates an agent and allocates an immutable id. Fails if `name` is already taken. Name cannot be changed later.",+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateAgentRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "201": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GetAgentResponse"+ }+ }+ },+ "description": "The created agent."+ },+ "400": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Invalid request body or unknown model/MCP/skill refs."+ },+ "409": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "An agent with this name already exists."+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "The agent spec is valid but requires a capability this server does not provide (e.g. sandbox or skills)."+ }+ },+ "summary": "Create an agent",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"+ ],+ "x-fern-sdk-method-name": "create"+ }+ },+ "/api/v1/agents/{agent_id}": {+ "delete": {+ "description": "Delete a configured agent by immutable id. Idempotent if already gone.",+ "parameters": [+ {+ "description": "Immutable agent identifier.",+ "in": "path",+ "name": "agent_id",+ "required": true,+ "schema": {+ "description": "Immutable agent identifier.",+ "maxLength": 64,+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/DeleteAgentResponse"+ }+ }+ },+ "description": "Agent deleted."+ },+ "401": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "OIDC is configured and the request has no valid session cookie."+ }+ },+ "summary": "Delete an agent",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"+ ],+ "x-fern-sdk-method-name": "delete"+ },+ "get": {+ "description": "Fetch a configured agent by immutable id.",+ "parameters": [+ {+ "description": "Immutable agent identifier.",+ "in": "path",+ "name": "agent_id",+ "required": true,+ "schema": {+ "description": "Immutable agent identifier.",+ "maxLength": 64,+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GetAgentResponse"+ }+ }+ },+ "description": "The agent."+ },+ "404": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Agent not found."+ }+ },+ "summary": "Get an agent",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"+ ],+ "x-fern-sdk-method-name": "get"+ },+ "put": {+ "description": "Replaces the manifest for an existing agent keyed by immutable `agent_id`.",+ "parameters": [+ {+ "description": "Immutable agent identifier.",+ "in": "path",+ "name": "agent_id",+ "required": true,+ "schema": {+ "description": "Immutable agent identifier.",+ "maxLength": 64,+ "minLength": 1,+ "type": "string"+ }+ }+ ],+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/UpdateAgentRequest"+ }+ }+ },+ "required": true+ },+ "responses": {+ "200": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/GetAgentResponse"+ }+ }+ },+ "description": "The saved agent."+ },+ "400": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Invalid request body or unknown model/MCP/skill refs."+ },+ "404": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "Agent not found."+ },+ "422": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "The agent spec is valid but requires a capability this server does not provide (e.g. sandbox or skills)."+ }+ },+ "summary": "Update an agent",+ "tags": [+ "Agents"+ ],+ "x-fern-sdk-group-name": [+ "agents"],"x-fern-sdk-method-name": "update"}@@ -7979,201 +8244,21 @@"schema": {"$ref": "#/components/schemas/GetSandboxProviderResponse"}- }- },- "description": "The saved sandbox provider."- },- "400": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Invalid request body, or redacted API key with no stored secret to keep."- },- "422": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Daytona rejected the provided API key."- }- },- "summary": "Create or replace the sandbox provider",- "tags": [- "Sandboxes"- ],- "x-fern-sdk-group-name": [- "settings",- "sandboxProviders"- ],- "x-fern-sdk-method-name": "create_or_update"- }- },- "/api/v1/settings/skills": {- "get": {- "description": "All configured skills with nested manifests (settings / admin projection).",- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/ListSkillsResponse"- }- }- },- "description": "All configured skills."- },- "401": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "OIDC is configured and the request has no valid session cookie."- },- "403": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "OIDC is configured and the caller is authenticated but not an admin."- }- },- "summary": "List configured skills",- "tags": [- "Skills"- ],- "x-fern-sdk-group-name": [- "settings",- "skills"- ],- "x-fern-sdk-method-name": "list"- },- "post": {- "description": "Creates a skill keyed by `name`. Fails if `name` is already taken.",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/CreateSkillRequest"- }- }- },- "required": true- },- "responses": {- "201": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GetSkillResponse"- }- }- },- "description": "The created skill."- },- "400": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Invalid request body."- },- "409": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "A skill with this name already exists."- }- },- "summary": "Create a skill",- "tags": [- "Skills"- ],- "x-fern-sdk-group-name": [- "settings",- "skills"- ],- "x-fern-sdk-method-name": "create"- },- "put": {- "description": "Full upsert keyed by `name`: creates the skill or replaces its entire manifest.",- "requestBody": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/UpdateSkillRequest"- }- }- },- "required": true- },- "responses": {- "200": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GetSkillResponse"- }- }- },- "description": "The saved skill."- },- "400": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Invalid request body."- }- },- "summary": "Create or replace a skill",- "tags": [- "Skills"- ],- "x-fern-sdk-group-name": [- "settings",- "skills"- ],- "x-fern-sdk-method-name": "create_or_update"- }- },- "/api/v1/skills": {- "get": {- "description": "Configured skills as a slim name/description list for the composer.",- "responses": {- "200": {+ }+ },+ "description": "The saved sandbox provider."+ },+ "400": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/ListAvailableSkillsResponse"+ "$ref": "#/components/schemas/RequestErrorResponse"}}},- "description": "All configured skills (chat projection)."+ "description": "Invalid request body, or redacted API key with no stored secret to keep."},- "401": {+ "422": {"content": {"application/json": {"schema": {@@ -8181,105 +8266,45 @@}}},- "description": "OIDC is configured and the request has no valid session cookie."+ "description": "Daytona rejected the provided API key."}},- "summary": "List skills for chat",+ "summary": "Create or replace the sandbox provider","tags": [- "Skills"+ "Sandboxes"],"x-fern-sdk-group-name": [- "skills"+ "settings",+ "sandboxProviders"],- "x-fern-sdk-method-name": "list"+ "x-fern-sdk-method-name": "create_or_update"}},- "/internal/metrics/charts": {+ "/api/v1/settings/skills": {"get": {- "description": "List available session metric charts.",+ "description": "All configured skills with nested manifests (settings / admin projection).","responses": {"200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetSessionMetricsChartResponse"+ "$ref": "#/components/schemas/ListSkillsResponse"}}},- "description": "Available session metric charts."- }- },- "summary": "Get session metrics charts",- "tags": [- "Internal"- ],- "x-fern-sdk-group-name": [- "internal",- "metrics"- ],- "x-fern-sdk-method-name": "list_charts"- }- },- "/internal/metrics/charts-data": {- "get": {- "description": "Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.",- "parameters": [- {- "description": "Named agent identifier.",- "in": "query",- "name": "agent_id",- "required": true,- "schema": {- "description": "Named agent identifier.",- "maxLength": 64,- "minLength": 1,- "type": "string"- }- },- {- "description": "Inclusive lower bound on session `created_at`.",- "in": "query",- "name": "start_timestamp",- "required": true,- "schema": {- "description": "Inclusive lower bound on session `created_at`.",- "format": "date-time",- "type": "string"- }- },- {- "description": "Inclusive upper bound on session `created_at`.",- "in": "query",- "name": "end_timestamp",- "required": true,- "schema": {- "description": "Inclusive upper bound on session `created_at`.",- "format": "date-time",- "type": "string"- }+ "description": "All configured skills."},- {- "description": "Session metrics chart to return.",- "in": "query",- "name": "chart_name",- "required": true,- "schema": {- "$ref": "#/components/schemas/SessionMetricsChartName"- }- }- ],- "responses": {- "200": {+ "401": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetSessionMetricsChartDataResponse"+ "$ref": "#/components/schemas/RequestErrorResponse"}}},- "description": "Zero-filled time series for one chart."+ "description": "OIDC is configured and the request has no valid session cookie."},- "400": {+ "403": {"content": {"application/json": {"schema": {@@ -8287,69 +8312,41 @@}}},- "description": "Invalid timestamps or a window longer than 30 days."+ "description": "OIDC is configured and the caller is authenticated but not an admin."}},- "summary": "Get session metrics chart data",+ "summary": "List configured skills","tags": [- "Internal"+ "Skills"],"x-fern-sdk-group-name": [- "internal",- "metrics"+ "settings",+ "skills"],- "x-fern-sdk-method-name": "get_chart_data"- }- },- "/internal/metrics/meters": {- "get": {- "description": "Aggregate the caller's session meters for a named agent over an inclusive creation-time window.",- "parameters": [- {- "description": "Named agent identifier.",- "in": "query",- "name": "agent_id",- "required": true,- "schema": {- "description": "Named agent identifier.",- "maxLength": 64,- "minLength": 1,- "type": "string"- }- },- {- "description": "Inclusive lower bound on session `created_at`.",- "in": "query",- "name": "start_timestamp",- "required": true,- "schema": {- "description": "Inclusive lower bound on session `created_at`.",- "format": "date-time",- "type": "string"+ "x-fern-sdk-method-name": "list"+ },+ "post": {+ "description": "Creates a skill keyed by `name`. Fails if `name` is already taken.",+ "requestBody": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/CreateSkillRequest"+ }}},- {- "description": "Inclusive upper bound on session `created_at`.",- "in": "query",- "name": "end_timestamp",- "required": true,- "schema": {- "description": "Inclusive upper bound on session `created_at`.",- "format": "date-time",- "type": "string"- }- }- ],+ "required": true+ },"responses": {- "200": {+ "201": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetSessionMetricsMeterResponse"+ "$ref": "#/components/schemas/GetSkillResponse"}}},- "description": "Session metric meters."+ "description": "The created skill."},"400": {"content": {@@ -8359,28 +8356,36 @@}}},- "description": "Invalid timestamps or a window longer than 30 days."+ "description": "Invalid request body."+ },+ "409": {+ "content": {+ "application/json": {+ "schema": {+ "$ref": "#/components/schemas/RequestErrorResponse"+ }+ }+ },+ "description": "A skill with this name already exists."}},- "summary": "Get session metrics meters",+ "summary": "Create a skill","tags": [- "Internal"+ "Skills"],"x-fern-sdk-group-name": [- "internal",- "metrics"+ "settings",+ "skills"],- "x-fern-sdk-method-name": "get_meters"- }- },- "/internal/sessions/get-or-create-by-external-id": {- "post": {- "description": "Idempotent get-or-create: returns the existing session for this `external_id`, or creates one",+ "x-fern-sdk-method-name": "create"+ },+ "put": {+ "description": "Full upsert keyed by `name`: creates the skill or replaces its entire manifest.","requestBody": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetOrCreateSessionByExternalIdRequest"+ "$ref": "#/components/schemas/UpdateSkillRequest"}}},@@ -8391,21 +8396,11 @@"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/GetSessionResponse"- }- }- },- "description": "Session already existed for this external id."- },- "201": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/GetSessionResponse"+ "$ref": "#/components/schemas/GetSkillResponse"}}},- "description": "Session created."+ "description": "The saved skill."},"400": {"content": {@@ -8416,28 +8411,34 @@}},"description": "Invalid request body."- },- "403": {- "content": {- "application/json": {- "schema": {- "$ref": "#/components/schemas/RequestErrorResponse"- }- }- },- "description": "Caller is not the session creator."- },- "404": {+ }+ },+ "summary": "Create or replace a skill",+ "tags": [+ "Skills"+ ],+ "x-fern-sdk-group-name": [+ "settings",+ "skills"+ ],+ "x-fern-sdk-method-name": "create_or_update"+ }+ },+ "/api/v1/skills": {+ "get": {+ "description": "Configured skills as a slim name/description list for the composer.",+ "responses": {+ "200": {"content": {"application/json": {"schema": {- "$ref": "#/components/schemas/RequestErrorResponse"+ "$ref": "#/components/schemas/ListAvailableSkillsResponse"}}},- "description": "Named agent not found."+ "description": "All configured skills (chat projection)."},- "422": {+ "401": {"content": {"application/json": {"schema": {@@ -8445,18 +8446,17 @@}}},- "description": "The agent spec is valid but references a resource this server does not provide (e.g. model, MCP server, skill, or sandbox)."+ "description": "OIDC is configured and the request has no valid session cookie."}},- "summary": "Get or create a session by external id",+ "summary": "List skills for chat","tags": [- "Internal"+ "Skills"],"x-fern-sdk-group-name": [- "internal",- "sessions"+ "skills"],- "x-fern-sdk-method-name": "get_or_create_by_external_id"+ "x-fern-sdk-method-name": "list"}}},diff --git a/packages/trueforge-sdk/package.json b/packages/trueforge-sdk/package.jsonindex 7e8622a50..875151f62 100644--- a/packages/trueforge-sdk/package.json+++ b/packages/trueforge-sdk/package.json@@ -187,17 +187,6 @@},"default": "./dist/cjs/api/resources/internal/exports.js"},- "./internal/agents": {- "import": {- "types": "./dist/esm/api/resources/internal/resources/agents/exports.d.mts",- "default": "./dist/esm/api/resources/internal/resources/agents/exports.mjs"- },- "require": {- "types": "./dist/cjs/api/resources/internal/resources/agents/exports.d.ts",- "default": "./dist/cjs/api/resources/internal/resources/agents/exports.js"- },- "default": "./dist/cjs/api/resources/internal/resources/agents/exports.js"- },"./internal/metrics": {"import": {"types": "./dist/esm/api/resources/internal/resources/metrics/exports.d.mts",@@ -220,6 +209,17 @@},"default": "./dist/cjs/api/resources/internal/resources/sessions/exports.js"},+ "./internal/agents": {+ "import": {+ "types": "./dist/esm/api/resources/internal/resources/agents/exports.d.mts",+ "default": "./dist/esm/api/resources/internal/resources/agents/exports.mjs"+ },+ "require": {+ "types": "./dist/cjs/api/resources/internal/resources/agents/exports.d.ts",+ "default": "./dist/cjs/api/resources/internal/resources/agents/exports.js"+ },+ "default": "./dist/cjs/api/resources/internal/resources/agents/exports.js"+ },"./settings": {"import": {"types": "./dist/esm/api/resources/settings/exports.d.mts",diff --git a/packages/trueforge-sdk/reference.md b/packages/trueforge-sdk/reference.mdindex 0294f494b..01a8e751a 100644--- a/packages/trueforge-sdk/reference.md+++ b/packages/trueforge-sdk/reference.md@@ -2501,8 +2501,8 @@ await client.catalogs.skills.list();</dl></details>-## Internal Agents-<details><summary><code>client.internal.agents.<a href="/src/api/resources/internal/resources/agents/client/Client.ts">getCodeSnippets</a>(agent_id) -> TrueForge.GetAgentCodeSnippetsResponse</code></summary>+## Internal Metrics+<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">listCharts</a>() -> TrueForge.GetSessionMetricsChartResponse</code></summary><dl><dd>@@ -2514,7 +2514,7 @@ await client.catalogs.skills.list();<dl><dd>-TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.+List available session metric charts.</dd></dl></dd>@@ -2529,7 +2529,7 @@ TypeScript TrueForge SDK samples (stream and non-stream) for creating a session<dd>```typescript-await client.internal.agents.getCodeSnippets("agent_id");+await client.internal.metrics.listCharts();```</dd>@@ -2545,15 +2545,7 @@ await client.internal.agents.getCodeSnippets("agent_id");<dl><dd>-**agent_id:** `string` — Immutable agent identifier.--</dd>-</dl>--<dl>-<dd>--**requestOptions:** `AgentsClient.RequestOptions`+**requestOptions:** `MetricsClient.RequestOptions`</dd></dl>@@ -2565,8 +2557,7 @@ await client.internal.agents.getCodeSnippets("agent_id");</dl></details>-## Internal Metrics-<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">listCharts</a>() -> TrueForge.GetSessionMetricsChartResponse</code></summary>+<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">getChartData</a>({ ...params }) -> TrueForge.GetSessionMetricsChartDataResponse</code></summary><dl><dd>@@ -2578,7 +2569,7 @@ await client.internal.agents.getCodeSnippets("agent_id");<dl><dd>-List available session metric charts.+Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.</dd></dl></dd>@@ -2593,7 +2584,12 @@ List available session metric charts.<dd>```typescript-await client.internal.metrics.listCharts();+await client.internal.metrics.getChartData({+ agentId: "agent_id",+ startTimestamp: new Date("2024-01-15T09:30:00.000Z"),+ endTimestamp: new Date("2024-01-15T09:30:00.000Z"),+ chartName: "sessions_over_time"+});```</dd>@@ -2609,6 +2605,14 @@ await client.internal.metrics.listCharts();<dl><dd>+**request:** `TrueForge.internal.GetChartDataMetricsRequest`++</dd>+</dl>++<dl>+<dd>+**requestOptions:** `MetricsClient.RequestOptions`</dd>@@ -2621,7 +2625,7 @@ await client.internal.metrics.listCharts();</dl></details>-<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">getChartData</a>({ ...params }) -> TrueForge.GetSessionMetricsChartDataResponse</code></summary>+<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">getMeters</a>({ ...params }) -> TrueForge.GetSessionMetricsMeterResponse</code></summary><dl><dd>@@ -2633,7 +2637,7 @@ await client.internal.metrics.listCharts();<dl><dd>-Return one chart for the caller's sessions on a named agent over an inclusive creation-time window. Uses hourly buckets for windows up to 24 hours and daily UTC buckets otherwise.+Aggregate the caller's session meters for a named agent over an inclusive creation-time window.</dd></dl></dd>@@ -2648,11 +2652,10 @@ Return one chart for the caller's sessions on a named agent over an inclusive cr<dd>```typescript-await client.internal.metrics.getChartData({+await client.internal.metrics.getMeters({agentId: "agent_id",startTimestamp: new Date("2024-01-15T09:30:00.000Z"),- endTimestamp: new Date("2024-01-15T09:30:00.000Z"),- chartName: "sessions_over_time"+ endTimestamp: new Date("2024-01-15T09:30:00.000Z")});```@@ -2669,7 +2672,7 @@ await client.internal.metrics.getChartData({<dl><dd>-**request:** `TrueForge.internal.GetChartDataMetricsRequest`+**request:** `TrueForge.internal.GetMetersMetricsRequest`</dd></dl>@@ -2689,7 +2692,8 @@ await client.internal.metrics.getChartData({</dl></details>-<details><summary><code>client.internal.metrics.<a href="/src/api/resources/internal/resources/metrics/client/Client.ts">getMeters</a>({ ...params }) -> TrueForge.GetSessionMetricsMeterResponse</code></summary>+## Internal Sessions+<details><summary><code>client.internal.sessions.<a href="/src/api/resources/internal/resources/sessions/client/Client.ts">getOrCreateByExternalId</a>({ ...params }) -> TrueForge.GetSessionResponse</code></summary><dl><dd>@@ -2701,7 +2705,7 @@ await client.internal.metrics.getChartData({<dl><dd>-Aggregate the caller's session meters for a named agent over an inclusive creation-time window.+Idempotent get-or-create: returns the existing session for this `external_id`, or creates one</dd></dl></dd>@@ -2716,10 +2720,11 @@ Aggregate the caller's session meters for a named agent over an inclusive creati<dd>```typescript-await client.internal.metrics.getMeters({- agentId: "agent_id",- startTimestamp: new Date("2024-01-15T09:30:00.000Z"),- endTimestamp: new Date("2024-01-15T09:30:00.000Z")+await client.internal.sessions.getOrCreateByExternalId({+ agent: {+ name: "name"+ },+ externalId: "external_id"});```@@ -2736,7 +2741,7 @@ await client.internal.metrics.getMeters({<dl><dd>-**request:** `TrueForge.internal.GetMetersMetricsRequest`+**request:** `TrueForge.internal.GetOrCreateSessionByExternalIdRequest`</dd></dl>@@ -2744,7 +2749,7 @@ await client.internal.metrics.getMeters({<dl><dd>-**requestOptions:** `MetricsClient.RequestOptions`+**requestOptions:** `SessionsClient.RequestOptions`</dd></dl>@@ -2756,8 +2761,8 @@ await client.internal.metrics.getMeters({</dl></details>-## Internal Sessions-<details><summary><code>client.internal.sessions.<a href="/src/api/resources/internal/resources/sessions/client/Client.ts">getOrCreateByExternalId</a>({ ...params }) -> TrueForge.GetSessionResponse</code></summary>+## Internal Agents+<details><summary><code>client.internal.agents.<a href="/src/api/resources/internal/resources/agents/client/Client.ts">getCodeSnippets</a>(agent_id) -> TrueForge.GetAgentCodeSnippetsResponse</code></summary><dl><dd>@@ -2769,7 +2774,7 @@ await client.internal.metrics.getMeters({<dl><dd>-Idempotent get-or-create: returns the existing session for this `external_id`, or creates one+TypeScript TrueForge SDK samples (stream and non-stream) for creating a session and turn against this agent.</dd></dl></dd>@@ -2784,12 +2789,7 @@ Idempotent get-or-create: returns the existing session for this `external_id`, o<dd>```typescript-await client.internal.sessions.getOrCreateByExternalId({- agent: {- name: "name"- },- externalId: "external_id"-});+await client.internal.agents.getCodeSnippets("agent_id");```</dd>@@ -2805,7 +2805,7 @@ await client.internal.sessions.getOrCreateByExternalId({<dl><dd>-**request:** `TrueForge.internal.GetOrCreateSessionByExternalIdRequest`+**agent_id:** `string` — Immutable agent identifier.</dd></dl>@@ -2813,7 +2813,7 @@ await client.internal.sessions.getOrCreateByExternalId({<dl><dd>-**requestOptions:** `SessionsClient.RequestOptions`+**requestOptions:** `AgentsClient.RequestOptions`</dd></dl>diff --git a/packages/trueforge-sdk/src/api/resources/internal/client/Client.ts b/packages/trueforge-sdk/src/api/resources/internal/client/Client.tsindex 4773e2b34..01a773804 100644--- a/packages/trueforge-sdk/src/api/resources/internal/client/Client.ts+++ b/packages/trueforge-sdk/src/api/resources/internal/client/Client.ts@@ -12,18 +12,14 @@ export declare namespace InternalClient {export class InternalClient {protected readonly _options: NormalizedClientOptionsWithAuth<InternalClient.Options>;- protected _agents: AgentsClient | undefined;protected _metrics: MetricsClient | undefined;protected _sessions: SessionsClient | undefined;+ protected _agents: AgentsClient | undefined;constructor(options: InternalClient.Options) {this._options = normalizeClientOptionsWithAuth(options);}- public get agents(): AgentsClient {- return (this._agents ??= new AgentsClient(this._options));- }-public get metrics(): MetricsClient {return (this._metrics ??= new MetricsClient(this._options));}@@ -31,4 +27,8 @@ export class InternalClient {public get sessions(): SessionsClient {return (this._sessions ??= new SessionsClient(this._options));}++ public get agents(): AgentsClient {+ return (this._agents ??= new AgentsClient(this._options));+ }}diff --git a/packages/trueforge-sdk/src/api/resources/internal/resources/metrics/client/Client.ts b/packages/trueforge-sdk/src/api/resources/internal/resources/metrics/client/Client.tsindex d58a35f90..78b5d45b0 100644--- a/packages/trueforge-sdk/src/api/resources/internal/resources/metrics/client/Client.ts+++ b/packages/trueforge-sdk/src/api/resources/internal/resources/metrics/client/Client.ts@@ -52,7 +52,7 @@ export class MetricsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- "internal/metrics/charts",+ "api/internal/metrics/charts",),method: "GET",headers: _headers,@@ -84,7 +84,7 @@ export class MetricsClient {});}- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/internal/metrics/charts");+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/internal/metrics/charts");}/**@@ -138,7 +138,7 @@ export class MetricsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- "internal/metrics/charts-data",+ "api/internal/metrics/charts-data",),method: "GET",headers: _headers,@@ -188,7 +188,12 @@ export class MetricsClient {}}- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/internal/metrics/charts-data");+ return handleNonStatusCodeError(+ _response.error,+ _response.rawResponse,+ "GET",+ "/api/internal/metrics/charts-data",+ );}/**@@ -235,7 +240,7 @@ export class MetricsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- "internal/metrics/meters",+ "api/internal/metrics/meters",),method: "GET",headers: _headers,@@ -285,6 +290,6 @@ export class MetricsClient {}}- return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/internal/metrics/meters");+ return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/api/internal/metrics/meters");}}diff --git a/packages/trueforge-sdk/src/api/resources/internal/resources/sessions/client/Client.ts b/packages/trueforge-sdk/src/api/resources/internal/resources/sessions/client/Client.tsindex 4e7727113..f69c83483 100644--- a/packages/trueforge-sdk/src/api/resources/internal/resources/sessions/client/Client.ts+++ b/packages/trueforge-sdk/src/api/resources/internal/resources/sessions/client/Client.ts@@ -65,7 +65,7 @@ export class SessionsClient {url: core.url.join((await core.Supplier.get(this._options.baseUrl)) ??(await core.Supplier.get(this._options.environment)),- "internal/sessions/get-or-create-by-external-id",+ "api/internal/sessions/get-or-create-by-external-id",),method: "POST",headers: _headers,@@ -159,7 +159,7 @@ export class SessionsClient {_response.error,_response.rawResponse,"POST",- "/internal/sessions/get-or-create-by-external-id",+ "/api/internal/sessions/get-or-create-by-external-id",);}}diff --git a/packages/trueforge-sdk/tests/wire/internal/metrics.test.ts b/packages/trueforge-sdk/tests/wire/internal/metrics.test.tsindex 4c21eb8b0..472559dd9 100644--- a/packages/trueforge-sdk/tests/wire/internal/metrics.test.ts+++ b/packages/trueforge-sdk/tests/wire/internal/metrics.test.ts@@ -24,7 +24,7 @@ describe("MetricsClient", () => {server.mockEndpoint()- .get("/internal/metrics/charts")+ .get("/api/internal/metrics/charts").respondWith().statusCode(200).jsonBody(rawResponseBody)@@ -67,7 +67,7 @@ describe("MetricsClient", () => {server.mockEndpoint()- .get("/internal/metrics/charts-data")+ .get("/api/internal/metrics/charts-data").respondWith().statusCode(200).jsonBody(rawResponseBody)@@ -114,7 +114,7 @@ describe("MetricsClient", () => {server.mockEndpoint()- .get("/internal/metrics/charts-data")+ .get("/api/internal/metrics/charts-data").respondWith().statusCode(400).jsonBody(rawResponseBody)@@ -142,7 +142,7 @@ describe("MetricsClient", () => {server.mockEndpoint()- .get("/internal/metrics/meters")+ .get("/api/internal/metrics/meters").respondWith().statusCode(200).jsonBody(rawResponseBody)@@ -175,7 +175,7 @@ describe("MetricsClient", () => {server.mockEndpoint()- .get("/internal/metrics/meters")+ .get("/api/internal/metrics/meters").respondWith().statusCode(400).jsonBody(rawResponseBody)diff --git a/packages/trueforge-sdk/tests/wire/internal/sessions.test.ts b/packages/trueforge-sdk/tests/wire/internal/sessions.test.tsindex 1938816ca..f8b74b8b3 100644--- a/packages/trueforge-sdk/tests/wire/internal/sessions.test.ts+++ b/packages/trueforge-sdk/tests/wire/internal/sessions.test.ts@@ -24,7 +24,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/internal/sessions/get-or-create-by-external-id")+ .post("/api/internal/sessions/get-or-create-by-external-id").jsonBody(rawRequestBody).respondWith().statusCode(200)@@ -72,7 +72,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/internal/sessions/get-or-create-by-external-id")+ .post("/api/internal/sessions/get-or-create-by-external-id").jsonBody(rawRequestBody).respondWith().statusCode(400)@@ -97,7 +97,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/internal/sessions/get-or-create-by-external-id")+ .post("/api/internal/sessions/get-or-create-by-external-id").jsonBody(rawRequestBody).respondWith().statusCode(403)@@ -122,7 +122,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/internal/sessions/get-or-create-by-external-id")+ .post("/api/internal/sessions/get-or-create-by-external-id").jsonBody(rawRequestBody).respondWith().statusCode(404)@@ -147,7 +147,7 @@ describe("SessionsClient", () => {server.mockEndpoint()- .post("/internal/sessions/get-or-create-by-external-id")+ .post("/api/internal/sessions/get-or-create-by-external-id").jsonBody(rawRequestBody).respondWith().statusCode(422)