Composio powers 1000+ toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.
TypeScript agentic-aiagentsaiai-agentsaiagentsdeveloper-toolsfunction-callinggpt-4javascriptjsllmllmopsmcppythonremote-mcp-serverssetypescript
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.tsindex 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.tsindex 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.tsindex 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 */