@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.cjs +63 -63
- package/dist/index.d.cts +192 -180
- package/dist/index.d.ts +192 -180
- package/dist/index.js +63 -63
- package/package.json +6 -6
package/dist/index.d.ts
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
|
|
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
|
|
740
|
-
type
|
|
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
|
|
762
|
+
interface IntegrationsConfig {
|
|
748
763
|
/**
|
|
749
|
-
*
|
|
764
|
+
* Apps to expose to the agent.
|
|
750
765
|
*
|
|
751
766
|
* @example
|
|
752
|
-
*
|
|
767
|
+
* apps: ["github", "gmail", "linear"]
|
|
753
768
|
*/
|
|
754
|
-
|
|
769
|
+
apps: string[];
|
|
755
770
|
/**
|
|
756
|
-
* Per-
|
|
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,
|
|
780
|
+
tools?: Record<string, IntegrationToolsFilter>;
|
|
766
781
|
/**
|
|
767
|
-
*
|
|
768
|
-
|
|
769
|
-
|
|
770
|
-
|
|
771
|
-
* keys
|
|
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
|
|
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
|
-
*
|
|
785
|
-
*
|
|
786
|
-
* Combines user identification with optional configuration.
|
|
796
|
+
* Managed integrations setup.
|
|
787
797
|
*/
|
|
788
|
-
interface
|
|
789
|
-
/**
|
|
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
|
-
|
|
908
|
-
|
|
909
|
-
|
|
910
|
-
|
|
911
|
-
|
|
912
|
-
|
|
913
|
-
|
|
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
|
-
|
|
919
|
-
connectionId: string;
|
|
926
|
+
accountId?: string;
|
|
920
927
|
}
|
|
921
|
-
|
|
922
|
-
|
|
923
|
-
|
|
924
|
-
|
|
925
|
-
|
|
926
|
-
|
|
927
|
-
|
|
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
|
-
/**
|
|
1435
|
-
|
|
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
|
|
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
|
-
*
|
|
1590
|
-
*
|
|
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
|
-
|
|
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
|
-
|
|
1622
|
-
|
|
1623
|
-
|
|
1624
|
-
|
|
1625
|
-
|
|
1626
|
-
|
|
1627
|
-
|
|
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
|
|
1885
|
-
|
|
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
|
-
/**
|
|
1909
|
-
|
|
1910
|
-
/**
|
|
1911
|
-
|
|
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
|
-
/**
|
|
1933
|
-
|
|
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
|
-
/**
|
|
2106
|
-
|
|
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
|
-
/**
|
|
2141
|
-
|
|
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
|
-
/**
|
|
2172
|
-
|
|
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,
|
|
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
|
-
/**
|
|
2379
|
-
|
|
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
|
|
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 };
|