Skip to content

Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.

feat(core): add session.update() for partial session config updates

Abir Taheer254fb245df37
diff --git a/ts/packages/core/src/lib/toolRouterParams.ts b/ts/packages/core/src/lib/toolRouterParams.ts
index e82fda173..3b457ba40 100644
--- a/ts/packages/core/src/lib/toolRouterParams.ts
+++ b/ts/packages/core/src/lib/toolRouterParams.ts
@@ -1,4 +1,7 @@
-import { SessionCreateParams } from '@composio/client/resources/tool-router/session/session.mjs';
+import {
+ SessionCreateParams,
+ SessionPatchParams,
+} from '@composio/client/resources/tool-router/session/session.mjs';
import {
ToolRouterConfigTags,
ToolRouterConfigTools,
@@ -9,6 +12,7 @@ import {
ToolRouterToolkitsParamSchema,
ToolRouterToolkitsDisabledConfigSchema,
ToolRouterToolkitsEnabledConfigSchema,
+ ToolRouterUpdateSessionConfig,
} from '../types/toolRouter.types';
import { ValidationError } from '../errors';
import { z } from 'zod';
@@ -165,3 +169,51 @@ export const transformToolRouterToolkitsParams = (
// Otherwise return as-is (already in enable/disable format)
return params as SessionCreateParams.Enable | SessionCreateParams.Disable;
};
+
+export const transformToolRouterUpdateParams = (
+ config: ToolRouterUpdateSessionConfig
+): SessionPatchParams => {
+ const params: SessionPatchParams = {};
+
+ if (config.toolkits !== undefined) {
+ params.toolkits = transformToolRouterToolkitsParams(config.toolkits);
+ }
+ if (config.tools !== undefined) {
+ params.tools = transformToolRouterToolsParams(config.tools);
+ }
+ if (config.tags !== undefined) {
+ params.tags = transformToolRouterTagsParams(config.tags);
+ }
+ if (config.authConfigs !== undefined) {
+ params.auth_configs = config.authConfigs;
+ }
+ if (config.connectedAccounts !== undefined) {
+ params.connected_accounts = config.connectedAccounts;
+ }
+ if (config.manageConnections !== undefined) {
+ if (config.manageConnections === null) {
+ params.manage_connections = null;
+ } else {
+ params.manage_connections = transformToolRouterManageConnectionsParams(config.manageConnections);
+ }
+ }
+ if (config.workbench !== undefined) {
+ if (config.workbench === null) {
+ params.workbench = null;
+ } else {
+ params.workbench = transformToolRouterWorkbenchParams(config.workbench);
+ }
+ }
+ if (config.multiAccount !== undefined) {
+ if (config.multiAccount === null) {
+ params.multi_account = null;
+ } else {
+ params.multi_account = transformToolRouterMultiAccountParams(config.multiAccount);
+ }
+ }
+ if (config.preload !== undefined) {
+ params.preload = config.preload;
+ }
+
+ return params;
+};
diff --git a/ts/packages/core/src/models/ToolRouterSession.ts b/ts/packages/core/src/models/ToolRouterSession.ts
index b0b352110..39b37fcbf 100644
--- a/ts/packages/core/src/models/ToolRouterSession.ts
+++ b/ts/packages/core/src/models/ToolRouterSession.ts
@@ -16,6 +16,7 @@ import {
ToolRouterSessionMetadata,
ToolRouterSessionPreloadConfig,
ToolRouterSessionWarning,
+ ToolRouterUpdateSessionConfig,
} from '../types/toolRouter.types';
import {
transformSearchResponse,
@@ -49,6 +50,7 @@ import { findCustomTool, executeCustomTool } from './customToolExecution';
import { findCustomToolMapEntryByFinalSlug } from './CustomTool';
import { transformProxyParams } from './proxyParamsTransform';
import { inlineCustomToolsExperimental } from './inlineCustomToolsPayload';
+import { transformToolRouterUpdateParams } from '../lib/toolRouterParams';
const COMPOSIO_MULTI_EXECUTE_TOOL = 'COMPOSIO_MULTI_EXECUTE_TOOL';
export const DIRECT_CUSTOM_TOOL_DESCRIPTION_PREFIX =
@@ -62,9 +64,9 @@ export class ToolRouterSession<
public readonly sessionId: string;
public readonly mcp: ToolRouterMCPServerConfig;
public readonly experimental: SessionExperimental;
- public readonly preload: ToolRouterSessionPreloadConfig;
- public readonly configVersion?: number;
- public readonly warnings: ToolRouterSessionWarning[];
+ public preload: ToolRouterSessionPreloadConfig;
+ public configVersion?: number;
+ public warnings: ToolRouterSessionWarning[];
private readonly preloadedCustomToolSlugs: string[];
private readonly inlineCustomToolsPayload: ToolRouterSessionMetadata['inlineCustomToolsPayload'];
@@ -471,6 +473,19 @@ export class ToolRouterSession<
};
}
+ /**
+ * Partially update the session configuration.
+ * Only the fields provided will be changed; omitted fields are preserved.
+ * Mutates this session's `configVersion`, `preload`, and `warnings` in-place.
+ */
+ async update(config: ToolRouterUpdateSessionConfig): Promise<void> {
+ const params = transformToolRouterUpdateParams(config);
+ const response = await this.client.toolRouter.session.patch(this.sessionId, params);
+ this.configVersion = response.config_version;
+ this.preload = response.config.preload;
+ this.warnings = response.warnings ?? [];
+ }
+
// ── Private helpers ──────────────────────────────────────────
/** Check if this session has any custom tools bound. */
diff --git a/ts/packages/core/src/types/toolRouter.types.ts b/ts/packages/core/src/types/toolRouter.types.ts
index 94d8ccf49..bb77c1ae5 100644
--- a/ts/packages/core/src/types/toolRouter.types.ts
+++ b/ts/packages/core/src/types/toolRouter.types.ts
@@ -612,6 +612,27 @@ export type ToolRouterSessionProxyExecuteFn = (
params: SessionProxyExecuteParams
) => Promise<ToolRouterSessionProxyExecuteResponse>;
+/**
+ * Config accepted by `session.update()`. Same camelCase shape as
+ * `ToolRouterCreateSessionConfig` but every field is optional and
+ * `manageConnections`, `workbench`, and `multiAccount` accept `null`
+ * to clear the stored value. `sessionPreset` and custom tools/toolkits
+ * are not supported on update.
+ */
+export interface ToolRouterUpdateSessionConfig {
+ toolkits?: ToolRouterCreateSessionConfig['toolkits'];
+ tools?: ToolRouterCreateSessionConfig['tools'];
+ tags?: ToolRouterCreateSessionConfig['tags'];
+ authConfigs?: ToolRouterCreateSessionConfig['authConfigs'];
+ connectedAccounts?: ToolRouterCreateSessionConfig['connectedAccounts'];
+ manageConnections?: ToolRouterCreateSessionConfig['manageConnections'] | null;
+ workbench?: ToolRouterCreateSessionConfig['workbench'] | null;
+ multiAccount?: ToolRouterCreateSessionConfig['multiAccount'] | null;
+ preload?: ToolRouterCreateSessionConfig['preload'];
+}
+
+export type ToolRouterSessionUpdateFn = (config: ToolRouterUpdateSessionConfig) => Promise<void>;
+
/** Session type returned by ToolRouter.create() and ToolRouter.use() */
export interface Session<
TToolCollection,
@@ -633,6 +654,8 @@ export interface Session<
search: ToolRouterSessionSearchFn;
/** Execute a tool within the session */
execute: ToolRouterSessionExecuteFn;
+ /** Update the session configuration. Mutates this session in-place. */
+ update: ToolRouterSessionUpdateFn;
/** Proxy an API call through Composio's auth layer using the session's connected account */
proxyExecute: ToolRouterSessionProxyExecuteFn;
/** List custom tools registered in this session, with their final slugs and schemas */