@github/copilot-sdk 1.0.29 → 1.0.30-preview.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +98 -7
- package/dist/cjs/cliVersion.js +1 -1
- package/dist/cjs/client.js +619 -93
- package/dist/cjs/decisions.js +139 -0
- package/dist/cjs/generated/rpc.js +164 -14
- package/dist/cjs/index.js +7 -0
- package/dist/cjs/session.js +98 -9
- package/dist/cliVersion.d.ts +1 -1
- package/dist/cliVersion.js +1 -1
- package/dist/client.d.ts +36 -3
- package/dist/client.js +621 -93
- package/dist/decisions.d.ts +65 -0
- package/dist/decisions.js +113 -0
- package/dist/generated/rpc.d.ts +1429 -127
- package/dist/generated/rpc.js +164 -14
- package/dist/generated/session-events.d.ts +213 -19
- package/dist/index.d.ts +4 -2
- package/dist/index.js +8 -0
- package/dist/session.d.ts +11 -2
- package/dist/session.js +98 -9
- package/dist/types.d.ts +141 -22
- package/docs/agent-author.md +1 -1
- package/docs/examples.md +77 -17
- package/package.json +12 -12
package/dist/generated/rpc.d.ts
CHANGED
|
@@ -2172,6 +2172,211 @@ export type DebugCollectLogsResultKind =
|
|
|
2172
2172
|
"archive"
|
|
2173
2173
|
/** A directory containing the collected files was written. */
|
|
2174
2174
|
| "directory";
|
|
2175
|
+
/**
|
|
2176
|
+
* The answer to one question. Probabilities are normalized the same way for every backend.
|
|
2177
|
+
*
|
|
2178
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
2179
|
+
* via the `definition` "DecisionAnswer".
|
|
2180
|
+
*/
|
|
2181
|
+
/** @experimental */
|
|
2182
|
+
export type DecisionAnswer = {
|
|
2183
|
+
/**
|
|
2184
|
+
* Name of the question this answers.
|
|
2185
|
+
*/
|
|
2186
|
+
name: string;
|
|
2187
|
+
/**
|
|
2188
|
+
* Probability, from 0 to 1, that the answer is yes.
|
|
2189
|
+
*/
|
|
2190
|
+
probability: number;
|
|
2191
|
+
/**
|
|
2192
|
+
* Answered question kind discriminator.
|
|
2193
|
+
*/
|
|
2194
|
+
kind: "boolean";
|
|
2195
|
+
} | {
|
|
2196
|
+
/**
|
|
2197
|
+
* Name of the question this answers.
|
|
2198
|
+
*/
|
|
2199
|
+
name: string;
|
|
2200
|
+
/**
|
|
2201
|
+
* Value of the most probable option. On a tie, the tied option listed first.
|
|
2202
|
+
*/
|
|
2203
|
+
value: string;
|
|
2204
|
+
/**
|
|
2205
|
+
* True when another option has exactly the same probability as `value`. Check this, not only `confidence`.
|
|
2206
|
+
*/
|
|
2207
|
+
tied: boolean;
|
|
2208
|
+
/**
|
|
2209
|
+
* How peaked the distribution is: `(p_max - 1/n) / (1 - 1/n)`. Not a probability of being correct.
|
|
2210
|
+
*/
|
|
2211
|
+
confidence: number;
|
|
2212
|
+
/**
|
|
2213
|
+
* The backend's own confidence, which may use a different formula. Diagnostic only.
|
|
2214
|
+
*/
|
|
2215
|
+
vendorConfidence?: number;
|
|
2216
|
+
/**
|
|
2217
|
+
* Probability of every option, in request order, summing to 1.
|
|
2218
|
+
*/
|
|
2219
|
+
probabilities: DecisionOptionProbability[];
|
|
2220
|
+
/**
|
|
2221
|
+
* Answered question kind discriminator.
|
|
2222
|
+
*/
|
|
2223
|
+
kind: "choice";
|
|
2224
|
+
} | {
|
|
2225
|
+
/**
|
|
2226
|
+
* Name of the question this answers.
|
|
2227
|
+
*/
|
|
2228
|
+
name: string;
|
|
2229
|
+
/**
|
|
2230
|
+
* Expected level position: the sum of each level's zero-based position times its probability.
|
|
2231
|
+
*/
|
|
2232
|
+
score: number;
|
|
2233
|
+
/**
|
|
2234
|
+
* Label of the most probable level. On a tie, the lower level.
|
|
2235
|
+
*/
|
|
2236
|
+
level: string;
|
|
2237
|
+
/**
|
|
2238
|
+
* How peaked the distribution is: `(p_max - 1/n) / (1 - 1/n)`. Not a probability of being correct.
|
|
2239
|
+
*/
|
|
2240
|
+
confidence: number;
|
|
2241
|
+
/**
|
|
2242
|
+
* The backend's own confidence, which may use a different formula. Diagnostic only.
|
|
2243
|
+
*/
|
|
2244
|
+
vendorConfidence?: number;
|
|
2245
|
+
/**
|
|
2246
|
+
* Probability of every level, from lowest to highest, summing to 1.
|
|
2247
|
+
*/
|
|
2248
|
+
probabilities: DecisionLevelProbability[];
|
|
2249
|
+
/**
|
|
2250
|
+
* Answered question kind discriminator.
|
|
2251
|
+
*/
|
|
2252
|
+
kind: "score";
|
|
2253
|
+
} | {
|
|
2254
|
+
/**
|
|
2255
|
+
* Name of the question that was refused.
|
|
2256
|
+
*/
|
|
2257
|
+
name: string;
|
|
2258
|
+
/**
|
|
2259
|
+
* Answered question kind discriminator.
|
|
2260
|
+
*/
|
|
2261
|
+
kind: "refused";
|
|
2262
|
+
};
|
|
2263
|
+
/**
|
|
2264
|
+
* Context shared by every question in a request.
|
|
2265
|
+
*
|
|
2266
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
2267
|
+
* via the `definition` "DecisionContext".
|
|
2268
|
+
*/
|
|
2269
|
+
/** @experimental */
|
|
2270
|
+
export type DecisionContext = {
|
|
2271
|
+
/**
|
|
2272
|
+
* The text the questions are about.
|
|
2273
|
+
*/
|
|
2274
|
+
text: string;
|
|
2275
|
+
/**
|
|
2276
|
+
* Context format discriminator.
|
|
2277
|
+
*/
|
|
2278
|
+
kind: "text";
|
|
2279
|
+
} | {
|
|
2280
|
+
/**
|
|
2281
|
+
* A JSON object, or an array of JSON objects. Other JSON values are rejected with `invalidRequest`.
|
|
2282
|
+
*/
|
|
2283
|
+
value: JsonValue;
|
|
2284
|
+
/**
|
|
2285
|
+
* Context format discriminator.
|
|
2286
|
+
*/
|
|
2287
|
+
kind: "json";
|
|
2288
|
+
};
|
|
2289
|
+
/**
|
|
2290
|
+
* Why a decisions request failed.
|
|
2291
|
+
*
|
|
2292
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
2293
|
+
* via the `definition` "DecisionErrorKind".
|
|
2294
|
+
*/
|
|
2295
|
+
/** @experimental */
|
|
2296
|
+
export type DecisionErrorKind =
|
|
2297
|
+
/** The decisions feature is disabled for this runtime. */
|
|
2298
|
+
"notEnabled"
|
|
2299
|
+
/** No usable decision model: unknown id, not entitled, or rejected by the backend. */
|
|
2300
|
+
| "noModel"
|
|
2301
|
+
/** No account, or the backend rejected its credential. */
|
|
2302
|
+
| "unauthenticated"
|
|
2303
|
+
/** The request is malformed or breaks a limit other than size. */
|
|
2304
|
+
| "invalidRequest"
|
|
2305
|
+
/** The request is over a size limit. */
|
|
2306
|
+
| "tooLarge"
|
|
2307
|
+
/** The backend answered with something that breaks the answer rules. */
|
|
2308
|
+
| "upstreamProtocol"
|
|
2309
|
+
/** The backend is rate limiting this account. */
|
|
2310
|
+
| "rateLimited"
|
|
2311
|
+
/** The deadline passed. */
|
|
2312
|
+
| "timeout"
|
|
2313
|
+
/** The backend could not be reached or failed. */
|
|
2314
|
+
| "unavailable"
|
|
2315
|
+
/** Too many decisions requests are already running or waiting on this connection. */
|
|
2316
|
+
| "overloaded";
|
|
2317
|
+
/**
|
|
2318
|
+
* One question for the decision model to answer about the context.
|
|
2319
|
+
*
|
|
2320
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
2321
|
+
* via the `definition` "DecisionQuestion".
|
|
2322
|
+
*/
|
|
2323
|
+
/** @experimental */
|
|
2324
|
+
export type DecisionQuestion = {
|
|
2325
|
+
/**
|
|
2326
|
+
* Caller-chosen name, unique within the request, that identifies this question's answer. Never sent to the model.
|
|
2327
|
+
*/
|
|
2328
|
+
name: string;
|
|
2329
|
+
/**
|
|
2330
|
+
* The yes/no question.
|
|
2331
|
+
*/
|
|
2332
|
+
instructions: string;
|
|
2333
|
+
/**
|
|
2334
|
+
* Optional description of when the answer is yes.
|
|
2335
|
+
*/
|
|
2336
|
+
whenTrue?: string;
|
|
2337
|
+
/**
|
|
2338
|
+
* Optional description of when the answer is no.
|
|
2339
|
+
*/
|
|
2340
|
+
whenFalse?: string;
|
|
2341
|
+
/**
|
|
2342
|
+
* Question kind discriminator.
|
|
2343
|
+
*/
|
|
2344
|
+
kind: "boolean";
|
|
2345
|
+
} | {
|
|
2346
|
+
/**
|
|
2347
|
+
* Caller-chosen name, unique within the request, that identifies this question's answer. Never sent to the model.
|
|
2348
|
+
*/
|
|
2349
|
+
name: string;
|
|
2350
|
+
/**
|
|
2351
|
+
* The question whose answer is one of `options`.
|
|
2352
|
+
*/
|
|
2353
|
+
instructions: string;
|
|
2354
|
+
/**
|
|
2355
|
+
* Candidate answers. Values must be unique identifiers; the model reads both value and description.
|
|
2356
|
+
*/
|
|
2357
|
+
options: DecisionOption[];
|
|
2358
|
+
/**
|
|
2359
|
+
* Question kind discriminator.
|
|
2360
|
+
*/
|
|
2361
|
+
kind: "choice";
|
|
2362
|
+
} | {
|
|
2363
|
+
/**
|
|
2364
|
+
* Caller-chosen name, unique within the request, that identifies this question's answer. Never sent to the model.
|
|
2365
|
+
*/
|
|
2366
|
+
name: string;
|
|
2367
|
+
/**
|
|
2368
|
+
* The question whose answer is a rating on `levels`.
|
|
2369
|
+
*/
|
|
2370
|
+
instructions: string;
|
|
2371
|
+
/**
|
|
2372
|
+
* Scale levels from lowest to highest. A level's zero-based position is its numeric value.
|
|
2373
|
+
*/
|
|
2374
|
+
levels: DecisionLevel[];
|
|
2375
|
+
/**
|
|
2376
|
+
* Question kind discriminator.
|
|
2377
|
+
*/
|
|
2378
|
+
kind: "score";
|
|
2379
|
+
};
|
|
2175
2380
|
/**
|
|
2176
2381
|
* Whether the supplied diagnostic cursor remained within the retained buffer window.
|
|
2177
2382
|
*
|
|
@@ -3379,30 +3584,6 @@ export type InstructionSourceLocation =
|
|
|
3379
3584
|
| "working-directory"
|
|
3380
3585
|
/** Instructions live in plugin-provided configuration. */
|
|
3381
3586
|
| "plugin";
|
|
3382
|
-
/**
|
|
3383
|
-
* Selects whether Kerberos credentials come from native lookup with a client fallback, or only from the client.
|
|
3384
|
-
*
|
|
3385
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3386
|
-
* via the `definition` "KerberosAuthMode".
|
|
3387
|
-
*/
|
|
3388
|
-
/** @experimental */
|
|
3389
|
-
export type KerberosAuthMode =
|
|
3390
|
-
/** Use the callback only when native credential lookup fails. */
|
|
3391
|
-
"fallback"
|
|
3392
|
-
/** Always use the callback without native credential lookup. */
|
|
3393
|
-
| "always";
|
|
3394
|
-
/**
|
|
3395
|
-
* Selects which traffic a client's Kerberos callback authenticates.
|
|
3396
|
-
*
|
|
3397
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
3398
|
-
* via the `definition` "KerberosAuthScope".
|
|
3399
|
-
*/
|
|
3400
|
-
/** @experimental */
|
|
3401
|
-
export type KerberosAuthScope =
|
|
3402
|
-
/** Authenticate only requests made for this connection's sessions. */
|
|
3403
|
-
"connection"
|
|
3404
|
-
/** Also authenticate the runtime's shared background traffic. Only one connection at a time may claim this scope. */
|
|
3405
|
-
| "runtime";
|
|
3406
3587
|
/**
|
|
3407
3588
|
* Transport the runtime would otherwise use for this request. `http` (the default when absent) covers plain HTTP and SSE responses; `websocket` indicates a full-duplex message channel where each body chunk maps to one WebSocket message and the `binary` flag distinguishes text from binary frames. The SDK consumer uses this to decide whether to service the request with an HTTP client or a WebSocket client. It is the one piece of request metadata the consumer cannot reliably infer from the URL or headers alone.
|
|
3408
3589
|
*
|
|
@@ -4143,6 +4324,18 @@ export type McpToolUiVisibility =
|
|
|
4143
4324
|
"model"
|
|
4144
4325
|
/** An MCP App view may call the tool. */
|
|
4145
4326
|
| "app";
|
|
4327
|
+
/**
|
|
4328
|
+
* OAuth grant type override for this login.
|
|
4329
|
+
*
|
|
4330
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
4331
|
+
* via the `definition` "McpOauthLoginGrantType".
|
|
4332
|
+
*/
|
|
4333
|
+
/** @experimental */
|
|
4334
|
+
export type McpOauthLoginGrantType =
|
|
4335
|
+
/** Interactive browser-based OAuth flow using an authorization code, typically with PKCE. */
|
|
4336
|
+
"authorization_code"
|
|
4337
|
+
/** Headless OAuth flow where a confidential client authenticates directly with a client secret. */
|
|
4338
|
+
| "client_credentials";
|
|
4146
4339
|
/**
|
|
4147
4340
|
* Host response to the pending OAuth request.
|
|
4148
4341
|
*
|
|
@@ -4178,18 +4371,6 @@ export type McpOauthPendingRequestResponse = {
|
|
|
4178
4371
|
*/
|
|
4179
4372
|
kind: "runtimeRefresh";
|
|
4180
4373
|
};
|
|
4181
|
-
/**
|
|
4182
|
-
* OAuth grant type override for this login.
|
|
4183
|
-
*
|
|
4184
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
4185
|
-
* via the `definition` "McpOauthLoginGrantType".
|
|
4186
|
-
*/
|
|
4187
|
-
/** @experimental */
|
|
4188
|
-
export type McpOauthLoginGrantType =
|
|
4189
|
-
/** Interactive browser-based OAuth flow using an authorization code, typically with PKCE. */
|
|
4190
|
-
"authorization_code"
|
|
4191
|
-
/** Headless OAuth flow where a confidential client authenticates directly with a client secret. */
|
|
4192
|
-
| "client_credentials";
|
|
4193
4374
|
/**
|
|
4194
4375
|
* Outcome of starting the original prepared owned login.
|
|
4195
4376
|
*
|
|
@@ -4860,6 +5041,18 @@ export type TokenPriceUnit =
|
|
|
4860
5041
|
"ai_credits"
|
|
4861
5042
|
/** Prices are quoted in nano-AIU; divide by 1,000,000,000 to get AI Credits. */
|
|
4862
5043
|
| "nano_aiu";
|
|
5044
|
+
/**
|
|
5045
|
+
* Selects which traffic a client's network callbacks serve.
|
|
5046
|
+
*
|
|
5047
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
5048
|
+
* via the `definition` "NetworkScope".
|
|
5049
|
+
*/
|
|
5050
|
+
/** @experimental */
|
|
5051
|
+
export type NetworkScope =
|
|
5052
|
+
/** Serve only requests made for this connection and its sessions. */
|
|
5053
|
+
"connection"
|
|
5054
|
+
/** Also serve the runtime's shared background traffic. Only one connection at a time may claim this scope. */
|
|
5055
|
+
| "runtime";
|
|
4863
5056
|
/**
|
|
4864
5057
|
* Allowed values for the `OptionsUpdateAdditionalContentExclusionPolicyScope` enumeration.
|
|
4865
5058
|
*
|
|
@@ -5486,7 +5679,7 @@ export type SandboxConfigSource =
|
|
|
5486
5679
|
/** A repository policy selected the sandbox state. */
|
|
5487
5680
|
| "repository_policy";
|
|
5488
5681
|
/**
|
|
5489
|
-
* Extensible identifier of a sandbox policy feature whose availability varies between hosts. A plain string, so an older client decodes a name added by a newer runtime; ignore names you do not recognize. Known values: `network` — sandboxed commands can reach the network (`network.allowOutbound`, on by default); on Linux this needs the tooling for Bubblewrap's private network namespace, such as slirp4netns. `network_filtering` — host rules and the sandbox proxy (`network.allowedHosts`, `network.blockedHosts`, `network.proxy`); on Linux this needs the same tooling as `network`; on Windows it needs Process Security Environment 1.1 host-loopback support or MXC's PSEC 1.0-only proxy-loopback compatibility capability, and a policy that uses it must also set `network.allowLocalNetwork`, because Windows reaches the local proxy only together with private-network access. Compatibility applies only to an explicit identity-less runtime proxy, not general host-loopback access, and other policy restrictions still apply. `denied_paths` — native enforcement of `filesystem.deniedPaths`; on Windows this needs a version whose sandbox contract reports denied-path support. `shell` — shell commands inside the sandbox: bash on macOS and Linux, PowerShell on Windows. `filesystem_enumeration` — enumerate-only filesystem grants, which PowerShell's drive roots use on Windows; this needs a version with Process Security Environment 1.1 filesystem enumeration support. Without it, sandboxed PowerShell still runs, but `Get-Location` may report the drive root, `Set-Location` may fail, and relative paths may resolve against the drive root; the session also receives a `session.warning` with `warningType` `sandbox`. Other platforms always report it.
|
|
5682
|
+
* Extensible identifier of a sandbox policy feature whose availability varies between hosts. A plain string, so an older client decodes a name added by a newer runtime; ignore names you do not recognize. Known values: `network` — sandboxed commands can reach the network (`network.allowOutbound`, on by default); on Linux this needs the tooling for Bubblewrap's private network namespace, such as slirp4netns. `network_filtering` — host rules and the sandbox proxy (`network.allowedHosts`, `network.blockedHosts`, `network.proxy`); on Linux this needs the same tooling as `network`; on Windows it needs Process Security Environment 1.1 host-loopback support or MXC's PSEC 1.0-only proxy-loopback compatibility capability, and a policy that uses it must also set `network.allowLocalNetwork`, because Windows reaches the local proxy only together with private-network access. Compatibility applies only to an explicit identity-less runtime proxy, not general host-loopback access, and other policy restrictions still apply. `denied_paths` — native enforcement of `filesystem.deniedPaths`; on Windows this needs a version whose sandbox contract reports denied-path support. `shell` — shell commands inside the sandbox: bash on macOS and Linux, PowerShell on Windows. `filesystem_enumeration` — enumerate-only filesystem grants, which PowerShell's drive roots and `filesystem.enumeratePaths` use on Windows; this needs a version with Process Security Environment 1.1 filesystem enumeration support. Without it, sandboxed PowerShell still runs, but `Get-Location` may report the drive root, `Set-Location` may fail, and relative paths may resolve against the drive root; the session also receives a `session.warning` with `warningType` `sandbox`. `filesystem.enumeratePaths` entries are ignored. Other platforms always report it.
|
|
5490
5683
|
*
|
|
5491
5684
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
5492
5685
|
* via the `definition` "SandboxHostCapabilityName".
|
|
@@ -5943,6 +6136,23 @@ export type SessionsOpenProgressStatus =
|
|
|
5943
6136
|
"in-progress"
|
|
5944
6137
|
/** The step has completed successfully. */
|
|
5945
6138
|
| "complete";
|
|
6139
|
+
/**
|
|
6140
|
+
* GitHub marketplace source supplied by Team customizations.
|
|
6141
|
+
*
|
|
6142
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
6143
|
+
* via the `definition` "TeamPluginMarketplaceSource".
|
|
6144
|
+
*/
|
|
6145
|
+
/** @experimental */
|
|
6146
|
+
export type TeamPluginMarketplaceSource = {
|
|
6147
|
+
/**
|
|
6148
|
+
* Marketplace source discriminator. Currently only github is supported.
|
|
6149
|
+
*/
|
|
6150
|
+
source: "github";
|
|
6151
|
+
/**
|
|
6152
|
+
* GitHub repository in owner/name form.
|
|
6153
|
+
*/
|
|
6154
|
+
repo: string;
|
|
6155
|
+
};
|
|
5946
6156
|
/**
|
|
5947
6157
|
* Copilot plan tier used by the session quota projection.
|
|
5948
6158
|
*
|
|
@@ -6918,6 +7128,21 @@ export type UISessionLimitsExhaustedResponseAction =
|
|
|
6918
7128
|
| "unset"
|
|
6919
7129
|
/** Leave the limit unchanged and cancel the blocked model request. */
|
|
6920
7130
|
| "cancel";
|
|
7131
|
+
/**
|
|
7132
|
+
* Optional recovery-aware enrollment for an in-process Auto-switch handler.
|
|
7133
|
+
*
|
|
7134
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7135
|
+
* via the `definition` "UIRegisterDirectAutoModeSwitchHandlerRequest".
|
|
7136
|
+
*/
|
|
7137
|
+
/** @experimental */
|
|
7138
|
+
export type UIRegisterDirectAutoModeSwitchHandlerRequest = {
|
|
7139
|
+
[k: string]: unknown | undefined;
|
|
7140
|
+
} | {
|
|
7141
|
+
/**
|
|
7142
|
+
* Opt into active-request Auto recovery before starting a turn. Attach the handler separately, show the failure reason, and return the user's choice for the originating live session. Require a positive acknowledgment in the registration result. Dismiss offers on auto_mode_recovery_consent.completed and on session resume or disconnect. Omitted or false preserves legacy rate-limit switching.
|
|
7143
|
+
*/
|
|
7144
|
+
autoModeRecovery?: boolean;
|
|
7145
|
+
};
|
|
6921
7146
|
/**
|
|
6922
7147
|
* Execution-critical workflow storage operation.
|
|
6923
7148
|
*
|
|
@@ -7265,6 +7490,30 @@ export type SessionGitHubAuthLogoutResult = boolean;
|
|
|
7265
7490
|
*/
|
|
7266
7491
|
/** @experimental */
|
|
7267
7492
|
export type SessionGitHubAuthLogoutUserResult = boolean;
|
|
7493
|
+
/**
|
|
7494
|
+
* Whether the credential operation succeeded.
|
|
7495
|
+
*
|
|
7496
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7497
|
+
* via the `definition` "SessionMcpOauthHasValidTokensResult".
|
|
7498
|
+
*/
|
|
7499
|
+
/** @experimental */
|
|
7500
|
+
export type SessionMcpOauthHasValidTokensResult = boolean;
|
|
7501
|
+
/**
|
|
7502
|
+
* Whether the credential operation succeeded.
|
|
7503
|
+
*
|
|
7504
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7505
|
+
* via the `definition` "SessionMcpOauthTryRefreshTokensResult".
|
|
7506
|
+
*/
|
|
7507
|
+
/** @experimental */
|
|
7508
|
+
export type SessionMcpOauthTryRefreshTokensResult = boolean;
|
|
7509
|
+
/**
|
|
7510
|
+
* The selected owner's OAuth credential key.
|
|
7511
|
+
*
|
|
7512
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
7513
|
+
* via the `definition` "SessionMcpOauthStoreKeyResult".
|
|
7514
|
+
*/
|
|
7515
|
+
/** @experimental */
|
|
7516
|
+
export type SessionMcpOauthStoreKeyResult = string;
|
|
7268
7517
|
/**
|
|
7269
7518
|
* Pending warnings returned and cleared by session.quota.takeWarnings.
|
|
7270
7519
|
*
|
|
@@ -13692,6 +13941,289 @@ export interface DebugCollectLogsSkippedEntry {
|
|
|
13692
13941
|
*/
|
|
13693
13942
|
reason: string;
|
|
13694
13943
|
}
|
|
13944
|
+
/**
|
|
13945
|
+
* Probability of one choice option.
|
|
13946
|
+
*
|
|
13947
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
13948
|
+
* via the `definition` "DecisionOptionProbability".
|
|
13949
|
+
*/
|
|
13950
|
+
/** @experimental */
|
|
13951
|
+
export interface DecisionOptionProbability {
|
|
13952
|
+
/**
|
|
13953
|
+
* Option value.
|
|
13954
|
+
*/
|
|
13955
|
+
value: string;
|
|
13956
|
+
/**
|
|
13957
|
+
* Probability from 0 to 1.
|
|
13958
|
+
*/
|
|
13959
|
+
probability: number;
|
|
13960
|
+
}
|
|
13961
|
+
/**
|
|
13962
|
+
* Probability of one score level.
|
|
13963
|
+
*
|
|
13964
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
13965
|
+
* via the `definition` "DecisionLevelProbability".
|
|
13966
|
+
*/
|
|
13967
|
+
/** @experimental */
|
|
13968
|
+
export interface DecisionLevelProbability {
|
|
13969
|
+
/**
|
|
13970
|
+
* Level label.
|
|
13971
|
+
*/
|
|
13972
|
+
label: string;
|
|
13973
|
+
/**
|
|
13974
|
+
* Probability from 0 to 1.
|
|
13975
|
+
*/
|
|
13976
|
+
probability: number;
|
|
13977
|
+
}
|
|
13978
|
+
/**
|
|
13979
|
+
* `data` of a JSON-RPC error returned by a `decisions.*` method.
|
|
13980
|
+
*
|
|
13981
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
13982
|
+
* via the `definition` "DecisionErrorData".
|
|
13983
|
+
*/
|
|
13984
|
+
/** @experimental */
|
|
13985
|
+
export interface DecisionErrorData {
|
|
13986
|
+
/**
|
|
13987
|
+
* Error category to branch on.
|
|
13988
|
+
*/
|
|
13989
|
+
kind: DecisionErrorKind;
|
|
13990
|
+
/**
|
|
13991
|
+
* Every limit or rule the request broke, for `invalidRequest` and `tooLarge`.
|
|
13992
|
+
*/
|
|
13993
|
+
violations?: DecisionViolation[];
|
|
13994
|
+
/**
|
|
13995
|
+
* HTTP status the backend returned, when the error came from it.
|
|
13996
|
+
*/
|
|
13997
|
+
statusCode?: number;
|
|
13998
|
+
/**
|
|
13999
|
+
* How long to wait before retrying, for `rateLimited`.
|
|
14000
|
+
*/
|
|
14001
|
+
retryAfterMs?: number;
|
|
14002
|
+
}
|
|
14003
|
+
/**
|
|
14004
|
+
* One rule or limit a request broke.
|
|
14005
|
+
*
|
|
14006
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14007
|
+
* via the `definition` "DecisionViolation".
|
|
14008
|
+
*/
|
|
14009
|
+
/** @experimental */
|
|
14010
|
+
export interface DecisionViolation {
|
|
14011
|
+
/**
|
|
14012
|
+
* Where in the request, for example `questions[2].options`.
|
|
14013
|
+
*/
|
|
14014
|
+
path: string;
|
|
14015
|
+
/**
|
|
14016
|
+
* Stable rule identifier, for example `minOptions` or `requestBytes`.
|
|
14017
|
+
*/
|
|
14018
|
+
rule: string;
|
|
14019
|
+
/**
|
|
14020
|
+
* The value the request had, when numeric.
|
|
14021
|
+
*/
|
|
14022
|
+
actual?: number;
|
|
14023
|
+
/**
|
|
14024
|
+
* The limit it broke, when numeric.
|
|
14025
|
+
*/
|
|
14026
|
+
limit?: number;
|
|
14027
|
+
}
|
|
14028
|
+
/**
|
|
14029
|
+
* One level of a score question's scale.
|
|
14030
|
+
*
|
|
14031
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14032
|
+
* via the `definition` "DecisionLevel".
|
|
14033
|
+
*/
|
|
14034
|
+
/** @experimental */
|
|
14035
|
+
export interface DecisionLevel {
|
|
14036
|
+
/**
|
|
14037
|
+
* Short, unique name of the level, such as `Low`.
|
|
14038
|
+
*/
|
|
14039
|
+
label: string;
|
|
14040
|
+
/**
|
|
14041
|
+
* When this level applies.
|
|
14042
|
+
*/
|
|
14043
|
+
description: string;
|
|
14044
|
+
}
|
|
14045
|
+
/**
|
|
14046
|
+
* One callable decision model.
|
|
14047
|
+
*
|
|
14048
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14049
|
+
* via the `definition` "DecisionModelInfo".
|
|
14050
|
+
*/
|
|
14051
|
+
/** @experimental */
|
|
14052
|
+
export interface DecisionModelInfo {
|
|
14053
|
+
/**
|
|
14054
|
+
* Model id to pass as `model` to `decisions.ask`.
|
|
14055
|
+
*/
|
|
14056
|
+
id: string;
|
|
14057
|
+
/**
|
|
14058
|
+
* Display name.
|
|
14059
|
+
*/
|
|
14060
|
+
name: string;
|
|
14061
|
+
/**
|
|
14062
|
+
* Whether `decisions.ask` uses this model when `model` is omitted.
|
|
14063
|
+
*/
|
|
14064
|
+
isDefault: boolean;
|
|
14065
|
+
/**
|
|
14066
|
+
* Effective limits callers can rely on: the stricter of the backend's and the runtime's.
|
|
14067
|
+
*/
|
|
14068
|
+
limits: DecisionModelLimits;
|
|
14069
|
+
/**
|
|
14070
|
+
* Whether the backend can refuse individual questions.
|
|
14071
|
+
*/
|
|
14072
|
+
supportsRefusals: boolean;
|
|
14073
|
+
}
|
|
14074
|
+
/**
|
|
14075
|
+
* Request limits for one decision model.
|
|
14076
|
+
*
|
|
14077
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14078
|
+
* via the `definition` "DecisionModelLimits".
|
|
14079
|
+
*/
|
|
14080
|
+
/** @experimental */
|
|
14081
|
+
export interface DecisionModelLimits {
|
|
14082
|
+
/**
|
|
14083
|
+
* Maximum questions per request.
|
|
14084
|
+
*/
|
|
14085
|
+
maxQuestions: number;
|
|
14086
|
+
/**
|
|
14087
|
+
* Minimum options per choice question.
|
|
14088
|
+
*/
|
|
14089
|
+
minOptions: number;
|
|
14090
|
+
/**
|
|
14091
|
+
* Maximum options per choice question.
|
|
14092
|
+
*/
|
|
14093
|
+
maxOptions: number;
|
|
14094
|
+
/**
|
|
14095
|
+
* Minimum levels per score question.
|
|
14096
|
+
*/
|
|
14097
|
+
minLevels: number;
|
|
14098
|
+
/**
|
|
14099
|
+
* Maximum levels per score question.
|
|
14100
|
+
*/
|
|
14101
|
+
maxLevels: number;
|
|
14102
|
+
/**
|
|
14103
|
+
* Maximum size of the serialized request, in bytes.
|
|
14104
|
+
*/
|
|
14105
|
+
maxRequestBytes: number;
|
|
14106
|
+
/**
|
|
14107
|
+
* Maximum nesting depth of JSON context.
|
|
14108
|
+
*/
|
|
14109
|
+
maxJsonDepth: number;
|
|
14110
|
+
/**
|
|
14111
|
+
* Token budget for the context plus any one question, when the model has one.
|
|
14112
|
+
*/
|
|
14113
|
+
contextPlusQuestionTokens?: number;
|
|
14114
|
+
}
|
|
14115
|
+
/**
|
|
14116
|
+
* One candidate answer to a choice question.
|
|
14117
|
+
*
|
|
14118
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14119
|
+
* via the `definition` "DecisionOption".
|
|
14120
|
+
*/
|
|
14121
|
+
/** @experimental */
|
|
14122
|
+
export interface DecisionOption {
|
|
14123
|
+
/**
|
|
14124
|
+
* Identifier returned when the model picks this option. Letters, digits and `._:/@-`, 1-64 characters. The model reads it, so it must not hold anything the caller would not put in the context.
|
|
14125
|
+
*/
|
|
14126
|
+
value: string;
|
|
14127
|
+
/**
|
|
14128
|
+
* When this option applies.
|
|
14129
|
+
*/
|
|
14130
|
+
description: string;
|
|
14131
|
+
}
|
|
14132
|
+
/**
|
|
14133
|
+
* One request to a decision model: shared context plus the questions to answer about it.
|
|
14134
|
+
*
|
|
14135
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14136
|
+
* via the `definition` "DecisionsAskRequest".
|
|
14137
|
+
*/
|
|
14138
|
+
/** @experimental */
|
|
14139
|
+
export interface DecisionsAskRequest {
|
|
14140
|
+
/**
|
|
14141
|
+
* Opaque account identifier returned by `account.getAllUsers`. When omitted, the current account is used.
|
|
14142
|
+
*/
|
|
14143
|
+
selectionId?: string;
|
|
14144
|
+
/**
|
|
14145
|
+
* GitHub token to ask as. When provided, it is used instead of the current account or `selectionId`.
|
|
14146
|
+
*/
|
|
14147
|
+
gitHubToken?: string;
|
|
14148
|
+
/**
|
|
14149
|
+
* Decision model id from `models.list` `decisionModels`. When omitted, the runtime uses its default decision model for the account.
|
|
14150
|
+
*/
|
|
14151
|
+
model?: string;
|
|
14152
|
+
/**
|
|
14153
|
+
* Shared context every question sees. The runtime never truncates it; an oversized request fails with `tooLarge`.
|
|
14154
|
+
*/
|
|
14155
|
+
context: DecisionContext;
|
|
14156
|
+
/**
|
|
14157
|
+
* Questions to answer about the context. Names must be unique; answers come back in the same order.
|
|
14158
|
+
*/
|
|
14159
|
+
questions: DecisionQuestion[];
|
|
14160
|
+
/**
|
|
14161
|
+
* End-to-end deadline in milliseconds, covering credential resolution, queueing, the model call and parsing. Defaults to 5000; allowed range 250-30000.
|
|
14162
|
+
*/
|
|
14163
|
+
timeoutMs?: number;
|
|
14164
|
+
/**
|
|
14165
|
+
* Static identifier of the calling feature, used only for telemetry and never sent to the model, for example `vscode.chat.route`. Unrecognized values are reported as `other`.
|
|
14166
|
+
*/
|
|
14167
|
+
purpose?: string;
|
|
14168
|
+
}
|
|
14169
|
+
/**
|
|
14170
|
+
* The decision model's answers.
|
|
14171
|
+
*
|
|
14172
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14173
|
+
* via the `definition` "DecisionsAskResult".
|
|
14174
|
+
*/
|
|
14175
|
+
/** @experimental */
|
|
14176
|
+
export interface DecisionsAskResult {
|
|
14177
|
+
/**
|
|
14178
|
+
* Decision model id that answered; valid as `model` in a later request.
|
|
14179
|
+
*/
|
|
14180
|
+
model: string;
|
|
14181
|
+
/**
|
|
14182
|
+
* Model name the backend reported, when it differs from `model`. Informational only.
|
|
14183
|
+
*/
|
|
14184
|
+
upstreamModel?: string;
|
|
14185
|
+
/**
|
|
14186
|
+
* One answer per question, in request order.
|
|
14187
|
+
*/
|
|
14188
|
+
answers: DecisionAnswer[];
|
|
14189
|
+
/**
|
|
14190
|
+
* Token usage, when the backend reports it.
|
|
14191
|
+
*/
|
|
14192
|
+
usage?: DecisionUsage;
|
|
14193
|
+
/**
|
|
14194
|
+
* Milliseconds from receiving the request to producing the result.
|
|
14195
|
+
*/
|
|
14196
|
+
latencyMs: number;
|
|
14197
|
+
}
|
|
14198
|
+
/**
|
|
14199
|
+
* Token usage the backend reported for one request.
|
|
14200
|
+
*
|
|
14201
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
14202
|
+
* via the `definition` "DecisionUsage".
|
|
14203
|
+
*/
|
|
14204
|
+
/** @experimental */
|
|
14205
|
+
export interface DecisionUsage {
|
|
14206
|
+
/**
|
|
14207
|
+
* Input tokens, including cached and cache-write tokens.
|
|
14208
|
+
*/
|
|
14209
|
+
inputTokens: number;
|
|
14210
|
+
/**
|
|
14211
|
+
* Input tokens served from the backend's prompt cache, when reported.
|
|
14212
|
+
*/
|
|
14213
|
+
cachedInputTokens?: number;
|
|
14214
|
+
/**
|
|
14215
|
+
* Input tokens written to the backend's prompt cache, when reported.
|
|
14216
|
+
*/
|
|
14217
|
+
cacheWriteTokens?: number;
|
|
14218
|
+
/**
|
|
14219
|
+
* Output tokens, including reasoning tokens.
|
|
14220
|
+
*/
|
|
14221
|
+
outputTokens: number;
|
|
14222
|
+
/**
|
|
14223
|
+
* Reasoning tokens, when reported.
|
|
14224
|
+
*/
|
|
14225
|
+
reasoningTokens?: number;
|
|
14226
|
+
}
|
|
13695
14227
|
/**
|
|
13696
14228
|
* MCP-specific detail for a source-discriminated diagnostic entry.
|
|
13697
14229
|
*
|
|
@@ -17131,6 +17663,10 @@ export interface InstallationConfirmationResponse {
|
|
|
17131
17663
|
*/
|
|
17132
17664
|
/** @experimental */
|
|
17133
17665
|
export interface InstalledPluginInfo {
|
|
17666
|
+
/**
|
|
17667
|
+
* Soft assignment from effective managed settings. This is not a mandatory enabled-state restriction.
|
|
17668
|
+
*/
|
|
17669
|
+
assignment?: ManagedPluginAssignment;
|
|
17134
17670
|
/**
|
|
17135
17671
|
* Plugin name
|
|
17136
17672
|
*/
|
|
@@ -17192,6 +17728,23 @@ export interface InstalledPluginInfo {
|
|
|
17192
17728
|
*/
|
|
17193
17729
|
id?: string;
|
|
17194
17730
|
}
|
|
17731
|
+
/**
|
|
17732
|
+
* An optional plugin default from managed settings. Explicit user choices override this default.
|
|
17733
|
+
*
|
|
17734
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17735
|
+
* via the `definition` "ManagedPluginAssignment".
|
|
17736
|
+
*/
|
|
17737
|
+
/** @experimental */
|
|
17738
|
+
export interface ManagedPluginAssignment {
|
|
17739
|
+
/**
|
|
17740
|
+
* Assignment state. The runtime currently supports defaultEnabled.
|
|
17741
|
+
*/
|
|
17742
|
+
state: string;
|
|
17743
|
+
/**
|
|
17744
|
+
* Administrator-provided explanation from the same winning policy entry as the state.
|
|
17745
|
+
*/
|
|
17746
|
+
reason?: string;
|
|
17747
|
+
}
|
|
17195
17748
|
/**
|
|
17196
17749
|
* The GitHub repository and commit an installed plugin is pinned to.
|
|
17197
17750
|
*
|
|
@@ -17410,49 +17963,6 @@ export interface JsonSchemaResponseFormat {
|
|
|
17410
17963
|
*/
|
|
17411
17964
|
strict?: boolean;
|
|
17412
17965
|
}
|
|
17413
|
-
/**
|
|
17414
|
-
* Requests a fresh initial SPNEGO token for a Kerberos service principal.
|
|
17415
|
-
*
|
|
17416
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17417
|
-
* via the `definition` "KerberosAuthAcquireRequest".
|
|
17418
|
-
*/
|
|
17419
|
-
/** @experimental */
|
|
17420
|
-
export interface KerberosAuthAcquireRequest {
|
|
17421
|
-
/**
|
|
17422
|
-
* Service principal in the platform-independent `service/host` form, optionally followed by `@REALM`.
|
|
17423
|
-
*/
|
|
17424
|
-
spn: string;
|
|
17425
|
-
}
|
|
17426
|
-
/**
|
|
17427
|
-
* Client credentials for a single authentication exchange.
|
|
17428
|
-
*
|
|
17429
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17430
|
-
* via the `definition` "KerberosAuthAcquireResult".
|
|
17431
|
-
*/
|
|
17432
|
-
/** @experimental */
|
|
17433
|
-
export interface KerberosAuthAcquireResult {
|
|
17434
|
-
/**
|
|
17435
|
-
* Base64 initial SPNEGO token without the Negotiate prefix; omitted when unavailable. Never log or persist it.
|
|
17436
|
-
*/
|
|
17437
|
-
token?: string;
|
|
17438
|
-
}
|
|
17439
|
-
/**
|
|
17440
|
-
* Registers the calling SDK connection's Kerberos credential provider.
|
|
17441
|
-
*
|
|
17442
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
17443
|
-
* via the `definition` "KerberosAuthSetProviderRequest".
|
|
17444
|
-
*/
|
|
17445
|
-
/** @experimental */
|
|
17446
|
-
export interface KerberosAuthSetProviderRequest {
|
|
17447
|
-
/**
|
|
17448
|
-
* Native lookup fallback or exclusive client callback.
|
|
17449
|
-
*/
|
|
17450
|
-
mode: KerberosAuthMode;
|
|
17451
|
-
/**
|
|
17452
|
-
* Traffic the callback authenticates; defaults to `connection`.
|
|
17453
|
-
*/
|
|
17454
|
-
scope?: KerberosAuthScope;
|
|
17455
|
-
}
|
|
17456
17966
|
/**
|
|
17457
17967
|
* HTTP headers as a map from lowercased header name to a list of values. Multi-valued headers (e.g. Set-Cookie) preserve all values.
|
|
17458
17968
|
*
|
|
@@ -17805,6 +18315,144 @@ export interface LogResult {
|
|
|
17805
18315
|
*/
|
|
17806
18316
|
eventId: string;
|
|
17807
18317
|
}
|
|
18318
|
+
/**
|
|
18319
|
+
* A project configuration that the tolerant loader could not use.
|
|
18320
|
+
*
|
|
18321
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18322
|
+
* via the `definition` "LspConfigurationProblem".
|
|
18323
|
+
*/
|
|
18324
|
+
/** @experimental */
|
|
18325
|
+
export interface LspConfigurationProblem {
|
|
18326
|
+
/**
|
|
18327
|
+
* Configuration file path.
|
|
18328
|
+
*/
|
|
18329
|
+
path: string;
|
|
18330
|
+
/**
|
|
18331
|
+
* Configuration read or validation failure.
|
|
18332
|
+
*/
|
|
18333
|
+
error: string;
|
|
18334
|
+
}
|
|
18335
|
+
/**
|
|
18336
|
+
* Runtime-owned configuration inventory and configuration diagnostics.
|
|
18337
|
+
*
|
|
18338
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18339
|
+
* via the `definition` "LspConfigurationSnapshot".
|
|
18340
|
+
*/
|
|
18341
|
+
/** @experimental */
|
|
18342
|
+
export interface LspConfigurationSnapshot {
|
|
18343
|
+
/**
|
|
18344
|
+
* Effective servers in merge order.
|
|
18345
|
+
*/
|
|
18346
|
+
configs: LspServerSummary[];
|
|
18347
|
+
/**
|
|
18348
|
+
* User entries, including entries disabled by project configuration.
|
|
18349
|
+
*/
|
|
18350
|
+
userServers: LspServerSummary[];
|
|
18351
|
+
/**
|
|
18352
|
+
* Effective plugin entries.
|
|
18353
|
+
*/
|
|
18354
|
+
pluginServers: LspServerSummary[];
|
|
18355
|
+
/**
|
|
18356
|
+
* Project entries, including disabled entries absent from the effective set.
|
|
18357
|
+
*/
|
|
18358
|
+
projectServers: LspServerSummary[];
|
|
18359
|
+
/**
|
|
18360
|
+
* User configuration file path.
|
|
18361
|
+
*/
|
|
18362
|
+
userConfigPath: string;
|
|
18363
|
+
/**
|
|
18364
|
+
* Nearest project configuration file path.
|
|
18365
|
+
*/
|
|
18366
|
+
projectConfigPath?: string;
|
|
18367
|
+
/**
|
|
18368
|
+
* User configuration read or validation failure.
|
|
18369
|
+
*/
|
|
18370
|
+
userConfigError?: string;
|
|
18371
|
+
/**
|
|
18372
|
+
* Project files rejected by the loader.
|
|
18373
|
+
*/
|
|
18374
|
+
projectProblems: LspConfigurationProblem[];
|
|
18375
|
+
/**
|
|
18376
|
+
* Failure to inspect project configuration.
|
|
18377
|
+
*/
|
|
18378
|
+
projectInspectionError?: string;
|
|
18379
|
+
/**
|
|
18380
|
+
* Identifiers disabled through the user toggle list.
|
|
18381
|
+
*/
|
|
18382
|
+
userDisabledServers: string[];
|
|
18383
|
+
/**
|
|
18384
|
+
* Configuration loader diagnostics.
|
|
18385
|
+
*/
|
|
18386
|
+
warnings: string[];
|
|
18387
|
+
/**
|
|
18388
|
+
* Plugin configuration diagnostics.
|
|
18389
|
+
*/
|
|
18390
|
+
pluginWarnings: string[];
|
|
18391
|
+
}
|
|
18392
|
+
/**
|
|
18393
|
+
* One language server in the runtime's configuration inventory.
|
|
18394
|
+
*
|
|
18395
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18396
|
+
* via the `definition` "LspServerSummary".
|
|
18397
|
+
*/
|
|
18398
|
+
/** @experimental */
|
|
18399
|
+
export interface LspServerSummary {
|
|
18400
|
+
/**
|
|
18401
|
+
* Configured server identifier.
|
|
18402
|
+
*/
|
|
18403
|
+
id: string;
|
|
18404
|
+
/**
|
|
18405
|
+
* File suffixes handled by the server.
|
|
18406
|
+
*/
|
|
18407
|
+
fileExtensions: {
|
|
18408
|
+
[k: string]: string | undefined;
|
|
18409
|
+
};
|
|
18410
|
+
/**
|
|
18411
|
+
* Project root relative to the repository root.
|
|
18412
|
+
*/
|
|
18413
|
+
rootUri?: string;
|
|
18414
|
+
/**
|
|
18415
|
+
* Request deadline in milliseconds.
|
|
18416
|
+
*/
|
|
18417
|
+
requestTimeoutMs?: number;
|
|
18418
|
+
/**
|
|
18419
|
+
* Protocol initialization deadline in milliseconds.
|
|
18420
|
+
*/
|
|
18421
|
+
initializationTimeoutMs?: number;
|
|
18422
|
+
/**
|
|
18423
|
+
* Process startup deadline in milliseconds.
|
|
18424
|
+
*/
|
|
18425
|
+
spawnTimeoutMs?: number;
|
|
18426
|
+
/**
|
|
18427
|
+
* Warmup deadline in milliseconds.
|
|
18428
|
+
*/
|
|
18429
|
+
warmupTimeoutMs?: number;
|
|
18430
|
+
/**
|
|
18431
|
+
* Plugin that supplies the server, when applicable.
|
|
18432
|
+
*/
|
|
18433
|
+
sourcePlugin?: string;
|
|
18434
|
+
/**
|
|
18435
|
+
* Whether the effective configuration disables this entry.
|
|
18436
|
+
*/
|
|
18437
|
+
disabled: boolean;
|
|
18438
|
+
/**
|
|
18439
|
+
* Platform-selected launch script for a user entry.
|
|
18440
|
+
*/
|
|
18441
|
+
launchDescription?: string;
|
|
18442
|
+
}
|
|
18443
|
+
/**
|
|
18444
|
+
* Parameters for a process-wide, read-only language-server inventory.
|
|
18445
|
+
*
|
|
18446
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18447
|
+
* via the `definition` "LspGlobalConfigurationRequest".
|
|
18448
|
+
*/
|
|
18449
|
+
/** @experimental */
|
|
18450
|
+
export interface LspGlobalConfigurationRequest {
|
|
18451
|
+
/**
|
|
18452
|
+
* Absolute working directory used for project and plugin discovery.
|
|
18453
|
+
*/
|
|
18454
|
+
workingDirectory: string;
|
|
18455
|
+
}
|
|
17808
18456
|
/**
|
|
17809
18457
|
* Parameters for (re)loading the merged LSP configuration set.
|
|
17810
18458
|
*
|
|
@@ -17826,6 +18474,124 @@ export interface LspInitializeRequest {
|
|
|
17826
18474
|
*/
|
|
17827
18475
|
force?: boolean;
|
|
17828
18476
|
}
|
|
18477
|
+
/**
|
|
18478
|
+
* Process exit information from a startup probe.
|
|
18479
|
+
*
|
|
18480
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18481
|
+
* via the `definition` "LspProbeExitStatus".
|
|
18482
|
+
*/
|
|
18483
|
+
/** @experimental */
|
|
18484
|
+
export interface LspProbeExitStatus {
|
|
18485
|
+
/**
|
|
18486
|
+
* Exit code, or null when the process ended through a signal.
|
|
18487
|
+
*/
|
|
18488
|
+
code: number | null;
|
|
18489
|
+
/**
|
|
18490
|
+
* Termination signal, or null for a normal exit.
|
|
18491
|
+
*/
|
|
18492
|
+
signal: string | null;
|
|
18493
|
+
/**
|
|
18494
|
+
* Failure to observe the child process.
|
|
18495
|
+
*/
|
|
18496
|
+
error?: string;
|
|
18497
|
+
}
|
|
18498
|
+
/**
|
|
18499
|
+
* A server selected for a startup probe.
|
|
18500
|
+
*
|
|
18501
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18502
|
+
* via the `definition` "LspProbeRequest".
|
|
18503
|
+
*/
|
|
18504
|
+
/** @experimental */
|
|
18505
|
+
export interface LspProbeRequest {
|
|
18506
|
+
/**
|
|
18507
|
+
* Configured server identifier.
|
|
18508
|
+
*/
|
|
18509
|
+
serverId: string;
|
|
18510
|
+
}
|
|
18511
|
+
/**
|
|
18512
|
+
* Result of a language-server startup probe.
|
|
18513
|
+
*
|
|
18514
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18515
|
+
* via the `definition` "LspProbeResult".
|
|
18516
|
+
*/
|
|
18517
|
+
/** @experimental */
|
|
18518
|
+
export interface LspProbeResult {
|
|
18519
|
+
/**
|
|
18520
|
+
* Runtime selection outcome: started, disabled, missing, or unavailable.
|
|
18521
|
+
*/
|
|
18522
|
+
status: string;
|
|
18523
|
+
/**
|
|
18524
|
+
* Effective server identifiers, used when the requested server is absent.
|
|
18525
|
+
*/
|
|
18526
|
+
availableServers: string[];
|
|
18527
|
+
/**
|
|
18528
|
+
* Child process identifier, or null when no process identifier exists.
|
|
18529
|
+
*/
|
|
18530
|
+
pid: number | null;
|
|
18531
|
+
/**
|
|
18532
|
+
* Time spent on process startup, in milliseconds.
|
|
18533
|
+
*/
|
|
18534
|
+
spawnTimeMs: number;
|
|
18535
|
+
/**
|
|
18536
|
+
* Child exit observed during the startup window.
|
|
18537
|
+
*/
|
|
18538
|
+
immediateExit?: LspProbeExitStatus;
|
|
18539
|
+
/**
|
|
18540
|
+
* Whether the runtime confined the probe in the session sandbox.
|
|
18541
|
+
*/
|
|
18542
|
+
sandboxed: boolean;
|
|
18543
|
+
}
|
|
18544
|
+
/**
|
|
18545
|
+
* A persistent user-level server toggle.
|
|
18546
|
+
*
|
|
18547
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18548
|
+
* via the `definition` "LspSetEnabledRequest".
|
|
18549
|
+
*/
|
|
18550
|
+
/** @experimental */
|
|
18551
|
+
export interface LspSetEnabledRequest {
|
|
18552
|
+
/**
|
|
18553
|
+
* Configured server identifier.
|
|
18554
|
+
*/
|
|
18555
|
+
serverId: string;
|
|
18556
|
+
/**
|
|
18557
|
+
* True to remove the user-level disable override.
|
|
18558
|
+
*/
|
|
18559
|
+
enabled: boolean;
|
|
18560
|
+
}
|
|
18561
|
+
/**
|
|
18562
|
+
* A server whose warmup failed.
|
|
18563
|
+
*
|
|
18564
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18565
|
+
* via the `definition` "LspWarmupError".
|
|
18566
|
+
*/
|
|
18567
|
+
/** @experimental */
|
|
18568
|
+
export interface LspWarmupError {
|
|
18569
|
+
/**
|
|
18570
|
+
* Configured server identifier.
|
|
18571
|
+
*/
|
|
18572
|
+
serverId: string;
|
|
18573
|
+
/**
|
|
18574
|
+
* Server startup failure.
|
|
18575
|
+
*/
|
|
18576
|
+
error: string;
|
|
18577
|
+
}
|
|
18578
|
+
/**
|
|
18579
|
+
* The servers retained by the session after warmup.
|
|
18580
|
+
*
|
|
18581
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
18582
|
+
* via the `definition` "LspWarmupResult".
|
|
18583
|
+
*/
|
|
18584
|
+
/** @experimental */
|
|
18585
|
+
export interface LspWarmupResult {
|
|
18586
|
+
/**
|
|
18587
|
+
* Successfully acquired server identifiers.
|
|
18588
|
+
*/
|
|
18589
|
+
servers: string[];
|
|
18590
|
+
/**
|
|
18591
|
+
* Individual server startup failures.
|
|
18592
|
+
*/
|
|
18593
|
+
errors: LspWarmupError[];
|
|
18594
|
+
}
|
|
17829
18595
|
/**
|
|
17830
18596
|
* Organization-specific information that clients surface to end users. Informational only; the runtime does not enforce it.
|
|
17831
18597
|
*
|
|
@@ -18338,6 +19104,10 @@ export interface MarketplacePluginInfo {
|
|
|
18338
19104
|
* Short description from the marketplace catalog, when present
|
|
18339
19105
|
*/
|
|
18340
19106
|
description?: string;
|
|
19107
|
+
/**
|
|
19108
|
+
* Soft assignment from effective managed settings for this marketplace entry.
|
|
19109
|
+
*/
|
|
19110
|
+
assignment?: ManagedPluginAssignment;
|
|
18341
19111
|
}
|
|
18342
19112
|
/**
|
|
18343
19113
|
* Registered marketplace summary.
|
|
@@ -21042,6 +21812,35 @@ export interface MemoryConfiguration {
|
|
|
21042
21812
|
*/
|
|
21043
21813
|
mode?: MemoryMode;
|
|
21044
21814
|
}
|
|
21815
|
+
/**
|
|
21816
|
+
* A memory the agent stored after validation, secret filtering and approval.
|
|
21817
|
+
*
|
|
21818
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
21819
|
+
* via the `definition` "MemoryStoreRequest".
|
|
21820
|
+
*/
|
|
21821
|
+
/** @experimental */
|
|
21822
|
+
export interface MemoryStoreRequest {
|
|
21823
|
+
/**
|
|
21824
|
+
* Target session identifier
|
|
21825
|
+
*/
|
|
21826
|
+
sessionId: string;
|
|
21827
|
+
/**
|
|
21828
|
+
* Short topic the memory is about.
|
|
21829
|
+
*/
|
|
21830
|
+
subject: string;
|
|
21831
|
+
/**
|
|
21832
|
+
* The fact to remember.
|
|
21833
|
+
*/
|
|
21834
|
+
fact: string;
|
|
21835
|
+
/**
|
|
21836
|
+
* Sources supporting the fact, such as file paths with line numbers or a quotation of the user.
|
|
21837
|
+
*/
|
|
21838
|
+
citations: string;
|
|
21839
|
+
/**
|
|
21840
|
+
* Why the agent considers the fact worth remembering.
|
|
21841
|
+
*/
|
|
21842
|
+
reason: string;
|
|
21843
|
+
}
|
|
21045
21844
|
/**
|
|
21046
21845
|
* Per-source attribution breakdown for the session's current context window, or null if uninitialized.
|
|
21047
21846
|
*
|
|
@@ -21828,6 +22627,14 @@ export interface ModelList {
|
|
|
21828
22627
|
* The runtime's default image model, separate from conversation models, with its availability for the resolved account. The default is reported even when unavailable; clients choose whether to display it. These entries must not be selected as chat models. Absent on runtimes that do not expose this catalog.
|
|
21829
22628
|
*/
|
|
21830
22629
|
imageModels?: ImageToolModel[];
|
|
22630
|
+
/**
|
|
22631
|
+
* Decision models the resolved account can call with `decisions.ask`, separate from conversation models, with each model's effective limits. Absent when the `DECISIONS_API` feature flag is off or the runtime does not expose this catalog; empty when the account has none. These entries must not be selected as chat models.
|
|
22632
|
+
*
|
|
22633
|
+
* @experimental
|
|
22634
|
+
*
|
|
22635
|
+
* @experimental
|
|
22636
|
+
*/
|
|
22637
|
+
decisionModels?: DecisionModelInfo[];
|
|
21831
22638
|
}
|
|
21832
22639
|
/** @experimental */
|
|
21833
22640
|
export interface ModelPickerPersistenceRequest {
|
|
@@ -22440,7 +23247,7 @@ export interface ModelSetReasoningEffortRequest {
|
|
|
22440
23247
|
reasoningEffort: string;
|
|
22441
23248
|
}
|
|
22442
23249
|
/**
|
|
22443
|
-
* Update the session's reasoning effort without changing the selected model. Use `switchTo` instead when you also need to change the model. The runtime
|
|
23250
|
+
* Update the session's reasoning effort without changing the selected model. Use `switchTo` instead when you also need to change the model. The runtime applies the effort to the next new model request, including tool continuations, without changing retries of an already-started request.
|
|
22444
23251
|
*
|
|
22445
23252
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
22446
23253
|
* via the `definition` "ModelSetReasoningEffortResult".
|
|
@@ -22467,6 +23274,48 @@ export interface ModelsListRequest {
|
|
|
22467
23274
|
*/
|
|
22468
23275
|
streamerMode?: boolean;
|
|
22469
23276
|
}
|
|
23277
|
+
/**
|
|
23278
|
+
* Options for a host's startup model admission check.
|
|
23279
|
+
*
|
|
23280
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23281
|
+
* via the `definition` "ModelStartupAdmissionRequest".
|
|
23282
|
+
*/
|
|
23283
|
+
/** @experimental */
|
|
23284
|
+
export interface ModelStartupAdmissionRequest {
|
|
23285
|
+
/**
|
|
23286
|
+
* Claims the session's one-time enablement prompt only when its catalog is ready.
|
|
23287
|
+
*/
|
|
23288
|
+
claimEnablement?: boolean;
|
|
23289
|
+
}
|
|
23290
|
+
/**
|
|
23291
|
+
* A cached startup model snapshot and an optional one-time enablement prompt. This check never resolves credentials or fetches a catalog.
|
|
23292
|
+
*
|
|
23293
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23294
|
+
* via the `definition` "ModelStartupAdmissionResult".
|
|
23295
|
+
*/
|
|
23296
|
+
/** @experimental */
|
|
23297
|
+
export interface ModelStartupAdmissionResult {
|
|
23298
|
+
/**
|
|
23299
|
+
* The selected model, when the session has one.
|
|
23300
|
+
*/
|
|
23301
|
+
selectedModel?: string;
|
|
23302
|
+
/**
|
|
23303
|
+
* Whether the session already has a resolved Copilot catalog.
|
|
23304
|
+
*/
|
|
23305
|
+
catalogReady: boolean;
|
|
23306
|
+
/**
|
|
23307
|
+
* Whether the cached selected model currently requires enablement.
|
|
23308
|
+
*/
|
|
23309
|
+
requiresEnablement: boolean;
|
|
23310
|
+
/**
|
|
23311
|
+
* Whether this call consumed the session's startup enablement claim.
|
|
23312
|
+
*/
|
|
23313
|
+
claimedEnablement: boolean;
|
|
23314
|
+
/**
|
|
23315
|
+
* The selected model to enable, only for the first successful prompt claim.
|
|
23316
|
+
*/
|
|
23317
|
+
modelToEnable?: string;
|
|
23318
|
+
}
|
|
22470
23319
|
/**
|
|
22471
23320
|
* An Auto preference request for the session. This updates Auto configuration only; it does not change the selected model to `auto`.
|
|
22472
23321
|
*
|
|
@@ -22855,6 +23704,97 @@ export interface NameSetRequest {
|
|
|
22855
23704
|
*/
|
|
22856
23705
|
name: string;
|
|
22857
23706
|
}
|
|
23707
|
+
/**
|
|
23708
|
+
* Registers the Negotiate authentication callback, which then supplies the Kerberos tokens instead of native credential lookup.
|
|
23709
|
+
*
|
|
23710
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23711
|
+
* via the `definition` "NetworkAuthenticateNegotiateOptions".
|
|
23712
|
+
*/
|
|
23713
|
+
/** @experimental */
|
|
23714
|
+
export interface NetworkAuthenticateNegotiateOptions {
|
|
23715
|
+
}
|
|
23716
|
+
/**
|
|
23717
|
+
* Requests a fresh initial SPNEGO token for a Kerberos service principal.
|
|
23718
|
+
*
|
|
23719
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23720
|
+
* via the `definition` "NetworkAuthenticateNegotiateRequest".
|
|
23721
|
+
*/
|
|
23722
|
+
/** @experimental */
|
|
23723
|
+
export interface NetworkAuthenticateNegotiateRequest {
|
|
23724
|
+
/**
|
|
23725
|
+
* Service principal in the platform-independent `service/host` form, optionally followed by `@REALM`.
|
|
23726
|
+
*/
|
|
23727
|
+
spn: string;
|
|
23728
|
+
}
|
|
23729
|
+
/**
|
|
23730
|
+
* Client credentials for a single Negotiate authentication exchange.
|
|
23731
|
+
*
|
|
23732
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23733
|
+
* via the `definition` "NetworkAuthenticateNegotiateResult".
|
|
23734
|
+
*/
|
|
23735
|
+
/** @experimental */
|
|
23736
|
+
export interface NetworkAuthenticateNegotiateResult {
|
|
23737
|
+
/**
|
|
23738
|
+
* Base64 initial SPNEGO token without the Negotiate prefix; omitted when unavailable. Never log or persist it.
|
|
23739
|
+
*/
|
|
23740
|
+
token?: string;
|
|
23741
|
+
}
|
|
23742
|
+
/**
|
|
23743
|
+
* Registers the proxy resolution callback, which then decides the proxies for every request the runtime would otherwise route by ambient proxy settings, or leaves a request to that routing.
|
|
23744
|
+
*
|
|
23745
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23746
|
+
* via the `definition` "NetworkResolveProxyOptions".
|
|
23747
|
+
*/
|
|
23748
|
+
/** @experimental */
|
|
23749
|
+
export interface NetworkResolveProxyOptions {
|
|
23750
|
+
}
|
|
23751
|
+
/**
|
|
23752
|
+
* Requests the proxies for a request target.
|
|
23753
|
+
*
|
|
23754
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23755
|
+
* via the `definition` "NetworkResolveProxyRequest".
|
|
23756
|
+
*/
|
|
23757
|
+
/** @experimental */
|
|
23758
|
+
export interface NetworkResolveProxyRequest {
|
|
23759
|
+
/**
|
|
23760
|
+
* Request target as a PAC script sees it: without credentials or fragment, and for `https` and `wss` also without path and query.
|
|
23761
|
+
*/
|
|
23762
|
+
url: string;
|
|
23763
|
+
}
|
|
23764
|
+
/**
|
|
23765
|
+
* Proxies for a request target, in the order to try them.
|
|
23766
|
+
*
|
|
23767
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23768
|
+
* via the `definition` "NetworkResolveProxyResult".
|
|
23769
|
+
*/
|
|
23770
|
+
/** @experimental */
|
|
23771
|
+
export interface NetworkResolveProxyResult {
|
|
23772
|
+
/**
|
|
23773
|
+
* PAC-style proxy list such as `PROXY proxy.example:8080; HTTPS proxy.example:443; DIRECT`, as returned by a PAC script or Electron's `session.resolveProxy`; `DIRECT` connects directly. Omitted, null or empty leaves the request to the runtime's own proxy resolution, as if no callback were registered: proxy environment variables, `NO_PROXY`, then the operating system's proxy settings and PAC. Entry types the runtime doesn't support, such as SOCKS and QUIC, are skipped.
|
|
23774
|
+
*/
|
|
23775
|
+
proxy?: string;
|
|
23776
|
+
}
|
|
23777
|
+
/**
|
|
23778
|
+
* Registers the calling SDK connection's network callbacks, replacing any previous registration.
|
|
23779
|
+
*
|
|
23780
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
23781
|
+
* via the `definition` "NetworkSetProviderRequest".
|
|
23782
|
+
*/
|
|
23783
|
+
/** @experimental */
|
|
23784
|
+
export interface NetworkSetProviderRequest {
|
|
23785
|
+
/**
|
|
23786
|
+
* Traffic the callbacks serve; defaults to `connection`.
|
|
23787
|
+
*/
|
|
23788
|
+
scope?: NetworkScope;
|
|
23789
|
+
/**
|
|
23790
|
+
* Present when the client answers `network.resolveProxy`.
|
|
23791
|
+
*/
|
|
23792
|
+
resolveProxy?: NetworkResolveProxyOptions;
|
|
23793
|
+
/**
|
|
23794
|
+
* Present when the client answers `network.authenticateNegotiate`.
|
|
23795
|
+
*/
|
|
23796
|
+
authenticateNegotiate?: NetworkAuthenticateNegotiateOptions;
|
|
23797
|
+
}
|
|
22858
23798
|
/**
|
|
22859
23799
|
* Content-exclusion policy supplied to `session.options.update`, with rules, last-updated data, and scope.
|
|
22860
23800
|
*
|
|
@@ -24854,6 +25794,10 @@ export interface PlanUpdateRequest {
|
|
|
24854
25794
|
*/
|
|
24855
25795
|
/** @experimental */
|
|
24856
25796
|
export interface Plugin {
|
|
25797
|
+
/**
|
|
25798
|
+
* Soft assignment from effective managed settings. This does not mark the plugin as hard-managed.
|
|
25799
|
+
*/
|
|
25800
|
+
assignment?: ManagedPluginAssignment;
|
|
24857
25801
|
/**
|
|
24858
25802
|
* Plugin name
|
|
24859
25803
|
*/
|
|
@@ -27266,6 +28210,10 @@ export interface SandboxConfigUserPolicyFilesystem {
|
|
|
27266
28210
|
* Paths explicitly denied.
|
|
27267
28211
|
*/
|
|
27268
28212
|
deniedPaths?: string[];
|
|
28213
|
+
/**
|
|
28214
|
+
* Paths granted enumerate-only access: sandboxed commands can list these directories without reading the files in them. Honored only on Windows hosts with the `filesystem_enumeration` capability; ignored elsewhere. An entry at or under a read-only, read-write, or denied path is ignored, so it never narrows a grant or reopens a denial.
|
|
28215
|
+
*/
|
|
28216
|
+
enumeratePaths?: string[];
|
|
27269
28217
|
}
|
|
27270
28218
|
/**
|
|
27271
28219
|
* Network rules to merge into the base policy.
|
|
@@ -27538,7 +28486,7 @@ export interface SandboxGrantPathForRequestResult {
|
|
|
27538
28486
|
/** @experimental */
|
|
27539
28487
|
export interface SandboxHostCapability {
|
|
27540
28488
|
/**
|
|
27541
|
-
* The policy feature, as an extensible string: ignore names you do not recognize. Known values: `network` (sandboxed commands can reach the network; on Linux this needs the tooling for Bubblewrap's private network namespace, such as slirp4netns), `network_filtering` (host rules and the sandbox proxy; on Linux this needs the same tooling as `network`; on Windows it needs Process Security Environment 1.1 host-loopback support or MXC's PSEC 1.0-only proxy-loopback compatibility capability, and a policy that uses it must also set `network.allowLocalNetwork`; compatibility applies only to an explicit identity-less runtime proxy, not general host-loopback access, and other policy restrictions still apply), `denied_paths` (native enforcement of `filesystem.deniedPaths`), `shell` (shell commands inside the sandbox), and `filesystem_enumeration` (enumerate-only filesystem grants
|
|
28489
|
+
* The policy feature, as an extensible string: ignore names you do not recognize. Known values: `network` (sandboxed commands can reach the network; on Linux this needs the tooling for Bubblewrap's private network namespace, such as slirp4netns), `network_filtering` (host rules and the sandbox proxy; on Linux this needs the same tooling as `network`; on Windows it needs Process Security Environment 1.1 host-loopback support or MXC's PSEC 1.0-only proxy-loopback compatibility capability, and a policy that uses it must also set `network.allowLocalNetwork`; compatibility applies only to an explicit identity-less runtime proxy, not general host-loopback access, and other policy restrictions still apply), `denied_paths` (native enforcement of `filesystem.deniedPaths`), `shell` (shell commands inside the sandbox), and `filesystem_enumeration` (enumerate-only filesystem grants: PowerShell's drive roots and `filesystem.enumeratePaths`; on Windows this needs Process Security Environment 1.1 filesystem enumeration support, and without it sandboxed PowerShell still runs but cannot resolve its current location, and `filesystem.enumeratePaths` entries are ignored; other platforms always report it).
|
|
27542
28490
|
*/
|
|
27543
28491
|
name: SandboxHostCapabilityName;
|
|
27544
28492
|
/**
|
|
@@ -28053,6 +29001,10 @@ export interface SendMessagesRequest {
|
|
|
28053
29001
|
* W3C Trace Context tracestate header for distributed tracing
|
|
28054
29002
|
*/
|
|
28055
29003
|
tracestate?: string;
|
|
29004
|
+
/**
|
|
29005
|
+
* Opaque caller-chosen ID for the turn this batch starts. The runtime copies it unchanged into `params._meta["com.github.copilot/turnId"]` on every MCP `tools/call` the agent makes while serving that turn, including calls from sub-agents it spawns and from Autopilot continuations of it. Visible user steering (`mode: "immediate"`) that a running turn consumes hands it to a successor turn: the steering's value replaces the running turn's from the next model call onward, and steering without one clears it. System and hidden steering leave it unchanged. A turn started without one, including one the runtime starts itself, carries no turn ID. The `user.message` event for each message the send delivers echoes it as `clientTurnId` when the message is consumed, and is persisted like other events; the value stamped on MCP calls is held in memory only and is not restored on resume.
|
|
29006
|
+
*/
|
|
29007
|
+
clientTurnId?: string;
|
|
28056
29008
|
/**
|
|
28057
29009
|
* If true, await completion of the agentic loop for this turn before returning. Defaults to false (fire-and-forget). When true, the result still contains the same `messageIds`; the caller can rely on the agent having processed the messages before the call resolves. Transport-dependent tail semantics: on a LOCAL (in-process) session the wait additionally blocks until the completed turn's event tail has been dispatched to this session's in-process subscribers, so a subsequent read of subscriber state already reflects the turn; on a REMOTE session the wait resolves once the loop completes and mirrored delivery follows over the wire. Callers that need the stronger local guarantee on remote sessions should await the event stream explicitly.
|
|
28058
29010
|
*/
|
|
@@ -28129,6 +29081,10 @@ export interface SendRequest {
|
|
|
28129
29081
|
* W3C Trace Context tracestate header for distributed tracing
|
|
28130
29082
|
*/
|
|
28131
29083
|
tracestate?: string;
|
|
29084
|
+
/**
|
|
29085
|
+
* Opaque caller-chosen ID for the turn this message starts. The runtime copies it unchanged into `params._meta["com.github.copilot/turnId"]` on every MCP `tools/call` the agent makes while serving that turn, including calls from sub-agents it spawns and from Autopilot continuations of it. Visible user steering (`mode: "immediate"`) that a running turn consumes hands it to a successor turn: the steering's value replaces the running turn's from the next model call onward, and steering without one clears it. System and hidden steering leave it unchanged. A turn started without one, including one the runtime starts itself, carries no turn ID. The `user.message` event for each message the send delivers echoes it as `clientTurnId` when the message is consumed, and is persisted like other events; the value stamped on MCP calls is held in memory only and is not restored on resume.
|
|
29086
|
+
*/
|
|
29087
|
+
clientTurnId?: string;
|
|
28132
29088
|
/**
|
|
28133
29089
|
* If true, await completion of the agentic loop for this message before returning. Defaults to false (fire-and-forget). When true, the result still contains the same `messageId`; the caller can rely on the agent having processed the message before the call resolves. Transport-dependent tail semantics: on a LOCAL (in-process) session the wait additionally blocks until the completed turn's event tail has been dispatched to this session's in-process subscribers, so a subsequent read of subscriber state already reflects the turn; on a REMOTE session the wait resolves once the loop completes and mirrored delivery follows over the wire. Callers that need the stronger local guarantee on remote sessions should await the event stream explicitly.
|
|
28134
29090
|
*/
|
|
@@ -30054,6 +31010,10 @@ export interface SessionOpenOptions {
|
|
|
30054
31010
|
* @experimental
|
|
30055
31011
|
*/
|
|
30056
31012
|
enableCitations?: boolean;
|
|
31013
|
+
/**
|
|
31014
|
+
* Whether the model may request multiple tool calls per response. Defaults to true. False sends a provider hint, not an execution guarantee: all returned calls are still handled and handlers may run concurrently. Re-supply on cold resume.
|
|
31015
|
+
*/
|
|
31016
|
+
allowMultipleToolCalls?: boolean;
|
|
30057
31017
|
/**
|
|
30058
31018
|
* Override URL for the Copilot API endpoint.
|
|
30059
31019
|
*/
|
|
@@ -30506,6 +31466,50 @@ export interface SessionsOpenProgress {
|
|
|
30506
31466
|
*/
|
|
30507
31467
|
message?: string;
|
|
30508
31468
|
}
|
|
31469
|
+
/**
|
|
31470
|
+
* Soft plugin defaults for this session, without persistent user preferences or hard policy.
|
|
31471
|
+
*
|
|
31472
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
31473
|
+
* via the `definition` "SessionPluginDefaults".
|
|
31474
|
+
*/
|
|
31475
|
+
/** @experimental */
|
|
31476
|
+
export interface SessionPluginDefaults {
|
|
31477
|
+
/**
|
|
31478
|
+
* Opaque revision of the defaults, assignment reasons, and Team marketplaces.
|
|
31479
|
+
*/
|
|
31480
|
+
generation: string;
|
|
31481
|
+
/**
|
|
31482
|
+
* Plugin specs mapped to soft enablement defaults. Managed defaultEnabled assignments override Team defaults for the same spec.
|
|
31483
|
+
*/
|
|
31484
|
+
defaultEnabledPlugins: {
|
|
31485
|
+
[k: string]: boolean | undefined;
|
|
31486
|
+
};
|
|
31487
|
+
/**
|
|
31488
|
+
* Team-only defaults for hosts that retain activation inputs. Managed assignments are read live by the runtime resolver and must not be retained as Team defaults.
|
|
31489
|
+
*/
|
|
31490
|
+
teamDefaultEnabledPlugins: {
|
|
31491
|
+
[k: string]: boolean | undefined;
|
|
31492
|
+
};
|
|
31493
|
+
/**
|
|
31494
|
+
* Team marketplace definitions available only as best-effort installation fallbacks.
|
|
31495
|
+
*/
|
|
31496
|
+
extraKnownMarketplaces: {
|
|
31497
|
+
[k: string]: TeamPluginMarketplace | undefined;
|
|
31498
|
+
};
|
|
31499
|
+
}
|
|
31500
|
+
/**
|
|
31501
|
+
* A Team marketplace fallback. Explicit marketplace configuration takes precedence.
|
|
31502
|
+
*
|
|
31503
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
31504
|
+
* via the `definition` "TeamPluginMarketplace".
|
|
31505
|
+
*/
|
|
31506
|
+
/** @experimental */
|
|
31507
|
+
export interface TeamPluginMarketplace {
|
|
31508
|
+
/**
|
|
31509
|
+
* Validated GitHub repository source for the marketplace.
|
|
31510
|
+
*/
|
|
31511
|
+
source: TeamPluginMarketplaceSource;
|
|
31512
|
+
}
|
|
30509
31513
|
/**
|
|
30510
31514
|
* Plugin names (or specs) to disable in the session's authoritative working directory.
|
|
30511
31515
|
*
|
|
@@ -31233,6 +32237,10 @@ export interface SessionsFindByPrefixRequest {
|
|
|
31233
32237
|
* UUID prefix (>=7 hex chars, <36 chars). Returns the unique session ID, or undefined when there is no match or the prefix matches multiple sessions.
|
|
31234
32238
|
*/
|
|
31235
32239
|
prefix: string;
|
|
32240
|
+
/**
|
|
32241
|
+
* Configuration directory containing the session state. Omitted to use the server's configured home.
|
|
32242
|
+
*/
|
|
32243
|
+
configDir?: string;
|
|
31236
32244
|
}
|
|
31237
32245
|
/**
|
|
31238
32246
|
* Session ID matching the prefix, omitted when no unique match exists.
|
|
@@ -34853,7 +35861,7 @@ export interface UIUserInputResponse {
|
|
|
34853
35861
|
wasFreeform: boolean;
|
|
34854
35862
|
}
|
|
34855
35863
|
/**
|
|
34856
|
-
*
|
|
35864
|
+
* Registers an in-process Auto-switch responder and suppresses server-bridge dispatch to avoid competing responders for the same requestId. When requested, also enrolls the responder for active-request Auto recovery and acknowledges support. Attach the actual listener separately through standard event subscriptions before starting a turn, and release the handle when the responder is removed.
|
|
34857
35865
|
*
|
|
34858
35866
|
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
34859
35867
|
* via the `definition` "UIRegisterDirectAutoModeSwitchHandlerResult".
|
|
@@ -34864,6 +35872,10 @@ export interface UIRegisterDirectAutoModeSwitchHandlerResult {
|
|
|
34864
35872
|
* Opaque handle representing the registration. Pass this same handle to `unregisterDirectAutoModeSwitchHandler` when the in-process handler is no longer active. Multiple registrations are reference-counted; the server bridge will only dispatch auto-mode-switch requests when no handles are active.
|
|
34865
35873
|
*/
|
|
34866
35874
|
handle: string;
|
|
35875
|
+
/**
|
|
35876
|
+
* Positive acknowledgment of recovery-aware enrollment. Absence on an older runtime means recovery is unsupported.
|
|
35877
|
+
*/
|
|
35878
|
+
autoModeRecovery?: boolean;
|
|
34867
35879
|
}
|
|
34868
35880
|
/**
|
|
34869
35881
|
* Identifies one runtime-owned native action for an in-process SDK UI dispatcher.
|
|
@@ -35433,6 +36445,35 @@ export interface UserSettingsWriteAllRequest {
|
|
|
35433
36445
|
*/
|
|
35434
36446
|
settings: JsonValue;
|
|
35435
36447
|
}
|
|
36448
|
+
/**
|
|
36449
|
+
* A raw top-level setting edit with explicit read-failure behavior.
|
|
36450
|
+
*
|
|
36451
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
36452
|
+
* via the `definition` "UserSettingsWriteKeyRequest".
|
|
36453
|
+
*/
|
|
36454
|
+
/** @experimental */
|
|
36455
|
+
export interface UserSettingsWriteKeyRequest {
|
|
36456
|
+
/**
|
|
36457
|
+
* The top-level setting to write without canonicalizing legacy siblings.
|
|
36458
|
+
*/
|
|
36459
|
+
key: string;
|
|
36460
|
+
/**
|
|
36461
|
+
* Optional host paths and environment. Omit to use the server's settings home.
|
|
36462
|
+
*/
|
|
36463
|
+
context?: UserSettingsHostContext;
|
|
36464
|
+
/**
|
|
36465
|
+
* The value to store. Explicit null is retained. Pass null when deleting.
|
|
36466
|
+
*/
|
|
36467
|
+
value: JsonValue | null;
|
|
36468
|
+
/**
|
|
36469
|
+
* Remove the key instead of writing it. Defaults to false.
|
|
36470
|
+
*/
|
|
36471
|
+
delete?: boolean;
|
|
36472
|
+
/**
|
|
36473
|
+
* Refuse to replace an unreadable or invalid file. Defaults to false.
|
|
36474
|
+
*/
|
|
36475
|
+
refuseOnReadFailure?: boolean;
|
|
36476
|
+
}
|
|
35436
36477
|
/**
|
|
35437
36478
|
* Current sharing status and shareable GitHub URL for a session.
|
|
35438
36479
|
*
|
|
@@ -37638,24 +38679,82 @@ export interface AgentRegistryRemoveEntryRequest {
|
|
|
37638
38679
|
*/
|
|
37639
38680
|
pid: number;
|
|
37640
38681
|
}
|
|
38682
|
+
/**
|
|
38683
|
+
* Runtime-owned configuration inventory and configuration diagnostics.
|
|
38684
|
+
*
|
|
38685
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
38686
|
+
* via the `definition` "LspListResult".
|
|
38687
|
+
*/
|
|
37641
38688
|
/** @experimental */
|
|
37642
|
-
export interface
|
|
38689
|
+
export interface LspListResult {
|
|
37643
38690
|
/**
|
|
37644
|
-
*
|
|
38691
|
+
* Effective servers in merge order.
|
|
37645
38692
|
*/
|
|
37646
|
-
|
|
38693
|
+
configs: LspServerSummary[];
|
|
38694
|
+
/**
|
|
38695
|
+
* User entries, including entries disabled by project configuration.
|
|
38696
|
+
*/
|
|
38697
|
+
userServers: LspServerSummary[];
|
|
38698
|
+
/**
|
|
38699
|
+
* Effective plugin entries.
|
|
38700
|
+
*/
|
|
38701
|
+
pluginServers: LspServerSummary[];
|
|
38702
|
+
/**
|
|
38703
|
+
* Project entries, including disabled entries absent from the effective set.
|
|
38704
|
+
*/
|
|
38705
|
+
projectServers: LspServerSummary[];
|
|
38706
|
+
/**
|
|
38707
|
+
* User configuration file path.
|
|
38708
|
+
*/
|
|
38709
|
+
userConfigPath: string;
|
|
38710
|
+
/**
|
|
38711
|
+
* Nearest project configuration file path.
|
|
38712
|
+
*/
|
|
38713
|
+
projectConfigPath?: string;
|
|
38714
|
+
/**
|
|
38715
|
+
* User configuration read or validation failure.
|
|
38716
|
+
*/
|
|
38717
|
+
userConfigError?: string;
|
|
38718
|
+
/**
|
|
38719
|
+
* Project files rejected by the loader.
|
|
38720
|
+
*/
|
|
38721
|
+
projectProblems: LspConfigurationProblem[];
|
|
38722
|
+
/**
|
|
38723
|
+
* Failure to inspect project configuration.
|
|
38724
|
+
*/
|
|
38725
|
+
projectInspectionError?: string;
|
|
38726
|
+
/**
|
|
38727
|
+
* Identifiers disabled through the user toggle list.
|
|
38728
|
+
*/
|
|
38729
|
+
userDisabledServers: string[];
|
|
38730
|
+
/**
|
|
38731
|
+
* Configuration loader diagnostics.
|
|
38732
|
+
*/
|
|
38733
|
+
warnings: string[];
|
|
38734
|
+
/**
|
|
38735
|
+
* Plugin configuration diagnostics.
|
|
38736
|
+
*/
|
|
38737
|
+
pluginWarnings: string[];
|
|
37647
38738
|
}
|
|
38739
|
+
/**
|
|
38740
|
+
* Parameters for a process-wide, read-only language-server inventory.
|
|
38741
|
+
*
|
|
38742
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
38743
|
+
* via the `definition` "LspListRequest".
|
|
38744
|
+
*/
|
|
37648
38745
|
/** @experimental */
|
|
37649
|
-
export interface
|
|
37650
|
-
|
|
38746
|
+
export interface LspListRequest {
|
|
38747
|
+
/**
|
|
38748
|
+
* Absolute working directory used for project and plugin discovery.
|
|
38749
|
+
*/
|
|
38750
|
+
workingDirectory: string;
|
|
37651
38751
|
}
|
|
37652
38752
|
/** @experimental */
|
|
37653
|
-
export interface
|
|
37654
|
-
expectedModel: string;
|
|
38753
|
+
export interface SessionWorkflowPauseAtCheckpointResult {
|
|
37655
38754
|
/**
|
|
37656
|
-
*
|
|
38755
|
+
* Whether this execution attempt must pause or may continue.
|
|
37657
38756
|
*/
|
|
37658
|
-
|
|
38757
|
+
action: WorkflowPauseCheckpointAction;
|
|
37659
38758
|
}
|
|
37660
38759
|
/** @experimental */
|
|
37661
38760
|
export interface SessionModelListRequest {
|
|
@@ -37798,6 +38897,143 @@ export interface SessionProviderGetEndpointRequest {
|
|
|
37798
38897
|
*/
|
|
37799
38898
|
modelId?: string;
|
|
37800
38899
|
}
|
|
38900
|
+
/**
|
|
38901
|
+
* Runtime-owned configuration inventory and configuration diagnostics.
|
|
38902
|
+
*
|
|
38903
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
38904
|
+
* via the `definition` "SessionLspListResult".
|
|
38905
|
+
*/
|
|
38906
|
+
/** @experimental */
|
|
38907
|
+
export interface SessionLspListResult {
|
|
38908
|
+
/**
|
|
38909
|
+
* Effective servers in merge order.
|
|
38910
|
+
*/
|
|
38911
|
+
configs: LspServerSummary[];
|
|
38912
|
+
/**
|
|
38913
|
+
* User entries, including entries disabled by project configuration.
|
|
38914
|
+
*/
|
|
38915
|
+
userServers: LspServerSummary[];
|
|
38916
|
+
/**
|
|
38917
|
+
* Effective plugin entries.
|
|
38918
|
+
*/
|
|
38919
|
+
pluginServers: LspServerSummary[];
|
|
38920
|
+
/**
|
|
38921
|
+
* Project entries, including disabled entries absent from the effective set.
|
|
38922
|
+
*/
|
|
38923
|
+
projectServers: LspServerSummary[];
|
|
38924
|
+
/**
|
|
38925
|
+
* User configuration file path.
|
|
38926
|
+
*/
|
|
38927
|
+
userConfigPath: string;
|
|
38928
|
+
/**
|
|
38929
|
+
* Nearest project configuration file path.
|
|
38930
|
+
*/
|
|
38931
|
+
projectConfigPath?: string;
|
|
38932
|
+
/**
|
|
38933
|
+
* User configuration read or validation failure.
|
|
38934
|
+
*/
|
|
38935
|
+
userConfigError?: string;
|
|
38936
|
+
/**
|
|
38937
|
+
* Project files rejected by the loader.
|
|
38938
|
+
*/
|
|
38939
|
+
projectProblems: LspConfigurationProblem[];
|
|
38940
|
+
/**
|
|
38941
|
+
* Failure to inspect project configuration.
|
|
38942
|
+
*/
|
|
38943
|
+
projectInspectionError?: string;
|
|
38944
|
+
/**
|
|
38945
|
+
* Identifiers disabled through the user toggle list.
|
|
38946
|
+
*/
|
|
38947
|
+
userDisabledServers: string[];
|
|
38948
|
+
/**
|
|
38949
|
+
* Configuration loader diagnostics.
|
|
38950
|
+
*/
|
|
38951
|
+
warnings: string[];
|
|
38952
|
+
/**
|
|
38953
|
+
* Plugin configuration diagnostics.
|
|
38954
|
+
*/
|
|
38955
|
+
pluginWarnings: string[];
|
|
38956
|
+
}
|
|
38957
|
+
/**
|
|
38958
|
+
* The servers retained by the session after warmup.
|
|
38959
|
+
*
|
|
38960
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
38961
|
+
* via the `definition` "SessionLspStartResult".
|
|
38962
|
+
*/
|
|
38963
|
+
/** @experimental */
|
|
38964
|
+
export interface SessionLspStartResult {
|
|
38965
|
+
/**
|
|
38966
|
+
* Successfully acquired server identifiers.
|
|
38967
|
+
*/
|
|
38968
|
+
servers: string[];
|
|
38969
|
+
/**
|
|
38970
|
+
* Individual server startup failures.
|
|
38971
|
+
*/
|
|
38972
|
+
errors: LspWarmupError[];
|
|
38973
|
+
}
|
|
38974
|
+
/**
|
|
38975
|
+
* Result of a language-server startup probe.
|
|
38976
|
+
*
|
|
38977
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
38978
|
+
* via the `definition` "SessionLspDiagnoseResult".
|
|
38979
|
+
*/
|
|
38980
|
+
/** @experimental */
|
|
38981
|
+
export interface SessionLspDiagnoseResult {
|
|
38982
|
+
/**
|
|
38983
|
+
* Runtime selection outcome: started, disabled, missing, or unavailable.
|
|
38984
|
+
*/
|
|
38985
|
+
status: string;
|
|
38986
|
+
/**
|
|
38987
|
+
* Effective server identifiers, used when the requested server is absent.
|
|
38988
|
+
*/
|
|
38989
|
+
availableServers: string[];
|
|
38990
|
+
/**
|
|
38991
|
+
* Child process identifier, or null when no process identifier exists.
|
|
38992
|
+
*/
|
|
38993
|
+
pid: number | null;
|
|
38994
|
+
/**
|
|
38995
|
+
* Time spent on process startup, in milliseconds.
|
|
38996
|
+
*/
|
|
38997
|
+
spawnTimeMs: number;
|
|
38998
|
+
/**
|
|
38999
|
+
* Child exit observed during the startup window.
|
|
39000
|
+
*/
|
|
39001
|
+
immediateExit?: LspProbeExitStatus;
|
|
39002
|
+
/**
|
|
39003
|
+
* Whether the runtime confined the probe in the session sandbox.
|
|
39004
|
+
*/
|
|
39005
|
+
sandboxed: boolean;
|
|
39006
|
+
}
|
|
39007
|
+
/**
|
|
39008
|
+
* A server selected for a startup probe.
|
|
39009
|
+
*
|
|
39010
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
39011
|
+
* via the `definition` "SessionLspDiagnoseRequest".
|
|
39012
|
+
*/
|
|
39013
|
+
/** @experimental */
|
|
39014
|
+
export interface SessionLspDiagnoseRequest {
|
|
39015
|
+
/**
|
|
39016
|
+
* Configured server identifier.
|
|
39017
|
+
*/
|
|
39018
|
+
serverId: string;
|
|
39019
|
+
}
|
|
39020
|
+
/**
|
|
39021
|
+
* A persistent user-level server toggle.
|
|
39022
|
+
*
|
|
39023
|
+
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
39024
|
+
* via the `definition` "SessionLspSetRequest".
|
|
39025
|
+
*/
|
|
39026
|
+
/** @experimental */
|
|
39027
|
+
export interface SessionLspSetRequest {
|
|
39028
|
+
/**
|
|
39029
|
+
* Configured server identifier.
|
|
39030
|
+
*/
|
|
39031
|
+
serverId: string;
|
|
39032
|
+
/**
|
|
39033
|
+
* True to remove the user-level disable override.
|
|
39034
|
+
*/
|
|
39035
|
+
enabled: boolean;
|
|
39036
|
+
}
|
|
37801
39037
|
/** @experimental */
|
|
37802
39038
|
export interface SessionCommandsListRequest {
|
|
37803
39039
|
/**
|
|
@@ -37814,6 +39050,13 @@ export interface SessionCommandsListRequest {
|
|
|
37814
39050
|
includeClientCommands?: boolean;
|
|
37815
39051
|
}
|
|
37816
39052
|
/** @experimental */
|
|
39053
|
+
export interface SessionUiRegisterDirectAutoModeSwitchHandlerRequest {
|
|
39054
|
+
/**
|
|
39055
|
+
* Opt into active-request Auto recovery before starting a turn. Attach the handler separately, show the failure reason, and return the user's choice for the originating live session. Require a positive acknowledgment in the registration result. Dismiss offers on auto_mode_recovery_consent.completed and on session resume or disconnect. Omitted or false preserves legacy rate-limit switching.
|
|
39056
|
+
*/
|
|
39057
|
+
autoModeRecovery?: boolean;
|
|
39058
|
+
}
|
|
39059
|
+
/** @experimental */
|
|
37817
39060
|
export interface SessionHistoryCompactRequest {
|
|
37818
39061
|
/**
|
|
37819
39062
|
* Optional user-provided instructions to focus the compaction summary
|
|
@@ -37830,27 +39073,6 @@ export interface SessionHistoryCompactRequest {
|
|
|
37830
39073
|
*/
|
|
37831
39074
|
tokenLimit?: number;
|
|
37832
39075
|
}
|
|
37833
|
-
/**
|
|
37834
|
-
* Internal absolute code-change totals reported by the owning host.
|
|
37835
|
-
*
|
|
37836
|
-
* This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
|
|
37837
|
-
* via the `definition` "SessionUsageSetCodeChangesRequest".
|
|
37838
|
-
*/
|
|
37839
|
-
/** @experimental */
|
|
37840
|
-
export interface SessionUsageSetCodeChangesRequest {
|
|
37841
|
-
/**
|
|
37842
|
-
* Absolute added-line total, replacing the previous reading.
|
|
37843
|
-
*/
|
|
37844
|
-
linesAdded: number;
|
|
37845
|
-
/**
|
|
37846
|
-
* Absolute removed-line total, replacing the previous reading.
|
|
37847
|
-
*/
|
|
37848
|
-
linesRemoved: number;
|
|
37849
|
-
/**
|
|
37850
|
-
* Absolute changed-file count; omission preserves the previous count.
|
|
37851
|
-
*/
|
|
37852
|
-
filesCount?: number;
|
|
37853
|
-
}
|
|
37854
39076
|
/**
|
|
37855
39077
|
* The incumbent session-owned quota and account projection.
|
|
37856
39078
|
*
|
|
@@ -38474,6 +39696,17 @@ export declare function createServerRpc(connection: MessageConnection): {
|
|
|
38474
39696
|
listTokenPriceUnits: (params?: ModelsListTokenPriceUnitsRequest) => Promise<ModelTokenPriceUnitList>;
|
|
38475
39697
|
};
|
|
38476
39698
|
/** @experimental */
|
|
39699
|
+
decisions: {
|
|
39700
|
+
/**
|
|
39701
|
+
* Asks a decision model yes/no, pick-one, or rating questions about shared context and returns normalized probabilities. Sessionless, so a host can classify or route a request before any session exists. Requires the `DECISIONS_API` feature flag. A failed request is a JSON-RPC error whose `data` is a `DecisionErrorData`.
|
|
39702
|
+
*
|
|
39703
|
+
* @param params One request to a decision model: shared context plus the questions to answer about it.
|
|
39704
|
+
*
|
|
39705
|
+
* @returns The decision model's answers.
|
|
39706
|
+
*/
|
|
39707
|
+
ask: (params: DecisionsAskRequest) => Promise<DecisionsAskResult>;
|
|
39708
|
+
};
|
|
39709
|
+
/** @experimental */
|
|
38477
39710
|
azureMl: {
|
|
38478
39711
|
/**
|
|
38479
39712
|
* Lists eligible Azure ML local models and redacted warnings before a chat session exists.
|
|
@@ -39142,13 +40375,13 @@ export declare function createServerRpc(connection: MessageConnection): {
|
|
|
39142
40375
|
httpResponseChunk: (params: LlmInferenceHttpResponseChunkRequest) => Promise<LlmInferenceHttpResponseChunkResult>;
|
|
39143
40376
|
};
|
|
39144
40377
|
/** @experimental */
|
|
39145
|
-
|
|
40378
|
+
network: {
|
|
39146
40379
|
/**
|
|
39147
|
-
* Registers the calling SDK client's Kerberos
|
|
40380
|
+
* Registers the calling SDK client's network callbacks, replacing any previous registration. With `resolveProxy`, the client decides the proxies for every request the runtime would otherwise route by ambient proxy settings (proxy environment variables, `NO_PROXY` and operating-system settings), or leaves a request to that routing; requests with an explicitly configured proxy and loopback targets never consult it. With `authenticateNegotiate`, the client supplies the Kerberos tokens for Negotiate proxy challenges instead of native credential lookup. The callbacks serve requests made for the client's sessions and, with `runtime` scope, the runtime's shared traffic, which includes background requests and remote MCP server connections; only one connection may hold `runtime` scope. The registration ends when the connection closes.
|
|
39148
40381
|
*
|
|
39149
|
-
* @param params Registers the calling SDK connection's
|
|
40382
|
+
* @param params Registers the calling SDK connection's network callbacks, replacing any previous registration.
|
|
39150
40383
|
*/
|
|
39151
|
-
setProvider: (params:
|
|
40384
|
+
setProvider: (params: NetworkSetProviderRequest) => Promise<void>;
|
|
39152
40385
|
};
|
|
39153
40386
|
/** @experimental */
|
|
39154
40387
|
sessions: {
|
|
@@ -39391,6 +40624,17 @@ export declare function createServerRpc(connection: MessageConnection): {
|
|
|
39391
40624
|
*/
|
|
39392
40625
|
refresh: (params: ConnectorDiscoveryAccountRequest) => Promise<ConnectorDiscoveryCatalogResult>;
|
|
39393
40626
|
};
|
|
40627
|
+
/** @experimental */
|
|
40628
|
+
lsp: {
|
|
40629
|
+
/**
|
|
40630
|
+
* Reads the process-wide language-server inventory for a working directory without starting servers. Uses the host configuration home and persisted workspace trust.
|
|
40631
|
+
*
|
|
40632
|
+
* @param params Parameters for a process-wide, read-only language-server inventory.
|
|
40633
|
+
*
|
|
40634
|
+
* @returns Runtime-owned configuration inventory and configuration diagnostics.
|
|
40635
|
+
*/
|
|
40636
|
+
list: (params: LspListRequest) => Promise<LspListResult>;
|
|
40637
|
+
};
|
|
39394
40638
|
};
|
|
39395
40639
|
/** Create typed session-scoped RPC methods. */
|
|
39396
40640
|
export declare function createSessionRpc(connection: MessageConnection, sessionId: string): {
|
|
@@ -39804,6 +41048,14 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
39804
41048
|
* @returns The session's authoritative model snapshot. Auto preference fields are configuration for the virtual `auto` model and do not change the selected model identifier. The context tier reflects `Session.getContextTier()`, restored from the session journal on resume.
|
|
39805
41049
|
*/
|
|
39806
41050
|
getCurrent: () => Promise<CurrentModel>;
|
|
41051
|
+
/**
|
|
41052
|
+
* Reads the session's cached startup model state without fetching a catalog or resolving credentials. An interactive host can claim the one-time enablement prompt after applying its startup configuration. Claims remain shared with the owning host and are scoped to this session's lifetime.
|
|
41053
|
+
*
|
|
41054
|
+
* @param params Options for a host's startup model admission check.
|
|
41055
|
+
*
|
|
41056
|
+
* @returns A cached startup model snapshot and an optional one-time enablement prompt. This check never resolves credentials or fetches a catalog.
|
|
41057
|
+
*/
|
|
41058
|
+
startupAdmission: (params: ModelStartupAdmissionRequest) => Promise<ModelStartupAdmissionResult>;
|
|
39807
41059
|
/**
|
|
39808
41060
|
* Switches the session to a model and optional reasoning configuration.
|
|
39809
41061
|
*
|
|
@@ -39833,7 +41085,7 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
39833
41085
|
*
|
|
39834
41086
|
* @param params Reasoning effort level to apply to the currently selected model.
|
|
39835
41087
|
*
|
|
39836
|
-
* @returns Update the session's reasoning effort without changing the selected model. Use `switchTo` instead when you also need to change the model. The runtime
|
|
41088
|
+
* @returns Update the session's reasoning effort without changing the selected model. Use `switchTo` instead when you also need to change the model. The runtime applies the effort to the next new model request, including tool continuations, without changing retries of an already-started request.
|
|
39837
41089
|
*/
|
|
39838
41090
|
setReasoningEffort: (params: ModelSetReasoningEffortRequest) => Promise<ModelSetReasoningEffortResult>;
|
|
39839
41091
|
/**
|
|
@@ -40779,6 +42031,12 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
40779
42031
|
*/
|
|
40780
42032
|
refresh: (params?: SessionPluginsMarketplacesRefreshRequest) => Promise<MarketplaceRefreshResult>;
|
|
40781
42033
|
};
|
|
42034
|
+
/**
|
|
42035
|
+
* Reads Team and managed soft plugin defaults for the live session. Does not install plugins or persist user preferences.
|
|
42036
|
+
*
|
|
42037
|
+
* @returns Soft plugin defaults for this session, without persistent user preferences or hard policy.
|
|
42038
|
+
*/
|
|
42039
|
+
getDefaults: () => Promise<SessionPluginDefaults>;
|
|
40782
42040
|
/**
|
|
40783
42041
|
* Reloads the session's plugin set, refreshing MCP servers, custom agents, hooks, and skills cache so SDK-driven changes via `server.plugins.*` take effect immediately.
|
|
40784
42042
|
*
|
|
@@ -40854,6 +42112,40 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
40854
42112
|
* @param params Parameters for (re)loading the merged LSP configuration set.
|
|
40855
42113
|
*/
|
|
40856
42114
|
initialize: (params: LspInitializeRequest) => Promise<void>;
|
|
42115
|
+
/**
|
|
42116
|
+
* Reads language-server configuration and diagnostics using the session's settings and active plugins. Explicit force reloads the files from disk.
|
|
42117
|
+
*
|
|
42118
|
+
* @param params Parameters for (re)loading the merged LSP configuration set.
|
|
42119
|
+
*
|
|
42120
|
+
* @returns Runtime-owned configuration inventory and configuration diagnostics.
|
|
42121
|
+
*/
|
|
42122
|
+
list: (params: LspInitializeRequest) => Promise<SessionLspListResult>;
|
|
42123
|
+
/**
|
|
42124
|
+
* Initializes and retains configured language servers under the session's effective LSP sandbox policy. The runtime owns client leases, callbacks, and process lifetime.
|
|
42125
|
+
*
|
|
42126
|
+
* @param params Parameters for (re)loading the merged LSP configuration set.
|
|
42127
|
+
*
|
|
42128
|
+
* @returns The servers retained by the session after warmup.
|
|
42129
|
+
*/
|
|
42130
|
+
start: (params: LspInitializeRequest) => Promise<SessionLspStartResult>;
|
|
42131
|
+
/**
|
|
42132
|
+
* Stops the session's language-server clients without changing another session or the process-wide inventory.
|
|
42133
|
+
*/
|
|
42134
|
+
stop: () => Promise<void>;
|
|
42135
|
+
/**
|
|
42136
|
+
* Probes one configured language-server process under the session's effective LSP sandbox policy, then terminates the probe process.
|
|
42137
|
+
*
|
|
42138
|
+
* @param params A server selected for a startup probe.
|
|
42139
|
+
*
|
|
42140
|
+
* @returns Result of a language-server startup probe.
|
|
42141
|
+
*/
|
|
42142
|
+
diagnose: (params: SessionLspDiagnoseRequest) => Promise<SessionLspDiagnoseResult>;
|
|
42143
|
+
/**
|
|
42144
|
+
* Persists a user-level language-server enable override in the session's configuration home. Reload configuration to apply it.
|
|
42145
|
+
*
|
|
42146
|
+
* @param params A persistent user-level server toggle.
|
|
42147
|
+
*/
|
|
42148
|
+
set: (params: SessionLspSetRequest) => Promise<void>;
|
|
40857
42149
|
};
|
|
40858
42150
|
/** @experimental */
|
|
40859
42151
|
extensions: {
|
|
@@ -41106,11 +42398,13 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
|
|
|
41106
42398
|
*/
|
|
41107
42399
|
handlePendingExitPlanMode: (params: UIHandlePendingExitPlanModeRequest) => Promise<UIHandlePendingResult>;
|
|
41108
42400
|
/**
|
|
41109
|
-
* Registers an in-process handler for auto-mode-switch requests so the server bridge skips dispatch.
|
|
42401
|
+
* Registers an in-process handler for auto-mode-switch requests so the server bridge skips dispatch. Set `autoModeRecovery` to also handle Auto recovery consent offers.
|
|
42402
|
+
*
|
|
42403
|
+
* @param params Optional recovery-aware enrollment for an in-process Auto-switch handler.
|
|
41110
42404
|
*
|
|
41111
|
-
* @returns
|
|
42405
|
+
* @returns Registers an in-process Auto-switch responder and suppresses server-bridge dispatch to avoid competing responders for the same requestId. When requested, also enrolls the responder for active-request Auto recovery and acknowledges support. Attach the actual listener separately through standard event subscriptions before starting a turn, and release the handle when the responder is removed.
|
|
41112
42406
|
*/
|
|
41113
|
-
registerDirectAutoModeSwitchHandler: () => Promise<UIRegisterDirectAutoModeSwitchHandlerResult>;
|
|
42407
|
+
registerDirectAutoModeSwitchHandler: (params?: SessionUiRegisterDirectAutoModeSwitchHandlerRequest) => Promise<UIRegisterDirectAutoModeSwitchHandlerResult>;
|
|
41114
42408
|
/**
|
|
41115
42409
|
* Unregisters a previously-registered in-process auto-mode-switch handler by its opaque handle.
|
|
41116
42410
|
*
|
|
@@ -41979,17 +43273,25 @@ export interface ExtensionLaunchProviderHandler {
|
|
|
41979
43273
|
*/
|
|
41980
43274
|
resolve(params: ExtensionLaunchProviderResolveRequest): Promise<ExtensionLaunchProviderResolveResult>;
|
|
41981
43275
|
}
|
|
41982
|
-
/** Handler for `
|
|
43276
|
+
/** Handler for `network` client global API methods. */
|
|
41983
43277
|
/** @experimental */
|
|
41984
|
-
export interface
|
|
43278
|
+
export interface NetworkHandler {
|
|
43279
|
+
/**
|
|
43280
|
+
* Requests the proxies for a request target as a PAC-style proxy list, or no list to leave the request to the runtime's own proxy resolution. The runtime caches answers for a few seconds and fails the request, rather than connecting directly, when the callback fails.
|
|
43281
|
+
*
|
|
43282
|
+
* @param params Requests the proxies for a request target.
|
|
43283
|
+
*
|
|
43284
|
+
* @returns Proxies for a request target, in the order to try them.
|
|
43285
|
+
*/
|
|
43286
|
+
resolveProxy(params: NetworkResolveProxyRequest): Promise<NetworkResolveProxyResult>;
|
|
41985
43287
|
/**
|
|
41986
|
-
* Requests a fresh base64 initial SPNEGO token for a Kerberos service principal; the runtime
|
|
43288
|
+
* Requests a fresh base64 initial SPNEGO token for a Kerberos service principal; the runtime uses it to answer Negotiate proxy challenges. Tokens must not be logged, persisted or reused across connections. Continuation challenges are not supported by this callback.
|
|
41987
43289
|
*
|
|
41988
43290
|
* @param params Requests a fresh initial SPNEGO token for a Kerberos service principal.
|
|
41989
43291
|
*
|
|
41990
|
-
* @returns Client credentials for a single authentication exchange.
|
|
43292
|
+
* @returns Client credentials for a single Negotiate authentication exchange.
|
|
41991
43293
|
*/
|
|
41992
|
-
|
|
43294
|
+
authenticateNegotiate(params: NetworkAuthenticateNegotiateRequest): Promise<NetworkAuthenticateNegotiateResult>;
|
|
41993
43295
|
}
|
|
41994
43296
|
/** Handler for `llmInference` client global API methods. */
|
|
41995
43297
|
/** @experimental */
|
|
@@ -42071,7 +43373,7 @@ export interface InstallationsHandler {
|
|
|
42071
43373
|
export interface ClientGlobalApiHandlers {
|
|
42072
43374
|
host?: HostHandler;
|
|
42073
43375
|
extensionLaunchProvider?: ExtensionLaunchProviderHandler;
|
|
42074
|
-
|
|
43376
|
+
network?: NetworkHandler;
|
|
42075
43377
|
llmInference?: LlmInferenceHandler;
|
|
42076
43378
|
gitHubTelemetry?: GitHubTelemetryHandler;
|
|
42077
43379
|
gitHubToken?: GitHubTokenHandler;
|