@github/copilot-sdk 1.0.17-preview.4 → 1.0.17-preview.6

package/dist/generated/rpc.d.ts

@@ -15,7 +15,7 @@ export type JsonValue = null | boolean | number | string | JsonValue[] | {
  * via the `definition` "AuthInfo".
  */
 /** @experimental */
-export type AuthInfo = HMACAuthInfo | EnvAuthInfo | TokenAuthInfo | TokenProviderAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
+export type AuthInfo = HMACAuthInfo | EnvAuthInfo | TokenAuthInfo | TokenProviderAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | AccountAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
 /**
  * The provider kind stamped on a signed-in account.
  *
@@ -383,6 +383,8 @@ export type AuthInfoType =
  | "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. */
@@ -445,17 +447,19 @@ export type AuthLoginStep = {
     kind: "error";
 };
 /**
- * Terminal disposition of a login persistence attempt.
+ * Disposition of a login attempt, including pending user decisions.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AuthLoginResultStatus".
  */
 /** @experimental */
 export type AuthLoginResultStatus = 
-/** The credential was persisted and the account is signed in. */
+/** The credential was persisted and the selected account is signed in. */
 "completed"
 /** Persistence needs explicit consent to store the token in plaintext. */
  | "needs-plaintext-consent"
+/** Credentials are saved; select an account using a returned selectionId as advance input to complete sign-in. */
+ | "needs-account-selection"
 /** The user declined plaintext persistence. */
  | "declined";
 /**
@@ -1358,6 +1362,20 @@ export type ConnectorMcpStatus =
  | "disabled"
 /** The Connector currently has no live server configuration. */
  | "not_configured";
+/**
+ * Availability.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectorDiscoveryAvailability".
+ */
+/** @experimental */
+export type ConnectorDiscoveryAvailability = 
+/** Enabled. */
+"enabled"
+/** Disabled. */
+ | "disabled"
+/** Unavailable. */
+ | "unavailable";
 /**
  * Session account selection, or null.
  *
@@ -4750,7 +4768,7 @@ export type SessionsClientMetadataEntry = {
  * via the `definition` "SettableAuthInfo".
  */
 /** @experimental */
-export type SettableAuthInfo = HMACAuthInfo | EnvAuthInfo | SettableTokenAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
+export type SettableAuthInfo = HMACAuthInfo | EnvAuthInfo | SettableTokenAuthInfo | CopilotApiTokenAuthInfo | UserAuthInfo | AccountAuthInfo | GhCliAuthInfo | ApiKeyAuthInfo;
 /**
  * Rust-owned settings predicates exposed across the SDK boundary. Raw feature-flag names are intentionally not part of the contract.
  *
@@ -6405,6 +6423,27 @@ export interface UserAuthInfo {
     login: string;
     copilotUser?: CopilotUserResponse;
 }
+/**
+ * An interactive account whose model provider owns its credentials. It carries no GitHub credential.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AccountAuthInfo".
+ */
+/** @experimental */
+export interface AccountAuthInfo {
+    /**
+     * Provider-owned account authentication.
+     */
+    type: "account";
+    /**
+     * Host coordinate owned by the account's model provider.
+     */
+    host: string;
+    /**
+     * Login identifying the provider-owned account.
+     */
+    login: string;
+}
 /**
  * Authentication-info input variant for GitHub CLI credentials, carrying host, login, and the `gh auth token` value.
  *
@@ -7121,6 +7160,28 @@ export interface AuthIdentityMetadata {
      */
     login: string;
 }
+/**
+ * A credential-free account choice after sign-in.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "AuthLoginAccount".
+ */
+/** @experimental */
+export interface AuthLoginAccount {
+    /**
+     * Opaque identifier supplied to the next login step to select this account.
+     */
+    selectionId: string;
+    /**
+     * Host coordinate owned by the selected account's provider.
+     */
+    host: string;
+    /**
+     * Human-readable login for the account choice.
+     */
+    login: string;
+    kind: AccountKind;
+}
 /**
  * Advance an in-flight login flow, optionally fulfilling an input-required step.
  *
@@ -7163,7 +7224,7 @@ export interface AuthLoginBegun {
     step: AuthLoginStep;
 }
 /**
- * Terminal result of an interactive login flow.
+ * Result of an interactive login flow. Pending consent or account selection is not terminal.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "AuthLoginResultDto".
@@ -7179,6 +7240,10 @@ export interface AuthLoginResultDto {
      * Login that was signed in, when completed.
      */
     login?: string;
+    /**
+     * Available accounts when sign-in is awaiting account selection, ordered with Microsoft 365 first.
+     */
+    accounts?: AuthLoginAccount[];
 }
 /**
  * Cancel an in-flight login flow.
@@ -9408,6 +9473,146 @@ export interface ConnectorDisconnectResult {
     disconnected: boolean;
     status: ConnectorStatus;
 }
+/**
+ * Eligible account.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectorDiscoveryAccount".
+ */
+/** @experimental */
+export interface ConnectorDiscoveryAccount {
+    /**
+     * Opaque account ID.
+     */
+    accountId: string;
+    authInfo: ConnectorDiscoveryAuthInfo;
+}
+/**
+ * Account metadata.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectorDiscoveryAuthInfo".
+ */
+/** @experimental */
+export interface ConnectorDiscoveryAuthInfo {
+    type: AuthInfoType;
+    /**
+     * Host.
+     */
+    host: string;
+    /**
+     * Login.
+     */
+    login: string;
+}
+/**
+ * Eligible accounts.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectorDiscoveryAccountList".
+ */
+/** @experimental */
+export interface ConnectorDiscoveryAccountList {
+    availability: ConnectorDiscoveryAvailability;
+    /**
+     * Eligible accounts.
+     */
+    accounts: ConnectorDiscoveryAccount[];
+}
+/**
+ * Selected account.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectorDiscoveryAccountRequest".
+ */
+/** @experimental */
+export interface ConnectorDiscoveryAccountRequest {
+    /**
+     * Opaque account ID.
+     */
+    accountId: string;
+}
+/**
+ * Feature availability.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectorDiscoveryCapabilities".
+ */
+/** @experimental */
+export interface ConnectorDiscoveryCapabilities {
+    /**
+     * API version.
+     */
+    apiVersion: number;
+    availability: ConnectorDiscoveryAvailability;
+    /**
+     * Whether accounts are selected by opaque ID.
+     */
+    opaqueAccountSelection: boolean;
+    /**
+     * Whether results are cached.
+     */
+    conditionalCache: boolean;
+}
+/**
+ * Entry.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectorDiscoveryCatalogEntry".
+ */
+/** @experimental */
+export interface ConnectorDiscoveryCatalogEntry {
+    /**
+     * Name.
+     */
+    name: string;
+    /**
+     * Display name.
+     */
+    displayName: string;
+    /**
+     * Description.
+     */
+    description?: string;
+    /**
+     * Logo.
+     */
+    logo?: string;
+    /**
+     * Tier.
+     */
+    tier?: string;
+    /**
+     * Release tag.
+     */
+    releaseTag?: string;
+    status: ConnectorCatalogStatus;
+}
+/**
+ * Entries for the selected account.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "ConnectorDiscoveryCatalogResult".
+ */
+/** @experimental */
+export interface ConnectorDiscoveryCatalogResult {
+    /**
+     * Opaque account ID.
+     */
+    accountId: string;
+    /**
+     * Revision.
+     */
+    revision: number;
+    /**
+     * Refresh time in Unix epoch milliseconds.
+     */
+    refreshedAtMs: number;
+    /**
+     * Entries.
+     */
+    connectors: ConnectorDiscoveryCatalogEntry[];
+}
 /**
  * Requests authoritative Connector-to-MCP reconciliation for the pinned account.
  *
@@ -11070,6 +11275,27 @@ export interface FolderTrustCheckResult {
      */
     trusted: boolean;
 }
+/**
+ * Owner, name, and host of a GitHub repository, as resolved from a git remote URL.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "GitHubRepositoryIdentity".
+ */
+/** @experimental */
+export interface GitHubRepositoryIdentity {
+    /**
+     * Repository owner login (user or organization).
+     */
+    owner: string;
+    /**
+     * Repository name, without the owner prefix or the `.git` suffix.
+     */
+    name: string;
+    /**
+     * Host the remote points at, for example `github.com` or a GitHub Enterprise hostname.
+     */
+    host: string;
+}
 /**
  * Client environment metadata describing the process that produced a telemetry event.
  *
@@ -14268,6 +14494,64 @@ export interface McpConfigUpdateRequest {
     name: string;
     config: McpSerializableServerConfig;
 }
+/**
+ * Effective MCP configuration entry. Configuration enablement is distinct from the optional live observation.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpConfiguredServer".
+ */
+/** @experimental */
+export interface McpConfiguredServer {
+    /**
+     * Server name (config key)
+     */
+    name: string;
+    /**
+     * Whether this configured server is enabled after session configuration and policy filtering.
+     */
+    enabled: boolean;
+    source?: McpServerSource;
+    /**
+     * Plugin name that provided this server, when source is plugin.
+     */
+    sourcePlugin?: string;
+    /**
+     * Plugin version that provided this server, when source is plugin.
+     */
+    sourcePluginVersion?: string;
+    /**
+     * Human-readable display name supplied by configuration.
+     */
+    displayName?: string;
+    live?: McpConfiguredServerState;
+}
+/**
+ * Observational state for a matching already materialized MCP server.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpConfiguredServerState".
+ */
+/** @experimental */
+export interface McpConfiguredServerState {
+    status: McpServerStatus;
+    /**
+     * Observed connection error, when the materialized server failed.
+     */
+    error?: string;
+}
+/**
+ * Effective MCP configuration with optional live observations from matching already materialized servers.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "McpConfiguredServerList".
+ */
+/** @experimental */
+export interface McpConfiguredServerList {
+    /**
+     * Effective configured MCP servers.
+     */
+    servers: McpConfiguredServer[];
+}
 /**
  * Result of configuring GitHub MCP.
  *
@@ -22045,6 +22329,23 @@ export interface SessionBulkDeleteResult {
         [k: string]: number | undefined;
     };
 }
+/**
+ * The IDE a host is connected to, as reported to the session.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionConnectedIdeInfo".
+ */
+/** @experimental */
+export interface SessionConnectedIdeInfo {
+    /**
+     * Display name of the connected IDE, for example `VS Code`.
+     */
+    ideName: string;
+    /**
+     * Absolute path of the workspace folder the IDE has open.
+     */
+    workspaceFolder: string;
+}
 /**
  * The enriched metadata records, with summary and context fields backfilled where available. Sessions confirmed empty and unnamed are omitted.
  *
@@ -22887,6 +23188,19 @@ export interface SessionManagedPermissions {
 export interface SessionManagedSettings {
     permissions?: SessionManagedPermissions;
 }
+/**
+ * Records which IDE the host is connected to, or clears it.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionMcpSetConnectedIdeInfoParams".
+ */
+/** @experimental */
+export interface SessionMcpSetConnectedIdeInfoParams {
+    /**
+     * The connected IDE. Null or omitted clears the recorded IDE, which is how a host reports that it is disconnected.
+     */
+    ide?: SessionConnectedIdeInfo | null;
+}
 /**
  * Point-in-time snapshot of slow-changing session identifier and state fields
  *
@@ -23721,6 +24035,90 @@ export interface SessionsCloseRequest {
 /** @experimental */
 export interface SessionsCloseResult {
 }
+/**
+ * Identity, state location and starting context for a workspace record.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionsCreateWorkspaceRequest".
+ */
+/** @experimental */
+export interface SessionsCreateWorkspaceRequest {
+    /**
+     * Session ID the workspace record belongs to
+     */
+    sessionId: string;
+    /**
+     * Directory the session's state is written under when no session filesystem provider is configured. Ignored when a provider is configured; the provider's session state path is used instead.
+     */
+    sessionStatePath: string;
+    /**
+     * `windows` (any letter case) selects Windows path rules. Any other value selects POSIX path rules.
+     */
+    convention: string;
+    context?: SessionWorkingDirectoryContextWithClient;
+    /**
+     * User-supplied display name for the workspace
+     */
+    name?: string;
+}
+/**
+ * A working-directory context together with the client that produced it.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionWorkingDirectoryContextWithClient".
+ */
+/** @experimental */
+export interface SessionWorkingDirectoryContextWithClient {
+    /**
+     * Current working directory path
+     */
+    cwd: string;
+    /**
+     * Root directory of the git repository
+     */
+    gitRoot?: string;
+    /**
+     * Repository identifier derived from the git remote URL
+     */
+    repository?: string;
+    /**
+     * Hosting platform type of the repository
+     */
+    hostType?: string;
+    /**
+     * Current git branch name
+     */
+    branch?: string;
+    /**
+     * Raw host string from the git remote URL
+     */
+    repositoryHost?: string;
+    /**
+     * Head commit of the current git branch
+     */
+    headCommit?: string;
+    /**
+     * Merge-base commit SHA
+     */
+    baseCommit?: string;
+    /**
+     * Name of the client that created the session
+     */
+    clientName?: string;
+}
+/**
+ * The workspace record that was written.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionsCreateWorkspaceResult".
+ */
+/** @experimental */
+export interface SessionsCreateWorkspaceResult {
+    /**
+     * The created workspace record, as JSON
+     */
+    workspaceJson: string;
+}
 /**
  * Session ID to delete from disk.
  *
@@ -24348,6 +24746,36 @@ export interface SessionsLoadDeferredRepoHooksRequest {
      */
     sessionId: string;
 }
+/**
+ * Where the session's state lives, as a root directory and the session ID under it.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionsLoadWorkspaceRequest".
+ */
+/** @experimental */
+export interface SessionsLoadWorkspaceRequest {
+    /**
+     * Root directory every session's state directory sits under
+     */
+    sessionsHome: string;
+    /**
+     * Session ID naming the state directory under the sessions home. Rejected when it is absolute or contains a parent component, so it cannot escape the sessions home.
+     */
+    sessionId: string;
+}
+/**
+ * The workspace record on disk, omitted when the session has none.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionsLoadWorkspaceResult".
+ */
+/** @experimental */
+export interface SessionsLoadWorkspaceResult {
+    /**
+     * The workspace record, as JSON. Omitted when the record does not exist.
+     */
+    workspaceJson?: string;
+}
 /**
  * Age threshold and optional flags controlling which old sessions are pruned (or simulated when dryRun is true).
  *
@@ -24542,6 +24970,36 @@ export interface SessionsTransferRemoteControlRequest {
      */
     expectedFromSessionId?: string;
 }
+/**
+ * Where the session's state lives, plus workspace-schema fields to merge into its workspace record. Stored keys outside the schema are not preserved, and a stored `fork_count` is never replaced.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionsUpdateWorkspaceFieldsRequest".
+ */
+/** @experimental */
+export interface SessionsUpdateWorkspaceFieldsRequest {
+    /**
+     * Root directory every session's state directory sits under
+     */
+    sessionsHome: string;
+    /**
+     * Session ID naming the state directory under the sessions home. Rejected when it is absolute or contains a parent component, so it cannot escape the sessions home.
+     */
+    sessionId: string;
+    /**
+     * Workspace-schema fields to merge into the record, as a JSON object. Fields the object omits keep their stored values, except stored keys outside the schema are not preserved and a stored `fork_count` is never replaced.
+     */
+    fieldsJson: string;
+}
+/**
+ * The merge completed. The record carries the supplied workspace-schema fields, but a stored `fork_count` stays.
+ *
+ * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
+ * via the `definition` "SessionsUpdateWorkspaceFieldsResult".
+ */
+/** @experimental */
+export interface SessionsUpdateWorkspaceFieldsResult {
+}
 /**
  * Telemetry engagement ID for the session, when available.
  *
@@ -25143,7 +25601,7 @@ export interface SkillPlanUninstallRequest {
     policySessionId: string;
 }
 /**
- * Catalog-only metadata for one SDK-provided skill. The complete SKILL.md is fetched separately and lazily.
+ * Authoritative catalog metadata for one SDK-provided skill. The skill's SKILL.md text is fetched separately and lazily.
  *
  * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema
  * via the `definition` "SkillProviderDescriptor".
@@ -30570,6 +31028,37 @@ export declare function createServerRpc(connection: MessageConnection): {
          */
         spawn: (params: AgentRegistrySpawnRequest) => Promise<AgentRegistrySpawnResult>;
     };
+    /** @experimental */
+    connectors: {
+        /**
+         * Returns feature availability.
+         *
+         * @returns Feature availability.
+         */
+        getCapabilities: () => Promise<ConnectorDiscoveryCapabilities>;
+        /**
+         * Returns eligible accounts.
+         *
+         * @returns Eligible accounts.
+         */
+        getAccounts: () => Promise<ConnectorDiscoveryAccountList>;
+        /**
+         * Lists entries for the selected account.
+         *
+         * @param params Selected account.
+         *
+         * @returns Entries for the selected account.
+         */
+        list: (params: ConnectorDiscoveryAccountRequest) => Promise<ConnectorDiscoveryCatalogResult>;
+        /**
+         * Refreshes entries for the selected account.
+         *
+         * @param params Selected account.
+         *
+         * @returns Entries for the selected account.
+         */
+        refresh: (params: ConnectorDiscoveryAccountRequest) => Promise<ConnectorDiscoveryCatalogResult>;
+    };
 };
 /** Create typed session-scoped RPC methods. */
 export declare function createSessionRpc(connection: MessageConnection, sessionId: string): {
@@ -31428,11 +31917,17 @@ export declare function createSessionRpc(connection: MessageConnection, sessionI
     /** @experimental */
     mcp: {
         /**
-         * Lists MCP servers configured for the session, their connection status, and host-level state. The host-level state (disabled/filtered servers, failed/needs-auth/pending connections, mcp3p policy, full config) is empty/zero when no MCP host has been initialized for the session.
+         * Lists materialized MCP servers and their connection status. Cache misses may start and wait for MCP servers.
          *
          * @returns MCP servers configured for the session, with their connection status and host-level state.
          */
         list: () => Promise<McpServerList>;
+        /**
+         * Lists effective MCP configuration without starting, restarting, authenticating, or waiting for servers. An optional live observation is from an already materialized matching server; this is not a readiness guarantee.
+         *
+         * @returns Effective MCP configuration with optional live observations from matching already materialized servers.
+         */
+        listConfigured: () => Promise<McpConfiguredServerList>;
         /**
          * Lists the tools exposed by a connected MCP server on this session's host. This performs a live `tools/list` request. Tool UI metadata is returned independently of whether MCP Apps rendering is enabled for the session.
          *