@github/copilot-sdk-win32-x64 1.0.17-preview.3 → 1.0.17-preview.5
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/copilot-sdk/canvas.d.ts +6 -1
- package/copilot-sdk/docs/agent-author.md +29 -2
- package/copilot-sdk/extension.js +233 -20
- package/copilot-sdk/generated/rpc.d.ts +1218 -410
- package/copilot-sdk/generated/session-events.d.ts +240 -5
- package/copilot-sdk/index.d.ts +2 -2
- package/copilot-sdk/index.js +236 -22
- package/copilot-sdk/sessionFsProvider.d.ts +9 -1
- package/copilot-sdk/types.d.ts +67 -2
- package/package.json +1 -1
- package/prebuilds/win32-x64/copilot-runtime.exe +0 -0
- package/prebuilds/win32-x64/dpapi.node +0 -0
- package/prebuilds/win32-x64/msal-node-runtime.node +0 -0
- package/prebuilds/win32-x64/msalruntime.dll +0 -0
- package/prebuilds/win32-x64/runtime.node +2 -2
- package/ripgrep/bin/win32-x64/rg.exe +0 -0
- package/schemas/api.schema.json +1518 -131
- package/schemas/session-events.schema.json +419 -8
- package/tgrep/bin/win32-x64/tgrep.exe +0 -0
- package/prebuilds/win32-x64/OneAuthInterop.LICENSE.txt +0 -192
- package/prebuilds/win32-x64/OneAuthInterop.dll +0 -0
- package/prebuilds/win32-x64/OneAuthInterop.dll.stamp.json +0 -4
|
@@ -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
|
/**
|
|
@@ -1394,6 +1398,44 @@ export type ContentFilterMode =
|
|
|
1394
1398
|
| "markdown"
|
|
1395
1399
|
/** Remove characters that can hide directives. */
|
|
1396
1400
|
| "hidden_characters";
|
|
1401
|
+
/**
|
|
1402
|
+
* Component of session customization discovery.
|
|
1403
|
+
*
|
|
1404
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1405
|
+
* via the `definition` "CustomizationReloadSubsystem".
|
|
1406
|
+
*/
|
|
1407
|
+
/** @experimental */
|
|
1408
|
+
export type CustomizationReloadSubsystem =
|
|
1409
|
+
/** Repository metadata and working-directory context. */
|
|
1410
|
+
"repositoryContext"
|
|
1411
|
+
/** Session instructions and their cached dynamic context. */
|
|
1412
|
+
| "instructions"
|
|
1413
|
+
/** Discovered plugin configuration. */
|
|
1414
|
+
| "plugins"
|
|
1415
|
+
/** Configured session and plugin hooks. */
|
|
1416
|
+
| "hooks"
|
|
1417
|
+
/** Discovered skills. */
|
|
1418
|
+
| "skills"
|
|
1419
|
+
/** Discovered custom agents. */
|
|
1420
|
+
| "agents"
|
|
1421
|
+
/** Loaded MCP server configuration. */
|
|
1422
|
+
| "mcp"
|
|
1423
|
+
/** Configured session extensions. */
|
|
1424
|
+
| "extensions" | (string & {});
|
|
1425
|
+
/**
|
|
1426
|
+
* Result of reloading a customization component.
|
|
1427
|
+
*
|
|
1428
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1429
|
+
* via the `definition` "CustomizationReloadStatus".
|
|
1430
|
+
*/
|
|
1431
|
+
/** @experimental */
|
|
1432
|
+
export type CustomizationReloadStatus =
|
|
1433
|
+
/** The component was refreshed successfully. */
|
|
1434
|
+
"reloaded"
|
|
1435
|
+
/** The component was not configured, loaded, or eligible for refresh. */
|
|
1436
|
+
| "skipped"
|
|
1437
|
+
/** The component could not be refreshed; other components may still reload. */
|
|
1438
|
+
| "failed" | (string & {});
|
|
1397
1439
|
/**
|
|
1398
1440
|
* Source category for a collected debug bundle entry.
|
|
1399
1441
|
*
|
|
@@ -1700,57 +1742,45 @@ export type DiscoveredMcpServerType =
|
|
|
1700
1742
|
/** Server is backed by an in-memory runtime implementation. */
|
|
1701
1743
|
| "memory";
|
|
1702
1744
|
/**
|
|
1703
|
-
*
|
|
1745
|
+
* Kind of component that supplied a provider adapter or row. Attribution does not confer authority.
|
|
1704
1746
|
*
|
|
1705
1747
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1706
|
-
* via the `definition` "
|
|
1748
|
+
* via the `definition` "ModelProviderProvenanceSource".
|
|
1707
1749
|
*/
|
|
1708
1750
|
/** @experimental */
|
|
1709
|
-
export type
|
|
1751
|
+
export type ModelProviderProvenanceSource =
|
|
1752
|
+
/** Built into the runtime. */
|
|
1753
|
+
"builtIn"
|
|
1754
|
+
/** Derived from existing user configuration. */
|
|
1755
|
+
| "configured"
|
|
1756
|
+
/** Supplied by an extension. */
|
|
1757
|
+
| "extension"
|
|
1758
|
+
/** Supplied by another trusted contributor. */
|
|
1759
|
+
| "custom";
|
|
1710
1760
|
/**
|
|
1711
|
-
*
|
|
1761
|
+
* Typed outcome for a provider operation.
|
|
1712
1762
|
*
|
|
1713
1763
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1714
|
-
* via the `definition` "
|
|
1764
|
+
* via the `definition` "ModelProviderOperationOutcomeCode".
|
|
1715
1765
|
*/
|
|
1716
1766
|
/** @experimental */
|
|
1717
|
-
export type
|
|
1718
|
-
/**
|
|
1719
|
-
"
|
|
1720
|
-
/**
|
|
1721
|
-
| "
|
|
1722
|
-
/**
|
|
1723
|
-
| "
|
|
1767
|
+
export type ModelProviderOperationOutcomeCode =
|
|
1768
|
+
/** The operation completed successfully; an empty inventory is valid. */
|
|
1769
|
+
"success"
|
|
1770
|
+
/** The provider or instance is absent during discovery, status, or model listing. Distinct from a successful empty inventory. */
|
|
1771
|
+
| "absent"
|
|
1772
|
+
/** The provider is configured or expected but could not be reached. */
|
|
1773
|
+
| "unreachable"
|
|
1774
|
+
/** The operation failed for a reason other than absence or reachability. */
|
|
1775
|
+
| "failed";
|
|
1724
1776
|
/**
|
|
1725
|
-
*
|
|
1777
|
+
* Indicates whether the command was accepted into the local execution queue.
|
|
1726
1778
|
*
|
|
1727
1779
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
1728
|
-
* via the `definition` "
|
|
1780
|
+
* via the `definition` "EnqueueCommandResult".
|
|
1729
1781
|
*/
|
|
1730
1782
|
/** @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
|
-
};
|
|
1783
|
+
export type EnqueueCommandResult = AcceptedEnqueueCommandResult | UnsupportedEnqueueCommandResult;
|
|
1754
1784
|
/**
|
|
1755
1785
|
* GitHub Mission Control compute kind.
|
|
1756
1786
|
*
|
|
@@ -3604,17 +3634,49 @@ export type ModelListRequest = {
|
|
|
3604
3634
|
skipCache?: boolean;
|
|
3605
3635
|
};
|
|
3606
3636
|
/**
|
|
3607
|
-
*
|
|
3637
|
+
* When the runtime may run an adapter without an explicit user action.
|
|
3608
3638
|
*
|
|
3609
3639
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3610
|
-
* via the `definition` "
|
|
3640
|
+
* via the `definition` "ModelProviderAutomaticDiscoveryMode".
|
|
3611
3641
|
*/
|
|
3612
3642
|
/** @experimental */
|
|
3613
|
-
export type
|
|
3614
|
-
/** The
|
|
3615
|
-
"
|
|
3616
|
-
/** The
|
|
3617
|
-
| "
|
|
3643
|
+
export type ModelProviderAutomaticDiscoveryMode =
|
|
3644
|
+
/** The adapter declares that automatic discovery is safe when the other policy fields are satisfied. */
|
|
3645
|
+
"automatic"
|
|
3646
|
+
/** The adapter may refresh instances the user already configured, but must not scan for new instances automatically. */
|
|
3647
|
+
| "configuredOnly"
|
|
3648
|
+
/** The adapter must run only after an explicit user action. */
|
|
3649
|
+
| "explicit";
|
|
3650
|
+
/**
|
|
3651
|
+
* Network reach an adapter may use during discovery.
|
|
3652
|
+
*
|
|
3653
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3654
|
+
* via the `definition` "ModelProviderDiscoveryNetworkScope".
|
|
3655
|
+
*/
|
|
3656
|
+
/** @experimental */
|
|
3657
|
+
export type ModelProviderDiscoveryNetworkScope =
|
|
3658
|
+
/** Discovery does not contact a network service. */
|
|
3659
|
+
"none"
|
|
3660
|
+
/** Discovery is limited to loopback addresses on the local machine. */
|
|
3661
|
+
| "loopbackOnly"
|
|
3662
|
+
/** Discovery contacts only endpoints the user already configured. */
|
|
3663
|
+
| "configuredEndpointOnly"
|
|
3664
|
+
/** Discovery may scan or contact the local network. */
|
|
3665
|
+
| "localNetwork"
|
|
3666
|
+
/** Discovery may contact remote internet services. */
|
|
3667
|
+
| "internet";
|
|
3668
|
+
/**
|
|
3669
|
+
* Whether a planned configuration entry is new or already present in the session registry.
|
|
3670
|
+
*
|
|
3671
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3672
|
+
* via the `definition` "ModelProviderConfigurationDisposition".
|
|
3673
|
+
*/
|
|
3674
|
+
/** @experimental */
|
|
3675
|
+
export type ModelProviderConfigurationDisposition =
|
|
3676
|
+
/** No matching entry is registered; the caller should add the entry. */
|
|
3677
|
+
"create"
|
|
3678
|
+
/** An equivalent entry is already registered; the caller should reuse it rather than adding a duplicate. */
|
|
3679
|
+
| "alreadyConfigured";
|
|
3618
3680
|
/**
|
|
3619
3681
|
* Provider type. Defaults to "openai" for generic OpenAI-compatible APIs.
|
|
3620
3682
|
*
|
|
@@ -3675,6 +3737,88 @@ export type ProviderConfigModelProvider =
|
|
|
3675
3737
|
| "foundry_local"
|
|
3676
3738
|
/** llama.cpp server. */
|
|
3677
3739
|
| "llama_cpp";
|
|
3740
|
+
/** @experimental */
|
|
3741
|
+
export type ProtocolSystemMessageConfig = ProtocolSystemMessageAppendConfig | ProtocolSystemMessageReplaceConfig | ProtocolSystemMessageCustomizeConfig;
|
|
3742
|
+
/** @experimental */
|
|
3743
|
+
export type ProtocolAppendMode = "append";
|
|
3744
|
+
/** @experimental */
|
|
3745
|
+
export type ProtocolReplaceMode = "replace";
|
|
3746
|
+
/** @experimental */
|
|
3747
|
+
export type ProtocolCustomizeMode = "customize";
|
|
3748
|
+
/** @experimental */
|
|
3749
|
+
export type ProtocolSectionOverride = (ProtocolStaticSectionOverride | ProtocolMarkerSectionOverride) | undefined;
|
|
3750
|
+
/** @experimental */
|
|
3751
|
+
export type ProtocolStaticSectionAction =
|
|
3752
|
+
/** Replace the section content. */
|
|
3753
|
+
"replace"
|
|
3754
|
+
/** Remove the section content. */
|
|
3755
|
+
| "remove"
|
|
3756
|
+
/** Append content to the section. */
|
|
3757
|
+
| "append"
|
|
3758
|
+
/** Prepend content to the section. */
|
|
3759
|
+
| "prepend";
|
|
3760
|
+
/** @experimental */
|
|
3761
|
+
export type ProtocolMarkerSectionOverride = {
|
|
3762
|
+
/**
|
|
3763
|
+
* Section override action discriminator.
|
|
3764
|
+
*/
|
|
3765
|
+
action: "transform";
|
|
3766
|
+
} | {
|
|
3767
|
+
/**
|
|
3768
|
+
* Section override action discriminator.
|
|
3769
|
+
*/
|
|
3770
|
+
action: "preserve";
|
|
3771
|
+
};
|
|
3772
|
+
/**
|
|
3773
|
+
* Provider family. Matches the `type` field of a BYOK provider config.
|
|
3774
|
+
*
|
|
3775
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3776
|
+
* via the `definition` "ProviderEndpointType".
|
|
3777
|
+
*/
|
|
3778
|
+
/** @experimental */
|
|
3779
|
+
export type ProviderEndpointType =
|
|
3780
|
+
/** OpenAI-compatible endpoint (use the OpenAI client library). */
|
|
3781
|
+
"openai"
|
|
3782
|
+
/** Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). */
|
|
3783
|
+
| "azure"
|
|
3784
|
+
/** Anthropic endpoint (use the Anthropic client library). */
|
|
3785
|
+
| "anthropic";
|
|
3786
|
+
/**
|
|
3787
|
+
* Wire API to be used, when required for the provider type.
|
|
3788
|
+
*
|
|
3789
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3790
|
+
* via the `definition` "ProviderEndpointWireApi".
|
|
3791
|
+
*/
|
|
3792
|
+
/** @experimental */
|
|
3793
|
+
export type ProviderEndpointWireApi =
|
|
3794
|
+
/** Classic chat-completions request shape. */
|
|
3795
|
+
"completions"
|
|
3796
|
+
/** Newer responses request shape. */
|
|
3797
|
+
| "responses";
|
|
3798
|
+
/**
|
|
3799
|
+
* Transport to be used for provider requests.
|
|
3800
|
+
*
|
|
3801
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3802
|
+
* via the `definition` "ProviderEndpointTransport".
|
|
3803
|
+
*/
|
|
3804
|
+
/** @experimental */
|
|
3805
|
+
export type ProviderEndpointTransport =
|
|
3806
|
+
/** HTTP request/streaming transport. */
|
|
3807
|
+
"http"
|
|
3808
|
+
/** WebSocket transport. */
|
|
3809
|
+
| "websockets";
|
|
3810
|
+
/**
|
|
3811
|
+
* Whether the requested preference was already effective or was accepted for later transactional activation.
|
|
3812
|
+
*
|
|
3813
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3814
|
+
* via the `definition` "ModelSwitchAutoTierStatus".
|
|
3815
|
+
*/
|
|
3816
|
+
/** @experimental */
|
|
3817
|
+
export type ModelSwitchAutoTierStatus =
|
|
3818
|
+
/** 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`. */
|
|
3819
|
+
"unchanged"
|
|
3820
|
+
/** 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. */
|
|
3821
|
+
| "pending";
|
|
3678
3822
|
/**
|
|
3679
3823
|
* Allowed values for the `OptionsUpdateAdditionalContentExclusionPolicyScope` enumeration.
|
|
3680
3824
|
*
|
|
@@ -3932,10 +4076,6 @@ export type PluginsReloadRequest = {
|
|
|
3932
4076
|
*/
|
|
3933
4077
|
deferRepoHooks?: boolean;
|
|
3934
4078
|
};
|
|
3935
|
-
/** @experimental */
|
|
3936
|
-
export type ProtocolAppendMode = "append";
|
|
3937
|
-
/** @experimental */
|
|
3938
|
-
export type ProtocolCustomizeMode = "customize";
|
|
3939
4079
|
/**
|
|
3940
4080
|
* Controls whether the runtime may defer loading an external tool definition.
|
|
3941
4081
|
*
|
|
@@ -3948,72 +4088,6 @@ export type ProtocolExternalToolDefer =
|
|
|
3948
4088
|
"auto"
|
|
3949
4089
|
/** The runtime must include the tool without deferring it. */
|
|
3950
4090
|
| "never";
|
|
3951
|
-
/** @experimental */
|
|
3952
|
-
export type ProtocolMarkerSectionOverride = {
|
|
3953
|
-
/**
|
|
3954
|
-
* Section override action discriminator.
|
|
3955
|
-
*/
|
|
3956
|
-
action: "transform";
|
|
3957
|
-
} | {
|
|
3958
|
-
/**
|
|
3959
|
-
* Section override action discriminator.
|
|
3960
|
-
*/
|
|
3961
|
-
action: "preserve";
|
|
3962
|
-
};
|
|
3963
|
-
/** @experimental */
|
|
3964
|
-
export type ProtocolReplaceMode = "replace";
|
|
3965
|
-
/** @experimental */
|
|
3966
|
-
export type ProtocolSectionOverride = ProtocolStaticSectionOverride | ProtocolMarkerSectionOverride;
|
|
3967
|
-
/** @experimental */
|
|
3968
|
-
export type ProtocolStaticSectionAction =
|
|
3969
|
-
/** Replace the section content. */
|
|
3970
|
-
"replace"
|
|
3971
|
-
/** Remove the section content. */
|
|
3972
|
-
| "remove"
|
|
3973
|
-
/** Append content to the section. */
|
|
3974
|
-
| "append"
|
|
3975
|
-
/** Prepend content to the section. */
|
|
3976
|
-
| "prepend";
|
|
3977
|
-
/** @experimental */
|
|
3978
|
-
export type ProtocolSystemMessageConfig = ProtocolSystemMessageAppendConfig | ProtocolSystemMessageReplaceConfig | ProtocolSystemMessageCustomizeConfig;
|
|
3979
|
-
/**
|
|
3980
|
-
* Provider family. Matches the `type` field of a BYOK provider config.
|
|
3981
|
-
*
|
|
3982
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3983
|
-
* via the `definition` "ProviderEndpointType".
|
|
3984
|
-
*/
|
|
3985
|
-
/** @experimental */
|
|
3986
|
-
export type ProviderEndpointType =
|
|
3987
|
-
/** OpenAI-compatible endpoint (use the OpenAI client library). */
|
|
3988
|
-
"openai"
|
|
3989
|
-
/** Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). */
|
|
3990
|
-
| "azure"
|
|
3991
|
-
/** Anthropic endpoint (use the Anthropic client library). */
|
|
3992
|
-
| "anthropic";
|
|
3993
|
-
/**
|
|
3994
|
-
* Wire API to be used, when required for the provider type.
|
|
3995
|
-
*
|
|
3996
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3997
|
-
* via the `definition` "ProviderEndpointWireApi".
|
|
3998
|
-
*/
|
|
3999
|
-
/** @experimental */
|
|
4000
|
-
export type ProviderEndpointWireApi =
|
|
4001
|
-
/** Classic chat-completions request shape. */
|
|
4002
|
-
"completions"
|
|
4003
|
-
/** Newer responses request shape. */
|
|
4004
|
-
| "responses";
|
|
4005
|
-
/**
|
|
4006
|
-
* Transport to be used for provider requests.
|
|
4007
|
-
*
|
|
4008
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
4009
|
-
* via the `definition` "ProviderEndpointTransport".
|
|
4010
|
-
*/
|
|
4011
|
-
/** @experimental */
|
|
4012
|
-
export type ProviderEndpointTransport =
|
|
4013
|
-
/** HTTP request/streaming transport. */
|
|
4014
|
-
"http"
|
|
4015
|
-
/** WebSocket transport. */
|
|
4016
|
-
| "websockets";
|
|
4017
4091
|
/**
|
|
4018
4092
|
* Optional model identifier to scope the endpoint snapshot to.
|
|
4019
4093
|
*
|
|
@@ -4185,6 +4259,22 @@ export type SandboxConfigSource =
|
|
|
4185
4259
|
*/
|
|
4186
4260
|
/** @experimental */
|
|
4187
4261
|
export type SandboxHostCapabilityName = string;
|
|
4262
|
+
/**
|
|
4263
|
+
* State of the persistent certificate authority of the sandbox credential proxy.
|
|
4264
|
+
*
|
|
4265
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
4266
|
+
* via the `definition` "SandboxProxyCaState".
|
|
4267
|
+
*/
|
|
4268
|
+
/** @experimental */
|
|
4269
|
+
export type SandboxProxyCaState =
|
|
4270
|
+
/** This platform has no supported OS trust store. The proxy uses a per-process certificate bundle. */
|
|
4271
|
+
"unsupported"
|
|
4272
|
+
/** OS trust does not include the certificate authority, or none is stored. */
|
|
4273
|
+
| "notInstalled"
|
|
4274
|
+
/** OS trust includes the stored certificate authority. */
|
|
4275
|
+
| "installed"
|
|
4276
|
+
/** The runtime could not read the certificate authority or the OS trust store. */
|
|
4277
|
+
| "error";
|
|
4188
4278
|
/**
|
|
4189
4279
|
* A session-scoped sandbox transition applied while handling a slash command
|
|
4190
4280
|
*
|
|
@@ -4664,7 +4754,7 @@ export type SessionsClientMetadataEntry = {
|
|
|
4664
4754
|
* via the `definition` "SettableAuthInfo".
|
|
4665
4755
|
*/
|
|
4666
4756
|
/** @experimental */
|
|
4667
|
-
export type SettableAuthInfo = HMACAuthInfo | EnvAuthInfo | SettableTokenAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
|
|
4757
|
+
export type SettableAuthInfo = HMACAuthInfo | EnvAuthInfo | SettableTokenAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | AccountAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
|
|
4668
4758
|
/**
|
|
4669
4759
|
* Rust-owned settings predicates exposed across the SDK boundary. Raw feature-flag names are intentionally not part of the contract.
|
|
4670
4760
|
*
|
|
@@ -6319,6 +6409,27 @@ export interface UserAuthInfo {
|
|
|
6319
6409
|
login: string;
|
|
6320
6410
|
copilotUser?: CopilotUserResponse;
|
|
6321
6411
|
}
|
|
6412
|
+
/**
|
|
6413
|
+
* An interactive account whose model provider owns its credentials. It carries no GitHub credential.
|
|
6414
|
+
*
|
|
6415
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
6416
|
+
* via the `definition` "AccountAuthInfo".
|
|
6417
|
+
*/
|
|
6418
|
+
/** @experimental */
|
|
6419
|
+
export interface AccountAuthInfo {
|
|
6420
|
+
/**
|
|
6421
|
+
* Provider-owned account authentication.
|
|
6422
|
+
*/
|
|
6423
|
+
type: "account";
|
|
6424
|
+
/**
|
|
6425
|
+
* Host coordinate owned by the account's model provider.
|
|
6426
|
+
*/
|
|
6427
|
+
host: string;
|
|
6428
|
+
/**
|
|
6429
|
+
* Login identifying the provider-owned account.
|
|
6430
|
+
*/
|
|
6431
|
+
login: string;
|
|
6432
|
+
}
|
|
6322
6433
|
/**
|
|
6323
6434
|
* Authentication-info input variant for GitHub CLI credentials, carrying host, login, and the `gh auth token` value.
|
|
6324
6435
|
*
|
|
@@ -7035,6 +7146,28 @@ export interface AuthIdentityMetadata {
|
|
|
7035
7146
|
*/
|
|
7036
7147
|
login: string;
|
|
7037
7148
|
}
|
|
7149
|
+
/**
|
|
7150
|
+
* A credential-free account choice after sign-in.
|
|
7151
|
+
*
|
|
7152
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7153
|
+
* via the `definition` "AuthLoginAccount".
|
|
7154
|
+
*/
|
|
7155
|
+
/** @experimental */
|
|
7156
|
+
export interface AuthLoginAccount {
|
|
7157
|
+
/**
|
|
7158
|
+
* Opaque identifier supplied to the next login step to select this account.
|
|
7159
|
+
*/
|
|
7160
|
+
selectionId: string;
|
|
7161
|
+
/**
|
|
7162
|
+
* Host coordinate owned by the selected account's provider.
|
|
7163
|
+
*/
|
|
7164
|
+
host: string;
|
|
7165
|
+
/**
|
|
7166
|
+
* Human-readable login for the account choice.
|
|
7167
|
+
*/
|
|
7168
|
+
login: string;
|
|
7169
|
+
kind: AccountKind;
|
|
7170
|
+
}
|
|
7038
7171
|
/**
|
|
7039
7172
|
* Advance an in-flight login flow, optionally fulfilling an input-required step.
|
|
7040
7173
|
*
|
|
@@ -7077,7 +7210,7 @@ export interface AuthLoginBegun {
|
|
|
7077
7210
|
step: AuthLoginStep;
|
|
7078
7211
|
}
|
|
7079
7212
|
/**
|
|
7080
|
-
*
|
|
7213
|
+
* Result of an interactive login flow. Pending consent or account selection is not terminal.
|
|
7081
7214
|
*
|
|
7082
7215
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7083
7216
|
* via the `definition` "AuthLoginResultDto".
|
|
@@ -7093,6 +7226,10 @@ export interface AuthLoginResultDto {
|
|
|
7093
7226
|
* Login that was signed in, when completed.
|
|
7094
7227
|
*/
|
|
7095
7228
|
login?: string;
|
|
7229
|
+
/**
|
|
7230
|
+
* Available accounts when sign-in is awaiting account selection, ordered with Microsoft 365 first.
|
|
7231
|
+
*/
|
|
7232
|
+
accounts?: AuthLoginAccount[];
|
|
7096
7233
|
}
|
|
7097
7234
|
/**
|
|
7098
7235
|
* Cancel an in-flight login flow.
|
|
@@ -9454,6 +9591,10 @@ export interface CurrentModel {
|
|
|
9454
9591
|
* Currently active model identifier
|
|
9455
9592
|
*/
|
|
9456
9593
|
modelId?: string;
|
|
9594
|
+
/**
|
|
9595
|
+
* 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.
|
|
9596
|
+
*/
|
|
9597
|
+
planBaseModelId?: string;
|
|
9457
9598
|
/**
|
|
9458
9599
|
* 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.
|
|
9459
9600
|
*/
|
|
@@ -9509,31 +9650,67 @@ export interface CurrentToolMetadata {
|
|
|
9509
9650
|
deferLoading?: boolean;
|
|
9510
9651
|
}
|
|
9511
9652
|
/**
|
|
9512
|
-
*
|
|
9653
|
+
* Result of one customization reload component.
|
|
9513
9654
|
*
|
|
9514
9655
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9515
|
-
* via the `definition` "
|
|
9656
|
+
* via the `definition` "CustomizationReloadOutcome".
|
|
9516
9657
|
*/
|
|
9517
9658
|
/** @experimental */
|
|
9518
|
-
export interface
|
|
9519
|
-
|
|
9520
|
-
|
|
9521
|
-
*/
|
|
9522
|
-
bundlePath: string;
|
|
9523
|
-
source: DebugCollectLogsSource;
|
|
9659
|
+
export interface CustomizationReloadOutcome {
|
|
9660
|
+
subsystem: CustomizationReloadSubsystem;
|
|
9661
|
+
status: CustomizationReloadStatus;
|
|
9524
9662
|
/**
|
|
9525
|
-
*
|
|
9663
|
+
* Reason for a skipped component or description of a failure, when available
|
|
9526
9664
|
*/
|
|
9527
|
-
|
|
9665
|
+
detail?: string | null;
|
|
9528
9666
|
}
|
|
9529
9667
|
/**
|
|
9530
|
-
*
|
|
9668
|
+
* 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.
|
|
9531
9669
|
*
|
|
9532
9670
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9533
|
-
* via the `definition` "
|
|
9671
|
+
* via the `definition` "CustomizationsReloadResult".
|
|
9534
9672
|
*/
|
|
9535
9673
|
/** @experimental */
|
|
9536
|
-
export interface
|
|
9674
|
+
export interface CustomizationsReloadResult {
|
|
9675
|
+
/**
|
|
9676
|
+
* Warnings from skill discovery
|
|
9677
|
+
*/
|
|
9678
|
+
warnings: string[];
|
|
9679
|
+
/**
|
|
9680
|
+
* Errors from any component that could not be refreshed
|
|
9681
|
+
*/
|
|
9682
|
+
errors: string[];
|
|
9683
|
+
/**
|
|
9684
|
+
* Outcome of each component in reload order; a skipped component was not configured or loaded
|
|
9685
|
+
*/
|
|
9686
|
+
outcomes: CustomizationReloadOutcome[];
|
|
9687
|
+
}
|
|
9688
|
+
/**
|
|
9689
|
+
* A file included in the session debug bundle.
|
|
9690
|
+
*
|
|
9691
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9692
|
+
* via the `definition` "DebugCollectLogsCollectedEntry".
|
|
9693
|
+
*/
|
|
9694
|
+
/** @experimental */
|
|
9695
|
+
export interface DebugCollectLogsCollectedEntry {
|
|
9696
|
+
/**
|
|
9697
|
+
* Relative path of the file in the staged bundle/archive.
|
|
9698
|
+
*/
|
|
9699
|
+
bundlePath: string;
|
|
9700
|
+
source: DebugCollectLogsSource;
|
|
9701
|
+
/**
|
|
9702
|
+
* Redacted output size in bytes.
|
|
9703
|
+
*/
|
|
9704
|
+
sizeBytes: number;
|
|
9705
|
+
}
|
|
9706
|
+
/**
|
|
9707
|
+
* A caller-provided server-local file or directory to include in the debug bundle.
|
|
9708
|
+
*
|
|
9709
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9710
|
+
* via the `definition` "DebugCollectLogsEntry".
|
|
9711
|
+
*/
|
|
9712
|
+
/** @experimental */
|
|
9713
|
+
export interface DebugCollectLogsEntry {
|
|
9537
9714
|
kind: DebugCollectLogsEntryKind;
|
|
9538
9715
|
/**
|
|
9539
9716
|
* Server-local source path to read.
|
|
@@ -9959,64 +10136,256 @@ export interface McpSourcePlugin {
|
|
|
9959
10136
|
version?: string;
|
|
9960
10137
|
}
|
|
9961
10138
|
/**
|
|
9962
|
-
*
|
|
10139
|
+
* 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.
|
|
9963
10140
|
*
|
|
9964
10141
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9965
|
-
* via the `definition` "
|
|
10142
|
+
* via the `definition` "DiscoveredModel".
|
|
9966
10143
|
*/
|
|
9967
10144
|
/** @experimental */
|
|
9968
|
-
export interface
|
|
10145
|
+
export interface DiscoveredModel {
|
|
9969
10146
|
/**
|
|
9970
|
-
*
|
|
10147
|
+
* Provider-native model identifier.
|
|
9971
10148
|
*/
|
|
9972
|
-
|
|
10149
|
+
id: string;
|
|
9973
10150
|
/**
|
|
9974
|
-
*
|
|
10151
|
+
* Provider-reported display name.
|
|
9975
10152
|
*/
|
|
9976
|
-
|
|
10153
|
+
name?: string;
|
|
10154
|
+
provenance: ModelProviderProvenance;
|
|
10155
|
+
/**
|
|
10156
|
+
* Provider-reported artifact digest.
|
|
10157
|
+
*/
|
|
10158
|
+
digest?: string;
|
|
10159
|
+
/**
|
|
10160
|
+
* Provider-reported last-modified timestamp.
|
|
10161
|
+
*/
|
|
10162
|
+
modifiedAt?: string;
|
|
10163
|
+
/**
|
|
10164
|
+
* Provider-reported artifact size in bytes.
|
|
10165
|
+
*/
|
|
10166
|
+
sizeBytes?: number;
|
|
10167
|
+
details: ModelArtifactDetails;
|
|
10168
|
+
capabilities: ModelCapabilities;
|
|
10169
|
+
/**
|
|
10170
|
+
* Non-fatal warnings encountered while enriching this model.
|
|
10171
|
+
*/
|
|
10172
|
+
warnings: ModelProviderWarning[];
|
|
9977
10173
|
}
|
|
10174
|
+
/**
|
|
10175
|
+
* Attribution for the adapter that produced a provider row.
|
|
10176
|
+
*
|
|
10177
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10178
|
+
* via the `definition` "ModelProviderProvenance".
|
|
10179
|
+
*/
|
|
9978
10180
|
/** @experimental */
|
|
9979
|
-
export interface
|
|
10181
|
+
export interface ModelProviderProvenance {
|
|
9980
10182
|
/**
|
|
9981
|
-
*
|
|
10183
|
+
* Stable opaque adapter identity from the effective catalog. Treat this as a whole identifier, not a parseable owner or kind.
|
|
9982
10184
|
*/
|
|
9983
|
-
|
|
10185
|
+
adapterId: string;
|
|
9984
10186
|
/**
|
|
9985
|
-
*
|
|
10187
|
+
* Descriptive provider family that produced this row; not a routing key.
|
|
9986
10188
|
*/
|
|
9987
|
-
|
|
10189
|
+
providerKind: string;
|
|
10190
|
+
source: ModelProviderProvenanceSource;
|
|
10191
|
+
/**
|
|
10192
|
+
* Stable contributor identifier when the adapter has an owner outside the runtime. Independent of the contribution mechanism and not a routing key.
|
|
10193
|
+
*/
|
|
10194
|
+
ownerId?: string;
|
|
10195
|
+
/**
|
|
10196
|
+
* Human-readable contributor name, not the adapter display name.
|
|
10197
|
+
*/
|
|
10198
|
+
ownerDisplayName?: string;
|
|
9988
10199
|
}
|
|
9989
10200
|
/**
|
|
9990
|
-
*
|
|
10201
|
+
* Provider-reported model artifact metadata.
|
|
9991
10202
|
*
|
|
9992
10203
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
9993
|
-
* via the `definition` "
|
|
10204
|
+
* via the `definition` "ModelArtifactDetails".
|
|
9994
10205
|
*/
|
|
9995
10206
|
/** @experimental */
|
|
9996
|
-
export interface
|
|
10207
|
+
export interface ModelArtifactDetails {
|
|
10208
|
+
/**
|
|
10209
|
+
* Artifact format, such as `gguf`.
|
|
10210
|
+
*/
|
|
10211
|
+
format?: string;
|
|
9997
10212
|
/**
|
|
9998
|
-
*
|
|
10213
|
+
* Primary model family.
|
|
9999
10214
|
*/
|
|
10000
|
-
|
|
10215
|
+
family?: string;
|
|
10001
10216
|
/**
|
|
10002
|
-
*
|
|
10217
|
+
* Provider-reported model families.
|
|
10003
10218
|
*/
|
|
10004
|
-
|
|
10219
|
+
families?: string[];
|
|
10005
10220
|
/**
|
|
10006
|
-
*
|
|
10221
|
+
* Provider-reported parameter count label.
|
|
10007
10222
|
*/
|
|
10008
|
-
|
|
10223
|
+
parameterSize?: string;
|
|
10009
10224
|
/**
|
|
10010
|
-
*
|
|
10011
|
-
|
|
10012
|
-
|
|
10225
|
+
* Provider-reported quantization label.
|
|
10226
|
+
*/
|
|
10227
|
+
quantization?: string;
|
|
10228
|
+
/**
|
|
10229
|
+
* Provider-reported model architecture.
|
|
10230
|
+
*/
|
|
10231
|
+
architecture?: string;
|
|
10232
|
+
/**
|
|
10233
|
+
* Provider-reported tokenizer.
|
|
10234
|
+
*/
|
|
10235
|
+
tokenizer?: string;
|
|
10236
|
+
}
|
|
10237
|
+
/**
|
|
10238
|
+
* Model capabilities and limits
|
|
10239
|
+
*
|
|
10240
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10241
|
+
* via the `definition` "ModelCapabilities".
|
|
10242
|
+
*/
|
|
10243
|
+
/** @experimental */
|
|
10244
|
+
export interface ModelCapabilities {
|
|
10245
|
+
supports?: ModelCapabilitiesSupports;
|
|
10246
|
+
limits?: ModelCapabilitiesLimits;
|
|
10247
|
+
}
|
|
10248
|
+
/**
|
|
10249
|
+
* Feature flags indicating what the model supports
|
|
10250
|
+
*
|
|
10251
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10252
|
+
* via the `definition` "ModelCapabilitiesSupports".
|
|
10253
|
+
*/
|
|
10254
|
+
/** @experimental */
|
|
10255
|
+
export interface ModelCapabilitiesSupports {
|
|
10256
|
+
/**
|
|
10257
|
+
* Whether the model supports provider-native thinking. Independent of configurable reasoning effort; omission means unknown.
|
|
10258
|
+
*/
|
|
10259
|
+
thinking?: boolean;
|
|
10260
|
+
/**
|
|
10261
|
+
* Whether this model supports vision/image input
|
|
10262
|
+
*/
|
|
10263
|
+
vision?: boolean;
|
|
10264
|
+
/**
|
|
10265
|
+
* Whether this model supports canonical tool calling
|
|
10266
|
+
*/
|
|
10267
|
+
toolCalls?: boolean;
|
|
10268
|
+
/**
|
|
10269
|
+
* Whether this model supports reasoning effort configuration
|
|
10270
|
+
*/
|
|
10271
|
+
reasoningEffort?: boolean;
|
|
10272
|
+
adaptive_thinking?: AdaptiveThinkingSupport;
|
|
10273
|
+
}
|
|
10274
|
+
/**
|
|
10275
|
+
* Token limits for prompts, outputs, and context window
|
|
10276
|
+
*
|
|
10277
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10278
|
+
* via the `definition` "ModelCapabilitiesLimits".
|
|
10279
|
+
*/
|
|
10280
|
+
/** @experimental */
|
|
10281
|
+
export interface ModelCapabilitiesLimits {
|
|
10282
|
+
/**
|
|
10283
|
+
* Maximum number of prompt/input tokens
|
|
10284
|
+
*/
|
|
10285
|
+
max_prompt_tokens?: number;
|
|
10286
|
+
/**
|
|
10287
|
+
* Maximum number of output/completion tokens
|
|
10288
|
+
*/
|
|
10289
|
+
max_output_tokens?: number;
|
|
10290
|
+
/**
|
|
10291
|
+
* Maximum total context window size in tokens
|
|
10292
|
+
*/
|
|
10293
|
+
max_context_window_tokens?: number;
|
|
10294
|
+
vision?: ModelCapabilitiesLimitsVision;
|
|
10295
|
+
}
|
|
10296
|
+
/**
|
|
10297
|
+
* Vision-specific limits
|
|
10298
|
+
*
|
|
10299
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10300
|
+
* via the `definition` "ModelCapabilitiesLimitsVision".
|
|
10301
|
+
*/
|
|
10302
|
+
/** @experimental */
|
|
10303
|
+
export interface ModelCapabilitiesLimitsVision {
|
|
10304
|
+
/**
|
|
10305
|
+
* MIME types the model accepts
|
|
10306
|
+
*/
|
|
10307
|
+
supported_media_types: string[];
|
|
10308
|
+
/**
|
|
10309
|
+
* Maximum number of images per prompt
|
|
10310
|
+
*/
|
|
10311
|
+
max_prompt_images: number;
|
|
10312
|
+
/**
|
|
10313
|
+
* Maximum image size in bytes
|
|
10314
|
+
*/
|
|
10315
|
+
max_prompt_image_size: number;
|
|
10316
|
+
}
|
|
10317
|
+
/**
|
|
10318
|
+
* A non-fatal provider observation warning.
|
|
10319
|
+
*
|
|
10320
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10321
|
+
* via the `definition` "ModelProviderWarning".
|
|
10322
|
+
*/
|
|
10323
|
+
/** @experimental */
|
|
10324
|
+
export interface ModelProviderWarning {
|
|
10325
|
+
/**
|
|
10326
|
+
* Machine-readable warning code.
|
|
10327
|
+
*/
|
|
10328
|
+
code: string;
|
|
10329
|
+
/**
|
|
10330
|
+
* Human-readable warning message.
|
|
10331
|
+
*/
|
|
10332
|
+
message: string;
|
|
10333
|
+
}
|
|
10334
|
+
/**
|
|
10335
|
+
* 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.
|
|
10336
|
+
*
|
|
10337
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10338
|
+
* via the `definition` "DiscoveredModelList".
|
|
10339
|
+
*/
|
|
10340
|
+
/** @experimental */
|
|
10341
|
+
export interface DiscoveredModelList {
|
|
10342
|
+
outcome: ModelProviderOperationOutcome;
|
|
10343
|
+
/**
|
|
10344
|
+
* Provider-native models in provider order.
|
|
10345
|
+
*/
|
|
10346
|
+
models: DiscoveredModel[];
|
|
10347
|
+
}
|
|
10348
|
+
/**
|
|
10349
|
+
* Typed provider-operation outcome. Use the code for control flow and the optional message for display.
|
|
10350
|
+
*
|
|
10351
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10352
|
+
* via the `definition` "ModelProviderOperationOutcome".
|
|
10353
|
+
*/
|
|
10354
|
+
/** @experimental */
|
|
10355
|
+
export interface ModelProviderOperationOutcome {
|
|
10356
|
+
code: ModelProviderOperationOutcomeCode;
|
|
10357
|
+
/**
|
|
10358
|
+
* Human-readable detail for non-success outcomes.
|
|
10359
|
+
*/
|
|
10360
|
+
message?: string;
|
|
10361
|
+
}
|
|
10362
|
+
/**
|
|
10363
|
+
* Slash-prefixed command string to enqueue for FIFO processing.
|
|
10364
|
+
*
|
|
10365
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
10366
|
+
* via the `definition` "EnqueueCommandParams".
|
|
10367
|
+
*/
|
|
10368
|
+
/** @experimental */
|
|
10369
|
+
export interface EnqueueCommandParams {
|
|
10370
|
+
/**
|
|
10371
|
+
* 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.
|
|
10372
|
+
*/
|
|
10373
|
+
command: string;
|
|
10374
|
+
/**
|
|
10375
|
+
* Optional user-facing text for the queue row. The command string is shown when omitted.
|
|
10376
|
+
*/
|
|
10377
|
+
displayText?: string | null;
|
|
10378
|
+
}
|
|
10379
|
+
/** @experimental */
|
|
10380
|
+
export interface UnsupportedEnqueueCommandResult {
|
|
10381
|
+
/**
|
|
10382
|
+
* False because the target session does not support local command queueing (e.g. remote sessions).
|
|
10013
10383
|
*/
|
|
10014
|
-
|
|
10015
|
-
interaction: EntraTokenInteraction;
|
|
10384
|
+
queued: false;
|
|
10016
10385
|
/**
|
|
10017
|
-
*
|
|
10386
|
+
* Legacy null queue ID accepted for compatibility with older runtimes.
|
|
10018
10387
|
*/
|
|
10019
|
-
|
|
10388
|
+
queueId?: null;
|
|
10020
10389
|
}
|
|
10021
10390
|
/**
|
|
10022
10391
|
* Hosting capabilities and session capacity advertised by an environment.
|
|
@@ -13950,6 +14319,64 @@ export interface McpConfigUpdateRequest {
|
|
|
13950
14319
|
name: string;
|
|
13951
14320
|
config: McpSerializableServerConfig;
|
|
13952
14321
|
}
|
|
14322
|
+
/**
|
|
14323
|
+
* Effective MCP configuration entry. Configuration enablement is distinct from the optional live observation.
|
|
14324
|
+
*
|
|
14325
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14326
|
+
* via the `definition` "McpConfiguredServer".
|
|
14327
|
+
*/
|
|
14328
|
+
/** @experimental */
|
|
14329
|
+
export interface McpConfiguredServer {
|
|
14330
|
+
/**
|
|
14331
|
+
* Server name (config key)
|
|
14332
|
+
*/
|
|
14333
|
+
name: string;
|
|
14334
|
+
/**
|
|
14335
|
+
* Whether this configured server is enabled after session configuration and policy filtering.
|
|
14336
|
+
*/
|
|
14337
|
+
enabled: boolean;
|
|
14338
|
+
source?: McpServerSource;
|
|
14339
|
+
/**
|
|
14340
|
+
* Plugin name that provided this server, when source is plugin.
|
|
14341
|
+
*/
|
|
14342
|
+
sourcePlugin?: string;
|
|
14343
|
+
/**
|
|
14344
|
+
* Plugin version that provided this server, when source is plugin.
|
|
14345
|
+
*/
|
|
14346
|
+
sourcePluginVersion?: string;
|
|
14347
|
+
/**
|
|
14348
|
+
* Human-readable display name supplied by configuration.
|
|
14349
|
+
*/
|
|
14350
|
+
displayName?: string;
|
|
14351
|
+
live?: McpConfiguredServerState;
|
|
14352
|
+
}
|
|
14353
|
+
/**
|
|
14354
|
+
* Observational state for a matching already materialized MCP server.
|
|
14355
|
+
*
|
|
14356
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14357
|
+
* via the `definition` "McpConfiguredServerState".
|
|
14358
|
+
*/
|
|
14359
|
+
/** @experimental */
|
|
14360
|
+
export interface McpConfiguredServerState {
|
|
14361
|
+
status: McpServerStatus;
|
|
14362
|
+
/**
|
|
14363
|
+
* Observed connection error, when the materialized server failed.
|
|
14364
|
+
*/
|
|
14365
|
+
error?: string;
|
|
14366
|
+
}
|
|
14367
|
+
/**
|
|
14368
|
+
* Effective MCP configuration with optional live observations from matching already materialized servers.
|
|
14369
|
+
*
|
|
14370
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14371
|
+
* via the `definition` "McpConfiguredServerList".
|
|
14372
|
+
*/
|
|
14373
|
+
/** @experimental */
|
|
14374
|
+
export interface McpConfiguredServerList {
|
|
14375
|
+
/**
|
|
14376
|
+
* Effective configured MCP servers.
|
|
14377
|
+
*/
|
|
14378
|
+
servers: McpConfiguredServer[];
|
|
14379
|
+
}
|
|
13953
14380
|
/**
|
|
13954
14381
|
* Result of configuring GitHub MCP.
|
|
13955
14382
|
*
|
|
@@ -15900,86 +16327,10 @@ export interface Model {
|
|
|
15900
16327
|
provider?: ModelProviderRef;
|
|
15901
16328
|
}
|
|
15902
16329
|
/**
|
|
15903
|
-
*
|
|
16330
|
+
* Policy state (if applicable)
|
|
15904
16331
|
*
|
|
15905
16332
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15906
|
-
* via the `definition` "
|
|
15907
|
-
*/
|
|
15908
|
-
/** @experimental */
|
|
15909
|
-
export interface ModelCapabilities {
|
|
15910
|
-
supports?: ModelCapabilitiesSupports;
|
|
15911
|
-
limits?: ModelCapabilitiesLimits;
|
|
15912
|
-
}
|
|
15913
|
-
/**
|
|
15914
|
-
* Feature flags indicating what the model supports
|
|
15915
|
-
*
|
|
15916
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15917
|
-
* via the `definition` "ModelCapabilitiesSupports".
|
|
15918
|
-
*/
|
|
15919
|
-
/** @experimental */
|
|
15920
|
-
export interface ModelCapabilitiesSupports {
|
|
15921
|
-
/**
|
|
15922
|
-
* Whether this model supports vision/image input
|
|
15923
|
-
*/
|
|
15924
|
-
vision?: boolean;
|
|
15925
|
-
/**
|
|
15926
|
-
* Whether this model supports canonical tool calling
|
|
15927
|
-
*/
|
|
15928
|
-
toolCalls?: boolean;
|
|
15929
|
-
/**
|
|
15930
|
-
* Whether this model supports reasoning effort configuration
|
|
15931
|
-
*/
|
|
15932
|
-
reasoningEffort?: boolean;
|
|
15933
|
-
adaptive_thinking?: AdaptiveThinkingSupport;
|
|
15934
|
-
}
|
|
15935
|
-
/**
|
|
15936
|
-
* Token limits for prompts, outputs, and context window
|
|
15937
|
-
*
|
|
15938
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15939
|
-
* via the `definition` "ModelCapabilitiesLimits".
|
|
15940
|
-
*/
|
|
15941
|
-
/** @experimental */
|
|
15942
|
-
export interface ModelCapabilitiesLimits {
|
|
15943
|
-
/**
|
|
15944
|
-
* Maximum number of prompt/input tokens
|
|
15945
|
-
*/
|
|
15946
|
-
max_prompt_tokens?: number;
|
|
15947
|
-
/**
|
|
15948
|
-
* Maximum number of output/completion tokens
|
|
15949
|
-
*/
|
|
15950
|
-
max_output_tokens?: number;
|
|
15951
|
-
/**
|
|
15952
|
-
* Maximum total context window size in tokens
|
|
15953
|
-
*/
|
|
15954
|
-
max_context_window_tokens?: number;
|
|
15955
|
-
vision?: ModelCapabilitiesLimitsVision;
|
|
15956
|
-
}
|
|
15957
|
-
/**
|
|
15958
|
-
* Vision-specific limits
|
|
15959
|
-
*
|
|
15960
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15961
|
-
* via the `definition` "ModelCapabilitiesLimitsVision".
|
|
15962
|
-
*/
|
|
15963
|
-
/** @experimental */
|
|
15964
|
-
export interface ModelCapabilitiesLimitsVision {
|
|
15965
|
-
/**
|
|
15966
|
-
* MIME types the model accepts
|
|
15967
|
-
*/
|
|
15968
|
-
supported_media_types: string[];
|
|
15969
|
-
/**
|
|
15970
|
-
* Maximum number of images per prompt
|
|
15971
|
-
*/
|
|
15972
|
-
max_prompt_images: number;
|
|
15973
|
-
/**
|
|
15974
|
-
* Maximum image size in bytes
|
|
15975
|
-
*/
|
|
15976
|
-
max_prompt_image_size: number;
|
|
15977
|
-
}
|
|
15978
|
-
/**
|
|
15979
|
-
* Policy state (if applicable)
|
|
15980
|
-
*
|
|
15981
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
15982
|
-
* via the `definition` "ModelPolicy".
|
|
16333
|
+
* via the `definition` "ModelPolicy".
|
|
15983
16334
|
*/
|
|
15984
16335
|
/** @experimental */
|
|
15985
16336
|
export interface ModelPolicy {
|
|
@@ -16352,6 +16703,280 @@ export interface ModelPickerSettingsContext {
|
|
|
16352
16703
|
*/
|
|
16353
16704
|
environment: {};
|
|
16354
16705
|
}
|
|
16706
|
+
/**
|
|
16707
|
+
* Normalized model-provider adapter definitions available to the session, not discovered instances.
|
|
16708
|
+
*
|
|
16709
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16710
|
+
* via the `definition` "ModelProviderAdapterCatalog".
|
|
16711
|
+
*/
|
|
16712
|
+
/** @experimental */
|
|
16713
|
+
export interface ModelProviderAdapterCatalog {
|
|
16714
|
+
/**
|
|
16715
|
+
* Available provider adapters ordered by adapterId.
|
|
16716
|
+
*/
|
|
16717
|
+
providers: ModelProviderAdapterDescriptor[];
|
|
16718
|
+
}
|
|
16719
|
+
/**
|
|
16720
|
+
* A normalized model-provider adapter in the session's effective catalog.
|
|
16721
|
+
*
|
|
16722
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16723
|
+
* via the `definition` "ModelProviderAdapterDescriptor".
|
|
16724
|
+
*/
|
|
16725
|
+
/** @experimental */
|
|
16726
|
+
export interface ModelProviderAdapterDescriptor {
|
|
16727
|
+
/**
|
|
16728
|
+
* Stable opaque identity for routing to this adapter. Unique in the effective catalog, independent of live registration generations.
|
|
16729
|
+
*/
|
|
16730
|
+
adapterId: string;
|
|
16731
|
+
/**
|
|
16732
|
+
* Descriptive provider family, such as `ollama`. Different adapters may have the same family; use adapterId for routing.
|
|
16733
|
+
*/
|
|
16734
|
+
providerKind: string;
|
|
16735
|
+
/**
|
|
16736
|
+
* Human-readable provider name.
|
|
16737
|
+
*/
|
|
16738
|
+
displayName: string;
|
|
16739
|
+
provenance: ModelProviderAttribution;
|
|
16740
|
+
automaticDiscovery: ModelProviderAutomaticDiscoveryPolicy;
|
|
16741
|
+
/**
|
|
16742
|
+
* Operations supported by this provider adapter.
|
|
16743
|
+
*/
|
|
16744
|
+
operations: ModelProviderAdapterOperationDescriptor[];
|
|
16745
|
+
}
|
|
16746
|
+
/**
|
|
16747
|
+
* Contributor attribution, independent of routing identity and authorization.
|
|
16748
|
+
*
|
|
16749
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16750
|
+
* via the `definition` "ModelProviderAttribution".
|
|
16751
|
+
*/
|
|
16752
|
+
/** @experimental */
|
|
16753
|
+
export interface ModelProviderAttribution {
|
|
16754
|
+
source: ModelProviderProvenanceSource;
|
|
16755
|
+
/**
|
|
16756
|
+
* Stable contributor identifier. Required and nonblank for extension and custom sources; optional for built-in and configured sources. Does not grant authority.
|
|
16757
|
+
*/
|
|
16758
|
+
ownerId?: string;
|
|
16759
|
+
/**
|
|
16760
|
+
* Human-readable contributor name, not the adapter display name.
|
|
16761
|
+
*/
|
|
16762
|
+
ownerDisplayName?: string;
|
|
16763
|
+
}
|
|
16764
|
+
/**
|
|
16765
|
+
* Adapter-declared policy that tells clients whether discovery may run automatically.
|
|
16766
|
+
*
|
|
16767
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16768
|
+
* via the `definition` "ModelProviderAutomaticDiscoveryPolicy".
|
|
16769
|
+
*/
|
|
16770
|
+
/** @experimental */
|
|
16771
|
+
export interface ModelProviderAutomaticDiscoveryPolicy {
|
|
16772
|
+
mode: ModelProviderAutomaticDiscoveryMode;
|
|
16773
|
+
networkScope: ModelProviderDiscoveryNetworkScope;
|
|
16774
|
+
/**
|
|
16775
|
+
* 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.
|
|
16776
|
+
*/
|
|
16777
|
+
requiresInput: boolean;
|
|
16778
|
+
/**
|
|
16779
|
+
* True when the adapter must be enabled by a trusted owner, such as a trusted extension, before automatic discovery may run.
|
|
16780
|
+
*/
|
|
16781
|
+
requiresTrust: boolean;
|
|
16782
|
+
}
|
|
16783
|
+
/**
|
|
16784
|
+
* An operation supported by a model-provider adapter.
|
|
16785
|
+
*
|
|
16786
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16787
|
+
* via the `definition` "ModelProviderAdapterOperationDescriptor".
|
|
16788
|
+
*/
|
|
16789
|
+
/** @experimental */
|
|
16790
|
+
export interface ModelProviderAdapterOperationDescriptor {
|
|
16791
|
+
/**
|
|
16792
|
+
* Supported operation name: `discover`, `getStatus`, or `models.list`. Unknown names and duplicate declarations are rejected.
|
|
16793
|
+
*/
|
|
16794
|
+
name: string;
|
|
16795
|
+
/**
|
|
16796
|
+
* 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.
|
|
16797
|
+
*/
|
|
16798
|
+
inputSchema?: JsonValue;
|
|
16799
|
+
}
|
|
16800
|
+
/**
|
|
16801
|
+
* 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.
|
|
16802
|
+
*
|
|
16803
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16804
|
+
* via the `definition` "ModelProviderConfigurationPlan".
|
|
16805
|
+
*/
|
|
16806
|
+
/** @experimental */
|
|
16807
|
+
export interface ModelProviderConfigurationPlan {
|
|
16808
|
+
provider: NamedProviderConfig;
|
|
16809
|
+
model: ProviderModelConfig;
|
|
16810
|
+
/**
|
|
16811
|
+
* Provider-qualified selection id (`provider/id`) to pass to `switchTo` once the plan is applied.
|
|
16812
|
+
*/
|
|
16813
|
+
selectionId: string;
|
|
16814
|
+
providerDisposition: ModelProviderConfigurationDisposition;
|
|
16815
|
+
modelDisposition: ModelProviderConfigurationDisposition;
|
|
16816
|
+
/**
|
|
16817
|
+
* Non-fatal warnings carried over from the discovered model, such as capabilities the provider did not report.
|
|
16818
|
+
*/
|
|
16819
|
+
warnings: ModelProviderWarning[];
|
|
16820
|
+
}
|
|
16821
|
+
/**
|
|
16822
|
+
* External SDK input for a named custom model provider. Ingested by the native protocol boundary before host dispatch.
|
|
16823
|
+
*
|
|
16824
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16825
|
+
* via the `definition` "NamedProviderConfig".
|
|
16826
|
+
*/
|
|
16827
|
+
/** @experimental */
|
|
16828
|
+
export interface NamedProviderConfig {
|
|
16829
|
+
/**
|
|
16830
|
+
* Unique provider name used to qualify model selection IDs.
|
|
16831
|
+
*/
|
|
16832
|
+
name: string;
|
|
16833
|
+
type?: ProviderConfigType;
|
|
16834
|
+
wireApi?: ProviderConfigWireApi;
|
|
16835
|
+
transport?: ProviderConfigTransport;
|
|
16836
|
+
/**
|
|
16837
|
+
* Base URL for provider API requests.
|
|
16838
|
+
*/
|
|
16839
|
+
baseUrl: string;
|
|
16840
|
+
/**
|
|
16841
|
+
* Static API key used to authenticate provider requests.
|
|
16842
|
+
*/
|
|
16843
|
+
apiKey?: string;
|
|
16844
|
+
/**
|
|
16845
|
+
* Static bearer token used to authenticate provider requests.
|
|
16846
|
+
*/
|
|
16847
|
+
bearerToken?: string;
|
|
16848
|
+
azure?: ProviderConfigAzure;
|
|
16849
|
+
/**
|
|
16850
|
+
* Additional HTTP headers included with provider requests.
|
|
16851
|
+
*/
|
|
16852
|
+
headers?: {
|
|
16853
|
+
[k: string]: string | undefined;
|
|
16854
|
+
};
|
|
16855
|
+
modelProvider?: ProviderConfigModelProvider;
|
|
16856
|
+
/**
|
|
16857
|
+
* Whether the host supplies bearer tokens dynamically.
|
|
16858
|
+
*/
|
|
16859
|
+
hasBearerTokenProvider?: boolean;
|
|
16860
|
+
}
|
|
16861
|
+
/**
|
|
16862
|
+
* Azure-specific provider options.
|
|
16863
|
+
*
|
|
16864
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16865
|
+
* via the `definition` "ProviderConfigAzure".
|
|
16866
|
+
*/
|
|
16867
|
+
/** @experimental */
|
|
16868
|
+
export interface ProviderConfigAzure {
|
|
16869
|
+
/**
|
|
16870
|
+
* API version. When set, uses the versioned deployment route. When omitted, uses the GA versionless v1 route.
|
|
16871
|
+
*/
|
|
16872
|
+
apiVersion?: string;
|
|
16873
|
+
}
|
|
16874
|
+
/**
|
|
16875
|
+
* A BYOK model definition referencing a named provider.
|
|
16876
|
+
*
|
|
16877
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16878
|
+
* via the `definition` "ProviderModelConfig".
|
|
16879
|
+
*/
|
|
16880
|
+
/** @experimental */
|
|
16881
|
+
export interface ProviderModelConfig {
|
|
16882
|
+
/**
|
|
16883
|
+
* 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`.
|
|
16884
|
+
*/
|
|
16885
|
+
id: string;
|
|
16886
|
+
/**
|
|
16887
|
+
* Name of the configured provider that serves this model.
|
|
16888
|
+
*/
|
|
16889
|
+
provider: string;
|
|
16890
|
+
/**
|
|
16891
|
+
* The model name sent to the provider API for inference. Defaults to `id`.
|
|
16892
|
+
*/
|
|
16893
|
+
wireModel?: string;
|
|
16894
|
+
/**
|
|
16895
|
+
* Well-known base model id used for behavior/capability/config lookup. Defaults to `id`.
|
|
16896
|
+
*/
|
|
16897
|
+
modelId?: string;
|
|
16898
|
+
/**
|
|
16899
|
+
* Display name for model pickers. Defaults to the provider-qualified selection id (`provider/id`).
|
|
16900
|
+
*/
|
|
16901
|
+
name?: string;
|
|
16902
|
+
/**
|
|
16903
|
+
* Maximum prompt/input tokens for the model.
|
|
16904
|
+
*/
|
|
16905
|
+
maxPromptTokens?: number;
|
|
16906
|
+
/**
|
|
16907
|
+
* Maximum context window tokens for the model.
|
|
16908
|
+
*/
|
|
16909
|
+
maxContextWindowTokens?: number;
|
|
16910
|
+
/**
|
|
16911
|
+
* Maximum output tokens for the model.
|
|
16912
|
+
*/
|
|
16913
|
+
maxOutputTokens?: number;
|
|
16914
|
+
capabilities?: ModelCapabilitiesOverride;
|
|
16915
|
+
systemMessage?: ProtocolSystemMessageConfig;
|
|
16916
|
+
/**
|
|
16917
|
+
* Provider-published model metadata, preserved verbatim as the public Model.metadata object.
|
|
16918
|
+
*/
|
|
16919
|
+
metadata?: {
|
|
16920
|
+
[k: string]: JsonValue | undefined;
|
|
16921
|
+
};
|
|
16922
|
+
}
|
|
16923
|
+
/** @experimental */
|
|
16924
|
+
export interface ProtocolSystemMessageAppendConfig {
|
|
16925
|
+
mode?: ProtocolAppendMode;
|
|
16926
|
+
/**
|
|
16927
|
+
* Text appended to the standard system prompt.
|
|
16928
|
+
*/
|
|
16929
|
+
content?: string;
|
|
16930
|
+
}
|
|
16931
|
+
/** @experimental */
|
|
16932
|
+
export interface ProtocolSystemMessageReplaceConfig {
|
|
16933
|
+
mode: ProtocolReplaceMode;
|
|
16934
|
+
/**
|
|
16935
|
+
* Complete replacement system-message text.
|
|
16936
|
+
*/
|
|
16937
|
+
content: string;
|
|
16938
|
+
/**
|
|
16939
|
+
* Optional structured blocks corresponding to the replacement content.
|
|
16940
|
+
*/
|
|
16941
|
+
contentBlocks?: SystemMessageBlock[];
|
|
16942
|
+
}
|
|
16943
|
+
/** @experimental */
|
|
16944
|
+
export interface SystemMessageBlock {
|
|
16945
|
+
/**
|
|
16946
|
+
* Text content for this system-message block.
|
|
16947
|
+
*/
|
|
16948
|
+
content: string;
|
|
16949
|
+
/**
|
|
16950
|
+
* Whether the block is static and may be cached independently of dynamic prompt content.
|
|
16951
|
+
*/
|
|
16952
|
+
isStatic?: boolean;
|
|
16953
|
+
/**
|
|
16954
|
+
* Whether providers with explicit prompt caching should place a cache breakpoint after this block.
|
|
16955
|
+
*/
|
|
16956
|
+
cacheBreakpoint?: boolean;
|
|
16957
|
+
}
|
|
16958
|
+
/** @experimental */
|
|
16959
|
+
export interface ProtocolSystemMessageCustomizeConfig {
|
|
16960
|
+
mode: ProtocolCustomizeMode;
|
|
16961
|
+
/**
|
|
16962
|
+
* Named standard-prompt section overrides.
|
|
16963
|
+
*/
|
|
16964
|
+
sections?: {
|
|
16965
|
+
[k: string]: ProtocolSectionOverride | undefined;
|
|
16966
|
+
};
|
|
16967
|
+
/**
|
|
16968
|
+
* Text appended after the customized sections.
|
|
16969
|
+
*/
|
|
16970
|
+
content?: string;
|
|
16971
|
+
}
|
|
16972
|
+
/** @experimental */
|
|
16973
|
+
export interface ProtocolStaticSectionOverride {
|
|
16974
|
+
action: ProtocolStaticSectionAction;
|
|
16975
|
+
/**
|
|
16976
|
+
* Optional content used by replace, append, and prepend operations.
|
|
16977
|
+
*/
|
|
16978
|
+
content?: string;
|
|
16979
|
+
}
|
|
16355
16980
|
/**
|
|
16356
16981
|
* 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.
|
|
16357
16982
|
*
|
|
@@ -16374,6 +16999,134 @@ export interface ModelProviderDescriptor {
|
|
|
16374
16999
|
*/
|
|
16375
17000
|
ordering: number;
|
|
16376
17001
|
}
|
|
17002
|
+
/**
|
|
17003
|
+
* Provider discovery parameters.
|
|
17004
|
+
*
|
|
17005
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17006
|
+
* via the `definition` "ModelProviderDiscoverRequest".
|
|
17007
|
+
*/
|
|
17008
|
+
/** @experimental */
|
|
17009
|
+
export interface ModelProviderDiscoverRequest {
|
|
17010
|
+
/**
|
|
17011
|
+
* Opaque adapter identity returned by `session.providers.getCatalog`.
|
|
17012
|
+
*/
|
|
17013
|
+
adapterId: string;
|
|
17014
|
+
/**
|
|
17015
|
+
* 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.
|
|
17016
|
+
*/
|
|
17017
|
+
input?: JsonValue;
|
|
17018
|
+
}
|
|
17019
|
+
/**
|
|
17020
|
+
* Provider instances found by a discovery operation.
|
|
17021
|
+
*
|
|
17022
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17023
|
+
* via the `definition` "ModelProviderDiscoverResult".
|
|
17024
|
+
*/
|
|
17025
|
+
/** @experimental */
|
|
17026
|
+
export interface ModelProviderDiscoverResult {
|
|
17027
|
+
outcome: ModelProviderOperationOutcome;
|
|
17028
|
+
/**
|
|
17029
|
+
* Discovered provider instances. Empty when passive default discovery finds no reachable provider.
|
|
17030
|
+
*/
|
|
17031
|
+
instances: ModelProviderInstance[];
|
|
17032
|
+
}
|
|
17033
|
+
/**
|
|
17034
|
+
* A normalized model-provider instance discovered by the runtime.
|
|
17035
|
+
*
|
|
17036
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17037
|
+
* via the `definition` "ModelProviderInstance".
|
|
17038
|
+
*/
|
|
17039
|
+
/** @experimental */
|
|
17040
|
+
export interface ModelProviderInstance {
|
|
17041
|
+
reference: ModelProviderInstanceReference;
|
|
17042
|
+
/**
|
|
17043
|
+
* Human-readable instance name.
|
|
17044
|
+
*/
|
|
17045
|
+
displayName: string;
|
|
17046
|
+
provenance: ModelProviderProvenance;
|
|
17047
|
+
/**
|
|
17048
|
+
* Inference API endpoint when the provider exposes one separately from its management endpoint.
|
|
17049
|
+
*/
|
|
17050
|
+
inferenceEndpoint?: string;
|
|
17051
|
+
inferenceType?: ProviderEndpointType;
|
|
17052
|
+
inferenceWireApi?: ProviderEndpointWireApi;
|
|
17053
|
+
inferenceTransport?: ProviderEndpointTransport;
|
|
17054
|
+
}
|
|
17055
|
+
/**
|
|
17056
|
+
* Serializable reference to a discovered provider instance.
|
|
17057
|
+
*
|
|
17058
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17059
|
+
* via the `definition` "ModelProviderInstanceReference".
|
|
17060
|
+
*/
|
|
17061
|
+
/** @experimental */
|
|
17062
|
+
export interface ModelProviderInstanceReference {
|
|
17063
|
+
/**
|
|
17064
|
+
* Stable opaque identity of the adapter that owns this reference. Must be present in the target session's effective catalog.
|
|
17065
|
+
*/
|
|
17066
|
+
adapterId: string;
|
|
17067
|
+
/**
|
|
17068
|
+
* Descriptive provider family. Must match the selected adapter; not a routing key.
|
|
17069
|
+
*/
|
|
17070
|
+
providerKind: string;
|
|
17071
|
+
/**
|
|
17072
|
+
* Stable instance identifier derived by the provider adapter, such as `ollama:{normalizedEndpoint}`.
|
|
17073
|
+
*/
|
|
17074
|
+
id: string;
|
|
17075
|
+
/**
|
|
17076
|
+
* 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.
|
|
17077
|
+
*/
|
|
17078
|
+
managementEndpoint: string;
|
|
17079
|
+
}
|
|
17080
|
+
/**
|
|
17081
|
+
* Provider status request parameters.
|
|
17082
|
+
*
|
|
17083
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17084
|
+
* via the `definition` "ModelProviderGetStatusRequest".
|
|
17085
|
+
*/
|
|
17086
|
+
/** @experimental */
|
|
17087
|
+
export interface ModelProviderGetStatusRequest {
|
|
17088
|
+
instance: ModelProviderInstanceReference;
|
|
17089
|
+
}
|
|
17090
|
+
/**
|
|
17091
|
+
* Provider model inventory request parameters.
|
|
17092
|
+
*
|
|
17093
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17094
|
+
* via the `definition` "ModelProviderModelsListRequest".
|
|
17095
|
+
*/
|
|
17096
|
+
/** @experimental */
|
|
17097
|
+
export interface ModelProviderModelsListRequest {
|
|
17098
|
+
instance: ModelProviderInstanceReference;
|
|
17099
|
+
}
|
|
17100
|
+
/**
|
|
17101
|
+
* 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`.
|
|
17102
|
+
*
|
|
17103
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17104
|
+
* via the `definition` "ModelProviderPrepareConfigurationRequest".
|
|
17105
|
+
*/
|
|
17106
|
+
/** @experimental */
|
|
17107
|
+
export interface ModelProviderPrepareConfigurationRequest {
|
|
17108
|
+
instance: ModelProviderInstance;
|
|
17109
|
+
model: DiscoveredModel;
|
|
17110
|
+
}
|
|
17111
|
+
/**
|
|
17112
|
+
* Current health information for a provider instance.
|
|
17113
|
+
*
|
|
17114
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17115
|
+
* via the `definition` "ModelProviderStatus".
|
|
17116
|
+
*/
|
|
17117
|
+
/** @experimental */
|
|
17118
|
+
export interface ModelProviderStatus {
|
|
17119
|
+
outcome: ModelProviderOperationOutcome;
|
|
17120
|
+
instance: ModelProviderInstance;
|
|
17121
|
+
/**
|
|
17122
|
+
* Open provider status value, such as `healthy`, `unreachable`, or `notInstalled`.
|
|
17123
|
+
*/
|
|
17124
|
+
status: string;
|
|
17125
|
+
/**
|
|
17126
|
+
* Provider-reported version.
|
|
17127
|
+
*/
|
|
17128
|
+
version?: string;
|
|
17129
|
+
}
|
|
16377
17130
|
/**
|
|
16378
17131
|
* 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.
|
|
16379
17132
|
*
|
|
@@ -16681,75 +17434,22 @@ export interface ModeSetResult {
|
|
|
16681
17434
|
*/
|
|
16682
17435
|
deferImplementation?: boolean;
|
|
16683
17436
|
/**
|
|
16684
|
-
* Whether the host should arm an interactive continuation after the mode change.
|
|
16685
|
-
*/
|
|
16686
|
-
armInteractiveContinuation?: boolean;
|
|
16687
|
-
}
|
|
16688
|
-
/**
|
|
16689
|
-
* Result of moving in-flight MCP loading to the background.
|
|
16690
|
-
*
|
|
16691
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16692
|
-
* via the `definition` "MoveMcpLoadingToBackgroundResult".
|
|
16693
|
-
*/
|
|
16694
|
-
/** @experimental */
|
|
16695
|
-
export interface MoveMcpLoadingToBackgroundResult {
|
|
16696
|
-
/**
|
|
16697
|
-
* Whether an in-flight MCP load was moved to the background, releasing turns that were waiting on it. False when no MCP load was in flight or the waiting turns had already been released.
|
|
16698
|
-
*/
|
|
16699
|
-
movedToBackground: boolean;
|
|
16700
|
-
}
|
|
16701
|
-
/**
|
|
16702
|
-
* External SDK input for a named custom model provider. Ingested by the native protocol boundary before host dispatch.
|
|
16703
|
-
*
|
|
16704
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16705
|
-
* via the `definition` "NamedProviderConfig".
|
|
16706
|
-
*/
|
|
16707
|
-
/** @experimental */
|
|
16708
|
-
export interface NamedProviderConfig {
|
|
16709
|
-
/**
|
|
16710
|
-
* Unique provider name used to qualify model selection IDs.
|
|
16711
|
-
*/
|
|
16712
|
-
name: string;
|
|
16713
|
-
type?: ProviderConfigType;
|
|
16714
|
-
wireApi?: ProviderConfigWireApi;
|
|
16715
|
-
transport?: ProviderConfigTransport;
|
|
16716
|
-
/**
|
|
16717
|
-
* Base URL for provider API requests.
|
|
16718
|
-
*/
|
|
16719
|
-
baseUrl: string;
|
|
16720
|
-
/**
|
|
16721
|
-
* Static API key used to authenticate provider requests.
|
|
16722
|
-
*/
|
|
16723
|
-
apiKey?: string;
|
|
16724
|
-
/**
|
|
16725
|
-
* Static bearer token used to authenticate provider requests.
|
|
16726
|
-
*/
|
|
16727
|
-
bearerToken?: string;
|
|
16728
|
-
azure?: ProviderConfigAzure;
|
|
16729
|
-
/**
|
|
16730
|
-
* Additional HTTP headers included with provider requests.
|
|
16731
|
-
*/
|
|
16732
|
-
headers?: {
|
|
16733
|
-
[k: string]: string | undefined;
|
|
16734
|
-
};
|
|
16735
|
-
modelProvider?: ProviderConfigModelProvider;
|
|
16736
|
-
/**
|
|
16737
|
-
* Whether the host supplies bearer tokens dynamically.
|
|
17437
|
+
* Whether the host should arm an interactive continuation after the mode change.
|
|
16738
17438
|
*/
|
|
16739
|
-
|
|
17439
|
+
armInteractiveContinuation?: boolean;
|
|
16740
17440
|
}
|
|
16741
17441
|
/**
|
|
16742
|
-
*
|
|
17442
|
+
* Result of moving in-flight MCP loading to the background.
|
|
16743
17443
|
*
|
|
16744
17444
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
16745
|
-
* via the `definition` "
|
|
17445
|
+
* via the `definition` "MoveMcpLoadingToBackgroundResult".
|
|
16746
17446
|
*/
|
|
16747
17447
|
/** @experimental */
|
|
16748
|
-
export interface
|
|
17448
|
+
export interface MoveMcpLoadingToBackgroundResult {
|
|
16749
17449
|
/**
|
|
16750
|
-
*
|
|
17450
|
+
* Whether an in-flight MCP load was moved to the background, releasing turns that were waiting on it. False when no MCP load was in flight or the waiting turns had already been released.
|
|
16751
17451
|
*/
|
|
16752
|
-
|
|
17452
|
+
movedToBackground: boolean;
|
|
16753
17453
|
}
|
|
16754
17454
|
/**
|
|
16755
17455
|
* The session's friendly name, or null when not yet set.
|
|
@@ -18890,63 +19590,6 @@ export interface ProtocolExternalToolDefinition {
|
|
|
18890
19590
|
[k: string]: JsonValue | undefined;
|
|
18891
19591
|
};
|
|
18892
19592
|
}
|
|
18893
|
-
/** @experimental */
|
|
18894
|
-
export interface ProtocolStaticSectionOverride {
|
|
18895
|
-
action: ProtocolStaticSectionAction;
|
|
18896
|
-
/**
|
|
18897
|
-
* Optional content used by replace, append, and prepend operations.
|
|
18898
|
-
*/
|
|
18899
|
-
content?: string;
|
|
18900
|
-
}
|
|
18901
|
-
/** @experimental */
|
|
18902
|
-
export interface ProtocolSystemMessageAppendConfig {
|
|
18903
|
-
mode?: ProtocolAppendMode;
|
|
18904
|
-
/**
|
|
18905
|
-
* Text appended to the standard system prompt.
|
|
18906
|
-
*/
|
|
18907
|
-
content?: string;
|
|
18908
|
-
}
|
|
18909
|
-
/** @experimental */
|
|
18910
|
-
export interface ProtocolSystemMessageReplaceConfig {
|
|
18911
|
-
mode: ProtocolReplaceMode;
|
|
18912
|
-
/**
|
|
18913
|
-
* Complete replacement system-message text.
|
|
18914
|
-
*/
|
|
18915
|
-
content: string;
|
|
18916
|
-
/**
|
|
18917
|
-
* Optional structured blocks corresponding to the replacement content.
|
|
18918
|
-
*/
|
|
18919
|
-
contentBlocks?: SystemMessageBlock[];
|
|
18920
|
-
}
|
|
18921
|
-
/** @experimental */
|
|
18922
|
-
export interface SystemMessageBlock {
|
|
18923
|
-
/**
|
|
18924
|
-
* Text content for this system-message block.
|
|
18925
|
-
*/
|
|
18926
|
-
content: string;
|
|
18927
|
-
/**
|
|
18928
|
-
* Whether the block is static and may be cached independently of dynamic prompt content.
|
|
18929
|
-
*/
|
|
18930
|
-
isStatic?: boolean;
|
|
18931
|
-
/**
|
|
18932
|
-
* Whether providers with explicit prompt caching should place a cache breakpoint after this block.
|
|
18933
|
-
*/
|
|
18934
|
-
cacheBreakpoint?: boolean;
|
|
18935
|
-
}
|
|
18936
|
-
/** @experimental */
|
|
18937
|
-
export interface ProtocolSystemMessageCustomizeConfig {
|
|
18938
|
-
mode: ProtocolCustomizeMode;
|
|
18939
|
-
/**
|
|
18940
|
-
* Named standard-prompt section overrides.
|
|
18941
|
-
*/
|
|
18942
|
-
sections?: {
|
|
18943
|
-
[k: string]: ProtocolSectionOverride;
|
|
18944
|
-
};
|
|
18945
|
-
/**
|
|
18946
|
-
* Text appended after the customized sections.
|
|
18947
|
-
*/
|
|
18948
|
-
content?: string;
|
|
18949
|
-
}
|
|
18950
19593
|
/**
|
|
18951
19594
|
* BYOK providers and/or models to add to the session's registry at runtime. Both fields are optional; provide providers, models, or both.
|
|
18952
19595
|
*
|
|
@@ -18964,55 +19607,6 @@ export interface ProviderAddRequest {
|
|
|
18964
19607
|
*/
|
|
18965
19608
|
models?: ProviderModelConfig[];
|
|
18966
19609
|
}
|
|
18967
|
-
/**
|
|
18968
|
-
* A BYOK model definition referencing a named provider.
|
|
18969
|
-
*
|
|
18970
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18971
|
-
* via the `definition` "ProviderModelConfig".
|
|
18972
|
-
*/
|
|
18973
|
-
/** @experimental */
|
|
18974
|
-
export interface ProviderModelConfig {
|
|
18975
|
-
/**
|
|
18976
|
-
* 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`.
|
|
18977
|
-
*/
|
|
18978
|
-
id: string;
|
|
18979
|
-
/**
|
|
18980
|
-
* Name of the configured provider that serves this model.
|
|
18981
|
-
*/
|
|
18982
|
-
provider: string;
|
|
18983
|
-
/**
|
|
18984
|
-
* The model name sent to the provider API for inference. Defaults to `id`.
|
|
18985
|
-
*/
|
|
18986
|
-
wireModel?: string;
|
|
18987
|
-
/**
|
|
18988
|
-
* Well-known base model id used for behavior/capability/config lookup. Defaults to `id`.
|
|
18989
|
-
*/
|
|
18990
|
-
modelId?: string;
|
|
18991
|
-
/**
|
|
18992
|
-
* Display name for model pickers. Defaults to the provider-qualified selection id (`provider/id`).
|
|
18993
|
-
*/
|
|
18994
|
-
name?: string;
|
|
18995
|
-
/**
|
|
18996
|
-
* Maximum prompt/input tokens for the model.
|
|
18997
|
-
*/
|
|
18998
|
-
maxPromptTokens?: number;
|
|
18999
|
-
/**
|
|
19000
|
-
* Maximum context window tokens for the model.
|
|
19001
|
-
*/
|
|
19002
|
-
maxContextWindowTokens?: number;
|
|
19003
|
-
/**
|
|
19004
|
-
* Maximum output tokens for the model.
|
|
19005
|
-
*/
|
|
19006
|
-
maxOutputTokens?: number;
|
|
19007
|
-
capabilities?: ModelCapabilitiesOverride;
|
|
19008
|
-
systemMessage?: ProtocolSystemMessageConfig;
|
|
19009
|
-
/**
|
|
19010
|
-
* Provider-published model metadata, preserved verbatim as the public Model.metadata object.
|
|
19011
|
-
*/
|
|
19012
|
-
metadata?: {
|
|
19013
|
-
[k: string]: JsonValue | undefined;
|
|
19014
|
-
};
|
|
19015
|
-
}
|
|
19016
19610
|
/**
|
|
19017
19611
|
* The selectable model entries synthesized for the models added by this call.
|
|
19018
19612
|
*
|
|
@@ -20891,6 +21485,47 @@ export interface SandboxHostSupport {
|
|
|
20891
21485
|
*/
|
|
20892
21486
|
capabilities: SandboxHostCapability[];
|
|
20893
21487
|
}
|
|
21488
|
+
/**
|
|
21489
|
+
* Result of creating the persistent certificate authority of the sandbox credential proxy.
|
|
21490
|
+
*
|
|
21491
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21492
|
+
* via the `definition` "SandboxProxyCaCreateResult".
|
|
21493
|
+
*/
|
|
21494
|
+
/** @experimental */
|
|
21495
|
+
export interface SandboxProxyCaCreateResult {
|
|
21496
|
+
/**
|
|
21497
|
+
* Absolute path of the public certificate of the certificate authority, in PEM format.
|
|
21498
|
+
*/
|
|
21499
|
+
certificatePath: string;
|
|
21500
|
+
}
|
|
21501
|
+
/**
|
|
21502
|
+
* 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.
|
|
21503
|
+
*
|
|
21504
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21505
|
+
* via the `definition` "SandboxProxyCaRequest".
|
|
21506
|
+
*/
|
|
21507
|
+
/** @experimental */
|
|
21508
|
+
export interface SandboxProxyCaRequest {
|
|
21509
|
+
sandboxConfig?: SandboxConfig;
|
|
21510
|
+
}
|
|
21511
|
+
/**
|
|
21512
|
+
* Status of the persistent certificate authority of the sandbox credential proxy.
|
|
21513
|
+
*
|
|
21514
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21515
|
+
* via the `definition` "SandboxProxyCaStatus".
|
|
21516
|
+
*/
|
|
21517
|
+
/** @experimental */
|
|
21518
|
+
export interface SandboxProxyCaStatus {
|
|
21519
|
+
state: SandboxProxyCaState;
|
|
21520
|
+
/**
|
|
21521
|
+
* Human-readable reason for the state. On `installed` or `notInstalled`, present only when the certificate authority must be rotated, and then says why.
|
|
21522
|
+
*/
|
|
21523
|
+
detail?: string;
|
|
21524
|
+
/**
|
|
21525
|
+
* 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.
|
|
21526
|
+
*/
|
|
21527
|
+
canInstall: boolean;
|
|
21528
|
+
}
|
|
20894
21529
|
/**
|
|
20895
21530
|
* Register an absolute-time scheduled prompt.
|
|
20896
21531
|
*
|
|
@@ -21570,6 +22205,10 @@ export interface SessionFsError {
|
|
|
21570
22205
|
* Free-form detail about the error, for logging/diagnostics
|
|
21571
22206
|
*/
|
|
21572
22207
|
message?: string;
|
|
22208
|
+
/**
|
|
22209
|
+
* For failed writeFile requests only: true if the provider changed the target before failing. Omit when unknown or unchanged.
|
|
22210
|
+
*/
|
|
22211
|
+
writeChanged?: boolean;
|
|
21573
22212
|
}
|
|
21574
22213
|
/**
|
|
21575
22214
|
* Path to test for existence in the client-provided session filesystem.
|
|
@@ -21702,6 +22341,37 @@ export interface SessionFsReaddirWithTypesResult {
|
|
|
21702
22341
|
entries: SessionFsReaddirWithTypesEntry[];
|
|
21703
22342
|
error?: SessionFsError;
|
|
21704
22343
|
}
|
|
22344
|
+
/**
|
|
22345
|
+
* Path of the binary file to read from the client-provided session filesystem.
|
|
22346
|
+
*
|
|
22347
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
22348
|
+
* via the `definition` "SessionFsReadFileBytesRequest".
|
|
22349
|
+
*/
|
|
22350
|
+
/** @experimental */
|
|
22351
|
+
export interface SessionFsReadFileBytesRequest {
|
|
22352
|
+
/**
|
|
22353
|
+
* Target session identifier
|
|
22354
|
+
*/
|
|
22355
|
+
sessionId: string;
|
|
22356
|
+
/**
|
|
22357
|
+
* Path using SessionFs conventions
|
|
22358
|
+
*/
|
|
22359
|
+
path: string;
|
|
22360
|
+
}
|
|
22361
|
+
/**
|
|
22362
|
+
* File bytes as standard base64, or a filesystem error if the read failed.
|
|
22363
|
+
*
|
|
22364
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
22365
|
+
* via the `definition` "SessionFsReadFileBytesResult".
|
|
22366
|
+
*/
|
|
22367
|
+
/** @experimental */
|
|
22368
|
+
export interface SessionFsReadFileBytesResult {
|
|
22369
|
+
/**
|
|
22370
|
+
* Exact file bytes encoded as standard base64
|
|
22371
|
+
*/
|
|
22372
|
+
content: string;
|
|
22373
|
+
error?: SessionFsError;
|
|
22374
|
+
}
|
|
21705
22375
|
/**
|
|
21706
22376
|
* Path of the file to read from the client-provided session filesystem.
|
|
21707
22377
|
*
|
|
@@ -21791,6 +22461,10 @@ export interface SessionFsSetProviderCapabilities {
|
|
|
21791
22461
|
* Whether the provider supports SQLite query/exists operations
|
|
21792
22462
|
*/
|
|
21793
22463
|
sqlite?: boolean;
|
|
22464
|
+
/**
|
|
22465
|
+
* Whether the provider supports binary reads and writes through sessionFs.readFileBytes and sessionFs.writeFileBytes
|
|
22466
|
+
*/
|
|
22467
|
+
binary?: boolean;
|
|
21794
22468
|
}
|
|
21795
22469
|
/**
|
|
21796
22470
|
* 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.
|
|
@@ -22001,6 +22675,31 @@ export interface SessionFsStatResult {
|
|
|
22001
22675
|
birthtime: string;
|
|
22002
22676
|
error?: SessionFsError;
|
|
22003
22677
|
}
|
|
22678
|
+
/**
|
|
22679
|
+
* File path, standard-base64-encoded bytes to write, and optional mode for the client-provided session filesystem.
|
|
22680
|
+
*
|
|
22681
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
22682
|
+
* via the `definition` "SessionFsWriteFileBytesRequest".
|
|
22683
|
+
*/
|
|
22684
|
+
/** @experimental */
|
|
22685
|
+
export interface SessionFsWriteFileBytesRequest {
|
|
22686
|
+
/**
|
|
22687
|
+
* Target session identifier
|
|
22688
|
+
*/
|
|
22689
|
+
sessionId: string;
|
|
22690
|
+
/**
|
|
22691
|
+
* Path using SessionFs conventions
|
|
22692
|
+
*/
|
|
22693
|
+
path: string;
|
|
22694
|
+
/**
|
|
22695
|
+
* Exact file bytes encoded as standard base64
|
|
22696
|
+
*/
|
|
22697
|
+
content: string;
|
|
22698
|
+
/**
|
|
22699
|
+
* Optional POSIX-style mode for newly created files
|
|
22700
|
+
*/
|
|
22701
|
+
mode?: number;
|
|
22702
|
+
}
|
|
22004
22703
|
/**
|
|
22005
22704
|
* File path, content to write, and optional mode for the client-provided session filesystem.
|
|
22006
22705
|
*
|
|
@@ -29127,6 +29826,47 @@ export declare function createServerRpc(connection: MessageConnection): {
|
|
|
29127
29826
|
* @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.
|
|
29128
29827
|
*/
|
|
29129
29828
|
getHostSupport: () => Promise<SandboxHostSupport>;
|
|
29829
|
+
/** @experimental */
|
|
29830
|
+
proxyCa: {
|
|
29831
|
+
/**
|
|
29832
|
+
* 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.
|
|
29833
|
+
*
|
|
29834
|
+
* @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.
|
|
29835
|
+
*
|
|
29836
|
+
* @returns Status of the persistent certificate authority of the sandbox credential proxy.
|
|
29837
|
+
*/
|
|
29838
|
+
getStatus: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
|
|
29839
|
+
/**
|
|
29840
|
+
* 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.
|
|
29841
|
+
*
|
|
29842
|
+
* @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.
|
|
29843
|
+
*
|
|
29844
|
+
* @returns Result of creating the persistent certificate authority of the sandbox credential proxy.
|
|
29845
|
+
*/
|
|
29846
|
+
create: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaCreateResult>;
|
|
29847
|
+
/**
|
|
29848
|
+
* 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.
|
|
29849
|
+
*
|
|
29850
|
+
* @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.
|
|
29851
|
+
*
|
|
29852
|
+
* @returns Status of the persistent certificate authority of the sandbox credential proxy.
|
|
29853
|
+
*/
|
|
29854
|
+
rotate: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
|
|
29855
|
+
/**
|
|
29856
|
+
* 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.
|
|
29857
|
+
*
|
|
29858
|
+
* @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.
|
|
29859
|
+
*
|
|
29860
|
+
* @returns Status of the persistent certificate authority of the sandbox credential proxy.
|
|
29861
|
+
*/
|
|
29862
|
+
trust: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
|
|
29863
|
+
/**
|
|
29864
|
+
* 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.
|
|
29865
|
+
*
|
|
29866
|
+
* @returns Status of the persistent certificate authority of the sandbox credential proxy.
|
|
29867
|
+
*/
|
|
29868
|
+
remove: () => Promise<SandboxProxyCaStatus>;
|
|
29869
|
+
};
|
|
29130
29870
|
};
|
|
29131
29871
|
/** @experimental */
|
|
29132
29872
|
tools: {
|
|
@@ -29942,6 +30682,50 @@ export declare function createServerRpc(connection: MessageConnection): {
|
|
|
29942
30682
|
};
|
|
29943
30683
|
/** Create typed session-scoped RPC methods. */
|
|
29944
30684
|
export declare function createSessionRpc(connection: MessageConnection, sessionId: string): {
|
|
30685
|
+
/** @experimental */
|
|
30686
|
+
providers: {
|
|
30687
|
+
/**
|
|
30688
|
+
* 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.
|
|
30689
|
+
*
|
|
30690
|
+
* @returns Normalized model-provider adapter definitions available to the session, not discovered instances.
|
|
30691
|
+
*/
|
|
30692
|
+
getCatalog: () => Promise<ModelProviderAdapterCatalog>;
|
|
30693
|
+
/**
|
|
30694
|
+
* Discovers reachable instances using an adapter from this session's effective provider catalog and provider-specific discovery input.
|
|
30695
|
+
*
|
|
30696
|
+
* @param params Provider discovery parameters.
|
|
30697
|
+
*
|
|
30698
|
+
* @returns Provider instances found by a discovery operation.
|
|
30699
|
+
*/
|
|
30700
|
+
discover: (params: ModelProviderDiscoverRequest) => Promise<ModelProviderDiscoverResult>;
|
|
30701
|
+
/**
|
|
30702
|
+
* Gets current health and version information for a discovered model-provider instance.
|
|
30703
|
+
*
|
|
30704
|
+
* @param params Provider status request parameters.
|
|
30705
|
+
*
|
|
30706
|
+
* @returns Current health information for a provider instance.
|
|
30707
|
+
*/
|
|
30708
|
+
getStatus: (params: ModelProviderGetStatusRequest) => Promise<ModelProviderStatus>;
|
|
30709
|
+
/** @experimental */
|
|
30710
|
+
models: {
|
|
30711
|
+
/**
|
|
30712
|
+
* Lists models installed or otherwise available from a discovered model-provider instance.
|
|
30713
|
+
*
|
|
30714
|
+
* @param params Provider model inventory request parameters.
|
|
30715
|
+
*
|
|
30716
|
+
* @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.
|
|
30717
|
+
*/
|
|
30718
|
+
list: (params: ModelProviderModelsListRequest) => Promise<DiscoveredModelList>;
|
|
30719
|
+
/**
|
|
30720
|
+
* 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.
|
|
30721
|
+
*
|
|
30722
|
+
* @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`.
|
|
30723
|
+
*
|
|
30724
|
+
* @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.
|
|
30725
|
+
*/
|
|
30726
|
+
prepareConfiguration: (params: ModelProviderPrepareConfigurationRequest) => Promise<ModelProviderConfigurationPlan>;
|
|
30727
|
+
};
|
|
30728
|
+
};
|
|
29945
30729
|
/**
|
|
29946
30730
|
* Suspends the session while preserving persisted state for later resume.
|
|
29947
30731
|
*
|
|
@@ -30549,18 +31333,20 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
30549
31333
|
*/
|
|
30550
31334
|
getSources: () => Promise<InstructionsGetSourcesResult>;
|
|
30551
31335
|
/**
|
|
30552
|
-
*
|
|
31336
|
+
* 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.
|
|
31337
|
+
*
|
|
31338
|
+
* @returns Instruction sources loaded for the session, in merge order.
|
|
30553
31339
|
*/
|
|
30554
|
-
reload: () => Promise<
|
|
31340
|
+
reload: () => Promise<InstructionsGetSourcesResult>;
|
|
30555
31341
|
};
|
|
30556
31342
|
/** @experimental */
|
|
30557
31343
|
customizations: {
|
|
30558
31344
|
/**
|
|
30559
|
-
*
|
|
31345
|
+
* 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.
|
|
30560
31346
|
*
|
|
30561
|
-
* @returns
|
|
31347
|
+
* @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.
|
|
30562
31348
|
*/
|
|
30563
|
-
reload: () => Promise<
|
|
31349
|
+
reload: () => Promise<CustomizationsReloadResult>;
|
|
30564
31350
|
};
|
|
30565
31351
|
/** @experimental */
|
|
30566
31352
|
fleet: {
|
|
@@ -30751,11 +31537,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
30751
31537
|
/** @experimental */
|
|
30752
31538
|
mcp: {
|
|
30753
31539
|
/**
|
|
30754
|
-
* Lists MCP servers
|
|
31540
|
+
* Lists materialized MCP servers and their connection status. Cache misses may start and wait for MCP servers.
|
|
30755
31541
|
*
|
|
30756
31542
|
* @returns MCP servers configured for the session, with their connection status and host-level state.
|
|
30757
31543
|
*/
|
|
30758
31544
|
list: () => Promise<McpServerList>;
|
|
31545
|
+
/**
|
|
31546
|
+
* 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.
|
|
31547
|
+
*
|
|
31548
|
+
* @returns Effective MCP configuration with optional live observations from matching already materialized servers.
|
|
31549
|
+
*/
|
|
31550
|
+
listConfigured: () => Promise<McpConfiguredServerList>;
|
|
30759
31551
|
/**
|
|
30760
31552
|
* 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.
|
|
30761
31553
|
*
|
|
@@ -32137,6 +32929,14 @@ export interface SessionFsHandler {
|
|
|
32137
32929
|
* @returns File content as a UTF-8 string, or a filesystem error if the read failed.
|
|
32138
32930
|
*/
|
|
32139
32931
|
readFile(params: SessionFsReadFileRequest): Promise<SessionFsReadFileResult>;
|
|
32932
|
+
/**
|
|
32933
|
+
* Reads binary file content from the client-provided session filesystem.
|
|
32934
|
+
*
|
|
32935
|
+
* @param params Path of the binary file to read from the client-provided session filesystem.
|
|
32936
|
+
*
|
|
32937
|
+
* @returns File bytes as standard base64, or a filesystem error if the read failed.
|
|
32938
|
+
*/
|
|
32939
|
+
readFileBytes(params: SessionFsReadFileBytesRequest): Promise<SessionFsReadFileBytesResult>;
|
|
32140
32940
|
/**
|
|
32141
32941
|
* Writes a file in the client-provided session filesystem.
|
|
32142
32942
|
*
|
|
@@ -32145,6 +32945,14 @@ export interface SessionFsHandler {
|
|
|
32145
32945
|
* @returns Describes a filesystem error.
|
|
32146
32946
|
*/
|
|
32147
32947
|
writeFile(params: SessionFsWriteFileRequest): Promise<SessionFsError | undefined>;
|
|
32948
|
+
/**
|
|
32949
|
+
* Writes binary file content to the client-provided session filesystem.
|
|
32950
|
+
*
|
|
32951
|
+
* @param params File path, standard-base64-encoded bytes to write, and optional mode for the client-provided session filesystem.
|
|
32952
|
+
*
|
|
32953
|
+
* @returns Describes a filesystem error.
|
|
32954
|
+
*/
|
|
32955
|
+
writeFileBytes(params: SessionFsWriteFileBytesRequest): Promise<SessionFsError | undefined>;
|
|
32148
32956
|
/**
|
|
32149
32957
|
* Appends content to a file in the client-provided session filesystem, creating parent directories as needed.
|
|
32150
32958
|
*
|