@github/copilot-sdk 1.0.17-preview.0 → 1.0.17-preview.10
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/README.md +108 -0
- package/dist/canvas.d.ts +6 -1
- package/dist/cjs/cliVersion.js +1 -1
- package/dist/cjs/client.js +69 -4
- package/dist/cjs/extension.js +2 -0
- package/dist/cjs/generated/rpc.js +577 -251
- package/dist/cjs/index.js +2 -0
- package/dist/cjs/runtimeArtifacts.js +1 -0
- package/dist/cjs/session.js +151 -2
- package/dist/cjs/sessionFsProvider.js +57 -0
- package/dist/cjs/types.js +5 -2
- package/dist/cliVersion.d.ts +1 -1
- package/dist/cliVersion.js +1 -1
- package/dist/client.d.ts +1 -0
- package/dist/client.js +69 -4
- package/dist/extension.d.ts +1 -1
- package/dist/extension.js +2 -0
- package/dist/generated/rpc.d.ts +2250 -684
- package/dist/generated/rpc.js +577 -251
- package/dist/generated/session-events.d.ts +292 -11
- package/dist/index.d.ts +2 -2
- package/dist/index.js +2 -0
- package/dist/runtimeArtifacts.js +1 -0
- package/dist/session.d.ts +52 -1
- package/dist/session.js +151 -2
- package/dist/sessionFsProvider.d.ts +9 -1
- package/dist/sessionFsProvider.js +56 -0
- package/dist/types.d.ts +159 -2
- package/dist/types.js +4 -2
- package/docs/agent-author.md +29 -2
- package/package.json +13 -12
package/dist/generated/rpc.d.ts
CHANGED
|
@@ -15,7 +15,7 @@ export type JsonValue = null | boolean | number | string | JsonValue[] | {
|
|
|
15
15
|
* via the `definition` "AuthInfo".
|
|
16
16
|
*/
|
|
17
17
|
/** @experimental */
|
|
18
|
-
export type AuthInfo = HMACAuthInfo | EnvAuthInfo | TokenAuthInfo | TokenProviderAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
|
|
18
|
+
export type AuthInfo = HMACAuthInfo | EnvAuthInfo | TokenAuthInfo | TokenProviderAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | AccountAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
|
|
19
19
|
/**
|
|
20
20
|
* The provider kind stamped on a signed-in account.
|
|
21
21
|
*
|
|
@@ -383,6 +383,8 @@ export type AuthInfoType =
|
|
|
383
383
|
| "env"
|
|
384
384
|
/** Authentication from an interactive user sign-in. */
|
|
385
385
|
| "user"
|
|
386
|
+
/** Authentication from a selected provider-owned account, without a GitHub credential. */
|
|
387
|
+
| "account"
|
|
386
388
|
/** Authentication delegated to the GitHub CLI. */
|
|
387
389
|
| "gh-cli"
|
|
388
390
|
/** Authentication from an API key credential. */
|
|
@@ -445,17 +447,19 @@ export type AuthLoginStep = {
|
|
|
445
447
|
kind: "error";
|
|
446
448
|
};
|
|
447
449
|
/**
|
|
448
|
-
*
|
|
450
|
+
* Disposition of a login attempt, including pending user decisions.
|
|
449
451
|
*
|
|
450
452
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
451
453
|
* via the `definition` "AuthLoginResultStatus".
|
|
452
454
|
*/
|
|
453
455
|
/** @experimental */
|
|
454
456
|
export type AuthLoginResultStatus =
|
|
455
|
-
/** The credential was persisted and the account is signed in. */
|
|
457
|
+
/** The credential was persisted and the selected account is signed in. */
|
|
456
458
|
"completed"
|
|
457
459
|
/** Persistence needs explicit consent to store the token in plaintext. */
|
|
458
460
|
| "needs-plaintext-consent"
|
|
461
|
+
/** Credentials are saved; select an account using a returned selectionId as advance input to complete sign-in. */
|
|
462
|
+
| "needs-account-selection"
|
|
459
463
|
/** The user declined plaintext persistence. */
|
|
460
464
|
| "declined";
|
|
461
465
|
/**
|
|
@@ -467,6 +471,7 @@ export type AuthLoginResultStatus =
|
|
|
467
471
|
/** @experimental */
|
|
468
472
|
export type AuthReadValue = {
|
|
469
473
|
account?: AccountStatus;
|
|
474
|
+
authInfo?: AuthIdentity;
|
|
470
475
|
/**
|
|
471
476
|
* Account read-datum variant discriminator.
|
|
472
477
|
*/
|
|
@@ -1358,6 +1363,20 @@ export type ConnectorMcpStatus =
|
|
|
1358
1363
|
| "disabled"
|
|
1359
1364
|
/** The Connector currently has no live server configuration. */
|
|
1360
1365
|
| "not_configured";
|
|
1366
|
+
/**
|
|
1367
|
+
* Availability.
|
|
1368
|
+
*
|
|
1369
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1370
|
+
* via the `definition` "ConnectorDiscoveryAvailability".
|
|
1371
|
+
*/
|
|
1372
|
+
/** @experimental */
|
|
1373
|
+
export type ConnectorDiscoveryAvailability =
|
|
1374
|
+
/** Enabled. */
|
|
1375
|
+
"enabled"
|
|
1376
|
+
/** Disabled. */
|
|
1377
|
+
| "disabled"
|
|
1378
|
+
/** Unavailable. */
|
|
1379
|
+
| "unavailable";
|
|
1361
1380
|
/**
|
|
1362
1381
|
* Session account selection, or null.
|
|
1363
1382
|
*
|
|
@@ -1394,6 +1413,44 @@ export type ContentFilterMode =
|
|
|
1394
1413
|
| "markdown"
|
|
1395
1414
|
/** Remove characters that can hide directives. */
|
|
1396
1415
|
| "hidden_characters";
|
|
1416
|
+
/**
|
|
1417
|
+
* Component of session customization discovery.
|
|
1418
|
+
*
|
|
1419
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1420
|
+
* via the `definition` "CustomizationReloadSubsystem".
|
|
1421
|
+
*/
|
|
1422
|
+
/** @experimental */
|
|
1423
|
+
export type CustomizationReloadSubsystem =
|
|
1424
|
+
/** Repository metadata and working-directory context. */
|
|
1425
|
+
"repositoryContext"
|
|
1426
|
+
/** Session instructions and their cached dynamic context. */
|
|
1427
|
+
| "instructions"
|
|
1428
|
+
/** Discovered plugin configuration. */
|
|
1429
|
+
| "plugins"
|
|
1430
|
+
/** Configured session and plugin hooks. */
|
|
1431
|
+
| "hooks"
|
|
1432
|
+
/** Discovered skills. */
|
|
1433
|
+
| "skills"
|
|
1434
|
+
/** Discovered custom agents. */
|
|
1435
|
+
| "agents"
|
|
1436
|
+
/** Loaded MCP server configuration. */
|
|
1437
|
+
| "mcp"
|
|
1438
|
+
/** Configured session extensions. */
|
|
1439
|
+
| "extensions" | (string & {});
|
|
1440
|
+
/**
|
|
1441
|
+
* Result of reloading a customization component.
|
|
1442
|
+
*
|
|
1443
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1444
|
+
* via the `definition` "CustomizationReloadStatus".
|
|
1445
|
+
*/
|
|
1446
|
+
/** @experimental */
|
|
1447
|
+
export type CustomizationReloadStatus =
|
|
1448
|
+
/** The component was refreshed successfully. */
|
|
1449
|
+
"reloaded"
|
|
1450
|
+
/** The component was not configured, loaded, or eligible for refresh. */
|
|
1451
|
+
| "skipped"
|
|
1452
|
+
/** The component could not be refreshed; other components may still reload. */
|
|
1453
|
+
| "failed" | (string & {});
|
|
1397
1454
|
/**
|
|
1398
1455
|
* Source category for a collected debug bundle entry.
|
|
1399
1456
|
*
|
|
@@ -1700,57 +1757,45 @@ export type DiscoveredMcpServerType =
|
|
|
1700
1757
|
/** Server is backed by an in-memory runtime implementation. */
|
|
1701
1758
|
| "memory";
|
|
1702
1759
|
/**
|
|
1703
|
-
*
|
|
1760
|
+
* Kind of component that supplied a provider adapter or row. Attribution does not confer authority.
|
|
1704
1761
|
*
|
|
1705
1762
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1706
|
-
* via the `definition` "
|
|
1763
|
+
* via the `definition` "ModelProviderProvenanceSource".
|
|
1707
1764
|
*/
|
|
1708
1765
|
/** @experimental */
|
|
1709
|
-
export type
|
|
1766
|
+
export type ModelProviderProvenanceSource =
|
|
1767
|
+
/** Built into the runtime. */
|
|
1768
|
+
"builtIn"
|
|
1769
|
+
/** Derived from existing user configuration. */
|
|
1770
|
+
| "configured"
|
|
1771
|
+
/** Supplied by an extension. */
|
|
1772
|
+
| "extension"
|
|
1773
|
+
/** Supplied by another trusted contributor. */
|
|
1774
|
+
| "custom";
|
|
1710
1775
|
/**
|
|
1711
|
-
*
|
|
1776
|
+
* Typed outcome for a provider operation.
|
|
1712
1777
|
*
|
|
1713
1778
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1714
|
-
* via the `definition` "
|
|
1779
|
+
* via the `definition` "ModelProviderOperationOutcomeCode".
|
|
1715
1780
|
*/
|
|
1716
1781
|
/** @experimental */
|
|
1717
|
-
export type
|
|
1718
|
-
/**
|
|
1719
|
-
"
|
|
1720
|
-
/**
|
|
1721
|
-
| "
|
|
1722
|
-
/**
|
|
1723
|
-
| "
|
|
1782
|
+
export type ModelProviderOperationOutcomeCode =
|
|
1783
|
+
/** The operation completed successfully; an empty inventory is valid. */
|
|
1784
|
+
"success"
|
|
1785
|
+
/** The provider or instance is absent during discovery, status, or model listing. Distinct from a successful empty inventory. */
|
|
1786
|
+
| "absent"
|
|
1787
|
+
/** The provider is configured or expected but could not be reached. */
|
|
1788
|
+
| "unreachable"
|
|
1789
|
+
/** The operation failed for a reason other than absence or reachability. */
|
|
1790
|
+
| "failed";
|
|
1724
1791
|
/**
|
|
1725
|
-
*
|
|
1792
|
+
* Indicates whether the command was accepted into the local execution queue.
|
|
1726
1793
|
*
|
|
1727
1794
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1728
|
-
* via the `definition` "
|
|
1795
|
+
* via the `definition` "EnqueueCommandResult".
|
|
1729
1796
|
*/
|
|
1730
1797
|
/** @experimental */
|
|
1731
|
-
export type
|
|
1732
|
-
/**
|
|
1733
|
-
* Opaque access token.
|
|
1734
|
-
*/
|
|
1735
|
-
accessToken: string;
|
|
1736
|
-
/**
|
|
1737
|
-
* Expiry as milliseconds since Unix epoch, when supplied by OneAuth.
|
|
1738
|
-
*/
|
|
1739
|
-
expiresOnTimestamp?: number;
|
|
1740
|
-
/**
|
|
1741
|
-
* Opaque OneAuth account id, when supplied by the broker.
|
|
1742
|
-
*/
|
|
1743
|
-
accountId?: string;
|
|
1744
|
-
/**
|
|
1745
|
-
* OneAuth token acquisition outcome discriminator.
|
|
1746
|
-
*/
|
|
1747
|
-
status: "ok";
|
|
1748
|
-
} | {
|
|
1749
|
-
/**
|
|
1750
|
-
* OneAuth token acquisition outcome discriminator.
|
|
1751
|
-
*/
|
|
1752
|
-
status: "interaction-required";
|
|
1753
|
-
};
|
|
1798
|
+
export type EnqueueCommandResult = AcceptedEnqueueCommandResult | UnsupportedEnqueueCommandResult;
|
|
1754
1799
|
/**
|
|
1755
1800
|
* GitHub Mission Control compute kind.
|
|
1756
1801
|
*
|
|
@@ -1945,6 +1990,14 @@ export type GitHubTokenAcquireResult = {
|
|
|
1945
1990
|
*/
|
|
1946
1991
|
kind: "cancelled";
|
|
1947
1992
|
};
|
|
1993
|
+
/**
|
|
1994
|
+
* Source for direct repo installs (when marketplace is empty)
|
|
1995
|
+
*
|
|
1996
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1997
|
+
* via the `definition` "InstalledPluginSource".
|
|
1998
|
+
*/
|
|
1999
|
+
/** @experimental */
|
|
2000
|
+
export type InstalledPluginSource = string | InstalledPluginSourceGitHub | InstalledPluginSourceUrl | InstalledPluginSourceLocal;
|
|
1948
2001
|
/**
|
|
1949
2002
|
* Optional compaction parameters.
|
|
1950
2003
|
*
|
|
@@ -2412,14 +2465,6 @@ export type InstallationDecision =
|
|
|
2412
2465
|
| "decline"
|
|
2413
2466
|
/** The user cancelled the pending decision without granting consent. */
|
|
2414
2467
|
| "cancel";
|
|
2415
|
-
/**
|
|
2416
|
-
* Source for direct repo installs (when marketplace is empty)
|
|
2417
|
-
*
|
|
2418
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
2419
|
-
* via the `definition` "InstalledPluginSource".
|
|
2420
|
-
*/
|
|
2421
|
-
/** @experimental */
|
|
2422
|
-
export type InstalledPluginSource = string | InstalledPluginSourceGitHub | InstalledPluginSourceUrl | InstalledPluginSourceLocal;
|
|
2423
2468
|
/**
|
|
2424
2469
|
* Which tier this target belongs to
|
|
2425
2470
|
*
|
|
@@ -3289,6 +3334,18 @@ export type McpServerCardEmbeddedKind = "embedded";
|
|
|
3289
3334
|
*/
|
|
3290
3335
|
/** @experimental */
|
|
3291
3336
|
export type McpPlanInstallResult = McpPlanInstallPlanned | CatalogNegotiationRefusedError | CatalogHandleRejectedError | CatalogInvalidRequestError | CatalogAuthenticationRequiredError | CatalogPolicyRejectedError | CatalogNetworkFailureError | CatalogUnsafeRetrievalError | CatalogMalformedCardError | CatalogContractViolationError | CatalogUnavailableTransportError | CatalogNotInstallableError | CatalogUnavailableError;
|
|
3337
|
+
/**
|
|
3338
|
+
* The sender role of an MCP prompt message.
|
|
3339
|
+
*
|
|
3340
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3341
|
+
* via the `definition` "McpPromptRole".
|
|
3342
|
+
*/
|
|
3343
|
+
/** @experimental */
|
|
3344
|
+
export type McpPromptRole =
|
|
3345
|
+
/** A message from the user. */
|
|
3346
|
+
"user"
|
|
3347
|
+
/** A message from the assistant. */
|
|
3348
|
+
| "assistant";
|
|
3292
3349
|
/**
|
|
3293
3350
|
* MCP server configuration (stdio, remote HTTP/SSE, or in-process)
|
|
3294
3351
|
*
|
|
@@ -3344,15 +3401,15 @@ export type SessionContextAttribution = {
|
|
|
3344
3401
|
*/
|
|
3345
3402
|
modelSource: string;
|
|
3346
3403
|
/**
|
|
3347
|
-
*
|
|
3404
|
+
* Effective input budget after reserving requested output against the combined context ceiling. Mirrors `SessionContextInfo.promptTokenLimit`.
|
|
3348
3405
|
*/
|
|
3349
3406
|
promptTokenLimit: number;
|
|
3350
3407
|
/**
|
|
3351
|
-
*
|
|
3408
|
+
* Advertised prompt allowance for the selected context tier: the denominator for context-usage displays and capacity for `categories.freeSpace` and `categories.buffer`. Mirrors `SessionContextInfo.limit`.
|
|
3352
3409
|
*/
|
|
3353
3410
|
limit: number;
|
|
3354
3411
|
/**
|
|
3355
|
-
* Output
|
|
3412
|
+
* Output reservation overlapping the displayed prompt allowance plus the tokens past the effective input budget's buffer-exhaustion blocking threshold. Mirrors `SessionContextInfo.bufferTokens`.
|
|
3356
3413
|
*/
|
|
3357
3414
|
bufferTokens: number;
|
|
3358
3415
|
/**
|
|
@@ -3388,7 +3445,7 @@ export type SessionContextAttribution = {
|
|
|
3388
3445
|
*/
|
|
3389
3446
|
freeSpace: number;
|
|
3390
3447
|
/**
|
|
3391
|
-
*
|
|
3448
|
+
* Overlapping output reservation plus post-blocking-threshold buffer.
|
|
3392
3449
|
*/
|
|
3393
3450
|
buffer: number;
|
|
3394
3451
|
};
|
|
@@ -3466,7 +3523,7 @@ export type SessionContextInfo = {
|
|
|
3466
3523
|
*/
|
|
3467
3524
|
totalTokens: number;
|
|
3468
3525
|
/**
|
|
3469
|
-
*
|
|
3526
|
+
* Effective input budget: the selected tier's prompt allowance bounded by the combined context ceiling minus the requested output allowance. Uses DEFAULT_TOKEN_LIMIT when limits are unspecified.
|
|
3470
3527
|
*/
|
|
3471
3528
|
promptTokenLimit: number;
|
|
3472
3529
|
/**
|
|
@@ -3474,11 +3531,11 @@ export type SessionContextInfo = {
|
|
|
3474
3531
|
*/
|
|
3475
3532
|
compactionThreshold: number;
|
|
3476
3533
|
/**
|
|
3477
|
-
*
|
|
3534
|
+
* Advertised prompt allowance for the selected context tier, without adding output tokens. The denominator for context-usage displays.
|
|
3478
3535
|
*/
|
|
3479
3536
|
limit: number;
|
|
3480
3537
|
/**
|
|
3481
|
-
* Output
|
|
3538
|
+
* Output reservation overlapping the displayed prompt allowance plus tokens after the effective input budget's buffer-exhaustion blocking threshold (default 95%).
|
|
3482
3539
|
*/
|
|
3483
3540
|
bufferTokens: number;
|
|
3484
3541
|
} | null;
|
|
@@ -3592,17 +3649,49 @@ export type ModelListRequest = {
|
|
|
3592
3649
|
skipCache?: boolean;
|
|
3593
3650
|
};
|
|
3594
3651
|
/**
|
|
3595
|
-
*
|
|
3652
|
+
* When the runtime may run an adapter without an explicit user action.
|
|
3596
3653
|
*
|
|
3597
3654
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3598
|
-
* via the `definition` "
|
|
3655
|
+
* via the `definition` "ModelProviderAutomaticDiscoveryMode".
|
|
3599
3656
|
*/
|
|
3600
3657
|
/** @experimental */
|
|
3601
|
-
export type
|
|
3602
|
-
/** The
|
|
3603
|
-
"
|
|
3604
|
-
/** The
|
|
3605
|
-
| "
|
|
3658
|
+
export type ModelProviderAutomaticDiscoveryMode =
|
|
3659
|
+
/** The adapter declares that automatic discovery is safe when the other policy fields are satisfied. */
|
|
3660
|
+
"automatic"
|
|
3661
|
+
/** The adapter may refresh instances the user already configured, but must not scan for new instances automatically. */
|
|
3662
|
+
| "configuredOnly"
|
|
3663
|
+
/** The adapter must run only after an explicit user action. */
|
|
3664
|
+
| "explicit";
|
|
3665
|
+
/**
|
|
3666
|
+
* Network reach an adapter may use during discovery.
|
|
3667
|
+
*
|
|
3668
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3669
|
+
* via the `definition` "ModelProviderDiscoveryNetworkScope".
|
|
3670
|
+
*/
|
|
3671
|
+
/** @experimental */
|
|
3672
|
+
export type ModelProviderDiscoveryNetworkScope =
|
|
3673
|
+
/** Discovery does not contact a network service. */
|
|
3674
|
+
"none"
|
|
3675
|
+
/** Discovery is limited to loopback addresses on the local machine. */
|
|
3676
|
+
| "loopbackOnly"
|
|
3677
|
+
/** Discovery contacts only endpoints the user already configured. */
|
|
3678
|
+
| "configuredEndpointOnly"
|
|
3679
|
+
/** Discovery may scan or contact the local network. */
|
|
3680
|
+
| "localNetwork"
|
|
3681
|
+
/** Discovery may contact remote internet services. */
|
|
3682
|
+
| "internet";
|
|
3683
|
+
/**
|
|
3684
|
+
* Whether a planned configuration entry is new or already present in the session registry.
|
|
3685
|
+
*
|
|
3686
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3687
|
+
* via the `definition` "ModelProviderConfigurationDisposition".
|
|
3688
|
+
*/
|
|
3689
|
+
/** @experimental */
|
|
3690
|
+
export type ModelProviderConfigurationDisposition =
|
|
3691
|
+
/** No matching entry is registered; the caller should add the entry. */
|
|
3692
|
+
"create"
|
|
3693
|
+
/** An equivalent entry is already registered; the caller should reuse it rather than adding a duplicate. */
|
|
3694
|
+
| "alreadyConfigured";
|
|
3606
3695
|
/**
|
|
3607
3696
|
* Provider type. Defaults to "openai" for generic OpenAI-compatible APIs.
|
|
3608
3697
|
*
|
|
@@ -3641,6 +3730,110 @@ export type ProviderConfigTransport =
|
|
|
3641
3730
|
"http"
|
|
3642
3731
|
/** WebSocket transport. */
|
|
3643
3732
|
| "websockets";
|
|
3733
|
+
/**
|
|
3734
|
+
* The product serving the model, reported in telemetry as `model_provider`.
|
|
3735
|
+
*
|
|
3736
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3737
|
+
* via the `definition` "ProviderConfigModelProvider".
|
|
3738
|
+
*/
|
|
3739
|
+
/** @experimental */
|
|
3740
|
+
export type ProviderConfigModelProvider =
|
|
3741
|
+
/** OpenAI API. */
|
|
3742
|
+
"openai"
|
|
3743
|
+
/** Anthropic API. */
|
|
3744
|
+
| "anthropic"
|
|
3745
|
+
/** Azure OpenAI Service. */
|
|
3746
|
+
| "azure_openai"
|
|
3747
|
+
/** Ollama. */
|
|
3748
|
+
| "ollama"
|
|
3749
|
+
/** LM Studio. */
|
|
3750
|
+
| "lm_studio"
|
|
3751
|
+
/** Foundry Local. */
|
|
3752
|
+
| "foundry_local"
|
|
3753
|
+
/** llama.cpp server. */
|
|
3754
|
+
| "llama_cpp";
|
|
3755
|
+
/** @experimental */
|
|
3756
|
+
export type ProtocolSystemMessageConfig = ProtocolSystemMessageAppendConfig | ProtocolSystemMessageReplaceConfig | ProtocolSystemMessageCustomizeConfig;
|
|
3757
|
+
/** @experimental */
|
|
3758
|
+
export type ProtocolAppendMode = "append";
|
|
3759
|
+
/** @experimental */
|
|
3760
|
+
export type ProtocolReplaceMode = "replace";
|
|
3761
|
+
/** @experimental */
|
|
3762
|
+
export type ProtocolCustomizeMode = "customize";
|
|
3763
|
+
/** @experimental */
|
|
3764
|
+
export type ProtocolSectionOverride = (ProtocolStaticSectionOverride | ProtocolMarkerSectionOverride) | undefined;
|
|
3765
|
+
/** @experimental */
|
|
3766
|
+
export type ProtocolStaticSectionAction =
|
|
3767
|
+
/** Replace the section content. */
|
|
3768
|
+
"replace"
|
|
3769
|
+
/** Remove the section content. */
|
|
3770
|
+
| "remove"
|
|
3771
|
+
/** Append content to the section. */
|
|
3772
|
+
| "append"
|
|
3773
|
+
/** Prepend content to the section. */
|
|
3774
|
+
| "prepend";
|
|
3775
|
+
/** @experimental */
|
|
3776
|
+
export type ProtocolMarkerSectionOverride = {
|
|
3777
|
+
/**
|
|
3778
|
+
* Section override action discriminator.
|
|
3779
|
+
*/
|
|
3780
|
+
action: "transform";
|
|
3781
|
+
} | {
|
|
3782
|
+
/**
|
|
3783
|
+
* Section override action discriminator.
|
|
3784
|
+
*/
|
|
3785
|
+
action: "preserve";
|
|
3786
|
+
};
|
|
3787
|
+
/**
|
|
3788
|
+
* Provider family. Matches the `type` field of a BYOK provider config.
|
|
3789
|
+
*
|
|
3790
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3791
|
+
* via the `definition` "ProviderEndpointType".
|
|
3792
|
+
*/
|
|
3793
|
+
/** @experimental */
|
|
3794
|
+
export type ProviderEndpointType =
|
|
3795
|
+
/** OpenAI-compatible endpoint (use the OpenAI client library). */
|
|
3796
|
+
"openai"
|
|
3797
|
+
/** Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). */
|
|
3798
|
+
| "azure"
|
|
3799
|
+
/** Anthropic endpoint (use the Anthropic client library). */
|
|
3800
|
+
| "anthropic";
|
|
3801
|
+
/**
|
|
3802
|
+
* Wire API to be used, when required for the provider type.
|
|
3803
|
+
*
|
|
3804
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3805
|
+
* via the `definition` "ProviderEndpointWireApi".
|
|
3806
|
+
*/
|
|
3807
|
+
/** @experimental */
|
|
3808
|
+
export type ProviderEndpointWireApi =
|
|
3809
|
+
/** Classic chat-completions request shape. */
|
|
3810
|
+
"completions"
|
|
3811
|
+
/** Newer responses request shape. */
|
|
3812
|
+
| "responses";
|
|
3813
|
+
/**
|
|
3814
|
+
* Transport to be used for provider requests.
|
|
3815
|
+
*
|
|
3816
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3817
|
+
* via the `definition` "ProviderEndpointTransport".
|
|
3818
|
+
*/
|
|
3819
|
+
/** @experimental */
|
|
3820
|
+
export type ProviderEndpointTransport =
|
|
3821
|
+
/** HTTP request/streaming transport. */
|
|
3822
|
+
"http"
|
|
3823
|
+
/** WebSocket transport. */
|
|
3824
|
+
| "websockets";
|
|
3825
|
+
/**
|
|
3826
|
+
* Whether the requested preference was already effective or was accepted for later transactional activation.
|
|
3827
|
+
*
|
|
3828
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3829
|
+
* via the `definition` "ModelSwitchAutoTierStatus".
|
|
3830
|
+
*/
|
|
3831
|
+
/** @experimental */
|
|
3832
|
+
export type ModelSwitchAutoTierStatus =
|
|
3833
|
+
/** The requested preference is already effective. No activation is pending for it, although this request may have cancelled an earlier unclaimed preference reported in `supersededAutoTier`. */
|
|
3834
|
+
"unchanged"
|
|
3835
|
+
/** The request was accepted but has not committed. A later user turn using the `auto` model must mint and validate the replacement before it becomes effective. */
|
|
3836
|
+
| "pending";
|
|
3644
3837
|
/**
|
|
3645
3838
|
* Allowed values for the `OptionsUpdateAdditionalContentExclusionPolicyScope` enumeration.
|
|
3646
3839
|
*
|
|
@@ -3898,10 +4091,6 @@ export type PluginsReloadRequest = {
|
|
|
3898
4091
|
*/
|
|
3899
4092
|
deferRepoHooks?: boolean;
|
|
3900
4093
|
};
|
|
3901
|
-
/** @experimental */
|
|
3902
|
-
export type ProtocolAppendMode = "append";
|
|
3903
|
-
/** @experimental */
|
|
3904
|
-
export type ProtocolCustomizeMode = "customize";
|
|
3905
4094
|
/**
|
|
3906
4095
|
* Controls whether the runtime may defer loading an external tool definition.
|
|
3907
4096
|
*
|
|
@@ -3914,72 +4103,6 @@ export type ProtocolExternalToolDefer =
|
|
|
3914
4103
|
"auto"
|
|
3915
4104
|
/** The runtime must include the tool without deferring it. */
|
|
3916
4105
|
| "never";
|
|
3917
|
-
/** @experimental */
|
|
3918
|
-
export type ProtocolMarkerSectionOverride = {
|
|
3919
|
-
/**
|
|
3920
|
-
* Section override action discriminator.
|
|
3921
|
-
*/
|
|
3922
|
-
action: "transform";
|
|
3923
|
-
} | {
|
|
3924
|
-
/**
|
|
3925
|
-
* Section override action discriminator.
|
|
3926
|
-
*/
|
|
3927
|
-
action: "preserve";
|
|
3928
|
-
};
|
|
3929
|
-
/** @experimental */
|
|
3930
|
-
export type ProtocolReplaceMode = "replace";
|
|
3931
|
-
/** @experimental */
|
|
3932
|
-
export type ProtocolSectionOverride = ProtocolStaticSectionOverride | ProtocolMarkerSectionOverride;
|
|
3933
|
-
/** @experimental */
|
|
3934
|
-
export type ProtocolStaticSectionAction =
|
|
3935
|
-
/** Replace the section content. */
|
|
3936
|
-
"replace"
|
|
3937
|
-
/** Remove the section content. */
|
|
3938
|
-
| "remove"
|
|
3939
|
-
/** Append content to the section. */
|
|
3940
|
-
| "append"
|
|
3941
|
-
/** Prepend content to the section. */
|
|
3942
|
-
| "prepend";
|
|
3943
|
-
/** @experimental */
|
|
3944
|
-
export type ProtocolSystemMessageConfig = ProtocolSystemMessageAppendConfig | ProtocolSystemMessageReplaceConfig | ProtocolSystemMessageCustomizeConfig;
|
|
3945
|
-
/**
|
|
3946
|
-
* Provider family. Matches the `type` field of a BYOK provider config.
|
|
3947
|
-
*
|
|
3948
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3949
|
-
* via the `definition` "ProviderEndpointType".
|
|
3950
|
-
*/
|
|
3951
|
-
/** @experimental */
|
|
3952
|
-
export type ProviderEndpointType =
|
|
3953
|
-
/** OpenAI-compatible endpoint (use the OpenAI client library). */
|
|
3954
|
-
"openai"
|
|
3955
|
-
/** Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). */
|
|
3956
|
-
| "azure"
|
|
3957
|
-
/** Anthropic endpoint (use the Anthropic client library). */
|
|
3958
|
-
| "anthropic";
|
|
3959
|
-
/**
|
|
3960
|
-
* Wire API to be used, when required for the provider type.
|
|
3961
|
-
*
|
|
3962
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3963
|
-
* via the `definition` "ProviderEndpointWireApi".
|
|
3964
|
-
*/
|
|
3965
|
-
/** @experimental */
|
|
3966
|
-
export type ProviderEndpointWireApi =
|
|
3967
|
-
/** Classic chat-completions request shape. */
|
|
3968
|
-
"completions"
|
|
3969
|
-
/** Newer responses request shape. */
|
|
3970
|
-
| "responses";
|
|
3971
|
-
/**
|
|
3972
|
-
* Transport to be used for provider requests.
|
|
3973
|
-
*
|
|
3974
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3975
|
-
* via the `definition` "ProviderEndpointTransport".
|
|
3976
|
-
*/
|
|
3977
|
-
/** @experimental */
|
|
3978
|
-
export type ProviderEndpointTransport =
|
|
3979
|
-
/** HTTP request/streaming transport. */
|
|
3980
|
-
"http"
|
|
3981
|
-
/** WebSocket transport. */
|
|
3982
|
-
| "websockets";
|
|
3983
4106
|
/**
|
|
3984
4107
|
* Optional model identifier to scope the endpoint snapshot to.
|
|
3985
4108
|
*
|
|
@@ -4144,13 +4267,29 @@ export type SandboxConfigSource =
|
|
|
4144
4267
|
/** A repository policy selected the sandbox state. */
|
|
4145
4268
|
| "repository_policy";
|
|
4146
4269
|
/**
|
|
4147
|
-
* Extensible identifier of a sandbox policy feature whose availability varies between hosts. A plain string, so an older client decodes a name added by a newer runtime; ignore names you do not recognize. Known values: `network` — sandboxed commands can reach the network (`network.allowOutbound`, on by default); on Linux this needs the tooling for Bubblewrap's private network namespace, such as slirp4netns. `network_filtering` — host rules and the sandbox proxy (`network.allowedHosts`, `network.blockedHosts`, `network.proxy`); on Linux this needs the same tooling as `network`; on Windows it needs
|
|
4270
|
+
* Extensible identifier of a sandbox policy feature whose availability varies between hosts. A plain string, so an older client decodes a name added by a newer runtime; ignore names you do not recognize. Known values: `network` — sandboxed commands can reach the network (`network.allowOutbound`, on by default); on Linux this needs the tooling for Bubblewrap's private network namespace, such as slirp4netns. `network_filtering` — host rules and the sandbox proxy (`network.allowedHosts`, `network.blockedHosts`, `network.proxy`); on Linux this needs the same tooling as `network`; on Windows it needs Process Security Environment 1.1 host-loopback support or MXC's PSEC 1.0-only proxy-loopback compatibility capability, and a policy that uses it must also set `network.allowLocalNetwork`, because Windows reaches the local proxy only together with private-network access. Compatibility applies only to an explicit identity-less runtime proxy, not general host-loopback access, and other policy restrictions still apply. `denied_paths` — native enforcement of `filesystem.deniedPaths`; on Windows this needs a version whose sandbox contract reports denied-path support. `shell` — shell commands inside the sandbox: bash on macOS and Linux, PowerShell on Windows. `filesystem_enumeration` — enumerate-only filesystem grants, which PowerShell's drive roots use on Windows; this needs a version with Process Security Environment 1.1 filesystem enumeration support. Without it, sandboxed PowerShell still runs, but `Get-Location` may report the drive root, `Set-Location` may fail, and relative paths may resolve against the drive root; the session also receives a `session.warning` with `warningType` `sandbox`. Other platforms always report it.
|
|
4148
4271
|
*
|
|
4149
4272
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
4150
4273
|
* via the `definition` "SandboxHostCapabilityName".
|
|
4151
4274
|
*/
|
|
4152
4275
|
/** @experimental */
|
|
4153
4276
|
export type SandboxHostCapabilityName = string;
|
|
4277
|
+
/**
|
|
4278
|
+
* State of the persistent certificate authority of the sandbox credential proxy.
|
|
4279
|
+
*
|
|
4280
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
4281
|
+
* via the `definition` "SandboxProxyCaState".
|
|
4282
|
+
*/
|
|
4283
|
+
/** @experimental */
|
|
4284
|
+
export type SandboxProxyCaState =
|
|
4285
|
+
/** This platform has no supported OS trust store. The proxy uses a per-process certificate bundle. */
|
|
4286
|
+
"unsupported"
|
|
4287
|
+
/** OS trust does not include the certificate authority, or none is stored. */
|
|
4288
|
+
| "notInstalled"
|
|
4289
|
+
/** OS trust includes the stored certificate authority. */
|
|
4290
|
+
| "installed"
|
|
4291
|
+
/** The runtime could not read the certificate authority or the OS trust store. */
|
|
4292
|
+
| "error";
|
|
4154
4293
|
/**
|
|
4155
4294
|
* A session-scoped sandbox transition applied while handling a slash command
|
|
4156
4295
|
*
|
|
@@ -4630,7 +4769,7 @@ export type SessionsClientMetadataEntry = {
|
|
|
4630
4769
|
* via the `definition` "SettableAuthInfo".
|
|
4631
4770
|
*/
|
|
4632
4771
|
/** @experimental */
|
|
4633
|
-
export type SettableAuthInfo = HMACAuthInfo | EnvAuthInfo | SettableTokenAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
|
|
4772
|
+
export type SettableAuthInfo = HMACAuthInfo | EnvAuthInfo | SettableTokenAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | AccountAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
|
|
4634
4773
|
/**
|
|
4635
4774
|
* Rust-owned settings predicates exposed across the SDK boundary. Raw feature-flag names are intentionally not part of the contract.
|
|
4636
4775
|
*
|
|
@@ -6286,29 +6425,50 @@ export interface UserAuthInfo {
|
|
|
6286
6425
|
copilotUser?: CopilotUserResponse;
|
|
6287
6426
|
}
|
|
6288
6427
|
/**
|
|
6289
|
-
*
|
|
6428
|
+
* An interactive account whose model provider owns its credentials. It carries no GitHub credential.
|
|
6290
6429
|
*
|
|
6291
6430
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
6292
|
-
* via the `definition` "
|
|
6431
|
+
* via the `definition` "AccountAuthInfo".
|
|
6293
6432
|
*/
|
|
6294
6433
|
/** @experimental */
|
|
6295
|
-
export interface
|
|
6434
|
+
export interface AccountAuthInfo {
|
|
6296
6435
|
/**
|
|
6297
|
-
*
|
|
6436
|
+
* Provider-owned account authentication.
|
|
6298
6437
|
*/
|
|
6299
|
-
type: "
|
|
6438
|
+
type: "account";
|
|
6300
6439
|
/**
|
|
6301
|
-
*
|
|
6440
|
+
* Host coordinate owned by the account's model provider.
|
|
6302
6441
|
*/
|
|
6303
6442
|
host: string;
|
|
6304
6443
|
/**
|
|
6305
|
-
*
|
|
6444
|
+
* Login identifying the provider-owned account.
|
|
6306
6445
|
*/
|
|
6307
6446
|
login: string;
|
|
6308
|
-
|
|
6309
|
-
|
|
6310
|
-
|
|
6311
|
-
|
|
6447
|
+
}
|
|
6448
|
+
/**
|
|
6449
|
+
* Authentication-info input variant for GitHub CLI credentials, carrying host, login, and the `gh auth token` value.
|
|
6450
|
+
*
|
|
6451
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
6452
|
+
* via the `definition` "GhCliAuthInfo".
|
|
6453
|
+
*/
|
|
6454
|
+
/** @experimental */
|
|
6455
|
+
export interface GhCliAuthInfo {
|
|
6456
|
+
/**
|
|
6457
|
+
* Authentication via the `gh` CLI's saved credentials.
|
|
6458
|
+
*/
|
|
6459
|
+
type: "gh-cli";
|
|
6460
|
+
/**
|
|
6461
|
+
* Authentication host.
|
|
6462
|
+
*/
|
|
6463
|
+
host: string;
|
|
6464
|
+
/**
|
|
6465
|
+
* User login as reported by `gh auth status`.
|
|
6466
|
+
*/
|
|
6467
|
+
login: string;
|
|
6468
|
+
/**
|
|
6469
|
+
* The token returned by `gh auth token`. Treat as a secret.
|
|
6470
|
+
*/
|
|
6471
|
+
token: string;
|
|
6312
6472
|
copilotUser?: CopilotUserResponse;
|
|
6313
6473
|
}
|
|
6314
6474
|
/**
|
|
@@ -7001,6 +7161,28 @@ export interface AuthIdentityMetadata {
|
|
|
7001
7161
|
*/
|
|
7002
7162
|
login: string;
|
|
7003
7163
|
}
|
|
7164
|
+
/**
|
|
7165
|
+
* A credential-free account choice after sign-in.
|
|
7166
|
+
*
|
|
7167
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7168
|
+
* via the `definition` "AuthLoginAccount".
|
|
7169
|
+
*/
|
|
7170
|
+
/** @experimental */
|
|
7171
|
+
export interface AuthLoginAccount {
|
|
7172
|
+
/**
|
|
7173
|
+
* Opaque identifier supplied to the next login step to select this account.
|
|
7174
|
+
*/
|
|
7175
|
+
selectionId: string;
|
|
7176
|
+
/**
|
|
7177
|
+
* Host coordinate owned by the selected account's provider.
|
|
7178
|
+
*/
|
|
7179
|
+
host: string;
|
|
7180
|
+
/**
|
|
7181
|
+
* Human-readable login for the account choice.
|
|
7182
|
+
*/
|
|
7183
|
+
login: string;
|
|
7184
|
+
kind: AccountKind;
|
|
7185
|
+
}
|
|
7004
7186
|
/**
|
|
7005
7187
|
* Advance an in-flight login flow, optionally fulfilling an input-required step.
|
|
7006
7188
|
*
|
|
@@ -7043,7 +7225,7 @@ export interface AuthLoginBegun {
|
|
|
7043
7225
|
step: AuthLoginStep;
|
|
7044
7226
|
}
|
|
7045
7227
|
/**
|
|
7046
|
-
*
|
|
7228
|
+
* Result of an interactive login flow. Pending consent or account selection is not terminal.
|
|
7047
7229
|
*
|
|
7048
7230
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7049
7231
|
* via the `definition` "AuthLoginResultDto".
|
|
@@ -7059,6 +7241,10 @@ export interface AuthLoginResultDto {
|
|
|
7059
7241
|
* Login that was signed in, when completed.
|
|
7060
7242
|
*/
|
|
7061
7243
|
login?: string;
|
|
7244
|
+
/**
|
|
7245
|
+
* Available accounts when sign-in is awaiting account selection, ordered with Microsoft 365 first.
|
|
7246
|
+
*/
|
|
7247
|
+
accounts?: AuthLoginAccount[];
|
|
7062
7248
|
}
|
|
7063
7249
|
/**
|
|
7064
7250
|
* Cancel an in-flight login flow.
|
|
@@ -7205,6 +7391,74 @@ export interface AutopilotObjectiveState {
|
|
|
7205
7391
|
creditCountNanoAiu: string;
|
|
7206
7392
|
creditLimit?: AutopilotObjectiveCreditLimit;
|
|
7207
7393
|
}
|
|
7394
|
+
/**
|
|
7395
|
+
* A server-advertised routing preference. Identifiers and execution types are extensible.
|
|
7396
|
+
*
|
|
7397
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7398
|
+
* via the `definition` "AutoTierDescriptor".
|
|
7399
|
+
*/
|
|
7400
|
+
/** @experimental */
|
|
7401
|
+
export interface AutoTierDescriptor {
|
|
7402
|
+
/**
|
|
7403
|
+
* Opaque routing identifier transmitted unchanged to the provider.
|
|
7404
|
+
*/
|
|
7405
|
+
id: string;
|
|
7406
|
+
/**
|
|
7407
|
+
* Human-readable label, not a routing identifier.
|
|
7408
|
+
*/
|
|
7409
|
+
displayName: string;
|
|
7410
|
+
/**
|
|
7411
|
+
* Description displayed beside the preference.
|
|
7412
|
+
*/
|
|
7413
|
+
description: string;
|
|
7414
|
+
/**
|
|
7415
|
+
* Execution kind; this client supports `auto` preferences on the Auto model.
|
|
7416
|
+
*/
|
|
7417
|
+
type: string;
|
|
7418
|
+
status: AutoTierStatus;
|
|
7419
|
+
}
|
|
7420
|
+
/**
|
|
7421
|
+
* Availability of a server-advertised routing preference.
|
|
7422
|
+
*
|
|
7423
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7424
|
+
* via the `definition` "AutoTierStatus".
|
|
7425
|
+
*/
|
|
7426
|
+
/** @experimental */
|
|
7427
|
+
export interface AutoTierStatus {
|
|
7428
|
+
/**
|
|
7429
|
+
* Whether the provider permits selecting this preference.
|
|
7430
|
+
*/
|
|
7431
|
+
enabled: boolean;
|
|
7432
|
+
/**
|
|
7433
|
+
* Extensible machine-readable unavailability reason.
|
|
7434
|
+
*/
|
|
7435
|
+
reason?: string;
|
|
7436
|
+
/**
|
|
7437
|
+
* Human-readable explanation of availability.
|
|
7438
|
+
*/
|
|
7439
|
+
message?: string;
|
|
7440
|
+
}
|
|
7441
|
+
/**
|
|
7442
|
+
* Account-bound discovery metadata for the virtual `auto` model.
|
|
7443
|
+
*
|
|
7444
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7445
|
+
* via the `definition` "AutoTierMetadata".
|
|
7446
|
+
*/
|
|
7447
|
+
/** @experimental */
|
|
7448
|
+
export interface AutoTierMetadata {
|
|
7449
|
+
/**
|
|
7450
|
+
* Provider-default preference, used only when no explicit preference exists.
|
|
7451
|
+
*/
|
|
7452
|
+
defaultTier: string;
|
|
7453
|
+
/**
|
|
7454
|
+
* Routing preferences in the server's presentation order.
|
|
7455
|
+
*/
|
|
7456
|
+
tiers: AutoTierDescriptor[];
|
|
7457
|
+
/**
|
|
7458
|
+
* Provider that supplied this metadata, when the catalog is provider-attributed.
|
|
7459
|
+
*/
|
|
7460
|
+
providerId?: string;
|
|
7461
|
+
}
|
|
7208
7462
|
/**
|
|
7209
7463
|
* The running runtime's complete catalog of well-known built-in model IDs, including supported models and additional IDs with built-in metadata.
|
|
7210
7464
|
*
|
|
@@ -9288,6 +9542,146 @@ export interface ConnectorDisconnectResult {
|
|
|
9288
9542
|
disconnected: boolean;
|
|
9289
9543
|
status: ConnectorStatus;
|
|
9290
9544
|
}
|
|
9545
|
+
/**
|
|
9546
|
+
* Eligible account.
|
|
9547
|
+
*
|
|
9548
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9549
|
+
* via the `definition` "ConnectorDiscoveryAccount".
|
|
9550
|
+
*/
|
|
9551
|
+
/** @experimental */
|
|
9552
|
+
export interface ConnectorDiscoveryAccount {
|
|
9553
|
+
/**
|
|
9554
|
+
* Opaque account ID.
|
|
9555
|
+
*/
|
|
9556
|
+
accountId: string;
|
|
9557
|
+
authInfo: ConnectorDiscoveryAuthInfo;
|
|
9558
|
+
}
|
|
9559
|
+
/**
|
|
9560
|
+
* Account metadata.
|
|
9561
|
+
*
|
|
9562
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9563
|
+
* via the `definition` "ConnectorDiscoveryAuthInfo".
|
|
9564
|
+
*/
|
|
9565
|
+
/** @experimental */
|
|
9566
|
+
export interface ConnectorDiscoveryAuthInfo {
|
|
9567
|
+
type: AuthInfoType;
|
|
9568
|
+
/**
|
|
9569
|
+
* Host.
|
|
9570
|
+
*/
|
|
9571
|
+
host: string;
|
|
9572
|
+
/**
|
|
9573
|
+
* Login.
|
|
9574
|
+
*/
|
|
9575
|
+
login: string;
|
|
9576
|
+
}
|
|
9577
|
+
/**
|
|
9578
|
+
* Eligible accounts.
|
|
9579
|
+
*
|
|
9580
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9581
|
+
* via the `definition` "ConnectorDiscoveryAccountList".
|
|
9582
|
+
*/
|
|
9583
|
+
/** @experimental */
|
|
9584
|
+
export interface ConnectorDiscoveryAccountList {
|
|
9585
|
+
availability: ConnectorDiscoveryAvailability;
|
|
9586
|
+
/**
|
|
9587
|
+
* Eligible accounts.
|
|
9588
|
+
*/
|
|
9589
|
+
accounts: ConnectorDiscoveryAccount[];
|
|
9590
|
+
}
|
|
9591
|
+
/**
|
|
9592
|
+
* Selected account.
|
|
9593
|
+
*
|
|
9594
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9595
|
+
* via the `definition` "ConnectorDiscoveryAccountRequest".
|
|
9596
|
+
*/
|
|
9597
|
+
/** @experimental */
|
|
9598
|
+
export interface ConnectorDiscoveryAccountRequest {
|
|
9599
|
+
/**
|
|
9600
|
+
* Opaque account ID.
|
|
9601
|
+
*/
|
|
9602
|
+
accountId: string;
|
|
9603
|
+
}
|
|
9604
|
+
/**
|
|
9605
|
+
* Feature availability.
|
|
9606
|
+
*
|
|
9607
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9608
|
+
* via the `definition` "ConnectorDiscoveryCapabilities".
|
|
9609
|
+
*/
|
|
9610
|
+
/** @experimental */
|
|
9611
|
+
export interface ConnectorDiscoveryCapabilities {
|
|
9612
|
+
/**
|
|
9613
|
+
* API version.
|
|
9614
|
+
*/
|
|
9615
|
+
apiVersion: number;
|
|
9616
|
+
availability: ConnectorDiscoveryAvailability;
|
|
9617
|
+
/**
|
|
9618
|
+
* Whether accounts are selected by opaque ID.
|
|
9619
|
+
*/
|
|
9620
|
+
opaqueAccountSelection: boolean;
|
|
9621
|
+
/**
|
|
9622
|
+
* Whether results are cached.
|
|
9623
|
+
*/
|
|
9624
|
+
conditionalCache: boolean;
|
|
9625
|
+
}
|
|
9626
|
+
/**
|
|
9627
|
+
* Entry.
|
|
9628
|
+
*
|
|
9629
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9630
|
+
* via the `definition` "ConnectorDiscoveryCatalogEntry".
|
|
9631
|
+
*/
|
|
9632
|
+
/** @experimental */
|
|
9633
|
+
export interface ConnectorDiscoveryCatalogEntry {
|
|
9634
|
+
/**
|
|
9635
|
+
* Name.
|
|
9636
|
+
*/
|
|
9637
|
+
name: string;
|
|
9638
|
+
/**
|
|
9639
|
+
* Display name.
|
|
9640
|
+
*/
|
|
9641
|
+
displayName: string;
|
|
9642
|
+
/**
|
|
9643
|
+
* Description.
|
|
9644
|
+
*/
|
|
9645
|
+
description?: string;
|
|
9646
|
+
/**
|
|
9647
|
+
* Logo.
|
|
9648
|
+
*/
|
|
9649
|
+
logo?: string;
|
|
9650
|
+
/**
|
|
9651
|
+
* Tier.
|
|
9652
|
+
*/
|
|
9653
|
+
tier?: string;
|
|
9654
|
+
/**
|
|
9655
|
+
* Release tag.
|
|
9656
|
+
*/
|
|
9657
|
+
releaseTag?: string;
|
|
9658
|
+
status: ConnectorCatalogStatus;
|
|
9659
|
+
}
|
|
9660
|
+
/**
|
|
9661
|
+
* Entries for the selected account.
|
|
9662
|
+
*
|
|
9663
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9664
|
+
* via the `definition` "ConnectorDiscoveryCatalogResult".
|
|
9665
|
+
*/
|
|
9666
|
+
/** @experimental */
|
|
9667
|
+
export interface ConnectorDiscoveryCatalogResult {
|
|
9668
|
+
/**
|
|
9669
|
+
* Opaque account ID.
|
|
9670
|
+
*/
|
|
9671
|
+
accountId: string;
|
|
9672
|
+
/**
|
|
9673
|
+
* Revision.
|
|
9674
|
+
*/
|
|
9675
|
+
revision: number;
|
|
9676
|
+
/**
|
|
9677
|
+
* Refresh time in Unix epoch milliseconds.
|
|
9678
|
+
*/
|
|
9679
|
+
refreshedAtMs: number;
|
|
9680
|
+
/**
|
|
9681
|
+
* Entries.
|
|
9682
|
+
*/
|
|
9683
|
+
connectors: ConnectorDiscoveryCatalogEntry[];
|
|
9684
|
+
}
|
|
9291
9685
|
/**
|
|
9292
9686
|
* Requests authoritative Connector-to-MCP reconciliation for the pinned account.
|
|
9293
9687
|
*
|
|
@@ -9420,6 +9814,10 @@ export interface CurrentModel {
|
|
|
9420
9814
|
* Currently active model identifier
|
|
9421
9815
|
*/
|
|
9422
9816
|
modelId?: string;
|
|
9817
|
+
/**
|
|
9818
|
+
* Captured base model to restore when leaving plan mode. Omitted outside plan mode or when no plan override has captured a base model. Persistent agent model requirements apply to this model rather than the temporary plan model.
|
|
9819
|
+
*/
|
|
9820
|
+
planBaseModelId?: string;
|
|
9423
9821
|
/**
|
|
9424
9822
|
* Reasoning effort level currently applied to the active model, when one is set. Reads `Session.getReasoningEffort()` synchronously after `getSelectedModel()` resolves so the two values are reported as a snapshot.
|
|
9425
9823
|
*/
|
|
@@ -9474,6 +9872,42 @@ export interface CurrentToolMetadata {
|
|
|
9474
9872
|
*/
|
|
9475
9873
|
deferLoading?: boolean;
|
|
9476
9874
|
}
|
|
9875
|
+
/**
|
|
9876
|
+
* Result of one customization reload component.
|
|
9877
|
+
*
|
|
9878
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9879
|
+
* via the `definition` "CustomizationReloadOutcome".
|
|
9880
|
+
*/
|
|
9881
|
+
/** @experimental */
|
|
9882
|
+
export interface CustomizationReloadOutcome {
|
|
9883
|
+
subsystem: CustomizationReloadSubsystem;
|
|
9884
|
+
status: CustomizationReloadStatus;
|
|
9885
|
+
/**
|
|
9886
|
+
* Reason for a skipped component or description of a failure, when available
|
|
9887
|
+
*/
|
|
9888
|
+
detail?: string | null;
|
|
9889
|
+
}
|
|
9890
|
+
/**
|
|
9891
|
+
* Results of reloading discovered session customizations. Inspect outcomes for reloaded, skipped, or failed subsystems; a rejection may follow partial mutation. Changes to the model-facing prompt and tools apply on the next turn.
|
|
9892
|
+
*
|
|
9893
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9894
|
+
* via the `definition` "CustomizationsReloadResult".
|
|
9895
|
+
*/
|
|
9896
|
+
/** @experimental */
|
|
9897
|
+
export interface CustomizationsReloadResult {
|
|
9898
|
+
/**
|
|
9899
|
+
* Warnings from skill discovery
|
|
9900
|
+
*/
|
|
9901
|
+
warnings: string[];
|
|
9902
|
+
/**
|
|
9903
|
+
* Errors from any component that could not be refreshed
|
|
9904
|
+
*/
|
|
9905
|
+
errors: string[];
|
|
9906
|
+
/**
|
|
9907
|
+
* Outcome of each component in reload order; a skipped component was not configured or loaded
|
|
9908
|
+
*/
|
|
9909
|
+
outcomes: CustomizationReloadOutcome[];
|
|
9910
|
+
}
|
|
9477
9911
|
/**
|
|
9478
9912
|
* A file included in the session debug bundle.
|
|
9479
9913
|
*
|
|
@@ -9925,98 +10359,290 @@ export interface McpSourcePlugin {
|
|
|
9925
10359
|
version?: string;
|
|
9926
10360
|
}
|
|
9927
10361
|
/**
|
|
9928
|
-
*
|
|
10362
|
+
* A model offered for agent conversations. Missing capability metadata does not disqualify a candidate. Models known to be incompatible, such as embedding-only models, are excluded by the adapter.
|
|
9929
10363
|
*
|
|
9930
10364
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9931
|
-
* via the `definition` "
|
|
10365
|
+
* via the `definition` "DiscoveredModel".
|
|
9932
10366
|
*/
|
|
9933
10367
|
/** @experimental */
|
|
9934
|
-
export interface
|
|
10368
|
+
export interface DiscoveredModel {
|
|
9935
10369
|
/**
|
|
9936
|
-
*
|
|
10370
|
+
* Provider-native model identifier.
|
|
9937
10371
|
*/
|
|
9938
|
-
|
|
10372
|
+
id: string;
|
|
9939
10373
|
/**
|
|
9940
|
-
*
|
|
10374
|
+
* Provider-reported display name.
|
|
9941
10375
|
*/
|
|
9942
|
-
|
|
9943
|
-
|
|
9944
|
-
/** @experimental */
|
|
9945
|
-
export interface UnsupportedEnqueueCommandResult {
|
|
10376
|
+
name?: string;
|
|
10377
|
+
provenance: ModelProviderProvenance;
|
|
9946
10378
|
/**
|
|
9947
|
-
*
|
|
10379
|
+
* Provider-reported artifact digest.
|
|
9948
10380
|
*/
|
|
9949
|
-
|
|
10381
|
+
digest?: string;
|
|
9950
10382
|
/**
|
|
9951
|
-
*
|
|
10383
|
+
* Provider-reported last-modified timestamp.
|
|
9952
10384
|
*/
|
|
9953
|
-
|
|
10385
|
+
modifiedAt?: string;
|
|
10386
|
+
/**
|
|
10387
|
+
* Provider-reported artifact size in bytes.
|
|
10388
|
+
*/
|
|
10389
|
+
sizeBytes?: number;
|
|
10390
|
+
details: ModelArtifactDetails;
|
|
10391
|
+
capabilities: ModelCapabilities;
|
|
10392
|
+
/**
|
|
10393
|
+
* Non-fatal warnings encountered while enriching this model.
|
|
10394
|
+
*/
|
|
10395
|
+
warnings: ModelProviderWarning[];
|
|
9954
10396
|
}
|
|
9955
10397
|
/**
|
|
9956
|
-
*
|
|
10398
|
+
* Attribution for the adapter that produced a provider row.
|
|
9957
10399
|
*
|
|
9958
10400
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9959
|
-
* via the `definition` "
|
|
10401
|
+
* via the `definition` "ModelProviderProvenance".
|
|
9960
10402
|
*/
|
|
9961
10403
|
/** @experimental */
|
|
9962
|
-
export interface
|
|
10404
|
+
export interface ModelProviderProvenance {
|
|
9963
10405
|
/**
|
|
9964
|
-
*
|
|
10406
|
+
* Stable opaque adapter identity from the effective catalog. Treat this as a whole identifier, not a parseable owner or kind.
|
|
9965
10407
|
*/
|
|
9966
|
-
|
|
10408
|
+
adapterId: string;
|
|
9967
10409
|
/**
|
|
9968
|
-
*
|
|
10410
|
+
* Descriptive provider family that produced this row; not a routing key.
|
|
9969
10411
|
*/
|
|
9970
|
-
|
|
10412
|
+
providerKind: string;
|
|
10413
|
+
source: ModelProviderProvenanceSource;
|
|
9971
10414
|
/**
|
|
9972
|
-
*
|
|
9973
|
-
*/
|
|
9974
|
-
redirectUri: string;
|
|
9975
|
-
/**
|
|
9976
|
-
* Exact delegated scopes to request.
|
|
9977
|
-
*
|
|
9978
|
-
* @minItems 1
|
|
10415
|
+
* Stable contributor identifier when the adapter has an owner outside the runtime. Independent of the contribution mechanism and not a routing key.
|
|
9979
10416
|
*/
|
|
9980
|
-
|
|
9981
|
-
interaction: EntraTokenInteraction;
|
|
10417
|
+
ownerId?: string;
|
|
9982
10418
|
/**
|
|
9983
|
-
*
|
|
10419
|
+
* Human-readable contributor name, not the adapter display name.
|
|
9984
10420
|
*/
|
|
9985
|
-
|
|
10421
|
+
ownerDisplayName?: string;
|
|
9986
10422
|
}
|
|
9987
10423
|
/**
|
|
9988
|
-
*
|
|
10424
|
+
* Provider-reported model artifact metadata.
|
|
9989
10425
|
*
|
|
9990
10426
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9991
|
-
* via the `definition` "
|
|
10427
|
+
* via the `definition` "ModelArtifactDetails".
|
|
9992
10428
|
*/
|
|
9993
10429
|
/** @experimental */
|
|
9994
|
-
export interface
|
|
10430
|
+
export interface ModelArtifactDetails {
|
|
9995
10431
|
/**
|
|
9996
|
-
*
|
|
10432
|
+
* Artifact format, such as `gguf`.
|
|
9997
10433
|
*/
|
|
9998
|
-
|
|
10434
|
+
format?: string;
|
|
9999
10435
|
/**
|
|
10000
|
-
*
|
|
10436
|
+
* Primary model family.
|
|
10001
10437
|
*/
|
|
10002
|
-
|
|
10438
|
+
family?: string;
|
|
10003
10439
|
/**
|
|
10004
|
-
*
|
|
10440
|
+
* Provider-reported model families.
|
|
10005
10441
|
*/
|
|
10006
|
-
|
|
10442
|
+
families?: string[];
|
|
10007
10443
|
/**
|
|
10008
|
-
*
|
|
10444
|
+
* Provider-reported parameter count label.
|
|
10009
10445
|
*/
|
|
10010
|
-
|
|
10446
|
+
parameterSize?: string;
|
|
10447
|
+
/**
|
|
10448
|
+
* Provider-reported quantization label.
|
|
10449
|
+
*/
|
|
10450
|
+
quantization?: string;
|
|
10451
|
+
/**
|
|
10452
|
+
* Provider-reported model architecture.
|
|
10453
|
+
*/
|
|
10454
|
+
architecture?: string;
|
|
10455
|
+
/**
|
|
10456
|
+
* Provider-reported tokenizer.
|
|
10457
|
+
*/
|
|
10458
|
+
tokenizer?: string;
|
|
10011
10459
|
}
|
|
10012
10460
|
/**
|
|
10013
|
-
*
|
|
10461
|
+
* Model capabilities and limits
|
|
10014
10462
|
*
|
|
10015
10463
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10016
|
-
* via the `definition` "
|
|
10464
|
+
* via the `definition` "ModelCapabilities".
|
|
10017
10465
|
*/
|
|
10018
10466
|
/** @experimental */
|
|
10019
|
-
export interface
|
|
10467
|
+
export interface ModelCapabilities {
|
|
10468
|
+
supports?: ModelCapabilitiesSupports;
|
|
10469
|
+
limits?: ModelCapabilitiesLimits;
|
|
10470
|
+
}
|
|
10471
|
+
/**
|
|
10472
|
+
* Feature flags indicating what the model supports
|
|
10473
|
+
*
|
|
10474
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10475
|
+
* via the `definition` "ModelCapabilitiesSupports".
|
|
10476
|
+
*/
|
|
10477
|
+
/** @experimental */
|
|
10478
|
+
export interface ModelCapabilitiesSupports {
|
|
10479
|
+
/**
|
|
10480
|
+
* Whether the model supports provider-native thinking. Independent of configurable reasoning effort; omission means unknown.
|
|
10481
|
+
*/
|
|
10482
|
+
thinking?: boolean;
|
|
10483
|
+
/**
|
|
10484
|
+
* Whether this model supports vision/image input
|
|
10485
|
+
*/
|
|
10486
|
+
vision?: boolean;
|
|
10487
|
+
/**
|
|
10488
|
+
* Whether this model supports canonical tool calling
|
|
10489
|
+
*/
|
|
10490
|
+
toolCalls?: boolean;
|
|
10491
|
+
/**
|
|
10492
|
+
* Whether this model supports reasoning effort configuration
|
|
10493
|
+
*/
|
|
10494
|
+
reasoningEffort?: boolean;
|
|
10495
|
+
adaptive_thinking?: AdaptiveThinkingSupport;
|
|
10496
|
+
}
|
|
10497
|
+
/**
|
|
10498
|
+
* Token limits for prompts, outputs, and context window
|
|
10499
|
+
*
|
|
10500
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10501
|
+
* via the `definition` "ModelCapabilitiesLimits".
|
|
10502
|
+
*/
|
|
10503
|
+
/** @experimental */
|
|
10504
|
+
export interface ModelCapabilitiesLimits {
|
|
10505
|
+
/**
|
|
10506
|
+
* Maximum number of prompt/input tokens
|
|
10507
|
+
*/
|
|
10508
|
+
max_prompt_tokens?: number;
|
|
10509
|
+
/**
|
|
10510
|
+
* Maximum number of output/completion tokens
|
|
10511
|
+
*/
|
|
10512
|
+
max_output_tokens?: number;
|
|
10513
|
+
/**
|
|
10514
|
+
* Maximum total context window size in tokens
|
|
10515
|
+
*/
|
|
10516
|
+
max_context_window_tokens?: number;
|
|
10517
|
+
vision?: ModelCapabilitiesLimitsVision;
|
|
10518
|
+
}
|
|
10519
|
+
/**
|
|
10520
|
+
* Vision-specific limits
|
|
10521
|
+
*
|
|
10522
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10523
|
+
* via the `definition` "ModelCapabilitiesLimitsVision".
|
|
10524
|
+
*/
|
|
10525
|
+
/** @experimental */
|
|
10526
|
+
export interface ModelCapabilitiesLimitsVision {
|
|
10527
|
+
/**
|
|
10528
|
+
* MIME types the model accepts
|
|
10529
|
+
*/
|
|
10530
|
+
supported_media_types: string[];
|
|
10531
|
+
/**
|
|
10532
|
+
* Maximum number of images per prompt
|
|
10533
|
+
*/
|
|
10534
|
+
max_prompt_images: number;
|
|
10535
|
+
/**
|
|
10536
|
+
* Maximum image size in bytes
|
|
10537
|
+
*/
|
|
10538
|
+
max_prompt_image_size: number;
|
|
10539
|
+
}
|
|
10540
|
+
/**
|
|
10541
|
+
* A non-fatal provider observation warning.
|
|
10542
|
+
*
|
|
10543
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10544
|
+
* via the `definition` "ModelProviderWarning".
|
|
10545
|
+
*/
|
|
10546
|
+
/** @experimental */
|
|
10547
|
+
export interface ModelProviderWarning {
|
|
10548
|
+
/**
|
|
10549
|
+
* Machine-readable warning code.
|
|
10550
|
+
*/
|
|
10551
|
+
code: string;
|
|
10552
|
+
/**
|
|
10553
|
+
* Human-readable warning message.
|
|
10554
|
+
*/
|
|
10555
|
+
message: string;
|
|
10556
|
+
}
|
|
10557
|
+
/**
|
|
10558
|
+
* Models offered for agent conversations by one provider instance. Adapters exclude known-incompatible models, but retain candidates with unknown capabilities. Listing does not guarantee compatibility.
|
|
10559
|
+
*
|
|
10560
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10561
|
+
* via the `definition` "DiscoveredModelList".
|
|
10562
|
+
*/
|
|
10563
|
+
/** @experimental */
|
|
10564
|
+
export interface DiscoveredModelList {
|
|
10565
|
+
outcome: ModelProviderOperationOutcome;
|
|
10566
|
+
/**
|
|
10567
|
+
* Provider-native models in provider order.
|
|
10568
|
+
*/
|
|
10569
|
+
models: DiscoveredModel[];
|
|
10570
|
+
}
|
|
10571
|
+
/**
|
|
10572
|
+
* Typed provider-operation outcome. Use the code for control flow and the optional message for display.
|
|
10573
|
+
*
|
|
10574
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10575
|
+
* via the `definition` "ModelProviderOperationOutcome".
|
|
10576
|
+
*/
|
|
10577
|
+
/** @experimental */
|
|
10578
|
+
export interface ModelProviderOperationOutcome {
|
|
10579
|
+
code: ModelProviderOperationOutcomeCode;
|
|
10580
|
+
/**
|
|
10581
|
+
* Human-readable detail for non-success outcomes.
|
|
10582
|
+
*/
|
|
10583
|
+
message?: string;
|
|
10584
|
+
}
|
|
10585
|
+
/**
|
|
10586
|
+
* Slash-prefixed command string to enqueue for FIFO processing.
|
|
10587
|
+
*
|
|
10588
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10589
|
+
* via the `definition` "EnqueueCommandParams".
|
|
10590
|
+
*/
|
|
10591
|
+
/** @experimental */
|
|
10592
|
+
export interface EnqueueCommandParams {
|
|
10593
|
+
/**
|
|
10594
|
+
* Slash-prefixed command string to enqueue, e.g. '/compact' or '/model gpt-4'. Queued FIFO with any in-flight items; if the session is idle, processing kicks off immediately.
|
|
10595
|
+
*/
|
|
10596
|
+
command: string;
|
|
10597
|
+
/**
|
|
10598
|
+
* Optional user-facing text for the queue row. The command string is shown when omitted.
|
|
10599
|
+
*/
|
|
10600
|
+
displayText?: string | null;
|
|
10601
|
+
}
|
|
10602
|
+
/** @experimental */
|
|
10603
|
+
export interface UnsupportedEnqueueCommandResult {
|
|
10604
|
+
/**
|
|
10605
|
+
* False because the target session does not support local command queueing (e.g. remote sessions).
|
|
10606
|
+
*/
|
|
10607
|
+
queued: false;
|
|
10608
|
+
/**
|
|
10609
|
+
* Legacy null queue ID accepted for compatibility with older runtimes.
|
|
10610
|
+
*/
|
|
10611
|
+
queueId?: null;
|
|
10612
|
+
}
|
|
10613
|
+
/**
|
|
10614
|
+
* Hosting capabilities and session capacity advertised by an environment.
|
|
10615
|
+
*
|
|
10616
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10617
|
+
* via the `definition` "EnvironmentCapabilities".
|
|
10618
|
+
*/
|
|
10619
|
+
/** @experimental */
|
|
10620
|
+
export interface EnvironmentCapabilities {
|
|
10621
|
+
/**
|
|
10622
|
+
* Advertised Agent Host Protocol version.
|
|
10623
|
+
*/
|
|
10624
|
+
ahpVersion?: string;
|
|
10625
|
+
/**
|
|
10626
|
+
* Feature identifiers advertised by the environment.
|
|
10627
|
+
*/
|
|
10628
|
+
features: string[];
|
|
10629
|
+
/**
|
|
10630
|
+
* Maximum session capacity, when advertised.
|
|
10631
|
+
*/
|
|
10632
|
+
maxSessions?: number;
|
|
10633
|
+
/**
|
|
10634
|
+
* Current session count, when advertised.
|
|
10635
|
+
*/
|
|
10636
|
+
currentSessions?: number;
|
|
10637
|
+
}
|
|
10638
|
+
/**
|
|
10639
|
+
* Identify a user-managed Mission Control environment to delete.
|
|
10640
|
+
*
|
|
10641
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10642
|
+
* via the `definition` "EnvironmentsDeleteRequest".
|
|
10643
|
+
*/
|
|
10644
|
+
/** @experimental */
|
|
10645
|
+
export interface EnvironmentsDeleteRequest {
|
|
10020
10646
|
/**
|
|
10021
10647
|
* User-managed environment to delete. GitHub-managed environments cannot be deleted.
|
|
10022
10648
|
*/
|
|
@@ -10718,6 +11344,27 @@ export interface FolderTrustCheckResult {
|
|
|
10718
11344
|
*/
|
|
10719
11345
|
trusted: boolean;
|
|
10720
11346
|
}
|
|
11347
|
+
/**
|
|
11348
|
+
* Owner, name, and host of a GitHub repository, as resolved from a git remote URL.
|
|
11349
|
+
*
|
|
11350
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
11351
|
+
* via the `definition` "GitHubRepositoryIdentity".
|
|
11352
|
+
*/
|
|
11353
|
+
/** @experimental */
|
|
11354
|
+
export interface GitHubRepositoryIdentity {
|
|
11355
|
+
/**
|
|
11356
|
+
* Repository owner login (user or organization).
|
|
11357
|
+
*/
|
|
11358
|
+
owner: string;
|
|
11359
|
+
/**
|
|
11360
|
+
* Repository name, without the owner prefix or the `.git` suffix.
|
|
11361
|
+
*/
|
|
11362
|
+
name: string;
|
|
11363
|
+
/**
|
|
11364
|
+
* Host the remote points at, for example `github.com` or a GitHub Enterprise hostname.
|
|
11365
|
+
*/
|
|
11366
|
+
host: string;
|
|
11367
|
+
}
|
|
10721
11368
|
/**
|
|
10722
11369
|
* Client environment metadata describing the process that produced a telemetry event.
|
|
10723
11370
|
*
|
|
@@ -10868,57 +11515,174 @@ export interface GitHubTokenAcquireRequest {
|
|
|
10868
11515
|
reason: GitHubTokenAcquireReason;
|
|
10869
11516
|
}
|
|
10870
11517
|
/**
|
|
10871
|
-
*
|
|
11518
|
+
* Installed plugin record from global state, with marketplace, version, install time, enabled state, cache path, and source.
|
|
10872
11519
|
*
|
|
10873
11520
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10874
|
-
* via the `definition` "
|
|
11521
|
+
* via the `definition` "InstalledPlugin".
|
|
10875
11522
|
*/
|
|
10876
11523
|
/** @experimental */
|
|
10877
|
-
export interface
|
|
11524
|
+
export interface InstalledPlugin {
|
|
10878
11525
|
/**
|
|
10879
|
-
*
|
|
11526
|
+
* Plugin name
|
|
10880
11527
|
*/
|
|
10881
|
-
|
|
10882
|
-
result?: ExternalToolResult;
|
|
11528
|
+
name: string;
|
|
10883
11529
|
/**
|
|
10884
|
-
*
|
|
11530
|
+
* Marketplace the plugin came from (empty string for direct repo installs)
|
|
10885
11531
|
*/
|
|
10886
|
-
|
|
10887
|
-
}
|
|
10888
|
-
/**
|
|
10889
|
-
* Indicates whether the external tool call result was handled successfully.
|
|
10890
|
-
*
|
|
10891
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10892
|
-
* via the `definition` "HandlePendingToolCallResult".
|
|
10893
|
-
*/
|
|
10894
|
-
/** @experimental */
|
|
10895
|
-
export interface HandlePendingToolCallResult {
|
|
11532
|
+
marketplace: string;
|
|
10896
11533
|
/**
|
|
10897
|
-
*
|
|
11534
|
+
* Version installed (if available)
|
|
10898
11535
|
*/
|
|
10899
|
-
|
|
11536
|
+
version?: string;
|
|
11537
|
+
/**
|
|
11538
|
+
* Installation timestamp
|
|
11539
|
+
*/
|
|
11540
|
+
installed_at: string;
|
|
11541
|
+
/**
|
|
11542
|
+
* Whether the plugin is currently enabled
|
|
11543
|
+
*/
|
|
11544
|
+
enabled: boolean;
|
|
11545
|
+
/**
|
|
11546
|
+
* Path where the plugin is cached locally
|
|
11547
|
+
*/
|
|
11548
|
+
cache_path?: string;
|
|
11549
|
+
source?: InstalledPluginSource;
|
|
11550
|
+
/**
|
|
11551
|
+
* Per-plugin source fingerprint (a SHA-256 hash of the plugin's catalog source spec plus its resolved source subtree — NOT a Git commit SHA) captured at marketplace install/update time. Auto-update compares it against the freshly recomputed fingerprint to detect a content change that does not bump the version. Absent for pre-existing installs and for direct (non-marketplace) installs.
|
|
11552
|
+
*/
|
|
11553
|
+
source_sha?: string;
|
|
11554
|
+
/**
|
|
11555
|
+
* Absolute path of the marketplace directory a live plugin was resolved from. Present only on live, never-persisted records — those synthesized at session start for a directory/local marketplace, whose cache_path points at the real plugin directory on disk rather than a copy under the installed-plugins cache. Its presence is what marks a record as live, and no record carrying it is ever written to the persisted installedPlugins key.
|
|
11556
|
+
*/
|
|
11557
|
+
installed_from?: string;
|
|
10900
11558
|
}
|
|
10901
11559
|
/**
|
|
10902
|
-
*
|
|
11560
|
+
* Source descriptor for a direct GitHub plugin install, with `owner/repo`, optional ref or full commit SHA, and optional subpath.
|
|
10903
11561
|
*
|
|
10904
11562
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10905
|
-
* via the `definition` "
|
|
11563
|
+
* via the `definition` "InstalledPluginSourceGitHub".
|
|
10906
11564
|
*/
|
|
10907
11565
|
/** @experimental */
|
|
10908
|
-
export interface
|
|
11566
|
+
export interface InstalledPluginSourceGitHub {
|
|
10909
11567
|
/**
|
|
10910
|
-
*
|
|
11568
|
+
* Constant value. Always "github".
|
|
10911
11569
|
*/
|
|
10912
|
-
|
|
11570
|
+
source: "github";
|
|
11571
|
+
/**
|
|
11572
|
+
* GitHub repository in `owner/repo` form.
|
|
11573
|
+
*/
|
|
11574
|
+
repo: string;
|
|
11575
|
+
/**
|
|
11576
|
+
* Optional Git ref to resolve.
|
|
11577
|
+
*/
|
|
11578
|
+
ref?: string;
|
|
11579
|
+
/**
|
|
11580
|
+
* Optional full 40-character hexadecimal commit SHA.
|
|
11581
|
+
*/
|
|
11582
|
+
sha?: string;
|
|
11583
|
+
/**
|
|
11584
|
+
* Optional repository-relative path to the plugin.
|
|
11585
|
+
*/
|
|
11586
|
+
path?: string;
|
|
10913
11587
|
}
|
|
10914
11588
|
/**
|
|
10915
|
-
*
|
|
11589
|
+
* Source descriptor for a direct URL plugin install, with URL, optional ref or full commit SHA, and optional subpath.
|
|
10916
11590
|
*
|
|
10917
11591
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10918
|
-
* via the `definition` "
|
|
11592
|
+
* via the `definition` "InstalledPluginSourceUrl".
|
|
10919
11593
|
*/
|
|
10920
11594
|
/** @experimental */
|
|
10921
|
-
export interface
|
|
11595
|
+
export interface InstalledPluginSourceUrl {
|
|
11596
|
+
/**
|
|
11597
|
+
* Constant value. Always "url".
|
|
11598
|
+
*/
|
|
11599
|
+
source: "url";
|
|
11600
|
+
/**
|
|
11601
|
+
* URL of the plugin source.
|
|
11602
|
+
*/
|
|
11603
|
+
url: string;
|
|
11604
|
+
/**
|
|
11605
|
+
* Optional Git ref to resolve.
|
|
11606
|
+
*/
|
|
11607
|
+
ref?: string;
|
|
11608
|
+
/**
|
|
11609
|
+
* Optional full 40-character hexadecimal commit SHA.
|
|
11610
|
+
*/
|
|
11611
|
+
sha?: string;
|
|
11612
|
+
/**
|
|
11613
|
+
* Optional source-relative path to the plugin.
|
|
11614
|
+
*/
|
|
11615
|
+
path?: string;
|
|
11616
|
+
}
|
|
11617
|
+
/**
|
|
11618
|
+
* Source descriptor for a direct local plugin install, with a local filesystem path.
|
|
11619
|
+
*
|
|
11620
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
11621
|
+
* via the `definition` "InstalledPluginSourceLocal".
|
|
11622
|
+
*/
|
|
11623
|
+
/** @experimental */
|
|
11624
|
+
export interface InstalledPluginSourceLocal {
|
|
11625
|
+
/**
|
|
11626
|
+
* Constant value. Always "local".
|
|
11627
|
+
*/
|
|
11628
|
+
source: "local";
|
|
11629
|
+
/**
|
|
11630
|
+
* Local filesystem path to the plugin.
|
|
11631
|
+
*/
|
|
11632
|
+
path: string;
|
|
11633
|
+
}
|
|
11634
|
+
/**
|
|
11635
|
+
* Pending external tool call request ID, with the tool result or an error describing why it failed.
|
|
11636
|
+
*
|
|
11637
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
11638
|
+
* via the `definition` "HandlePendingToolCallRequest".
|
|
11639
|
+
*/
|
|
11640
|
+
/** @experimental */
|
|
11641
|
+
export interface HandlePendingToolCallRequest {
|
|
11642
|
+
/**
|
|
11643
|
+
* Request ID of the pending tool call
|
|
11644
|
+
*/
|
|
11645
|
+
requestId: string;
|
|
11646
|
+
result?: ExternalToolResult;
|
|
11647
|
+
/**
|
|
11648
|
+
* Error message if the tool call failed
|
|
11649
|
+
*/
|
|
11650
|
+
error?: string;
|
|
11651
|
+
}
|
|
11652
|
+
/**
|
|
11653
|
+
* Indicates whether the external tool call result was handled successfully.
|
|
11654
|
+
*
|
|
11655
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
11656
|
+
* via the `definition` "HandlePendingToolCallResult".
|
|
11657
|
+
*/
|
|
11658
|
+
/** @experimental */
|
|
11659
|
+
export interface HandlePendingToolCallResult {
|
|
11660
|
+
/**
|
|
11661
|
+
* Whether the tool call result was handled successfully
|
|
11662
|
+
*/
|
|
11663
|
+
success: boolean;
|
|
11664
|
+
}
|
|
11665
|
+
/**
|
|
11666
|
+
* Indicates whether an in-progress manual compaction was aborted.
|
|
11667
|
+
*
|
|
11668
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
11669
|
+
* via the `definition` "HistoryAbortManualCompactionResult".
|
|
11670
|
+
*/
|
|
11671
|
+
/** @experimental */
|
|
11672
|
+
export interface HistoryAbortManualCompactionResult {
|
|
11673
|
+
/**
|
|
11674
|
+
* Whether an in-progress manual compaction was aborted. False when no manual compaction was running, when its abort controller was already aborted, or when the session is remote.
|
|
11675
|
+
*/
|
|
11676
|
+
aborted: boolean;
|
|
11677
|
+
}
|
|
11678
|
+
/**
|
|
11679
|
+
* Indicates whether an in-progress background compaction was cancelled.
|
|
11680
|
+
*
|
|
11681
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
11682
|
+
* via the `definition` "HistoryCancelBackgroundCompactionResult".
|
|
11683
|
+
*/
|
|
11684
|
+
/** @experimental */
|
|
11685
|
+
export interface HistoryCancelBackgroundCompactionResult {
|
|
10922
11686
|
/**
|
|
10923
11687
|
* Whether an in-progress background compaction was cancelled. False when no compaction was running, when the session is remote, or when the underlying processor was unavailable.
|
|
10924
11688
|
*/
|
|
@@ -12165,123 +12929,6 @@ export interface InstallationConfirmationResponse {
|
|
|
12165
12929
|
reviewFingerprint: string;
|
|
12166
12930
|
decision: InstallationDecision;
|
|
12167
12931
|
}
|
|
12168
|
-
/**
|
|
12169
|
-
* Installed plugin record from global state, with marketplace, version, install time, enabled state, cache path, and source.
|
|
12170
|
-
*
|
|
12171
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
12172
|
-
* via the `definition` "InstalledPlugin".
|
|
12173
|
-
*/
|
|
12174
|
-
/** @experimental */
|
|
12175
|
-
export interface InstalledPlugin {
|
|
12176
|
-
/**
|
|
12177
|
-
* Plugin name
|
|
12178
|
-
*/
|
|
12179
|
-
name: string;
|
|
12180
|
-
/**
|
|
12181
|
-
* Marketplace the plugin came from (empty string for direct repo installs)
|
|
12182
|
-
*/
|
|
12183
|
-
marketplace: string;
|
|
12184
|
-
/**
|
|
12185
|
-
* Version installed (if available)
|
|
12186
|
-
*/
|
|
12187
|
-
version?: string;
|
|
12188
|
-
/**
|
|
12189
|
-
* Installation timestamp
|
|
12190
|
-
*/
|
|
12191
|
-
installed_at: string;
|
|
12192
|
-
/**
|
|
12193
|
-
* Whether the plugin is currently enabled
|
|
12194
|
-
*/
|
|
12195
|
-
enabled: boolean;
|
|
12196
|
-
/**
|
|
12197
|
-
* Path where the plugin is cached locally
|
|
12198
|
-
*/
|
|
12199
|
-
cache_path?: string;
|
|
12200
|
-
source?: InstalledPluginSource;
|
|
12201
|
-
/**
|
|
12202
|
-
* Per-plugin source fingerprint (a SHA-256 hash of the plugin's catalog source spec plus its resolved source subtree — NOT a Git commit SHA) captured at marketplace install/update time. Auto-update compares it against the freshly recomputed fingerprint to detect a content change that does not bump the version. Absent for pre-existing installs and for direct (non-marketplace) installs.
|
|
12203
|
-
*/
|
|
12204
|
-
source_sha?: string;
|
|
12205
|
-
/**
|
|
12206
|
-
* Absolute path of the marketplace directory a live plugin was resolved from. Present only on live, never-persisted records — those synthesized at session start for a directory/local marketplace, whose cache_path points at the real plugin directory on disk rather than a copy under the installed-plugins cache. Its presence is what marks a record as live, and no record carrying it is ever written to the persisted installedPlugins key.
|
|
12207
|
-
*/
|
|
12208
|
-
installed_from?: string;
|
|
12209
|
-
}
|
|
12210
|
-
/**
|
|
12211
|
-
* Source descriptor for a direct GitHub plugin install, with `owner/repo`, optional ref or full commit SHA, and optional subpath.
|
|
12212
|
-
*
|
|
12213
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
12214
|
-
* via the `definition` "InstalledPluginSourceGitHub".
|
|
12215
|
-
*/
|
|
12216
|
-
/** @experimental */
|
|
12217
|
-
export interface InstalledPluginSourceGitHub {
|
|
12218
|
-
/**
|
|
12219
|
-
* Constant value. Always "github".
|
|
12220
|
-
*/
|
|
12221
|
-
source: "github";
|
|
12222
|
-
/**
|
|
12223
|
-
* GitHub repository in `owner/repo` form.
|
|
12224
|
-
*/
|
|
12225
|
-
repo: string;
|
|
12226
|
-
/**
|
|
12227
|
-
* Optional Git ref to resolve.
|
|
12228
|
-
*/
|
|
12229
|
-
ref?: string;
|
|
12230
|
-
/**
|
|
12231
|
-
* Optional full 40-character hexadecimal commit SHA.
|
|
12232
|
-
*/
|
|
12233
|
-
sha?: string;
|
|
12234
|
-
/**
|
|
12235
|
-
* Optional repository-relative path to the plugin.
|
|
12236
|
-
*/
|
|
12237
|
-
path?: string;
|
|
12238
|
-
}
|
|
12239
|
-
/**
|
|
12240
|
-
* Source descriptor for a direct URL plugin install, with URL, optional ref or full commit SHA, and optional subpath.
|
|
12241
|
-
*
|
|
12242
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
12243
|
-
* via the `definition` "InstalledPluginSourceUrl".
|
|
12244
|
-
*/
|
|
12245
|
-
/** @experimental */
|
|
12246
|
-
export interface InstalledPluginSourceUrl {
|
|
12247
|
-
/**
|
|
12248
|
-
* Constant value. Always "url".
|
|
12249
|
-
*/
|
|
12250
|
-
source: "url";
|
|
12251
|
-
/**
|
|
12252
|
-
* URL of the plugin source.
|
|
12253
|
-
*/
|
|
12254
|
-
url: string;
|
|
12255
|
-
/**
|
|
12256
|
-
* Optional Git ref to resolve.
|
|
12257
|
-
*/
|
|
12258
|
-
ref?: string;
|
|
12259
|
-
/**
|
|
12260
|
-
* Optional full 40-character hexadecimal commit SHA.
|
|
12261
|
-
*/
|
|
12262
|
-
sha?: string;
|
|
12263
|
-
/**
|
|
12264
|
-
* Optional source-relative path to the plugin.
|
|
12265
|
-
*/
|
|
12266
|
-
path?: string;
|
|
12267
|
-
}
|
|
12268
|
-
/**
|
|
12269
|
-
* Source descriptor for a direct local plugin install, with a local filesystem path.
|
|
12270
|
-
*
|
|
12271
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
12272
|
-
* via the `definition` "InstalledPluginSourceLocal".
|
|
12273
|
-
*/
|
|
12274
|
-
/** @experimental */
|
|
12275
|
-
export interface InstalledPluginSourceLocal {
|
|
12276
|
-
/**
|
|
12277
|
-
* Constant value. Always "local".
|
|
12278
|
-
*/
|
|
12279
|
-
source: "local";
|
|
12280
|
-
/**
|
|
12281
|
-
* Local filesystem path to the plugin.
|
|
12282
|
-
*/
|
|
12283
|
-
path: string;
|
|
12284
|
-
}
|
|
12285
12932
|
/**
|
|
12286
12933
|
* Information about an installed plugin tracked in global state.
|
|
12287
12934
|
*
|
|
@@ -13916,6 +14563,64 @@ export interface McpConfigUpdateRequest {
|
|
|
13916
14563
|
name: string;
|
|
13917
14564
|
config: McpSerializableServerConfig;
|
|
13918
14565
|
}
|
|
14566
|
+
/**
|
|
14567
|
+
* Effective MCP configuration entry. Configuration enablement is distinct from the optional live observation.
|
|
14568
|
+
*
|
|
14569
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14570
|
+
* via the `definition` "McpConfiguredServer".
|
|
14571
|
+
*/
|
|
14572
|
+
/** @experimental */
|
|
14573
|
+
export interface McpConfiguredServer {
|
|
14574
|
+
/**
|
|
14575
|
+
* Server name (config key)
|
|
14576
|
+
*/
|
|
14577
|
+
name: string;
|
|
14578
|
+
/**
|
|
14579
|
+
* Whether this configured server is enabled after session configuration and policy filtering.
|
|
14580
|
+
*/
|
|
14581
|
+
enabled: boolean;
|
|
14582
|
+
source?: McpServerSource;
|
|
14583
|
+
/**
|
|
14584
|
+
* Plugin name that provided this server, when source is plugin.
|
|
14585
|
+
*/
|
|
14586
|
+
sourcePlugin?: string;
|
|
14587
|
+
/**
|
|
14588
|
+
* Plugin version that provided this server, when source is plugin.
|
|
14589
|
+
*/
|
|
14590
|
+
sourcePluginVersion?: string;
|
|
14591
|
+
/**
|
|
14592
|
+
* Human-readable display name supplied by configuration.
|
|
14593
|
+
*/
|
|
14594
|
+
displayName?: string;
|
|
14595
|
+
live?: McpConfiguredServerState;
|
|
14596
|
+
}
|
|
14597
|
+
/**
|
|
14598
|
+
* Observational state for a matching already materialized MCP server.
|
|
14599
|
+
*
|
|
14600
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14601
|
+
* via the `definition` "McpConfiguredServerState".
|
|
14602
|
+
*/
|
|
14603
|
+
/** @experimental */
|
|
14604
|
+
export interface McpConfiguredServerState {
|
|
14605
|
+
status: McpServerStatus;
|
|
14606
|
+
/**
|
|
14607
|
+
* Observed connection error, when the materialized server failed.
|
|
14608
|
+
*/
|
|
14609
|
+
error?: string;
|
|
14610
|
+
}
|
|
14611
|
+
/**
|
|
14612
|
+
* Effective MCP configuration with optional live observations from matching already materialized servers.
|
|
14613
|
+
*
|
|
14614
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14615
|
+
* via the `definition` "McpConfiguredServerList".
|
|
14616
|
+
*/
|
|
14617
|
+
/** @experimental */
|
|
14618
|
+
export interface McpConfiguredServerList {
|
|
14619
|
+
/**
|
|
14620
|
+
* Effective configured MCP servers.
|
|
14621
|
+
*/
|
|
14622
|
+
servers: McpConfiguredServer[];
|
|
14623
|
+
}
|
|
13919
14624
|
/**
|
|
13920
14625
|
* Result of configuring GitHub MCP.
|
|
13921
14626
|
*
|
|
@@ -14476,17 +15181,34 @@ export interface McpOauthCancelLoginResult {
|
|
|
14476
15181
|
cancelled: boolean;
|
|
14477
15182
|
}
|
|
14478
15183
|
/**
|
|
14479
|
-
*
|
|
15184
|
+
* Host-delivered callback for a runtime-managed MCP OAuth login.
|
|
14480
15185
|
*
|
|
14481
15186
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14482
|
-
* via the `definition` "
|
|
15187
|
+
* via the `definition` "McpOauthCompleteRequest".
|
|
14483
15188
|
*/
|
|
14484
15189
|
/** @experimental */
|
|
14485
|
-
export interface
|
|
15190
|
+
export interface McpOauthCompleteRequest {
|
|
14486
15191
|
/**
|
|
14487
|
-
*
|
|
15192
|
+
* Opaque identifier returned by session.mcp.oauth.login for the pending external callback.
|
|
14488
15193
|
*/
|
|
14489
|
-
|
|
15194
|
+
authorizationId: string;
|
|
15195
|
+
/**
|
|
15196
|
+
* Full externally visible HTTPS callback URL received by the host, including the authorization response query parameters. Applications behind a reverse proxy must reconstruct the public URL rather than passing an internal proxy URL.
|
|
15197
|
+
*/
|
|
15198
|
+
callbackUrl: string;
|
|
15199
|
+
}
|
|
15200
|
+
/**
|
|
15201
|
+
* Pending MCP OAuth request ID and host-provided token or cancellation response.
|
|
15202
|
+
*
|
|
15203
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15204
|
+
* via the `definition` "McpOauthHandlePendingRequest".
|
|
15205
|
+
*/
|
|
15206
|
+
/** @experimental */
|
|
15207
|
+
export interface McpOauthHandlePendingRequest {
|
|
15208
|
+
/**
|
|
15209
|
+
* OAuth request identifier from the mcp.oauth_required event
|
|
15210
|
+
*/
|
|
15211
|
+
requestId: string;
|
|
14490
15212
|
result: McpOauthPendingRequestResponse;
|
|
14491
15213
|
}
|
|
14492
15214
|
/**
|
|
@@ -14503,7 +15225,7 @@ export interface McpOauthHandlePendingResult {
|
|
|
14503
15225
|
success: boolean;
|
|
14504
15226
|
}
|
|
14505
15227
|
/**
|
|
14506
|
-
* Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, callback
|
|
15228
|
+
* Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, callback handling, and static OAuth client selection.
|
|
14507
15229
|
*
|
|
14508
15230
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14509
15231
|
* via the `definition` "McpOauthLoginRequest".
|
|
@@ -14539,6 +15261,10 @@ export interface McpOauthLoginRequest {
|
|
|
14539
15261
|
*/
|
|
14540
15262
|
publicClient?: boolean;
|
|
14541
15263
|
grantType?: McpOauthLoginGrantType;
|
|
15264
|
+
/**
|
|
15265
|
+
* Optional externally visible HTTPS redirect URI for a host-managed callback endpoint. When supplied, the runtime still owns discovery, PKCE, token exchange, persistence, and reconnect, but does not bind a loopback listener or terminate HTTPS. The URI must not contain query parameters or a fragment and must be registered for the selected CIMD, DCR, or static OAuth client.
|
|
15266
|
+
*/
|
|
15267
|
+
redirectUri?: string;
|
|
14542
15268
|
/**
|
|
14543
15269
|
* Required for owned login. Consumes the exact prepareLogin handle once.
|
|
14544
15270
|
* Set forceReauth and display options during preparation, not consumption.
|
|
@@ -14563,9 +15289,13 @@ export interface McpOauthLoginResult {
|
|
|
14563
15289
|
loginId?: string;
|
|
14564
15290
|
status?: McpOwnedOauthLoginStatus;
|
|
14565
15291
|
/**
|
|
14566
|
-
* URL the caller should open in a browser to complete OAuth. Omitted when cached tokens were still valid and no browser interaction was needed — the server is already reconnected in that case.
|
|
15292
|
+
* URL the caller should open in a browser to complete OAuth. Omitted when cached tokens were still valid and no browser interaction was needed — the server is already reconnected in that case. For the default loopback flow, the runtime starts its listener before returning. With redirectUri, the host receives the callback and completes it through session.mcp.oauth.complete. The runtime continues the flow in the background and signals completion via session.mcp_server_status_changed.
|
|
14567
15293
|
*/
|
|
14568
15294
|
authorizationUrl?: string;
|
|
15295
|
+
/**
|
|
15296
|
+
* Opaque authorization identifier returned only for a host-managed redirect URI. The runtime also sends it as the OAuth state value, so the callback endpoint can read state and pass it with the full callback URL to session.mcp.oauth.complete.
|
|
15297
|
+
*/
|
|
15298
|
+
authorizationId?: string;
|
|
14569
15299
|
}
|
|
14570
15300
|
/**
|
|
14571
15301
|
* Effect-free preparation bound to the existing local session, requester and installation, with frozen options.
|
|
@@ -14798,6 +15528,235 @@ export interface McpPrepareInstallRequest {
|
|
|
14798
15528
|
source: McpServerCardReference;
|
|
14799
15529
|
secretStorage: McpInstallationSecretStorage;
|
|
14800
15530
|
}
|
|
15531
|
+
/**
|
|
15532
|
+
* An MCP prompt descriptor. Server-provided non-standard fields are exposed under `additionalProperties`.
|
|
15533
|
+
*
|
|
15534
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15535
|
+
* via the `definition` "McpPrompt".
|
|
15536
|
+
*/
|
|
15537
|
+
/** @experimental */
|
|
15538
|
+
export interface McpPrompt {
|
|
15539
|
+
/**
|
|
15540
|
+
* The programmatic name of the prompt
|
|
15541
|
+
*/
|
|
15542
|
+
name: string;
|
|
15543
|
+
/**
|
|
15544
|
+
* Human-readable display title
|
|
15545
|
+
*/
|
|
15546
|
+
title?: string;
|
|
15547
|
+
/**
|
|
15548
|
+
* Description of what this prompt provides
|
|
15549
|
+
*/
|
|
15550
|
+
description?: string;
|
|
15551
|
+
/**
|
|
15552
|
+
* Arguments accepted by the prompt
|
|
15553
|
+
*/
|
|
15554
|
+
arguments?: McpPromptArgument[];
|
|
15555
|
+
/**
|
|
15556
|
+
* Icons associated with this prompt
|
|
15557
|
+
*/
|
|
15558
|
+
icons?: McpPromptIcon[];
|
|
15559
|
+
/**
|
|
15560
|
+
* Prompt-level metadata
|
|
15561
|
+
*/
|
|
15562
|
+
_meta?: {
|
|
15563
|
+
[k: string]: JsonValue | undefined;
|
|
15564
|
+
};
|
|
15565
|
+
/**
|
|
15566
|
+
* Server-provided non-standard descriptor fields
|
|
15567
|
+
*/
|
|
15568
|
+
additionalProperties?: {
|
|
15569
|
+
[k: string]: JsonValue | undefined;
|
|
15570
|
+
};
|
|
15571
|
+
}
|
|
15572
|
+
/**
|
|
15573
|
+
* An argument accepted by an MCP prompt.
|
|
15574
|
+
*
|
|
15575
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15576
|
+
* via the `definition` "McpPromptArgument".
|
|
15577
|
+
*/
|
|
15578
|
+
/** @experimental */
|
|
15579
|
+
export interface McpPromptArgument {
|
|
15580
|
+
/**
|
|
15581
|
+
* Name of the argument
|
|
15582
|
+
*/
|
|
15583
|
+
name: string;
|
|
15584
|
+
/**
|
|
15585
|
+
* Description of the argument
|
|
15586
|
+
*/
|
|
15587
|
+
description?: string;
|
|
15588
|
+
/**
|
|
15589
|
+
* Whether the argument is required; omission is distinct from false
|
|
15590
|
+
*/
|
|
15591
|
+
required?: boolean;
|
|
15592
|
+
/**
|
|
15593
|
+
* Argument-level metadata
|
|
15594
|
+
*/
|
|
15595
|
+
_meta?: {
|
|
15596
|
+
[k: string]: JsonValue | undefined;
|
|
15597
|
+
};
|
|
15598
|
+
/**
|
|
15599
|
+
* Server-provided non-standard argument fields
|
|
15600
|
+
*/
|
|
15601
|
+
additionalProperties?: {
|
|
15602
|
+
[k: string]: JsonValue | undefined;
|
|
15603
|
+
};
|
|
15604
|
+
}
|
|
15605
|
+
/**
|
|
15606
|
+
* An MCP prompt icon with standard size hints and preserved non-standard fields.
|
|
15607
|
+
*
|
|
15608
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15609
|
+
* via the `definition` "McpPromptIcon".
|
|
15610
|
+
*/
|
|
15611
|
+
/** @experimental */
|
|
15612
|
+
export interface McpPromptIcon {
|
|
15613
|
+
/**
|
|
15614
|
+
* Icon URI
|
|
15615
|
+
*/
|
|
15616
|
+
src: string;
|
|
15617
|
+
/**
|
|
15618
|
+
* Icon MIME type, when known
|
|
15619
|
+
*/
|
|
15620
|
+
mimeType?: string;
|
|
15621
|
+
/**
|
|
15622
|
+
* Icon sizes, such as `48x48` or `any`
|
|
15623
|
+
*/
|
|
15624
|
+
sizes?: string[];
|
|
15625
|
+
/**
|
|
15626
|
+
* Theme hint for this icon
|
|
15627
|
+
*/
|
|
15628
|
+
theme?: string;
|
|
15629
|
+
/**
|
|
15630
|
+
* Server-provided non-standard icon fields
|
|
15631
|
+
*/
|
|
15632
|
+
additionalProperties?: {
|
|
15633
|
+
[k: string]: JsonValue | undefined;
|
|
15634
|
+
};
|
|
15635
|
+
}
|
|
15636
|
+
/**
|
|
15637
|
+
* An MCP prompt message with opaque JSON content preserved without flattening or content-type filtering.
|
|
15638
|
+
*
|
|
15639
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15640
|
+
* via the `definition` "McpPromptMessage".
|
|
15641
|
+
*/
|
|
15642
|
+
/** @experimental */
|
|
15643
|
+
export interface McpPromptMessage {
|
|
15644
|
+
role: McpPromptRole;
|
|
15645
|
+
/**
|
|
15646
|
+
* The original MCP content block, including nested metadata and unfamiliar content types
|
|
15647
|
+
*/
|
|
15648
|
+
content: JsonValue;
|
|
15649
|
+
/**
|
|
15650
|
+
* Message-level metadata
|
|
15651
|
+
*/
|
|
15652
|
+
_meta?: {
|
|
15653
|
+
[k: string]: JsonValue | undefined;
|
|
15654
|
+
};
|
|
15655
|
+
/**
|
|
15656
|
+
* Server-provided non-standard message fields
|
|
15657
|
+
*/
|
|
15658
|
+
additionalProperties?: {
|
|
15659
|
+
[k: string]: JsonValue | undefined;
|
|
15660
|
+
};
|
|
15661
|
+
}
|
|
15662
|
+
/**
|
|
15663
|
+
* MCP server, prompt name, and optional string-valued arguments.
|
|
15664
|
+
*
|
|
15665
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15666
|
+
* via the `definition` "McpPromptsGetRequest".
|
|
15667
|
+
*/
|
|
15668
|
+
/** @experimental */
|
|
15669
|
+
export interface McpPromptsGetRequest {
|
|
15670
|
+
/**
|
|
15671
|
+
* Name of the MCP server hosting the prompt
|
|
15672
|
+
*/
|
|
15673
|
+
serverName: string;
|
|
15674
|
+
/**
|
|
15675
|
+
* The programmatic name of the prompt
|
|
15676
|
+
*/
|
|
15677
|
+
promptName: string;
|
|
15678
|
+
/**
|
|
15679
|
+
* String-valued arguments to pass to the prompt
|
|
15680
|
+
*/
|
|
15681
|
+
arguments?: {
|
|
15682
|
+
[k: string]: string | undefined;
|
|
15683
|
+
};
|
|
15684
|
+
}
|
|
15685
|
+
/**
|
|
15686
|
+
* Prompt messages returned by the MCP server without sending them to the model.
|
|
15687
|
+
*
|
|
15688
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15689
|
+
* via the `definition` "McpPromptsGetResult".
|
|
15690
|
+
*/
|
|
15691
|
+
/** @experimental */
|
|
15692
|
+
export interface McpPromptsGetResult {
|
|
15693
|
+
/**
|
|
15694
|
+
* Description of the prompt
|
|
15695
|
+
*/
|
|
15696
|
+
description?: string;
|
|
15697
|
+
/**
|
|
15698
|
+
* Ordered prompt messages
|
|
15699
|
+
*/
|
|
15700
|
+
messages: McpPromptMessage[];
|
|
15701
|
+
/**
|
|
15702
|
+
* MCP result metadata
|
|
15703
|
+
*/
|
|
15704
|
+
_meta?: {
|
|
15705
|
+
[k: string]: JsonValue | undefined;
|
|
15706
|
+
};
|
|
15707
|
+
/**
|
|
15708
|
+
* Server-provided non-standard result fields
|
|
15709
|
+
*/
|
|
15710
|
+
additionalProperties?: {
|
|
15711
|
+
[k: string]: JsonValue | undefined;
|
|
15712
|
+
};
|
|
15713
|
+
}
|
|
15714
|
+
/**
|
|
15715
|
+
* MCP server whose prompts to enumerate.
|
|
15716
|
+
*
|
|
15717
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15718
|
+
* via the `definition` "McpPromptsListRequest".
|
|
15719
|
+
*/
|
|
15720
|
+
/** @experimental */
|
|
15721
|
+
export interface McpPromptsListRequest {
|
|
15722
|
+
/**
|
|
15723
|
+
* Name of the MCP server whose prompts to enumerate
|
|
15724
|
+
*/
|
|
15725
|
+
serverName: string;
|
|
15726
|
+
/**
|
|
15727
|
+
* Opaque MCP pagination cursor from a prior `nextCursor` value
|
|
15728
|
+
*/
|
|
15729
|
+
cursor?: string;
|
|
15730
|
+
}
|
|
15731
|
+
/**
|
|
15732
|
+
* One page of prompts advertised by the named MCP server.
|
|
15733
|
+
*
|
|
15734
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15735
|
+
* via the `definition` "McpPromptsListResult".
|
|
15736
|
+
*/
|
|
15737
|
+
/** @experimental */
|
|
15738
|
+
export interface McpPromptsListResult {
|
|
15739
|
+
/**
|
|
15740
|
+
* Prompts advertised by the server
|
|
15741
|
+
*/
|
|
15742
|
+
prompts: McpPrompt[];
|
|
15743
|
+
/**
|
|
15744
|
+
* Opaque cursor for the next page, if the server has more prompts
|
|
15745
|
+
*/
|
|
15746
|
+
nextCursor?: string;
|
|
15747
|
+
/**
|
|
15748
|
+
* MCP result metadata
|
|
15749
|
+
*/
|
|
15750
|
+
_meta?: {
|
|
15751
|
+
[k: string]: JsonValue | undefined;
|
|
15752
|
+
};
|
|
15753
|
+
/**
|
|
15754
|
+
* Server-provided non-standard result fields
|
|
15755
|
+
*/
|
|
15756
|
+
additionalProperties?: {
|
|
15757
|
+
[k: string]: JsonValue | undefined;
|
|
15758
|
+
};
|
|
15759
|
+
}
|
|
14801
15760
|
/**
|
|
14802
15761
|
* Indicates whether the auto-managed `github` MCP server was removed (false when nothing to remove).
|
|
14803
15762
|
*
|
|
@@ -15141,6 +16100,10 @@ export interface McpServer {
|
|
|
15141
16100
|
name: string;
|
|
15142
16101
|
status: McpServerStatus;
|
|
15143
16102
|
source?: McpServerSource;
|
|
16103
|
+
/**
|
|
16104
|
+
* Configured URL for an HTTP/SSE server, regardless of configuration source. Omitted for local and in-memory servers.
|
|
16105
|
+
*/
|
|
16106
|
+
url?: string;
|
|
15144
16107
|
/**
|
|
15145
16108
|
* Plugin name that provided this server, when source is plugin.
|
|
15146
16109
|
*/
|
|
@@ -15341,11 +16304,11 @@ export interface MetadataContextHeaviestMessagesResult {
|
|
|
15341
16304
|
/** @experimental */
|
|
15342
16305
|
export interface MetadataContextInfoRequest {
|
|
15343
16306
|
/**
|
|
15344
|
-
*
|
|
16307
|
+
* Advertised prompt allowance. Pass 0 to resolve the selected model and context tier from the session.
|
|
15345
16308
|
*/
|
|
15346
16309
|
promptTokenLimit: number;
|
|
15347
16310
|
/**
|
|
15348
|
-
*
|
|
16311
|
+
* Requested output allowance to reserve against the combined context ceiling. Pass 0 to resolve the session's request cap, falling back to the model's advertised output limit.
|
|
15349
16312
|
*/
|
|
15350
16313
|
outputTokenLimit: number;
|
|
15351
16314
|
/**
|
|
@@ -15584,6 +16547,10 @@ export interface Model {
|
|
|
15584
16547
|
metadata?: {
|
|
15585
16548
|
[k: string]: JsonValue | undefined;
|
|
15586
16549
|
};
|
|
16550
|
+
/**
|
|
16551
|
+
* Model vendor as the Copilot API reports it, for example "Anthropic" or "Azure OpenAI". Open vocabulary, passed through unchanged. It can name the vendor that serves the model instead of the one that built it, or a label that is not a vendor, such as "Experimental". Absent when the Copilot API reports no vendor.
|
|
16552
|
+
*/
|
|
16553
|
+
vendor?: string;
|
|
15587
16554
|
policy?: ModelPolicy;
|
|
15588
16555
|
billing?: ModelBilling;
|
|
15589
16556
|
/**
|
|
@@ -15612,133 +16579,57 @@ export interface Model {
|
|
|
15612
16579
|
provider?: ModelProviderRef;
|
|
15613
16580
|
}
|
|
15614
16581
|
/**
|
|
15615
|
-
*
|
|
16582
|
+
* Policy state (if applicable)
|
|
15616
16583
|
*
|
|
15617
16584
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15618
|
-
* via the `definition` "
|
|
16585
|
+
* via the `definition` "ModelPolicy".
|
|
15619
16586
|
*/
|
|
15620
16587
|
/** @experimental */
|
|
15621
|
-
export interface
|
|
15622
|
-
|
|
15623
|
-
|
|
16588
|
+
export interface ModelPolicy {
|
|
16589
|
+
state: ModelPolicyState;
|
|
16590
|
+
/**
|
|
16591
|
+
* Usage terms or conditions for this model
|
|
16592
|
+
*/
|
|
16593
|
+
terms?: string;
|
|
15624
16594
|
}
|
|
15625
16595
|
/**
|
|
15626
|
-
*
|
|
16596
|
+
* Billing information
|
|
15627
16597
|
*
|
|
15628
16598
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15629
|
-
* via the `definition` "
|
|
16599
|
+
* via the `definition` "ModelBilling".
|
|
15630
16600
|
*/
|
|
15631
16601
|
/** @experimental */
|
|
15632
|
-
export interface
|
|
15633
|
-
/**
|
|
15634
|
-
* Whether this model supports vision/image input
|
|
15635
|
-
*/
|
|
15636
|
-
vision?: boolean;
|
|
16602
|
+
export interface ModelBilling {
|
|
15637
16603
|
/**
|
|
15638
|
-
*
|
|
16604
|
+
* Billing cost multiplier relative to the base rate
|
|
15639
16605
|
*/
|
|
15640
|
-
|
|
16606
|
+
multiplier?: number;
|
|
16607
|
+
tokenPrices?: ModelBillingTokenPrices;
|
|
15641
16608
|
/**
|
|
15642
|
-
*
|
|
16609
|
+
* Whole-number percentage discount (0-100) applied to usage billed through this model. Populated for the synthetic `auto` model, where requests routed by auto-mode are billed at a reduced rate; absent for concrete models.
|
|
15643
16610
|
*/
|
|
15644
|
-
|
|
15645
|
-
|
|
16611
|
+
discountPercent?: number;
|
|
16612
|
+
promo?: ModelBillingPromo;
|
|
15646
16613
|
}
|
|
15647
16614
|
/**
|
|
15648
|
-
* Token
|
|
16615
|
+
* Token-level pricing information for this model
|
|
15649
16616
|
*
|
|
15650
16617
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15651
|
-
* via the `definition` "
|
|
16618
|
+
* via the `definition` "ModelBillingTokenPrices".
|
|
15652
16619
|
*/
|
|
15653
16620
|
/** @experimental */
|
|
15654
|
-
export interface
|
|
16621
|
+
export interface ModelBillingTokenPrices {
|
|
15655
16622
|
/**
|
|
15656
|
-
*
|
|
16623
|
+
* AI Credits cost per billing batch of input tokens
|
|
15657
16624
|
*/
|
|
15658
|
-
|
|
16625
|
+
inputPrice?: number;
|
|
15659
16626
|
/**
|
|
15660
|
-
*
|
|
16627
|
+
* AI Credits cost per billing batch of output tokens
|
|
15661
16628
|
*/
|
|
15662
|
-
|
|
16629
|
+
outputPrice?: number;
|
|
15663
16630
|
/**
|
|
15664
|
-
*
|
|
15665
|
-
|
|
15666
|
-
max_context_window_tokens?: number;
|
|
15667
|
-
vision?: ModelCapabilitiesLimitsVision;
|
|
15668
|
-
}
|
|
15669
|
-
/**
|
|
15670
|
-
* Vision-specific limits
|
|
15671
|
-
*
|
|
15672
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15673
|
-
* via the `definition` "ModelCapabilitiesLimitsVision".
|
|
15674
|
-
*/
|
|
15675
|
-
/** @experimental */
|
|
15676
|
-
export interface ModelCapabilitiesLimitsVision {
|
|
15677
|
-
/**
|
|
15678
|
-
* MIME types the model accepts
|
|
15679
|
-
*/
|
|
15680
|
-
supported_media_types: string[];
|
|
15681
|
-
/**
|
|
15682
|
-
* Maximum number of images per prompt
|
|
15683
|
-
*/
|
|
15684
|
-
max_prompt_images: number;
|
|
15685
|
-
/**
|
|
15686
|
-
* Maximum image size in bytes
|
|
15687
|
-
*/
|
|
15688
|
-
max_prompt_image_size: number;
|
|
15689
|
-
}
|
|
15690
|
-
/**
|
|
15691
|
-
* Policy state (if applicable)
|
|
15692
|
-
*
|
|
15693
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15694
|
-
* via the `definition` "ModelPolicy".
|
|
15695
|
-
*/
|
|
15696
|
-
/** @experimental */
|
|
15697
|
-
export interface ModelPolicy {
|
|
15698
|
-
state: ModelPolicyState;
|
|
15699
|
-
/**
|
|
15700
|
-
* Usage terms or conditions for this model
|
|
15701
|
-
*/
|
|
15702
|
-
terms?: string;
|
|
15703
|
-
}
|
|
15704
|
-
/**
|
|
15705
|
-
* Billing information
|
|
15706
|
-
*
|
|
15707
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15708
|
-
* via the `definition` "ModelBilling".
|
|
15709
|
-
*/
|
|
15710
|
-
/** @experimental */
|
|
15711
|
-
export interface ModelBilling {
|
|
15712
|
-
/**
|
|
15713
|
-
* Billing cost multiplier relative to the base rate
|
|
15714
|
-
*/
|
|
15715
|
-
multiplier?: number;
|
|
15716
|
-
tokenPrices?: ModelBillingTokenPrices;
|
|
15717
|
-
/**
|
|
15718
|
-
* Whole-number percentage discount (0-100) applied to usage billed through this model. Populated for the synthetic `auto` model, where requests routed by auto-mode are billed at a reduced rate; absent for concrete models.
|
|
15719
|
-
*/
|
|
15720
|
-
discountPercent?: number;
|
|
15721
|
-
promo?: ModelBillingPromo;
|
|
15722
|
-
}
|
|
15723
|
-
/**
|
|
15724
|
-
* Token-level pricing information for this model
|
|
15725
|
-
*
|
|
15726
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15727
|
-
* via the `definition` "ModelBillingTokenPrices".
|
|
15728
|
-
*/
|
|
15729
|
-
/** @experimental */
|
|
15730
|
-
export interface ModelBillingTokenPrices {
|
|
15731
|
-
/**
|
|
15732
|
-
* AI Credits cost per billing batch of input tokens
|
|
15733
|
-
*/
|
|
15734
|
-
inputPrice?: number;
|
|
15735
|
-
/**
|
|
15736
|
-
* AI Credits cost per billing batch of output tokens
|
|
15737
|
-
*/
|
|
15738
|
-
outputPrice?: number;
|
|
15739
|
-
/**
|
|
15740
|
-
* @deprecated
|
|
15741
|
-
* Use cacheReadPrice instead. AI Credits cost per billing batch of cached tokens
|
|
16631
|
+
* @deprecated
|
|
16632
|
+
* Use cacheReadPrice instead. AI Credits cost per billing batch of cached tokens
|
|
15742
16633
|
*/
|
|
15743
16634
|
cachePrice?: number;
|
|
15744
16635
|
/**
|
|
@@ -16044,47 +16935,449 @@ export interface ModelPickerPersistenceRequest {
|
|
|
16044
16935
|
contextTierExplicit?: boolean;
|
|
16045
16936
|
}
|
|
16046
16937
|
/**
|
|
16047
|
-
* Filesystem and environment context used to resolve model-picker settings.
|
|
16938
|
+
* Filesystem and environment context used to resolve model-picker settings.
|
|
16939
|
+
*
|
|
16940
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16941
|
+
* via the `definition` "ModelPickerSettingsContext".
|
|
16942
|
+
*/
|
|
16943
|
+
/** @experimental */
|
|
16944
|
+
export interface ModelPickerSettingsContext {
|
|
16945
|
+
/**
|
|
16946
|
+
* Optional Copilot configuration directory containing persisted settings.
|
|
16947
|
+
*/
|
|
16948
|
+
configDir?: string;
|
|
16949
|
+
/**
|
|
16950
|
+
* User home directory used when resolving persisted settings.
|
|
16951
|
+
*/
|
|
16952
|
+
homeDirectory: string;
|
|
16953
|
+
/**
|
|
16954
|
+
* Environment variables consulted while resolving model-picker settings.
|
|
16955
|
+
*/
|
|
16956
|
+
environment: {};
|
|
16957
|
+
}
|
|
16958
|
+
/**
|
|
16959
|
+
* Normalized model-provider adapter definitions available to the session, not discovered instances.
|
|
16960
|
+
*
|
|
16961
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16962
|
+
* via the `definition` "ModelProviderAdapterCatalog".
|
|
16963
|
+
*/
|
|
16964
|
+
/** @experimental */
|
|
16965
|
+
export interface ModelProviderAdapterCatalog {
|
|
16966
|
+
/**
|
|
16967
|
+
* Available provider adapters ordered by adapterId.
|
|
16968
|
+
*/
|
|
16969
|
+
providers: ModelProviderAdapterDescriptor[];
|
|
16970
|
+
}
|
|
16971
|
+
/**
|
|
16972
|
+
* A normalized model-provider adapter in the session's effective catalog.
|
|
16973
|
+
*
|
|
16974
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16975
|
+
* via the `definition` "ModelProviderAdapterDescriptor".
|
|
16976
|
+
*/
|
|
16977
|
+
/** @experimental */
|
|
16978
|
+
export interface ModelProviderAdapterDescriptor {
|
|
16979
|
+
/**
|
|
16980
|
+
* Stable opaque identity for routing to this adapter. Unique in the effective catalog, independent of live registration generations.
|
|
16981
|
+
*/
|
|
16982
|
+
adapterId: string;
|
|
16983
|
+
/**
|
|
16984
|
+
* Descriptive provider family, such as `ollama`. Different adapters may have the same family; use adapterId for routing.
|
|
16985
|
+
*/
|
|
16986
|
+
providerKind: string;
|
|
16987
|
+
/**
|
|
16988
|
+
* Human-readable provider name.
|
|
16989
|
+
*/
|
|
16990
|
+
displayName: string;
|
|
16991
|
+
provenance: ModelProviderAttribution;
|
|
16992
|
+
automaticDiscovery: ModelProviderAutomaticDiscoveryPolicy;
|
|
16993
|
+
/**
|
|
16994
|
+
* Operations supported by this provider adapter.
|
|
16995
|
+
*/
|
|
16996
|
+
operations: ModelProviderAdapterOperationDescriptor[];
|
|
16997
|
+
}
|
|
16998
|
+
/**
|
|
16999
|
+
* Contributor attribution, independent of routing identity and authorization.
|
|
17000
|
+
*
|
|
17001
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17002
|
+
* via the `definition` "ModelProviderAttribution".
|
|
17003
|
+
*/
|
|
17004
|
+
/** @experimental */
|
|
17005
|
+
export interface ModelProviderAttribution {
|
|
17006
|
+
source: ModelProviderProvenanceSource;
|
|
17007
|
+
/**
|
|
17008
|
+
* Stable contributor identifier. Required and nonblank for extension and custom sources; optional for built-in and configured sources. Does not grant authority.
|
|
17009
|
+
*/
|
|
17010
|
+
ownerId?: string;
|
|
17011
|
+
/**
|
|
17012
|
+
* Human-readable contributor name, not the adapter display name.
|
|
17013
|
+
*/
|
|
17014
|
+
ownerDisplayName?: string;
|
|
17015
|
+
}
|
|
17016
|
+
/**
|
|
17017
|
+
* Adapter-declared policy that tells clients whether discovery may run automatically.
|
|
17018
|
+
*
|
|
17019
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17020
|
+
* via the `definition` "ModelProviderAutomaticDiscoveryPolicy".
|
|
17021
|
+
*/
|
|
17022
|
+
/** @experimental */
|
|
17023
|
+
export interface ModelProviderAutomaticDiscoveryPolicy {
|
|
17024
|
+
mode: ModelProviderAutomaticDiscoveryMode;
|
|
17025
|
+
networkScope: ModelProviderDiscoveryNetworkScope;
|
|
17026
|
+
/**
|
|
17027
|
+
* True when discovery requires non-null caller input. Omission or null is rejected before adapter execution. When false, omitted or null input selects adapter defaults without schema validation.
|
|
17028
|
+
*/
|
|
17029
|
+
requiresInput: boolean;
|
|
17030
|
+
/**
|
|
17031
|
+
* True when the adapter must be enabled by a trusted owner, such as a trusted extension, before automatic discovery may run.
|
|
17032
|
+
*/
|
|
17033
|
+
requiresTrust: boolean;
|
|
17034
|
+
}
|
|
17035
|
+
/**
|
|
17036
|
+
* An operation supported by a model-provider adapter.
|
|
17037
|
+
*
|
|
17038
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17039
|
+
* via the `definition` "ModelProviderAdapterOperationDescriptor".
|
|
17040
|
+
*/
|
|
17041
|
+
/** @experimental */
|
|
17042
|
+
export interface ModelProviderAdapterOperationDescriptor {
|
|
17043
|
+
/**
|
|
17044
|
+
* Supported operation name: `discover`, `getStatus`, or `models.list`. Unknown names and duplicate declarations are rejected.
|
|
17045
|
+
*/
|
|
17046
|
+
name: string;
|
|
17047
|
+
/**
|
|
17048
|
+
* Optional self-contained JSON Schema Draft 7 for non-null discovery input. Only supported on discover. No external references are resolved. Omitted or null input selects defaults when requiresInput is false. Without a schema, the adapter validates supplied input.
|
|
17049
|
+
*/
|
|
17050
|
+
inputSchema?: JsonValue;
|
|
17051
|
+
}
|
|
17052
|
+
/**
|
|
17053
|
+
* Provider configuration prepared from a discovered model. Preparing a plan changes nothing: it neither registers the model with the session nor writes durable configuration. To apply it, pass `provider` and `model` to `session.provider.add`, omitting whichever the dispositions report as already configured.
|
|
17054
|
+
*
|
|
17055
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17056
|
+
* via the `definition` "ModelProviderConfigurationPlan".
|
|
17057
|
+
*/
|
|
17058
|
+
/** @experimental */
|
|
17059
|
+
export interface ModelProviderConfigurationPlan {
|
|
17060
|
+
provider: NamedProviderConfig;
|
|
17061
|
+
model: ProviderModelConfig;
|
|
17062
|
+
/**
|
|
17063
|
+
* Provider-qualified selection id (`provider/id`) to pass to `switchTo` once the plan is applied.
|
|
17064
|
+
*/
|
|
17065
|
+
selectionId: string;
|
|
17066
|
+
providerDisposition: ModelProviderConfigurationDisposition;
|
|
17067
|
+
modelDisposition: ModelProviderConfigurationDisposition;
|
|
17068
|
+
/**
|
|
17069
|
+
* Non-fatal warnings carried over from the discovered model, such as capabilities the provider did not report.
|
|
17070
|
+
*/
|
|
17071
|
+
warnings: ModelProviderWarning[];
|
|
17072
|
+
}
|
|
17073
|
+
/**
|
|
17074
|
+
* External SDK input for a named custom model provider. Ingested by the native protocol boundary before host dispatch.
|
|
17075
|
+
*
|
|
17076
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17077
|
+
* via the `definition` "NamedProviderConfig".
|
|
17078
|
+
*/
|
|
17079
|
+
/** @experimental */
|
|
17080
|
+
export interface NamedProviderConfig {
|
|
17081
|
+
/**
|
|
17082
|
+
* Unique provider name used to qualify model selection IDs.
|
|
17083
|
+
*/
|
|
17084
|
+
name: string;
|
|
17085
|
+
type?: ProviderConfigType;
|
|
17086
|
+
wireApi?: ProviderConfigWireApi;
|
|
17087
|
+
transport?: ProviderConfigTransport;
|
|
17088
|
+
/**
|
|
17089
|
+
* Base URL for provider API requests.
|
|
17090
|
+
*/
|
|
17091
|
+
baseUrl: string;
|
|
17092
|
+
/**
|
|
17093
|
+
* Static API key used to authenticate provider requests.
|
|
17094
|
+
*/
|
|
17095
|
+
apiKey?: string;
|
|
17096
|
+
/**
|
|
17097
|
+
* Static bearer token used to authenticate provider requests.
|
|
17098
|
+
*/
|
|
17099
|
+
bearerToken?: string;
|
|
17100
|
+
azure?: ProviderConfigAzure;
|
|
17101
|
+
/**
|
|
17102
|
+
* Additional HTTP headers included with provider requests.
|
|
17103
|
+
*/
|
|
17104
|
+
headers?: {
|
|
17105
|
+
[k: string]: string | undefined;
|
|
17106
|
+
};
|
|
17107
|
+
modelProvider?: ProviderConfigModelProvider;
|
|
17108
|
+
/**
|
|
17109
|
+
* Whether the host supplies bearer tokens dynamically.
|
|
17110
|
+
*/
|
|
17111
|
+
hasBearerTokenProvider?: boolean;
|
|
17112
|
+
}
|
|
17113
|
+
/**
|
|
17114
|
+
* Azure-specific provider options.
|
|
17115
|
+
*
|
|
17116
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17117
|
+
* via the `definition` "ProviderConfigAzure".
|
|
17118
|
+
*/
|
|
17119
|
+
/** @experimental */
|
|
17120
|
+
export interface ProviderConfigAzure {
|
|
17121
|
+
/**
|
|
17122
|
+
* API version. When set, uses the versioned deployment route. When omitted, uses the GA versionless v1 route.
|
|
17123
|
+
*/
|
|
17124
|
+
apiVersion?: string;
|
|
17125
|
+
}
|
|
17126
|
+
/**
|
|
17127
|
+
* A BYOK model definition referencing a named provider.
|
|
17128
|
+
*
|
|
17129
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17130
|
+
* via the `definition` "ProviderModelConfig".
|
|
17131
|
+
*/
|
|
17132
|
+
/** @experimental */
|
|
17133
|
+
export interface ProviderModelConfig {
|
|
17134
|
+
/**
|
|
17135
|
+
* Provider-local model id, unique within its provider. The session-wide selection id (shown in the model list and passed to switchTo) is the provider-qualified `provider/id`.
|
|
17136
|
+
*/
|
|
17137
|
+
id: string;
|
|
17138
|
+
/**
|
|
17139
|
+
* Name of the configured provider that serves this model.
|
|
17140
|
+
*/
|
|
17141
|
+
provider: string;
|
|
17142
|
+
/**
|
|
17143
|
+
* The model name sent to the provider API for inference. Defaults to `id`.
|
|
17144
|
+
*/
|
|
17145
|
+
wireModel?: string;
|
|
17146
|
+
/**
|
|
17147
|
+
* Well-known base model id used for behavior/capability/config lookup. Defaults to `id`.
|
|
17148
|
+
*/
|
|
17149
|
+
modelId?: string;
|
|
17150
|
+
/**
|
|
17151
|
+
* Display name for model pickers. Defaults to the provider-qualified selection id (`provider/id`).
|
|
17152
|
+
*/
|
|
17153
|
+
name?: string;
|
|
17154
|
+
/**
|
|
17155
|
+
* Maximum prompt/input tokens for the model.
|
|
17156
|
+
*/
|
|
17157
|
+
maxPromptTokens?: number;
|
|
17158
|
+
/**
|
|
17159
|
+
* Maximum context window tokens for the model.
|
|
17160
|
+
*/
|
|
17161
|
+
maxContextWindowTokens?: number;
|
|
17162
|
+
/**
|
|
17163
|
+
* Maximum output tokens for the model.
|
|
17164
|
+
*/
|
|
17165
|
+
maxOutputTokens?: number;
|
|
17166
|
+
capabilities?: ModelCapabilitiesOverride;
|
|
17167
|
+
systemMessage?: ProtocolSystemMessageConfig;
|
|
17168
|
+
/**
|
|
17169
|
+
* Provider-published model metadata, preserved verbatim as the public Model.metadata object.
|
|
17170
|
+
*/
|
|
17171
|
+
metadata?: {
|
|
17172
|
+
[k: string]: JsonValue | undefined;
|
|
17173
|
+
};
|
|
17174
|
+
}
|
|
17175
|
+
/** @experimental */
|
|
17176
|
+
export interface ProtocolSystemMessageAppendConfig {
|
|
17177
|
+
mode?: ProtocolAppendMode;
|
|
17178
|
+
/**
|
|
17179
|
+
* Text appended to the standard system prompt.
|
|
17180
|
+
*/
|
|
17181
|
+
content?: string;
|
|
17182
|
+
}
|
|
17183
|
+
/** @experimental */
|
|
17184
|
+
export interface ProtocolSystemMessageReplaceConfig {
|
|
17185
|
+
mode: ProtocolReplaceMode;
|
|
17186
|
+
/**
|
|
17187
|
+
* Complete replacement system-message text.
|
|
17188
|
+
*/
|
|
17189
|
+
content: string;
|
|
17190
|
+
/**
|
|
17191
|
+
* Optional structured blocks corresponding to the replacement content.
|
|
17192
|
+
*/
|
|
17193
|
+
contentBlocks?: SystemMessageBlock[];
|
|
17194
|
+
}
|
|
17195
|
+
/** @experimental */
|
|
17196
|
+
export interface SystemMessageBlock {
|
|
17197
|
+
/**
|
|
17198
|
+
* Text content for this system-message block.
|
|
17199
|
+
*/
|
|
17200
|
+
content: string;
|
|
17201
|
+
/**
|
|
17202
|
+
* Whether the block is static and may be cached independently of dynamic prompt content.
|
|
17203
|
+
*/
|
|
17204
|
+
isStatic?: boolean;
|
|
17205
|
+
/**
|
|
17206
|
+
* Whether providers with explicit prompt caching should place a cache breakpoint after this block.
|
|
17207
|
+
*/
|
|
17208
|
+
cacheBreakpoint?: boolean;
|
|
17209
|
+
}
|
|
17210
|
+
/** @experimental */
|
|
17211
|
+
export interface ProtocolSystemMessageCustomizeConfig {
|
|
17212
|
+
mode: ProtocolCustomizeMode;
|
|
17213
|
+
/**
|
|
17214
|
+
* Named standard-prompt section overrides.
|
|
17215
|
+
*/
|
|
17216
|
+
sections?: {
|
|
17217
|
+
[k: string]: ProtocolSectionOverride | undefined;
|
|
17218
|
+
};
|
|
17219
|
+
/**
|
|
17220
|
+
* Text appended after the customized sections.
|
|
17221
|
+
*/
|
|
17222
|
+
content?: string;
|
|
17223
|
+
}
|
|
17224
|
+
/** @experimental */
|
|
17225
|
+
export interface ProtocolStaticSectionOverride {
|
|
17226
|
+
action: ProtocolStaticSectionAction;
|
|
17227
|
+
/**
|
|
17228
|
+
* Optional content used by replace, append, and prepend operations.
|
|
17229
|
+
*/
|
|
17230
|
+
content?: string;
|
|
17231
|
+
}
|
|
17232
|
+
/**
|
|
17233
|
+
* One model provider available to the session — the model analog of the account `ProviderDescriptor`. Opaque id/label/kind plus a stable ordering; central code never branches on kind.
|
|
17234
|
+
*
|
|
17235
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17236
|
+
* via the `definition` "ModelProviderDescriptor".
|
|
17237
|
+
*/
|
|
17238
|
+
/** @experimental */
|
|
17239
|
+
export interface ModelProviderDescriptor {
|
|
17240
|
+
kind: ModelProviderKind;
|
|
17241
|
+
/**
|
|
17242
|
+
* Opaque, stable provider id, stamped onto every model this provider returns.
|
|
17243
|
+
*/
|
|
17244
|
+
id: string;
|
|
17245
|
+
/**
|
|
17246
|
+
* Human-readable menu label, owned by the runtime so every consumer renders identical text.
|
|
17247
|
+
*/
|
|
17248
|
+
label: string;
|
|
17249
|
+
/**
|
|
17250
|
+
* Stable ordering key for presenting providers in a deterministic sequence.
|
|
17251
|
+
*/
|
|
17252
|
+
ordering: number;
|
|
17253
|
+
}
|
|
17254
|
+
/**
|
|
17255
|
+
* Provider discovery parameters.
|
|
17256
|
+
*
|
|
17257
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17258
|
+
* via the `definition` "ModelProviderDiscoverRequest".
|
|
17259
|
+
*/
|
|
17260
|
+
/** @experimental */
|
|
17261
|
+
export interface ModelProviderDiscoverRequest {
|
|
17262
|
+
/**
|
|
17263
|
+
* Opaque adapter identity returned by `session.providers.getCatalog`.
|
|
17264
|
+
*/
|
|
17265
|
+
adapterId: string;
|
|
17266
|
+
/**
|
|
17267
|
+
* Provider-specific JSON input. Omission or null selects adapter defaults unless requiresInput is true. Non-null input is validated against the advertised Draft 7 schema when present; otherwise validation belongs to the adapter.
|
|
17268
|
+
*/
|
|
17269
|
+
input?: JsonValue;
|
|
17270
|
+
}
|
|
17271
|
+
/**
|
|
17272
|
+
* Provider instances found by a discovery operation.
|
|
17273
|
+
*
|
|
17274
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17275
|
+
* via the `definition` "ModelProviderDiscoverResult".
|
|
17276
|
+
*/
|
|
17277
|
+
/** @experimental */
|
|
17278
|
+
export interface ModelProviderDiscoverResult {
|
|
17279
|
+
outcome: ModelProviderOperationOutcome;
|
|
17280
|
+
/**
|
|
17281
|
+
* Discovered provider instances. Empty when passive default discovery finds no reachable provider.
|
|
17282
|
+
*/
|
|
17283
|
+
instances: ModelProviderInstance[];
|
|
17284
|
+
}
|
|
17285
|
+
/**
|
|
17286
|
+
* A normalized model-provider instance discovered by the runtime.
|
|
17287
|
+
*
|
|
17288
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17289
|
+
* via the `definition` "ModelProviderInstance".
|
|
17290
|
+
*/
|
|
17291
|
+
/** @experimental */
|
|
17292
|
+
export interface ModelProviderInstance {
|
|
17293
|
+
reference: ModelProviderInstanceReference;
|
|
17294
|
+
/**
|
|
17295
|
+
* Human-readable instance name.
|
|
17296
|
+
*/
|
|
17297
|
+
displayName: string;
|
|
17298
|
+
provenance: ModelProviderProvenance;
|
|
17299
|
+
/**
|
|
17300
|
+
* Inference API endpoint when the provider exposes one separately from its management endpoint.
|
|
17301
|
+
*/
|
|
17302
|
+
inferenceEndpoint?: string;
|
|
17303
|
+
inferenceType?: ProviderEndpointType;
|
|
17304
|
+
inferenceWireApi?: ProviderEndpointWireApi;
|
|
17305
|
+
inferenceTransport?: ProviderEndpointTransport;
|
|
17306
|
+
}
|
|
17307
|
+
/**
|
|
17308
|
+
* Serializable reference to a discovered provider instance.
|
|
17309
|
+
*
|
|
17310
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17311
|
+
* via the `definition` "ModelProviderInstanceReference".
|
|
17312
|
+
*/
|
|
17313
|
+
/** @experimental */
|
|
17314
|
+
export interface ModelProviderInstanceReference {
|
|
17315
|
+
/**
|
|
17316
|
+
* Stable opaque identity of the adapter that owns this reference. Must be present in the target session's effective catalog.
|
|
17317
|
+
*/
|
|
17318
|
+
adapterId: string;
|
|
17319
|
+
/**
|
|
17320
|
+
* Descriptive provider family. Must match the selected adapter; not a routing key.
|
|
17321
|
+
*/
|
|
17322
|
+
providerKind: string;
|
|
17323
|
+
/**
|
|
17324
|
+
* Stable instance identifier derived by the provider adapter, such as `ollama:{normalizedEndpoint}`.
|
|
17325
|
+
*/
|
|
17326
|
+
id: string;
|
|
17327
|
+
/**
|
|
17328
|
+
* Absolute provider management URI. The adapter validates normalization, supported schemes, and permission to access it against its bound configuration; a reference does not grant authority.
|
|
17329
|
+
*/
|
|
17330
|
+
managementEndpoint: string;
|
|
17331
|
+
}
|
|
17332
|
+
/**
|
|
17333
|
+
* Provider status request parameters.
|
|
17334
|
+
*
|
|
17335
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17336
|
+
* via the `definition` "ModelProviderGetStatusRequest".
|
|
17337
|
+
*/
|
|
17338
|
+
/** @experimental */
|
|
17339
|
+
export interface ModelProviderGetStatusRequest {
|
|
17340
|
+
instance: ModelProviderInstanceReference;
|
|
17341
|
+
}
|
|
17342
|
+
/**
|
|
17343
|
+
* Provider model inventory request parameters.
|
|
17344
|
+
*
|
|
17345
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17346
|
+
* via the `definition` "ModelProviderModelsListRequest".
|
|
17347
|
+
*/
|
|
17348
|
+
/** @experimental */
|
|
17349
|
+
export interface ModelProviderModelsListRequest {
|
|
17350
|
+
instance: ModelProviderInstanceReference;
|
|
17351
|
+
}
|
|
17352
|
+
/**
|
|
17353
|
+
* A discovered instance and one of its models to translate into provider configuration. Pass back the instance and model as returned by `session.providers.discover` and `session.providers.models.list`.
|
|
16048
17354
|
*
|
|
16049
17355
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16050
|
-
* via the `definition` "
|
|
17356
|
+
* via the `definition` "ModelProviderPrepareConfigurationRequest".
|
|
16051
17357
|
*/
|
|
16052
17358
|
/** @experimental */
|
|
16053
|
-
export interface
|
|
16054
|
-
|
|
16055
|
-
|
|
16056
|
-
*/
|
|
16057
|
-
configDir?: string;
|
|
16058
|
-
/**
|
|
16059
|
-
* User home directory used when resolving persisted settings.
|
|
16060
|
-
*/
|
|
16061
|
-
homeDirectory: string;
|
|
16062
|
-
/**
|
|
16063
|
-
* Environment variables consulted while resolving model-picker settings.
|
|
16064
|
-
*/
|
|
16065
|
-
environment: {};
|
|
17359
|
+
export interface ModelProviderPrepareConfigurationRequest {
|
|
17360
|
+
instance: ModelProviderInstance;
|
|
17361
|
+
model: DiscoveredModel;
|
|
16066
17362
|
}
|
|
16067
17363
|
/**
|
|
16068
|
-
*
|
|
17364
|
+
* Current health information for a provider instance.
|
|
16069
17365
|
*
|
|
16070
17366
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16071
|
-
* via the `definition` "
|
|
17367
|
+
* via the `definition` "ModelProviderStatus".
|
|
16072
17368
|
*/
|
|
16073
17369
|
/** @experimental */
|
|
16074
|
-
export interface
|
|
16075
|
-
|
|
16076
|
-
|
|
16077
|
-
* Opaque, stable provider id, stamped onto every model this provider returns.
|
|
16078
|
-
*/
|
|
16079
|
-
id: string;
|
|
17370
|
+
export interface ModelProviderStatus {
|
|
17371
|
+
outcome: ModelProviderOperationOutcome;
|
|
17372
|
+
instance: ModelProviderInstance;
|
|
16080
17373
|
/**
|
|
16081
|
-
*
|
|
17374
|
+
* Open provider status value, such as `healthy`, `unreachable`, or `notInstalled`.
|
|
16082
17375
|
*/
|
|
16083
|
-
|
|
17376
|
+
status: string;
|
|
16084
17377
|
/**
|
|
16085
|
-
*
|
|
17378
|
+
* Provider-reported version.
|
|
16086
17379
|
*/
|
|
16087
|
-
|
|
17380
|
+
version?: string;
|
|
16088
17381
|
}
|
|
16089
17382
|
/**
|
|
16090
17383
|
* Host-supplied exact model selection IDs to allow for this running session. CAPI IDs are intersected with repository `.github/allowed_models.txt` policy; provider-qualified IDs remain exempt from repository-only policy but are restricted by this host list. Omit or pass null to clear the host restriction; an explicit empty or disjoint list is rejected. Validation and pre-selection fallback failures preserve the previous restriction. Failures after a fallback selection commits retain the new restriction and selected model; callers should inspect current session state after such an error.
|
|
@@ -16410,58 +17703,6 @@ export interface MoveMcpLoadingToBackgroundResult {
|
|
|
16410
17703
|
*/
|
|
16411
17704
|
movedToBackground: boolean;
|
|
16412
17705
|
}
|
|
16413
|
-
/**
|
|
16414
|
-
* External SDK input for a named custom model provider. Ingested by the native protocol boundary before host dispatch.
|
|
16415
|
-
*
|
|
16416
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16417
|
-
* via the `definition` "NamedProviderConfig".
|
|
16418
|
-
*/
|
|
16419
|
-
/** @experimental */
|
|
16420
|
-
export interface NamedProviderConfig {
|
|
16421
|
-
/**
|
|
16422
|
-
* Unique provider name used to qualify model selection IDs.
|
|
16423
|
-
*/
|
|
16424
|
-
name: string;
|
|
16425
|
-
type?: ProviderConfigType;
|
|
16426
|
-
wireApi?: ProviderConfigWireApi;
|
|
16427
|
-
transport?: ProviderConfigTransport;
|
|
16428
|
-
/**
|
|
16429
|
-
* Base URL for provider API requests.
|
|
16430
|
-
*/
|
|
16431
|
-
baseUrl: string;
|
|
16432
|
-
/**
|
|
16433
|
-
* Static API key used to authenticate provider requests.
|
|
16434
|
-
*/
|
|
16435
|
-
apiKey?: string;
|
|
16436
|
-
/**
|
|
16437
|
-
* Static bearer token used to authenticate provider requests.
|
|
16438
|
-
*/
|
|
16439
|
-
bearerToken?: string;
|
|
16440
|
-
azure?: ProviderConfigAzure;
|
|
16441
|
-
/**
|
|
16442
|
-
* Additional HTTP headers included with provider requests.
|
|
16443
|
-
*/
|
|
16444
|
-
headers?: {
|
|
16445
|
-
[k: string]: string | undefined;
|
|
16446
|
-
};
|
|
16447
|
-
/**
|
|
16448
|
-
* Whether the host supplies bearer tokens dynamically.
|
|
16449
|
-
*/
|
|
16450
|
-
hasBearerTokenProvider?: boolean;
|
|
16451
|
-
}
|
|
16452
|
-
/**
|
|
16453
|
-
* Azure-specific provider options.
|
|
16454
|
-
*
|
|
16455
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16456
|
-
* via the `definition` "ProviderConfigAzure".
|
|
16457
|
-
*/
|
|
16458
|
-
/** @experimental */
|
|
16459
|
-
export interface ProviderConfigAzure {
|
|
16460
|
-
/**
|
|
16461
|
-
* API version. When set, uses the versioned deployment route. When omitted, uses the GA versionless v1 route.
|
|
16462
|
-
*/
|
|
16463
|
-
apiVersion?: string;
|
|
16464
|
-
}
|
|
16465
17706
|
/**
|
|
16466
17707
|
* The session's friendly name, or null when not yet set.
|
|
16467
17708
|
*
|
|
@@ -18601,63 +19842,6 @@ export interface ProtocolExternalToolDefinition {
|
|
|
18601
19842
|
[k: string]: JsonValue | undefined;
|
|
18602
19843
|
};
|
|
18603
19844
|
}
|
|
18604
|
-
/** @experimental */
|
|
18605
|
-
export interface ProtocolStaticSectionOverride {
|
|
18606
|
-
action: ProtocolStaticSectionAction;
|
|
18607
|
-
/**
|
|
18608
|
-
* Optional content used by replace, append, and prepend operations.
|
|
18609
|
-
*/
|
|
18610
|
-
content?: string;
|
|
18611
|
-
}
|
|
18612
|
-
/** @experimental */
|
|
18613
|
-
export interface ProtocolSystemMessageAppendConfig {
|
|
18614
|
-
mode?: ProtocolAppendMode;
|
|
18615
|
-
/**
|
|
18616
|
-
* Text appended to the standard system prompt.
|
|
18617
|
-
*/
|
|
18618
|
-
content?: string;
|
|
18619
|
-
}
|
|
18620
|
-
/** @experimental */
|
|
18621
|
-
export interface ProtocolSystemMessageReplaceConfig {
|
|
18622
|
-
mode: ProtocolReplaceMode;
|
|
18623
|
-
/**
|
|
18624
|
-
* Complete replacement system-message text.
|
|
18625
|
-
*/
|
|
18626
|
-
content: string;
|
|
18627
|
-
/**
|
|
18628
|
-
* Optional structured blocks corresponding to the replacement content.
|
|
18629
|
-
*/
|
|
18630
|
-
contentBlocks?: SystemMessageBlock[];
|
|
18631
|
-
}
|
|
18632
|
-
/** @experimental */
|
|
18633
|
-
export interface SystemMessageBlock {
|
|
18634
|
-
/**
|
|
18635
|
-
* Text content for this system-message block.
|
|
18636
|
-
*/
|
|
18637
|
-
content: string;
|
|
18638
|
-
/**
|
|
18639
|
-
* Whether the block is static and may be cached independently of dynamic prompt content.
|
|
18640
|
-
*/
|
|
18641
|
-
isStatic?: boolean;
|
|
18642
|
-
/**
|
|
18643
|
-
* Whether providers with explicit prompt caching should place a cache breakpoint after this block.
|
|
18644
|
-
*/
|
|
18645
|
-
cacheBreakpoint?: boolean;
|
|
18646
|
-
}
|
|
18647
|
-
/** @experimental */
|
|
18648
|
-
export interface ProtocolSystemMessageCustomizeConfig {
|
|
18649
|
-
mode: ProtocolCustomizeMode;
|
|
18650
|
-
/**
|
|
18651
|
-
* Named standard-prompt section overrides.
|
|
18652
|
-
*/
|
|
18653
|
-
sections?: {
|
|
18654
|
-
[k: string]: ProtocolSectionOverride;
|
|
18655
|
-
};
|
|
18656
|
-
/**
|
|
18657
|
-
* Text appended after the customized sections.
|
|
18658
|
-
*/
|
|
18659
|
-
content?: string;
|
|
18660
|
-
}
|
|
18661
19845
|
/**
|
|
18662
19846
|
* BYOK providers and/or models to add to the session's registry at runtime. Both fields are optional; provide providers, models, or both.
|
|
18663
19847
|
*
|
|
@@ -18675,55 +19859,6 @@ export interface ProviderAddRequest {
|
|
|
18675
19859
|
*/
|
|
18676
19860
|
models?: ProviderModelConfig[];
|
|
18677
19861
|
}
|
|
18678
|
-
/**
|
|
18679
|
-
* A BYOK model definition referencing a named provider.
|
|
18680
|
-
*
|
|
18681
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18682
|
-
* via the `definition` "ProviderModelConfig".
|
|
18683
|
-
*/
|
|
18684
|
-
/** @experimental */
|
|
18685
|
-
export interface ProviderModelConfig {
|
|
18686
|
-
/**
|
|
18687
|
-
* Provider-local model id, unique within its provider. The session-wide selection id (shown in the model list and passed to switchTo) is the provider-qualified `provider/id`.
|
|
18688
|
-
*/
|
|
18689
|
-
id: string;
|
|
18690
|
-
/**
|
|
18691
|
-
* Name of the configured provider that serves this model.
|
|
18692
|
-
*/
|
|
18693
|
-
provider: string;
|
|
18694
|
-
/**
|
|
18695
|
-
* The model name sent to the provider API for inference. Defaults to `id`.
|
|
18696
|
-
*/
|
|
18697
|
-
wireModel?: string;
|
|
18698
|
-
/**
|
|
18699
|
-
* Well-known base model id used for behavior/capability/config lookup. Defaults to `id`.
|
|
18700
|
-
*/
|
|
18701
|
-
modelId?: string;
|
|
18702
|
-
/**
|
|
18703
|
-
* Display name for model pickers. Defaults to the provider-qualified selection id (`provider/id`).
|
|
18704
|
-
*/
|
|
18705
|
-
name?: string;
|
|
18706
|
-
/**
|
|
18707
|
-
* Maximum prompt/input tokens for the model.
|
|
18708
|
-
*/
|
|
18709
|
-
maxPromptTokens?: number;
|
|
18710
|
-
/**
|
|
18711
|
-
* Maximum context window tokens for the model.
|
|
18712
|
-
*/
|
|
18713
|
-
maxContextWindowTokens?: number;
|
|
18714
|
-
/**
|
|
18715
|
-
* Maximum output tokens for the model.
|
|
18716
|
-
*/
|
|
18717
|
-
maxOutputTokens?: number;
|
|
18718
|
-
capabilities?: ModelCapabilitiesOverride;
|
|
18719
|
-
systemMessage?: ProtocolSystemMessageConfig;
|
|
18720
|
-
/**
|
|
18721
|
-
* Provider-published model metadata, preserved verbatim as the public Model.metadata object.
|
|
18722
|
-
*/
|
|
18723
|
-
metadata?: {
|
|
18724
|
-
[k: string]: JsonValue | undefined;
|
|
18725
|
-
};
|
|
18726
|
-
}
|
|
18727
19862
|
/**
|
|
18728
19863
|
* The selectable model entries synthesized for the models added by this call.
|
|
18729
19864
|
*
|
|
@@ -18770,6 +19905,7 @@ export interface ProviderConfig {
|
|
|
18770
19905
|
* Provider name used for model and telemetry attribution.
|
|
18771
19906
|
*/
|
|
18772
19907
|
providerName?: string;
|
|
19908
|
+
modelProvider?: ProviderConfigModelProvider;
|
|
18773
19909
|
/**
|
|
18774
19910
|
* The model identifier sent to the provider API for inference (the "wire" model), as opposed to modelId which is the well-known base.
|
|
18775
19911
|
*/
|
|
@@ -20601,6 +21737,47 @@ export interface SandboxHostSupport {
|
|
|
20601
21737
|
*/
|
|
20602
21738
|
capabilities: SandboxHostCapability[];
|
|
20603
21739
|
}
|
|
21740
|
+
/**
|
|
21741
|
+
* Result of creating the persistent certificate authority of the sandbox credential proxy.
|
|
21742
|
+
*
|
|
21743
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21744
|
+
* via the `definition` "SandboxProxyCaCreateResult".
|
|
21745
|
+
*/
|
|
21746
|
+
/** @experimental */
|
|
21747
|
+
export interface SandboxProxyCaCreateResult {
|
|
21748
|
+
/**
|
|
21749
|
+
* Absolute path of the public certificate of the certificate authority, in PEM format.
|
|
21750
|
+
*/
|
|
21751
|
+
certificatePath: string;
|
|
21752
|
+
}
|
|
21753
|
+
/**
|
|
21754
|
+
* Identifies the credential hosts that the persistent certificate authority of the sandbox credential proxy must cover. The runtime always adds the hosts from the saved user settings.
|
|
21755
|
+
*
|
|
21756
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21757
|
+
* via the `definition` "SandboxProxyCaRequest".
|
|
21758
|
+
*/
|
|
21759
|
+
/** @experimental */
|
|
21760
|
+
export interface SandboxProxyCaRequest {
|
|
21761
|
+
sandboxConfig?: SandboxConfig;
|
|
21762
|
+
}
|
|
21763
|
+
/**
|
|
21764
|
+
* Status of the persistent certificate authority of the sandbox credential proxy.
|
|
21765
|
+
*
|
|
21766
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21767
|
+
* via the `definition` "SandboxProxyCaStatus".
|
|
21768
|
+
*/
|
|
21769
|
+
/** @experimental */
|
|
21770
|
+
export interface SandboxProxyCaStatus {
|
|
21771
|
+
state: SandboxProxyCaState;
|
|
21772
|
+
/**
|
|
21773
|
+
* Human-readable reason for the state. On `installed` or `notInstalled`, present only when the certificate authority must be rotated, and then says why.
|
|
21774
|
+
*/
|
|
21775
|
+
detail?: string;
|
|
21776
|
+
/**
|
|
21777
|
+
* Whether this process can add the certificate authority to OS trust without credentials from a different user. False where OS trust is unsupported, and on Windows when the process cannot elevate itself to write the machine trust store. When false, do not offer to set up the certificate authority.
|
|
21778
|
+
*/
|
|
21779
|
+
canInstall: boolean;
|
|
21780
|
+
}
|
|
20604
21781
|
/**
|
|
20605
21782
|
* Register an absolute-time scheduled prompt.
|
|
20606
21783
|
*
|
|
@@ -21229,6 +22406,23 @@ export interface SessionBulkDeleteResult {
|
|
|
21229
22406
|
[k: string]: number | undefined;
|
|
21230
22407
|
};
|
|
21231
22408
|
}
|
|
22409
|
+
/**
|
|
22410
|
+
* The IDE a host is connected to, as reported to the session.
|
|
22411
|
+
*
|
|
22412
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
22413
|
+
* via the `definition` "SessionConnectedIdeInfo".
|
|
22414
|
+
*/
|
|
22415
|
+
/** @experimental */
|
|
22416
|
+
export interface SessionConnectedIdeInfo {
|
|
22417
|
+
/**
|
|
22418
|
+
* Display name of the connected IDE, for example `VS Code`.
|
|
22419
|
+
*/
|
|
22420
|
+
ideName: string;
|
|
22421
|
+
/**
|
|
22422
|
+
* Absolute path of the workspace folder the IDE has open.
|
|
22423
|
+
*/
|
|
22424
|
+
workspaceFolder: string;
|
|
22425
|
+
}
|
|
21232
22426
|
/**
|
|
21233
22427
|
* The enriched metadata records, with summary and context fields backfilled where available. Sessions confirmed empty and unnamed are omitted.
|
|
21234
22428
|
*
|
|
@@ -21280,6 +22474,10 @@ export interface SessionFsError {
|
|
|
21280
22474
|
* Free-form detail about the error, for logging/diagnostics
|
|
21281
22475
|
*/
|
|
21282
22476
|
message?: string;
|
|
22477
|
+
/**
|
|
22478
|
+
* For failed writeFile requests only: true if the provider changed the target before failing. Omit when unknown or unchanged.
|
|
22479
|
+
*/
|
|
22480
|
+
writeChanged?: boolean;
|
|
21283
22481
|
}
|
|
21284
22482
|
/**
|
|
21285
22483
|
* Path to test for existence in the client-provided session filesystem.
|
|
@@ -21368,27 +22566,58 @@ export interface SessionFsReaddirResult {
|
|
|
21368
22566
|
error?: SessionFsError;
|
|
21369
22567
|
}
|
|
21370
22568
|
/**
|
|
21371
|
-
* Directory entry returned by session filesystem `readdirWithTypes`, with name and entry type.
|
|
22569
|
+
* Directory entry returned by session filesystem `readdirWithTypes`, with name and entry type.
|
|
22570
|
+
*
|
|
22571
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
22572
|
+
* via the `definition` "SessionFsReaddirWithTypesEntry".
|
|
22573
|
+
*/
|
|
22574
|
+
/** @experimental */
|
|
22575
|
+
export interface SessionFsReaddirWithTypesEntry {
|
|
22576
|
+
/**
|
|
22577
|
+
* Entry name
|
|
22578
|
+
*/
|
|
22579
|
+
name: string;
|
|
22580
|
+
type: SessionFsReaddirWithTypesEntryType;
|
|
22581
|
+
}
|
|
22582
|
+
/**
|
|
22583
|
+
* Directory path whose entries (with type information) should be listed from the client-provided session filesystem.
|
|
22584
|
+
*
|
|
22585
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
22586
|
+
* via the `definition` "SessionFsReaddirWithTypesRequest".
|
|
22587
|
+
*/
|
|
22588
|
+
/** @experimental */
|
|
22589
|
+
export interface SessionFsReaddirWithTypesRequest {
|
|
22590
|
+
/**
|
|
22591
|
+
* Target session identifier
|
|
22592
|
+
*/
|
|
22593
|
+
sessionId: string;
|
|
22594
|
+
/**
|
|
22595
|
+
* Path using SessionFs conventions
|
|
22596
|
+
*/
|
|
22597
|
+
path: string;
|
|
22598
|
+
}
|
|
22599
|
+
/**
|
|
22600
|
+
* Entries in the requested directory paired with file/directory type information, or a filesystem error if the read failed.
|
|
21372
22601
|
*
|
|
21373
22602
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21374
|
-
* via the `definition` "
|
|
22603
|
+
* via the `definition` "SessionFsReaddirWithTypesResult".
|
|
21375
22604
|
*/
|
|
21376
22605
|
/** @experimental */
|
|
21377
|
-
export interface
|
|
22606
|
+
export interface SessionFsReaddirWithTypesResult {
|
|
21378
22607
|
/**
|
|
21379
|
-
*
|
|
22608
|
+
* Directory entries with type information
|
|
21380
22609
|
*/
|
|
21381
|
-
|
|
21382
|
-
|
|
22610
|
+
entries: SessionFsReaddirWithTypesEntry[];
|
|
22611
|
+
error?: SessionFsError;
|
|
21383
22612
|
}
|
|
21384
22613
|
/**
|
|
21385
|
-
*
|
|
22614
|
+
* Path of the binary file to read from the client-provided session filesystem.
|
|
21386
22615
|
*
|
|
21387
22616
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21388
|
-
* via the `definition` "
|
|
22617
|
+
* via the `definition` "SessionFsReadFileBytesRequest".
|
|
21389
22618
|
*/
|
|
21390
22619
|
/** @experimental */
|
|
21391
|
-
export interface
|
|
22620
|
+
export interface SessionFsReadFileBytesRequest {
|
|
21392
22621
|
/**
|
|
21393
22622
|
* Target session identifier
|
|
21394
22623
|
*/
|
|
@@ -21399,17 +22628,17 @@ export interface SessionFsReaddirWithTypesRequest {
|
|
|
21399
22628
|
path: string;
|
|
21400
22629
|
}
|
|
21401
22630
|
/**
|
|
21402
|
-
*
|
|
22631
|
+
* File bytes as standard base64, or a filesystem error if the read failed.
|
|
21403
22632
|
*
|
|
21404
22633
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21405
|
-
* via the `definition` "
|
|
22634
|
+
* via the `definition` "SessionFsReadFileBytesResult".
|
|
21406
22635
|
*/
|
|
21407
22636
|
/** @experimental */
|
|
21408
|
-
export interface
|
|
22637
|
+
export interface SessionFsReadFileBytesResult {
|
|
21409
22638
|
/**
|
|
21410
|
-
*
|
|
22639
|
+
* Exact file bytes encoded as standard base64
|
|
21411
22640
|
*/
|
|
21412
|
-
|
|
22641
|
+
content: string;
|
|
21413
22642
|
error?: SessionFsError;
|
|
21414
22643
|
}
|
|
21415
22644
|
/**
|
|
@@ -21501,6 +22730,10 @@ export interface SessionFsSetProviderCapabilities {
|
|
|
21501
22730
|
* Whether the provider supports SQLite query/exists operations
|
|
21502
22731
|
*/
|
|
21503
22732
|
sqlite?: boolean;
|
|
22733
|
+
/**
|
|
22734
|
+
* Whether the provider supports binary reads and writes through sessionFs.readFileBytes and sessionFs.writeFileBytes
|
|
22735
|
+
*/
|
|
22736
|
+
binary?: boolean;
|
|
21504
22737
|
}
|
|
21505
22738
|
/**
|
|
21506
22739
|
* Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots.
|
|
@@ -21711,6 +22944,31 @@ export interface SessionFsStatResult {
|
|
|
21711
22944
|
birthtime: string;
|
|
21712
22945
|
error?: SessionFsError;
|
|
21713
22946
|
}
|
|
22947
|
+
/**
|
|
22948
|
+
* File path, standard-base64-encoded bytes to write, and optional mode for the client-provided session filesystem.
|
|
22949
|
+
*
|
|
22950
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
22951
|
+
* via the `definition` "SessionFsWriteFileBytesRequest".
|
|
22952
|
+
*/
|
|
22953
|
+
/** @experimental */
|
|
22954
|
+
export interface SessionFsWriteFileBytesRequest {
|
|
22955
|
+
/**
|
|
22956
|
+
* Target session identifier
|
|
22957
|
+
*/
|
|
22958
|
+
sessionId: string;
|
|
22959
|
+
/**
|
|
22960
|
+
* Path using SessionFs conventions
|
|
22961
|
+
*/
|
|
22962
|
+
path: string;
|
|
22963
|
+
/**
|
|
22964
|
+
* Exact file bytes encoded as standard base64
|
|
22965
|
+
*/
|
|
22966
|
+
content: string;
|
|
22967
|
+
/**
|
|
22968
|
+
* Optional POSIX-style mode for newly created files
|
|
22969
|
+
*/
|
|
22970
|
+
mode?: number;
|
|
22971
|
+
}
|
|
21714
22972
|
/**
|
|
21715
22973
|
* File path, content to write, and optional mode for the client-provided session filesystem.
|
|
21716
22974
|
*
|
|
@@ -21996,6 +23254,10 @@ export interface SessionManagedPermissions {
|
|
|
21996
23254
|
* Permission rules that allow matching operations unless another managed source, deny, or ask rule restricts them.
|
|
21997
23255
|
*/
|
|
21998
23256
|
allow?: string[];
|
|
23257
|
+
/**
|
|
23258
|
+
* Closed-world host boundary expressed as `Domain(hostname)`, `Domain(IP)`, or `Domain(*.example.com)` rules. Schemes, ports, paths, queries, and fragments are rejected because every network request must be enforceable at host-level egress. Multiple managed sources intersect their lists; an empty list denies all hosts.
|
|
23259
|
+
*/
|
|
23260
|
+
limitTo?: string[];
|
|
21999
23261
|
}
|
|
22000
23262
|
/**
|
|
22001
23263
|
* Managed settings an SDK host may inject at session startup. Only permissions are accepted in this initial contract.
|
|
@@ -22007,6 +23269,19 @@ export interface SessionManagedPermissions {
|
|
|
22007
23269
|
export interface SessionManagedSettings {
|
|
22008
23270
|
permissions?: SessionManagedPermissions;
|
|
22009
23271
|
}
|
|
23272
|
+
/**
|
|
23273
|
+
* Records which IDE the host is connected to, or clears it.
|
|
23274
|
+
*
|
|
23275
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23276
|
+
* via the `definition` "SessionMcpSetConnectedIdeInfoParams".
|
|
23277
|
+
*/
|
|
23278
|
+
/** @experimental */
|
|
23279
|
+
export interface SessionMcpSetConnectedIdeInfoParams {
|
|
23280
|
+
/**
|
|
23281
|
+
* The connected IDE. Null or omitted clears the recorded IDE, which is how a host reports that it is disconnected.
|
|
23282
|
+
*/
|
|
23283
|
+
ide?: SessionConnectedIdeInfo | null;
|
|
23284
|
+
}
|
|
22010
23285
|
/**
|
|
22011
23286
|
* Point-in-time snapshot of slow-changing session identifier and state fields
|
|
22012
23287
|
*
|
|
@@ -22097,6 +23372,7 @@ export interface SessionModelList {
|
|
|
22097
23372
|
quotaSnapshots?: {
|
|
22098
23373
|
[k: string]: JsonValue | undefined;
|
|
22099
23374
|
};
|
|
23375
|
+
auto?: AutoTierMetadata;
|
|
22100
23376
|
}
|
|
22101
23377
|
/**
|
|
22102
23378
|
* Cost-category metadata for a CAPI model.
|
|
@@ -22841,6 +24117,90 @@ export interface SessionsCloseRequest {
|
|
|
22841
24117
|
/** @experimental */
|
|
22842
24118
|
export interface SessionsCloseResult {
|
|
22843
24119
|
}
|
|
24120
|
+
/**
|
|
24121
|
+
* Identity, state location and starting context for a workspace record.
|
|
24122
|
+
*
|
|
24123
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
24124
|
+
* via the `definition` "SessionsCreateWorkspaceRequest".
|
|
24125
|
+
*/
|
|
24126
|
+
/** @experimental */
|
|
24127
|
+
export interface SessionsCreateWorkspaceRequest {
|
|
24128
|
+
/**
|
|
24129
|
+
* Session ID the workspace record belongs to
|
|
24130
|
+
*/
|
|
24131
|
+
sessionId: string;
|
|
24132
|
+
/**
|
|
24133
|
+
* Directory the session's state is written under when no session filesystem provider is configured. Ignored when a provider is configured; the provider's session state path is used instead.
|
|
24134
|
+
*/
|
|
24135
|
+
sessionStatePath: string;
|
|
24136
|
+
/**
|
|
24137
|
+
* `windows` (any letter case) selects Windows path rules. Any other value selects POSIX path rules.
|
|
24138
|
+
*/
|
|
24139
|
+
convention: string;
|
|
24140
|
+
context?: SessionWorkingDirectoryContextWithClient;
|
|
24141
|
+
/**
|
|
24142
|
+
* User-supplied display name for the workspace
|
|
24143
|
+
*/
|
|
24144
|
+
name?: string;
|
|
24145
|
+
}
|
|
24146
|
+
/**
|
|
24147
|
+
* A working-directory context together with the client that produced it.
|
|
24148
|
+
*
|
|
24149
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
24150
|
+
* via the `definition` "SessionWorkingDirectoryContextWithClient".
|
|
24151
|
+
*/
|
|
24152
|
+
/** @experimental */
|
|
24153
|
+
export interface SessionWorkingDirectoryContextWithClient {
|
|
24154
|
+
/**
|
|
24155
|
+
* Current working directory path
|
|
24156
|
+
*/
|
|
24157
|
+
cwd: string;
|
|
24158
|
+
/**
|
|
24159
|
+
* Root directory of the git repository
|
|
24160
|
+
*/
|
|
24161
|
+
gitRoot?: string;
|
|
24162
|
+
/**
|
|
24163
|
+
* Repository identifier derived from the git remote URL
|
|
24164
|
+
*/
|
|
24165
|
+
repository?: string;
|
|
24166
|
+
/**
|
|
24167
|
+
* Hosting platform type of the repository
|
|
24168
|
+
*/
|
|
24169
|
+
hostType?: string;
|
|
24170
|
+
/**
|
|
24171
|
+
* Current git branch name
|
|
24172
|
+
*/
|
|
24173
|
+
branch?: string;
|
|
24174
|
+
/**
|
|
24175
|
+
* Raw host string from the git remote URL
|
|
24176
|
+
*/
|
|
24177
|
+
repositoryHost?: string;
|
|
24178
|
+
/**
|
|
24179
|
+
* Head commit of the current git branch
|
|
24180
|
+
*/
|
|
24181
|
+
headCommit?: string;
|
|
24182
|
+
/**
|
|
24183
|
+
* Merge-base commit SHA
|
|
24184
|
+
*/
|
|
24185
|
+
baseCommit?: string;
|
|
24186
|
+
/**
|
|
24187
|
+
* Name of the client that created the session
|
|
24188
|
+
*/
|
|
24189
|
+
clientName?: string;
|
|
24190
|
+
}
|
|
24191
|
+
/**
|
|
24192
|
+
* The workspace record that was written.
|
|
24193
|
+
*
|
|
24194
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
24195
|
+
* via the `definition` "SessionsCreateWorkspaceResult".
|
|
24196
|
+
*/
|
|
24197
|
+
/** @experimental */
|
|
24198
|
+
export interface SessionsCreateWorkspaceResult {
|
|
24199
|
+
/**
|
|
24200
|
+
* The created workspace record, as JSON
|
|
24201
|
+
*/
|
|
24202
|
+
workspaceJson: string;
|
|
24203
|
+
}
|
|
22844
24204
|
/**
|
|
22845
24205
|
* Session ID to delete from disk.
|
|
22846
24206
|
*
|
|
@@ -23468,6 +24828,36 @@ export interface SessionsLoadDeferredRepoHooksRequest {
|
|
|
23468
24828
|
*/
|
|
23469
24829
|
sessionId: string;
|
|
23470
24830
|
}
|
|
24831
|
+
/**
|
|
24832
|
+
* Where the session's state lives, as a root directory and the session ID under it.
|
|
24833
|
+
*
|
|
24834
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
24835
|
+
* via the `definition` "SessionsLoadWorkspaceRequest".
|
|
24836
|
+
*/
|
|
24837
|
+
/** @experimental */
|
|
24838
|
+
export interface SessionsLoadWorkspaceRequest {
|
|
24839
|
+
/**
|
|
24840
|
+
* Root directory every session's state directory sits under
|
|
24841
|
+
*/
|
|
24842
|
+
sessionsHome: string;
|
|
24843
|
+
/**
|
|
24844
|
+
* Session ID naming the state directory under the sessions home. Rejected when it is absolute or contains a parent component, so it cannot escape the sessions home.
|
|
24845
|
+
*/
|
|
24846
|
+
sessionId: string;
|
|
24847
|
+
}
|
|
24848
|
+
/**
|
|
24849
|
+
* The workspace record on disk, omitted when the session has none.
|
|
24850
|
+
*
|
|
24851
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
24852
|
+
* via the `definition` "SessionsLoadWorkspaceResult".
|
|
24853
|
+
*/
|
|
24854
|
+
/** @experimental */
|
|
24855
|
+
export interface SessionsLoadWorkspaceResult {
|
|
24856
|
+
/**
|
|
24857
|
+
* The workspace record, as JSON. Omitted when the record does not exist.
|
|
24858
|
+
*/
|
|
24859
|
+
workspaceJson?: string;
|
|
24860
|
+
}
|
|
23471
24861
|
/**
|
|
23472
24862
|
* Age threshold and optional flags controlling which old sessions are pruned (or simulated when dryRun is true).
|
|
23473
24863
|
*
|
|
@@ -23662,6 +25052,36 @@ export interface SessionsTransferRemoteControlRequest {
|
|
|
23662
25052
|
*/
|
|
23663
25053
|
expectedFromSessionId?: string;
|
|
23664
25054
|
}
|
|
25055
|
+
/**
|
|
25056
|
+
* Where the session's state lives, plus workspace-schema fields to merge into its workspace record. Stored keys outside the schema are not preserved, and a stored `fork_count` is never replaced.
|
|
25057
|
+
*
|
|
25058
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
25059
|
+
* via the `definition` "SessionsUpdateWorkspaceFieldsRequest".
|
|
25060
|
+
*/
|
|
25061
|
+
/** @experimental */
|
|
25062
|
+
export interface SessionsUpdateWorkspaceFieldsRequest {
|
|
25063
|
+
/**
|
|
25064
|
+
* Root directory every session's state directory sits under
|
|
25065
|
+
*/
|
|
25066
|
+
sessionsHome: string;
|
|
25067
|
+
/**
|
|
25068
|
+
* Session ID naming the state directory under the sessions home. Rejected when it is absolute or contains a parent component, so it cannot escape the sessions home.
|
|
25069
|
+
*/
|
|
25070
|
+
sessionId: string;
|
|
25071
|
+
/**
|
|
25072
|
+
* Workspace-schema fields to merge into the record, as a JSON object. Fields the object omits keep their stored values, except stored keys outside the schema are not preserved and a stored `fork_count` is never replaced.
|
|
25073
|
+
*/
|
|
25074
|
+
fieldsJson: string;
|
|
25075
|
+
}
|
|
25076
|
+
/**
|
|
25077
|
+
* The merge completed. The record carries the supplied workspace-schema fields, but a stored `fork_count` stays.
|
|
25078
|
+
*
|
|
25079
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
25080
|
+
* via the `definition` "SessionsUpdateWorkspaceFieldsResult".
|
|
25081
|
+
*/
|
|
25082
|
+
/** @experimental */
|
|
25083
|
+
export interface SessionsUpdateWorkspaceFieldsResult {
|
|
25084
|
+
}
|
|
23665
25085
|
/**
|
|
23666
25086
|
* Telemetry engagement ID for the session, when available.
|
|
23667
25087
|
*
|
|
@@ -23932,7 +25352,7 @@ export interface ShellCancelUserRequestedRequest {
|
|
|
23932
25352
|
requestId: string;
|
|
23933
25353
|
}
|
|
23934
25354
|
/**
|
|
23935
|
-
* Shell command to run, with optional working directory and timeout in milliseconds.
|
|
25355
|
+
* Shell command to run, with optional working directory and timeout in milliseconds. Spawn failures return an RPC error.
|
|
23936
25356
|
*
|
|
23937
25357
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23938
25358
|
* via the `definition` "ShellExecRequest".
|
|
@@ -23953,7 +25373,7 @@ export interface ShellExecRequest {
|
|
|
23953
25373
|
timeout?: number;
|
|
23954
25374
|
}
|
|
23955
25375
|
/**
|
|
23956
|
-
* Identifier of the spawned process,
|
|
25376
|
+
* Identifier of the spawned shell process, usable with shell.kill while the process is running.
|
|
23957
25377
|
*
|
|
23958
25378
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23959
25379
|
* via the `definition` "ShellExecResult".
|
|
@@ -23961,7 +25381,7 @@ export interface ShellExecRequest {
|
|
|
23961
25381
|
/** @experimental */
|
|
23962
25382
|
export interface ShellExecResult {
|
|
23963
25383
|
/**
|
|
23964
|
-
*
|
|
25384
|
+
* Identifier usable with shell.kill while the process is running
|
|
23965
25385
|
*/
|
|
23966
25386
|
processId: string;
|
|
23967
25387
|
}
|
|
@@ -24263,7 +25683,7 @@ export interface SkillPlanUninstallRequest {
|
|
|
24263
25683
|
policySessionId: string;
|
|
24264
25684
|
}
|
|
24265
25685
|
/**
|
|
24266
|
-
*
|
|
25686
|
+
* Authoritative catalog metadata for one SDK-provided skill. The skill's SKILL.md text is fetched separately and lazily.
|
|
24267
25687
|
*
|
|
24268
25688
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
24269
25689
|
* via the `definition` "SkillProviderDescriptor".
|
|
@@ -26659,7 +28079,7 @@ export interface UserSettingMetadata {
|
|
|
26659
28079
|
isDefault: boolean;
|
|
26660
28080
|
}
|
|
26661
28081
|
/**
|
|
26662
|
-
* Per-key metadata for every known user setting
|
|
28082
|
+
* Per-key metadata for every known user setting in settings.json, including settings left at their default. Excludes repository- and enterprise-managed overrides.
|
|
26663
28083
|
*
|
|
26664
28084
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
26665
28085
|
* via the `definition` "UserSettingsGetResult".
|
|
@@ -26686,19 +28106,6 @@ export interface UserSettingsSetRequest {
|
|
|
26686
28106
|
*/
|
|
26687
28107
|
settings: JsonValue;
|
|
26688
28108
|
}
|
|
26689
|
-
/**
|
|
26690
|
-
* Outcome of writing user settings.
|
|
26691
|
-
*
|
|
26692
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
26693
|
-
* via the `definition` "UserSettingsSetResult".
|
|
26694
|
-
*/
|
|
26695
|
-
/** @experimental */
|
|
26696
|
-
export interface UserSettingsSetResult {
|
|
26697
|
-
/**
|
|
26698
|
-
* Top-level keys whose write landed in settings.json but is shadowed by a value still present in the legacy config.json (config.json wins on read). The write does not take effect until the legacy value is removed.
|
|
26699
|
-
*/
|
|
26700
|
-
shadowedKeys: string[];
|
|
26701
|
-
}
|
|
26702
28109
|
/**
|
|
26703
28110
|
* Current sharing status and shareable GitHub URL for a session.
|
|
26704
28111
|
*
|
|
@@ -28837,6 +30244,47 @@ export declare function createServerRpc(connection: MessageConnection): {
|
|
|
28837
30244
|
* @returns Whether the host running this runtime can run the command sandbox. The runtime checks `supported` once per process. A capability answer can change while the process runs, for example after the user installs a missing package.
|
|
28838
30245
|
*/
|
|
28839
30246
|
getHostSupport: () => Promise<SandboxHostSupport>;
|
|
30247
|
+
/** @experimental */
|
|
30248
|
+
proxyCa: {
|
|
30249
|
+
/**
|
|
30250
|
+
* Reports whether the persistent certificate authority of the sandbox credential proxy exists, whether OS trust includes it, and whether it must be rotated. Changes nothing.
|
|
30251
|
+
*
|
|
30252
|
+
* @param params Identifies the credential hosts that the persistent certificate authority of the sandbox credential proxy must cover. The runtime always adds the hosts from the saved user settings.
|
|
30253
|
+
*
|
|
30254
|
+
* @returns Status of the persistent certificate authority of the sandbox credential proxy.
|
|
30255
|
+
*/
|
|
30256
|
+
getStatus: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
|
|
30257
|
+
/**
|
|
30258
|
+
* Creates the persistent certificate authority of the sandbox credential proxy if none is stored, without changing OS trust, and returns the path of its public certificate. Keeps an existing certificate authority, even one that must be rotated. Fails where OS trust is unsupported. Trust it with sandbox.proxyCa.trust: the CLI trusts only the hosts in the saved user settings, so it refuses a certificate authority that also covers hosts from sandboxConfig.
|
|
30259
|
+
*
|
|
30260
|
+
* @param params Identifies the credential hosts that the persistent certificate authority of the sandbox credential proxy must cover. The runtime always adds the hosts from the saved user settings.
|
|
30261
|
+
*
|
|
30262
|
+
* @returns Result of creating the persistent certificate authority of the sandbox credential proxy.
|
|
30263
|
+
*/
|
|
30264
|
+
create: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaCreateResult>;
|
|
30265
|
+
/**
|
|
30266
|
+
* Replaces the persistent certificate authority of the sandbox credential proxy with a new one for the current credential hosts. If OS trust included the old one, removes it and trusts the new one, which can show an OS authentication prompt. Running sandboxed tools keep the old certificate authority until they restart.
|
|
30267
|
+
*
|
|
30268
|
+
* @param params Identifies the credential hosts that the persistent certificate authority of the sandbox credential proxy must cover. The runtime always adds the hosts from the saved user settings.
|
|
30269
|
+
*
|
|
30270
|
+
* @returns Status of the persistent certificate authority of the sandbox credential proxy.
|
|
30271
|
+
*/
|
|
30272
|
+
rotate: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
|
|
30273
|
+
/**
|
|
30274
|
+
* Adds the persistent certificate authority of the sandbox credential proxy to OS trust, so sandboxed clients that read only OS trust accept the proxy. Call create first. Refuses a certificate authority that is not constrained to the current credential hosts. Can show an OS authentication prompt.
|
|
30275
|
+
*
|
|
30276
|
+
* @param params Identifies the credential hosts that the persistent certificate authority of the sandbox credential proxy must cover. The runtime always adds the hosts from the saved user settings.
|
|
30277
|
+
*
|
|
30278
|
+
* @returns Status of the persistent certificate authority of the sandbox credential proxy.
|
|
30279
|
+
*/
|
|
30280
|
+
trust: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
|
|
30281
|
+
/**
|
|
30282
|
+
* Removes the persistent certificate authority of the sandbox credential proxy from OS trust. Keeps the stored certificate authority. Can show an OS authentication prompt. Sandboxed clients that read only OS trust then reject the proxy; clients that read the per-process certificate bundle continue to work.
|
|
30283
|
+
*
|
|
30284
|
+
* @returns Status of the persistent certificate authority of the sandbox credential proxy.
|
|
30285
|
+
*/
|
|
30286
|
+
remove: () => Promise<SandboxProxyCaStatus>;
|
|
30287
|
+
};
|
|
28840
30288
|
};
|
|
28841
30289
|
/** @experimental */
|
|
28842
30290
|
tools: {
|
|
@@ -29334,23 +30782,17 @@ export declare function createServerRpc(connection: MessageConnection): {
|
|
|
29334
30782
|
/** @experimental */
|
|
29335
30783
|
settings: {
|
|
29336
30784
|
/**
|
|
29337
|
-
*
|
|
29338
|
-
*/
|
|
29339
|
-
reload: () => Promise<void>;
|
|
29340
|
-
/**
|
|
29341
|
-
* Lists every known user setting (settings.json overlaid with the legacy config.json, config.json wins), each with its effective value, its default, and whether it is at the default — so settings the user has never set still appear with their default value. Does not include repository- or enterprise-managed overrides that the runtime layers on top at session time.
|
|
30785
|
+
* Lists every known user setting from settings.json, each with its effective value, its default, and whether it is at the default — so settings the user has never set still appear with their default value. Does not include repository- or enterprise-managed overrides that the runtime layers on top at session time.
|
|
29342
30786
|
*
|
|
29343
|
-
* @returns Per-key metadata for every known user setting
|
|
30787
|
+
* @returns Per-key metadata for every known user setting in settings.json, including settings left at their default. Excludes repository- and enterprise-managed overrides.
|
|
29344
30788
|
*/
|
|
29345
30789
|
get: () => Promise<UserSettingsGetResult>;
|
|
29346
30790
|
/**
|
|
29347
|
-
* Writes one or more user settings to settings.json, replacing each provided top-level key. A key whose value is null is removed.
|
|
30791
|
+
* Writes one or more user settings to settings.json, replacing each provided top-level key. A key whose value is null is removed.
|
|
29348
30792
|
*
|
|
29349
30793
|
* @param params Partial user settings to write to settings.json. Each top-level key is written individually, replacing the existing value; a key whose value is null is removed.
|
|
29350
|
-
*
|
|
29351
|
-
* @returns Outcome of writing user settings.
|
|
29352
30794
|
*/
|
|
29353
|
-
set: (params: UserSettingsSetRequest) => Promise<
|
|
30795
|
+
set: (params: UserSettingsSetRequest) => Promise<void>;
|
|
29354
30796
|
};
|
|
29355
30797
|
};
|
|
29356
30798
|
/** @experimental */
|
|
@@ -29649,9 +31091,84 @@ export declare function createServerRpc(connection: MessageConnection): {
|
|
|
29649
31091
|
*/
|
|
29650
31092
|
spawn: (params: AgentRegistrySpawnRequest) => Promise<AgentRegistrySpawnResult>;
|
|
29651
31093
|
};
|
|
31094
|
+
/** @experimental */
|
|
31095
|
+
connectors: {
|
|
31096
|
+
/**
|
|
31097
|
+
* Returns feature availability.
|
|
31098
|
+
*
|
|
31099
|
+
* @returns Feature availability.
|
|
31100
|
+
*/
|
|
31101
|
+
getCapabilities: () => Promise<ConnectorDiscoveryCapabilities>;
|
|
31102
|
+
/**
|
|
31103
|
+
* Returns eligible accounts.
|
|
31104
|
+
*
|
|
31105
|
+
* @returns Eligible accounts.
|
|
31106
|
+
*/
|
|
31107
|
+
getAccounts: () => Promise<ConnectorDiscoveryAccountList>;
|
|
31108
|
+
/**
|
|
31109
|
+
* Lists entries for the selected account.
|
|
31110
|
+
*
|
|
31111
|
+
* @param params Selected account.
|
|
31112
|
+
*
|
|
31113
|
+
* @returns Entries for the selected account.
|
|
31114
|
+
*/
|
|
31115
|
+
list: (params: ConnectorDiscoveryAccountRequest) => Promise<ConnectorDiscoveryCatalogResult>;
|
|
31116
|
+
/**
|
|
31117
|
+
* Refreshes entries for the selected account.
|
|
31118
|
+
*
|
|
31119
|
+
* @param params Selected account.
|
|
31120
|
+
*
|
|
31121
|
+
* @returns Entries for the selected account.
|
|
31122
|
+
*/
|
|
31123
|
+
refresh: (params: ConnectorDiscoveryAccountRequest) => Promise<ConnectorDiscoveryCatalogResult>;
|
|
31124
|
+
};
|
|
29652
31125
|
};
|
|
29653
31126
|
/** Create typed session-scoped RPC methods. */
|
|
29654
31127
|
export declare function createSessionRpc(connection: MessageConnection, sessionId: string): {
|
|
31128
|
+
/** @experimental */
|
|
31129
|
+
providers: {
|
|
31130
|
+
/**
|
|
31131
|
+
* Returns adapter definitions and supported operations in this session's effective provider catalog, without running discovery. Does not list provider instances or select inference models.
|
|
31132
|
+
*
|
|
31133
|
+
* @returns Normalized model-provider adapter definitions available to the session, not discovered instances.
|
|
31134
|
+
*/
|
|
31135
|
+
getCatalog: () => Promise<ModelProviderAdapterCatalog>;
|
|
31136
|
+
/**
|
|
31137
|
+
* Discovers reachable instances using an adapter from this session's effective provider catalog and provider-specific discovery input.
|
|
31138
|
+
*
|
|
31139
|
+
* @param params Provider discovery parameters.
|
|
31140
|
+
*
|
|
31141
|
+
* @returns Provider instances found by a discovery operation.
|
|
31142
|
+
*/
|
|
31143
|
+
discover: (params: ModelProviderDiscoverRequest) => Promise<ModelProviderDiscoverResult>;
|
|
31144
|
+
/**
|
|
31145
|
+
* Gets current health and version information for a discovered model-provider instance.
|
|
31146
|
+
*
|
|
31147
|
+
* @param params Provider status request parameters.
|
|
31148
|
+
*
|
|
31149
|
+
* @returns Current health information for a provider instance.
|
|
31150
|
+
*/
|
|
31151
|
+
getStatus: (params: ModelProviderGetStatusRequest) => Promise<ModelProviderStatus>;
|
|
31152
|
+
/** @experimental */
|
|
31153
|
+
models: {
|
|
31154
|
+
/**
|
|
31155
|
+
* Lists models installed or otherwise available from a discovered model-provider instance.
|
|
31156
|
+
*
|
|
31157
|
+
* @param params Provider model inventory request parameters.
|
|
31158
|
+
*
|
|
31159
|
+
* @returns Models offered for agent conversations by one provider instance. Adapters exclude known-incompatible models, but retain candidates with unknown capabilities. Listing does not guarantee compatibility.
|
|
31160
|
+
*/
|
|
31161
|
+
list: (params: ModelProviderModelsListRequest) => Promise<DiscoveredModelList>;
|
|
31162
|
+
/**
|
|
31163
|
+
* Translates a discovered model into the provider and model configuration needed to use it, and reports whether each is already registered in this session. Prepares only: it registers nothing, writes nothing, and performs no provider requests.
|
|
31164
|
+
*
|
|
31165
|
+
* @param params A discovered instance and one of its models to translate into provider configuration. Pass back the instance and model as returned by `session.providers.discover` and `session.providers.models.list`.
|
|
31166
|
+
*
|
|
31167
|
+
* @returns Provider configuration prepared from a discovered model. Preparing a plan changes nothing: it neither registers the model with the session nor writes durable configuration. To apply it, pass `provider` and `model` to `session.provider.add`, omitting whichever the dispositions report as already configured.
|
|
31168
|
+
*/
|
|
31169
|
+
prepareConfiguration: (params: ModelProviderPrepareConfigurationRequest) => Promise<ModelProviderConfigurationPlan>;
|
|
31170
|
+
};
|
|
31171
|
+
};
|
|
29655
31172
|
/**
|
|
29656
31173
|
* Suspends the session while preserving persisted state for later resume.
|
|
29657
31174
|
*
|
|
@@ -30259,18 +31776,20 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
30259
31776
|
*/
|
|
30260
31777
|
getSources: () => Promise<InstructionsGetSourcesResult>;
|
|
30261
31778
|
/**
|
|
30262
|
-
*
|
|
31779
|
+
* For local sessions, invalidates instruction discovery and the model-facing prompt, then returns freshly discovered sources. The updated prompt takes effect on the next turn. Remote sessions must reload on their agent host instead.
|
|
31780
|
+
*
|
|
31781
|
+
* @returns Instruction sources loaded for the session, in merge order.
|
|
30263
31782
|
*/
|
|
30264
|
-
reload: () => Promise<
|
|
31783
|
+
reload: () => Promise<InstructionsGetSourcesResult>;
|
|
30265
31784
|
};
|
|
30266
31785
|
/** @experimental */
|
|
30267
31786
|
customizations: {
|
|
30268
31787
|
/**
|
|
30269
|
-
*
|
|
31788
|
+
* For local sessions, reconciles repository context and discovered instructions, plugins, skills, agents, hooks, MCP servers, and extensions after files appear or change under the working directory. Independent component failures are returned in outcomes and errors; a rejected call can have partially applied earlier steps. Remote sessions must reload on their agent host instead. The model-facing context is rebuilt on the next turn.
|
|
30270
31789
|
*
|
|
30271
|
-
* @returns
|
|
31790
|
+
* @returns Results of reloading discovered session customizations. Inspect outcomes for reloaded, skipped, or failed subsystems; a rejection may follow partial mutation. Changes to the model-facing prompt and tools apply on the next turn.
|
|
30272
31791
|
*/
|
|
30273
|
-
reload: () => Promise<
|
|
31792
|
+
reload: () => Promise<CustomizationsReloadResult>;
|
|
30274
31793
|
};
|
|
30275
31794
|
/** @experimental */
|
|
30276
31795
|
fleet: {
|
|
@@ -30461,11 +31980,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
30461
31980
|
/** @experimental */
|
|
30462
31981
|
mcp: {
|
|
30463
31982
|
/**
|
|
30464
|
-
* Lists MCP servers
|
|
31983
|
+
* Lists materialized MCP servers and their connection status. Cache misses may start and wait for MCP servers.
|
|
30465
31984
|
*
|
|
30466
31985
|
* @returns MCP servers configured for the session, with their connection status and host-level state.
|
|
30467
31986
|
*/
|
|
30468
31987
|
list: () => Promise<McpServerList>;
|
|
31988
|
+
/**
|
|
31989
|
+
* Lists effective MCP configuration without starting, restarting, authenticating, or waiting for servers. An optional live observation is from an already materialized matching server; this is not a readiness guarantee.
|
|
31990
|
+
*
|
|
31991
|
+
* @returns Effective MCP configuration with optional live observations from matching already materialized servers.
|
|
31992
|
+
*/
|
|
31993
|
+
listConfigured: () => Promise<McpConfiguredServerList>;
|
|
30469
31994
|
/**
|
|
30470
31995
|
* Lists the tools exposed by a connected MCP server on this session's host. This performs a live `tools/list` request. Tool UI metadata is returned independently of whether MCP Apps rendering is enabled for the session.
|
|
30471
31996
|
*
|
|
@@ -30579,11 +32104,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
30579
32104
|
/**
|
|
30580
32105
|
* Starts OAuth authentication for a remote MCP server. Owned servers require the original one-use prepareLogin handle and exact installation ID; manual servers retain the existing direct login behaviour.
|
|
30581
32106
|
*
|
|
30582
|
-
* @param params Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, callback
|
|
32107
|
+
* @param params Remote MCP server name and optional overrides controlling reauthentication, OAuth client display name, callback handling, and static OAuth client selection.
|
|
30583
32108
|
*
|
|
30584
32109
|
* @returns OAuth authorization URL the caller should open, or empty when cached tokens already authenticated the server.
|
|
30585
32110
|
*/
|
|
30586
32111
|
login: (params: McpOauthLoginRequest) => Promise<McpOauthLoginResult>;
|
|
32112
|
+
/**
|
|
32113
|
+
* Completes a runtime-managed MCP OAuth login after the authorization server redirects to a host-managed callback URL.
|
|
32114
|
+
*
|
|
32115
|
+
* @param params Host-delivered callback for a runtime-managed MCP OAuth login.
|
|
32116
|
+
*/
|
|
32117
|
+
complete: (params: McpOauthCompleteRequest) => Promise<void>;
|
|
30587
32118
|
/**
|
|
30588
32119
|
* Passively probes a configured remote MCP server to classify whether OAuth is required or a cached/override token is accepted. Does not start OAuth, emit pending OAuth requests, or mutate MCP connection state.
|
|
30589
32120
|
*
|
|
@@ -30694,6 +32225,25 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
30694
32225
|
*/
|
|
30695
32226
|
listTemplates: (params: McpResourcesListTemplatesRequest) => Promise<McpResourcesListTemplatesResult>;
|
|
30696
32227
|
};
|
|
32228
|
+
/** @experimental */
|
|
32229
|
+
prompts: {
|
|
32230
|
+
/**
|
|
32231
|
+
* Enumerate one page of prompts a connected MCP server exposes (proxies MCP `prompts/list`). Pass `cursor` to continue from a prior result's `nextCursor`.
|
|
32232
|
+
*
|
|
32233
|
+
* @param params MCP server whose prompts to enumerate.
|
|
32234
|
+
*
|
|
32235
|
+
* @returns One page of prompts advertised by the named MCP server.
|
|
32236
|
+
*/
|
|
32237
|
+
list: (params: McpPromptsListRequest) => Promise<McpPromptsListResult>;
|
|
32238
|
+
/**
|
|
32239
|
+
* Get a prompt's messages from a connected MCP server (proxies MCP `prompts/get`). Content is preserved as opaque JSON. Does not send messages to the model, execute tools, or fetch referenced resources.
|
|
32240
|
+
*
|
|
32241
|
+
* @param params MCP server, prompt name, and optional string-valued arguments.
|
|
32242
|
+
*
|
|
32243
|
+
* @returns Prompt messages returned by the MCP server without sending them to the model.
|
|
32244
|
+
*/
|
|
32245
|
+
get: (params: McpPromptsGetRequest) => Promise<McpPromptsGetResult>;
|
|
32246
|
+
};
|
|
30697
32247
|
};
|
|
30698
32248
|
/** @experimental */
|
|
30699
32249
|
diagnostics: {
|
|
@@ -31468,11 +33018,11 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
31468
33018
|
/** @experimental */
|
|
31469
33019
|
shell: {
|
|
31470
33020
|
/**
|
|
31471
|
-
* Starts a shell command
|
|
33021
|
+
* Starts a shell command, returning an RPC error if it cannot be spawned. The command runs as the leader of its own process group (POSIX) or in a dedicated job object (Windows), so a forced termination — via "shell.kill", the request timeout, or session disposal — signals that whole group/job rather than only the direct child. Two gaps are worth planning for: a command that exits on its own does not trigger that teardown, and on POSIX a descendant that moves itself into a new session or process group (for example via "setsid") leaves the signalled group, so either can leave a background process running.
|
|
31472
33022
|
*
|
|
31473
|
-
* @param params Shell command to run, with optional working directory and timeout in milliseconds.
|
|
33023
|
+
* @param params Shell command to run, with optional working directory and timeout in milliseconds. Spawn failures return an RPC error.
|
|
31474
33024
|
*
|
|
31475
|
-
* @returns Identifier of the spawned process,
|
|
33025
|
+
* @returns Identifier of the spawned shell process, usable with shell.kill while the process is running.
|
|
31476
33026
|
*/
|
|
31477
33027
|
exec: (params: ShellExecRequest) => Promise<ShellExecResult>;
|
|
31478
33028
|
/**
|
|
@@ -31822,6 +33372,14 @@ export interface SessionFsHandler {
|
|
|
31822
33372
|
* @returns File content as a UTF-8 string, or a filesystem error if the read failed.
|
|
31823
33373
|
*/
|
|
31824
33374
|
readFile(params: SessionFsReadFileRequest): Promise<SessionFsReadFileResult>;
|
|
33375
|
+
/**
|
|
33376
|
+
* Reads binary file content from the client-provided session filesystem.
|
|
33377
|
+
*
|
|
33378
|
+
* @param params Path of the binary file to read from the client-provided session filesystem.
|
|
33379
|
+
*
|
|
33380
|
+
* @returns File bytes as standard base64, or a filesystem error if the read failed.
|
|
33381
|
+
*/
|
|
33382
|
+
readFileBytes(params: SessionFsReadFileBytesRequest): Promise<SessionFsReadFileBytesResult>;
|
|
31825
33383
|
/**
|
|
31826
33384
|
* Writes a file in the client-provided session filesystem.
|
|
31827
33385
|
*
|
|
@@ -31830,6 +33388,14 @@ export interface SessionFsHandler {
|
|
|
31830
33388
|
* @returns Describes a filesystem error.
|
|
31831
33389
|
*/
|
|
31832
33390
|
writeFile(params: SessionFsWriteFileRequest): Promise<SessionFsError | undefined>;
|
|
33391
|
+
/**
|
|
33392
|
+
* Writes binary file content to the client-provided session filesystem.
|
|
33393
|
+
*
|
|
33394
|
+
* @param params File path, standard-base64-encoded bytes to write, and optional mode for the client-provided session filesystem.
|
|
33395
|
+
*
|
|
33396
|
+
* @returns Describes a filesystem error.
|
|
33397
|
+
*/
|
|
33398
|
+
writeFileBytes(params: SessionFsWriteFileBytesRequest): Promise<SessionFsError | undefined>;
|
|
31833
33399
|
/**
|
|
31834
33400
|
* Appends content to a file in the client-provided session filesystem, creating parent directories as needed.
|
|
31835
33401
|
*
|