@github/copilot-sdk-win32-x64 1.0.17-preview.2 → 1.0.17-preview.4

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.
@@ -1394,6 +1394,44 @@ export type ContentFilterMode =
1394
1394
  | "markdown"
1395
1395
  /** Remove characters that can hide directives. */
1396
1396
  | "hidden_characters";
1397
+ /**
1398
+ * Component of session customization discovery.
1399
+ *
1400
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
1401
+ * via the `definition` "CustomizationReloadSubsystem".
1402
+ */
1403
+ /** @experimental */
1404
+ export type CustomizationReloadSubsystem =
1405
+ /** Repository metadata and working-directory context. */
1406
+ "repositoryContext"
1407
+ /** Session instructions and their cached dynamic context. */
1408
+ | "instructions"
1409
+ /** Discovered plugin configuration. */
1410
+ | "plugins"
1411
+ /** Configured session and plugin hooks. */
1412
+ | "hooks"
1413
+ /** Discovered skills. */
1414
+ | "skills"
1415
+ /** Discovered custom agents. */
1416
+ | "agents"
1417
+ /** Loaded MCP server configuration. */
1418
+ | "mcp"
1419
+ /** Configured session extensions. */
1420
+ | "extensions" | (string & {});
1421
+ /**
1422
+ * Result of reloading a customization component.
1423
+ *
1424
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
1425
+ * via the `definition` "CustomizationReloadStatus".
1426
+ */
1427
+ /** @experimental */
1428
+ export type CustomizationReloadStatus =
1429
+ /** The component was refreshed successfully. */
1430
+ "reloaded"
1431
+ /** The component was not configured, loaded, or eligible for refresh. */
1432
+ | "skipped"
1433
+ /** The component could not be refreshed; other components may still reload. */
1434
+ | "failed" | (string & {});
1397
1435
  /**
1398
1436
  * Source category for a collected debug bundle entry.
1399
1437
  *
@@ -1700,57 +1738,45 @@ export type DiscoveredMcpServerType =
1700
1738
  /** Server is backed by an in-memory runtime implementation. */
1701
1739
  | "memory";
1702
1740
  /**
1703
- * Indicates whether the command was accepted into the local execution queue.
1741
+ * Kind of component that supplied a provider adapter or row. Attribution does not confer authority.
1704
1742
  *
1705
1743
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
1706
- * via the `definition` "EnqueueCommandResult".
1744
+ * via the `definition` "ModelProviderProvenanceSource".
1707
1745
  */
1708
1746
  /** @experimental */
1709
- export type EnqueueCommandResult = AcceptedEnqueueCommandResult | UnsupportedEnqueueCommandResult;
1747
+ export type ModelProviderProvenanceSource =
1748
+ /** Built into the runtime. */
1749
+ "builtIn"
1750
+ /** Derived from existing user configuration. */
1751
+ | "configured"
1752
+ /** Supplied by an extension. */
1753
+ | "extension"
1754
+ /** Supplied by another trusted contributor. */
1755
+ | "custom";
1710
1756
  /**
1711
- * How far OneAuth may go to acquire the requested token.
1757
+ * Typed outcome for a provider operation.
1712
1758
  *
1713
1759
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
1714
- * via the `definition` "EntraTokenInteraction".
1760
+ * via the `definition` "ModelProviderOperationOutcomeCode".
1715
1761
  */
1716
1762
  /** @experimental */
1717
- export type EntraTokenInteraction =
1718
- /** Acquire the token without any user interaction, failing if interaction would be required. */
1719
- "silent"
1720
- /** Allow interactive acquisition, prompting the user only when a cached or silent token is unavailable. */
1721
- | "interactive"
1722
- /** Always prompt interactively, bypassing any cached or silently-refreshable token. */
1723
- | "force-interactive";
1763
+ export type ModelProviderOperationOutcomeCode =
1764
+ /** The operation completed successfully; an empty inventory is valid. */
1765
+ "success"
1766
+ /** The provider or instance is absent during discovery, status, or model listing. Distinct from a successful empty inventory. */
1767
+ | "absent"
1768
+ /** The provider is configured or expected but could not be reached. */
1769
+ | "unreachable"
1770
+ /** The operation failed for a reason other than absence or reachability. */
1771
+ | "failed";
1724
1772
  /**
1725
- * Result of a OneAuth token acquisition.
1773
+ * Indicates whether the command was accepted into the local execution queue.
1726
1774
  *
1727
1775
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
1728
- * via the `definition` "EntraTokenAcquireResult".
1776
+ * via the `definition` "EnqueueCommandResult".
1729
1777
  */
1730
1778
  /** @experimental */
1731
- export type EntraTokenAcquireResult = {
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
- };
1779
+ export type EnqueueCommandResult = AcceptedEnqueueCommandResult | UnsupportedEnqueueCommandResult;
1754
1780
  /**
1755
1781
  * GitHub Mission Control compute kind.
1756
1782
  *
@@ -3604,17 +3630,49 @@ export type ModelListRequest = {
3604
3630
  skipCache?: boolean;
3605
3631
  };
3606
3632
  /**
3607
- * Whether the requested preference was already effective or was accepted for later transactional activation.
3633
+ * When the runtime may run an adapter without an explicit user action.
3608
3634
  *
3609
3635
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3610
- * via the `definition` "ModelSwitchAutoTierStatus".
3636
+ * via the `definition` "ModelProviderAutomaticDiscoveryMode".
3611
3637
  */
3612
3638
  /** @experimental */
3613
- export type ModelSwitchAutoTierStatus =
3614
- /** 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`. */
3615
- "unchanged"
3616
- /** 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. */
3617
- | "pending";
3639
+ export type ModelProviderAutomaticDiscoveryMode =
3640
+ /** The adapter declares that automatic discovery is safe when the other policy fields are satisfied. */
3641
+ "automatic"
3642
+ /** The adapter may refresh instances the user already configured, but must not scan for new instances automatically. */
3643
+ | "configuredOnly"
3644
+ /** The adapter must run only after an explicit user action. */
3645
+ | "explicit";
3646
+ /**
3647
+ * Network reach an adapter may use during discovery.
3648
+ *
3649
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3650
+ * via the `definition` "ModelProviderDiscoveryNetworkScope".
3651
+ */
3652
+ /** @experimental */
3653
+ export type ModelProviderDiscoveryNetworkScope =
3654
+ /** Discovery does not contact a network service. */
3655
+ "none"
3656
+ /** Discovery is limited to loopback addresses on the local machine. */
3657
+ | "loopbackOnly"
3658
+ /** Discovery contacts only endpoints the user already configured. */
3659
+ | "configuredEndpointOnly"
3660
+ /** Discovery may scan or contact the local network. */
3661
+ | "localNetwork"
3662
+ /** Discovery may contact remote internet services. */
3663
+ | "internet";
3664
+ /**
3665
+ * Whether a planned configuration entry is new or already present in the session registry.
3666
+ *
3667
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3668
+ * via the `definition` "ModelProviderConfigurationDisposition".
3669
+ */
3670
+ /** @experimental */
3671
+ export type ModelProviderConfigurationDisposition =
3672
+ /** No matching entry is registered; the caller should add the entry. */
3673
+ "create"
3674
+ /** An equivalent entry is already registered; the caller should reuse it rather than adding a duplicate. */
3675
+ | "alreadyConfigured";
3618
3676
  /**
3619
3677
  * Provider type. Defaults to "openai" for generic OpenAI-compatible APIs.
3620
3678
  *
@@ -3653,6 +3711,110 @@ export type ProviderConfigTransport =
3653
3711
  "http"
3654
3712
  /** WebSocket transport. */
3655
3713
  | "websockets";
3714
+ /**
3715
+ * The product serving the model, reported in telemetry as `model_provider`.
3716
+ *
3717
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3718
+ * via the `definition` "ProviderConfigModelProvider".
3719
+ */
3720
+ /** @experimental */
3721
+ export type ProviderConfigModelProvider =
3722
+ /** OpenAI API. */
3723
+ "openai"
3724
+ /** Anthropic API. */
3725
+ | "anthropic"
3726
+ /** Azure OpenAI Service. */
3727
+ | "azure_openai"
3728
+ /** Ollama. */
3729
+ | "ollama"
3730
+ /** LM Studio. */
3731
+ | "lm_studio"
3732
+ /** Foundry Local. */
3733
+ | "foundry_local"
3734
+ /** llama.cpp server. */
3735
+ | "llama_cpp";
3736
+ /** @experimental */
3737
+ export type ProtocolSystemMessageConfig = ProtocolSystemMessageAppendConfig | ProtocolSystemMessageReplaceConfig | ProtocolSystemMessageCustomizeConfig;
3738
+ /** @experimental */
3739
+ export type ProtocolAppendMode = "append";
3740
+ /** @experimental */
3741
+ export type ProtocolReplaceMode = "replace";
3742
+ /** @experimental */
3743
+ export type ProtocolCustomizeMode = "customize";
3744
+ /** @experimental */
3745
+ export type ProtocolSectionOverride = (ProtocolStaticSectionOverride | ProtocolMarkerSectionOverride) | undefined;
3746
+ /** @experimental */
3747
+ export type ProtocolStaticSectionAction =
3748
+ /** Replace the section content. */
3749
+ "replace"
3750
+ /** Remove the section content. */
3751
+ | "remove"
3752
+ /** Append content to the section. */
3753
+ | "append"
3754
+ /** Prepend content to the section. */
3755
+ | "prepend";
3756
+ /** @experimental */
3757
+ export type ProtocolMarkerSectionOverride = {
3758
+ /**
3759
+ * Section override action discriminator.
3760
+ */
3761
+ action: "transform";
3762
+ } | {
3763
+ /**
3764
+ * Section override action discriminator.
3765
+ */
3766
+ action: "preserve";
3767
+ };
3768
+ /**
3769
+ * Provider family. Matches the `type` field of a BYOK provider config.
3770
+ *
3771
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3772
+ * via the `definition` "ProviderEndpointType".
3773
+ */
3774
+ /** @experimental */
3775
+ export type ProviderEndpointType =
3776
+ /** OpenAI-compatible endpoint (use the OpenAI client library). */
3777
+ "openai"
3778
+ /** Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). */
3779
+ | "azure"
3780
+ /** Anthropic endpoint (use the Anthropic client library). */
3781
+ | "anthropic";
3782
+ /**
3783
+ * Wire API to be used, when required for the provider type.
3784
+ *
3785
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3786
+ * via the `definition` "ProviderEndpointWireApi".
3787
+ */
3788
+ /** @experimental */
3789
+ export type ProviderEndpointWireApi =
3790
+ /** Classic chat-completions request shape. */
3791
+ "completions"
3792
+ /** Newer responses request shape. */
3793
+ | "responses";
3794
+ /**
3795
+ * Transport to be used for provider requests.
3796
+ *
3797
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3798
+ * via the `definition` "ProviderEndpointTransport".
3799
+ */
3800
+ /** @experimental */
3801
+ export type ProviderEndpointTransport =
3802
+ /** HTTP request/streaming transport. */
3803
+ "http"
3804
+ /** WebSocket transport. */
3805
+ | "websockets";
3806
+ /**
3807
+ * Whether the requested preference was already effective or was accepted for later transactional activation.
3808
+ *
3809
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3810
+ * via the `definition` "ModelSwitchAutoTierStatus".
3811
+ */
3812
+ /** @experimental */
3813
+ export type ModelSwitchAutoTierStatus =
3814
+ /** 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`. */
3815
+ "unchanged"
3816
+ /** 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. */
3817
+ | "pending";
3656
3818
  /**
3657
3819
  * Allowed values for the `OptionsUpdateAdditionalContentExclusionPolicyScope` enumeration.
3658
3820
  *
@@ -3910,10 +4072,6 @@ export type PluginsReloadRequest = {
3910
4072
  */
3911
4073
  deferRepoHooks?: boolean;
3912
4074
  };
3913
- /** @experimental */
3914
- export type ProtocolAppendMode = "append";
3915
- /** @experimental */
3916
- export type ProtocolCustomizeMode = "customize";
3917
4075
  /**
3918
4076
  * Controls whether the runtime may defer loading an external tool definition.
3919
4077
  *
@@ -3926,72 +4084,6 @@ export type ProtocolExternalToolDefer =
3926
4084
  "auto"
3927
4085
  /** The runtime must include the tool without deferring it. */
3928
4086
  | "never";
3929
- /** @experimental */
3930
- export type ProtocolMarkerSectionOverride = {
3931
- /**
3932
- * Section override action discriminator.
3933
- */
3934
- action: "transform";
3935
- } | {
3936
- /**
3937
- * Section override action discriminator.
3938
- */
3939
- action: "preserve";
3940
- };
3941
- /** @experimental */
3942
- export type ProtocolReplaceMode = "replace";
3943
- /** @experimental */
3944
- export type ProtocolSectionOverride = ProtocolStaticSectionOverride | ProtocolMarkerSectionOverride;
3945
- /** @experimental */
3946
- export type ProtocolStaticSectionAction =
3947
- /** Replace the section content. */
3948
- "replace"
3949
- /** Remove the section content. */
3950
- | "remove"
3951
- /** Append content to the section. */
3952
- | "append"
3953
- /** Prepend content to the section. */
3954
- | "prepend";
3955
- /** @experimental */
3956
- export type ProtocolSystemMessageConfig = ProtocolSystemMessageAppendConfig | ProtocolSystemMessageReplaceConfig | ProtocolSystemMessageCustomizeConfig;
3957
- /**
3958
- * Provider family. Matches the `type` field of a BYOK provider config.
3959
- *
3960
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3961
- * via the `definition` "ProviderEndpointType".
3962
- */
3963
- /** @experimental */
3964
- export type ProviderEndpointType =
3965
- /** OpenAI-compatible endpoint (use the OpenAI client library). */
3966
- "openai"
3967
- /** Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). */
3968
- | "azure"
3969
- /** Anthropic endpoint (use the Anthropic client library). */
3970
- | "anthropic";
3971
- /**
3972
- * Wire API to be used, when required for the provider type.
3973
- *
3974
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3975
- * via the `definition` "ProviderEndpointWireApi".
3976
- */
3977
- /** @experimental */
3978
- export type ProviderEndpointWireApi =
3979
- /** Classic chat-completions request shape. */
3980
- "completions"
3981
- /** Newer responses request shape. */
3982
- | "responses";
3983
- /**
3984
- * Transport to be used for provider requests.
3985
- *
3986
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
3987
- * via the `definition` "ProviderEndpointTransport".
3988
- */
3989
- /** @experimental */
3990
- export type ProviderEndpointTransport =
3991
- /** HTTP request/streaming transport. */
3992
- "http"
3993
- /** WebSocket transport. */
3994
- | "websockets";
3995
4087
  /**
3996
4088
  * Optional model identifier to scope the endpoint snapshot to.
3997
4089
  *
@@ -4163,6 +4255,22 @@ export type SandboxConfigSource =
4163
4255
  */
4164
4256
  /** @experimental */
4165
4257
  export type SandboxHostCapabilityName = string;
4258
+ /**
4259
+ * State of the persistent certificate authority of the sandbox credential proxy.
4260
+ *
4261
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
4262
+ * via the `definition` "SandboxProxyCaState".
4263
+ */
4264
+ /** @experimental */
4265
+ export type SandboxProxyCaState =
4266
+ /** This platform has no supported OS trust store. The proxy uses a per-process certificate bundle. */
4267
+ "unsupported"
4268
+ /** OS trust does not include the certificate authority, or none is stored. */
4269
+ | "notInstalled"
4270
+ /** OS trust includes the stored certificate authority. */
4271
+ | "installed"
4272
+ /** The runtime could not read the certificate authority or the OS trust store. */
4273
+ | "error";
4166
4274
  /**
4167
4275
  * A session-scoped sandbox transition applied while handling a slash command
4168
4276
  *
@@ -9432,6 +9540,10 @@ export interface CurrentModel {
9432
9540
  * Currently active model identifier
9433
9541
  */
9434
9542
  modelId?: string;
9543
+ /**
9544
+ * 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.
9545
+ */
9546
+ planBaseModelId?: string;
9435
9547
  /**
9436
9548
  * 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.
9437
9549
  */
@@ -9486,6 +9598,42 @@ export interface CurrentToolMetadata {
9486
9598
  */
9487
9599
  deferLoading?: boolean;
9488
9600
  }
9601
+ /**
9602
+ * Result of one customization reload component.
9603
+ *
9604
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
9605
+ * via the `definition` "CustomizationReloadOutcome".
9606
+ */
9607
+ /** @experimental */
9608
+ export interface CustomizationReloadOutcome {
9609
+ subsystem: CustomizationReloadSubsystem;
9610
+ status: CustomizationReloadStatus;
9611
+ /**
9612
+ * Reason for a skipped component or description of a failure, when available
9613
+ */
9614
+ detail?: string | null;
9615
+ }
9616
+ /**
9617
+ * 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.
9618
+ *
9619
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
9620
+ * via the `definition` "CustomizationsReloadResult".
9621
+ */
9622
+ /** @experimental */
9623
+ export interface CustomizationsReloadResult {
9624
+ /**
9625
+ * Warnings from skill discovery
9626
+ */
9627
+ warnings: string[];
9628
+ /**
9629
+ * Errors from any component that could not be refreshed
9630
+ */
9631
+ errors: string[];
9632
+ /**
9633
+ * Outcome of each component in reload order; a skipped component was not configured or loaded
9634
+ */
9635
+ outcomes: CustomizationReloadOutcome[];
9636
+ }
9489
9637
  /**
9490
9638
  * A file included in the session debug bundle.
9491
9639
  *
@@ -9937,64 +10085,256 @@ export interface McpSourcePlugin {
9937
10085
  version?: string;
9938
10086
  }
9939
10087
  /**
9940
- * Slash-prefixed command string to enqueue for FIFO processing.
10088
+ * 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.
9941
10089
  *
9942
10090
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
9943
- * via the `definition` "EnqueueCommandParams".
10091
+ * via the `definition` "DiscoveredModel".
9944
10092
  */
9945
10093
  /** @experimental */
9946
- export interface EnqueueCommandParams {
10094
+ export interface DiscoveredModel {
9947
10095
  /**
9948
- * 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.
10096
+ * Provider-native model identifier.
9949
10097
  */
9950
- command: string;
10098
+ id: string;
9951
10099
  /**
9952
- * Optional user-facing text for the queue row. The command string is shown when omitted.
10100
+ * Provider-reported display name.
9953
10101
  */
9954
- displayText?: string | null;
9955
- }
9956
- /** @experimental */
9957
- export interface UnsupportedEnqueueCommandResult {
10102
+ name?: string;
10103
+ provenance: ModelProviderProvenance;
9958
10104
  /**
9959
- * False because the target session does not support local command queueing (e.g. remote sessions).
10105
+ * Provider-reported artifact digest.
9960
10106
  */
9961
- queued: false;
10107
+ digest?: string;
9962
10108
  /**
9963
- * Legacy null queue ID accepted for compatibility with older runtimes.
10109
+ * Provider-reported last-modified timestamp.
9964
10110
  */
9965
- queueId?: null;
9966
- }
10111
+ modifiedAt?: string;
10112
+ /**
10113
+ * Provider-reported artifact size in bytes.
10114
+ */
10115
+ sizeBytes?: number;
10116
+ details: ModelArtifactDetails;
10117
+ capabilities: ModelCapabilities;
10118
+ /**
10119
+ * Non-fatal warnings encountered while enriching this model.
10120
+ */
10121
+ warnings: ModelProviderWarning[];
10122
+ }
9967
10123
  /**
9968
- * OneAuth token request supplied by a trusted host application.
10124
+ * Attribution for the adapter that produced a provider row.
9969
10125
  *
9970
10126
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
9971
- * via the `definition` "EntraTokenAcquireRequest".
10127
+ * via the `definition` "ModelProviderProvenance".
9972
10128
  */
9973
10129
  /** @experimental */
9974
- export interface EntraTokenAcquireRequest {
10130
+ export interface ModelProviderProvenance {
9975
10131
  /**
9976
- * Public client application id.
10132
+ * Stable opaque adapter identity from the effective catalog. Treat this as a whole identifier, not a parseable owner or kind.
9977
10133
  */
9978
- clientId: string;
10134
+ adapterId: string;
9979
10135
  /**
9980
- * Tenant id or tenant selector, such as common or organizations.
10136
+ * Descriptive provider family that produced this row; not a routing key.
9981
10137
  */
9982
- tenantId: string;
10138
+ providerKind: string;
10139
+ source: ModelProviderProvenanceSource;
9983
10140
  /**
9984
- * Broker redirect URI registered for the client. Required: the OneAuth broker validates a non-empty, registered redirect URI for the public client (MSAL broker registration), so this is not a browser-flow vestige and cannot be omitted.
10141
+ * Stable contributor identifier when the adapter has an owner outside the runtime. Independent of the contribution mechanism and not a routing key.
9985
10142
  */
9986
- redirectUri: string;
10143
+ ownerId?: string;
9987
10144
  /**
9988
- * Exact delegated scopes to request.
9989
- *
9990
- * @minItems 1
10145
+ * Human-readable contributor name, not the adapter display name.
10146
+ */
10147
+ ownerDisplayName?: string;
10148
+ }
10149
+ /**
10150
+ * Provider-reported model artifact metadata.
10151
+ *
10152
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10153
+ * via the `definition` "ModelArtifactDetails".
10154
+ */
10155
+ /** @experimental */
10156
+ export interface ModelArtifactDetails {
10157
+ /**
10158
+ * Artifact format, such as `gguf`.
10159
+ */
10160
+ format?: string;
10161
+ /**
10162
+ * Primary model family.
10163
+ */
10164
+ family?: string;
10165
+ /**
10166
+ * Provider-reported model families.
10167
+ */
10168
+ families?: string[];
10169
+ /**
10170
+ * Provider-reported parameter count label.
10171
+ */
10172
+ parameterSize?: string;
10173
+ /**
10174
+ * Provider-reported quantization label.
10175
+ */
10176
+ quantization?: string;
10177
+ /**
10178
+ * Provider-reported model architecture.
10179
+ */
10180
+ architecture?: string;
10181
+ /**
10182
+ * Provider-reported tokenizer.
10183
+ */
10184
+ tokenizer?: string;
10185
+ }
10186
+ /**
10187
+ * Model capabilities and limits
10188
+ *
10189
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10190
+ * via the `definition` "ModelCapabilities".
10191
+ */
10192
+ /** @experimental */
10193
+ export interface ModelCapabilities {
10194
+ supports?: ModelCapabilitiesSupports;
10195
+ limits?: ModelCapabilitiesLimits;
10196
+ }
10197
+ /**
10198
+ * Feature flags indicating what the model supports
10199
+ *
10200
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10201
+ * via the `definition` "ModelCapabilitiesSupports".
10202
+ */
10203
+ /** @experimental */
10204
+ export interface ModelCapabilitiesSupports {
10205
+ /**
10206
+ * Whether the model supports provider-native thinking. Independent of configurable reasoning effort; omission means unknown.
10207
+ */
10208
+ thinking?: boolean;
10209
+ /**
10210
+ * Whether this model supports vision/image input
10211
+ */
10212
+ vision?: boolean;
10213
+ /**
10214
+ * Whether this model supports canonical tool calling
10215
+ */
10216
+ toolCalls?: boolean;
10217
+ /**
10218
+ * Whether this model supports reasoning effort configuration
10219
+ */
10220
+ reasoningEffort?: boolean;
10221
+ adaptive_thinking?: AdaptiveThinkingSupport;
10222
+ }
10223
+ /**
10224
+ * Token limits for prompts, outputs, and context window
10225
+ *
10226
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10227
+ * via the `definition` "ModelCapabilitiesLimits".
10228
+ */
10229
+ /** @experimental */
10230
+ export interface ModelCapabilitiesLimits {
10231
+ /**
10232
+ * Maximum number of prompt/input tokens
10233
+ */
10234
+ max_prompt_tokens?: number;
10235
+ /**
10236
+ * Maximum number of output/completion tokens
10237
+ */
10238
+ max_output_tokens?: number;
10239
+ /**
10240
+ * Maximum total context window size in tokens
10241
+ */
10242
+ max_context_window_tokens?: number;
10243
+ vision?: ModelCapabilitiesLimitsVision;
10244
+ }
10245
+ /**
10246
+ * Vision-specific limits
10247
+ *
10248
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10249
+ * via the `definition` "ModelCapabilitiesLimitsVision".
10250
+ */
10251
+ /** @experimental */
10252
+ export interface ModelCapabilitiesLimitsVision {
10253
+ /**
10254
+ * MIME types the model accepts
10255
+ */
10256
+ supported_media_types: string[];
10257
+ /**
10258
+ * Maximum number of images per prompt
10259
+ */
10260
+ max_prompt_images: number;
10261
+ /**
10262
+ * Maximum image size in bytes
10263
+ */
10264
+ max_prompt_image_size: number;
10265
+ }
10266
+ /**
10267
+ * A non-fatal provider observation warning.
10268
+ *
10269
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10270
+ * via the `definition` "ModelProviderWarning".
10271
+ */
10272
+ /** @experimental */
10273
+ export interface ModelProviderWarning {
10274
+ /**
10275
+ * Machine-readable warning code.
10276
+ */
10277
+ code: string;
10278
+ /**
10279
+ * Human-readable warning message.
10280
+ */
10281
+ message: string;
10282
+ }
10283
+ /**
10284
+ * 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.
10285
+ *
10286
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10287
+ * via the `definition` "DiscoveredModelList".
10288
+ */
10289
+ /** @experimental */
10290
+ export interface DiscoveredModelList {
10291
+ outcome: ModelProviderOperationOutcome;
10292
+ /**
10293
+ * Provider-native models in provider order.
9991
10294
  */
9992
- scopes: [string, ...string[]];
9993
- interaction: EntraTokenInteraction;
10295
+ models: DiscoveredModel[];
10296
+ }
10297
+ /**
10298
+ * Typed provider-operation outcome. Use the code for control flow and the optional message for display.
10299
+ *
10300
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10301
+ * via the `definition` "ModelProviderOperationOutcome".
10302
+ */
10303
+ /** @experimental */
10304
+ export interface ModelProviderOperationOutcome {
10305
+ code: ModelProviderOperationOutcomeCode;
10306
+ /**
10307
+ * Human-readable detail for non-success outcomes.
10308
+ */
10309
+ message?: string;
10310
+ }
10311
+ /**
10312
+ * Slash-prefixed command string to enqueue for FIFO processing.
10313
+ *
10314
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
10315
+ * via the `definition` "EnqueueCommandParams".
10316
+ */
10317
+ /** @experimental */
10318
+ export interface EnqueueCommandParams {
10319
+ /**
10320
+ * 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.
10321
+ */
10322
+ command: string;
10323
+ /**
10324
+ * Optional user-facing text for the queue row. The command string is shown when omitted.
10325
+ */
10326
+ displayText?: string | null;
10327
+ }
10328
+ /** @experimental */
10329
+ export interface UnsupportedEnqueueCommandResult {
10330
+ /**
10331
+ * False because the target session does not support local command queueing (e.g. remote sessions).
10332
+ */
10333
+ queued: false;
9994
10334
  /**
9995
- * Previously rejected token that OneAuth must bypass during renewal.
10335
+ * Legacy null queue ID accepted for compatibility with older runtimes.
9996
10336
  */
9997
- accessTokenToRenew?: string;
10337
+ queueId?: null;
9998
10338
  }
9999
10339
  /**
10000
10340
  * Hosting capabilities and session capacity advertised by an environment.
@@ -15877,82 +16217,6 @@ export interface Model {
15877
16217
  warningMessages?: ModelMessage[];
15878
16218
  provider?: ModelProviderRef;
15879
16219
  }
15880
- /**
15881
- * Model capabilities and limits
15882
- *
15883
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
15884
- * via the `definition` "ModelCapabilities".
15885
- */
15886
- /** @experimental */
15887
- export interface ModelCapabilities {
15888
- supports?: ModelCapabilitiesSupports;
15889
- limits?: ModelCapabilitiesLimits;
15890
- }
15891
- /**
15892
- * Feature flags indicating what the model supports
15893
- *
15894
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
15895
- * via the `definition` "ModelCapabilitiesSupports".
15896
- */
15897
- /** @experimental */
15898
- export interface ModelCapabilitiesSupports {
15899
- /**
15900
- * Whether this model supports vision/image input
15901
- */
15902
- vision?: boolean;
15903
- /**
15904
- * Whether this model supports canonical tool calling
15905
- */
15906
- toolCalls?: boolean;
15907
- /**
15908
- * Whether this model supports reasoning effort configuration
15909
- */
15910
- reasoningEffort?: boolean;
15911
- adaptive_thinking?: AdaptiveThinkingSupport;
15912
- }
15913
- /**
15914
- * Token limits for prompts, outputs, and context window
15915
- *
15916
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
15917
- * via the `definition` "ModelCapabilitiesLimits".
15918
- */
15919
- /** @experimental */
15920
- export interface ModelCapabilitiesLimits {
15921
- /**
15922
- * Maximum number of prompt/input tokens
15923
- */
15924
- max_prompt_tokens?: number;
15925
- /**
15926
- * Maximum number of output/completion tokens
15927
- */
15928
- max_output_tokens?: number;
15929
- /**
15930
- * Maximum total context window size in tokens
15931
- */
15932
- max_context_window_tokens?: number;
15933
- vision?: ModelCapabilitiesLimitsVision;
15934
- }
15935
- /**
15936
- * Vision-specific limits
15937
- *
15938
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
15939
- * via the `definition` "ModelCapabilitiesLimitsVision".
15940
- */
15941
- /** @experimental */
15942
- export interface ModelCapabilitiesLimitsVision {
15943
- /**
15944
- * MIME types the model accepts
15945
- */
15946
- supported_media_types: string[];
15947
- /**
15948
- * Maximum number of images per prompt
15949
- */
15950
- max_prompt_images: number;
15951
- /**
15952
- * Maximum image size in bytes
15953
- */
15954
- max_prompt_image_size: number;
15955
- }
15956
16220
  /**
15957
16221
  * Policy state (if applicable)
15958
16222
  *
@@ -16331,35 +16595,437 @@ export interface ModelPickerSettingsContext {
16331
16595
  environment: {};
16332
16596
  }
16333
16597
  /**
16334
- * 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.
16598
+ * Normalized model-provider adapter definitions available to the session, not discovered instances.
16335
16599
  *
16336
16600
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16337
- * via the `definition` "ModelProviderDescriptor".
16601
+ * via the `definition` "ModelProviderAdapterCatalog".
16338
16602
  */
16339
16603
  /** @experimental */
16340
- export interface ModelProviderDescriptor {
16341
- kind: ModelProviderKind;
16342
- /**
16343
- * Opaque, stable provider id, stamped onto every model this provider returns.
16344
- */
16345
- id: string;
16346
- /**
16347
- * Human-readable menu label, owned by the runtime so every consumer renders identical text.
16348
- */
16349
- label: string;
16604
+ export interface ModelProviderAdapterCatalog {
16350
16605
  /**
16351
- * Stable ordering key for presenting providers in a deterministic sequence.
16606
+ * Available provider adapters ordered by adapterId.
16352
16607
  */
16353
- ordering: number;
16608
+ providers: ModelProviderAdapterDescriptor[];
16354
16609
  }
16355
16610
  /**
16356
- * 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.
16611
+ * A normalized model-provider adapter in the session's effective catalog.
16357
16612
  *
16358
16613
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16359
- * via the `definition` "ModelSetAllowedModelsRequest".
16614
+ * via the `definition` "ModelProviderAdapterDescriptor".
16360
16615
  */
16361
16616
  /** @experimental */
16362
- export interface ModelSetAllowedModelsRequest {
16617
+ export interface ModelProviderAdapterDescriptor {
16618
+ /**
16619
+ * Stable opaque identity for routing to this adapter. Unique in the effective catalog, independent of live registration generations.
16620
+ */
16621
+ adapterId: string;
16622
+ /**
16623
+ * Descriptive provider family, such as `ollama`. Different adapters may have the same family; use adapterId for routing.
16624
+ */
16625
+ providerKind: string;
16626
+ /**
16627
+ * Human-readable provider name.
16628
+ */
16629
+ displayName: string;
16630
+ provenance: ModelProviderAttribution;
16631
+ automaticDiscovery: ModelProviderAutomaticDiscoveryPolicy;
16632
+ /**
16633
+ * Operations supported by this provider adapter.
16634
+ */
16635
+ operations: ModelProviderAdapterOperationDescriptor[];
16636
+ }
16637
+ /**
16638
+ * Contributor attribution, independent of routing identity and authorization.
16639
+ *
16640
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16641
+ * via the `definition` "ModelProviderAttribution".
16642
+ */
16643
+ /** @experimental */
16644
+ export interface ModelProviderAttribution {
16645
+ source: ModelProviderProvenanceSource;
16646
+ /**
16647
+ * Stable contributor identifier. Required and nonblank for extension and custom sources; optional for built-in and configured sources. Does not grant authority.
16648
+ */
16649
+ ownerId?: string;
16650
+ /**
16651
+ * Human-readable contributor name, not the adapter display name.
16652
+ */
16653
+ ownerDisplayName?: string;
16654
+ }
16655
+ /**
16656
+ * Adapter-declared policy that tells clients whether discovery may run automatically.
16657
+ *
16658
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16659
+ * via the `definition` "ModelProviderAutomaticDiscoveryPolicy".
16660
+ */
16661
+ /** @experimental */
16662
+ export interface ModelProviderAutomaticDiscoveryPolicy {
16663
+ mode: ModelProviderAutomaticDiscoveryMode;
16664
+ networkScope: ModelProviderDiscoveryNetworkScope;
16665
+ /**
16666
+ * 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.
16667
+ */
16668
+ requiresInput: boolean;
16669
+ /**
16670
+ * True when the adapter must be enabled by a trusted owner, such as a trusted extension, before automatic discovery may run.
16671
+ */
16672
+ requiresTrust: boolean;
16673
+ }
16674
+ /**
16675
+ * An operation supported by a model-provider adapter.
16676
+ *
16677
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16678
+ * via the `definition` "ModelProviderAdapterOperationDescriptor".
16679
+ */
16680
+ /** @experimental */
16681
+ export interface ModelProviderAdapterOperationDescriptor {
16682
+ /**
16683
+ * Supported operation name: `discover`, `getStatus`, or `models.list`. Unknown names and duplicate declarations are rejected.
16684
+ */
16685
+ name: string;
16686
+ /**
16687
+ * 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.
16688
+ */
16689
+ inputSchema?: JsonValue;
16690
+ }
16691
+ /**
16692
+ * 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.
16693
+ *
16694
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16695
+ * via the `definition` "ModelProviderConfigurationPlan".
16696
+ */
16697
+ /** @experimental */
16698
+ export interface ModelProviderConfigurationPlan {
16699
+ provider: NamedProviderConfig;
16700
+ model: ProviderModelConfig;
16701
+ /**
16702
+ * Provider-qualified selection id (`provider/id`) to pass to `switchTo` once the plan is applied.
16703
+ */
16704
+ selectionId: string;
16705
+ providerDisposition: ModelProviderConfigurationDisposition;
16706
+ modelDisposition: ModelProviderConfigurationDisposition;
16707
+ /**
16708
+ * Non-fatal warnings carried over from the discovered model, such as capabilities the provider did not report.
16709
+ */
16710
+ warnings: ModelProviderWarning[];
16711
+ }
16712
+ /**
16713
+ * External SDK input for a named custom model provider. Ingested by the native protocol boundary before host dispatch.
16714
+ *
16715
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16716
+ * via the `definition` "NamedProviderConfig".
16717
+ */
16718
+ /** @experimental */
16719
+ export interface NamedProviderConfig {
16720
+ /**
16721
+ * Unique provider name used to qualify model selection IDs.
16722
+ */
16723
+ name: string;
16724
+ type?: ProviderConfigType;
16725
+ wireApi?: ProviderConfigWireApi;
16726
+ transport?: ProviderConfigTransport;
16727
+ /**
16728
+ * Base URL for provider API requests.
16729
+ */
16730
+ baseUrl: string;
16731
+ /**
16732
+ * Static API key used to authenticate provider requests.
16733
+ */
16734
+ apiKey?: string;
16735
+ /**
16736
+ * Static bearer token used to authenticate provider requests.
16737
+ */
16738
+ bearerToken?: string;
16739
+ azure?: ProviderConfigAzure;
16740
+ /**
16741
+ * Additional HTTP headers included with provider requests.
16742
+ */
16743
+ headers?: {
16744
+ [k: string]: string | undefined;
16745
+ };
16746
+ modelProvider?: ProviderConfigModelProvider;
16747
+ /**
16748
+ * Whether the host supplies bearer tokens dynamically.
16749
+ */
16750
+ hasBearerTokenProvider?: boolean;
16751
+ }
16752
+ /**
16753
+ * Azure-specific provider options.
16754
+ *
16755
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16756
+ * via the `definition` "ProviderConfigAzure".
16757
+ */
16758
+ /** @experimental */
16759
+ export interface ProviderConfigAzure {
16760
+ /**
16761
+ * API version. When set, uses the versioned deployment route. When omitted, uses the GA versionless v1 route.
16762
+ */
16763
+ apiVersion?: string;
16764
+ }
16765
+ /**
16766
+ * A BYOK model definition referencing a named provider.
16767
+ *
16768
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16769
+ * via the `definition` "ProviderModelConfig".
16770
+ */
16771
+ /** @experimental */
16772
+ export interface ProviderModelConfig {
16773
+ /**
16774
+ * 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`.
16775
+ */
16776
+ id: string;
16777
+ /**
16778
+ * Name of the configured provider that serves this model.
16779
+ */
16780
+ provider: string;
16781
+ /**
16782
+ * The model name sent to the provider API for inference. Defaults to `id`.
16783
+ */
16784
+ wireModel?: string;
16785
+ /**
16786
+ * Well-known base model id used for behavior/capability/config lookup. Defaults to `id`.
16787
+ */
16788
+ modelId?: string;
16789
+ /**
16790
+ * Display name for model pickers. Defaults to the provider-qualified selection id (`provider/id`).
16791
+ */
16792
+ name?: string;
16793
+ /**
16794
+ * Maximum prompt/input tokens for the model.
16795
+ */
16796
+ maxPromptTokens?: number;
16797
+ /**
16798
+ * Maximum context window tokens for the model.
16799
+ */
16800
+ maxContextWindowTokens?: number;
16801
+ /**
16802
+ * Maximum output tokens for the model.
16803
+ */
16804
+ maxOutputTokens?: number;
16805
+ capabilities?: ModelCapabilitiesOverride;
16806
+ systemMessage?: ProtocolSystemMessageConfig;
16807
+ /**
16808
+ * Provider-published model metadata, preserved verbatim as the public Model.metadata object.
16809
+ */
16810
+ metadata?: {
16811
+ [k: string]: JsonValue | undefined;
16812
+ };
16813
+ }
16814
+ /** @experimental */
16815
+ export interface ProtocolSystemMessageAppendConfig {
16816
+ mode?: ProtocolAppendMode;
16817
+ /**
16818
+ * Text appended to the standard system prompt.
16819
+ */
16820
+ content?: string;
16821
+ }
16822
+ /** @experimental */
16823
+ export interface ProtocolSystemMessageReplaceConfig {
16824
+ mode: ProtocolReplaceMode;
16825
+ /**
16826
+ * Complete replacement system-message text.
16827
+ */
16828
+ content: string;
16829
+ /**
16830
+ * Optional structured blocks corresponding to the replacement content.
16831
+ */
16832
+ contentBlocks?: SystemMessageBlock[];
16833
+ }
16834
+ /** @experimental */
16835
+ export interface SystemMessageBlock {
16836
+ /**
16837
+ * Text content for this system-message block.
16838
+ */
16839
+ content: string;
16840
+ /**
16841
+ * Whether the block is static and may be cached independently of dynamic prompt content.
16842
+ */
16843
+ isStatic?: boolean;
16844
+ /**
16845
+ * Whether providers with explicit prompt caching should place a cache breakpoint after this block.
16846
+ */
16847
+ cacheBreakpoint?: boolean;
16848
+ }
16849
+ /** @experimental */
16850
+ export interface ProtocolSystemMessageCustomizeConfig {
16851
+ mode: ProtocolCustomizeMode;
16852
+ /**
16853
+ * Named standard-prompt section overrides.
16854
+ */
16855
+ sections?: {
16856
+ [k: string]: ProtocolSectionOverride | undefined;
16857
+ };
16858
+ /**
16859
+ * Text appended after the customized sections.
16860
+ */
16861
+ content?: string;
16862
+ }
16863
+ /** @experimental */
16864
+ export interface ProtocolStaticSectionOverride {
16865
+ action: ProtocolStaticSectionAction;
16866
+ /**
16867
+ * Optional content used by replace, append, and prepend operations.
16868
+ */
16869
+ content?: string;
16870
+ }
16871
+ /**
16872
+ * 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.
16873
+ *
16874
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16875
+ * via the `definition` "ModelProviderDescriptor".
16876
+ */
16877
+ /** @experimental */
16878
+ export interface ModelProviderDescriptor {
16879
+ kind: ModelProviderKind;
16880
+ /**
16881
+ * Opaque, stable provider id, stamped onto every model this provider returns.
16882
+ */
16883
+ id: string;
16884
+ /**
16885
+ * Human-readable menu label, owned by the runtime so every consumer renders identical text.
16886
+ */
16887
+ label: string;
16888
+ /**
16889
+ * Stable ordering key for presenting providers in a deterministic sequence.
16890
+ */
16891
+ ordering: number;
16892
+ }
16893
+ /**
16894
+ * Provider discovery parameters.
16895
+ *
16896
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16897
+ * via the `definition` "ModelProviderDiscoverRequest".
16898
+ */
16899
+ /** @experimental */
16900
+ export interface ModelProviderDiscoverRequest {
16901
+ /**
16902
+ * Opaque adapter identity returned by `session.providers.getCatalog`.
16903
+ */
16904
+ adapterId: string;
16905
+ /**
16906
+ * 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.
16907
+ */
16908
+ input?: JsonValue;
16909
+ }
16910
+ /**
16911
+ * Provider instances found by a discovery operation.
16912
+ *
16913
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16914
+ * via the `definition` "ModelProviderDiscoverResult".
16915
+ */
16916
+ /** @experimental */
16917
+ export interface ModelProviderDiscoverResult {
16918
+ outcome: ModelProviderOperationOutcome;
16919
+ /**
16920
+ * Discovered provider instances. Empty when passive default discovery finds no reachable provider.
16921
+ */
16922
+ instances: ModelProviderInstance[];
16923
+ }
16924
+ /**
16925
+ * A normalized model-provider instance discovered by the runtime.
16926
+ *
16927
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16928
+ * via the `definition` "ModelProviderInstance".
16929
+ */
16930
+ /** @experimental */
16931
+ export interface ModelProviderInstance {
16932
+ reference: ModelProviderInstanceReference;
16933
+ /**
16934
+ * Human-readable instance name.
16935
+ */
16936
+ displayName: string;
16937
+ provenance: ModelProviderProvenance;
16938
+ /**
16939
+ * Inference API endpoint when the provider exposes one separately from its management endpoint.
16940
+ */
16941
+ inferenceEndpoint?: string;
16942
+ inferenceType?: ProviderEndpointType;
16943
+ inferenceWireApi?: ProviderEndpointWireApi;
16944
+ inferenceTransport?: ProviderEndpointTransport;
16945
+ }
16946
+ /**
16947
+ * Serializable reference to a discovered provider instance.
16948
+ *
16949
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16950
+ * via the `definition` "ModelProviderInstanceReference".
16951
+ */
16952
+ /** @experimental */
16953
+ export interface ModelProviderInstanceReference {
16954
+ /**
16955
+ * Stable opaque identity of the adapter that owns this reference. Must be present in the target session's effective catalog.
16956
+ */
16957
+ adapterId: string;
16958
+ /**
16959
+ * Descriptive provider family. Must match the selected adapter; not a routing key.
16960
+ */
16961
+ providerKind: string;
16962
+ /**
16963
+ * Stable instance identifier derived by the provider adapter, such as `ollama:{normalizedEndpoint}`.
16964
+ */
16965
+ id: string;
16966
+ /**
16967
+ * 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.
16968
+ */
16969
+ managementEndpoint: string;
16970
+ }
16971
+ /**
16972
+ * Provider status request parameters.
16973
+ *
16974
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16975
+ * via the `definition` "ModelProviderGetStatusRequest".
16976
+ */
16977
+ /** @experimental */
16978
+ export interface ModelProviderGetStatusRequest {
16979
+ instance: ModelProviderInstanceReference;
16980
+ }
16981
+ /**
16982
+ * Provider model inventory request parameters.
16983
+ *
16984
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16985
+ * via the `definition` "ModelProviderModelsListRequest".
16986
+ */
16987
+ /** @experimental */
16988
+ export interface ModelProviderModelsListRequest {
16989
+ instance: ModelProviderInstanceReference;
16990
+ }
16991
+ /**
16992
+ * 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`.
16993
+ *
16994
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16995
+ * via the `definition` "ModelProviderPrepareConfigurationRequest".
16996
+ */
16997
+ /** @experimental */
16998
+ export interface ModelProviderPrepareConfigurationRequest {
16999
+ instance: ModelProviderInstance;
17000
+ model: DiscoveredModel;
17001
+ }
17002
+ /**
17003
+ * Current health information for a provider instance.
17004
+ *
17005
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
17006
+ * via the `definition` "ModelProviderStatus".
17007
+ */
17008
+ /** @experimental */
17009
+ export interface ModelProviderStatus {
17010
+ outcome: ModelProviderOperationOutcome;
17011
+ instance: ModelProviderInstance;
17012
+ /**
17013
+ * Open provider status value, such as `healthy`, `unreachable`, or `notInstalled`.
17014
+ */
17015
+ status: string;
17016
+ /**
17017
+ * Provider-reported version.
17018
+ */
17019
+ version?: string;
17020
+ }
17021
+ /**
17022
+ * 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.
17023
+ *
17024
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
17025
+ * via the `definition` "ModelSetAllowedModelsRequest".
17026
+ */
17027
+ /** @experimental */
17028
+ export interface ModelSetAllowedModelsRequest {
16363
17029
  /**
16364
17030
  * Exact model IDs to permit, or null to clear the host restriction.
16365
17031
  */
@@ -16655,78 +17321,26 @@ export interface ModeSetResult {
16655
17321
  */
16656
17322
  deprecationWarnings?: string[];
16657
17323
  /**
16658
- * Whether the host must defer implementing the requested mode change.
16659
- */
16660
- deferImplementation?: boolean;
16661
- /**
16662
- * Whether the host should arm an interactive continuation after the mode change.
16663
- */
16664
- armInteractiveContinuation?: boolean;
16665
- }
16666
- /**
16667
- * Result of moving in-flight MCP loading to the background.
16668
- *
16669
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16670
- * via the `definition` "MoveMcpLoadingToBackgroundResult".
16671
- */
16672
- /** @experimental */
16673
- export interface MoveMcpLoadingToBackgroundResult {
16674
- /**
16675
- * 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.
16676
- */
16677
- movedToBackground: boolean;
16678
- }
16679
- /**
16680
- * External SDK input for a named custom model provider. Ingested by the native protocol boundary before host dispatch.
16681
- *
16682
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16683
- * via the `definition` "NamedProviderConfig".
16684
- */
16685
- /** @experimental */
16686
- export interface NamedProviderConfig {
16687
- /**
16688
- * Unique provider name used to qualify model selection IDs.
16689
- */
16690
- name: string;
16691
- type?: ProviderConfigType;
16692
- wireApi?: ProviderConfigWireApi;
16693
- transport?: ProviderConfigTransport;
16694
- /**
16695
- * Base URL for provider API requests.
16696
- */
16697
- baseUrl: string;
16698
- /**
16699
- * Static API key used to authenticate provider requests.
16700
- */
16701
- apiKey?: string;
16702
- /**
16703
- * Static bearer token used to authenticate provider requests.
16704
- */
16705
- bearerToken?: string;
16706
- azure?: ProviderConfigAzure;
16707
- /**
16708
- * Additional HTTP headers included with provider requests.
16709
- */
16710
- headers?: {
16711
- [k: string]: string | undefined;
16712
- };
17324
+ * Whether the host must defer implementing the requested mode change.
17325
+ */
17326
+ deferImplementation?: boolean;
16713
17327
  /**
16714
- * Whether the host supplies bearer tokens dynamically.
17328
+ * Whether the host should arm an interactive continuation after the mode change.
16715
17329
  */
16716
- hasBearerTokenProvider?: boolean;
17330
+ armInteractiveContinuation?: boolean;
16717
17331
  }
16718
17332
  /**
16719
- * Azure-specific provider options.
17333
+ * Result of moving in-flight MCP loading to the background.
16720
17334
  *
16721
17335
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
16722
- * via the `definition` "ProviderConfigAzure".
17336
+ * via the `definition` "MoveMcpLoadingToBackgroundResult".
16723
17337
  */
16724
17338
  /** @experimental */
16725
- export interface ProviderConfigAzure {
17339
+ export interface MoveMcpLoadingToBackgroundResult {
16726
17340
  /**
16727
- * API version. When set, uses the versioned deployment route. When omitted, uses the GA versionless v1 route.
17341
+ * 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.
16728
17342
  */
16729
- apiVersion?: string;
17343
+ movedToBackground: boolean;
16730
17344
  }
16731
17345
  /**
16732
17346
  * The session's friendly name, or null when not yet set.
@@ -18867,63 +19481,6 @@ export interface ProtocolExternalToolDefinition {
18867
19481
  [k: string]: JsonValue | undefined;
18868
19482
  };
18869
19483
  }
18870
- /** @experimental */
18871
- export interface ProtocolStaticSectionOverride {
18872
- action: ProtocolStaticSectionAction;
18873
- /**
18874
- * Optional content used by replace, append, and prepend operations.
18875
- */
18876
- content?: string;
18877
- }
18878
- /** @experimental */
18879
- export interface ProtocolSystemMessageAppendConfig {
18880
- mode?: ProtocolAppendMode;
18881
- /**
18882
- * Text appended to the standard system prompt.
18883
- */
18884
- content?: string;
18885
- }
18886
- /** @experimental */
18887
- export interface ProtocolSystemMessageReplaceConfig {
18888
- mode: ProtocolReplaceMode;
18889
- /**
18890
- * Complete replacement system-message text.
18891
- */
18892
- content: string;
18893
- /**
18894
- * Optional structured blocks corresponding to the replacement content.
18895
- */
18896
- contentBlocks?: SystemMessageBlock[];
18897
- }
18898
- /** @experimental */
18899
- export interface SystemMessageBlock {
18900
- /**
18901
- * Text content for this system-message block.
18902
- */
18903
- content: string;
18904
- /**
18905
- * Whether the block is static and may be cached independently of dynamic prompt content.
18906
- */
18907
- isStatic?: boolean;
18908
- /**
18909
- * Whether providers with explicit prompt caching should place a cache breakpoint after this block.
18910
- */
18911
- cacheBreakpoint?: boolean;
18912
- }
18913
- /** @experimental */
18914
- export interface ProtocolSystemMessageCustomizeConfig {
18915
- mode: ProtocolCustomizeMode;
18916
- /**
18917
- * Named standard-prompt section overrides.
18918
- */
18919
- sections?: {
18920
- [k: string]: ProtocolSectionOverride;
18921
- };
18922
- /**
18923
- * Text appended after the customized sections.
18924
- */
18925
- content?: string;
18926
- }
18927
19484
  /**
18928
19485
  * BYOK providers and/or models to add to the session's registry at runtime. Both fields are optional; provide providers, models, or both.
18929
19486
  *
@@ -18941,55 +19498,6 @@ export interface ProviderAddRequest {
18941
19498
  */
18942
19499
  models?: ProviderModelConfig[];
18943
19500
  }
18944
- /**
18945
- * A BYOK model definition referencing a named provider.
18946
- *
18947
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
18948
- * via the `definition` "ProviderModelConfig".
18949
- */
18950
- /** @experimental */
18951
- export interface ProviderModelConfig {
18952
- /**
18953
- * 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`.
18954
- */
18955
- id: string;
18956
- /**
18957
- * Name of the configured provider that serves this model.
18958
- */
18959
- provider: string;
18960
- /**
18961
- * The model name sent to the provider API for inference. Defaults to `id`.
18962
- */
18963
- wireModel?: string;
18964
- /**
18965
- * Well-known base model id used for behavior/capability/config lookup. Defaults to `id`.
18966
- */
18967
- modelId?: string;
18968
- /**
18969
- * Display name for model pickers. Defaults to the provider-qualified selection id (`provider/id`).
18970
- */
18971
- name?: string;
18972
- /**
18973
- * Maximum prompt/input tokens for the model.
18974
- */
18975
- maxPromptTokens?: number;
18976
- /**
18977
- * Maximum context window tokens for the model.
18978
- */
18979
- maxContextWindowTokens?: number;
18980
- /**
18981
- * Maximum output tokens for the model.
18982
- */
18983
- maxOutputTokens?: number;
18984
- capabilities?: ModelCapabilitiesOverride;
18985
- systemMessage?: ProtocolSystemMessageConfig;
18986
- /**
18987
- * Provider-published model metadata, preserved verbatim as the public Model.metadata object.
18988
- */
18989
- metadata?: {
18990
- [k: string]: JsonValue | undefined;
18991
- };
18992
- }
18993
19501
  /**
18994
19502
  * The selectable model entries synthesized for the models added by this call.
18995
19503
  *
@@ -19036,6 +19544,7 @@ export interface ProviderConfig {
19036
19544
  * Provider name used for model and telemetry attribution.
19037
19545
  */
19038
19546
  providerName?: string;
19547
+ modelProvider?: ProviderConfigModelProvider;
19039
19548
  /**
19040
19549
  * The model identifier sent to the provider API for inference (the "wire" model), as opposed to modelId which is the well-known base.
19041
19550
  */
@@ -20867,6 +21376,47 @@ export interface SandboxHostSupport {
20867
21376
  */
20868
21377
  capabilities: SandboxHostCapability[];
20869
21378
  }
21379
+ /**
21380
+ * Result of creating the persistent certificate authority of the sandbox credential proxy.
21381
+ *
21382
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
21383
+ * via the `definition` "SandboxProxyCaCreateResult".
21384
+ */
21385
+ /** @experimental */
21386
+ export interface SandboxProxyCaCreateResult {
21387
+ /**
21388
+ * Absolute path of the public certificate of the certificate authority, in PEM format.
21389
+ */
21390
+ certificatePath: string;
21391
+ }
21392
+ /**
21393
+ * 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.
21394
+ *
21395
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
21396
+ * via the `definition` "SandboxProxyCaRequest".
21397
+ */
21398
+ /** @experimental */
21399
+ export interface SandboxProxyCaRequest {
21400
+ sandboxConfig?: SandboxConfig;
21401
+ }
21402
+ /**
21403
+ * Status of the persistent certificate authority of the sandbox credential proxy.
21404
+ *
21405
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
21406
+ * via the `definition` "SandboxProxyCaStatus".
21407
+ */
21408
+ /** @experimental */
21409
+ export interface SandboxProxyCaStatus {
21410
+ state: SandboxProxyCaState;
21411
+ /**
21412
+ * Human-readable reason for the state. On `installed` or `notInstalled`, present only when the certificate authority must be rotated, and then says why.
21413
+ */
21414
+ detail?: string;
21415
+ /**
21416
+ * 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.
21417
+ */
21418
+ canInstall: boolean;
21419
+ }
20870
21420
  /**
20871
21421
  * Register an absolute-time scheduled prompt.
20872
21422
  *
@@ -21546,6 +22096,10 @@ export interface SessionFsError {
21546
22096
  * Free-form detail about the error, for logging/diagnostics
21547
22097
  */
21548
22098
  message?: string;
22099
+ /**
22100
+ * For failed writeFile requests only: true if the provider changed the target before failing. Omit when unknown or unchanged.
22101
+ */
22102
+ writeChanged?: boolean;
21549
22103
  }
21550
22104
  /**
21551
22105
  * Path to test for existence in the client-provided session filesystem.
@@ -21678,6 +22232,37 @@ export interface SessionFsReaddirWithTypesResult {
21678
22232
  entries: SessionFsReaddirWithTypesEntry[];
21679
22233
  error?: SessionFsError;
21680
22234
  }
22235
+ /**
22236
+ * Path of the binary file to read from the client-provided session filesystem.
22237
+ *
22238
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
22239
+ * via the `definition` "SessionFsReadFileBytesRequest".
22240
+ */
22241
+ /** @experimental */
22242
+ export interface SessionFsReadFileBytesRequest {
22243
+ /**
22244
+ * Target session identifier
22245
+ */
22246
+ sessionId: string;
22247
+ /**
22248
+ * Path using SessionFs conventions
22249
+ */
22250
+ path: string;
22251
+ }
22252
+ /**
22253
+ * File bytes as standard base64, or a filesystem error if the read failed.
22254
+ *
22255
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
22256
+ * via the `definition` "SessionFsReadFileBytesResult".
22257
+ */
22258
+ /** @experimental */
22259
+ export interface SessionFsReadFileBytesResult {
22260
+ /**
22261
+ * Exact file bytes encoded as standard base64
22262
+ */
22263
+ content: string;
22264
+ error?: SessionFsError;
22265
+ }
21681
22266
  /**
21682
22267
  * Path of the file to read from the client-provided session filesystem.
21683
22268
  *
@@ -21767,6 +22352,10 @@ export interface SessionFsSetProviderCapabilities {
21767
22352
  * Whether the provider supports SQLite query/exists operations
21768
22353
  */
21769
22354
  sqlite?: boolean;
22355
+ /**
22356
+ * Whether the provider supports binary reads and writes through sessionFs.readFileBytes and sessionFs.writeFileBytes
22357
+ */
22358
+ binary?: boolean;
21770
22359
  }
21771
22360
  /**
21772
22361
  * 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.
@@ -21977,6 +22566,31 @@ export interface SessionFsStatResult {
21977
22566
  birthtime: string;
21978
22567
  error?: SessionFsError;
21979
22568
  }
22569
+ /**
22570
+ * File path, standard-base64-encoded bytes to write, and optional mode for the client-provided session filesystem.
22571
+ *
22572
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
22573
+ * via the `definition` "SessionFsWriteFileBytesRequest".
22574
+ */
22575
+ /** @experimental */
22576
+ export interface SessionFsWriteFileBytesRequest {
22577
+ /**
22578
+ * Target session identifier
22579
+ */
22580
+ sessionId: string;
22581
+ /**
22582
+ * Path using SessionFs conventions
22583
+ */
22584
+ path: string;
22585
+ /**
22586
+ * Exact file bytes encoded as standard base64
22587
+ */
22588
+ content: string;
22589
+ /**
22590
+ * Optional POSIX-style mode for newly created files
22591
+ */
22592
+ mode?: number;
22593
+ }
21980
22594
  /**
21981
22595
  * File path, content to write, and optional mode for the client-provided session filesystem.
21982
22596
  *
@@ -29103,6 +29717,47 @@ export declare function createServerRpc(connection: MessageConnection): {
29103
29717
  * @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.
29104
29718
  */
29105
29719
  getHostSupport: () => Promise<SandboxHostSupport>;
29720
+ /** @experimental */
29721
+ proxyCa: {
29722
+ /**
29723
+ * 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.
29724
+ *
29725
+ * @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.
29726
+ *
29727
+ * @returns Status of the persistent certificate authority of the sandbox credential proxy.
29728
+ */
29729
+ getStatus: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
29730
+ /**
29731
+ * 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.
29732
+ *
29733
+ * @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.
29734
+ *
29735
+ * @returns Result of creating the persistent certificate authority of the sandbox credential proxy.
29736
+ */
29737
+ create: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaCreateResult>;
29738
+ /**
29739
+ * 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.
29740
+ *
29741
+ * @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.
29742
+ *
29743
+ * @returns Status of the persistent certificate authority of the sandbox credential proxy.
29744
+ */
29745
+ rotate: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
29746
+ /**
29747
+ * 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.
29748
+ *
29749
+ * @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.
29750
+ *
29751
+ * @returns Status of the persistent certificate authority of the sandbox credential proxy.
29752
+ */
29753
+ trust: (params: SandboxProxyCaRequest) => Promise<SandboxProxyCaStatus>;
29754
+ /**
29755
+ * 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.
29756
+ *
29757
+ * @returns Status of the persistent certificate authority of the sandbox credential proxy.
29758
+ */
29759
+ remove: () => Promise<SandboxProxyCaStatus>;
29760
+ };
29106
29761
  };
29107
29762
  /** @experimental */
29108
29763
  tools: {
@@ -29918,6 +30573,50 @@ export declare function createServerRpc(connection: MessageConnection): {
29918
30573
  };
29919
30574
  /** Create typed session-scoped RPC methods. */
29920
30575
  export declare function createSessionRpc(connection: MessageConnection, sessionId: string): {
30576
+ /** @experimental */
30577
+ providers: {
30578
+ /**
30579
+ * 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.
30580
+ *
30581
+ * @returns Normalized model-provider adapter definitions available to the session, not discovered instances.
30582
+ */
30583
+ getCatalog: () => Promise<ModelProviderAdapterCatalog>;
30584
+ /**
30585
+ * Discovers reachable instances using an adapter from this session's effective provider catalog and provider-specific discovery input.
30586
+ *
30587
+ * @param params Provider discovery parameters.
30588
+ *
30589
+ * @returns Provider instances found by a discovery operation.
30590
+ */
30591
+ discover: (params: ModelProviderDiscoverRequest) => Promise<ModelProviderDiscoverResult>;
30592
+ /**
30593
+ * Gets current health and version information for a discovered model-provider instance.
30594
+ *
30595
+ * @param params Provider status request parameters.
30596
+ *
30597
+ * @returns Current health information for a provider instance.
30598
+ */
30599
+ getStatus: (params: ModelProviderGetStatusRequest) => Promise<ModelProviderStatus>;
30600
+ /** @experimental */
30601
+ models: {
30602
+ /**
30603
+ * Lists models installed or otherwise available from a discovered model-provider instance.
30604
+ *
30605
+ * @param params Provider model inventory request parameters.
30606
+ *
30607
+ * @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.
30608
+ */
30609
+ list: (params: ModelProviderModelsListRequest) => Promise<DiscoveredModelList>;
30610
+ /**
30611
+ * 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.
30612
+ *
30613
+ * @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`.
30614
+ *
30615
+ * @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.
30616
+ */
30617
+ prepareConfiguration: (params: ModelProviderPrepareConfigurationRequest) => Promise<ModelProviderConfigurationPlan>;
30618
+ };
30619
+ };
29921
30620
  /**
29922
30621
  * Suspends the session while preserving persisted state for later resume.
29923
30622
  *
@@ -30525,18 +31224,20 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
30525
31224
  */
30526
31225
  getSources: () => Promise<InstructionsGetSourcesResult>;
30527
31226
  /**
30528
- * Invalidates cached custom-instruction discovery so subsequent turns and source reads observe instruction files currently on disk.
31227
+ * 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.
31228
+ *
31229
+ * @returns Instruction sources loaded for the session, in merge order.
30529
31230
  */
30530
- reload: () => Promise<void>;
31231
+ reload: () => Promise<InstructionsGetSourcesResult>;
30531
31232
  };
30532
31233
  /** @experimental */
30533
31234
  customizations: {
30534
31235
  /**
30535
- * Reloads all repository and user customizations for the active session: instructions, plugins and their MCP servers and hooks, custom agents, extensions, and skills. Returns diagnostics from the final skill reload.
31236
+ * 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.
30536
31237
  *
30537
- * @returns Diagnostics from reloading skill definitions, with warnings and errors as separate lists.
31238
+ * @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.
30538
31239
  */
30539
- reload: () => Promise<SkillsLoadDiagnostics>;
31240
+ reload: () => Promise<CustomizationsReloadResult>;
30540
31241
  };
30541
31242
  /** @experimental */
30542
31243
  fleet: {
@@ -32113,6 +32814,14 @@ export interface SessionFsHandler {
32113
32814
  * @returns File content as a UTF-8 string, or a filesystem error if the read failed.
32114
32815
  */
32115
32816
  readFile(params: SessionFsReadFileRequest): Promise<SessionFsReadFileResult>;
32817
+ /**
32818
+ * Reads binary file content from the client-provided session filesystem.
32819
+ *
32820
+ * @param params Path of the binary file to read from the client-provided session filesystem.
32821
+ *
32822
+ * @returns File bytes as standard base64, or a filesystem error if the read failed.
32823
+ */
32824
+ readFileBytes(params: SessionFsReadFileBytesRequest): Promise<SessionFsReadFileBytesResult>;
32116
32825
  /**
32117
32826
  * Writes a file in the client-provided session filesystem.
32118
32827
  *
@@ -32121,6 +32830,14 @@ export interface SessionFsHandler {
32121
32830
  * @returns Describes a filesystem error.
32122
32831
  */
32123
32832
  writeFile(params: SessionFsWriteFileRequest): Promise<SessionFsError | undefined>;
32833
+ /**
32834
+ * Writes binary file content to the client-provided session filesystem.
32835
+ *
32836
+ * @param params File path, standard-base64-encoded bytes to write, and optional mode for the client-provided session filesystem.
32837
+ *
32838
+ * @returns Describes a filesystem error.
32839
+ */
32840
+ writeFileBytes(params: SessionFsWriteFileBytesRequest): Promise<SessionFsError | undefined>;
32124
32841
  /**
32125
32842
  * Appends content to a file in the client-provided session filesystem, creating parent directories as needed.
32126
32843
  *