@github/copilot-sdk 1.0.20-preview.2 → 1.0.21-preview.0

package/dist/generated/rpc.d.ts

@@ -16,6 +16,32 @@ export type JsonValue = null | boolean | number | string | JsonValue[] | {
  */
 /** @experimental */
 export type AuthInfo = HMACAuthInfo | EnvAuthInfo | TokenAuthInfo | TokenProviderAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | AccountAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
+/**
+ * Authentication type
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AuthInfoType".
+ */
+/** @experimental */
+export type AuthInfoType = 
+/** Authentication provided by a GitHub App HMAC credential. */
+"hmac"
+/** Authentication resolved from environment-provided credentials. */
+ | "env"
+/** Authentication from an interactive user sign-in. */
+ | "user"
+/** Authentication from a selected provider-owned account, without a GitHub credential. */
+ | "account"
+/** Authentication delegated to the GitHub CLI. */
+ | "gh-cli"
+/** Authentication from an API key credential. */
+ | "api-key"
+/** Authentication from a GitHub token. */
+ | "token"
+/** Authentication from an SDK GitHub token callback. */
+ | "token-provider"
+/** Authentication from a Copilot API token. */
+ | "copilot-api-token";
 /**
  * The provider kind stamped on a signed-in account.
  *
@@ -369,32 +395,6 @@ export type LoginProviderKind =
  | "proxima"
 /** Microsoft Entra sign-in that derives a GitHub (EMU) credential. */
  | "entra";
-/**
- * Authentication type
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "AuthInfoType".
- */
-/** @experimental */
-export type AuthInfoType = 
-/** Authentication provided by a GitHub App HMAC credential. */
-"hmac"
-/** Authentication resolved from environment-provided credentials. */
- | "env"
-/** Authentication from an interactive user sign-in. */
- | "user"
-/** Authentication from a selected provider-owned account, without a GitHub credential. */
- | "account"
-/** Authentication delegated to the GitHub CLI. */
- | "gh-cli"
-/** Authentication from an API key credential. */
- | "api-key"
-/** Authentication from a GitHub token. */
- | "token"
-/** Authentication from an SDK GitHub token callback. */
- | "token-provider"
-/** Authentication from a Copilot API token. */
- | "copilot-api-token";
 /**
  * One step in an interactive login flow. The consumer acts on the step and calls advance to proceed. Browser-open is encoded as two distinct steps by design: `open-url` is CONSUMER-driven (the provider surfaces the authorize URL and the consumer opens it — github.com/GHEC web), while `needs-interaction` is PROVIDER-driven (the provider opens the browser or broker UI itself and does not surface a URL — Entra).
  *
@@ -6573,6 +6573,33 @@ export interface ApiKeyAuthInfo {
     host: string;
     copilotUser?: CopilotUserResponse;
 }
+/**
+ * Credential-free authentication identity safe to expose to hosts and user interfaces.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AuthIdentity".
+ */
+/** @experimental */
+export interface AuthIdentity {
+    type: AuthInfoType;
+    /**
+     * Authentication host
+     */
+    host: string;
+    /**
+     * Authenticated login, when available
+     */
+    login?: string;
+    /**
+     * Name of the environment variable that supplied the credential, when applicable
+     */
+    envVar?: string;
+    /**
+     * Opaque SDK GitHub credential registration backing this identity. Routing metadata only; never a credential.
+     */
+    registrationId?: string;
+    copilotUser?: CopilotUserResponse;
+}
 /**
  * Current authentication state
  *
@@ -6883,6 +6910,12 @@ export interface AgentInfo {
      * Authored base prompt for the agent. Runtime prompt assembly may add dynamic context at invocation time. Omitted from `session.agent.list` unless `includePrompt` is true.
      */
     prompt?: string;
+    /**
+     * Declarative hook actions keyed by event name, executed only while this agent is active.
+     */
+    hooks?: {
+        [k: string]: JsonValue[] | undefined;
+    };
 }
 /**
  * Agents available to the session.
@@ -7116,6 +7149,10 @@ export interface AgentReloadResult {
  */
 /** @experimental */
 export interface AgentsDiscoverRequest {
+    /**
+     * Explicit discovery-only agent roots, separate from customAgents and filesystem grants. Available without ambient discovery, subject to managed/source disables. Relative paths resolve against the request's effective working directory when supplied. Null and omission are equivalent; an empty array contributes no explicit roots.
+     */
+    agentDirectories?: string[];
     /**
      * Optional list of project directory paths to scan for project-scoped agents. When omitted or empty, only user/plugin/remote-independent agents are returned (no project scan).
      */
@@ -7173,6 +7210,10 @@ export interface AgentSetPromptRequest {
  */
 /** @experimental */
 export interface AgentsGetDiscoveryPathsRequest {
+    /**
+     * Explicit discovery-only agent roots to enumerate, including configured missing directories. Relative paths resolve against the request's effective working directory when supplied. These are not filesystem grants or preferred creation targets. Null and omission are equivalent.
+     */
+    agentDirectories?: string[];
     /**
      * Optional list of project directory paths. When omitted or empty, only the user-level directory is returned.
      */
@@ -7200,33 +7241,6 @@ export interface ProviderDescriptor {
      */
     available: boolean;
 }
-/**
- * Credential-free authentication identity safe to expose to hosts and user interfaces.
- *
- * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
- * via the `definition` "AuthIdentity".
- */
-/** @experimental */
-export interface AuthIdentity {
-    type: AuthInfoType;
-    /**
-     * Authentication host
-     */
-    host: string;
-    /**
-     * Authenticated login, when available
-     */
-    login?: string;
-    /**
-     * Name of the environment variable that supplied the credential, when applicable
-     */
-    envVar?: string;
-    /**
-     * Opaque SDK GitHub credential registration backing this identity. Routing metadata only; never a credential.
-     */
-    registrationId?: string;
-    copilotUser?: CopilotUserResponse;
-}
 /**
  * Credential-free identity metadata.
  *
@@ -12094,6 +12108,10 @@ export interface HistoryTruncateResult {
  */
 /** @experimental */
 export interface HooksDiscoverRequest {
+    /**
+     * Explicit discovery-only file-hook roots, separate from callback hooks and filesystem grants. Available without ambient discovery or repository file-hook enablement, subject to managed/hook disables. Relative paths resolve against the request's effective working directory when supplied. Null and omission are equivalent; an empty array contributes no explicit roots.
+     */
+    hookDirectories?: string[];
     /**
      * Optional project directory paths whose trusted repository and project-expanded plugin hooks should be discovered. When omitted or empty, user, managed-policy, and globally enabled installed or explicit plugin hooks are returned without project expansion.
      */
@@ -13187,6 +13205,10 @@ export interface InstructionDiscoveryPathList {
  */
 /** @experimental */
 export interface InstructionsDiscoverRequest {
+    /**
+     * Explicit discovery-only instruction roots using existing SDK instruction formats, not filesystem grants. Available without ambient discovery, subject to instruction/managed disables. Relative paths resolve against the request's effective working directory when supplied. Null and omission are equivalent; an empty array contributes no explicit roots.
+     */
+    instructionDirectories?: string[];
     /**
      * Optional list of project directory paths to scan for repository/working-directory instruction sources. When omitted or empty, only user-level and plugin instruction sources are returned (no project scan).
      */
@@ -13204,6 +13226,10 @@ export interface InstructionsDiscoverRequest {
  */
 /** @experimental */
 export interface InstructionsGetDiscoveryPathsRequest {
+    /**
+     * Explicit discovery-only instruction roots to enumerate, including configured missing directories. Relative paths resolve against the request's effective working directory when supplied. These are not filesystem grants or preferred creation targets. Null and omission are equivalent.
+     */
+    instructionDirectories?: string[];
     /**
      * Optional list of project directory paths. When omitted or empty, only the user-level targets are returned.
      */
@@ -17134,6 +17160,64 @@ export interface ModelCapabilitiesOverrideLimitsVision {
      */
     max_prompt_image_size?: number;
 }
+/**
+ * Host presentation state the reasoning-summaries policy depends on.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ModelGetReasoningSummariesRequest".
+ */
+/** @experimental */
+export interface ModelGetReasoningSummariesRequest {
+    /**
+     * The host's persisted `showReasoning` user setting, omitted when unset.
+     */
+    persistedShowReasoning?: boolean;
+    /**
+     * Whether the host is currently showing reasoning summaries. Defaults to false.
+     */
+    summariesVisible?: boolean;
+}
+/**
+ * Reasoning-summaries presentation policy for the session's current model.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ModelGetReasoningSummariesResult".
+ */
+/** @experimental */
+export interface ModelGetReasoningSummariesResult {
+    /**
+     * False until the session has a model catalog and a selected model. This read never resolves the catalog itself, and the runtime emits no readiness notification, so repeating this call alone leaves `ready` false indefinitely on a session that has neither listed models nor run a turn. `session.model.list` is the prerequisite and the signal: it resolves and caches the catalog for the session, so a successful return means the next read is ready. The exception is a session that resolves models without a Copilot catalog, that is a BYOK registry or an alternate provider: `session.model.list` returns an empty list without caching a catalog, so `ready` stays false and this policy is unavailable there. While false, every model-policy field is false and `visibility` is omitted; `experimentSettled` is independent of readiness and still reports the assignment state.
+     */
+    ready: boolean;
+    /**
+     * Whether the session's reasoning-summaries experiment assignment has settled. False means this read does not wait for a pending assignment and reports the experiment-derived fields conservatively: `showHiddenHint` is false and `visibility` falls back to `persistedShowReasoning`, or is omitted when none was supplied. A host that wants the assigned answer re-reads until this is true.
+     */
+    experimentSettled: boolean;
+    /**
+     * Whether turns on this session produce reasoning summaries, honouring an explicit session reasoning-summary override.
+     */
+    sessionShowsSummaries: boolean;
+    /**
+     * Whether the selected model shows reasoning summaries by default.
+     */
+    modelDefaultShowsSummaries: boolean;
+    /**
+     * Whether the selected model emits reasoning headers.
+     */
+    showReasoningHeaders: boolean;
+    /**
+     * Default reasoning visibility, and only meaningful once `ready` is true: false when the session produces no summaries, else the persisted setting, else the experiment's default. While `ready` is true it is omitted only when all three are unavailable, that is when the session produces summaries, no `persistedShowReasoning` was supplied, and `experimentSettled` is false. While `ready` is false there is no model policy to report and this field is always omitted, so an absent value alone does not imply a pending experiment.
+     */
+    visibility?: boolean;
+    /**
+     * Whether to show the hint that reasoning summaries are hidden. Always false while `experimentSettled` is false.
+     */
+    showHiddenHint: boolean;
+    /**
+     * Whether the supplied `persistedShowReasoning` setting only restates the model default. This reports a redundancy, not a standing instruction to delete the setting: it stays true for as long as the setting and the model default agree, including for a user who later chose that value deliberately. It exists for a one-time migration of a legacy setting written before the model default made it redundant, so a host that acts on it owns the cleanup and must gate it behind its own persisted `done` marker, delete only a setting whose value still matches the one it read, and never repeat the deletion on a later launch. Under an off-by-default reasoning-summaries experiment an explicit `showReasoning: true` opt-in also reads as redundant on a summary-producing model, so an ungated host would keep deleting that opt-in and hide summaries again on every launch.
+     */
+    clearRedundantSetting: boolean;
+}
 /**
  * List of Copilot models available to the resolved user, including capabilities and billing metadata.
  *
@@ -23894,15 +23978,27 @@ export interface SessionOpenOptions {
      */
     allowAllMcpServerInstructions?: boolean;
     /**
-     * Additional directories to search for skills.
+     * Explicit discovery-only skill roots, not filesystem grants. Available without enableConfigDiscovery, subject to skill/managed disables. Relative SDK paths resolve once when supplied against the request's effective workingDirectory; retained roots do not move on cwd changes. Null and omission are equivalent; [] clears only the explicit SDK contribution.
      */
     skillDirectories?: string[];
+    /**
+     * Explicit discovery-only agent roots, separate from customAgents and filesystem grants. Available without enableConfigDiscovery, subject to managed/source disables. Relative SDK paths resolve once when supplied against the request's effective workingDirectory; retained roots do not move on cwd changes. Null and omission are equivalent; [] clears only the explicit SDK contribution.
+     */
+    agentDirectories?: string[];
+    /**
+     * Explicit discovery-only instruction roots using existing SDK instruction formats, not filesystem grants. Available without enableConfigDiscovery, subject to instruction/managed disables. Relative SDK paths resolve once when supplied against the request's effective workingDirectory; retained roots do not move on cwd changes. Null and omission are equivalent; [] clears only the explicit SDK contribution.
+     */
+    instructionDirectories?: string[];
+    /**
+     * Explicit discovery-only file-hook roots, separate from callback hooks and filesystem grants. Available without enableConfigDiscovery or enableFileHooks, which controls repository-origin hooks only; hook/managed disables still apply. Relative SDK paths resolve once when supplied against the request's effective workingDirectory; retained roots do not move on cwd changes. Null and omission are equivalent; [] clears only the explicit SDK contribution.
+     */
+    hookDirectories?: string[];
     /**
      * Skill scan directories and descendants excluded from discovery. Supports `~`-relative paths.
      */
     ignoredSkillsLocations?: string[];
     /**
-     * Whether skill loading is enabled. When omitted, an SDK skill provider enables skills by default.
+     * Whether skill loading is enabled. When omitted, explicit SDK skill roots or an SDK skill provider enable skills independently of enableConfigDiscovery.
      */
     enableSkills?: boolean;
     /**
@@ -25679,9 +25775,21 @@ export interface SessionUpdateOptionsParams {
      */
     allowAllMcpServerInstructions?: boolean;
     /**
-     * Additional directories to search for skills.
+     * Explicit discovery-only skill roots, not filesystem grants. Available without enableConfigDiscovery, subject to skill/managed disables. Relative SDK paths resolve once when supplied against the request's effective workingDirectory; retained roots do not move on cwd changes. Null and omission are equivalent; [] clears only the explicit SDK contribution.
      */
     skillDirectories?: string[];
+    /**
+     * Explicit discovery-only agent roots, separate from customAgents and filesystem grants. Available without enableConfigDiscovery, subject to managed/source disables. Relative SDK paths resolve once when supplied against the request's effective workingDirectory; retained roots do not move on cwd changes. Null and omission are equivalent; [] clears only the explicit SDK contribution.
+     */
+    agentDirectories?: string[];
+    /**
+     * Explicit discovery-only instruction roots using existing SDK instruction formats, not filesystem grants. Available without enableConfigDiscovery, subject to instruction/managed disables. Relative SDK paths resolve once when supplied against the request's effective workingDirectory; retained roots do not move on cwd changes. Null and omission are equivalent; [] clears only the explicit SDK contribution.
+     */
+    instructionDirectories?: string[];
+    /**
+     * Explicit discovery-only file-hook roots, separate from callback hooks and filesystem grants. Available without enableConfigDiscovery or enableFileHooks, which controls repository-origin hooks only; hook/managed disables still apply. Relative SDK paths resolve once when supplied against the request's effective workingDirectory; retained roots do not move on cwd changes. Null and omission are equivalent; [] clears only the explicit SDK contribution.
+     */
+    hookDirectories?: string[];
     /**
      * Skill scan directories and descendants excluded from discovery. Supports `~`-relative paths.
      */
@@ -25789,7 +25897,7 @@ export interface SessionUpdateOptionsParams {
      */
     organizationCustomInstructions?: string;
     /**
-     * Whether to enable loading of `.github/hooks/` filesystem hooks. Separate from the SDK callback hook mechanism.
+     * Whether to enable repository-origin file hooks from `.github/hooks/` and trusted repository-configured roots. Does not control explicit hookDirectories or SDK callback hooks.
      */
     enableFileHooks?: boolean;
     /**
@@ -25801,7 +25909,7 @@ export interface SessionUpdateOptionsParams {
      */
     enableSessionStore?: boolean;
     /**
-     * Whether skill loading is enabled. Explicit false disables every source, including a bound SDK provider; changing the value invalidates the loaded skill snapshot. When omitted, creation falls back to enableConfigDiscovery unless an SDK skill provider is registered.
+     * Whether skill loading is enabled. Explicit false disables every source, including explicit SDK roots and a bound SDK provider; changing the value invalidates the loaded skill snapshot. When omitted, creation falls back to enableConfigDiscovery unless explicit SDK skill roots or an SDK skill provider are supplied.
      */
     enableSkills?: boolean;
     contextTier?: OptionsUpdateContextTier;
@@ -26256,7 +26364,7 @@ export interface SkillsDiscoverRequest {
      */
     projectPaths?: string[];
     /**
-     * Optional list of additional skill directory paths to include
+     * Explicit discovery-only skill roots, not filesystem grants. Available without ambient discovery, subject to skill/managed disables. Relative paths resolve against the request's effective working directory when supplied. Null and omission are equivalent; an empty array contributes no explicit roots.
      */
     skillDirectories?: string[];
     /**
@@ -26311,6 +26419,10 @@ export interface SkillSetEnabledRequest {
  */
 /** @experimental */
 export interface SkillsGetDiscoveryPathsRequest {
+    /**
+     * Explicit discovery-only skill roots to enumerate, including configured missing directories. Relative paths resolve against the request's effective working directory when supplied. These are not filesystem grants or preferred creation targets. Null and omission are equivalent.
+     */
+    skillDirectories?: string[];
     /**
      * Optional list of project directory paths. When omitted or empty, only personal and custom directories are returned.
      */
@@ -28363,6 +28475,107 @@ export interface UserSettingMetadata {
      */
     isDefault: boolean;
 }
+/**
+ * A single top-level setting subtree to validate and write.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsApplyTopKeyRequest".
+ */
+/** @experimental */
+export interface UserSettingsApplyTopKeyRequest {
+    /**
+     * Canonical path of the setting the caller is editing. Currently informational only.
+     */
+    canonicalPath: string[];
+    /**
+     * Top-level setting name to write.
+     */
+    topKey: string;
+    /**
+     * Value to write for the whole top-level key. Omitted when `delete` is true. Explicit null is preserved and validated as null.
+     */
+    value?: JsonValue | null;
+    /**
+     * True to remove the top-level key instead of writing it.
+     */
+    delete?: boolean;
+    /**
+     * Records that the user chose an update channel explicitly, so the one-time staff channel migration stops reapplying. Honored only for the `autoUpdatesChannel` key.
+     */
+    completeStaffUpdateChannelMigration?: boolean;
+}
+/**
+ * Outcome of validating and writing one top-level setting subtree.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsApplyTopKeyResult".
+ */
+/** @experimental */
+export interface UserSettingsApplyTopKeyResult {
+    /**
+     * `ok` when the value was written, `validation-error` when it was rejected before any write, `write-error` when validation passed but the write failed.
+     */
+    status: string;
+    /**
+     * Problems found, present only when `status` is `validation-error`.
+     */
+    issues?: UserSettingsValidationIssue[];
+    /**
+     * Why the write failed, present only when `status` is `write-error`.
+     */
+    error?: string | null;
+}
+/**
+ * One problem found while validating a setting value.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsValidationIssue".
+ */
+/** @experimental */
+export interface UserSettingsValidationIssue {
+    /**
+     * Where in the settings tree the problem sits, as object keys and array indices. The first element is the top-level key; a whole-value problem is reported as that single key.
+     */
+    path: JsonValue[];
+    /**
+     * Human-readable description of the problem.
+     */
+    message: string;
+}
+/**
+ * Selects which settings file paths to resolve.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsGetPathsRequest".
+ */
+/** @experimental */
+export interface UserSettingsGetPathsRequest {
+    /**
+     * Absolute path of a repository root. Supply it to also resolve that repository's two settings file paths; omit it to resolve only the user path.
+     */
+    repoRoot?: string;
+}
+/**
+ * On-disk locations of the settings files this runtime reads. A path is reported whether or not the file exists.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsGetPathsResult".
+ */
+/** @experimental */
+export interface UserSettingsGetPathsResult {
+    /**
+     * The user settings file: `settings.json` under the resolved Copilot home. This is the file `user.settings.get`, `user.settings.load`, and `user.settings.set` read and write.
+     */
+    userSettings: string;
+    /**
+     * The repository's checked-in settings file, or null when no repository root was supplied.
+     */
+    repoSettings?: string | null;
+    /**
+     * The repository's local, untracked settings file, or null when no repository root was supplied.
+     */
+    repoLocalSettings?: string | null;
+}
 /**
  * Per-key metadata for every known user setting in settings.json, including settings left at their default. Excludes repository- and enterprise-managed overrides.
  *
@@ -28378,6 +28591,178 @@ export interface UserSettingsGetResult {
         [k: string]: UserSettingMetadata;
     };
 }
+/**
+ * Top-level user-setting keys grouped by who may govern them.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsGovernanceKeysResult".
+ */
+/** @experimental */
+export interface UserSettingsGovernanceKeysResult {
+    /**
+     * Top-level keys a repository may override through `.github/copilot/settings.json` or `.github/copilot/settings.local.json`.
+     */
+    repo: string[];
+    /**
+     * Top-level keys a repository may override through a Claude-compatible repository config.
+     */
+    claudeRepo: string[];
+    /**
+     * Top-level keys an enterprise policy may fix through managed settings.
+     */
+    managed: string[];
+}
+/**
+ * Contents of settings.json as stored, for a caller about to rewrite it.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsLoadForEditResult".
+ */
+/** @experimental */
+export interface UserSettingsLoadForEditResult {
+    /**
+     * `ok` when the file parsed, `missing` when there is no file yet, `invalid` when the file exists but will not parse.
+     */
+    status: string;
+    /**
+     * Parsed contents, present only when `status` is `ok`.
+     */
+    settings?: JsonValue;
+}
+/**
+ * Settings object whose key names should be canonicalized.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsNormalizeRequest".
+ */
+/** @experimental */
+export interface UserSettingsNormalizeRequest {
+    /**
+     * Free-form settings object, possibly using legacy or snake_case key names.
+     */
+    settings: JsonValue;
+}
+/**
+ * Settings object with canonical key names.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsNormalizeResult".
+ */
+/** @experimental */
+export interface UserSettingsNormalizeResult {
+    /**
+     * The same settings with every legacy or snake_case key renamed to its canonical spelling.
+     */
+    settings: JsonValue;
+}
+/**
+ * One setting that will not take effect, and why.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsProblem".
+ */
+/** @experimental */
+export interface UserSettingsProblem {
+    /**
+     * Stable identifier for this problem within the reported set, so a caller can track a selection across refreshes.
+     */
+    id: string;
+    /**
+     * What is wrong in machine-readable form, for a caller that wants to branch rather than display.
+     */
+    kind: string;
+    /**
+     * Coarse grouping for the problem, for a caller that presents problems in sections.
+     */
+    category: string;
+    source: UserSettingsProblemLocation;
+    /**
+     * The offending key as written in the file, when the problem is attributable to a single key. Absent when the whole file is at fault.
+     */
+    rawKey?: string;
+    /**
+     * Why the setting will not take effect. Never contains the setting's value, which may be a token or another secret.
+     */
+    explanation: string;
+}
+/**
+ * The settings layer a problem was found in.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsProblemLocation".
+ */
+/** @experimental */
+export interface UserSettingsProblemLocation {
+    /**
+     * Which layer this is: `user`, `repo`, or `local`.
+     */
+    kind: string;
+    /**
+     * The caller-supplied display label for the layer.
+     */
+    label: string;
+    /**
+     * Absolute path of the file backing this layer.
+     */
+    filePath: string;
+}
+/**
+ * One already-loaded settings layer to diagnose.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsProblemSource".
+ */
+/** @experimental */
+export interface UserSettingsProblemSource {
+    /**
+     * Which layer this is: `user`, `repo`, or `local`.
+     */
+    kind: string;
+    /**
+     * Caller-chosen display label for the layer, echoed back on each problem so a caller can group by layer without re-deriving its own naming.
+     */
+    label: string;
+    /**
+     * Absolute path of the file backing this layer.
+     */
+    filePath: string;
+    /**
+     * The layer's settings exactly as loaded, unnormalized. Empty when the file is missing or failed to parse.
+     */
+    config?: {
+        [k: string]: unknown | undefined;
+    };
+    /**
+     * True when the file itself failed to parse, so its keys could not be read at all.
+     */
+    invalid?: boolean;
+}
+/**
+ * The settings layers to diagnose.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsProblemsRequest".
+ */
+/** @experimental */
+export interface UserSettingsProblemsRequest {
+    /**
+     * Layers to diagnose, in the precedence order the caller applies them.
+     */
+    sources?: UserSettingsProblemSource[];
+}
+/**
+ * The settings that will not take effect across the given layers.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsProblemsResult".
+ */
+/** @experimental */
+export interface UserSettingsProblemsResult {
+    /**
+     * Each setting that will not take effect, and why. Empty when every layer is healthy.
+     */
+    problems?: UserSettingsProblem[];
+}
 /**
  * Partial user settings to write to settings.json. Each top-level key is written individually, replacing the existing value; a key whose value is null is removed.
  *
@@ -28391,6 +28776,57 @@ export interface UserSettingsSetRequest {
      */
     settings: JsonValue;
 }
+/**
+ * A single top-level setting subtree to validate.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsValidateRequest".
+ */
+/** @experimental */
+export interface UserSettingsValidateRequest {
+    /**
+     * Top-level setting name to validate.
+     */
+    topKey: string;
+    /**
+     * Value to validate. Omitted when `delete` is true.
+     */
+    value?: JsonValue;
+    /**
+     * True to validate a removal of this key. The current settings file is not read.
+     */
+    delete?: boolean;
+}
+/**
+ * Outcome of validating one top-level setting subtree.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsValidateResult".
+ */
+/** @experimental */
+export interface UserSettingsValidateResult {
+    /**
+     * True when the subtree is valid.
+     */
+    ok: boolean;
+    /**
+     * Problems found, empty when `ok` is true.
+     */
+    issues?: UserSettingsValidationIssue[];
+}
+/**
+ * The whole content to store in the user settings file.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "UserSettingsWriteAllRequest".
+ */
+/** @experimental */
+export interface UserSettingsWriteAllRequest {
+    /**
+     * The settings object to store. It replaces the file's entire content, so a key absent here is removed.
+     */
+    settings: JsonValue;
+}
 /**
  * Current sharing status and shareable GitHub URL for a session.
  *
@@ -30089,6 +30525,19 @@ export interface HostGetConfigurationResult {
 /** @experimental */
 export interface HostReadyResult {
 }
+/**
+ * The resolved feature flags, keyed by flag name.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "FeatureFlagsResolveResult".
+ */
+/** @experimental */
+export interface FeatureFlagsResolveResult {
+    /**
+     * Whether the flag is enabled for this population.
+     */
+    [k: string]: boolean | undefined;
+}
 /**
  * Ordered managed permission verdicts and the supplied policy's fail-closed posture.
  *
@@ -30996,6 +31445,25 @@ export declare function createServerRpc(connection: MessageConnection): {
         disable: (params: DiscoveredExtensionsDisableRequest) => Promise<void>;
     };
     /** @experimental */
+    instructions: {
+        /**
+         * Discovers instruction sources across user, repository, and plugin sources.
+         *
+         * @param params Optional project paths to include in instruction discovery.
+         *
+         * @returns Instruction sources discovered across user, repository, and plugin sources.
+         */
+        discover: (params: InstructionsDiscoverRequest) => Promise<ServerInstructionSourceList>;
+        /**
+         * Returns the canonical files and directories where a client may create custom instructions that the runtime will recognize, including ones that do not exist yet. Repository targets become active once created.
+         *
+         * @param params Optional project paths to include when enumerating instruction discovery targets.
+         *
+         * @returns Canonical files and directories where custom instructions can be created so the runtime will recognize them.
+         */
+        getDiscoveryPaths: (params: InstructionsGetDiscoveryPathsRequest) => Promise<InstructionDiscoveryPathList>;
+    };
+    /** @experimental */
     skills: {
         /**
          * Plans installation of a verified Agent Finder Skill candidate without writing files. The returned review is safe to present to a user and installing always leaves the Skill disabled until separately enabled.
@@ -31248,25 +31716,6 @@ export declare function createServerRpc(connection: MessageConnection): {
         getDiscoveryPaths: (params: AgentsGetDiscoveryPathsRequest) => Promise<AgentDiscoveryPathList>;
     };
     /** @experimental */
-    instructions: {
-        /**
-         * Discovers instruction sources across user, repository, and plugin sources.
-         *
-         * @param params Optional project paths to include in instruction discovery.
-         *
-         * @returns Instruction sources discovered across user, repository, and plugin sources.
-         */
-        discover: (params: InstructionsDiscoverRequest) => Promise<ServerInstructionSourceList>;
-        /**
-         * Returns the canonical files and directories where a client may create custom instructions that the runtime will recognize, including ones that do not exist yet. Repository targets become active once created.
-         *
-         * @param params Optional project paths to include when enumerating instruction discovery targets.
-         *
-         * @returns Canonical files and directories where custom instructions can be created so the runtime will recognize them.
-         */
-        getDiscoveryPaths: (params: InstructionsGetDiscoveryPathsRequest) => Promise<InstructionDiscoveryPathList>;
-    };
-    /** @experimental */
     commands: {
         /**
          * Lists the well-known built-in slash commands that work as the first message in a new session (e.g. /plan, /env), without requiring an active session. Commands that depend on session state, authentication, or a synced session are omitted.
@@ -32033,6 +32482,14 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
          * @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 stores the effort on the session and applies it to subsequent turns.
          */
         setReasoningEffort: (params: ModelSetReasoningEffortRequest) => Promise<ModelSetReasoningEffortResult>;
+        /**
+         * Computes whether the session's current model shows reasoning summaries and how a host should present them: the default Ctrl+T visibility, reasoning headers, the hidden-summaries hint, and whether a persisted `showReasoning` setting is redundant. The runtime folds in the session's model catalog, selection and reasoning-summaries experiment assignment; the host supplies only its own persisted setting and current visibility. This method reads the session's resolved model catalog rather than resolving it, so call `session.model.list` first on a session that has not listed models or run a turn; until then the result is `ready: false`. A session that resolves models without a Copilot catalog, that is a BYOK registry or an alternate provider, never caches one and stays `ready: false`.
+         *
+         * @param params Host presentation state the reasoning-summaries policy depends on.
+         *
+         * @returns Reasoning-summaries presentation policy for the session's current model.
+         */
+        getReasoningSummaries: (params: ModelGetReasoningSummariesRequest) => Promise<ModelGetReasoningSummariesResult>;
         /**
          * Lists models available to this session using its own auth and integration context. Connected hosts (CLI TUI, GitHub App) should call this through the session client so remote sessions return the remote CLI's available models rather than the caller's.
          *