@evolvingmachines/sdk 0.0.39 → 0.0.41

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -1,6 +1,6 @@
1
+ import { EventEmitter } from 'events';
1
2
  import * as zod from 'zod';
2
3
  import { z } from 'zod';
3
- import { EventEmitter } from 'events';
4
4
  export { E2BConfig, E2BProvider, createE2BProvider } from '@evolvingmachines/e2b';
5
5
  export { DaytonaConfig, DaytonaProvider, createDaytonaProvider } from '@evolvingmachines/daytona';
6
6
  export { ModalConfig, ModalProvider, createModalProvider } from '@evolvingmachines/modal';
@@ -397,6 +397,18 @@ interface AgentBrowserConfig {
397
397
  }
398
398
  /** Browser automation configuration. */
399
399
  type BrowserConfig = BrowserProvider | ActionbookBrowserConfig | AgentBrowserConfig;
400
+ /** Saved browser login selector exposed to a run. Empty/omitted means all enabled browser logins. */
401
+ interface BrowserCredentialScopeEntry {
402
+ website: string;
403
+ /** One-word label for the saved credential, such as "qa-admin" or "work"; not the website username or email. */
404
+ accountLabel?: string;
405
+ /** Python bridge wire shape. Prefer accountLabel in TypeScript. */
406
+ account_label?: string;
407
+ }
408
+ /** Browser login MCP configuration for managed remote agent-browser runs. */
409
+ interface BrowserCredentialsConfig {
410
+ allow?: BrowserCredentialScopeEntry[];
411
+ }
400
412
  /** Marketplace plugin shape for CLIs with explicit plugin install commands. */
401
413
  interface MarketplaceAgentPluginConfig {
402
414
  /** Marketplace URL/source to register in the sandbox user profile */
@@ -553,6 +565,17 @@ interface AgentOptions {
553
565
  apiKey: string;
554
566
  dashboardUrl?: string;
555
567
  };
568
+ /** Run-scoped browser login MCP setup. Requires managed remote agent-browser. */
569
+ browserCredentials?: {
570
+ apiKey: string;
571
+ dashboardUrl?: string;
572
+ config?: BrowserCredentialsConfig;
573
+ };
574
+ /** Evolve-managed app integrations */
575
+ integrations?: IntegrationsSetup & {
576
+ apiKey: string;
577
+ dashboardUrl?: string;
578
+ };
556
579
  /** Plugins/extensions to install in the sandbox user profile before first run */
557
580
  plugins?: AgentPluginConfig[];
558
581
  /** Skills to enable (e.g., ["pdf", "dev-browser"]) */
@@ -584,11 +607,6 @@ interface AgentOptions {
584
607
  sessionTagPrefix?: string;
585
608
  /** Observability metadata for trace grouping (generic key-value, domain-agnostic) */
586
609
  observability?: Record<string, unknown>;
587
- /**
588
- * Composio Tool Router configuration
589
- * Set via withComposio() - provides access to 1000+ tools
590
- */
591
- composio?: ComposioSetup;
592
610
  /** Resolved storage configuration (set via Evolve.withStorage()) */
593
611
  storage?: ResolvedStorageConfig;
594
612
  }
@@ -731,65 +749,58 @@ interface StreamCallbacks {
731
749
  onLifecycle?: (event: LifecycleEvent) => void;
732
750
  }
733
751
  /**
734
- * Configuration for Composio Tool Router integration
735
- *
736
- * Provides access to 1000+ tools (GitHub, Gmail, Slack, etc.) via MCP.
737
- * Evidence: tool-router/quickstart.mdx
752
+ * Configuration for managed integrations.
738
753
  */
739
- /** Tool filter configuration per toolkit */
740
- type ToolsFilter = string[] | {
754
+ /** Tool filter configuration per app */
755
+ type IntegrationToolsFilter = string[] | {
741
756
  enable: string[];
742
757
  } | {
743
758
  disable: string[];
744
759
  } | {
745
760
  tags: string[];
746
761
  };
747
- interface ComposioConfig {
762
+ interface IntegrationsConfig {
748
763
  /**
749
- * Restrict to specific toolkits
764
+ * Apps to expose to the agent.
750
765
  *
751
766
  * @example
752
- * toolkits: ["github", "gmail", "linear"]
767
+ * apps: ["github", "gmail", "linear"]
753
768
  */
754
- toolkits?: string[];
769
+ apps: string[];
755
770
  /**
756
- * Per-toolkit tool filtering
771
+ * Per-app tool filtering.
757
772
  *
758
773
  * @example
759
774
  * tools: {
760
- * github: ["github_create_issue", "github_list_repos"],
775
+ * github: { enable: ["github_create_issue", "github_list_repos"] },
761
776
  * gmail: { disable: ["gmail_delete_email"] },
762
777
  * slack: { tags: ["readOnlyHint"] }
763
778
  * }
764
779
  */
765
- tools?: Record<string, ToolsFilter>;
780
+ tools?: Record<string, IntegrationToolsFilter>;
766
781
  /**
767
- * API keys for direct authentication (bypasses OAuth)
768
- * For tools that support API key auth (e.g., Stripe, OpenAI)
769
- *
770
- * @example
771
- * keys: { stripe: "sk_live_...", openai: "sk-..." }
782
+ * Pin specific connected accounts by account ID or account label.
783
+ */
784
+ accounts?: Record<string, string[]>;
785
+ /**
786
+ * API keys for apps that use API-key auth.
787
+ * Requires a matching authConfigs entry for each app.
772
788
  */
773
789
  keys?: Record<string, string>;
774
790
  /**
775
- * Custom OAuth auth config IDs for white-labeling
776
- * Created in Composio dashboard
777
- *
778
- * @example
779
- * authConfigs: { github: "ac_your_github_config" }
791
+ * Custom auth config IDs per app.
780
792
  */
781
793
  authConfigs?: Record<string, string>;
782
794
  }
783
795
  /**
784
- * Composio setup for Tool Router integration
785
- *
786
- * Combines user identification with optional configuration.
796
+ * Managed integrations setup.
787
797
  */
788
- interface ComposioSetup {
789
- /** User's unique identifier for Composio session */
798
+ interface IntegrationsSetup extends IntegrationsConfig {
799
+ /**
800
+ * Integration user ID. Use "root" for dashboard-owned/private accounts,
801
+ * or your app's stable end-user ID for per-user accounts.
802
+ */
790
803
  userId: string;
791
- /** Optional Composio configuration */
792
- config?: ComposioConfig;
793
804
  }
794
805
  /**
795
806
  * Storage configuration for .withStorage()
@@ -903,79 +914,54 @@ interface StorageClient {
903
914
  downloadFiles(idOrLatest: string, options?: DownloadFilesOptions): Promise<FileMap>;
904
915
  }
905
916
 
906
- /**
907
- * Composio Auth Helpers
908
- *
909
- * Helper functions for managing Composio authentication in your app's UI.
910
- * Evidence: tool-router/manually-authenticating-users.mdx
911
- */
912
- /**
913
- * Result from getAuthUrl()
914
- */
915
- interface ComposioAuthResult {
916
- /** OAuth/Connect Link URL to redirect user to */
917
+ interface IntegrationAuthParams {
918
+ userId: string;
919
+ app: string;
920
+ accountLabel?: string;
921
+ apiKey?: string;
922
+ dashboardUrl?: string;
923
+ }
924
+ interface IntegrationAuthResult {
917
925
  url: string;
918
- /** Connection request ID for tracking */
919
- connectionId: string;
926
+ accountId?: string;
920
927
  }
921
- /**
922
- * Connection status for a toolkit
923
- */
924
- interface ComposioConnectionStatus {
925
- /** Toolkit slug (e.g., "github", "gmail") */
926
- toolkit: string;
927
- /** Whether the user has an active connection */
928
- connected: boolean;
929
- /** Connected account ID if connected */
928
+ interface IntegrationAccount {
929
+ userId: string;
930
+ app: string;
931
+ appName?: string;
932
+ appIcon?: string;
933
+ accountLabel?: string;
934
+ status: string;
930
935
  accountId?: string;
936
+ updatedAt?: string;
937
+ }
938
+ interface IntegrationAccountListParams {
939
+ userIds: string[];
940
+ app?: string;
941
+ statuses?: string[];
942
+ apiKey?: string;
943
+ dashboardUrl?: string;
944
+ }
945
+ interface IntegrationAccountUpdateParams {
946
+ accountId: string;
947
+ accountLabel?: string;
948
+ apiKey?: string;
949
+ dashboardUrl?: string;
950
+ }
951
+ interface IntegrationAccountDeleteParams {
952
+ accountId: string;
953
+ apiKey?: string;
954
+ dashboardUrl?: string;
955
+ }
956
+ interface IntegrationAccountUpdateResult {
957
+ success: boolean;
958
+ accountId: string;
959
+ accountLabel?: string;
960
+ }
961
+ interface IntegrationAccountDeleteResult {
962
+ success: boolean;
963
+ accountId: string;
931
964
  }
932
- /**
933
- * Get OAuth URL for a toolkit
934
- *
935
- * Returns a Connect Link URL that you can show in your app's UI.
936
- * User completes OAuth, then is redirected back to your app.
937
- *
938
- * @param userId - User's unique identifier
939
- * @param toolkit - Toolkit slug (e.g., "github", "gmail")
940
- * @returns Auth URL and connection ID
941
- *
942
- * @example
943
- * const { url } = await getAuthUrl("user_123", "github");
944
- * // Show button: <a href={url}>Connect GitHub</a>
945
- */
946
- declare function getAuthUrl(userId: string, toolkit: string): Promise<ComposioAuthResult>;
947
- /**
948
- * Get connection status for a user
949
- *
950
- * @param userId - User's unique identifier
951
- * @param toolkit - Optional toolkit slug to check specific connection
952
- * @returns Status map for all toolkits, or boolean if toolkit specified
953
- *
954
- * @example
955
- * // Get all connections
956
- * const status = await getStatus("user_123");
957
- * // { github: true, gmail: false, slack: true }
958
- *
959
- * @example
960
- * // Check single toolkit
961
- * const isConnected = await getStatus("user_123", "github");
962
- * // true
963
- */
964
- declare function getStatus(userId: string, toolkit?: string): Promise<Record<string, boolean> | boolean>;
965
- /**
966
- * Get detailed connection info for a user
967
- *
968
- * Returns array of connections with account IDs.
969
- * More detailed than getStatus() - use when you need account IDs.
970
- *
971
- * @param userId - User's unique identifier
972
- * @returns Array of connection statuses
973
- *
974
- * @example
975
- * const connections = await getConnections("user_123");
976
- * // [{ toolkit: "github", connected: true, accountId: "ca_..." }, ...]
977
- */
978
- declare function getConnections(userId: string): Promise<ComposioConnectionStatus[]>;
979
965
 
980
966
  /**
981
967
  * Unified Agent Implementation
@@ -1015,6 +1001,7 @@ declare class Agent {
1015
1001
  private agentState;
1016
1002
  private droidSessionId?;
1017
1003
  private managedBrowserSession?;
1004
+ private sandboxGatewayApiKey?;
1018
1005
  private readonly skills?;
1019
1006
  private readonly storage?;
1020
1007
  private lastCheckpointId?;
@@ -1042,6 +1029,9 @@ declare class Agent {
1042
1029
  * Build environment variables for sandbox
1043
1030
  */
1044
1031
  private buildEnvironmentVariables;
1032
+ private getSandboxGatewayApiKey;
1033
+ private ensureSandboxGatewayApiKey;
1034
+ private resolveSandboxGatewayMcpServers;
1045
1035
  private ensureManagedBrowserSession;
1046
1036
  private setupManagedBrowser;
1047
1037
  private closeManagedBrowserSession;
@@ -1392,6 +1382,60 @@ declare function parseNdjsonLine(agentType: AgentType, line: string): OutputEven
1392
1382
  */
1393
1383
  declare function parseNdjsonOutput(agentType: AgentType, output: string): OutputEvent[];
1394
1384
 
1385
+ declare const BROWSER_LOGIN_MCP_SERVER_NAME = "browser-login";
1386
+ interface BrowserCredentialMetadata {
1387
+ id: string;
1388
+ website: string;
1389
+ accountLabel: string;
1390
+ email: string;
1391
+ enabled: boolean;
1392
+ createdBy: string;
1393
+ createdAt: string;
1394
+ updatedAt: string;
1395
+ lastUsedAt: string | null;
1396
+ }
1397
+ interface BrowserCredentialsClientConfig {
1398
+ apiKey?: string;
1399
+ dashboardUrl?: string;
1400
+ }
1401
+ interface BrowserCredentialCreateInput {
1402
+ website: string;
1403
+ accountLabel: string;
1404
+ email: string;
1405
+ password: string;
1406
+ }
1407
+ type BrowserCredentialDeleteInput = {
1408
+ id: string;
1409
+ } | {
1410
+ website: string;
1411
+ accountLabel: string;
1412
+ };
1413
+ interface BrowserCredentialListOptions {
1414
+ website?: string;
1415
+ limit?: number;
1416
+ offset?: number;
1417
+ }
1418
+ declare class BrowserCredentialsClient {
1419
+ private readonly config;
1420
+ constructor(config?: BrowserCredentialsClientConfig);
1421
+ private toMetadata;
1422
+ list(options?: BrowserCredentialListOptions): Promise<{
1423
+ credentials: BrowserCredentialMetadata[];
1424
+ total: number;
1425
+ count: number;
1426
+ offset: number;
1427
+ hasMore: boolean;
1428
+ }>;
1429
+ create(input: BrowserCredentialCreateInput): Promise<{
1430
+ status: "created" | "already_exists";
1431
+ credential: BrowserCredentialMetadata;
1432
+ }>;
1433
+ delete(input: BrowserCredentialDeleteInput): Promise<{
1434
+ ok: boolean;
1435
+ }>;
1436
+ }
1437
+ declare function browserCredentials(config?: BrowserCredentialsClientConfig): BrowserCredentialsClient;
1438
+
1395
1439
  /**
1396
1440
  * Evolve events
1397
1441
  *
@@ -1420,6 +1464,8 @@ interface EvolveConfig {
1420
1464
  mcpServers?: Record<string, McpServerConfig>;
1421
1465
  /** Browser automation provider to enable explicitly */
1422
1466
  browser?: BrowserConfig;
1467
+ /** Browser login MCP setup for managed remote agent-browser runs */
1468
+ browserCredentials?: BrowserCredentialsConfig;
1423
1469
  /** Agent plugins/extensions to install before first run */
1424
1470
  plugins?: AgentPluginConfig[];
1425
1471
  /** Skills to enable (e.g., ["pdf", "dev-browser"]) */
@@ -1431,8 +1477,8 @@ interface EvolveConfig {
1431
1477
  sessionTagPrefix?: string;
1432
1478
  /** Observability metadata for trace grouping (generic key-value, domain-agnostic) */
1433
1479
  observability?: Record<string, unknown>;
1434
- /** Composio user ID and config */
1435
- composio?: ComposioSetup;
1480
+ /** Managed integrations config */
1481
+ integrations?: IntegrationsSetup;
1436
1482
  /** Storage configuration for checkpointing */
1437
1483
  storage?: StorageConfig;
1438
1484
  }
@@ -1516,6 +1562,13 @@ declare class Evolve extends EventEmitter {
1516
1562
  * kit.withBrowser({ provider: "agent-browser", remote: true }) // managed remote agent-browser
1517
1563
  */
1518
1564
  withBrowser(provider?: BrowserConfig | false): this;
1565
+ /**
1566
+ * Enable saved browser logins for managed remote agent-browser runs.
1567
+ *
1568
+ * Empty config exposes all enabled browser logins for this Evolve account.
1569
+ * Use allow to restrict a run to specific websites and optional account labels.
1570
+ */
1571
+ withBrowserCredentials(config?: BrowserCredentialsConfig): this;
1519
1572
  /**
1520
1573
  * Install agent plugins/extensions in the sandbox user profile.
1521
1574
  *
@@ -1568,38 +1621,12 @@ declare class Evolve extends EventEmitter {
1568
1621
  */
1569
1622
  withObservability(meta: Record<string, unknown>): this;
1570
1623
  /**
1571
- * Enable Composio Tool Router for 1000+ tool integrations
1572
- *
1573
- * Provides access to GitHub, Gmail, Slack, Notion, and 1000+ other
1574
- * tools via a single MCP server. Handles authentication automatically.
1575
- *
1576
- * Evidence: tool-router/quickstart.mdx
1577
- *
1578
- * @param userId - Your user's unique identifier
1579
- * @param config - Optional configuration for toolkits, API keys, and auth
1580
- *
1581
- * @example
1582
- * // Basic - all tools, in-chat auth
1583
- * kit.withComposio("user_123")
1584
- *
1585
- * @example
1586
- * // Restrict to specific toolkits
1587
- * kit.withComposio("user_123", { toolkits: ["github", "gmail"] })
1624
+ * Enable Evolve-managed integrations.
1588
1625
  *
1589
- * @example
1590
- * // With API keys for direct auth
1591
- * kit.withComposio("user_123", {
1592
- * toolkits: ["github", "stripe"],
1593
- * keys: { stripe: "sk_live_..." }
1594
- * })
1595
- *
1596
- * @example
1597
- * // With white-label OAuth
1598
- * kit.withComposio("user_123", {
1599
- * authConfigs: { github: "ac_your_oauth_config" }
1600
- * })
1626
+ * Available only in gateway mode. Integration credentials stay server-side; the
1627
+ * sandbox receives an Evolve-scoped MCP proxy.
1601
1628
  */
1602
- withComposio(userId: string, config?: ComposioConfig): this;
1629
+ withIntegrations(config: IntegrationsSetup): this;
1603
1630
  /**
1604
1631
  * Configure storage for checkpoint persistence
1605
1632
  *
@@ -1617,32 +1644,17 @@ declare class Evolve extends EventEmitter {
1617
1644
  * kit.withStorage()
1618
1645
  */
1619
1646
  withStorage(config?: StorageConfig): this;
1620
- /**
1621
- * Static helpers for Composio auth management
1622
- *
1623
- * Use these in your app's settings UI to manage user connections.
1624
- *
1625
- * Evidence: tool-router/manually-authenticating-users.mdx
1626
- *
1627
- * @example
1628
- * // Get OAuth URL for "Connect GitHub" button
1629
- * const { url } = await Evolve.composio.auth("user_123", "github");
1630
- *
1631
- * @example
1632
- * // Check connection status
1633
- * const status = await Evolve.composio.status("user_123");
1634
- * // { github: true, gmail: false, ... }
1635
- *
1636
- * @example
1637
- * // Check single toolkit
1638
- * const isConnected = await Evolve.composio.status("user_123", "github");
1639
- * // true | false
1640
- */
1641
- static composio: {
1642
- auth: typeof getAuthUrl;
1643
- status: typeof getStatus;
1644
- connections: typeof getConnections;
1647
+ /** Static helpers for managed integration auth and observability. */
1648
+ static integrations: {
1649
+ auth: (params: IntegrationAuthParams) => Promise<IntegrationAuthResult>;
1650
+ accounts: {
1651
+ list: (params: IntegrationAccountListParams) => Promise<IntegrationAccount[]>;
1652
+ update: (params: IntegrationAccountUpdateParams) => Promise<IntegrationAccountUpdateResult>;
1653
+ delete: (params: IntegrationAccountDeleteParams) => Promise<IntegrationAccountDeleteResult>;
1654
+ };
1645
1655
  };
1656
+ /** Static browser credential client for listing, creating, and deleting saved browser logins. */
1657
+ static browserCredentials: typeof browserCredentials;
1646
1658
  /**
1647
1659
  * Initialize agent on first use
1648
1660
  */
@@ -1881,8 +1893,8 @@ interface SwarmConfig {
1881
1893
  mcpServers?: Record<string, McpServerConfig>;
1882
1894
  /** Default skills for all operations (per-operation config takes precedence) */
1883
1895
  skills?: SkillName[];
1884
- /** Default Composio configuration for all operations (per-operation config takes precedence) */
1885
- composio?: ComposioSetup;
1896
+ /** Default Integrations configuration for all operations (per-operation config takes precedence) */
1897
+ integrations?: IntegrationsSetup;
1886
1898
  }
1887
1899
  /** Callback for bestOf candidate completion */
1888
1900
  type OnCandidateCompleteCallback = (itemIndex: number, candidateIndex: number, status: "success" | "error") => void;
@@ -1905,10 +1917,10 @@ interface BestOfConfig {
1905
1917
  skills?: SkillName[];
1906
1918
  /** Skills for judge (defaults to skills) */
1907
1919
  judgeSkills?: SkillName[];
1908
- /** Composio config for candidates (defaults to operation composio) */
1909
- composio?: ComposioSetup;
1910
- /** Composio config for judge (defaults to composio) */
1911
- judgeComposio?: ComposioSetup;
1920
+ /** Integrations config for candidates (defaults to operation integrations) */
1921
+ integrations?: IntegrationsSetup;
1922
+ /** Integrations config for judge (defaults to integrations) */
1923
+ judgeIntegrations?: IntegrationsSetup;
1912
1924
  /** Callback when a candidate completes */
1913
1925
  onCandidateComplete?: OnCandidateCompleteCallback;
1914
1926
  /** Callback when judge completes */
@@ -1929,8 +1941,8 @@ interface VerifyConfig {
1929
1941
  verifierMcpServers?: Record<string, McpServerConfig>;
1930
1942
  /** Skills for verifier (defaults to operation skills) */
1931
1943
  verifierSkills?: SkillName[];
1932
- /** Composio config for verifier (defaults to operation composio) */
1933
- verifierComposio?: ComposioSetup;
1944
+ /** Integrations config for verifier (defaults to operation integrations) */
1945
+ verifierIntegrations?: IntegrationsSetup;
1934
1946
  /** Callback invoked after each worker completion (before verification) */
1935
1947
  onWorkerComplete?: OnWorkerCompleteCallback;
1936
1948
  /** Callback invoked after each verifier completion */
@@ -2102,8 +2114,8 @@ interface MapParams<T> {
2102
2114
  mcpServers?: Record<string, McpServerConfig>;
2103
2115
  /** Skills override (replaces swarm default) */
2104
2116
  skills?: SkillName[];
2105
- /** Composio override (replaces swarm default) */
2106
- composio?: ComposioSetup;
2117
+ /** Integrations override (replaces swarm default) */
2118
+ integrations?: IntegrationsSetup;
2107
2119
  /** Optional bestOf configuration for N candidates + judge (mutually exclusive with verify) */
2108
2120
  bestOf?: BestOfConfig;
2109
2121
  /** Optional verify configuration for LLM-as-judge quality verification with retry (mutually exclusive with bestOf) */
@@ -2137,8 +2149,8 @@ interface FilterParams<T> {
2137
2149
  mcpServers?: Record<string, McpServerConfig>;
2138
2150
  /** Skills override (replaces swarm default) */
2139
2151
  skills?: SkillName[];
2140
- /** Composio override (replaces swarm default) */
2141
- composio?: ComposioSetup;
2152
+ /** Integrations override (replaces swarm default) */
2153
+ integrations?: IntegrationsSetup;
2142
2154
  /** Optional verify configuration for LLM-as-judge quality verification with retry */
2143
2155
  verify?: VerifyConfig;
2144
2156
  /** Per-item retry configuration. Typed to allow retryOn access to SwarmResult fields. */
@@ -2168,8 +2180,8 @@ interface ReduceParams<T> {
2168
2180
  mcpServers?: Record<string, McpServerConfig>;
2169
2181
  /** Skills override (replaces swarm default) */
2170
2182
  skills?: SkillName[];
2171
- /** Composio override (replaces swarm default) */
2172
- composio?: ComposioSetup;
2183
+ /** Integrations override (replaces swarm default) */
2184
+ integrations?: IntegrationsSetup;
2173
2185
  /** Optional verify configuration for LLM-as-judge quality verification with retry */
2174
2186
  verify?: VerifyConfig;
2175
2187
  /** Retry configuration (retries entire reduce on error). Typed to allow retryOn access to ReduceResult fields. */
@@ -2185,7 +2197,7 @@ interface BestOfParams<T> {
2185
2197
  prompt: string;
2186
2198
  /** Optional operation name for observability */
2187
2199
  name?: string;
2188
- /** BestOf configuration (n, judgeCriteria, taskAgents, judgeAgent, mcpServers, skills, composio) */
2200
+ /** BestOf configuration (n, judgeCriteria, taskAgents, judgeAgent, mcpServers, skills, integrations) */
2189
2201
  config: BestOfConfig;
2190
2202
  /** Optional system prompt */
2191
2203
  systemPrompt?: string;
@@ -2375,8 +2387,8 @@ interface BaseStepConfig {
2375
2387
  mcpServers?: Record<string, McpServerConfig>;
2376
2388
  /** Skills override (replaces swarm default for this step) */
2377
2389
  skills?: SkillName[];
2378
- /** Composio override (replaces swarm default for this step) */
2379
- composio?: ComposioSetup;
2390
+ /** Integrations override (replaces swarm default for this step) */
2391
+ integrations?: IntegrationsSetup;
2380
2392
  /** Timeout in ms */
2381
2393
  timeoutMs?: number;
2382
2394
  }
@@ -3137,4 +3149,4 @@ interface SessionsClient {
3137
3149
  */
3138
3150
  declare function sessions(config?: SessionsConfig): SessionsClient;
3139
3151
 
3140
- export { AGENT_REGISTRY, AGENT_TYPES, type ActionbookBrowserConfig, Agent, type AgentBrowserConfig, type AgentConfig, type AgentOptions, type AgentOverride, type AgentParser, type AgentPluginConfig, type AgentRegistryEntry, type AgentResponse, type AgentRuntimeState, type AgentType, BROWSER_ACTIONBOOK_PROMPT, type BaseMeta, type BestOfConfig, type BestOfParams, type BestOfResult, type BrowserConfig, type BrowserProvider, type BrowserReplay, type BrowserReplayOptions, type BrowserRuntimeInfo, type CandidateCompleteEvent, type CheckpointInfo, type CodexAgentPluginConfig, type ComposioAuthResult, type ComposioConfig, type ComposioConnectionStatus, type ComposioSetup, type DownloadCheckpointOptions, type DownloadFilesOptions, type DownloadSessionOptions, type EmitOption, type EventHandler, type EventName, Evolve, type EvolveConfig, type EvolveEvents, type ExecuteCommandOptions, type FileMap, type FilterConfig, type FilterParams, type GeminiAgentPluginConfig, type GetEventsOptions, type IndexedMeta, type ItemInput, type ItemRetryEvent, JUDGE_PROMPT, type JsonSchema, type JudgeCompleteEvent, type JudgeDecision, type JudgeMeta, type LifecycleEvent, type LifecycleReason, type ListSessionsOptions, type ManagedBrowserProvider, type MapConfig, type MapParams, type MarketplaceAgentPluginConfig, type McpConfigInfo, type McpServerConfig, type ModelInfo, type OnCandidateCompleteCallback, type OnItemRetryCallback, type OnJudgeCompleteCallback, type OnVerifierCompleteCallback, type OnWorkerCompleteCallback, type OperationType, type OutputEvent, type OutputResult, Pipeline, type PipelineContext, type PipelineEventMap, type PipelineEvents, type PipelineResult, type ProcessInfo, type Prompt, type PromptFn, RETRY_FEEDBACK_PROMPT, type ReasoningEffort, type ReduceConfig, type ReduceMeta, type ReduceParams, type ReduceResult, type ResolvedStorageConfig, type RetryConfig, type RunCost, type RunOptions, SCHEMA_PROMPT, SWARM_RESULT_BRAND, SYSTEM_PROMPT, type SandboxCommandHandle, type SandboxCommandResult, type SandboxCommands, type SandboxCreateOptions, type SandboxFiles, type SandboxInstance, type SandboxLifecycleState, type SandboxProvider, type SandboxRunOptions, type SandboxSpawnOptions, type SchemaValidationOptions, Semaphore, type SessionCost, type SessionEvent, type SessionInfo, type SessionPage, type SessionStatus, type SessionsClient, type SessionsConfig, type SkillName, type SkillsConfig, type StepCompleteEvent, type StepErrorEvent, type StepEvent, type StepResult, type StepStartEvent, type StorageClient, type StorageConfig, type StreamCallbacks, Swarm, type SwarmConfig, type SwarmResult, SwarmResultList, TerminalPipeline, type ToolsFilter, VALIDATION_PRESETS, VERIFY_PROMPT, type ValidationMode, type VerifierCompleteEvent, type VerifyConfig, type VerifyDecision, type VerifyInfo, type VerifyMeta, WORKSPACE_PROMPT, WORKSPACE_SWE_PROMPT, type WorkerCompleteEvent, type WorkspaceMode, applyTemplate, buildWorkerSystemPrompt, createAgentParser, createClaudeParser, createCodexParser, createDroidParser, createGeminiParser, executeWithRetry, expandPath, getAgentConfig, getMcpSettingsDir, getMcpSettingsPath, isValidAgentType, isZodSchema, jsonSchemaToString, parseNdjsonLine, parseNdjsonOutput, parseQwenOutput, readLocalDir, resolveStorageConfig, saveLocalDir, sessions, storage, writeClaudeMcpConfig, writeCodexMcpConfig, writeDroidGatewaySettings, writeDroidMcpConfig, writeGeminiMcpConfig, writeMcpConfig, writeQwenMcpConfig, zodSchemaToJson };
3152
+ export { AGENT_REGISTRY, AGENT_TYPES, type ActionbookBrowserConfig, Agent, type AgentBrowserConfig, type AgentConfig, type AgentOptions, type AgentOverride, type AgentParser, type AgentPluginConfig, type AgentRegistryEntry, type AgentResponse, type AgentRuntimeState, type AgentType, BROWSER_ACTIONBOOK_PROMPT, BROWSER_LOGIN_MCP_SERVER_NAME, type BaseMeta, type BestOfConfig, type BestOfParams, type BestOfResult, type BrowserConfig, type BrowserCredentialCreateInput, type BrowserCredentialDeleteInput, type BrowserCredentialListOptions, type BrowserCredentialMetadata, type BrowserCredentialScopeEntry, BrowserCredentialsClient, type BrowserCredentialsClientConfig, type BrowserCredentialsConfig, type BrowserProvider, type BrowserReplay, type BrowserReplayOptions, type BrowserRuntimeInfo, type CandidateCompleteEvent, type CheckpointInfo, type CodexAgentPluginConfig, type DownloadCheckpointOptions, type DownloadFilesOptions, type DownloadSessionOptions, type EmitOption, type EventHandler, type EventName, Evolve, type EvolveConfig, type EvolveEvents, type ExecuteCommandOptions, type FileMap, type FilterConfig, type FilterParams, type GeminiAgentPluginConfig, type GetEventsOptions, type IndexedMeta, type IntegrationAccount, type IntegrationAccountDeleteParams, type IntegrationAccountDeleteResult, type IntegrationAccountListParams, type IntegrationAccountUpdateParams, type IntegrationAccountUpdateResult, type IntegrationAuthParams, type IntegrationAuthResult, type IntegrationToolsFilter, type IntegrationsConfig, type IntegrationsSetup, type ItemInput, type ItemRetryEvent, JUDGE_PROMPT, type JsonSchema, type JudgeCompleteEvent, type JudgeDecision, type JudgeMeta, type LifecycleEvent, type LifecycleReason, type ListSessionsOptions, type ManagedBrowserProvider, type MapConfig, type MapParams, type MarketplaceAgentPluginConfig, type McpConfigInfo, type McpServerConfig, type ModelInfo, type OnCandidateCompleteCallback, type OnItemRetryCallback, type OnJudgeCompleteCallback, type OnVerifierCompleteCallback, type OnWorkerCompleteCallback, type OperationType, type OutputEvent, type OutputResult, Pipeline, type PipelineContext, type PipelineEventMap, type PipelineEvents, type PipelineResult, type ProcessInfo, type Prompt, type PromptFn, RETRY_FEEDBACK_PROMPT, type ReasoningEffort, type ReduceConfig, type ReduceMeta, type ReduceParams, type ReduceResult, type ResolvedStorageConfig, type RetryConfig, type RunCost, type RunOptions, SCHEMA_PROMPT, SWARM_RESULT_BRAND, SYSTEM_PROMPT, type SandboxCommandHandle, type SandboxCommandResult, type SandboxCommands, type SandboxCreateOptions, type SandboxFiles, type SandboxInstance, type SandboxLifecycleState, type SandboxProvider, type SandboxRunOptions, type SandboxSpawnOptions, type SchemaValidationOptions, Semaphore, type SessionCost, type SessionEvent, type SessionInfo, type SessionPage, type SessionStatus, type SessionsClient, type SessionsConfig, type SkillName, type SkillsConfig, type StepCompleteEvent, type StepErrorEvent, type StepEvent, type StepResult, type StepStartEvent, type StorageClient, type StorageConfig, type StreamCallbacks, Swarm, type SwarmConfig, type SwarmResult, SwarmResultList, TerminalPipeline, VALIDATION_PRESETS, VERIFY_PROMPT, type ValidationMode, type VerifierCompleteEvent, type VerifyConfig, type VerifyDecision, type VerifyInfo, type VerifyMeta, WORKSPACE_PROMPT, WORKSPACE_SWE_PROMPT, type WorkerCompleteEvent, type WorkspaceMode, applyTemplate, browserCredentials, buildWorkerSystemPrompt, createAgentParser, createClaudeParser, createCodexParser, createDroidParser, createGeminiParser, executeWithRetry, expandPath, getAgentConfig, getMcpSettingsDir, getMcpSettingsPath, isValidAgentType, isZodSchema, jsonSchemaToString, parseNdjsonLine, parseNdjsonOutput, parseQwenOutput, readLocalDir, resolveStorageConfig, saveLocalDir, sessions, storage, writeClaudeMcpConfig, writeCodexMcpConfig, writeDroidGatewaySettings, writeDroidMcpConfig, writeGeminiMcpConfig, writeMcpConfig, writeQwenMcpConfig, zodSchemaToJson };