12
SessionPreset,
13
type ToolRouterSessionConfig,
14
} from '../../src/types/toolRouter.types';
15
+import type { ConnectionRequest } from '../../src/types/connectionRequest.types';
16
import { createCustomTool } from '../../src/models/CustomTool';
17
import { DIRECT_CUSTOM_TOOL_DESCRIPTION_PREFIX } from '../../src/models/ToolRouterSession';
18
2091
});
2092
});
2093
2094
+ describe('ensureConnected function', () => {
2095
+ const userId = 'user_123';
2096
+ const sessionId = 'session_123';
2097
+
2098
+ beforeEach(async () => {
2099
+ mockClient.toolRouter.session.create.mockResolvedValueOnce(mockSessionCreateResponse);
2100
+ });
2101
+
2102
+ it('returns the active connection without linking when the toolkit is already connected', async () => {
2103
+ mockClient.toolRouter.session.toolkits.mockResolvedValueOnce(mockToolkitsResponse);
2104
+
2105
+ const session = await toolRouter.create(userId);
2106
+ const result = await session.ensureConnected('gmail');
2107
+
2108
+ expect(mockClient.toolRouter.session.toolkits).toHaveBeenCalledWith(
2109
+ sessionId,
2110
+ expect.objectContaining({ toolkits: ['gmail'] }),
2111
+ undefined
2112
+ );
2113
+ expect(mockClient.toolRouter.session.link).not.toHaveBeenCalled();
2114
+ expect(result).toEqual({
2115
+ toolkit: 'gmail',
2116
+ wasConnected: true,
2117
+ connectedAccount: { id: 'conn_123', status: 'ACTIVE' },
2118
+ });
2119
+ });
2120
+
2121
+ it('treats a no-auth toolkit as connected without linking', async () => {
2122
+ mockClient.toolRouter.session.toolkits.mockResolvedValueOnce({
2123
+ items: [{ slug: 'search', name: 'Search', is_no_auth: true, connected_account: null }],
2124
+ next_cursor: null,
2125
+ total_pages: 1,
2126
+ });
2127
+
2128
+ const session = await toolRouter.create(userId);
2129
+ const result = await session.ensureConnected('search');
2130
+
2131
+ expect(mockClient.toolRouter.session.link).not.toHaveBeenCalled();
2132
+ expect(result).toEqual({ toolkit: 'search', wasConnected: true });
2133
+ });
2134
+
2135
+ it('links and waits for a connection when the toolkit has none', async () => {
2136
+ // github has connected_account: null in the shared mock response.
2137
+ mockClient.toolRouter.session.toolkits.mockResolvedValueOnce(mockToolkitsResponse);
2138
+
2139
+ const session = await toolRouter.create(userId);
2140
+ const waitForConnection = vi.fn().mockResolvedValue({ id: 'conn_456', status: 'ACTIVE' });
2141
+ const authorizeSpy = vi.spyOn(session, 'authorize').mockResolvedValue({
2142
+ id: 'conn_456',
2143
+ status: ConnectedAccountStatuses.INITIATED,
2144
+ redirectUrl: 'https://composio.dev/auth/redirect',
2145
+ waitForConnection,
2146
+ } as unknown as ConnectionRequest);
2147
+
2148
+ const result = await session.ensureConnected('github', { timeout: 5000 });
2149
+
2150
+ expect(authorizeSpy).toHaveBeenCalledWith('github', {}, undefined);
2151
+ expect(waitForConnection).toHaveBeenCalledWith(5000);
2152
+ expect(result).toEqual({
2153
+ toolkit: 'github',
2154
+ wasConnected: false,
2155
+ connectedAccount: { id: 'conn_456', status: 'ACTIVE' },
2156
+ });
2157
+ });
2158
+
2159
+ it('links a new connection when the only linked account is still pending', async () => {
2160
+ // slack has an INITIATED (non-active) connected_account in the shared mock.
2161
+ mockClient.toolRouter.session.toolkits.mockResolvedValueOnce(mockToolkitsResponse);
2162
+
2163
+ const session = await toolRouter.create(userId);
2164
+ const waitForConnection = vi.fn().mockResolvedValue({ id: 'conn_789', status: 'ACTIVE' });
2165
+ const authorizeSpy = vi.spyOn(session, 'authorize').mockResolvedValue({
2166
+ id: 'conn_789',
2167
+ status: ConnectedAccountStatuses.INITIATED,
2168
+ redirectUrl: null,
2169
+ waitForConnection,
2170
+ } as unknown as ConnectionRequest);
2171
+
2172
+ const result = await session.ensureConnected('slack');
2173
+
2174
+ expect(authorizeSpy).toHaveBeenCalledWith('slack', {}, undefined);
2175
+ expect(waitForConnection).toHaveBeenCalledWith(undefined);
2176
+ expect(result).toEqual({
2177
+ toolkit: 'slack',
2178
+ wasConnected: false,
2179
+ connectedAccount: { id: 'conn_789', status: 'ACTIVE' },
2180
+ });
2181
+ });
2182
+
2183
+ it('rejects invalid timeout options without calling the API', async () => {
2184
+ mockClient.toolRouter.session.create.mockResolvedValueOnce(mockSessionCreateResponse);
2185
+ const session = await toolRouter.create(userId);
2186
+
2187
+ await expect(session.ensureConnected('github', { timeout: -1 })).rejects.toMatchObject({
2188
+ name: 'ValidationError',
2189
+ });
2190
+ expect(mockClient.toolRouter.session.toolkits).not.toHaveBeenCalled();
2191
+ expect(mockClient.toolRouter.session.link).not.toHaveBeenCalled();
2192
+ });
2193
+ });
2194
+
2195
describe('toolkits function', () => {
2196
const userId = 'user_123';
2197
const sessionId = 'session_123';