Q101: a connector can hold several labelled company accounts, each granted and used by name

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

src/shared/commands/composio.ts

@@ -6,9 +6,14 @@ export interface ConnectorCatalogEntry {
   logoUrl: string | null;
 }
 
+/** The label of a toolkit's first account, and of every account from before labels existed. */
+export const DEFAULT_CONNECTOR_ACCOUNT_LABEL = "main";
+
 export interface ConnectComposioToolkitInput {
   orgId: string;
   toolkitSlug: string;
+  /** The account to connect or reconnect; a new label adds another account of the toolkit. */
+  label: string;
 }
 
 export interface ConnectComposioToolkitResult {
@@ -19,6 +24,7 @@ export interface ConnectComposioToolkitResult {
 export interface DisconnectComposioToolkitInput {
   orgId: string;
   toolkitSlug: string;
+  label: string;
 }
 
 export interface RefreshComposioAccountsInput {

src/shared/domain.ts

@@ -451,6 +451,8 @@ export interface ConnectorAccountRecord {
   orgId: string;
   toolkitSlug: string;
   toolkitName: string;
+  /** Names the account among the toolkit's company accounts, e.g. "main" or "sales". */
+  label: string;
   authConfigId: string;
   status: string;
   /** A reconnect waiting for authorization; the current account keeps working until it is active. */
@@ -464,6 +466,7 @@ export interface ConnectorGrantRecord {
   orgId: string;
   agentId: string;
   toolkitSlug: string;
+  accountLabel: string;
   grantedByType: string;
   grantedById: string | null;
   createdAt: string;