Skip to content

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

Remove AgentSpec variables field (#148)

Bhavesh Patelbd17d54fe9fc
diff --git a/.github/fern/openapi/openapi.json b/.github/fern/openapi/openapi.json
index 54327ee9c..7bc1a5f9d 100644
--- a/.github/fern/openapi/openapi.json
+++ b/.github/fern/openapi/openapi.json
@@ -138,13 +138,6 @@
"$ref": "#/components/schemas/SkillNameRef"
},
"type": "array"
- },
- "variables": {
- "additionalProperties": {
- "type": "string"
- },
- "description": "Optional string key–value map reserved for parameterizing agent definitions.",
- "type": "object"
}
},
"required": [
@@ -3887,13 +3880,6 @@
"$ref": "#/components/schemas/SkillNameRef"
},
"type": "array"
- },
- "variables": {
- "additionalProperties": {
- "type": "string"
- },
- "description": "Optional string key–value map reserved for parameterizing agent definitions.",
- "type": "object"
}
},
"required": [
diff --git a/docs/api/agent-spec.mdx b/docs/api/agent-spec.mdx
index 276a16027..a8c4627c8 100644
--- a/docs/api/agent-spec.mdx
+++ b/docs/api/agent-spec.mdx
@@ -116,7 +116,3 @@ Runtime behavior. Every field has a default, so `config` can be omitted entirely
| `compaction.enabled` | `true` | Summarize older history when context grows too large. |
| `compaction.compaction_threshold_tokens` | `50000` | Context size (tokens) that triggers compaction. |
| `large_tool_response.enabled` | `true` | Offload oversized tool responses to a sandbox file. |
-
-## `variables`
-
-Optional map of string key–value pairs stored on the spec, reserved for parameterizing agent definitions.
diff --git a/docs/openapi.json b/docs/openapi.json
index 54327ee9c..7bc1a5f9d 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -138,13 +138,6 @@
"$ref": "#/components/schemas/SkillNameRef"
},
"type": "array"
- },
- "variables": {
- "additionalProperties": {
- "type": "string"
- },
- "description": "Optional string key–value map reserved for parameterizing agent definitions.",
- "type": "object"
}
},
"required": [
@@ -3887,13 +3880,6 @@
"$ref": "#/components/schemas/SkillNameRef"
},
"type": "array"
- },
- "variables": {
- "additionalProperties": {
- "type": "string"
- },
- "description": "Optional string key–value map reserved for parameterizing agent definitions.",
- "type": "object"
}
},
"required": [
diff --git a/packages/frontend/src/harnessServer.ts b/packages/frontend/src/harnessServer.ts
index cd0ec6191..408a06c59 100644
--- a/packages/frontend/src/harnessServer.ts
+++ b/packages/frontend/src/harnessServer.ts
@@ -42,7 +42,6 @@ export interface HarnessAgentSpec extends AgentSpec<
instructions?: string;
messages?: TrueForgeApi.AgentSpecUserMessage[];
responseFormat?: TrueForgeApi.ResponseFormat;
- variables?: Record<string, string>;
}
export type CreateHarnessServerOptions = CreateHarnessClientOptions;
diff --git a/packages/harness/src/agent-session/schemas/agentSpec.ts b/packages/harness/src/agent-session/schemas/agentSpec.ts
index e15ed45f2..8c83fa2b8 100644
--- a/packages/harness/src/agent-session/schemas/agentSpec.ts
+++ b/packages/harness/src/agent-session/schemas/agentSpec.ts
@@ -318,10 +318,6 @@ export const AgentSpecSchema = z
.describe('Optional name-only skill references. Requires `config.sandbox.enabled: true`.'),
// Factory must parse so nested RuntimeConfig field defaults materialize.
config: RuntimeConfigSchema.default(() => RuntimeConfigSchema.parse({})),
- variables: z
- .record(z.string(), z.string())
- .optional()
- .describe('Optional string key–value map reserved for parameterizing agent definitions.'),
})
.describe('Complete agent definition used inline on a session or saved as a named agent.')
.openapi('AgentSpec');
diff --git a/packages/sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts b/packages/sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts
index 68c1dbb37..2e211e85e 100644
--- a/packages/sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts
+++ b/packages/sdk/src/api/resources/agents/client/requests/UpdateAgentRequest.ts
@@ -22,6 +22,4 @@ export interface UpdateAgentRequest {
responseFormat?: TrueForge.ResponseFormat;
/** Optional name-only skill references. Requires `config.sandbox.enabled: true`. */
skills?: TrueForge.SkillNameRef[];
- /** Optional string key–value map reserved for parameterizing agent definitions. */
- variables?: Record<string, string>;
}
diff --git a/packages/sdk/src/api/types/AgentSpec.ts b/packages/sdk/src/api/types/AgentSpec.ts
index 3a5da033e..50d605911 100644
--- a/packages/sdk/src/api/types/AgentSpec.ts
+++ b/packages/sdk/src/api/types/AgentSpec.ts
@@ -17,6 +17,4 @@ export interface AgentSpec {
responseFormat?: TrueForge.ResponseFormat;
/** Optional name-only skill references. Requires `config.sandbox.enabled: true`. */
skills?: TrueForge.SkillNameRef[];
- /** Optional string key–value map reserved for parameterizing agent definitions. */
- variables?: Record<string, string>;
}
diff --git a/packages/sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts b/packages/sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts
index b765c1076..f99132ad1 100644
--- a/packages/sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts
+++ b/packages/sdk/src/serialization/resources/agents/client/requests/UpdateAgentRequest.ts
@@ -21,7 +21,6 @@ export const UpdateAgentRequest: core.serialization.Schema<
model: AgentSpecModel,
responseFormat: core.serialization.property("response_format", ResponseFormat.optional()),
skills: core.serialization.list(SkillNameRef).optional(),
- variables: core.serialization.record(core.serialization.string(), core.serialization.string()).optional(),
});
export declare namespace UpdateAgentRequest {
@@ -33,6 +32,5 @@ export declare namespace UpdateAgentRequest {
model: AgentSpecModel.Raw;
response_format?: ResponseFormat.Raw | null;
skills?: SkillNameRef.Raw[] | null;
- variables?: Record<string, string> | null;
}
}
diff --git a/packages/sdk/src/serialization/types/AgentSpec.ts b/packages/sdk/src/serialization/types/AgentSpec.ts
index 8579d67de..57d0f9781 100644
--- a/packages/sdk/src/serialization/types/AgentSpec.ts
+++ b/packages/sdk/src/serialization/types/AgentSpec.ts
@@ -19,7 +19,6 @@ export const AgentSpec: core.serialization.ObjectSchema<serializers.AgentSpec.Ra
model: AgentSpecModel,
responseFormat: core.serialization.property("response_format", ResponseFormat.optional()),
skills: core.serialization.list(SkillNameRef).optional(),
- variables: core.serialization.record(core.serialization.string(), core.serialization.string()).optional(),
});
export declare namespace AgentSpec {
@@ -31,6 +30,5 @@ export declare namespace AgentSpec {
model: AgentSpecModel.Raw;
response_format?: ResponseFormat.Raw | null;
skills?: SkillNameRef.Raw[] | null;
- variables?: Record<string, string> | null;
}
}
diff --git a/packages/sdk/tests/wire/agents.test.ts b/packages/sdk/tests/wire/agents.test.ts
index 1df0a6308..9c1a1989c 100644
--- a/packages/sdk/tests/wire/agents.test.ts
+++ b/packages/sdk/tests/wire/agents.test.ts
@@ -18,7 +18,6 @@ describe("AgentsClient", () => {
model: { name: "name" },
response_format: { type: "json_object" },
skills: [{ name: "name" }],
- variables: { key: "value" },
id: "id",
name: "name",
},
@@ -54,9 +53,6 @@ describe("AgentsClient", () => {
name: "name",
},
],
- variables: {
- key: "value",
- },
id: "id",
name: "name",
},
@@ -90,7 +86,6 @@ describe("AgentsClient", () => {
model: { name: "name" },
response_format: { type: "json_object" },
skills: [{ name: "name" }],
- variables: { key: "value" },
id: "id",
name: "name",
},
@@ -142,9 +137,6 @@ describe("AgentsClient", () => {
name: "name",
},
],
- variables: {
- key: "value",
- },
id: "id",
name: "name",
},
@@ -239,7 +231,6 @@ describe("AgentsClient", () => {
model: { name: "name" },
response_format: { type: "json_object" },
skills: [{ name: "name" }],
- variables: { key: "value" },
id: "id",
name: "name",
},
@@ -285,9 +276,6 @@ describe("AgentsClient", () => {
name: "name",
},
],
- variables: {
- key: "value",
- },
id: "id",
name: "name",
},
@@ -355,7 +343,6 @@ describe("AgentsClient", () => {
model: { name: "name" },
response_format: { type: "json_object" },
skills: [{ name: "name" }],
- variables: { key: "value" },
id: "id",
name: "name",
},
@@ -406,9 +393,6 @@ describe("AgentsClient", () => {
name: "name",
},
],
- variables: {
- key: "value",
- },
id: "id",
name: "name",
},
diff --git a/packages/trueforge-ui-sdk/docs/server-types.temp.md b/packages/trueforge-ui-sdk/docs/server-types.temp.md
index 1075afa32..af9f0b949 100644
--- a/packages/trueforge-ui-sdk/docs/server-types.temp.md
+++ b/packages/trueforge-ui-sdk/docs/server-types.temp.md
@@ -212,7 +212,6 @@ export interface AgentSpec {
responseFormat?: ResponseFormat;
skills?: SkillMount[];
config?: RuntimeConfig;
- variables?: Record<string, string>;
}
/** Partial patch (from `@truefoundry/assistant-ui-runtime`) */
@@ -224,7 +223,6 @@ export type AgentSpecUpdate = {
mcpServers?: McpServer[];
skills?: SkillMount[];
messages?: AgentSpecUserMessage[];
- variables?: Record<string, string>;
responseFormat?: ResponseFormat;
config?: RuntimeConfig;
};
diff --git a/packages/trueforge-ui-sdk/docs/server-types.temp.ts b/packages/trueforge-ui-sdk/docs/server-types.temp.ts
index 8f9165b5c..0efd44456 100644
--- a/packages/trueforge-ui-sdk/docs/server-types.temp.ts
+++ b/packages/trueforge-ui-sdk/docs/server-types.temp.ts
@@ -222,7 +222,6 @@ export interface AgentSpec {
// responseFormat?: ResponseFormat;
skills?: SkillMount[];
// config?: RuntimeConfig;
- // variables?: Record<string, string>;
}
export type AgentSpecUpdate = {
@@ -233,7 +232,6 @@ export type AgentSpecUpdate = {
mcpServers?: McpServer[];
skills?: SkillMount[];
messages?: AgentSpecUserMessage[];
- variables?: Record<string, string>;
responseFormat?: ResponseFormat;
config?: RuntimeConfig;
};
diff --git a/packages/trueforge-ui-sdk/docs/server.md b/packages/trueforge-ui-sdk/docs/server.md
index 63aa086f9..768cbc9f8 100644
--- a/packages/trueforge-ui-sdk/docs/server.md
+++ b/packages/trueforge-ui-sdk/docs/server.md
@@ -293,7 +293,6 @@ interface AgentSpec {
responseFormat?: ResponseFormat;
skills?: SkillMount[];
config?: RuntimeConfig;
- variables?: Record<string, string>;
}
interface Model {
@@ -399,7 +398,6 @@ type AgentSpecUpdate = {
mcpServers?: McpServer[];
skills?: SkillMount[];
messages?: AgentSpecUserMessage[];
- variables?: Record<string, string>;
responseFormat?: ResponseFormat;
config?: RuntimeConfig;
};