Skip to content

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

add skill disablement reason to capabilities (#92)

Heer Ambavi5e3837f731b2
diff --git a/fern/openapi/openapi.json b/fern/openapi/openapi.json
index d3148ee20..9215742fc 100644
--- a/fern/openapi/openapi.json
+++ b/fern/openapi/openapi.json
@@ -1014,6 +1014,10 @@
"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": [
diff --git a/packages/sdk/.fern/metadata.json b/packages/sdk/.fern/metadata.json
index ca0aa221e..d7d3ce2ae 100644
--- a/packages/sdk/.fern/metadata.json
+++ b/packages/sdk/.fern/metadata.json
@@ -27,7 +27,7 @@
"streamType": "web",
"useDefaultRequestParameterValues": true
},
- "originGitCommit": "bc8937241999f54ac608bc8f77e321eb0180a8fb",
+ "originGitCommit": "38280abf13ab4acc6191e3b327785a0dc319086f",
"originGitCommitIsDirty": true,
"invokedBy": "ci",
"requestedVersion": "0.0.0",
diff --git a/packages/sdk/reference.md b/packages/sdk/reference.md
index 4ea906ac7..d2c782486 100644
--- a/packages/sdk/reference.md
+++ b/packages/sdk/reference.md
@@ -632,7 +632,7 @@ await client.models.list();
<dl>
<dd>
-List sessions (newest first by default), token-paginated. Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.
+List sessions (newest first by default), token-paginated. Optional `agent_id` filters to sessions bound to that named agent; optional `created_by` filters by creator identity. Pass `page_token` to fetch the next page, keeping the other query params constant.
</dd>
</dl>
</dd>
diff --git a/packages/sdk/src/api/resources/sessions/client/Client.ts b/packages/sdk/src/api/resources/sessions/client/Client.ts
index eda85c2ee..bd3ab75da 100644
--- a/packages/sdk/src/api/resources/sessions/client/Client.ts
+++ b/packages/sdk/src/api/resources/sessions/client/Client.ts
@@ -24,7 +24,7 @@ export class SessionsClient {
}
/**
- * List sessions (newest first by default), token-paginated. Optional `agent_id` filters to sessions bound to that named agent. Pass `page_token` to fetch the next page, keeping the other query params constant.
+ * List sessions (newest first by default), token-paginated. Optional `agent_id` filters to sessions bound to that named agent; optional `created_by` filters by creator identity. Pass `page_token` to fetch the next page, keeping the other query params constant.
*
* @param {TrueForge.ListSessionsRequest} request
* @param {SessionsClient.RequestOptions} requestOptions - Request-specific configuration.
@@ -44,7 +44,7 @@ export class SessionsClient {
async (
request: TrueForge.ListSessionsRequest,
): Promise<core.WithRawResponse<TrueForge.ListSessionsResponse>> => {
- const { limit = 10, order, pageToken, startTimestamp, endTimestamp, agentId } = request;
+ const { limit = 10, order, pageToken, startTimestamp, endTimestamp, agentId, createdBy } = request;
const _queryParams: Record<string, unknown> = {
limit,
order:
@@ -60,6 +60,7 @@ export class SessionsClient {
start_timestamp: startTimestamp != null ? startTimestamp?.toISOString() : undefined,
end_timestamp: endTimestamp != null ? endTimestamp?.toISOString() : undefined,
agent_id: agentId,
+ created_by: createdBy,
};
const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
this._options?.headers,
diff --git a/packages/sdk/src/api/resources/sessions/client/requests/ListSessionsRequest.ts b/packages/sdk/src/api/resources/sessions/client/requests/ListSessionsRequest.ts
index c839e37f2..c8bc31dd5 100644
--- a/packages/sdk/src/api/resources/sessions/client/requests/ListSessionsRequest.ts
+++ b/packages/sdk/src/api/resources/sessions/client/requests/ListSessionsRequest.ts
@@ -19,4 +19,6 @@ export interface ListSessionsRequest {
endTimestamp?: Date;
/** When set, only sessions bound to this agent id are returned. */
agentId?: string;
+ /** When set, only sessions created by this identity are returned. */
+ createdBy?: string;
}
diff --git a/packages/sdk/src/api/types/GetCapabilitiesResponseDataSkill.ts b/packages/sdk/src/api/types/GetCapabilitiesResponseDataSkill.ts
index 5681d2dc5..10ddf84af 100644
--- a/packages/sdk/src/api/types/GetCapabilitiesResponseDataSkill.ts
+++ b/packages/sdk/src/api/types/GetCapabilitiesResponseDataSkill.ts
@@ -3,4 +3,6 @@
export interface GetCapabilitiesResponseDataSkill {
/** Whether skills are available. False when sandbox is not enabled (skills require a sandbox). */
enabled: boolean;
+ /** Present when skills are disabled. Explains why. */
+ reason?: string;
}
diff --git a/packages/sdk/src/api/types/Session.ts b/packages/sdk/src/api/types/Session.ts
index 9139df9ab..be14042e4 100644
--- a/packages/sdk/src/api/types/Session.ts
+++ b/packages/sdk/src/api/types/Session.ts
@@ -5,6 +5,7 @@ import type * as TrueForge from "../index.js";
export interface Session {
agent: TrueForge.SessionAgent;
createdAt: string;
+ createdBy: string;
id: string;
title: string | null;
updatedAt: string;
diff --git a/packages/sdk/src/serialization/types/GetCapabilitiesResponseDataSkill.ts b/packages/sdk/src/serialization/types/GetCapabilitiesResponseDataSkill.ts
index 9a7564596..8eedd3830 100644
--- a/packages/sdk/src/serialization/types/GetCapabilitiesResponseDataSkill.ts
+++ b/packages/sdk/src/serialization/types/GetCapabilitiesResponseDataSkill.ts
@@ -9,10 +9,12 @@ export const GetCapabilitiesResponseDataSkill: core.serialization.ObjectSchema<
TrueForge.GetCapabilitiesResponseDataSkill
> = core.serialization.object({
enabled: core.serialization.boolean(),
+ reason: core.serialization.string().optional(),
});
export declare namespace GetCapabilitiesResponseDataSkill {
export interface Raw {
enabled: boolean;
+ reason?: string | null;
}
}
diff --git a/packages/sdk/src/serialization/types/Session.ts b/packages/sdk/src/serialization/types/Session.ts
index 30759710a..df9245838 100644
--- a/packages/sdk/src/serialization/types/Session.ts
+++ b/packages/sdk/src/serialization/types/Session.ts
@@ -9,6 +9,7 @@ export const Session: core.serialization.ObjectSchema<serializers.Session.Raw, T
core.serialization.object({
agent: SessionAgent,
createdAt: core.serialization.property("created_at", core.serialization.string()),
+ createdBy: core.serialization.property("created_by", core.serialization.string()),
id: core.serialization.string(),
title: core.serialization.string().nullable(),
updatedAt: core.serialization.property("updated_at", core.serialization.string()),
@@ -18,6 +19,7 @@ export declare namespace Session {
export interface Raw {
agent: SessionAgent.Raw;
created_at: string;
+ created_by: string;
id: string;
title?: string | null;
updated_at: string;
diff --git a/packages/sdk/tests/wire/server.test.ts b/packages/sdk/tests/wire/server.test.ts
index be9501544..ac33ea6d2 100644
--- a/packages/sdk/tests/wire/server.test.ts
+++ b/packages/sdk/tests/wire/server.test.ts
@@ -9,7 +9,11 @@ describe("ServerClient", () => {
const client = new TrueForge({ maxRetries: 0, baseUrl: server.baseUrl });
const rawResponseBody = {
- data: { sandbox: { enabled: true }, settings: { enabled: true }, skill: { enabled: true } },
+ data: {
+ sandbox: { enabled: true },
+ settings: { enabled: true },
+ skill: { enabled: true, reason: "reason" },
+ },
};
server
@@ -31,6 +35,7 @@ describe("ServerClient", () => {
},
skill: {
enabled: true,
+ reason: "reason",
},
},
});
diff --git a/packages/sdk/tests/wire/sessions.test.ts b/packages/sdk/tests/wire/sessions.test.ts
index c5df6bee5..16f36a87c 100644
--- a/packages/sdk/tests/wire/sessions.test.ts
+++ b/packages/sdk/tests/wire/sessions.test.ts
@@ -14,6 +14,7 @@ describe("SessionsClient", () => {
{
agent: { agent_id: "agent_id", type: "ref" },
created_at: "created_at",
+ created_by: "created_by",
id: "id",
title: "title",
updated_at: "updated_at",
@@ -38,6 +39,7 @@ describe("SessionsClient", () => {
type: "ref",
},
createdAt: "created_at",
+ createdBy: "created_by",
id: "id",
title: "title",
updatedAt: "updated_at",
@@ -78,6 +80,7 @@ describe("SessionsClient", () => {
data: {
agent: { agent_id: "agent_id", type: "ref" },
created_at: "created_at",
+ created_by: "created_by",
id: "id",
title: "title",
updated_at: "updated_at",
@@ -106,6 +109,7 @@ describe("SessionsClient", () => {
type: "ref",
},
createdAt: "created_at",
+ createdBy: "created_by",
id: "id",
title: "title",
updatedAt: "updated_at",
@@ -196,6 +200,7 @@ describe("SessionsClient", () => {
data: {
agent: { agent_id: "agent_id", type: "ref" },
created_at: "created_at",
+ created_by: "created_by",
id: "id",
title: "title",
updated_at: "updated_at",
@@ -218,6 +223,7 @@ describe("SessionsClient", () => {
type: "ref",
},
createdAt: "created_at",
+ createdBy: "created_by",
id: "id",
title: "title",
updatedAt: "updated_at",
@@ -262,6 +268,7 @@ describe("SessionsClient", () => {
data: {
agent: { agent_id: "agent_id", type: "ref" },
created_at: "created_at",
+ created_by: "created_by",
id: "id",
title: "title",
updated_at: "updated_at",
@@ -285,6 +292,7 @@ describe("SessionsClient", () => {
type: "ref",
},
createdAt: "created_at",
+ createdBy: "created_by",
id: "id",
title: "title",
updatedAt: "updated_at",
diff --git a/packages/server/src/apis/capabilities.ts b/packages/server/src/apis/capabilities.ts
index 0925f4329..55d432f19 100644
--- a/packages/server/src/apis/capabilities.ts
+++ b/packages/server/src/apis/capabilities.ts
@@ -12,7 +12,12 @@ export function createCapabilitiesRouter(deps: { sandboxProviderStore: ISandboxP
{
data: {
sandbox: { enabled: sandboxEnabled },
- skill: { enabled: sandboxEnabled },
+ skill: sandboxEnabled
+ ? { enabled: true }
+ : {
+ enabled: false,
+ reason: 'Skills run in a sandbox, which is not configured.',
+ },
settings: { enabled: true },
},
},
diff --git a/packages/server/src/routes/capabilityRoutes.ts b/packages/server/src/routes/capabilityRoutes.ts
index 0660d290e..1bfe38d76 100644
--- a/packages/server/src/routes/capabilityRoutes.ts
+++ b/packages/server/src/routes/capabilityRoutes.ts
@@ -10,6 +10,7 @@ const GetCapabilitiesResponseSchema = z
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.'),
diff --git a/packages/server/tests/unit/apis/capabilities.test.ts b/packages/server/tests/unit/apis/capabilities.test.ts
index 0abe49667..67a018a8b 100644
--- a/packages/server/tests/unit/apis/capabilities.test.ts
+++ b/packages/server/tests/unit/apis/capabilities.test.ts
@@ -15,7 +15,10 @@ describe('capabilities routers', () => {
expect(await empty.json()).toEqual({
data: {
sandbox: { enabled: false },
- skill: { enabled: false },
+ skill: {
+ enabled: false,
+ reason: 'Skills run in a sandbox, which is not configured.',
+ },
settings: { enabled: true },
},
});