diff --git a/dotnet/src/Generated/Rpc.cs b/dotnet/src/Generated/Rpc.cs index 81cd4e6da8..774df7a0ed 100644 --- a/dotnet/src/Generated/Rpc.cs +++ b/dotnet/src/Generated/Rpc.cs @@ -667,6 +667,14 @@ public sealed class CopilotUserResponseEndpoints public string? Telemetry { get; set; } } +/// RPC data type for CopilotUserResponseEnterpriseList operations. +public sealed class CopilotUserResponseEnterpriseList +{ + /// Numeric database ID of the enterprise. + [JsonPropertyName("id")] + public long Id { get; set; } +} + /// RPC data type for CopilotUserResponseOrganizationListItem operations. public sealed class CopilotUserResponseOrganizationListItem { @@ -911,6 +919,10 @@ public sealed class CopilotUserResponse [JsonPropertyName("endpoints")] public CopilotUserResponseEndpoints? Endpoints { get; set; } + /// Enterprises that provide the user's Copilot license, each with a stable numeric ID. + [JsonPropertyName("enterprise_list")] + public IList? EnterpriseList { get; set; } + /// Whether MCP (Model Context Protocol) support is enabled for the user. [JsonPropertyName("is_mcp_enabled")] public bool? IsMcpEnabled { get; set; } @@ -1420,7 +1432,7 @@ public partial class McpPlanInstallResult [Experimental(Diagnostics.Experimental)] public sealed class CatalogNegotiatedContract { - /// Wire features the runtime understood for this operation. Always a superset of the caller's required features, because any shortfall is a refusal instead. Operation availability remains a separate typed result. + /// Wire features the runtime understood for this operation. Includes the five original catalog capabilities and only explicitly requested supported additions, in supported order without duplicates. Capabilities that introduce new success-union variants or operations are therefore included only when explicitly required, preserving older protocol-v3 clients. Always a superset of the caller's required features, because any shortfall is a refusal instead. Operation availability remains a separate typed result. [JsonPropertyName("grantedCapabilities")] public IList GrantedCapabilities { get => field ??= []; set; } @@ -1429,7 +1441,7 @@ public sealed class CatalogNegotiatedContract public long RuntimeProtocolVersion { get; set; } } -/// One change applying the plan would make, described rather than serialised so the configuration payload stays behind the runtime boundary. +/// The configuration-change alternative for the transportChoices entry at the same index. Only the selected alternative is applied; entries are not cumulative. The payload stays behind the runtime boundary. [Experimental(Diagnostics.Experimental)] public sealed class McpPlanConfigurationChange { @@ -1797,7 +1809,7 @@ public partial class McpPlanTransportChoiceRemote : McpPlanTransportChoice [Experimental(Diagnostics.Experimental)] public sealed class McpInstallPlan { - /// The configuration changes installing would make, described rather than serialised, so the mutable configuration payload stays behind the runtime boundary. + /// Alternative configuration changes, with exactly one entry for each transportChoices entry in the same order. Only the entry for the subsequently selected transport applies; these are not cumulative writes. Payloads remain behind the runtime boundary. [JsonPropertyName("configurationChanges")] public IList ConfigurationChanges { get => field ??= []; set; } @@ -1831,7 +1843,7 @@ public sealed class McpInstallPlan [JsonPropertyName("reloadRequired")] public bool ReloadRequired { get; set; } - /// Whether the plan cannot be applied without further input, because a required value has no default or a secret must be supplied. + /// True only when every eligible transport choice needs additional values or secrets. False means at least one choice needs no additional configuration, not that every choice is ready. A later apply operation must validate the selected choice's own inputs, secrets and policy after explicit confirmation. [JsonPropertyName("requiresInteractiveConfiguration")] public bool RequiresInteractiveConfiguration { get; set; } @@ -1922,7 +1934,7 @@ public partial class McpPlanInstallResultHandleRejected : McpPlanInstallResult public required CatalogHandleRejectionReason Reason { get; set; } } -/// The request was rejected before any work was done, because a bounded field fell outside its permitted range or a required field was unusable. +/// The request was rejected because a bounded field fell outside its permitted range or a required field was unusable. Pagination may also be rejected by the authority after a continuation request; repeat the search without page. /// The invalid-request variant of . [Experimental(Diagnostics.Experimental)] public partial class McpPlanInstallResultInvalidRequest : McpPlanInstallResult @@ -2182,7 +2194,7 @@ public partial class McpPlanInstallSourceCandidate : McpPlanInstallSource [JsonPropertyName("candidateHandle")] public required string CandidateHandle { get; set; } - /// The runtime- or authority-minted `searchId` returned with the search that produced this candidate. A search implementation binds it to private candidate-handle context; a planning implementation must verify that context before returning a plan. The unavailable planning implementation in this contract layer validates presence but does not claim the verification has occurred. It identifies a search rather than a person and must never be joined with user identity to re-identify anyone. + /// The runtime- or authority-minted `searchId` returned with the search that produced this candidate. Planning verifies the private correlation and atomically consumes a matching candidate before downstream work, including attempts that subsequently fail or report unavailable. A mismatched search does not consume the candidate. It identifies a search rather than a person and must never be joined with user identity to re-identify anyone. [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] [MinLength(1)] [MaxLength(64)] @@ -2448,7 +2460,7 @@ public partial class CatalogSearchResult } -/// One inert catalog result, represented as an MCP server or discovery-only AI skill variant so kind, media type, provenance, and installability cannot contradict each other. +/// One inert catalog result, represented as an MCP server, discovery-only AI skill, or opt-in Agent Plugin variant so kind, media type, provenance, and available operations cannot contradict each other. /// Polymorphic base type discriminated by kind. [Experimental(Diagnostics.Experimental)] [JsonPolymorphic( @@ -2456,6 +2468,7 @@ public partial class CatalogSearchResult UnknownDerivedTypeHandling = JsonUnknownDerivedTypeHandling.FallBackToBaseType)] [JsonDerivedType(typeof(CatalogCandidateMcpServer), "mcp-server")] [JsonDerivedType(typeof(CatalogCandidateAiSkill), "ai-skill")] +[JsonDerivedType(typeof(CatalogCandidatePlugin), "plugin")] public partial class CatalogCandidate { /// The type discriminator. @@ -2793,7 +2806,7 @@ public sealed class CatalogAiSkillCandidateProvenance /// Media type advertised for the referenced AI skill card. [JsonPropertyName("mediaType")] - public string MediaType { get; set; } = string.Empty; + public CatalogAiSkillMediaType MediaType { get; set; } /// ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a retrieval or validation timestamp. [JsonPropertyName("observedAt")] @@ -2834,11 +2847,11 @@ public partial class CatalogCandidateAiSkill : CatalogCandidate /// AI skills are discovery-only and cannot be installed through this surface. [JsonPropertyName("installability")] - public required string Installability { get; set; } + public required CatalogAiSkillInstallability Installability { get; set; } /// Media type of the underlying AI skill card. [JsonPropertyName("mediaType")] - public required string MediaType { get; set; } + public required CatalogAiSkillMediaType MediaType { get; set; } /// Where the catalog reference was observed, without the card itself or any content digest. [JsonPropertyName("provenance")] @@ -2861,7 +2874,146 @@ public partial class CatalogCandidateAiSkill : CatalogCandidate public CatalogTrustSnapshot? Trust { get; set; } } -/// A completed catalog search: inert candidate summaries, each carrying a single-use handle. +/// Where and when an Agent Plugin catalog reference was observed. Discovery provenance deliberately carries no descriptor URL, raw data, candidate handle, or content digest. +[Experimental(Diagnostics.Experimental)] +public sealed class CatalogAgentPluginCandidateProvenance +{ + /// Host of the catalog authority that advertised the reference, without path, query, or credentials. Inert untrusted data. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [JsonPropertyName("authority")] + public string Authority { get; set; } = string.Empty; + + /// Canonical Agent Plugin media type. + [JsonPropertyName("mediaType")] + public CatalogAgentPluginMediaType MediaType { get; set; } + + /// ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a retrieval or validation timestamp. + [JsonPropertyName("observedAt")] + public string ObservedAt { get; set; } = string.Empty; +} + +/// Syntactically validated GitHub repository provenance declared by catalog metadata. This is a source claim rather than proof that the descriptor URL resolves to the repository. +[Experimental(Diagnostics.Experimental)] +public sealed class CatalogPluginRepositorySource +{ + /// Case-preserving safe relative POSIX path derived from metadata.repoPath. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(256)] + [JsonPropertyName("path")] + public string Path { get; set; } = string.Empty; + + /// Canonical lowercase owner/repository name derived from metadata.sourceSet. + [RegularExpression("^[a-z0-9_.-]+/[a-z0-9_.-]+$")] + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(3)] + [MaxLength(256)] + [JsonPropertyName("repository")] + public string Repository { get; set; } = string.Empty; +} + +/// An inert Agent Plugin catalog result. Its canonical catalog identity, declared version, repository source claim, and explicit compatibility tags are safe to correlate, while its descriptor, URL, raw data, and installed-plugin state remain runtime-private. This contract-only variant does not mint or expose a candidate handle. +/// The plugin variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogCandidatePlugin : CatalogCandidate +{ + /// + [JsonIgnore] + public override string Kind => "plugin"; + + /// Explicit validated compatibility tags, in canonical order. An empty list means the source declared no recognised compatibility; clients must not infer compatibility from other fields. `canvas-only` requires both `canvas` and `github-copilot`. + [JsonPropertyName("compatibilityTags")] + public required IList CompatibilityTags { get; set; } + + /// Description taken verbatim from the card. Inert untrusted text. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("description")] + public string? Description { get; set; } + + /// Display name taken verbatim from the card. Inert untrusted text. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(200)] + [JsonPropertyName("displayName")] + public required string DisplayName { get; set; } + + /// Validated, normalised catalogue resource URN. This identity comes only from the catalog identifier and is never inferred from display text or installed-plugin state. + [JsonPropertyName("identity")] + public required string Identity { get; set; } + + /// Canonical Agent Plugin media type. + [JsonPropertyName("mediaType")] + public required CatalogAgentPluginMediaType MediaType { get; set; } + + /// Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw data, or content digest. + [JsonPropertyName("provenance")] + public required CatalogAgentPluginCandidateProvenance Provenance { get; set; } + + /// Publisher taken verbatim from the card. Inert untrusted text. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(200)] + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("publisher")] + public string? Publisher { get; set; } + + /// Bounded repository provenance declared through the catalog's sourceSet and repoPath metadata. It contains no descriptor URL. + [JsonPropertyName("source")] + public required CatalogPluginRepositorySource Source { get; set; } + + /// Versioned trust metadata observed from the catalog authority. Optional for protocol-3 compatibility and emitted only when the caller also requires the trust-snapshot capability. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("trust")] + public CatalogTrustSnapshot? Trust { get; set; } + + /// Optional version declared by the catalog source. Omitted rather than guessed when the source supplies no version. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("version")] + public string? Version { get; set; } +} + +/// Authority-reported navigation metadata, returned only to callers requiring catalog-search-pagination and only when a supported token is present. Tokenless first-page and continuation responses omit this object; no counts are inferred from candidates. The opaque token may be retained for previous or numbered navigation even when hasNextPage is false. +[Experimental(Diagnostics.Experimental)] +public sealed class CatalogSearchPagination +{ + /// One-based page returned by the authority. + [JsonPropertyName("currentPage")] + public int CurrentPage { get; set; } + + /// Whether the authority token advertises a valid next target within the navigation window. Not inferred from token presence, truncated, or currentPage being less than pageCount. + [JsonPropertyName("hasNextPage")] + public bool HasNextPage { get; set; } + + /// Navigation window ceiling ceil(1000 / pageSize), not the number of existing pages. Legal targets must not exceed this ceiling or the token's signed pageCount. + [JsonPropertyName("maxPage")] + public int MaxPage { get; set; } + + /// Backend-reported page count, which may exceed maxPage. Present pagination metadata always describes a multi-page result; zero- and single-page responses omit pagination. Navigation targets must also be within the signed pageCount carried by the supplied token. + [JsonPropertyName("pageCount")] + public long PageCount { get; set; } + + /// Page size bound to the search, equal to the effective request limit. + [JsonPropertyName("pageSize")] + public int PageSize { get; set; } + + /// Opaque authority-issued pagination token. Only the runtime decodes it or changes targetPage; SDK consumers must not decode, modify or log it. It has no runtime-created expiry or cache. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(4096)] + [JsonPropertyName("token")] + public string Token { get; set; } = string.Empty; + + /// Backend-reported count for this response, not the number of returned candidates. Its relationship to the full query result set is unknown. + [JsonPropertyName("totalCount")] + public long TotalCount { get; set; } + + /// The relationship of totalCount to the complete query result set is unknown; neither exactness nor a lower-bound guarantee is implied. + [JsonPropertyName("totalCountRelation")] + public CatalogSearchTotalCountRelation TotalCountRelation { get; set; } +} + +/// A completed catalog search containing inert candidate summaries. MCP server and AI skill variants carry a single-use handle; the Agent Plugin variant is handleless. /// The succeeded variant of . [Experimental(Diagnostics.Experimental)] public partial class CatalogSearchResultSucceeded : CatalogSearchResult @@ -2878,6 +3030,11 @@ public partial class CatalogSearchResultSucceeded : CatalogSearchResult [JsonPropertyName("negotiated")] public required CatalogNegotiatedContract Negotiated { get; set; } + /// Navigation metadata for callers explicitly requiring catalog-search-pagination. Omitted when the authority returns no token, including tokenless first-page and continuation responses. Counts are never substituted from candidates.length. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("pagination")] + public CatalogSearchPagination? Pagination { get; set; } + /// Pseudonymous identifier for this search, issued by the runtime or by the catalog authority it queried and never by the caller, so it cannot be forged or replayed to attribute an install to a search that never happened. Always present on a success, so a result set can be tied to the installs it leads to. It identifies a search rather than a person: it is derived from no user, account, device, or query data, and must never be joined with user identity to re-identify anyone. [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] [MinLength(1)] @@ -2885,7 +3042,7 @@ public partial class CatalogSearchResultSucceeded : CatalogSearchResult [JsonPropertyName("searchId")] public required string SearchId { get; set; } - /// Whether further matches existed beyond the requested limit. + /// Legacy indication that the authority returned a page token. Preserved for compatibility; this is not a has-next-page indicator. Use pagination.hasNextPage when pagination metadata is present. [JsonPropertyName("truncated")] public required bool Truncated { get; set; } } @@ -2950,7 +3107,7 @@ public partial class CatalogSearchResultUnsupportedKind : CatalogSearchResult public required IList SupportedKinds { get; set; } } -/// The request was rejected before any work was done, because a bounded field fell outside its permitted range or a required field was unusable. +/// The request was rejected because a bounded field fell outside its permitted range or a required field was unusable. Pagination may also be rejected by the authority after a continuation request; repeat the search without page. /// The invalid-request variant of . [Experimental(Diagnostics.Experimental)] public partial class CatalogSearchResultInvalidRequest : CatalogSearchResult @@ -3125,6 +3282,22 @@ public partial class CatalogSearchResultUnavailable : CatalogSearchResult public required CatalogUnavailableReason Reason { get; set; } } +/// An explicit numbered-page request. The SDK treats the token as opaque; only the runtime decodes it and changes its targetPage. Authority validation binds navigation to the original search. No snapshot stability or token TTL is promised. +[Experimental(Diagnostics.Experimental)] +public sealed class CatalogSearchPage +{ + /// Requested one-based page. Must not exceed either the token's signed pageCount or the navigation window ceil(1000 / pageSize). Repeat the search without page to discover newly available pages beyond that signed pageCount. + [JsonPropertyName("number")] + public int Number { get; set; } + + /// Opaque authority-issued pagination token from an earlier response. Never decode, modify or log it in an SDK consumer. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(4096)] + [JsonPropertyName("token")] + public string Token { get; set; } = string.Empty; +} + /// A bounded catalog search. Both the query length and the result count are capped by the schema so a caller cannot request an unbounded scan. [Experimental(Diagnostics.Experimental)] internal sealed class CatalogSearchRequest @@ -3133,7 +3306,7 @@ internal sealed class CatalogSearchRequest [JsonPropertyName("contract")] public CatalogClientContract Contract { get => field ??= new(); set; } - /// Restrict results to these candidate kinds. When omitted, every kind the runtime supports is searched. + /// Restrict results to these candidate kinds. Agent Plugins are opt-in and require the `agent-plugin-discovery` capability so protocol-v3 clients generated before that variant cannot receive an unknown result; when omitted, the backwards-compatible MCP server and AI skill kinds are searched. [JsonPropertyName("kinds")] public IList? Kinds { get; set; } @@ -3141,6 +3314,10 @@ internal sealed class CatalogSearchRequest [JsonPropertyName("limit")] public int? Limit { get; set; } + /// Numbered navigation using metadata from an earlier response. Requires catalog-search-pagination and the same query, kinds and effective limit. Omit for a fresh first-page search. + [JsonPropertyName("page")] + public CatalogSearchPage? Page { get; set; } + /// Free-text search query. Persisted as tool input for session continuity, but omitted from telemetry. [RegularExpression("\\S")] [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] @@ -3150,6 +3327,290 @@ internal sealed class CatalogSearchRequest public string Query { get; set; } = string.Empty; } +/// Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId. +/// Polymorphic base type discriminated by kind. +[Experimental(Diagnostics.Experimental)] +[JsonPolymorphic( + TypeDiscriminatorPropertyName = "kind", + UnknownDerivedTypeHandling = JsonUnknownDerivedTypeHandling.FallBackToBaseType)] +[JsonDerivedType(typeof(CatalogSelectionResultSelected), "selected")] +[JsonDerivedType(typeof(CatalogSelectionResultDeclined), "declined")] +[JsonDerivedType(typeof(CatalogSelectionResultCancelled), "cancelled")] +[JsonDerivedType(typeof(CatalogSelectionResultTimedOut), "timed-out")] +[JsonDerivedType(typeof(CatalogSelectionResultInvalid), "invalid")] +[JsonDerivedType(typeof(CatalogSelectionResultStale), "stale")] +[JsonDerivedType(typeof(CatalogSelectionResultReplayed), "replayed")] +[JsonDerivedType(typeof(CatalogSelectionResultForeign), "foreign")] +[JsonDerivedType(typeof(CatalogSelectionResultWrongKind), "wrong-kind")] +[JsonDerivedType(typeof(CatalogSelectionResultNegotiationRefused), "negotiation-refused")] +[JsonDerivedType(typeof(CatalogSelectionResultInvalidRequest), "invalid-request")] +[JsonDerivedType(typeof(CatalogSelectionResultUnavailable), "unavailable")] +public partial class CatalogSelectionResult +{ + /// The type discriminator. + [JsonPropertyName("kind")] + public virtual string Kind { get; set; } = string.Empty; +} + + +/// The chosen candidate was transferred into a fresh bounded single-use handle for a later explicit planning request. +/// The selected variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultSelected : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "selected"; + + /// Fresh single-use candidate handle accepted by mcp.planInstall. Returned only to the native host and never included in model-tool output. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(256)] + [JsonPropertyName("candidateHandle")] + public required string CandidateHandle { get; set; } + + /// The exact search identifier privately bound to the selected candidate. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(64)] + [JsonPropertyName("searchId")] + public required string SearchId { get; set; } +} + +/// The caller explicitly declined every candidate and the retained search state was released. +/// The declined variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultDeclined : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "declined"; + + /// The search identifier privately bound to the released selection group. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(64)] + [JsonPropertyName("searchId")] + public required string SearchId { get; set; } +} + +/// The caller cancelled the selection interaction and the retained search state was released. +/// The cancelled variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultCancelled : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "cancelled"; + + /// The search identifier privately bound to the released selection group. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(64)] + [JsonPropertyName("searchId")] + public required string SearchId { get; set; } +} + +/// The host declared that its live selection interaction timed out, and the retained search state was released. +/// The timed-out variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultTimedOut : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "timed-out"; + + /// The search identifier privately bound to the released selection group. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(64)] + [JsonPropertyName("searchId")] + public required string SearchId { get; set; } +} + +/// The selection reference was malformed or unknown. +/// The invalid variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultInvalid : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "invalid"; + + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonPropertyName("message")] + public required string Message { get; set; } +} + +/// The runtime-enforced selection reference lifetime elapsed before the request arrived. +/// The stale variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultStale : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "stale"; + + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonPropertyName("message")] + public required string Message { get; set; } +} + +/// The selection group was already terminated or its pending host hand-off was already claimed. +/// The replayed variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultReplayed : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "replayed"; + + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonPropertyName("message")] + public required string Message { get; set; } +} + +/// The selection reference belongs to another runtime instance or session. +/// The foreign variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultForeign : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "foreign"; + + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonPropertyName("message")] + public required string Message { get; set; } +} + +/// The presented opaque handle was issued for another catalog operation. +/// The wrong-kind variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultWrongKind : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "wrong-kind"; + + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonPropertyName("message")] + public required string Message { get; set; } +} + +/// The caller's protocol version or required capabilities cannot be honoured. Returned instead of a partial or ambiguous success. +/// The negotiation-refused variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultNegotiationRefused : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "negotiation-refused"; + + /// Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonPropertyName("message")] + public required string Message { get; set; } + + /// Lowest caller protocol version this runtime will serve. + [JsonPropertyName("minimumSupportedProtocolVersion")] + public required long MinimumSupportedProtocolVersion { get; set; } + + /// Whether the version or the capability set was the problem. + [JsonPropertyName("reason")] + public required CatalogNegotiationRefusedReason Reason { get; set; } + + /// Protocol version of the runtime that refused the request. + [JsonPropertyName("runtimeProtocolVersion")] + public required long RuntimeProtocolVersion { get; set; } + + /// Capabilities this runtime can safely advertise to this caller. The complete five-capability protocol-3 legacy set is always present; every capability added after that baseline appears only when the caller required it, so an older closed-enum decoder can still consume a refusal. This list does not imply that every deployment has enabled every operation. + [JsonPropertyName("supportedCapabilities")] + public required IList SupportedCapabilities { get; set; } + + /// The subset of the caller's bounded extensible capability identifiers this runtime cannot honour. + [JsonPropertyName("unsupportedCapabilities")] + public required IList UnsupportedCapabilities { get; set; } +} + +/// The request was rejected because a bounded field fell outside its permitted range or a required field was unusable. Pagination may also be rejected by the authority after a continuation request; repeat the search without page. +/// The invalid-request variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultInvalidRequest : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "invalid-request"; + + /// Which request field was rejected. + [JsonPropertyName("field")] + public required CatalogInvalidRequestField Field { get; set; } + + /// Human-readable explanation, safe to surface. Never echoes the offending value, nor a query, URL, handle, or secret. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonPropertyName("message")] + public required string Message { get; set; } +} + +/// The operation is not available on this runtime. Distinct from a network failure: nothing was attempted. +/// The unavailable variant of . +[Experimental(Diagnostics.Experimental)] +public partial class CatalogSelectionResultUnavailable : CatalogSelectionResult +{ + /// + [JsonIgnore] + public override string Kind => "unavailable"; + + /// Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MaxLength(1000)] + [JsonPropertyName("message")] + public required string Message { get; set; } + + /// Why the operation is unavailable. + [JsonPropertyName("reason")] + public required CatalogUnavailableReason Reason { get; set; } +} + +/// Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection. +[Experimental(Diagnostics.Experimental)] +internal sealed class CatalogSelectionRequest +{ + /// Protocol version and capabilities the caller requires. + [JsonPropertyName("contract")] + public CatalogClientContract Contract { get => field ??= new(); set; } + + /// The terminal outcome declared by the caller. Timed-out means the host's live interaction deadline elapsed; a reference whose runtime TTL elapsed is rejected separately as stale. + [JsonPropertyName("outcome")] + public CatalogSelectionDecision Outcome { get; set; } + + /// Opaque runtime-instance scoped reference to one visible candidate. For a non-selected outcome, any candidate reference from the same search closes that search's retained group. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(256)] + [JsonPropertyName("selectionRef")] + public string SelectionRef { get; set; } = string.Empty; + + /// Locally owned root session whose retained search state is being resolved. + [UnconditionalSuppressMessage("Trimming", "IL2026", Justification = "Safe for generated string properties: JSON Schema minLength/maxLength map to string length validation, not reflection over trimmed Count members")] + [MinLength(1)] + [MaxLength(256)] + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + /// Information about an installed plugin tracked in global state. [Experimental(Diagnostics.Experimental)] public sealed class InstalledPluginInfo @@ -3162,10 +3623,22 @@ public sealed class InstalledPluginInfo [JsonPropertyName("enabled")] public bool Enabled { get; set; } + /// Whether the managed desired plugin currently has an installed or live record. Set to false for a managed desired entry retained in the listing after installation or reconciliation failed. + [JsonPropertyName("installed")] + public bool? Installed { get; set; } + /// Absolute path of the marketplace directory a live plugin was resolved from. Present only on live, never-persisted records — a plugin belonging to a directory/local marketplace, which is loaded from its real directory on every pass instead of a copy under the installed-plugins cache. Its presence is what marks a listed plugin as live: such a plugin is always present on disk, so `enabled` is its only meaningful state and it is never "not installed". [JsonPropertyName("installedFrom")] public string? InstalledFrom { get; set; } + /// Whether enterprise managed settings control this plugin's enabled state. + [JsonPropertyName("managed")] + public bool? Managed { get; set; } + + /// The enabled state required by enterprise managed settings, when this plugin spec is managed. + [JsonPropertyName("managedDesiredEnabled")] + public bool? ManagedDesiredEnabled { get; set; } + /// Marketplace the plugin came from. Empty string ("") for direct repo / URL / local installs. [JsonPropertyName("marketplace")] public string Marketplace { get; set; } = string.Empty; @@ -3350,10 +3823,18 @@ internal sealed class PluginsBuiltinSetRequest [Experimental(Diagnostics.Experimental)] public sealed class MarketplaceInfo { + /// Whether the managed marketplace currently resolved into the runtime marketplace registry. Set to false when the desired managed entry is retained for governance visibility after loading or reconciliation failed. + [JsonPropertyName("available")] + public bool? Available { get; set; } + /// True when this is a default marketplace shipped with the runtime. Defaults are not removable. [JsonPropertyName("isDefault")] public bool? IsDefault { get; set; } + /// Whether enterprise managed settings provide and control this marketplace entry. + [JsonPropertyName("managed")] + public bool? Managed { get; set; } + /// Marketplace name (matches the @marketplace suffix in plugin specs). [JsonPropertyName("name")] public string Name { get; set; } = string.Empty; @@ -4026,7 +4507,7 @@ public sealed class SessionFsSetProviderCapabilities public bool? Sqlite { get; set; } } -/// Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. +/// Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots. [Experimental(Diagnostics.Experimental)] internal sealed class SessionFsSetProviderRequest { @@ -4038,7 +4519,7 @@ internal sealed class SessionFsSetProviderRequest [JsonPropertyName("conventions")] public SessionFsSetProviderConventions Conventions { get; set; } - /// Initial working directory for sessions. + /// Absolute initial working directory for sessions. Registering the provider establishes this path as the root of its virtual namespace; the runtime does not require the provider to materialize or stat it before creating a session. [JsonPropertyName("initialCwd")] public string InitialCwd { get; set; } = string.Empty; @@ -7893,21 +8374,1115 @@ public sealed class FactoryAgentOptions public JsonElement? Schema { get; set; } } -/// Parameters for one factory-scoped subagent call. +/// Parameters for one factory-scoped subagent call. +[Experimental(Diagnostics.Experimental)] +internal sealed class FactoryAgentRequest +{ + /// Opaque token identifying the current factory execution attempt. + [JsonPropertyName("executionToken")] + public string ExecutionToken { get; set; } = string.Empty; + + /// Factory run identifier that owns the subagent. + [JsonPropertyName("factoryRunId")] + public string FactoryRunId { get; set; } = string.Empty; + + /// Subagent execution options. + [JsonPropertyName("opts")] + public FactoryAgentOptions Opts { get => field ??= new(); set; } + + /// Prompt to send to the subagent. + [JsonPropertyName("prompt")] + public string Prompt { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Result of reading a factory journal entry. +[Experimental(Diagnostics.Experimental)] +public sealed class FactoryJournalGetResult +{ + /// Whether the journal contained the requested key. + [JsonPropertyName("hit")] + public bool Hit { get; set; } + + /// Cached JSON result. The hit field distinguishes a cached JSON null from a miss. + [JsonPropertyName("resultJson")] + public JsonElement? ResultJson { get; set; } +} + +/// Parameters for reading a factory journal entry. +[Experimental(Diagnostics.Experimental)] +internal sealed class FactoryJournalGetRequest +{ + /// Opaque token identifying the current factory execution attempt. + [JsonPropertyName("executionToken")] + public string ExecutionToken { get; set; } = string.Empty; + + /// Namespaced journal key. + [JsonPropertyName("key")] + public string Key { get; set; } = string.Empty; + + /// Factory run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Parameters for storing a factory journal entry. +[Experimental(Diagnostics.Experimental)] +internal sealed class FactoryJournalPutRequest +{ + /// Opaque token identifying the current factory execution attempt. + [JsonPropertyName("executionToken")] + public string ExecutionToken { get; set; } = string.Empty; + + /// Namespaced journal key. + [JsonPropertyName("key")] + public string Key { get; set; } = string.Empty; + + /// JSON result to memoize. + [JsonPropertyName("resultJson")] + public JsonElement ResultJson { get; set; } + + /// Factory run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Machine-readable workflow run failure. +/// Polymorphic base type discriminated by type. +[Experimental(Diagnostics.Experimental)] +[JsonPolymorphic( + TypeDiscriminatorPropertyName = "type", + UnknownDerivedTypeHandling = JsonUnknownDerivedTypeHandling.FallBackToBaseType)] +[JsonDerivedType(typeof(WorkflowRunFailureWorkflowLimitReached), "workflow_limit_reached")] +[JsonDerivedType(typeof(WorkflowRunFailureWorkflowResumeDeclined), "workflow_resume_declined")] +[JsonDerivedType(typeof(WorkflowRunFailureWorkflowDurableFailure), "workflow_durable_failure")] +[JsonDerivedType(typeof(WorkflowRunFailureWorkflowAccountingIncomplete), "workflow_accounting_incomplete")] +[JsonDerivedType(typeof(WorkflowRunFailureWorkflowProviderDisconnected), "workflow_provider_disconnected")] +public partial class WorkflowRunFailure +{ + /// The type discriminator. + [JsonPropertyName("type")] + public virtual string Type { get; set; } = string.Empty; +} + + +/// The workflow_limit_reached variant of . +[Experimental(Diagnostics.Experimental)] +public partial class WorkflowRunFailureWorkflowLimitReached : WorkflowRunFailure +{ + /// + [JsonIgnore] + public override string Type => "workflow_limit_reached"; + + /// Resource ceiling that stopped the run. + [JsonPropertyName("kind")] + public required WorkflowRunFailureKind Kind { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public required string RunId { get; set; } + + /// Suggested larger ceiling when the runtime can derive one safely. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("suggestedValue")] + public double? SuggestedValue { get; set; } + + /// Approved effective ceiling that was reached. + [JsonPropertyName("value")] + public required double Value { get; set; } +} + +/// The workflow_resume_declined variant of . +[Experimental(Diagnostics.Experimental)] +public partial class WorkflowRunFailureWorkflowResumeDeclined : WorkflowRunFailure +{ + /// + [JsonIgnore] + public override string Type => "workflow_resume_declined"; + + /// Human-readable reason the resume did not proceed. + [JsonPropertyName("reason")] + public required string Reason { get; set; } + + /// Workflow run identifier whose changed limits were declined. + [JsonPropertyName("runId")] + public required string RunId { get; set; } +} + +/// The workflow_durable_failure variant of . +[Experimental(Diagnostics.Experimental)] +public partial class WorkflowRunFailureWorkflowDurableFailure : WorkflowRunFailure +{ + /// + [JsonIgnore] + public override string Type => "workflow_durable_failure"; + + /// Stable failure code. + [JsonPropertyName("code")] + public required string Code { get; set; } + + /// Execution-critical durable operation that failed. + [JsonPropertyName("operation")] + public required WorkflowDurableOperation Operation { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public required string RunId { get; set; } +} + +/// The run stopped because its usage accounting could not be completed. +/// The workflow_accounting_incomplete variant of . +[Experimental(Diagnostics.Experimental)] +public partial class WorkflowRunFailureWorkflowAccountingIncomplete : WorkflowRunFailure +{ + /// + [JsonIgnore] + public override string Type => "workflow_accounting_incomplete"; + + /// Confirmed usage in nano-AIU, representing the floor of what the run spent. + [JsonPropertyName("drainedNanoAiu")] + public required long DrainedNanoAiu { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public required string RunId { get; set; } +} + +/// The extension that owns the workflow disconnected while the run was executing, so the host halted it. The run's journaled subagent results are preserved so a resume can reuse them. +/// The workflow_provider_disconnected variant of . +[Experimental(Diagnostics.Experimental)] +public partial class WorkflowRunFailureWorkflowProviderDisconnected : WorkflowRunFailure +{ + /// + [JsonIgnore] + public override string Type => "workflow_provider_disconnected"; + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public required string RunId { get; set; } +} + +/// Durable metadata describing who initiated a workflow pause. +/// Polymorphic base type discriminated by type. +[Experimental(Diagnostics.Experimental)] +[JsonPolymorphic( + TypeDiscriminatorPropertyName = "type", + UnknownDerivedTypeHandling = JsonUnknownDerivedTypeHandling.FallBackToBaseType)] +[JsonDerivedType(typeof(WorkflowPauseInfoUser), "user")] +[JsonDerivedType(typeof(WorkflowPauseInfoCheckpoint), "checkpoint")] +public partial class WorkflowPauseInfo +{ + /// The type discriminator. + [JsonPropertyName("type")] + public virtual string Type { get; set; } = string.Empty; +} + + +/// The user variant of . +[Experimental(Diagnostics.Experimental)] +public partial class WorkflowPauseInfoUser : WorkflowPauseInfo +{ + /// + [JsonIgnore] + public override string Type => "user"; +} + +/// The checkpoint variant of . +[Experimental(Diagnostics.Experimental)] +public partial class WorkflowPauseInfoCheckpoint : WorkflowPauseInfo +{ + /// + [JsonIgnore] + public override string Type => "checkpoint"; + + /// Stable author-defined checkpoint key that initiated the pause. + [JsonPropertyName("key")] + public required string Key { get; set; } +} + +/// Complete current or terminal workflow run envelope. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowRunResult +{ + /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. + [JsonPropertyName("attempt")] + public long? Attempt { get; set; } + + /// Error message for an errored run. + [JsonPropertyName("error")] + public string? Error { get; set; } + + /// Machine-readable failure details for a halted or errored run. + [JsonPropertyName("failure")] + public WorkflowRunFailure? Failure { get; set; } + + /// Structured pause initiator metadata for a paused attempt. + [JsonPropertyName("pauseInfo")] + public WorkflowPauseInfo? PauseInfo { get; set; } + + /// Reason for a halted or cancelled run. + [JsonPropertyName("reason")] + public string? Reason { get; set; } + + /// Completed workflow result. + [JsonPropertyName("result")] + public JsonElement? Result { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Partial journal and progress snapshot for a halted, cancelled, or errored run. + [JsonPropertyName("snapshot")] + public JsonElement? Snapshot { get; set; } + + /// Current or terminal workflow run status. + [JsonPropertyName("status")] + public WorkflowRunStatus Status { get; set; } +} + +/// Wire-only per-invocation workflow resource ceiling overrides. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowRunLimits +{ + /// Maximum AI credits consumed by workflow subagents and their descendants. The post-paid ceiling is soft: parallel turns can settle beyond it before the run stops. + [JsonPropertyName("maxAiCredits")] + public double? MaxAiCredits { get; set; } + + /// Maximum number of workflow subagents that may run concurrently. + [JsonPropertyName("maxConcurrentSubagents")] + public long? MaxConcurrentSubagents { get; set; } + + /// Maximum total number of workflow subagents that may be admitted. + [JsonPropertyName("maxTotalSubagents")] + public long? MaxTotalSubagents { get; set; } + + /// Maximum accumulated active-execution time in seconds. Active execution includes the entire extension body, subprocess waits, queued-agent waits, and sleeps; time between resumed attempts is not counted. + [JsonPropertyName("timeoutSeconds")] + public double? TimeoutSeconds { get; set; } +} + +/// Options controlling workflow invocation. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowRunOptions +{ + /// Per-invocation resource ceiling overrides. + [JsonPropertyName("limits")] + public WorkflowRunLimits? Limits { get; set; } + + /// Whether to emit workflow phase names to the session transcript. + [JsonPropertyName("logPhaseNames")] + public bool? LogPhaseNames { get; set; } + + /// Whether to notify the originating session when the workflow completes. + [JsonPropertyName("notifyOnComplete")] + public bool? NotifyOnComplete { get; set; } + + /// Run identifier whose journal and progress should seed this resumed run. + [JsonPropertyName("resumeFromRunId")] + public string? ResumeFromRunId { get; set; } +} + +/// Parameters for invoking a registered workflow. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowRunRequest +{ + /// Workflow input value. + [JsonPropertyName("args")] + public JsonElement Args { get; set; } + + /// Registered workflow name. + [JsonPropertyName("name")] + public string Name { get; set; } = string.Empty; + + /// Workflow invocation options. + [JsonPropertyName("options")] + public WorkflowRunOptions? Options { get; set; } + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Resolved persisted workflow identity and resumed run envelope. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowResumeResult +{ + /// Terminal resumed run envelope. + [JsonPropertyName("run")] + public WorkflowRunResult Run { get => field ??= new(); set; } + + /// Persisted workflow name resolved for the resumed run. + [JsonPropertyName("workflowName")] + public string WorkflowName { get; set; } = string.Empty; +} + +/// Parameters for resuming a workflow run from its persisted identity. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowResumeRequest +{ + /// Optional per-invocation resource ceiling overrides. + [JsonPropertyName("limits")] + public WorkflowRunLimits? Limits { get; set; } + + /// Whether to emit workflow phase names to the session transcript. + [JsonPropertyName("logPhaseNames")] + public bool? LogPhaseNames { get; set; } + + /// Whether to notify the originating session when the workflow completes. + [JsonPropertyName("notifyOnComplete")] + public bool? NotifyOnComplete { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Options for an internal tool-originated workflow invocation. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowToolRunOptions +{ + /// Per-invocation resource ceiling overrides. + [JsonPropertyName("limits")] + public WorkflowRunLimits? Limits { get; set; } + + /// Run identifier whose journal and progress should seed this resumed run. + [JsonPropertyName("resumeFromRunId")] + public string? ResumeFromRunId { get; set; } +} + +/// Internal parameters for invoking a registered workflow from a tool. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowToolRunRequest +{ + /// Workflow input value. + [JsonPropertyName("args")] + public JsonElement Args { get; set; } + + /// Registered workflow name. + [JsonPropertyName("name")] + public string Name { get; set; } = string.Empty; + + /// Tool-originated workflow invocation options. + [JsonPropertyName("options")] + public WorkflowToolRunOptions? Options { get; set; } + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; + + /// Opaque identifier of the originating tool call. + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// Internal parameters for resuming a workflow run from a tool. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowToolResumeRequest +{ + /// Optional per-invocation resource ceiling overrides. + [JsonPropertyName("limits")] + public WorkflowRunLimits? Limits { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; + + /// Opaque identifier of the originating tool call. + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// Parameters for retrieving a workflow run. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowGetRunRequest +{ + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Declared or approved workflow resource ceilings. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowDeclaredLimits +{ + /// Maximum AI credits consumed by subagents and descendants. + [JsonPropertyName("maxAiCredits")] + public double? MaxAiCredits { get; set; } + + /// Maximum concurrently active subagents. + [JsonPropertyName("maxConcurrentSubagents")] + public long? MaxConcurrentSubagents { get; set; } + + /// Maximum total subagents spawned by the run. + [JsonPropertyName("maxTotalSubagents")] + public long? MaxTotalSubagents { get; set; } + + /// Maximum accumulated active execution time in seconds. + [JsonPropertyName("timeoutSeconds")] + public double? TimeoutSeconds { get; set; } +} + +/// Durable workflow resource consumption. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowRunConsumed +{ + /// Accumulated active execution time in milliseconds. + [JsonPropertyName("activeMs")] + public long ActiveMs { get; set; } + + /// AI usage consumed by the run in nano-AIU. + [JsonPropertyName("nanoAiu")] + public long NanoAiu { get; set; } + + /// Total subagents spawned by the run. + [JsonPropertyName("subagents")] + public long Subagents { get; set; } +} + +/// Current workflow phase identity. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowCurrentPhase +{ + /// Current phase identifier. + [JsonPropertyName("id")] + public string Id { get; set; } = string.Empty; + + /// Zero-based declared phase ordinal, or null for an undeclared phase. + [JsonPropertyName("ordinal")] + public long? Ordinal { get; set; } +} + +/// Prompt-safe terminal workflow outcome. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowRunTerminal +{ + /// Human-readable terminal error. + [JsonPropertyName("error")] + public string? Error { get; set; } + + /// Machine-readable terminal failure. + [JsonPropertyName("failure")] + public WorkflowRunFailure? Failure { get; set; } + + /// Pause initiator metadata, or null when the run did not pause. + [JsonPropertyName("pauseInfo")] + public WorkflowPauseInfo? PauseInfo { get; set; } + + /// Human-readable terminal reason. + [JsonPropertyName("reason")] + public string? Reason { get; set; } + + /// Prompt-safe preview of the completed result. + [JsonPropertyName("resultPreview")] + public string? ResultPreview { get; set; } +} + +/// Durable workflow run summary with read-time live overlays. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowRunSummary +{ + /// Epoch milliseconds when the current active segment started, or null while inactive. + [JsonPropertyName("activeSegmentStartedAt")] + public long? ActiveSegmentStartedAt { get; set; } + + /// Approved effective resource ceilings, or null until approved. + [JsonPropertyName("approved")] + public WorkflowDeclaredLimits? Approved { get; set; } + + /// Whether the durable run state currently passes runtime resume eligibility checks. + [JsonPropertyName("canResume")] + public bool CanResume { get; set; } + + /// Epoch milliseconds when the run completed, or null while nonterminal. + [JsonPropertyName("completedAt")] + public long? CompletedAt { get; set; } + + /// Durable resource consumption. + [JsonPropertyName("consumed")] + public WorkflowRunConsumed Consumed { get => field ??= new(); set; } + + /// Epoch milliseconds when the run was created. + [JsonPropertyName("createdAt")] + public long CreatedAt { get; set; } + + /// Current phase identity, or null before any phase is entered. + [JsonPropertyName("currentPhase")] + public WorkflowCurrentPhase? CurrentPhase { get; set; } + + /// Resource ceilings declared by the workflow. + [JsonPropertyName("declaredLimits")] + public WorkflowDeclaredLimits DeclaredLimits { get => field ??= new(); set; } + + /// Number of phases declared by the workflow. + [JsonPropertyName("declaredPhaseCount")] + public long DeclaredPhaseCount { get; set; } + + /// Human-readable workflow description. + [JsonPropertyName("description")] + public string Description { get; set; } = string.Empty; + + /// Number of direct workflow agents currently live. + [JsonPropertyName("liveAgentCount")] + public long LiveAgentCount { get; set; } + + /// Epoch milliseconds when this live-overlay snapshot was observed. + [JsonPropertyName("observedAt")] + public long ObservedAt { get; set; } + + /// Monotonic durable run revision. + [JsonPropertyName("revision")] + public long Revision { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Epoch milliseconds when execution first started, or null before start. + [JsonPropertyName("startedAt")] + public long? StartedAt { get; set; } + + /// Current workflow run status. + [JsonPropertyName("status")] + public WorkflowRunStatus Status { get; set; } + + /// Terminal run outcome, or null while nonterminal. + [JsonPropertyName("terminal")] + public WorkflowRunTerminal? Terminal { get; set; } + + /// Total direct workflow agents spawned across all attempts. + [JsonPropertyName("totalSpawnedAgentCount")] + public long TotalSpawnedAgentCount { get; set; } + + /// Epoch milliseconds when the durable run was last updated. + [JsonPropertyName("updatedAt")] + public long UpdatedAt { get; set; } + + /// Registered workflow name. + [JsonPropertyName("workflowName")] + public string WorkflowName { get; set; } = string.Empty; +} + +/// A page of workflow runs in durable creation order. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowListRunsResult +{ + /// Whether terminal runs newer than this page exist. + [JsonPropertyName("hasMoreNewer")] + public bool? HasMoreNewer { get; set; } + + /// Newest terminal-run cursor in this page, or null when the terminal window is empty. + [JsonPropertyName("newestSeq")] + public long? NewestSeq { get; set; } + + /// Oldest terminal-run cursor in this page, or null when the terminal window is empty. + [JsonPropertyName("oldestSeq")] + public long? OldestSeq { get; set; } + + /// Number of terminal runs older than this page. + [JsonPropertyName("omittedOlder")] + public long? OmittedOlder { get; set; } + + /// Workflow run summaries in durable creation order. + [JsonPropertyName("runs")] + public IList Runs { get => field ??= []; set; } +} + +/// Parameters for paging workflow runs. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowListRunsRequest +{ + /// Exclusive forward cursor. + [JsonPropertyName("afterSeq")] + public long? AfterSeq { get; set; } + + /// Exclusive backward cursor. + [JsonPropertyName("beforeSeq")] + public long? BeforeSeq { get; set; } + + /// Maximum terminal runs to return. Defaults to 200 and is capped at 500. + [JsonPropertyName("limit")] + public int? Limit { get; set; } + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Prompt-safe durable identity and live status for a direct workflow agent. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowAgentSummary +{ + /// Accumulated active agent time in milliseconds. + [JsonPropertyName("activeMs")] + public long ActiveMs { get; set; } + + /// Prompt-safe live activity text. + [JsonPropertyName("activity")] + public string? Activity { get; set; } + + /// Stable direct-agent identifier. + [JsonPropertyName("agentId")] + public string AgentId { get; set; } = string.Empty; + + /// Registered agent type. + [JsonPropertyName("agentType")] + public string AgentType { get; set; } = string.Empty; + + /// Epoch milliseconds when the agent completed. + [JsonPropertyName("completedAt")] + public long? CompletedAt { get; set; } + + /// Friendly, non-unique name intended for display. + [JsonPropertyName("displayName")] + public string? DisplayName { get; set; } + + /// Friendly, non-unique name intended for display. + [JsonPropertyName("label")] + public string Label { get; set; } = string.Empty; + + /// Phase identifier active when the agent was launched, or null. + [JsonPropertyName("phaseId")] + public string? PhaseId { get; set; } + + /// Model requested when the agent was launched. + [JsonPropertyName("requestedModel")] + public string? RequestedModel { get; set; } + + /// Concrete model resolved for the agent. + [JsonPropertyName("resolvedModel")] + public string? ResolvedModel { get; set; } + + /// Owning workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Epoch milliseconds when the agent started. + [JsonPropertyName("startedAt")] + public long? StartedAt { get; set; } + + /// Current durable or live agent status. + [JsonPropertyName("status")] + public string Status { get; set; } = string.Empty; + + /// Tool-call identifier that launched the agent. + [JsonPropertyName("toolCallId")] + public string ToolCallId { get; set; } = string.Empty; +} + +/// Durable lifecycle and timing for one workflow phase. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowPhaseObservation +{ + /// Completed active time accumulated by this phase in milliseconds. + [JsonPropertyName("accumulatedActiveMs")] + public long AccumulatedActiveMs { get; set; } + + /// Epoch milliseconds when this phase completed; for a skipped phase, the synthetic skip timestamp (equal to `startedAt`). + [JsonPropertyName("completedAt")] + public long? CompletedAt { get; set; } + + /// Current live active time for this phase in milliseconds. + [JsonPropertyName("currentActiveMs")] + public long CurrentActiveMs { get; set; } + + /// Optional human-readable phase detail. + [JsonPropertyName("detail")] + public string? Detail { get; set; } + + /// Number of times execution entered this phase. + [JsonPropertyName("entryCount")] + public long EntryCount { get; set; } + + /// Phase identifier. + [JsonPropertyName("id")] + public string Id { get; set; } = string.Empty; + + /// Most recent run attempt that entered this phase, or `0` if the phase has never been entered. + [JsonPropertyName("lastEnteredRunAttempt")] + public long LastEnteredRunAttempt { get; set; } + + /// Direct agents in this phase that are currently live. + [JsonPropertyName("liveAgentCount")] + public long LiveAgentCount { get; set; } + + /// Zero-based declared phase ordinal, or null for an undeclared phase. + [JsonPropertyName("ordinal")] + public long? Ordinal { get; set; } + + /// Epoch milliseconds when this phase first started; for a skipped phase, the synthetic skip timestamp (equal to `completedAt`). + [JsonPropertyName("startedAt")] + public long? StartedAt { get; set; } + + /// Derived lifecycle state of the phase. + [JsonPropertyName("status")] + public WorkflowPhaseStatus Status { get; set; } + + /// Human-readable phase title. + [JsonPropertyName("title")] + public string Title { get; set; } = string.Empty; + + /// Total direct agents associated with this phase. + [JsonPropertyName("totalAgentCount")] + public long TotalAgentCount { get; set; } +} + +/// One durable workflow progress record. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowProgressLine +{ + /// Resume attempt that emitted this record. + [JsonPropertyName("attempt")] + public long Attempt { get; set; } + + /// Progress record kind. + [JsonPropertyName("kind")] + public WorkflowLogLineKind Kind { get; set; } + + /// Phase active when the record was emitted, or null before any phase. + [JsonPropertyName("phaseId")] + public string? PhaseId { get; set; } + + /// Epoch milliseconds when the record was persisted. + [JsonPropertyName("recordedAt")] + public long RecordedAt { get; set; } + + /// Global monotonic sequence number within the run. + [JsonPropertyName("seq")] + public long Seq { get; set; } + + /// Prompt-safe progress text. + [JsonPropertyName("text")] + public string Text { get; set; } = string.Empty; +} + +/// A bidirectional page of workflow progress. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowProgressPage +{ + /// Whether progress records newer than this page exist. + [JsonPropertyName("hasMoreNewer")] + public bool HasMoreNewer { get; set; } + + /// Whether progress records older than this page exist. + [JsonPropertyName("hasMoreOlder")] + public bool HasMoreOlder { get; set; } + + /// Newest sequence number in this page, or null when empty. + [JsonPropertyName("newestSeq")] + public long? NewestSeq { get; set; } + + /// Oldest sequence number in this page, or null when empty. + [JsonPropertyName("oldestSeq")] + public long? OldestSeq { get; set; } + + /// Progress records in sequence order. + [JsonPropertyName("records")] + public IList Records { get => field ??= []; set; } + + /// Run revision reflected by this page. + [JsonPropertyName("revision")] + public long Revision { get; set; } +} + +/// Full workflow run observability detail. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowRunDetail +{ + /// Epoch milliseconds when the current active segment started, or null while inactive. + [JsonPropertyName("activeSegmentStartedAt")] + public long? ActiveSegmentStartedAt { get; set; } + + /// Durable identities and live statuses for direct workflow agents. + [JsonPropertyName("agents")] + public IList Agents { get => field ??= []; set; } + + /// Approved effective resource ceilings, or null until approved. + [JsonPropertyName("approved")] + public WorkflowDeclaredLimits? Approved { get; set; } + + /// Whether the durable run state currently passes runtime resume eligibility checks. + [JsonPropertyName("canResume")] + public bool CanResume { get; set; } + + /// Epoch milliseconds when the run completed, or null while nonterminal. + [JsonPropertyName("completedAt")] + public long? CompletedAt { get; set; } + + /// Durable resource consumption. + [JsonPropertyName("consumed")] + public WorkflowRunConsumed Consumed { get => field ??= new(); set; } + + /// Epoch milliseconds when the run was created. + [JsonPropertyName("createdAt")] + public long CreatedAt { get; set; } + + /// Current phase identity, or null before any phase is entered. + [JsonPropertyName("currentPhase")] + public WorkflowCurrentPhase? CurrentPhase { get; set; } + + /// Resource ceilings declared by the workflow. + [JsonPropertyName("declaredLimits")] + public WorkflowDeclaredLimits DeclaredLimits { get => field ??= new(); set; } + + /// Number of phases declared by the workflow. + [JsonPropertyName("declaredPhaseCount")] + public long DeclaredPhaseCount { get; set; } + + /// Human-readable workflow description. + [JsonPropertyName("description")] + public string Description { get; set; } = string.Empty; + + /// Number of direct workflow agents currently live. + [JsonPropertyName("liveAgentCount")] + public long LiveAgentCount { get; set; } + + /// Epoch milliseconds when this live-overlay snapshot was observed. + [JsonPropertyName("observedAt")] + public long ObservedAt { get; set; } + + /// Lifecycle and timing observations for each workflow phase. + [JsonPropertyName("phases")] + public IList Phases { get => field ??= []; set; } + + /// Bidirectional page of durable workflow progress. + [JsonPropertyName("progress")] + public WorkflowProgressPage Progress { get => field ??= new(); set; } + + /// Monotonic durable run revision. + [JsonPropertyName("revision")] + public long Revision { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Epoch milliseconds when execution first started, or null before start. + [JsonPropertyName("startedAt")] + public long? StartedAt { get; set; } + + /// Current workflow run status. + [JsonPropertyName("status")] + public WorkflowRunStatus Status { get; set; } + + /// Terminal run outcome, or null while nonterminal. + [JsonPropertyName("terminal")] + public WorkflowRunTerminal? Terminal { get; set; } + + /// Total direct workflow agents spawned across all attempts. + [JsonPropertyName("totalSpawnedAgentCount")] + public long TotalSpawnedAgentCount { get; set; } + + /// Epoch milliseconds when the durable run was last updated. + [JsonPropertyName("updatedAt")] + public long UpdatedAt { get; set; } + + /// Registered workflow name. + [JsonPropertyName("workflowName")] + public string WorkflowName { get; set; } = string.Empty; +} + +/// Parameters for paging workflow progress. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowGetRunProgressRequest +{ + /// Exclusive forward cursor. + [JsonPropertyName("afterSeq")] + public long? AfterSeq { get; set; } + + /// Exclusive backward cursor. + [JsonPropertyName("beforeSeq")] + public long? BeforeSeq { get; set; } + + /// Maximum records to return. Defaults to 200 and is capped at 500. + [JsonPropertyName("limit")] + public int? Limit { get; set; } + + /// Optional phase identifier used to scope records and cursors. + [JsonPropertyName("phaseId")] + public string? PhaseId { get; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Parameters for cancelling a workflow run. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowCancelRequest +{ + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Parameters for pausing a running workflow. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowPauseRequest +{ + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// RPC data type for SessionWorkflowPauseAtCheckpoint operations. +[Experimental(Diagnostics.Experimental)] +internal sealed class SessionWorkflowPauseAtCheckpointResult +{ + /// Whether this execution attempt must pause or may continue. + [JsonPropertyName("action")] + public WorkflowPauseCheckpointAction Action { get; set; } +} + +/// Parameters for an owned durable pause checkpoint. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowPauseCheckpointRequest +{ + /// Opaque token identifying the execution attempt that reached the checkpoint. + [JsonPropertyName("executionToken")] + public string ExecutionToken { get; set; } = string.Empty; + + /// Stable author-defined checkpoint key. + [JsonPropertyName("key")] + public string Key { get; set; } = string.Empty; + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Acknowledgement that a workflow request was accepted. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowAckResult +{ +} + +/// One ordered workflow progress line. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowLogLine +{ + /// Progress line kind. + [JsonPropertyName("kind")] + public WorkflowLogLineKind Kind { get; set; } + + /// Monotonic sequence number within the workflow run. + [JsonPropertyName("seq")] + public long Seq { get; set; } + + /// Progress text. + [JsonPropertyName("text")] + public string Text { get; set; } = string.Empty; +} + +/// Parameters for recording workflow progress. +[Experimental(Diagnostics.Experimental)] +internal sealed class WorkflowLogRequest +{ + /// Opaque token identifying the current workflow execution attempt. + [JsonPropertyName("executionToken")] + public string ExecutionToken { get; set; } = string.Empty; + + /// Ordered progress lines to append. + [JsonPropertyName("lines")] + public IList Lines { get => field ??= []; set; } + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Result of one workflow-scoped subagent call. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowAgentResult +{ + /// Agent result, omitted when the agent produced no result. + [JsonPropertyName("result")] + public JsonElement? Result { get; set; } +} + +/// Options for one workflow-scoped subagent call. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowAgentOptions +{ + /// Optional built-in or custom agent name whose definition configures the subagent. + [JsonPropertyName("agent")] + public string? Agent { get; set; } + + /// Optional context tier override for the subagent. + [JsonPropertyName("contextTier")] + public ContextTier? ContextTier { get; set; } + + /// Optional label distinguishing otherwise identical memoized agent calls. + [JsonPropertyName("label")] + public string? Label { get; set; } + + /// Optional model identifier for the subagent. + [JsonPropertyName("model")] + public string? Model { get; set; } + + /// Optional reasoning effort override for the subagent. + [JsonPropertyName("reasoningEffort")] + public string? ReasoningEffort { get; set; } + + /// Optional JSON Schema for structured agent output. + [JsonPropertyName("schema")] + public JsonElement? Schema { get; set; } +} + +/// Parameters for one workflow-scoped subagent call. [Experimental(Diagnostics.Experimental)] -internal sealed class FactoryAgentRequest +internal sealed class WorkflowAgentRequest { - /// Opaque token identifying the current factory execution attempt. + /// Opaque token identifying the current workflow execution attempt. [JsonPropertyName("executionToken")] public string ExecutionToken { get; set; } = string.Empty; - /// Factory run identifier that owns the subagent. - [JsonPropertyName("factoryRunId")] - public string FactoryRunId { get; set; } = string.Empty; - /// Subagent execution options. [JsonPropertyName("opts")] - public FactoryAgentOptions Opts { get => field ??= new(); set; } + public WorkflowAgentOptions Opts { get => field ??= new(); set; } /// Prompt to send to the subagent. [JsonPropertyName("prompt")] @@ -7916,11 +9491,15 @@ internal sealed class FactoryAgentRequest /// Target session identifier. [JsonPropertyName("sessionId")] public string SessionId { get; set; } = string.Empty; + + /// Workflow run identifier that owns the subagent. + [JsonPropertyName("workflowRunId")] + public string WorkflowRunId { get; set; } = string.Empty; } -/// Result of reading a factory journal entry. +/// Result of reading a workflow journal entry. [Experimental(Diagnostics.Experimental)] -public sealed class FactoryJournalGetResult +public sealed class WorkflowJournalGetResult { /// Whether the journal contained the requested key. [JsonPropertyName("hit")] @@ -7931,11 +9510,11 @@ public sealed class FactoryJournalGetResult public JsonElement? ResultJson { get; set; } } -/// Parameters for reading a factory journal entry. +/// Parameters for reading a workflow journal entry. [Experimental(Diagnostics.Experimental)] -internal sealed class FactoryJournalGetRequest +internal sealed class WorkflowJournalGetRequest { - /// Opaque token identifying the current factory execution attempt. + /// Opaque token identifying the current workflow execution attempt. [JsonPropertyName("executionToken")] public string ExecutionToken { get; set; } = string.Empty; @@ -7943,7 +9522,7 @@ internal sealed class FactoryJournalGetRequest [JsonPropertyName("key")] public string Key { get; set; } = string.Empty; - /// Factory run identifier. + /// Workflow run identifier. [JsonPropertyName("runId")] public string RunId { get; set; } = string.Empty; @@ -7952,11 +9531,11 @@ internal sealed class FactoryJournalGetRequest public string SessionId { get; set; } = string.Empty; } -/// Parameters for storing a factory journal entry. +/// Parameters for storing a workflow journal entry. [Experimental(Diagnostics.Experimental)] -internal sealed class FactoryJournalPutRequest +internal sealed class WorkflowJournalPutRequest { - /// Opaque token identifying the current factory execution attempt. + /// Opaque token identifying the current workflow execution attempt. [JsonPropertyName("executionToken")] public string ExecutionToken { get; set; } = string.Empty; @@ -7968,7 +9547,7 @@ internal sealed class FactoryJournalPutRequest [JsonPropertyName("resultJson")] public JsonElement ResultJson { get; set; } - /// Factory run identifier. + /// Workflow run identifier. [JsonPropertyName("runId")] public string RunId { get; set; } = string.Empty; @@ -8064,6 +9643,10 @@ public sealed class ModelSwitchToResult [JsonPropertyName("persistenceError")] public string? PersistenceError { get; set; } + /// Stable queue item identifier when this request was enqueued. Remains present if the item drains before the response is returned. + [JsonPropertyName("queueId")] + public string? QueueId { get; set; } + /// Lifecycle result for the requested switch. [JsonPropertyName("status")] public string? Status { get; set; } @@ -8296,6 +9879,10 @@ internal sealed class ModelSwitchAutoTierRequest [Experimental(Diagnostics.Experimental)] internal sealed class ModelApplyStartupOverlayRequest { + /// Effective default Auto routing preference from user and managed settings. Applies only to fresh sessions and never replaces a per-session selection. + [JsonPropertyName("autoTier")] + public AutoTier? AutoTier { get; set; } + /// Model explicitly selected by the CLI, when provided. [JsonPropertyName("cliModel")] public string? CliModel { get; set; } @@ -12166,14 +13753,92 @@ internal sealed class McpResourcesListTemplatesRequest public string SessionId { get; set; } = string.Empty; } +/// Enterprise managed-settings resolution: the effective managed settings the session applied and which channels contributed, so SDK clients can show users what is enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on resume, and on account switch. This is an ephemeral live snapshot (delivered to subscribers but not persisted to the session event log), because at session start it resolves before `session.start` is emitted. Device values take precedence over server values, then the policy helper, per ordinary key, while permissions compose restrictively across device, server, policy-helper, and SDK-client layers. The account-scoped `getManagedSettings()` API does not include session-local client injection. Marked experimental while the managed-settings surface stabilizes. +[Experimental(Diagnostics.Experimental)] +public sealed class ManagedSettingsResolvedData +{ + /// Whether enterprise policy disables bypass-permissions ("yolo") mode for this session. Deny-wins across layers, and forced on when `failClosed` is true. + [JsonPropertyName("bypassPermissionsDisabled")] + public bool BypassPermissionsDisabled { get; set; } + + /// Whether a session-local permissions layer injected by the SDK host was present. + [JsonPropertyName("clientManaged")] + public bool? ClientManaged { get; set; } + + /// Whether an actual device MDM/plist/registry/file managed-settings layer was present. + [JsonPropertyName("deviceManaged")] + public bool DeviceManaged { get; set; } + + /// Whether managed policy could not be determined (e.g. a failed server fetch) and the session fell back to the fail-closed restriction. When true, restrictions such as disabling bypass-permissions are enforced even though `settings` may be absent. + [JsonPropertyName("failClosed")] + public bool FailClosed { get; set; } + + /// The setting keys under enterprise management in the effective managed settings (e.g. `model`, `enabledPlugins`, `permissions`). Empty when no managed settings are in force. + [JsonPropertyName("managedKeys")] + public IList ManagedKeys { get => field ??= []; set; } + + /// Whether at least two managed sources supplied permission allowlists, so enforcement intersects them and the flattened settings payload omits `permissions.allow`. + [JsonPropertyName("permissionsAllowIntersected")] + public bool? PermissionsAllowIntersected { get; set; } + + /// Whether the policy-helper managed-settings layer was present. The policy helper is the weakest channel: it fills keys no enterprise source set and can never replace one. + [JsonPropertyName("policyHelperManaged")] + public bool? PolicyHelperManaged { get; set; } + + /// Whether the effective sandbox policy forces the sandbox on *only* because managed policy could not be determined, rather than because the policy requires it. Lets clients tell a user whose `--no-sandbox` was overridden that the sandbox stayed on as a fail-closed fallback, instead of attributing it to an administrator who set no such policy. + [JsonPropertyName("sandboxEnabledByUndeterminedPolicy")] + public bool? SandboxEnabledByUndeterminedPolicy { get; set; } + + /// Whether the server (account/org) managed-settings layer was present. + [JsonPropertyName("serverManaged")] + public bool ServerManaged { get; set; } + + /// The effective (resolved) managed settings values, so clients can render exactly what is enforced. Absent when no managed policy is in force. + [JsonPropertyName("settings")] + public JsonElement? Settings { get; set; } + + /// Channel summary: `server`, `device`, `client`, or `policyHelper` when exactly one channel contributed; `mixed` when multiple channels contributed; otherwise `none`. Consult the per-channel booleans for exact provenance. + [JsonPropertyName("source")] + public ManagedSettingsResolvedSource Source { get; set; } +} + +/// Identifies the target session. +[Experimental(Diagnostics.Experimental)] +internal sealed class SessionManagedSettingsGetRequest +{ + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + /// Session plugin metadata, with name, marketplace, optional version, and enabled state. [Experimental(Diagnostics.Experimental)] public sealed class Plugin { + /// Opaque stable identity for a direct plugin source. + [JsonPropertyName("directSourceId")] + public string? DirectSourceId { get; set; } + /// Whether the plugin is currently enabled. [JsonPropertyName("enabled")] public bool Enabled { get; set; } + /// Whether this managed desired plugin has an installed or live record. + [JsonPropertyName("installed")] + public bool? Installed { get; set; } + + /// Absolute marketplace directory for a live plugin. + [JsonPropertyName("installedFrom")] + public string? InstalledFrom { get; set; } + + /// Whether enterprise managed settings control this plugin. + [JsonPropertyName("managed")] + public bool? Managed { get; set; } + + /// Enabled state required by enterprise managed settings. + [JsonPropertyName("managedDesiredEnabled")] + public bool? ManagedDesiredEnabled { get; set; } + /// Marketplace the plugin came from. [JsonPropertyName("marketplace")] public string Marketplace { get; set; } = string.Empty; @@ -12182,6 +13847,10 @@ public sealed class Plugin [JsonPropertyName("name")] public string Name { get; set; } = string.Empty; + /// Runtime plugin provenance, such as "builtin". + [JsonPropertyName("source")] + public string? Source { get; set; } + /// Installed version. [JsonPropertyName("version")] public string? Version { get; set; } @@ -12205,6 +13874,75 @@ internal sealed class SessionPluginsListRequest public string SessionId { get; set; } = string.Empty; } +/// Plugin source resolved relative to the session's authoritative working directory. +[Experimental(Diagnostics.Experimental)] +internal sealed class SessionPluginsInstallRequest +{ + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; + + /// Plugin install spec. Accepts the same forms as the CLI: "plugin@marketplace" (marketplace install), "owner/repo" or "owner/repo:subpath" (GitHub direct), an http/https/ssh URL, or a local path. Direct (non-marketplace) installs are deprecated and will produce a deprecationWarning in the result. + [JsonPropertyName("source")] + public string Source { get; set; } = string.Empty; +} + +/// Name (or spec) of the plugin to uninstall. +[Experimental(Diagnostics.Experimental)] +internal sealed class PluginsUninstallRequestWithSession +{ + /// Stable source identity for a direct (non-marketplace) install. Disambiguates uninstall when multiple installed plugins share the same name. + [JsonPropertyName("directSourceId")] + public string? DirectSourceId { get; set; } + + /// Plugin name or "plugin@marketplace" spec to uninstall. When ambiguous, prefer the fully-qualified spec. + [JsonPropertyName("name")] + public string Name { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Name (or spec) of the plugin to update. +[Experimental(Diagnostics.Experimental)] +internal sealed class PluginsUpdateRequestWithSession +{ + /// Plugin name or "plugin@marketplace" spec to update. + [JsonPropertyName("name")] + public string Name { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Plugin names (or specs) to enable in the session's authoritative working directory. +[Experimental(Diagnostics.Experimental)] +internal sealed class SessionPluginsEnableRequest +{ + /// Plugin names or "plugin@marketplace" specs to enable. Unknown names are ignored. Non-marketplace direct installs are always enabled and cannot be toggled via this API. + [JsonPropertyName("names")] + public IList Names { get => field ??= []; set; } + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Plugin names (or specs) to disable in the session's authoritative working directory. +[Experimental(Diagnostics.Experimental)] +internal sealed class SessionPluginsDisableRequest +{ + /// Plugin names or "plugin@marketplace" specs to disable. Unknown names are ignored. Non-marketplace direct installs cannot be disabled via this API; uninstall them instead. Plugin-owned MCP servers are stopped in active sessions immediately; other plugin contributions remain available until each session reloads plugins. + [JsonPropertyName("names")] + public IList Names { get => field ??= []; set; } + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + /// RPC data type for SessionPluginsReload operations. [Experimental(Diagnostics.Experimental)] public sealed class SessionPluginsReloadRequest @@ -12259,6 +13997,84 @@ internal sealed class SessionPluginsReloadRequestWithSession public string SessionId { get; set; } = string.Empty; } +/// Identifies the target session. +[Experimental(Diagnostics.Experimental)] +internal sealed class SessionPluginsMarketplacesListRequest +{ + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Marketplace source and optional working directory for relative-path resolution. +[Experimental(Diagnostics.Experimental)] +internal sealed class PluginsMarketplacesAddRequestWithSession +{ + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; + + /// Marketplace source. Accepts the same forms as the CLI: "owner/repo" or "owner/repo#ref" (GitHub), an http/https/ssh URL (optionally with #ref), a git scp-style URL (user@host:path), or a local path. The marketplace's own name (from its manifest) is used as the registration key. + [JsonPropertyName("source")] + public string Source { get; set; } = string.Empty; + + /// Working directory used to resolve relative local paths in `source`. Defaults to the server's current working directory. + [JsonPropertyName("workingDirectory")] + public string? WorkingDirectory { get; set; } +} + +/// Name of the marketplace to remove and an optional force flag. +[Experimental(Diagnostics.Experimental)] +internal sealed class PluginsMarketplacesRemoveRequestWithSession +{ + /// When true, also uninstall every plugin sourced from this marketplace. When false (default), removal is a no-op if any plugin from this marketplace is installed and the dependent plugin names are returned in the result. + [JsonPropertyName("force")] + public bool? Force { get; set; } + + /// Marketplace name to remove. + [JsonPropertyName("name")] + public string Name { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Name of the marketplace whose plugin catalog to fetch. +[Experimental(Diagnostics.Experimental)] +internal sealed class PluginsMarketplacesBrowseRequestWithSession +{ + /// Marketplace name to browse. + [JsonPropertyName("name")] + public string Name { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// RPC data type for SessionPluginsMarketplacesRefresh operations. +[Experimental(Diagnostics.Experimental)] +public sealed class SessionPluginsMarketplacesRefreshRequest +{ + /// Marketplace name to refresh. When omitted, every registered marketplace is refreshed. + [JsonPropertyName("name")] + public string? Name { get; set; } +} + +/// RPC data type for SessionPluginsMarketplacesRefreshRequestWithSession operations. +[Experimental(Diagnostics.Experimental)] +internal sealed class SessionPluginsMarketplacesRefreshRequestWithSession +{ + /// Marketplace name to refresh. When omitted, every registered marketplace is refreshed. + [JsonPropertyName("name")] + public string? Name { get; set; } + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + /// Short-lived, rotating credential the caller must send on every request, in addition to `apiKey` if one is present. Omitted when the endpoint does not require one. [Experimental(Diagnostics.Experimental)] public sealed class ProviderSessionToken @@ -13023,7 +14839,7 @@ public sealed class SandboxConfigUserPolicyNetwork [JsonPropertyName("blockedHosts")] public IList? BlockedHosts { get; set; } - /// HTTP(S) proxy for sandboxed traffic. With host rules, this is the built-in local proxy's upstream; credentials stay in the runtime, and Linux and macOS restrict the child to the local listener. Without host rules, Linux restricts egress to this endpoint but rejects credentials, and macOS proxying is cooperative. Windows enforcement depends on the application's networking stack. Configure credentials in the separate username/password fields. The transient local listener URL is never persisted. + /// HTTP(S) proxy for sandboxed traffic. This is the built-in local proxy's upstream: every sandboxed command reaches it through a loopback listener, so credentials stay in the runtime and never reach the child. On Windows the sandbox also needs local network access, because it reaches that listener over host loopback. Configure credentials in the separate username/password fields. The transient local listener URL is never persisted. [JsonPropertyName("proxy")] public SandboxConfigUserPolicyNetworkProxy? Proxy { get; set; } } @@ -14242,6 +16058,10 @@ internal sealed class ToolsGetBuiltinDescriptorsRequest [Experimental(Diagnostics.Experimental)] public sealed class TaskCompleteData { + /// Structured blocker details when outcome is blocked. + [JsonPropertyName("blocker")] + public TaskBlocker? Blocker { get; set; } + /// Active autopilot objective ID evaluated by the completion reviewer. [JsonPropertyName("objectiveId")] public long? ObjectiveId { get; set; } @@ -16527,6 +18347,10 @@ internal sealed class PermissionDecisionRequest [Experimental(Diagnostics.Experimental)] public sealed class PendingPermissionRequest { + /// Permission-recovery episode that authorized this request to surface for interactive attention. + [JsonPropertyName("recoveryEpisodeId")] + public string? RecoveryEpisodeId { get; set; } + /// The user-facing permission prompt details (commands, write, read, mcp, url, memory, custom-tool, path, hook). [JsonPropertyName("request")] public PermissionPromptRequest Request { get; set; } = null!; @@ -17279,6 +19103,10 @@ public sealed class SessionMetadataSnapshot [JsonPropertyName("currentMode")] public MetadataSnapshotCurrentMode CurrentMode { get; set; } + /// Live indexed-search state for this session activation. Omitted by runtimes that do not expose indexed-search status; absence does not indicate enablement. + [JsonPropertyName("indexedSearch")] + public IndexedSearchState? IndexedSearch { get; set; } + /// User-provided name supplied at session construction (via `--name`), if any. Immutable after construction. [JsonPropertyName("initialName")] public string? InitialName { get; set; } @@ -18594,6 +20422,10 @@ internal sealed class SessionQueuePendingItemsRequest [Experimental(Diagnostics.Experimental)] internal sealed class QueueSnapshotResult { + /// Queue item identifier of a model switch that has been dequeued but not yet applied. + [JsonPropertyName("inFlightModelChangeId")] + public string? InFlightModelChangeId { get; set; } + /// Insertion orders for queued items, aligned with `items`. [JsonPropertyName("itemOrders")] public IList? ItemOrders { get; set; } @@ -18777,6 +20609,56 @@ internal sealed class QueueUpdateTextRequest public string SessionId { get; set; } = string.Empty; } +/// Conditional withdrawal of a single user message, before the runtime claims it for delivery. +[Experimental(Diagnostics.Experimental)] +internal sealed class QueueWithdrawMessageRequest +{ + /// The prompt originally sent. A message edited since submission is not withdrawn, so an obsolete draft cannot replace the edit. + [JsonPropertyName("expectedPrompt")] + public string ExpectedPrompt { get; set; } = string.Empty; + + /// Message identity returned by send, not the queue item id. Batch messages are not eligible. + [JsonPropertyName("messageId")] + public string MessageId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Append to one pending steering message without changing its identity or delivery position. +[Experimental(Diagnostics.Experimental)] +internal sealed class QueueAppendSteeringRequest +{ + /// Mode captured at submission. Only steering messages in the same mode may be combined. + [JsonPropertyName("agentMode")] + public SendAgentMode AgentMode { get; set; } + + /// Attachments to add after the message's existing attachments. An empty list preserves the existing attachments. + [JsonPropertyName("attachments")] + public IList Attachments { get => field ??= []; set; } + + /// Display text to append to the existing preview after a blank line. + [JsonPropertyName("displayPrompt")] + public string DisplayPrompt { get; set; } = string.Empty; + + /// Expected current prompt, including any previous appends. The runtime applies plan-mode normalization before comparing and refuses a changed message. + [JsonPropertyName("expectedPrompt")] + public string ExpectedPrompt { get; set; } = string.Empty; + + /// Message identity returned by send, not the queue item id. Only unclaimed user steering messages are eligible. + [JsonPropertyName("messageId")] + public string MessageId { get; set; } = string.Empty; + + /// Text to append after a blank line. + [JsonPropertyName("prompt")] + public string Prompt { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + /// Result of duplicating a queued item. [Experimental(Diagnostics.Experimental)] public sealed class QueueDuplicateAtResult @@ -19846,6 +21728,57 @@ public sealed class FactoryAbortRequest public string SessionId { get; set; } = string.Empty; } +/// Result returned by an extension workflow closure. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowExecuteResult +{ + /// Workflow result value. + [JsonPropertyName("result")] + public JsonElement? Result { get; set; } +} + +/// Parameters sent to the owning extension to execute a workflow closure. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowExecuteRequest +{ + /// Workflow input value. + [JsonPropertyName("args")] + public JsonElement Args { get; set; } + + /// Opaque token identifying this workflow execution attempt. + [JsonPropertyName("executionToken")] + public string ExecutionToken { get; set; } = string.Empty; + + /// Registered workflow name. + [JsonPropertyName("name")] + public string Name { get; set; } = string.Empty; + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + +/// Parameters for cooperatively aborting a workflow body. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowAbortRequest +{ + /// Opaque token identifying the execution attempt to abort. + [JsonPropertyName("executionToken")] + public string ExecutionToken { get; set; } = string.Empty; + + /// Workflow run identifier. + [JsonPropertyName("runId")] + public string RunId { get; set; } = string.Empty; + + /// Target session identifier. + [JsonPropertyName("sessionId")] + public string SessionId { get; set; } = string.Empty; +} + /// Whether the client authoritatively confirmed its external work stopped. [Experimental(Diagnostics.Experimental)] public sealed class ClientTaskCancelResult @@ -21344,15 +23277,24 @@ public CatalogCapability(string value) /// Understands `application/ai-skill` candidates as discovery-only and typed non-installable. public static CatalogCapability AiSkillDiscovery { get; } = new("ai-skill-discovery"); + /// Understands opt-in `application/vnd.github.copilot-plugin` candidates and their typed identity, version, source, and compatibility fields. + public static CatalogCapability AgentPluginDiscovery { get; } = new("agent-plugin-discovery"); + /// Understands side-effect-free MCP install-plan requests, results, and plan handles; `planning-unavailable` separately reports that planning is not enabled. public static CatalogCapability McpInstallPlanning { get; } = new("mcp-install-planning"); /// Understands plans that enumerate every eligible transport rather than a single preferred one. public static CatalogCapability MultipleTransportChoice { get; } = new("multiple-transport-choice"); + /// Understands explicit numbered navigation and authority-reported pagination metadata with opaque tokens. Advertised and granted only when requested. + public static CatalogCapability CatalogSearchPagination { get; } = new("catalog-search-pagination"); + /// Understands versioned candidate trust snapshots. Protocol-3 callers must require this capability before the runtime adds the optional snapshot field. public static CatalogCapability TrustSnapshot { get; } = new("trust-snapshot"); + /// Understands exact candidate selection through model-safe opaque references and host-only candidate-handle hand-off. + public static CatalogCapability CatalogSelection { get; } = new("catalog-selection"); + /// Returns a value indicating whether two instances are equivalent. public static bool operator ==(CatalogCapability left, CatalogCapability right) => left.Equals(right); @@ -22187,6 +24129,9 @@ public CatalogHandleType(string value) /// An install plan handle. public static CatalogHandleType Plan { get; } = new("plan"); + /// A model-safe reference to one retained search candidate. + public static CatalogHandleType Selection { get; } = new("selection"); + /// Returns a value indicating whether two instances are equivalent. public static bool operator ==(CatalogHandleType left, CatalogHandleType right) => left.Equals(right); @@ -22244,7 +24189,7 @@ public CatalogHandleRejectionReason(string value) /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The handle is unparseable, unknown, or was issued for a different operation. + /// The handle is unparseable or unknown. public static CatalogHandleRejectionReason Invalid { get; } = new("invalid"); /// The handle's time to live has elapsed. @@ -22253,9 +24198,15 @@ public CatalogHandleRejectionReason(string value) /// The handle has already been used, and handles are single-use. public static CatalogHandleRejectionReason Replayed { get; } = new("replayed"); - /// The handle was issued by a different runtime instance. + /// The handle was issued by a different runtime instance or session. public static CatalogHandleRejectionReason Foreign { get; } = new("foreign"); + /// The handle was issued for another catalog operation. + public static CatalogHandleRejectionReason WrongKind { get; } = new("wrong-kind"); + + /// The supplied search identifier does not match the retained candidate. + public static CatalogHandleRejectionReason SearchMismatch { get; } = new("search-mismatch"); + /// Returns a value indicating whether two instances are equivalent. public static bool operator ==(CatalogHandleRejectionReason left, CatalogHandleRejectionReason right) => left.Equals(right); @@ -22293,7 +24244,7 @@ public override void Write(Utf8JsonWriter writer, CatalogHandleRejectionReason v } -/// Which request field was rejected before any work was done. +/// Which request field was rejected locally or by the catalog authority. [Experimental(Diagnostics.Experimental)] [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] @@ -22334,6 +24285,18 @@ public CatalogInvalidRequestField(string value) /// The requested configuration scope is not one this runtime writes. public static CatalogInvalidRequestField Scope { get; } = new("scope"); + /// The pagination token or target was invalid, or the authority rejected the continuation. Repeat the search without page. + public static CatalogInvalidRequestField Page { get; } = new("page"); + + /// The locally owned session identifier was missing or malformed. + public static CatalogInvalidRequestField SessionId { get; } = new("sessionId"); + + /// The opaque selection reference was missing or malformed. + public static CatalogInvalidRequestField SelectionRef { get; } = new("selectionRef"); + + /// The terminal selection outcome was missing or unsupported. + public static CatalogInvalidRequestField Outcome { get; } = new("outcome"); + /// Returns a value indicating whether two instances are equivalent. public static bool operator ==(CatalogInvalidRequestField left, CatalogInvalidRequestField right) => left.Equals(right); @@ -22631,6 +24594,9 @@ public CatalogMediaType(string value) /// An AI skill card. Representable and searchable, but typed non-installable. public static CatalogMediaType ApplicationAiSkill { get; } = new("application/ai-skill"); + /// An inert Agent Plugin descriptor. + public static CatalogMediaType ApplicationVndGitHubCopilotPlugin { get; } = new("application/vnd.github.copilot-plugin"); + /// Returns a value indicating whether two instances are equivalent. public static bool operator ==(CatalogMediaType left, CatalogMediaType right) => left.Equals(right); @@ -22766,7 +24732,7 @@ public CatalogContractViolationReason(string value) /// A result carried neither a URL nor embedded data, when exactly one is required. public static CatalogContractViolationReason NeitherUrlNorData { get; } = new("neither-url-nor-data"); - /// Two results claimed the same normalised identity. + /// Two results claimed the same collision key: normalised identity for existing kinds, or normalised identity and declared version for Agent Plugins. public static CatalogContractViolationReason DuplicateIdentity { get; } = new("duplicate-identity"); /// A result declared no media type, or one this contract does not model. @@ -22967,6 +24933,9 @@ public CatalogUnavailableReason(string value) /// Install planning is not wired up on this runtime build. public static CatalogUnavailableReason PlanningUnavailable { get; } = new("planning-unavailable"); + /// Exact candidate selection is not available in this session or runtime. + public static CatalogUnavailableReason SelectionUnavailable { get; } = new("selection-unavailable"); + /// No catalog authority is configured for this runtime. public static CatalogUnavailableReason AuthorityNotConfigured { get; } = new("authority-not-configured"); @@ -23454,6 +25423,312 @@ public override void Write(Utf8JsonWriter writer, CatalogTrustTier value, JsonSe } +/// Typed non-installable state for an AI skill candidate. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct CatalogAiSkillInstallability : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public CatalogAiSkillInstallability(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// AI skills are discovery-only on this surface. + public static CatalogAiSkillInstallability NotInstallableKind { get; } = new("not-installable-kind"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CatalogAiSkillInstallability left, CatalogAiSkillInstallability right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CatalogAiSkillInstallability left, CatalogAiSkillInstallability right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is CatalogAiSkillInstallability other && Equals(other); + + /// + public bool Equals(CatalogAiSkillInstallability other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override CatalogAiSkillInstallability Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, CatalogAiSkillInstallability value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CatalogAiSkillInstallability)); + } + } +} + + +/// Canonical AI skill media type. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct CatalogAiSkillMediaType : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public CatalogAiSkillMediaType(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// An AI skill card. + public static CatalogAiSkillMediaType ApplicationAiSkill { get; } = new("application/ai-skill"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CatalogAiSkillMediaType left, CatalogAiSkillMediaType right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CatalogAiSkillMediaType left, CatalogAiSkillMediaType right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is CatalogAiSkillMediaType other && Equals(other); + + /// + public bool Equals(CatalogAiSkillMediaType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override CatalogAiSkillMediaType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, CatalogAiSkillMediaType value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CatalogAiSkillMediaType)); + } + } +} + + +/// Explicit Agent Plugin compatibility declared by exact catalog tags. Clients must not infer these values from display text or other metadata. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct CatalogAgentPluginCompatibilityTag : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public CatalogAgentPluginCompatibilityTag(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The plugin contributes at least one GitHub Copilot Canvas. + public static CatalogAgentPluginCompatibilityTag Canvas { get; } = new("canvas"); + + /// The plugin depends on Canvas for its intended functionality. + public static CatalogAgentPluginCompatibilityTag CanvasOnly { get; } = new("canvas-only"); + + /// The plugin targets GitHub Copilot. + public static CatalogAgentPluginCompatibilityTag GitHubCopilot { get; } = new("github-copilot"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CatalogAgentPluginCompatibilityTag left, CatalogAgentPluginCompatibilityTag right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CatalogAgentPluginCompatibilityTag left, CatalogAgentPluginCompatibilityTag right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is CatalogAgentPluginCompatibilityTag other && Equals(other); + + /// + public bool Equals(CatalogAgentPluginCompatibilityTag other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override CatalogAgentPluginCompatibilityTag Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, CatalogAgentPluginCompatibilityTag value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CatalogAgentPluginCompatibilityTag)); + } + } +} + + +/// Canonical Agent Plugin media type. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct CatalogAgentPluginMediaType : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public CatalogAgentPluginMediaType(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// A GitHub Copilot Agent Plugin descriptor. + public static CatalogAgentPluginMediaType ApplicationVndGitHubCopilotPlugin { get; } = new("application/vnd.github.copilot-plugin"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CatalogAgentPluginMediaType left, CatalogAgentPluginMediaType right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CatalogAgentPluginMediaType left, CatalogAgentPluginMediaType right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is CatalogAgentPluginMediaType other && Equals(other); + + /// + public bool Equals(CatalogAgentPluginMediaType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override CatalogAgentPluginMediaType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, CatalogAgentPluginMediaType value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CatalogAgentPluginMediaType)); + } + } +} + + +/// Relationship of the backend-reported count to the complete query result set. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct CatalogSearchTotalCountRelation : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public CatalogSearchTotalCountRelation(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// No exact/full-query or lower-bound guarantee is available. + public static CatalogSearchTotalCountRelation Unknown { get; } = new("unknown"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CatalogSearchTotalCountRelation left, CatalogSearchTotalCountRelation right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CatalogSearchTotalCountRelation left, CatalogSearchTotalCountRelation right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is CatalogSearchTotalCountRelation other && Equals(other); + + /// + public bool Equals(CatalogSearchTotalCountRelation other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override CatalogSearchTotalCountRelation Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, CatalogSearchTotalCountRelation value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CatalogSearchTotalCountRelation)); + } + } +} + + /// What kind of resource a catalog candidate describes. [Experimental(Diagnostics.Experimental)] [JsonConverter(typeof(Converter))] @@ -23480,6 +25755,9 @@ public CatalogCandidateKind(string value) /// An AI skill, which is discoverable but not installable through this surface. public static CatalogCandidateKind AiSkill { get; } = new("ai-skill"); + /// An inert Agent Plugin candidate, available only when explicitly requested. + public static CatalogCandidateKind Plugin { get; } = new("plugin"); + /// Returns a value indicating whether two instances are equivalent. public static bool operator ==(CatalogCandidateKind left, CatalogCandidateKind right) => left.Equals(right); @@ -23517,6 +25795,75 @@ public override void Write(Utf8JsonWriter writer, CatalogCandidateKind value, Js } +/// Terminal outcome declared for a retained catalog selection group. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct CatalogSelectionDecision : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public CatalogSelectionDecision(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Choose the candidate named by selectionRef. + public static CatalogSelectionDecision Selected { get; } = new("selected"); + + /// Explicitly decline every candidate in the search. + public static CatalogSelectionDecision Declined { get; } = new("declined"); + + /// Cancel the selection interaction without choosing a candidate. + public static CatalogSelectionDecision Cancelled { get; } = new("cancelled"); + + /// Declare that the host's live interaction deadline elapsed while the reference remained valid. + public static CatalogSelectionDecision TimedOut { get; } = new("timed-out"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CatalogSelectionDecision left, CatalogSelectionDecision right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CatalogSelectionDecision left, CatalogSelectionDecision right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is CatalogSelectionDecision other && Equals(other); + + /// + public bool Equals(CatalogSelectionDecision other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override CatalogSelectionDecision Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, CatalogSelectionDecision value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CatalogSelectionDecision)); + } + } +} + + /// Where completed plugin content was staged before atomic promotion. [Experimental(Diagnostics.Experimental)] [JsonConverter(typeof(Converter))] @@ -26631,6 +28978,435 @@ public override void Write(Utf8JsonWriter writer, FactoryPauseCheckpointAction v } +/// Cumulative resource ceiling that stopped a workflow run. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct WorkflowRunFailureKind : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public WorkflowRunFailureKind(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The run admitted the approved maximum total number of subagents. + public static WorkflowRunFailureKind MaxTotalSubagents { get; } = new("maxTotalSubagents"); + + /// The run reached the approved accumulated active-execution time in seconds. + public static WorkflowRunFailureKind TimeoutSeconds { get; } = new("timeoutSeconds"); + + /// The run's settled subagent model usage exceeded the approved AI-credit ceiling, or no headroom remained for another subagent. + public static WorkflowRunFailureKind MaxAiCredits { get; } = new("maxAiCredits"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(WorkflowRunFailureKind left, WorkflowRunFailureKind right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(WorkflowRunFailureKind left, WorkflowRunFailureKind right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is WorkflowRunFailureKind other && Equals(other); + + /// + public bool Equals(WorkflowRunFailureKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override WorkflowRunFailureKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, WorkflowRunFailureKind value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(WorkflowRunFailureKind)); + } + } +} + + +/// Execution-critical workflow storage operation. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct WorkflowDurableOperation : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public WorkflowDurableOperation(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Creating the durable run and declared phases. + public static WorkflowDurableOperation CreateRun { get; } = new("createRun"); + + /// Persisting the transition to running. + public static WorkflowDurableOperation MarkRunStarted { get; } = new("markRunStarted"); + + /// Persisting the terminal run envelope. + public static WorkflowDurableOperation FinishRun { get; } = new("finishRun"); + + /// Persisting subagent admission accounting. + public static WorkflowDurableOperation ReserveAgent { get; } = new("reserveAgent"); + + /// Rolling back an uncommitted subagent admission. + public static WorkflowDurableOperation ReleaseAgent { get; } = new("releaseAgent"); + + /// Persisting an idempotent model-usage charge. + public static WorkflowDurableOperation ChargeCredit { get; } = new("chargeCredit"); + + /// Persisting active execution time. + public static WorkflowDurableOperation AddElapsed { get; } = new("addElapsed"); + + /// Reading the authoritative AI-credit total. + public static WorkflowDurableOperation ReconcileCreditTotal { get; } = new("reconcileCreditTotal"); + + /// Reading a journal entry without treating storage failure as a cache miss. + public static WorkflowDurableOperation JournalGet { get; } = new("journalGet"); + + /// Persisting a journal entry before reporting success. + public static WorkflowDurableOperation JournalPut { get; } = new("journalPut"); + + /// Renewing the durable owner lease that proves this process still owns the run. + public static WorkflowDurableOperation RefreshLease { get; } = new("refreshLease"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(WorkflowDurableOperation left, WorkflowDurableOperation right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(WorkflowDurableOperation left, WorkflowDurableOperation right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is WorkflowDurableOperation other && Equals(other); + + /// + public bool Equals(WorkflowDurableOperation other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override WorkflowDurableOperation Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, WorkflowDurableOperation value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(WorkflowDurableOperation)); + } + } +} + + +/// Current or terminal state of a workflow run. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct WorkflowRunStatus : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public WorkflowRunStatus(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The run was minted and is awaiting approval. + public static WorkflowRunStatus Pending { get; } = new("pending"); + + /// The run is executing. + public static WorkflowRunStatus Running { get; } = new("running"); + + /// The run completed successfully. + public static WorkflowRunStatus Completed { get; } = new("completed"); + + /// The run was interrupted while resource budget remained. + public static WorkflowRunStatus Halted { get; } = new("halted"); + + /// The current attempt stopped intentionally and the run may be resumed. + public static WorkflowRunStatus Paused { get; } = new("paused"); + + /// The run was cancelled before completion. + public static WorkflowRunStatus Cancelled { get; } = new("cancelled"); + + /// The workflow body failed or reached a cumulative resource ceiling. + public static WorkflowRunStatus Error { get; } = new("error"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(WorkflowRunStatus left, WorkflowRunStatus right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(WorkflowRunStatus left, WorkflowRunStatus right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is WorkflowRunStatus other && Equals(other); + + /// + public bool Equals(WorkflowRunStatus other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override WorkflowRunStatus Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, WorkflowRunStatus value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(WorkflowRunStatus)); + } + } +} + + +/// Derived lifecycle state of a workflow phase. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct WorkflowPhaseStatus : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public WorkflowPhaseStatus(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The phase has not been entered yet. + public static WorkflowPhaseStatus Pending { get; } = new("pending"); + + /// The phase is currently entered and accumulating active time. + public static WorkflowPhaseStatus Active { get; } = new("active"); + + /// The phase was entered and has since been closed. + public static WorkflowPhaseStatus Completed { get; } = new("completed"); + + /// The phase was never entered because a later phase was entered or the run reached a terminal state. + public static WorkflowPhaseStatus Skipped { get; } = new("skipped"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(WorkflowPhaseStatus left, WorkflowPhaseStatus right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(WorkflowPhaseStatus left, WorkflowPhaseStatus right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is WorkflowPhaseStatus other && Equals(other); + + /// + public bool Equals(WorkflowPhaseStatus other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override WorkflowPhaseStatus Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, WorkflowPhaseStatus value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(WorkflowPhaseStatus)); + } + } +} + + +/// Kind of workflow progress line. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct WorkflowLogLineKind : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public WorkflowLogLineKind(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// A narrator log line. + public static WorkflowLogLineKind Log { get; } = new("log"); + + /// A named workflow phase marker. + public static WorkflowLogLineKind Phase { get; } = new("phase"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(WorkflowLogLineKind left, WorkflowLogLineKind right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(WorkflowLogLineKind left, WorkflowLogLineKind right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is WorkflowLogLineKind other && Equals(other); + + /// + public bool Equals(WorkflowLogLineKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override WorkflowLogLineKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, WorkflowLogLineKind value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(WorkflowLogLineKind)); + } + } +} + + +/// Action the runtime selected for a durable workflow pause checkpoint. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct WorkflowPauseCheckpointAction : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public WorkflowPauseCheckpointAction(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The checkpoint was committed by a prior paused attempt, so execution may continue. + public static WorkflowPauseCheckpointAction Continue { get; } = new("continue"); + + /// This attempt claimed the checkpoint and must cooperatively stop. + public static WorkflowPauseCheckpointAction Pause { get; } = new("pause"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(WorkflowPauseCheckpointAction left, WorkflowPauseCheckpointAction right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(WorkflowPauseCheckpointAction left, WorkflowPauseCheckpointAction right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is WorkflowPauseCheckpointAction other && Equals(other); + + /// + public bool Equals(WorkflowPauseCheckpointAction other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override WorkflowPauseCheckpointAction Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, WorkflowPauseCheckpointAction value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(WorkflowPauseCheckpointAction)); + } + } +} + + /// Whether the requested preference was already effective or was accepted for later transactional activation. [Experimental(Diagnostics.Experimental)] [JsonConverter(typeof(Converter))] @@ -33450,17 +36226,35 @@ internal ServerCatalogApi(JsonRpc rpc) /// Protocol version and capabilities the caller requires. /// Free-text search query. Persisted as tool input for session continuity, but omitted from telemetry. /// Maximum number of candidates to return. Defaults to 10 when omitted. - /// Restrict results to these candidate kinds. When omitted, every kind the runtime supports is searched. + /// Restrict results to these candidate kinds. Agent Plugins are opt-in and require the `agent-plugin-discovery` capability so protocol-v3 clients generated before that variant cannot receive an unknown result; when omitted, the backwards-compatible MCP server and AI skill kinds are searched. + /// Numbered navigation using metadata from an earlier response. Requires catalog-search-pagination and the same query, kinds and effective limit. Omit for a fresh first-page search. /// The to monitor for cancellation requests. The default is . /// Outcome of a catalog.search call: either bounded inert candidates, or one typed refusal. Never a partial success. - public async Task SearchAsync(CatalogClientContract contract, string query, int? limit = null, IList? kinds = null, CancellationToken cancellationToken = default) + public async Task SearchAsync(CatalogClientContract contract, string query, int? limit = null, IList? kinds = null, CatalogSearchPage? page = null, CancellationToken cancellationToken = default) { ArgumentNullException.ThrowIfNull(contract); ArgumentNullException.ThrowIfNull(query); - var request = new CatalogSearchRequest { Contract = contract, Query = query, Limit = limit, Kinds = kinds }; + var request = new CatalogSearchRequest { Contract = contract, Query = query, Limit = limit, Kinds = kinds, Page = page }; return await CopilotClient.InvokeRpcAsync(_rpc, "catalog.search", [request], cancellationToken); } + + /// Terminates one retained catalog selection group. A selected outcome returns the native host a fresh single-use candidate handle plus the original searchId for a later explicit mcp.planInstall call; non-selected outcomes release the group without producing a planning input. Candidate state, cards, URLs, credentials and private identifiers remain inside the runtime. The model-facing catalog_select tool projects the result separately and never exposes the candidate handle or searchId. + /// Protocol version and capabilities the caller requires. + /// Locally owned root session whose retained search state is being resolved. + /// Opaque runtime-instance scoped reference to one visible candidate. For a non-selected outcome, any candidate reference from the same search closes that search's retained group. + /// The terminal outcome declared by the caller. Timed-out means the host's live interaction deadline elapsed; a reference whose runtime TTL elapsed is rejected separately as stale. + /// The to monitor for cancellation requests. The default is . + /// Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId. + public async Task SelectAsync(CatalogClientContract contract, string sessionId, string selectionRef, CatalogSelectionDecision outcome, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(contract); + ArgumentNullException.ThrowIfNull(sessionId); + ArgumentNullException.ThrowIfNull(selectionRef); + + var request = new CatalogSelectionRequest { Contract = contract, SessionId = sessionId, SelectionRef = selectionRef, Outcome = outcome }; + return await CopilotClient.InvokeRpcAsync(_rpc, "catalog.select", [request], cancellationToken); + } } /// Provides server-scoped Plugins APIs. @@ -33934,7 +36728,7 @@ internal ServerSessionFsApi(JsonRpc rpc) } /// Registers an SDK client as the session filesystem provider. - /// Initial working directory for sessions. + /// Absolute initial working directory for sessions. Registering the provider establishes this path as the root of its virtual namespace; the runtime does not require the provider to materialize or stat it before creating a session. /// Path within each session's SessionFs where the runtime stores files for that session. /// Path conventions used by this filesystem. /// Optional capabilities declared by the provider. @@ -34463,6 +37257,12 @@ internal SessionRpc(CopilotSession session) Interlocked.CompareExchange(ref field, new(_session), null) ?? field; + /// Workflow APIs. + public WorkflowApi Workflow => + field ?? + Interlocked.CompareExchange(ref field, new(_session), null) ?? + field; + /// Model APIs. public ModelApi Model => field ?? @@ -34541,6 +37341,12 @@ internal SessionRpc(CopilotSession session) Interlocked.CompareExchange(ref field, new(_session), null) ?? field; + /// ManagedSettings APIs. + public ManagedSettingsApi ManagedSettings => + field ?? + Interlocked.CompareExchange(ref field, new(_session), null) ?? + field; + /// Plugins APIs. public PluginsApi Plugins => field ?? @@ -35426,6 +38232,271 @@ public async Task PutAsync(string runId, string executionToken } } +/// Provides session-scoped Workflow APIs. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowApi +{ + private readonly CopilotSession _session; + + internal WorkflowApi(CopilotSession session) + { + _session = session; + } + + /// Runs a registered dynamic workflow by name at the top level. + /// Registered workflow name. + /// Workflow input value. + /// Workflow invocation options. + /// The to monitor for cancellation requests. The default is . + /// Complete current or terminal workflow run envelope. + public async Task RunAsync(string name, object args, WorkflowRunOptions? options = null, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(name); + ArgumentNullException.ThrowIfNull(args); + _session.ThrowIfDisposed(); + + var request = new WorkflowRunRequest { SessionId = _session.SessionId, Name = name, Args = CopilotClient.ToJsonElementForWire(args)!.Value, Options = options }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.run", [request], cancellationToken); + } + + /// Resumes a dynamic workflow run using its persisted name, arguments, journal, and accounting. + /// Workflow run identifier. + /// Optional per-invocation resource ceiling overrides. + /// Whether to notify the originating session when the workflow completes. + /// Whether to emit workflow phase names to the session transcript. + /// The to monitor for cancellation requests. The default is . + /// Resolved persisted workflow identity and resumed run envelope. + public async Task ResumeAsync(string runId, WorkflowRunLimits? limits = null, bool? notifyOnComplete = null, bool? logPhaseNames = null, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + _session.ThrowIfDisposed(); + + var request = new WorkflowResumeRequest { SessionId = _session.SessionId, RunId = runId, Limits = limits, NotifyOnComplete = notifyOnComplete, LogPhaseNames = logPhaseNames }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.resume", [request], cancellationToken); + } + + /// Internal tool-originated dynamic workflow invocation. + /// Registered workflow name. + /// Workflow input value. + /// Tool-originated workflow invocation options. + /// Opaque identifier of the originating tool call. + /// The to monitor for cancellation requests. The default is . + /// Complete current or terminal workflow run envelope. + internal async Task RunFromToolAsync(string name, object args, WorkflowToolRunOptions? options = null, string? toolCallId = null, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(name); + ArgumentNullException.ThrowIfNull(args); + _session.ThrowIfDisposed(); + + var request = new WorkflowToolRunRequest { SessionId = _session.SessionId, Name = name, Args = CopilotClient.ToJsonElementForWire(args)!.Value, Options = options, ToolCallId = toolCallId }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.runFromTool", [request], cancellationToken); + } + + /// Internal tool-originated dynamic workflow resume. + /// Workflow run identifier. + /// Optional per-invocation resource ceiling overrides. + /// Opaque identifier of the originating tool call. + /// The to monitor for cancellation requests. The default is . + /// Resolved persisted workflow identity and resumed run envelope. + internal async Task ResumeFromToolAsync(string runId, WorkflowRunLimits? limits = null, string? toolCallId = null, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + _session.ThrowIfDisposed(); + + var request = new WorkflowToolResumeRequest { SessionId = _session.SessionId, RunId = runId, Limits = limits, ToolCallId = toolCallId }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.resumeFromTool", [request], cancellationToken); + } + + /// Gets the current or settled envelope for a dynamic workflow run. + /// Workflow run identifier. + /// The to monitor for cancellation requests. The default is . + /// Complete current or terminal workflow run envelope. + public async Task GetRunAsync(string runId, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + _session.ThrowIfDisposed(); + + var request = new WorkflowGetRunRequest { SessionId = _session.SessionId, RunId = runId }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.getRun", [request], cancellationToken); + } + + /// Lists durable dynamic workflow runs for this session in creation order. + /// Exclusive forward cursor. + /// Exclusive backward cursor. + /// Maximum terminal runs to return. Defaults to 200 and is capped at 500. + /// The to monitor for cancellation requests. The default is . + /// A page of workflow runs in durable creation order. + public async Task ListRunsAsync(long? afterSeq = null, long? beforeSeq = null, int? limit = null, CancellationToken cancellationToken = default) + { + _session.ThrowIfDisposed(); + + var request = new WorkflowListRunsRequest { SessionId = _session.SessionId, AfterSeq = afterSeq, BeforeSeq = beforeSeq, Limit = limit }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.listRuns", [request], cancellationToken); + } + + /// Gets durable and live observability detail for one dynamic workflow run. + /// Workflow run identifier. + /// The to monitor for cancellation requests. The default is . + /// Full workflow run observability detail. + public async Task GetRunDetailAsync(string runId, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + _session.ThrowIfDisposed(); + + var request = new WorkflowGetRunRequest { SessionId = _session.SessionId, RunId = runId }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.getRunDetail", [request], cancellationToken); + } + + /// Pages durable progress for one dynamic workflow run. + /// Workflow run identifier. + /// Optional phase identifier used to scope records and cursors. + /// Exclusive forward cursor. + /// Exclusive backward cursor. + /// Maximum records to return. Defaults to 200 and is capped at 500. + /// The to monitor for cancellation requests. The default is . + /// A bidirectional page of workflow progress. + public async Task GetRunProgressAsync(string runId, string? phaseId = null, long? afterSeq = null, long? beforeSeq = null, int? limit = null, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + _session.ThrowIfDisposed(); + + var request = new WorkflowGetRunProgressRequest { SessionId = _session.SessionId, RunId = runId, PhaseId = phaseId, AfterSeq = afterSeq, BeforeSeq = beforeSeq, Limit = limit }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.getRunProgress", [request], cancellationToken); + } + + /// Requests cancellation of a dynamic workflow run and returns its run envelope. + /// Workflow run identifier. + /// The to monitor for cancellation requests. The default is . + /// Complete current or terminal workflow run envelope. + public async Task CancelAsync(string runId, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + _session.ThrowIfDisposed(); + + var request = new WorkflowCancelRequest { SessionId = _session.SessionId, RunId = runId }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.cancel", [request], cancellationToken); + } + + /// Pauses a running dynamic workflow and returns its settled run envelope. + /// Workflow run identifier. + /// The to monitor for cancellation requests. The default is . + /// Complete current or terminal workflow run envelope. + public async Task PauseAsync(string runId, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + _session.ThrowIfDisposed(); + + var request = new WorkflowPauseRequest { SessionId = _session.SessionId, RunId = runId }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.pause", [request], cancellationToken); + } + + /// Atomically pauses an owned dynamic workflow attempt at a durable checkpoint. + /// Workflow run identifier. + /// Opaque token identifying the execution attempt that reached the checkpoint. + /// Stable author-defined checkpoint key. + /// The to monitor for cancellation requests. The default is . + internal async Task PauseAtCheckpointAsync(string runId, string executionToken, string key, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + ArgumentNullException.ThrowIfNull(executionToken); + ArgumentNullException.ThrowIfNull(key); + _session.ThrowIfDisposed(); + + var request = new WorkflowPauseCheckpointRequest { SessionId = _session.SessionId, RunId = runId, ExecutionToken = executionToken, Key = key }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.pauseAtCheckpoint", [request], cancellationToken); + } + + /// Records a batch of ordered dynamic workflow progress lines. + /// Workflow run identifier. + /// Opaque token identifying the current workflow execution attempt. + /// Ordered progress lines to append. + /// The to monitor for cancellation requests. The default is . + /// Acknowledgement that a workflow request was accepted. + public async Task LogAsync(string runId, string executionToken, IList lines, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + ArgumentNullException.ThrowIfNull(executionToken); + ArgumentNullException.ThrowIfNull(lines); + _session.ThrowIfDisposed(); + + var request = new WorkflowLogRequest { SessionId = _session.SessionId, RunId = runId, ExecutionToken = executionToken, Lines = lines }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.log", [request], cancellationToken); + } + + /// Runs one dynamic-workflow-scoped subagent and returns its result. + /// Workflow run identifier that owns the subagent. + /// Opaque token identifying the current workflow execution attempt. + /// Prompt to send to the subagent. + /// Subagent execution options. + /// The to monitor for cancellation requests. The default is . + /// Result of one workflow-scoped subagent call. + public async Task AgentAsync(string workflowRunId, string executionToken, string prompt, WorkflowAgentOptions opts, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(workflowRunId); + ArgumentNullException.ThrowIfNull(executionToken); + ArgumentNullException.ThrowIfNull(prompt); + ArgumentNullException.ThrowIfNull(opts); + _session.ThrowIfDisposed(); + + var request = new WorkflowAgentRequest { SessionId = _session.SessionId, WorkflowRunId = workflowRunId, ExecutionToken = executionToken, Prompt = prompt, Opts = opts }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.agent", [request], cancellationToken); + } + + /// Journal APIs. + public WorkflowJournalApi Journal => + field ?? + Interlocked.CompareExchange(ref field, new(_session), null) ?? + field; +} + +/// Provides session-scoped WorkflowJournal APIs. +[Experimental(Diagnostics.Experimental)] +public sealed class WorkflowJournalApi +{ + private readonly CopilotSession _session; + + internal WorkflowJournalApi(CopilotSession session) + { + _session = session; + } + + /// Reads a memoized dynamic workflow journal entry. + /// Workflow run identifier. + /// Opaque token identifying the current workflow execution attempt. + /// Namespaced journal key. + /// The to monitor for cancellation requests. The default is . + /// Result of reading a workflow journal entry. + public async Task GetAsync(string runId, string executionToken, string key, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + ArgumentNullException.ThrowIfNull(executionToken); + ArgumentNullException.ThrowIfNull(key); + _session.ThrowIfDisposed(); + + var request = new WorkflowJournalGetRequest { SessionId = _session.SessionId, RunId = runId, ExecutionToken = executionToken, Key = key }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.journal.get", [request], cancellationToken); + } + + /// Stores a memoized dynamic workflow journal entry. + /// Workflow run identifier. + /// Opaque token identifying the current workflow execution attempt. + /// Namespaced journal key. + /// JSON result to memoize. + /// The to monitor for cancellation requests. The default is . + /// Acknowledgement that a workflow request was accepted. + public async Task PutAsync(string runId, string executionToken, string key, object resultJson, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(runId); + ArgumentNullException.ThrowIfNull(executionToken); + ArgumentNullException.ThrowIfNull(key); + ArgumentNullException.ThrowIfNull(resultJson); + _session.ThrowIfDisposed(); + + var request = new WorkflowJournalPutRequest { SessionId = _session.SessionId, RunId = runId, ExecutionToken = executionToken, Key = key, ResultJson = CopilotClient.ToJsonElementForWire(resultJson)!.Value }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.workflow.journal.put", [request], cancellationToken); + } +} + /// Provides session-scoped Model APIs. [Experimental(Diagnostics.Experimental)] public sealed class ModelApi @@ -35492,6 +38563,7 @@ public async Task SwitchAutoTierAsync(AutoTier? autoT /// Model required by device-managed policy, when configured. /// Model required by server-managed policy, when configured. /// Startup default model from the enterprise policy helper, when configured. Weakest of the managed sources: it applies only when neither device nor server policy names a model, and an explicit user selection still wins. + /// Effective default Auto routing preference from user and managed settings. Applies only to fresh sessions and never replaces a per-session selection. /// Model selected by repository settings, when configured. /// Reasoning effort selected by repository settings, when configured. /// Context tier selected by repository settings, when configured. @@ -35500,11 +38572,11 @@ public async Task SwitchAutoTierAsync(AutoTier? autoT /// Whether the overlay is being applied while resuming a deferred session. /// The to monitor for cancellation requests. The default is . /// The model identifier active on the session after the switch. - internal async Task ApplyStartupOverlayAsync(string? deviceManagedModel = null, string? serverManagedModel = null, string? policyHelperModel = null, string? repoModel = null, string? repoReasoningEffort = null, string? repoContextTier = null, string? repoAutoTier = null, string? cliModel = null, bool? deferredResume = null, CancellationToken cancellationToken = default) + internal async Task ApplyStartupOverlayAsync(string? deviceManagedModel = null, string? serverManagedModel = null, string? policyHelperModel = null, AutoTier? autoTier = null, string? repoModel = null, string? repoReasoningEffort = null, string? repoContextTier = null, string? repoAutoTier = null, string? cliModel = null, bool? deferredResume = null, CancellationToken cancellationToken = default) { _session.ThrowIfDisposed(); - var request = new ModelApplyStartupOverlayRequest { SessionId = _session.SessionId, DeviceManagedModel = deviceManagedModel, ServerManagedModel = serverManagedModel, PolicyHelperModel = policyHelperModel, RepoModel = repoModel, RepoReasoningEffort = repoReasoningEffort, RepoContextTier = repoContextTier, RepoAutoTier = repoAutoTier, CliModel = cliModel, DeferredResume = deferredResume }; + var request = new ModelApplyStartupOverlayRequest { SessionId = _session.SessionId, DeviceManagedModel = deviceManagedModel, ServerManagedModel = serverManagedModel, PolicyHelperModel = policyHelperModel, AutoTier = autoTier, RepoModel = repoModel, RepoReasoningEffort = repoReasoningEffort, RepoContextTier = repoContextTier, RepoAutoTier = repoAutoTier, CliModel = cliModel, DeferredResume = deferredResume }; return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.model.applyStartupOverlay", [request], cancellationToken); } @@ -36950,6 +40022,29 @@ public async Task ListTemplatesAsync(string ser } } +/// Provides session-scoped ManagedSettings APIs. +[Experimental(Diagnostics.Experimental)] +public sealed class ManagedSettingsApi +{ + private readonly CopilotSession _session; + + internal ManagedSettingsApi(CopilotSession session) + { + _session = session; + } + + /// Waits for the live session's in-flight managed-settings application, then returns the retained effective snapshot used by runtime enforcement and by `session.managed_settings_resolved`. It does not perform another account, device, or server resolution, and rejects when resolution has not produced a snapshot. + /// The to monitor for cancellation requests. The default is . + /// Enterprise managed-settings resolution: the effective managed settings the session applied and which channels contributed, so SDK clients can show users what is enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on resume, and on account switch. This is an ephemeral live snapshot (delivered to subscribers but not persisted to the session event log), because at session start it resolves before `session.start` is emitted. Device values take precedence over server values, then the policy helper, per ordinary key, while permissions compose restrictively across device, server, policy-helper, and SDK-client layers. The account-scoped `getManagedSettings()` API does not include session-local client injection. Marked experimental while the managed-settings surface stabilizes. + public async Task GetAsync(CancellationToken cancellationToken = default) + { + _session.ThrowIfDisposed(); + + var request = new SessionManagedSettingsGetRequest { SessionId = _session.SessionId }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.managedSettings.get", [request], cancellationToken); + } +} + /// Provides session-scoped Plugins APIs. [Experimental(Diagnostics.Experimental)] public sealed class PluginsApi @@ -36961,7 +40056,7 @@ internal PluginsApi(CopilotSession session) _session = session; } - /// Lists plugins installed for the session. + /// Lists globally installed, live, built-in, and enterprise-managed desired plugins using the live session's authoritative account, working directory, and retained managed policy. /// The to monitor for cancellation requests. The default is . /// Plugins installed for the session, with their enabled state and version metadata. public async Task ListAsync(CancellationToken cancellationToken = default) @@ -36972,6 +40067,69 @@ public async Task ListAsync(CancellationToken cancellationToken = de return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.list", [request], cancellationToken); } + /// Installs a plugin using the live session's authoritative account, working directory, and retained managed policy. + /// Plugin install spec. Accepts the same forms as the CLI: "plugin@marketplace" (marketplace install), "owner/repo" or "owner/repo:subpath" (GitHub direct), an http/https/ssh URL, or a local path. Direct (non-marketplace) installs are deprecated and will produce a deprecationWarning in the result. + /// The to monitor for cancellation requests. The default is . + /// Result of installing a plugin. + public async Task InstallAsync(string source, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(source); + _session.ThrowIfDisposed(); + + var request = new SessionPluginsInstallRequest { SessionId = _session.SessionId, Source = source }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.install", [request], cancellationToken); + } + + /// Uninstalls a plugin when permitted by the live session's retained managed policy. + /// Plugin name or "plugin@marketplace" spec to uninstall. When ambiguous, prefer the fully-qualified spec. + /// Stable source identity for a direct (non-marketplace) install. Disambiguates uninstall when multiple installed plugins share the same name. + /// The to monitor for cancellation requests. The default is . + public async Task UninstallAsync(string name, string? directSourceId = null, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(name); + _session.ThrowIfDisposed(); + + var request = new PluginsUninstallRequestWithSession { SessionId = _session.SessionId, Name = name, DirectSourceId = directSourceId }; + await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.uninstall", [request], cancellationToken); + } + + /// Updates an installed plugin using the live session's authoritative account, working directory, and retained managed policy. + /// Plugin name or "plugin@marketplace" spec to update. + /// The to monitor for cancellation requests. The default is . + /// Result of updating a single plugin. + public async Task UpdateAsync(string name, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(name); + _session.ThrowIfDisposed(); + + var request = new PluginsUpdateRequestWithSession { SessionId = _session.SessionId, Name = name }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.update", [request], cancellationToken); + } + + /// Enables installed plugins when permitted by the live session's retained managed policy. + /// Plugin names or "plugin@marketplace" specs to enable. Unknown names are ignored. Non-marketplace direct installs are always enabled and cannot be toggled via this API. + /// The to monitor for cancellation requests. The default is . + public async Task EnableAsync(IList names, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(names); + _session.ThrowIfDisposed(); + + var request = new SessionPluginsEnableRequest { SessionId = _session.SessionId, Names = names }; + await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.enable", [request], cancellationToken); + } + + /// Disables installed plugins when permitted by the live session's retained managed policy. + /// Plugin names or "plugin@marketplace" specs to disable. Unknown names are ignored. Non-marketplace direct installs cannot be disabled via this API; uninstall them instead. Plugin-owned MCP servers are stopped in active sessions immediately; other plugin contributions remain available until each session reloads plugins. + /// The to monitor for cancellation requests. The default is . + public async Task DisableAsync(IList names, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(names); + _session.ThrowIfDisposed(); + + var request = new SessionPluginsDisableRequest { SessionId = _session.SessionId, Names = names }; + await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.disable", [request], cancellationToken); + } + /// 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. /// Optional flags controlling which side effects the reload performs. /// The to monitor for cancellation requests. The default is . @@ -36982,6 +40140,88 @@ public async Task ReloadAsync(SessionPluginsReloadRequest? request = null, Cance var rpcRequest = new SessionPluginsReloadRequestWithSession { SessionId = _session.SessionId, ReloadMcp = request?.ReloadMcp, ReloadCustomAgents = request?.ReloadCustomAgents, ReloadHooks = request?.ReloadHooks, ReloadExtensions = request?.ReloadExtensions, DeferRepoHooks = request?.DeferRepoHooks }; await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.reload", [rpcRequest], cancellationToken); } + + /// Marketplaces APIs. + public PluginsMarketplacesApi Marketplaces => + field ?? + Interlocked.CompareExchange(ref field, new(_session), null) ?? + field; +} + +/// Provides session-scoped PluginsMarketplaces APIs. +[Experimental(Diagnostics.Experimental)] +public sealed class PluginsMarketplacesApi +{ + private readonly CopilotSession _session; + + internal PluginsMarketplacesApi(CopilotSession session) + { + _session = session; + } + + /// Lists registered and enterprise-managed desired marketplaces using the live session's retained policy. + /// The to monitor for cancellation requests. The default is . + /// All registered marketplaces, including built-in defaults. + public async Task ListAsync(CancellationToken cancellationToken = default) + { + _session.ThrowIfDisposed(); + + var request = new SessionPluginsMarketplacesListRequest { SessionId = _session.SessionId }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.marketplaces.list", [request], cancellationToken); + } + + /// Adds a marketplace when permitted by the live session's retained managed policy. + /// Marketplace source. Accepts the same forms as the CLI: "owner/repo" or "owner/repo#ref" (GitHub), an http/https/ssh URL (optionally with #ref), a git scp-style URL (user@host:path), or a local path. The marketplace's own name (from its manifest) is used as the registration key. + /// Working directory used to resolve relative local paths in `source`. Defaults to the server's current working directory. + /// The to monitor for cancellation requests. The default is . + /// Result of registering a new marketplace. + public async Task AddAsync(string source, string? workingDirectory = null, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(source); + _session.ThrowIfDisposed(); + + var request = new PluginsMarketplacesAddRequestWithSession { SessionId = _session.SessionId, Source = source, WorkingDirectory = workingDirectory }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.marketplaces.add", [request], cancellationToken); + } + + /// Removes a marketplace when permitted by the live session's retained managed policy. + /// Marketplace name to remove. + /// When true, also uninstall every plugin sourced from this marketplace. When false (default), removal is a no-op if any plugin from this marketplace is installed and the dependent plugin names are returned in the result. + /// The to monitor for cancellation requests. The default is . + /// Outcome of the remove attempt, including dependent-plugin info when applicable. + public async Task RemoveAsync(string name, bool? force = null, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(name); + _session.ThrowIfDisposed(); + + var request = new PluginsMarketplacesRemoveRequestWithSession { SessionId = _session.SessionId, Name = name, Force = force }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.marketplaces.remove", [request], cancellationToken); + } + + /// Browses a marketplace resolved through the live session's working directory and retained managed policy. + /// Marketplace name to browse. + /// The to monitor for cancellation requests. The default is . + /// Plugins advertised by the marketplace. + public async Task BrowseAsync(string name, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(name); + _session.ThrowIfDisposed(); + + var request = new PluginsMarketplacesBrowseRequestWithSession { SessionId = _session.SessionId, Name = name }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.marketplaces.browse", [request], cancellationToken); + } + + /// Refreshes marketplaces resolved through the live session's working directory and retained managed policy. + /// Optional marketplace name; omit to refresh all. + /// The to monitor for cancellation requests. The default is . + /// Result of refreshing one or more marketplace catalogs. + public async Task RefreshAsync(SessionPluginsMarketplacesRefreshRequest? request = null, CancellationToken cancellationToken = default) + { + _session.ThrowIfDisposed(); + + var rpcRequest = new SessionPluginsMarketplacesRefreshRequestWithSession { SessionId = _session.SessionId, Name = request?.Name }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.plugins.marketplaces.refresh", [rpcRequest], cancellationToken); + } } /// Provides session-scoped Provider APIs. @@ -38469,6 +41709,43 @@ public async Task UpdateTextAsync(string id, string promp return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.queue.updateText", [request], cancellationToken); } + /// Atomically withdraws an unchanged, unconsumed user message from the local queued or steering lane. A client retaining the original draft may restore it only when removed is true. Does not interrupt the running turn. + /// Message identity returned by send, not the queue item id. Batch messages are not eligible. + /// The prompt originally sent. A message edited since submission is not withdrawn, so an obsolete draft cannot replace the edit. + /// The to monitor for cancellation requests. The default is . + /// Result of removing a queued item. + public async Task WithdrawMessageAsync(string messageId, string expectedPrompt, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(messageId); + ArgumentNullException.ThrowIfNull(expectedPrompt); + _session.ThrowIfDisposed(); + + var request = new QueueWithdrawMessageRequest { SessionId = _session.SessionId, MessageId = messageId, ExpectedPrompt = expectedPrompt }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.queue.withdrawMessage", [request], cancellationToken); + } + + /// Atomically appends text and attachments to an unchanged, unconsumed local steering message. Returns updated=false if delivery or withdrawal already claimed the message. + /// Message identity returned by send, not the queue item id. Only unclaimed user steering messages are eligible. + /// Expected current prompt, including any previous appends. The runtime applies plan-mode normalization before comparing and refuses a changed message. + /// Mode captured at submission. Only steering messages in the same mode may be combined. + /// Text to append after a blank line. + /// Display text to append to the existing preview after a blank line. + /// Attachments to add after the message's existing attachments. An empty list preserves the existing attachments. + /// The to monitor for cancellation requests. The default is . + /// Result of editing a queued message. + public async Task AppendSteeringAsync(string messageId, string expectedPrompt, SendAgentMode agentMode, string prompt, string displayPrompt, IList attachments, CancellationToken cancellationToken = default) + { + ArgumentNullException.ThrowIfNull(messageId); + ArgumentNullException.ThrowIfNull(expectedPrompt); + ArgumentNullException.ThrowIfNull(prompt); + ArgumentNullException.ThrowIfNull(displayPrompt); + ArgumentNullException.ThrowIfNull(attachments); + _session.ThrowIfDisposed(); + + var request = new QueueAppendSteeringRequest { SessionId = _session.SessionId, MessageId = messageId, ExpectedPrompt = expectedPrompt, AgentMode = agentMode, Prompt = prompt, DisplayPrompt = displayPrompt, Attachments = attachments }; + return await CopilotClient.InvokeRpcAsync(_session.Rpc, "session.queue.appendSteering", [request], cancellationToken); + } + /// Duplicates an addressable queued item immediately after its source. /// Stable opaque ID of the queued item to duplicate. /// The to monitor for cancellation requests. The default is . @@ -38966,6 +42243,22 @@ public interface IFactoryHandler Task AbortAsync(FactoryAbortRequest request, CancellationToken cancellationToken = default); } +/// Handles `workflow` client session API methods. +[Experimental(Diagnostics.Experimental)] +public interface IWorkflowHandler +{ + /// Asks the owning extension connection to execute a registered dynamic workflow. + /// Parameters sent to the owning extension to execute a workflow closure. + /// The to monitor for cancellation requests. The default is . + /// Result returned by an extension workflow closure. + Task ExecuteAsync(WorkflowExecuteRequest request, CancellationToken cancellationToken = default); + /// Asks the owning extension connection to abort a running dynamic workflow cooperatively. + /// Parameters for cooperatively aborting a workflow body. + /// The to monitor for cancellation requests. The default is . + /// Acknowledgement that a workflow request was accepted. + Task AbortAsync(WorkflowAbortRequest request, CancellationToken cancellationToken = default); +} + /// Handles `tasks` client session API methods. [Experimental(Diagnostics.Experimental)] public interface ITasksHandler @@ -39077,6 +42370,9 @@ public sealed class ClientSessionApiHandlers /// Optional handler for Factory client session API methods. public IFactoryHandler? Factory { get; set; } + /// Optional handler for Workflow client session API methods. + public IWorkflowHandler? Workflow { get; set; } + /// Optional handler for Tasks client session API methods. public ITasksHandler? Tasks { get; set; } @@ -39115,6 +42411,18 @@ public static void RegisterClientSessionApiHandlers(JsonRpc rpc, Func>)(async (request, cancellationToken) => + { + var handler = getHandlers(request.SessionId).Workflow; + if (handler is null) throw new InvalidOperationException($"No workflow handler registered for session: {request.SessionId}"); + return await handler.ExecuteAsync(request, cancellationToken); + }), singleObjectParam: true); + rpc.SetLocalRpcMethod("workflow.abort", (Func>)(async (request, cancellationToken) => + { + var handler = getHandlers(request.SessionId).Workflow; + if (handler is null) throw new InvalidOperationException($"No workflow handler registered for session: {request.SessionId}"); + return await handler.AbortAsync(request, cancellationToken); + }), singleObjectParam: true); rpc.SetLocalRpcMethod("tasks.cancel", (Func>)(async (request, cancellationToken) => { var handler = getHandlers(request.SessionId).Tasks; @@ -39508,6 +42816,11 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(GitHub.Copilot.HookProgressEvent), TypeInfoPropertyName = "SessionEventsHookProgressEvent")] [JsonSerializable(typeof(GitHub.Copilot.HookStartData), TypeInfoPropertyName = "SessionEventsHookStartData")] [JsonSerializable(typeof(GitHub.Copilot.HookStartEvent), TypeInfoPropertyName = "SessionEventsHookStartEvent")] +[JsonSerializable(typeof(GitHub.Copilot.IndexedSearchDisabledReason), TypeInfoPropertyName = "SessionEventsIndexedSearchDisabledReason")] +[JsonSerializable(typeof(GitHub.Copilot.IndexedSearchErrorType), TypeInfoPropertyName = "SessionEventsIndexedSearchErrorType")] +[JsonSerializable(typeof(GitHub.Copilot.IndexedSearchIncrementalPhase), TypeInfoPropertyName = "SessionEventsIndexedSearchIncrementalPhase")] +[JsonSerializable(typeof(GitHub.Copilot.IndexedSearchOutcome), TypeInfoPropertyName = "SessionEventsIndexedSearchOutcome")] +[JsonSerializable(typeof(GitHub.Copilot.IndexedSearchState), TypeInfoPropertyName = "SessionEventsIndexedSearchState")] [JsonSerializable(typeof(GitHub.Copilot.ManagedSettingsEnforcedAction), TypeInfoPropertyName = "SessionEventsManagedSettingsEnforcedAction")] [JsonSerializable(typeof(GitHub.Copilot.ManagedSettingsEnforcedEscalation), TypeInfoPropertyName = "SessionEventsManagedSettingsEnforcedEscalation")] [JsonSerializable(typeof(GitHub.Copilot.ManagedSettingsResolvedSource), TypeInfoPropertyName = "SessionEventsManagedSettingsResolvedSource")] @@ -39557,6 +42870,7 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(GitHub.Copilot.OmittedBinaryType), TypeInfoPropertyName = "SessionEventsOmittedBinaryType")] [JsonSerializable(typeof(GitHub.Copilot.PendingMessagesModifiedData), TypeInfoPropertyName = "SessionEventsPendingMessagesModifiedData")] [JsonSerializable(typeof(GitHub.Copilot.PendingMessagesModifiedEvent), TypeInfoPropertyName = "SessionEventsPendingMessagesModifiedEvent")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionApprovalEvaluation), TypeInfoPropertyName = "SessionEventsPermissionApprovalEvaluation")] [JsonSerializable(typeof(GitHub.Copilot.PermissionAssentDetectedData), TypeInfoPropertyName = "SessionEventsPermissionAssentDetectedData")] [JsonSerializable(typeof(GitHub.Copilot.PermissionAssentDetectedEvent), TypeInfoPropertyName = "SessionEventsPermissionAssentDetectedEvent")] [JsonSerializable(typeof(GitHub.Copilot.PermissionAssistedApproval), TypeInfoPropertyName = "SessionEventsPermissionAssistedApproval")] @@ -39591,6 +42905,14 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(GitHub.Copilot.PermissionPromptRequestUrl), TypeInfoPropertyName = "SessionEventsPermissionPromptRequestUrl")] [JsonSerializable(typeof(GitHub.Copilot.PermissionPromptRequestWrite), TypeInfoPropertyName = "SessionEventsPermissionPromptRequestWrite")] [JsonSerializable(typeof(GitHub.Copilot.PermissionRecommendation), TypeInfoPropertyName = "SessionEventsPermissionRecommendation")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionRecoveryAttempt), TypeInfoPropertyName = "SessionEventsPermissionRecoveryAttempt")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionRecoveryAttemptDisposition), TypeInfoPropertyName = "SessionEventsPermissionRecoveryAttemptDisposition")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionRecoveryAttemptReason), TypeInfoPropertyName = "SessionEventsPermissionRecoveryAttemptReason")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionRecoveryAttemptRelation), TypeInfoPropertyName = "SessionEventsPermissionRecoveryAttemptRelation")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionRecoveryData), TypeInfoPropertyName = "SessionEventsPermissionRecoveryData")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionRecoveryOnBlocked), TypeInfoPropertyName = "SessionEventsPermissionRecoveryOnBlocked")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionRecoveryReason), TypeInfoPropertyName = "SessionEventsPermissionRecoveryReason")] +[JsonSerializable(typeof(GitHub.Copilot.PermissionRecoveryStatus), TypeInfoPropertyName = "SessionEventsPermissionRecoveryStatus")] [JsonSerializable(typeof(GitHub.Copilot.PermissionRequest), TypeInfoPropertyName = "SessionEventsPermissionRequest")] [JsonSerializable(typeof(GitHub.Copilot.PermissionRequestCustomTool), TypeInfoPropertyName = "SessionEventsPermissionRequestCustomTool")] [JsonSerializable(typeof(GitHub.Copilot.PermissionRequestExtensionEnvAccess), TypeInfoPropertyName = "SessionEventsPermissionRequestExtensionEnvAccess")] @@ -39623,12 +42945,26 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(GitHub.Copilot.ReasoningSummary), TypeInfoPropertyName = "SessionEventsReasoningSummary")] [JsonSerializable(typeof(GitHub.Copilot.RecommendedAutoTier), TypeInfoPropertyName = "SessionEventsRecommendedAutoTier")] [JsonSerializable(typeof(GitHub.Copilot.RemediationAction), TypeInfoPropertyName = "SessionEventsRemediationAction")] +[JsonSerializable(typeof(GitHub.Copilot.ResponsesReasoning), TypeInfoPropertyName = "SessionEventsResponsesReasoning")] [JsonSerializable(typeof(GitHub.Copilot.SamplingCompletedData), TypeInfoPropertyName = "SessionEventsSamplingCompletedData")] [JsonSerializable(typeof(GitHub.Copilot.SamplingCompletedEvent), TypeInfoPropertyName = "SessionEventsSamplingCompletedEvent")] [JsonSerializable(typeof(GitHub.Copilot.SamplingRequestedData), TypeInfoPropertyName = "SessionEventsSamplingRequestedData")] [JsonSerializable(typeof(GitHub.Copilot.SamplingRequestedEvent), TypeInfoPropertyName = "SessionEventsSamplingRequestedEvent")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxAttestation), TypeInfoPropertyName = "SessionEventsSandboxAttestation")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxBackend), TypeInfoPropertyName = "SessionEventsSandboxBackend")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxBypassSource), TypeInfoPropertyName = "SessionEventsSandboxBypassSource")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxControl), TypeInfoPropertyName = "SessionEventsSandboxControl")] [JsonSerializable(typeof(GitHub.Copilot.SandboxDecisionData), TypeInfoPropertyName = "SessionEventsSandboxDecisionData")] [JsonSerializable(typeof(GitHub.Copilot.SandboxDecisionEvent), TypeInfoPropertyName = "SessionEventsSandboxDecisionEvent")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxDegradationReason), TypeInfoPropertyName = "SessionEventsSandboxDegradationReason")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxDenialClass), TypeInfoPropertyName = "SessionEventsSandboxDenialClass")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxDenialConfidence), TypeInfoPropertyName = "SessionEventsSandboxDenialConfidence")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxEnforcementPoint), TypeInfoPropertyName = "SessionEventsSandboxEnforcementPoint")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxFilesystemPolicyDetails), TypeInfoPropertyName = "SessionEventsSandboxFilesystemPolicyDetails")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxOutcome), TypeInfoPropertyName = "SessionEventsSandboxOutcome")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxPlatform), TypeInfoPropertyName = "SessionEventsSandboxPlatform")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxPolicySource), TypeInfoPropertyName = "SessionEventsSandboxPolicySource")] +[JsonSerializable(typeof(GitHub.Copilot.SandboxProxyMode), TypeInfoPropertyName = "SessionEventsSandboxProxyMode")] [JsonSerializable(typeof(GitHub.Copilot.ScheduleOrigin), TypeInfoPropertyName = "SessionEventsScheduleOrigin")] [JsonSerializable(typeof(GitHub.Copilot.SessionEvent), TypeInfoPropertyName = "SessionEventsSessionEvent")] [JsonSerializable(typeof(GitHub.Copilot.SessionLimitsConfig), TypeInfoPropertyName = "SessionEventsSessionLimitsConfig")] @@ -39690,6 +43026,8 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(GitHub.Copilot.SystemNotificationShellCompleted), TypeInfoPropertyName = "SessionEventsSystemNotificationShellCompleted")] [JsonSerializable(typeof(GitHub.Copilot.SystemNotificationShellDetachedCompleted), TypeInfoPropertyName = "SessionEventsSystemNotificationShellDetachedCompleted")] [JsonSerializable(typeof(GitHub.Copilot.SystemNotificationUnclassified), TypeInfoPropertyName = "SessionEventsSystemNotificationUnclassified")] +[JsonSerializable(typeof(GitHub.Copilot.TaskBlocker), TypeInfoPropertyName = "SessionEventsTaskBlocker")] +[JsonSerializable(typeof(GitHub.Copilot.TaskBlockerKind), TypeInfoPropertyName = "SessionEventsTaskBlockerKind")] [JsonSerializable(typeof(GitHub.Copilot.TaskCompletionOutcome), TypeInfoPropertyName = "SessionEventsTaskCompletionOutcome")] [JsonSerializable(typeof(GitHub.Copilot.ToolExecutionCompleteContent), TypeInfoPropertyName = "SessionEventsToolExecutionCompleteContent")] [JsonSerializable(typeof(GitHub.Copilot.ToolExecutionCompleteContentAudio), TypeInfoPropertyName = "SessionEventsToolExecutionCompleteContentAudio")] @@ -39814,14 +43152,20 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(CanvasSessionContext))] [JsonSerializable(typeof(CapiSessionOptions))] [JsonSerializable(typeof(CardDigest))] +[JsonSerializable(typeof(CatalogAgentPluginCandidateProvenance))] [JsonSerializable(typeof(CatalogAiSkillCandidateProvenance))] [JsonSerializable(typeof(CatalogCandidate))] [JsonSerializable(typeof(CatalogCandidateSource))] [JsonSerializable(typeof(CatalogClientContract))] [JsonSerializable(typeof(CatalogMcpServerCandidateProvenance))] [JsonSerializable(typeof(CatalogNegotiatedContract))] +[JsonSerializable(typeof(CatalogPluginRepositorySource))] +[JsonSerializable(typeof(CatalogSearchPage))] +[JsonSerializable(typeof(CatalogSearchPagination))] [JsonSerializable(typeof(CatalogSearchRequest))] [JsonSerializable(typeof(CatalogSearchResult))] +[JsonSerializable(typeof(CatalogSelectionRequest))] +[JsonSerializable(typeof(CatalogSelectionResult))] [JsonSerializable(typeof(CatalogTrustProvenance))] [JsonSerializable(typeof(CatalogTrustSnapshot))] [JsonSerializable(typeof(ClientTaskCancelRequest))] @@ -39851,6 +43195,7 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(ContextHeaviestMessage))] [JsonSerializable(typeof(CopilotUserResponse))] [JsonSerializable(typeof(CopilotUserResponseEndpoints))] +[JsonSerializable(typeof(CopilotUserResponseEnterpriseList))] [JsonSerializable(typeof(CopilotUserResponseOrganizationListItem))] [JsonSerializable(typeof(CopilotUserResponseQuotaSnapshots))] [JsonSerializable(typeof(CopilotUserResponseQuotaSnapshotsChat))] @@ -39993,6 +43338,7 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(LogResult))] [JsonSerializable(typeof(LspInitializeRequest))] [JsonSerializable(typeof(ManagedSettingsReadResult))] +[JsonSerializable(typeof(ManagedSettingsResolvedData))] [JsonSerializable(typeof(MarketplaceAddResult))] [JsonSerializable(typeof(MarketplaceBrowseResult))] [JsonSerializable(typeof(MarketplaceInfo))] @@ -40232,11 +43578,16 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(PluginsEnableRequest))] [JsonSerializable(typeof(PluginsInstallRequest))] [JsonSerializable(typeof(PluginsMarketplacesAddRequest))] +[JsonSerializable(typeof(PluginsMarketplacesAddRequestWithSession))] [JsonSerializable(typeof(PluginsMarketplacesBrowseRequest))] +[JsonSerializable(typeof(PluginsMarketplacesBrowseRequestWithSession))] [JsonSerializable(typeof(PluginsMarketplacesRefreshRequest))] [JsonSerializable(typeof(PluginsMarketplacesRemoveRequest))] +[JsonSerializable(typeof(PluginsMarketplacesRemoveRequestWithSession))] [JsonSerializable(typeof(PluginsUninstallRequest))] +[JsonSerializable(typeof(PluginsUninstallRequestWithSession))] [JsonSerializable(typeof(PluginsUpdateRequest))] +[JsonSerializable(typeof(PluginsUpdateRequestWithSession))] [JsonSerializable(typeof(ProtocolExternalToolDefinition))] [JsonSerializable(typeof(ProtocolMarkerSectionOverride))] [JsonSerializable(typeof(ProtocolSectionOverride))] @@ -40262,6 +43613,7 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(PushAttachmentSelectionDetailsEnd))] [JsonSerializable(typeof(PushAttachmentSelectionDetailsStart))] [JsonSerializable(typeof(PushGitHubRepoRef))] +[JsonSerializable(typeof(QueueAppendSteeringRequest))] [JsonSerializable(typeof(QueueBeginDeferredIdleDrainRequest))] [JsonSerializable(typeof(QueueBeginDeferredIdleDrainResult))] [JsonSerializable(typeof(QueueConsumeSystemNotificationsRequest))] @@ -40288,6 +43640,7 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(QueueSnapshotResult))] [JsonSerializable(typeof(QueueUpdateTextRequest))] [JsonSerializable(typeof(QueueUpdateTextResult))] +[JsonSerializable(typeof(QueueWithdrawMessageRequest))] [JsonSerializable(typeof(QueuedCommandResult))] [JsonSerializable(typeof(RegisterEventInterestParams))] [JsonSerializable(typeof(RegisterEventInterestResult))] @@ -40420,6 +43773,7 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(SessionListEntry))] [JsonSerializable(typeof(SessionListFilter))] [JsonSerializable(typeof(SessionLoadDeferredRepoHooksResult))] +[JsonSerializable(typeof(SessionManagedSettingsGetRequest))] [JsonSerializable(typeof(SessionMcpAppsGetHostContextRequest))] [JsonSerializable(typeof(SessionMcpListRequest))] [JsonSerializable(typeof(SessionMcpMoveLoadingToBackgroundRequest))] @@ -40444,7 +43798,13 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(SessionPlanReadRequest))] [JsonSerializable(typeof(SessionPlanReadSqlTodosRequest))] [JsonSerializable(typeof(SessionPlanReadSqlTodosWithDependenciesRequest))] +[JsonSerializable(typeof(SessionPluginsDisableRequest))] +[JsonSerializable(typeof(SessionPluginsEnableRequest))] +[JsonSerializable(typeof(SessionPluginsInstallRequest))] [JsonSerializable(typeof(SessionPluginsListRequest))] +[JsonSerializable(typeof(SessionPluginsMarketplacesListRequest))] +[JsonSerializable(typeof(SessionPluginsMarketplacesRefreshRequest))] +[JsonSerializable(typeof(SessionPluginsMarketplacesRefreshRequestWithSession))] [JsonSerializable(typeof(SessionPluginsReloadRequest))] [JsonSerializable(typeof(SessionPluginsReloadRequestWithSession))] [JsonSerializable(typeof(SessionProviderGetEndpointRequest))] @@ -40494,6 +43854,7 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(SessionUpdateOptionsResult))] [JsonSerializable(typeof(SessionUsageGetMetricsRequest))] [JsonSerializable(typeof(SessionVisibilityGetRequest))] +[JsonSerializable(typeof(SessionWorkflowPauseAtCheckpointResult))] [JsonSerializable(typeof(SessionWorkingDirectoryContext))] [JsonSerializable(typeof(SessionWorkspacesAutopilotObjectiveExistsRequest))] [JsonSerializable(typeof(SessionWorkspacesDeleteAutopilotObjectiveRequest))] @@ -40664,6 +44025,46 @@ public static void RegisterClientGlobalApiHandlers(JsonRpc rpc, ClientGlobalApiH [JsonSerializable(typeof(VisibilityGetResult))] [JsonSerializable(typeof(VisibilitySetRequest))] [JsonSerializable(typeof(VisibilitySetResult))] +[JsonSerializable(typeof(WorkflowAbortRequest))] +[JsonSerializable(typeof(WorkflowAckResult))] +[JsonSerializable(typeof(WorkflowAgentOptions))] +[JsonSerializable(typeof(WorkflowAgentRequest))] +[JsonSerializable(typeof(WorkflowAgentResult))] +[JsonSerializable(typeof(WorkflowAgentSummary))] +[JsonSerializable(typeof(WorkflowCancelRequest))] +[JsonSerializable(typeof(WorkflowCurrentPhase))] +[JsonSerializable(typeof(WorkflowDeclaredLimits))] +[JsonSerializable(typeof(WorkflowExecuteRequest))] +[JsonSerializable(typeof(WorkflowExecuteResult))] +[JsonSerializable(typeof(WorkflowGetRunProgressRequest))] +[JsonSerializable(typeof(WorkflowGetRunRequest))] +[JsonSerializable(typeof(WorkflowJournalGetRequest))] +[JsonSerializable(typeof(WorkflowJournalGetResult))] +[JsonSerializable(typeof(WorkflowJournalPutRequest))] +[JsonSerializable(typeof(WorkflowListRunsRequest))] +[JsonSerializable(typeof(WorkflowListRunsResult))] +[JsonSerializable(typeof(WorkflowLogLine))] +[JsonSerializable(typeof(WorkflowLogRequest))] +[JsonSerializable(typeof(WorkflowPauseCheckpointRequest))] +[JsonSerializable(typeof(WorkflowPauseInfo))] +[JsonSerializable(typeof(WorkflowPauseRequest))] +[JsonSerializable(typeof(WorkflowPhaseObservation))] +[JsonSerializable(typeof(WorkflowProgressLine))] +[JsonSerializable(typeof(WorkflowProgressPage))] +[JsonSerializable(typeof(WorkflowResumeRequest))] +[JsonSerializable(typeof(WorkflowResumeResult))] +[JsonSerializable(typeof(WorkflowRunConsumed))] +[JsonSerializable(typeof(WorkflowRunDetail))] +[JsonSerializable(typeof(WorkflowRunFailure))] +[JsonSerializable(typeof(WorkflowRunLimits))] +[JsonSerializable(typeof(WorkflowRunOptions))] +[JsonSerializable(typeof(WorkflowRunRequest))] +[JsonSerializable(typeof(WorkflowRunResult))] +[JsonSerializable(typeof(WorkflowRunSummary))] +[JsonSerializable(typeof(WorkflowRunTerminal))] +[JsonSerializable(typeof(WorkflowToolResumeRequest))] +[JsonSerializable(typeof(WorkflowToolRunOptions))] +[JsonSerializable(typeof(WorkflowToolRunRequest))] [JsonSerializable(typeof(WorkspaceDiffFileChange))] [JsonSerializable(typeof(WorkspaceDiffResult))] [JsonSerializable(typeof(WorkspacesAddSummaryRequest))] diff --git a/dotnet/src/Generated/SessionEvents.cs b/dotnet/src/Generated/SessionEvents.cs index f643dc002c..0f0a16bee7 100644 --- a/dotnet/src/Generated/SessionEvents.cs +++ b/dotnet/src/Generated/SessionEvents.cs @@ -117,6 +117,7 @@ namespace GitHub.Copilot; [JsonDerivedType(typeof(SessionFusionRouteStartedEvent), "session.fusion_route_started")] [JsonDerivedType(typeof(SessionHandoffEvent), "session.handoff")] [JsonDerivedType(typeof(SessionIdleEvent), "session.idle")] +[JsonDerivedType(typeof(SessionIndexedSearchEvent), "session.indexed_search")] [JsonDerivedType(typeof(SessionInfoEvent), "session.info")] [JsonDerivedType(typeof(SessionManagedSettingsEnforcedEvent), "session.managed_settings_enforced")] [JsonDerivedType(typeof(SessionManagedSettingsResolvedEvent), "session.managed_settings_resolved")] @@ -127,6 +128,7 @@ namespace GitHub.Copilot; [JsonDerivedType(typeof(SessionModeChangedEvent), "session.mode_changed")] [JsonDerivedType(typeof(SessionModeNoticeDeliveredEvent), "session.mode_notice_delivered")] [JsonDerivedType(typeof(SessionModelChangeEvent), "session.model_change")] +[JsonDerivedType(typeof(SessionPermissionRecoveryEvent), "session.permission_recovery")] [JsonDerivedType(typeof(SessionPermissionsChangedEvent), "session.permissions_changed")] [JsonDerivedType(typeof(SessionPlanChangedEvent), "session.plan_changed")] [JsonDerivedType(typeof(SessionRemoteSteerableChangedEvent), "session.remote_steerable_changed")] @@ -355,6 +357,19 @@ public sealed partial class SessionInfoEvent : SessionEvent public required SessionInfoData Data { get; set; } } +/// Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. +/// Represents the session.indexed_search event. +public sealed partial class SessionIndexedSearchEvent : SessionEvent +{ + /// + [JsonIgnore] + public override string Type => "session.indexed_search"; + + /// The session.indexed_search event payload. + [JsonPropertyName("data")] + public required SessionIndexedSearchData Data { get; set; } +} + /// Warning message for timeline display with categorization. /// Represents the session.warning event. public sealed partial class SessionWarningEvent : SessionEvent @@ -713,6 +728,19 @@ public sealed partial class SessionFusionCompletedEvent : SessionEvent public required SessionFusionCompletedData Data { get; set; } } +/// Authoritative snapshot of an Autopilot permission-recovery episode. +/// Represents the session.permission_recovery event. +public sealed partial class SessionPermissionRecoveryEvent : SessionEvent +{ + /// + [JsonIgnore] + public override string Type => "session.permission_recovery"; + + /// The session.permission_recovery event payload. + [JsonPropertyName("data")] + public required SessionPermissionRecoveryData Data { get; set; } +} + /// Payload of `user.message` with displayed and model-transformed content, attachments, source/delivery metadata, mode, and telemetry IDs. /// Represents the user.message event. public sealed partial class UserMessageEvent : SessionEvent @@ -2500,6 +2528,23 @@ public sealed partial class SessionInfoData public string? Url { get; set; } } +/// Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. +/// Polymorphic base type discriminated by kind. +[JsonPolymorphic( + TypeDiscriminatorPropertyName = "kind", + UnknownDerivedTypeHandling = JsonUnknownDerivedTypeHandling.FallBackToBaseType)] +[JsonDerivedType(typeof(SessionIndexedSearchDataStatus), "status")] +[JsonDerivedType(typeof(SessionIndexedSearchDataStartup), "startup")] +[JsonDerivedType(typeof(SessionIndexedSearchDataServerError), "server_error")] +[JsonDerivedType(typeof(SessionIndexedSearchDataIncremental), "incremental")] +public partial class SessionIndexedSearchData +{ + /// The type discriminator. + [JsonPropertyName("kind")] + public virtual string Kind { get; set; } = string.Empty; +} + + /// Warning message for timeline display with categorization. public sealed partial class SessionWarningData { @@ -3095,6 +3140,11 @@ public sealed partial class SessionCompactionCompleteData [JsonPropertyName("requestId")] public string? RequestId { get; set; } + /// Reasoning baseline on the replacement summary, preserved when replay skips the compacted history. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("responsesReasoning")] + public ResponsesReasoning? ResponsesReasoning { get; set; } + /// Copilot service request ID (x-copilot-service-request-id header) for the compaction LLM call. [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] [JsonPropertyName("serviceRequestId")] @@ -3143,6 +3193,11 @@ public sealed partial class SessionCompactionCompleteData /// Task completion notification with summary from the agent. public sealed partial class SessionTaskCompleteData { + /// Structured blocker details when outcome is blocked. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("blocker")] + public TaskBlocker? Blocker { get; set; } + /// Active autopilot objective ID evaluated by the completion reviewer. [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] [JsonPropertyName("objectiveId")] @@ -3444,6 +3499,34 @@ public sealed partial class SessionFusionCompletedData public required string TurnId { get; set; } } +/// Authoritative snapshot of an Autopilot permission-recovery episode. +public sealed partial class SessionPermissionRecoveryData +{ + /// Ordered privacy-safe record of permission attempts and the successful alternative, when any. + [JsonPropertyName("attempts")] + public required PermissionRecoveryAttempt[] Attempts { get; set; } + + /// Stable identifier shared by every transition in this recovery episode. + [JsonPropertyName("episodeId")] + public required string EpisodeId { get; set; } + + /// Maximum number of distinct autonomous permission attempts allowed before escalation. + [JsonPropertyName("maxAttempts")] + public required long MaxAttempts { get; set; } + + /// Policy selected from the current client's response capability; mode or client changes may update it during recovery. + [JsonPropertyName("onBlocked")] + public required PermissionRecoveryOnBlocked OnBlocked { get; set; } + + /// Controlled reason for the latest episode transition. + [JsonPropertyName("reason")] + public required PermissionRecoveryReason Reason { get; set; } + + /// Current lifecycle state of the recovery episode. + [JsonPropertyName("status")] + public required PermissionRecoveryStatus Status { get; set; } +} + /// Payload of `user.message` with displayed and model-transformed content, attachments, source/delivery metadata, mode, and telemetry IDs. public sealed partial class UserMessageData { @@ -3491,6 +3574,11 @@ public sealed partial class UserMessageData [JsonPropertyName("parentAgentTaskId")] public string? ParentAgentTaskId { get; set; } + /// Responses reasoning settings anchored before this model-facing message, for cache-stable history replay. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("responsesReasoning")] + public ResponsesReasoning? ResponsesReasoning { get; set; } + /// Origin of this message, used for timeline filtering and attribution (e.g., `skill-pdf` for hidden skill injection or `agent-<agent-id>` for an inter-agent prompt). [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] [JsonPropertyName("source")] @@ -4293,6 +4381,18 @@ public sealed partial class AssistantUsageData [JsonPropertyName("serviceRequestId")] public string? ServiceRequestId { get; set; } + /// Number of prior thinking blocks the provider dropped while transforming the request. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonInclude] + [JsonPropertyName("thinkingDroppedBlocks")] + internal long? ThinkingDroppedBlocks { get; set; } + + /// Recognized provider-reported reasons for dropped thinking blocks, in response order. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonInclude] + [JsonPropertyName("thinkingDroppedReasons")] + internal string[]? ThinkingDroppedReasons { get; set; } + /// Time to first token in milliseconds. Only available for streaming requests. [JsonConverter(typeof(MillisecondsTimeSpanConverter))] [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] @@ -4893,6 +4993,11 @@ public sealed partial class SkillInvokedData [JsonPropertyName("disableModelInvocation")] public bool? DisableModelInvocation { get; set; } + /// Projected chat-message count when the skill was invoked. New writers persist this so replay does not need to reconstruct superseded history; readers derive it for legacy events when absent. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("invokedAtTurn")] + public long? InvokedAtTurn { get; set; } + /// Model identifier active when the skill was invoked, when known. [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] [JsonPropertyName("model")] @@ -4953,6 +5058,11 @@ public sealed partial class SkillInvokedRefData [JsonPropertyName("disableModelInvocation")] public bool? DisableModelInvocation { get; set; } + /// Projected chat-message count when the skill was invoked. Preserved from the inline event data when the authored body is deduplicated. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("invokedAtTurn")] + public long? InvokedAtTurn { get; set; } + /// Model identifier active when the skill was invoked, when known. [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] [JsonPropertyName("model")] @@ -5032,7 +5142,24 @@ public sealed partial class SkillContextDeliveredRefData } /// Payload of `sandbox.decision`, a bounded governance record of what the process sandbox was configured to do and whether it took effect. Discriminated by `kind`. -public sealed partial class SandboxDecisionData { } +/// Polymorphic base type discriminated by kind. +[JsonPolymorphic( + TypeDiscriminatorPropertyName = "kind", + UnknownDerivedTypeHandling = JsonUnknownDerivedTypeHandling.FallBackToBaseType)] +[JsonDerivedType(typeof(SandboxDecisionDataPolicyResolved), "policy_resolved")] +[JsonDerivedType(typeof(SandboxDecisionDataSpawnCompleted), "spawn_completed")] +[JsonDerivedType(typeof(SandboxDecisionDataEnforcementState), "enforcement_state")] +[JsonDerivedType(typeof(SandboxDecisionDataAccessDenied), "access_denied")] +[JsonDerivedType(typeof(SandboxDecisionDataBypassDecided), "bypass_decided")] +[JsonDerivedType(typeof(SandboxDecisionDataPermissiveRetryDecided), "permissive_retry_decided")] +[JsonDerivedType(typeof(SandboxDecisionDataPermissiveRetryCompleted), "permissive_retry_completed")] +public partial class SandboxDecisionData +{ + /// The type discriminator. + [JsonPropertyName("kind")] + public virtual string Kind { get; set; } = string.Empty; +} + /// Sub-agent startup details including parent tool call and agent information. public sealed partial class SubagentStartedData @@ -5428,6 +5555,11 @@ public sealed partial class SystemNotificationData /// Structured metadata identifying what triggered this notification. [JsonPropertyName("kind")] public required SystemNotification Kind { get; set; } + + /// Responses reasoning settings anchored before this model-facing message, for cache-stable history replay. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("responsesReasoning")] + public ResponsesReasoning? ResponsesReasoning { get; set; } } /// Permission request notification requiring client approval with request details. @@ -5438,6 +5570,11 @@ public sealed partial class PermissionRequestedData [JsonPropertyName("agentMode")] public SessionMode? AgentMode { get; set; } + /// Permission mode captured when evaluation began. Absent on historical events. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("permissionMode")] + public PermissionMode? PermissionMode { get; set; } + /// Details of the permission being requested. [JsonPropertyName("permissionRequest")] public required PermissionRequest PermissionRequest { get; set; } @@ -5447,6 +5584,11 @@ public sealed partial class PermissionRequestedData [JsonPropertyName("promptRequest")] public PermissionPromptRequest? PromptRequest { get; set; } + /// Permission-recovery episode that authorized this request to surface for interactive attention. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("recoveryEpisodeId")] + public string? RecoveryEpisodeId { get; set; } + /// Unique identifier for this permission request; used to respond via session.respondToPermission(). [JsonPropertyName("requestId")] public required string RequestId { get; set; } @@ -5465,12 +5607,22 @@ public sealed partial class PermissionRequestedData /// Permission request completion notification signaling UI dismissal. public sealed partial class PermissionCompletedData { + /// Atomic structured blocked outcome when this permission response ended an Autopilot recovery episode unsuccessfully. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("blocker")] + public TaskBlocker? Blocker { get; set; } + /// Who decided this permission request. Absent on completions recorded before this field existed, which consumers must treat as "not a human decision" rather than assuming one. Authorization records are minted only for `human_response`; an assisted-approval verdict, a host policy, an unattended fallback, and a hook resolution all produce the same `result` a person does, so this is the only field that distinguishes them. [Experimental(Diagnostics.Experimental)] [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] [JsonPropertyName("decisionSource")] public PermissionDecisionSource? DecisionSource { get; set; } + /// Permission-recovery episode settled by this response, when the request was escalated by Autopilot. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("recoveryEpisodeId")] + public string? RecoveryEpisodeId { get; set; } + /// Request ID of the resolved permission request; clients should dismiss any UI for this request. [JsonPropertyName("requestId")] public required string RequestId { get; set; } @@ -6708,6 +6860,131 @@ public sealed partial class SessionLimitsConfig public double? MaxAiCredits { get; set; } } +/// The status variant of . +public sealed partial class SessionIndexedSearchDataStatus : SessionIndexedSearchData +{ + /// + [JsonIgnore] + public override string Kind => "status"; + + /// Current indexed-search state for this session activation. + [JsonPropertyName("state")] + public required IndexedSearchState State { get; set; } +} + +/// The startup variant of . +public sealed partial class SessionIndexedSearchDataStartup : SessionIndexedSearchData +{ + /// + [JsonIgnore] + public override string Kind => "startup"; + + /// Why indexed search was disabled, when applicable. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("disabledReason")] + public IndexedSearchDisabledReason? DisabledReason { get; set; } + + /// Whether the repository meets the automatic indexing file-count threshold, when known. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("eligible")] + public bool? Eligible { get; set; } + + /// Startup failure details. May contain sensitive user data; restricted telemetry only. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("errorMessage")] + public string? ErrorMessage { get; set; } + + /// Number of text files counted in the repository. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("fileCount")] + public double? FileCount { get; set; } + + /// Whether indexed search was explicitly enabled through the environment. + [JsonPropertyName("forcedByEnv")] + public required bool ForcedByEnv { get; set; } + + /// Outcome of this startup attempt. + [JsonPropertyName("outcome")] + public required IndexedSearchOutcome Outcome { get; set; } + + /// Wall-clock duration of startup in milliseconds. + [JsonPropertyName("startupDurationMs")] + public required double StartupDurationMs { get; set; } + + /// Whether waiting for index readiness was requested, including skipped attempts. + [JsonPropertyName("warmStart")] + public required bool WarmStart { get; set; } +} + +/// The server_error variant of . +public sealed partial class SessionIndexedSearchDataServerError : SessionIndexedSearchData +{ + /// + [JsonIgnore] + public override string Kind => "server_error"; + + /// Server failure details. May contain sensitive user data; restricted telemetry only. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("errorMessage")] + public string? ErrorMessage { get; set; } + + /// Category of the server failure. + [JsonPropertyName("errorType")] + public required IndexedSearchErrorType ErrorType { get; set; } + + /// Process exit code, when available. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("exitCode")] + public double? ExitCode { get; set; } +} + +/// The incremental variant of . +public sealed partial class SessionIndexedSearchDataIncremental : SessionIndexedSearchData +{ + /// + [JsonIgnore] + public override string Kind => "incremental"; + + /// Number of added files. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("addedFileCount")] + public double? AddedFileCount { get; set; } + + /// Number of modified files. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("changedFileCount")] + public double? ChangedFileCount { get; set; } + + /// Number of deleted files. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("deletedFileCount")] + public double? DeletedFileCount { get; set; } + + /// Phase of the incremental index update. + [JsonPropertyName("phase")] + public required IndexedSearchIncrementalPhase Phase { get; set; } + + /// Total number of detected changes. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("totalChangeCount")] + public double? TotalChangeCount { get; set; } + + /// Total incremental indexing duration in milliseconds. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("totalDurationMs")] + public double? TotalDurationMs { get; set; } + + /// Index update duration in milliseconds. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("updateDurationMs")] + public double? UpdateDurationMs { get; set; } + + /// Workspace scan duration in milliseconds. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("walkDurationMs")] + public double? WalkDurationMs { get; set; } +} + /// Repository context for the handed-off session. /// Nested data type for HandoffRepository. public sealed partial class HandoffRepository @@ -6963,6 +7240,111 @@ public sealed partial class CompactionCompleteCompactionTokensUsed public long? OutputTokens { get; set; } } +/// Original request-level and effective conversation reasoning effort for a Responses history boundary. +/// Nested data type for ResponsesReasoning. +public sealed partial class ResponsesReasoning +{ + /// Effective effort selected before this message, independent of the response-level reasoning field. + [JsonPropertyName("effort")] + public required string Effort { get; set; } + + /// Original request-level effort, retained while replaying this conversation prefix. + [JsonPropertyName("initialEffort")] + public required string InitialEffort { get; set; } + + /// Provider model whose reasoning settings this boundary records. + [JsonPropertyName("model")] + public required string Model { get; set; } +} + +/// Nested data type for PermissionRecoveryAttempt. +public sealed partial class PermissionRecoveryAttempt +{ + /// Unique identifier for this attempt record. + [JsonPropertyName("attemptId")] + public required string AttemptId { get; set; } + + /// How the runtime handled this attempt. + [JsonPropertyName("disposition")] + public required PermissionRecoveryAttemptDisposition Disposition { get; set; } + + /// One-based position of this attempt in the episode. + [JsonPropertyName("ordinal")] + public required long Ordinal { get; set; } + + /// Controlled permission request kind, such as shell, path, URL, or tool. + [JsonPropertyName("permissionKind")] + public required string PermissionKind { get; set; } + + /// Controlled reason for the attempt disposition. + [JsonPropertyName("reason")] + public required PermissionRecoveryAttemptReason Reason { get; set; } + + /// Relationship between this attempt and earlier attempts in the episode. + [JsonPropertyName("relation")] + public required PermissionRecoveryAttemptRelation Relation { get; set; } + + /// SHA-256 fingerprint of normalized request data; raw permission arguments are not included. + [JsonPropertyName("requestFingerprint")] + public required string RequestFingerprint { get; set; } + + /// Tool-call identifier associated with this attempt, when available. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// Authoritative snapshot of an Autopilot permission-recovery episode. +/// Nested data type for PermissionRecoveryData. +public sealed partial class PermissionRecoveryData +{ + /// Ordered privacy-safe record of permission attempts and the successful alternative, when any. + [JsonPropertyName("attempts")] + public required PermissionRecoveryAttempt[] Attempts { get; set; } + + /// Stable identifier shared by every transition in this recovery episode. + [JsonPropertyName("episodeId")] + public required string EpisodeId { get; set; } + + /// Maximum number of distinct autonomous permission attempts allowed before escalation. + [JsonPropertyName("maxAttempts")] + public required long MaxAttempts { get; set; } + + /// Policy selected from the current client's response capability; mode or client changes may update it during recovery. + [JsonPropertyName("onBlocked")] + public required PermissionRecoveryOnBlocked OnBlocked { get; set; } + + /// Controlled reason for the latest episode transition. + [JsonPropertyName("reason")] + public required PermissionRecoveryReason Reason { get; set; } + + /// Current lifecycle state of the recovery episode. + [JsonPropertyName("status")] + public required PermissionRecoveryStatus Status { get; set; } +} + +/// Structured reason that the task cannot continue without intervention. +/// Nested data type for TaskBlocker. +[Experimental(Diagnostics.Experimental)] +public sealed partial class TaskBlocker +{ + /// Category of intervention that blocked the task. + [JsonPropertyName("kind")] + public required TaskBlockerKind Kind { get; set; } + + /// Permission-recovery episode that produced this blocker. + [JsonPropertyName("permissionRecovery")] + public required PermissionRecoveryData PermissionRecovery { get; set; } + + /// Controlled reason for the current blocked state. + [JsonPropertyName("reason")] + public required PermissionRecoveryReason Reason { get; set; } + + /// Whether a later user response or steering message can resume the task. + [JsonPropertyName("resumable")] + public required bool Resumable { get; set; } +} + /// Inclusive durable event range summarized by a completion receipt. /// Nested data type for CompletionReceiptEventRange. public sealed partial class CompletionReceiptEventRange @@ -8997,90 +9379,514 @@ public sealed partial class ToolExecutionCompleteToolDescription public required string Name { get; set; } } -/// Error details when the hook failed. -/// Nested data type for HookEndError. -public sealed partial class HookEndError +/// Effective sandbox filesystem rules, in policy order. Only populated when content capture is enabled, since these are real host paths. +/// Nested data type for SandboxFilesystemPolicyDetails. +public sealed partial class SandboxFilesystemPolicyDetails { - /// Human-readable error message. - [JsonPropertyName("message")] - public required string Message { get; set; } - - /// Source label of the hook that errored (e.g. the plugin it was loaded from), when known. - [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] - [JsonPropertyName("source")] - public string? Source { get; set; } - - /// Error stack trace, when available. - [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] - [JsonPropertyName("stack")] - public string? Stack { get; set; } -} + /// Paths the sandboxed process may not access at all. + [JsonPropertyName("deniedPaths")] + public required string[] DeniedPaths { get; set; } -/// Metadata about the prompt template and its construction. -/// Nested data type for SystemMessageMetadata. -public sealed partial class SystemMessageMetadata -{ - /// Version identifier of the prompt template used. - [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] - [JsonPropertyName("promptVersion")] - public string? PromptVersion { get; set; } + /// Paths the sandboxed process may read but not write. + [JsonPropertyName("readonlyPaths")] + public required string[] ReadonlyPaths { get; set; } - /// Template variables used when constructing the prompt. - [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] - [JsonPropertyName("variables")] - public IDictionary? Variables { get; set; } + /// Paths the sandboxed process may read and write. + [JsonPropertyName("readwritePaths")] + public required string[] ReadwritePaths { get; set; } } -/// System notification metadata for a background agent that completed or failed, including agent ID, type, status, description, and prompt. -/// The agent_completed variant of . -public sealed partial class SystemNotificationAgentCompleted : SystemNotification +/// The policy_resolved variant of . +public sealed partial class SandboxDecisionDataPolicyResolved : SandboxDecisionData { /// [JsonIgnore] - public override string Type => "agent_completed"; + public override string Kind => "policy_resolved"; - /// Unique task identifier. - [JsonPropertyName("agentId")] - public required string AgentId { get; set; } + /// Whether the current working directory was granted automatically. + [JsonPropertyName("addCurrentWorkingDirectory")] + public required bool AddCurrentWorkingDirectory { get; set; } - /// Type of the agent (e.g., explore, task, general-purpose). - [JsonPropertyName("agentType")] - public required string AgentType { get; set; } + /// Whether callers may opt an individual command out of the sandbox. + [JsonPropertyName("allowBypass")] + public required bool AllowBypass { get; set; } - /// Human-readable description of the agent task. - [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] - [JsonPropertyName("description")] - public string? Description { get; set; } + /// Whether the sandboxed process may reach loopback and private-range addresses. + [JsonPropertyName("allowLocalNetwork")] + public required bool AllowLocalNetwork { get; set; } - /// Friendly, non-unique name intended for display. + /// Whether the sandboxed process may open outbound network connections. + [JsonPropertyName("allowOutbound")] + public required bool AllowOutbound { get; set; } + + /// Process-containment implementation backing the sandbox. + [JsonPropertyName("backend")] + public required SandboxBackend Backend { get; set; } + + /// Enforcement mechanism this decision describes. + [JsonPropertyName("control")] + public required SandboxControl Control { get; set; } + + /// Why enforcement is weaker than configured, when it is. [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] - [JsonPropertyName("displayName")] - public string? DisplayName { get; set; } + [JsonPropertyName("degradationReason")] + public SandboxDegradationReason? DegradationReason { get; set; } - /// The full prompt given to the background agent. + /// Number of denied path rules in the effective policy. + [JsonPropertyName("deniedPathsCount")] + public required long DeniedPathsCount { get; set; } + + /// Effective filesystem rules. Populated only when content capture is enabled; the counts above are always present. [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] - [JsonPropertyName("prompt")] - public string? Prompt { get; set; } + [JsonPropertyName("effectiveFilesystemPolicy")] + public SandboxFilesystemPolicyDetails? EffectiveFilesystemPolicy { get; set; } - /// Whether the agent completed successfully or failed. - [JsonPropertyName("status")] - public required SystemNotificationAgentCompletedStatus Status { get; set; } + /// Runtime subsystem that applied the policy. + [JsonPropertyName("enforcementPoint")] + public required SandboxEnforcementPoint EnforcementPoint { get; set; } + + /// Whether the sandbox policy permits GitHub CLI credentials inside the sandbox. A policy capability, not proof that a credential was injected into this spawn: injection is per-command. + [JsonPropertyName("ghAuth")] + public required bool GhAuth { get; set; } + + /// Whether the sandbox policy permits git credentials inside the sandbox. A policy capability, not proof that a credential was injected into this spawn: injection is per-command. + [JsonPropertyName("gitAuth")] + public required bool GitAuth { get; set; } + + /// Whether the macOS keychain was reachable from inside the sandbox. Always false on other platforms. + [JsonPropertyName("keychainAccess")] + public required bool KeychainAccess { get; set; } + + /// Whether the resolved policy is fully active or degraded. + [JsonPropertyName("outcome")] + public required SandboxOutcome Outcome { get; set; } + + /// Host platform the sandbox is running on. + [JsonPropertyName("platform")] + public required SandboxPlatform Platform { get; set; } + + /// Whether the policy came from built-in defaults or user configuration. + [JsonPropertyName("policySource")] + public required SandboxPolicySource PolicySource { get; set; } + + /// Whether outbound traffic is unproxied, routed through a loopback proxy, or routed through an external proxy. + [JsonPropertyName("proxyMode")] + public required SandboxProxyMode ProxyMode { get; set; } + + /// Number of read-only path rules in the effective policy. + [JsonPropertyName("readonlyPathsCount")] + public required long ReadonlyPathsCount { get; set; } + + /// Number of read-write path rules in the effective policy. + [JsonPropertyName("readwritePathsCount")] + public required long ReadwritePathsCount { get; set; } + + /// Internal tool-call ID, used only to correlate the decision with its owning span. Omitted when the decision is not attributable to a tool call. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } } -/// System notification metadata for a background agent that became idle, including agent ID, type, and description. -/// The agent_idle variant of . -public sealed partial class SystemNotificationAgentIdle : SystemNotification +/// The spawn_completed variant of . +public sealed partial class SandboxDecisionDataSpawnCompleted : SandboxDecisionData { /// [JsonIgnore] - public override string Type => "agent_idle"; + public override string Kind => "spawn_completed"; - /// Unique task identifier. - [JsonPropertyName("agentId")] - public required string AgentId { get; set; } + /// Process-containment implementation backing the sandbox. + [JsonPropertyName("backend")] + public required SandboxBackend Backend { get; set; } - /// Type of the agent (e.g., explore, task, general-purpose). - [JsonPropertyName("agentType")] + /// Enforcement mechanism this decision describes. + [JsonPropertyName("control")] + public required SandboxControl Control { get; set; } + + /// Why enforcement is weaker than configured, when it is. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("degradationReason")] + public SandboxDegradationReason? DegradationReason { get; set; } + + /// Wall-clock time spent spawning the sandboxed process, in milliseconds. + [JsonPropertyName("durationMs")] + public required double DurationMs { get; set; } + + /// Runtime subsystem that applied the policy. + [JsonPropertyName("enforcementPoint")] + public required SandboxEnforcementPoint EnforcementPoint { get; set; } + + /// Whether the sandboxed process launched under the named backend. Not the exit status of the command that ran inside it. + [JsonPropertyName("outcome")] + public required SandboxOutcome Outcome { get; set; } + + /// Host platform the sandbox is running on. + [JsonPropertyName("platform")] + public required SandboxPlatform Platform { get; set; } + + /// Internal tool-call ID, used only to correlate the decision with its owning span. Omitted when the decision is not attributable to a tool call. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// The enforcement_state variant of . +public sealed partial class SandboxDecisionDataEnforcementState : SandboxDecisionData +{ + /// + [JsonIgnore] + public override string Kind => "enforcement_state"; + + /// Runtime observation backing the state. Omitted for `inactive`, which has nothing to attest. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("attestation")] + public SandboxAttestation? Attestation { get; set; } + + /// Containment backend that engaged. `unsupported` for any state other than `engaged`, since no backend is known to have run. + [JsonPropertyName("backend")] + public required SandboxBackend Backend { get; set; } + + /// Command the enforcement governed. Populated only when content capture is enabled, and only for shell commands; MCP, LSP, and search command lines are runtime plumbing. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("command")] + public string? Command { get; set; } + + /// Enforcement mechanism this decision describes. + [JsonPropertyName("control")] + public required SandboxControl Control { get; set; } + + /// Runtime subsystem whose enforcement this describes. + [JsonPropertyName("enforcementPoint")] + public required SandboxEnforcementPoint EnforcementPoint { get; set; } + + /// Observed enforcement state: `engaged`, `inactive`, or `failed`. Derived from runtime evidence, never from the configured posture or the compile-time target platform. + [JsonPropertyName("outcome")] + public required SandboxOutcome Outcome { get; set; } + + /// Host platform the sandbox is running on. + [JsonPropertyName("platform")] + public required SandboxPlatform Platform { get; set; } + + /// Internal tool-call ID, used only to correlate the decision with its owning span. Omitted when the decision is not attributable to a tool call. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// An enforcement check refused a specific access. Emitted per refusal with no deduplication, including when policy permits the caller to bypass the denial. Carries no backend: the built-in checks that produce this run in-process against the effective policy. +/// The access_denied variant of . +public sealed partial class SandboxDecisionDataAccessDenied : SandboxDecisionData +{ + /// + [JsonIgnore] + public override string Kind => "access_denied"; + + /// Runtime observation backing the denial. + [JsonPropertyName("attestation")] + public required SandboxAttestation Attestation { get; set; } + + /// Command whose execution the denial arose from. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("command")] + public string? Command { get; set; } + + /// How strong the evidence behind this denial is. Lets an analysis separate denials the sandbox recorded from ones inferred from output text, which otherwise look identical. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("confidence")] + public SandboxDenialConfidence? Confidence { get; set; } + + /// Sandbox control the denial belongs to. Follows from `denialClass`. + [JsonPropertyName("control")] + public required SandboxControl Control { get; set; } + + /// Bounded class of the refused access. + [JsonPropertyName("denialClass")] + public required SandboxDenialClass DenialClass { get; set; } + + /// Resource the check refused, when identified and content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("deniedResource")] + public string? DeniedResource { get; set; } + + /// Runtime subsystem that performed the check. + [JsonPropertyName("enforcementPoint")] + public required SandboxEnforcementPoint EnforcementPoint { get; set; } + + /// Always `denied`. + [JsonPropertyName("outcome")] + public required SandboxOutcome Outcome { get; set; } + + /// Host operating-system family. + [JsonPropertyName("platform")] + public required SandboxPlatform Platform { get; set; } + + /// Executable image associated with the captured denial, normalized to a basename. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("processName")] + public string? ProcessName { get; set; } + + /// Tool call the denial belongs to, for span correlation only. Never exported as a telemetry attribute or metric dimension. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// A request to run outside the process sandbox was resolved. This is what makes an `inactive` `enforcement_state` readable: without it, a command that ran unsandboxed because a person approved a bypass looks identical to one that ran unsandboxed because the session never had a sandbox. Reported only when a sandbox was in force, since bypassing a disabled sandbox bypasses nothing. Carries neither backend nor attestation: the verdict comes from the runtime's own permission flow or the local escalation prompt, not from a containment backend and not from the built-in policy check, so `source` is what records where it came from. +/// The bypass_decided variant of . +public sealed partial class SandboxDecisionDataBypassDecided : SandboxDecisionData +{ + /// + [JsonIgnore] + public override string Kind => "bypass_decided"; + + /// Command the verdict governs. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("command")] + public string? Command { get; set; } + + /// How strong the evidence behind `denialClass` was. Present exactly when `denialClass` is, so a verdict that relaxed the sandbox on a guess is distinguishable from one that relaxed it on a recorded refusal. Named to match `access_denied`, which reports the same pair. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("confidence")] + public SandboxDenialConfidence? Confidence { get; set; } + + /// Always `bypass`. + [JsonPropertyName("control")] + public required SandboxControl Control { get; set; } + + /// Bounded class of the access whose refusal raised this escalation. Omitted for a pre-execution bypass, such as a detached command that cannot be sandboxed and therefore resolves no denial. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("denialClass")] + public SandboxDenialClass? DenialClass { get; set; } + + /// Resource whose refusal raised this escalation. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("deniedResource")] + public string? DeniedResource { get; set; } + + /// Runtime subsystem the bypass applies to. + [JsonPropertyName("enforcementPoint")] + public required SandboxEnforcementPoint EnforcementPoint { get; set; } + + /// Whether the bypass was granted: `approved` or `declined`. `declined` also covers the cases where nobody answered, since the sandboxed denial stands either way. + [JsonPropertyName("outcome")] + public required SandboxOutcome Outcome { get; set; } + + /// Host operating-system family. + [JsonPropertyName("platform")] + public required SandboxPlatform Platform { get; set; } + + /// Executable image associated with the denial that raised this escalation, normalized to a basename. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("processName")] + public string? ProcessName { get; set; } + + /// Where the request originated. Orthogonal to `outcome`. + [JsonPropertyName("source")] + public required SandboxBypassSource Source { get; set; } + + /// Tool call the decision belongs to, for span correlation only. Never exported as a telemetry attribute or metric dimension. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// A permissive retry was resolved. Distinct from `bypass_decided` because this rung never requests a run outside the process sandbox: it relaxes the process container for one run while the sandbox, and with it the network policy, stays attached. Reported for both outcomes, so an escalation the user declined still leaves evidence that the runtime asked and that the sandboxed denial stood. +/// The permissive_retry_decided variant of . +public sealed partial class SandboxDecisionDataPermissiveRetryDecided : SandboxDecisionData +{ + /// + [JsonIgnore] + public override string Kind => "permissive_retry_decided"; + + /// Command the verdict governs. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("command")] + public string? Command { get; set; } + + /// How strong the evidence behind `denialClass` was. Present exactly when `denialClass` is. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("confidence")] + public SandboxDenialConfidence? Confidence { get; set; } + + /// Always `process`: the process container is what this rung relaxes, and the network control is deliberately untouched. + [JsonPropertyName("control")] + public required SandboxControl Control { get; set; } + + /// Bounded class of the access whose refusal raised this escalation. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("denialClass")] + public SandboxDenialClass? DenialClass { get; set; } + + /// Resource whose refusal raised this escalation. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("deniedResource")] + public string? DeniedResource { get; set; } + + /// Runtime subsystem the retry applies to. + [JsonPropertyName("enforcementPoint")] + public required SandboxEnforcementPoint EnforcementPoint { get; set; } + + /// Whether the permissive retry was granted: `approved` or `declined`. `declined` also covers the cases where nobody answered, since the sandboxed denial stands either way. + [JsonPropertyName("outcome")] + public required SandboxOutcome Outcome { get; set; } + + /// Host operating-system family. + [JsonPropertyName("platform")] + public required SandboxPlatform Platform { get; set; } + + /// Executable image associated with the denial that raised this escalation, normalized to a basename. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("processName")] + public string? ProcessName { get; set; } + + /// Where the request originated. Orthogonal to `outcome`. + [JsonPropertyName("source")] + public required SandboxBypassSource Source { get; set; } + + /// Tool call the decision belongs to, for span correlation only. Never exported as a telemetry attribute or metric dimension. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// An approved permissive retry finished. `succeeded` means the retry exited successfully without another correlated sandbox denial; `failed` means it failed or remained blocked and may therefore be followed by a full bypass. +/// The permissive_retry_completed variant of . +public sealed partial class SandboxDecisionDataPermissiveRetryCompleted : SandboxDecisionData +{ + /// + [JsonIgnore] + public override string Kind => "permissive_retry_completed"; + + /// Command the retry executed. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("command")] + public string? Command { get; set; } + + /// How strong the evidence behind `denialClass` was. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("confidence")] + public SandboxDenialConfidence? Confidence { get; set; } + + /// Always `process`: the retry changes process-container enforcement while leaving network policy attached. + [JsonPropertyName("control")] + public required SandboxControl Control { get; set; } + + /// Bounded class of the access whose refusal raised the permissive retry. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("denialClass")] + public SandboxDenialClass? DenialClass { get; set; } + + /// Resource whose refusal raised the retry. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("deniedResource")] + public string? DeniedResource { get; set; } + + /// Runtime subsystem that ran the retry. + [JsonPropertyName("enforcementPoint")] + public required SandboxEnforcementPoint EnforcementPoint { get; set; } + + /// Whether the permissive retry completed successfully: `succeeded` or `failed`. + [JsonPropertyName("outcome")] + public required SandboxOutcome Outcome { get; set; } + + /// Host operating-system family. + [JsonPropertyName("platform")] + public required SandboxPlatform Platform { get; set; } + + /// Executable image associated with the denial that raised the retry, normalized to a basename. Populated only when content capture is enabled. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("processName")] + public string? ProcessName { get; set; } + + /// Tool call the completion belongs to, for span correlation only. Never exported as a telemetry attribute or metric dimension. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("toolCallId")] + public string? ToolCallId { get; set; } +} + +/// Error details when the hook failed. +/// Nested data type for HookEndError. +public sealed partial class HookEndError +{ + /// Human-readable error message. + [JsonPropertyName("message")] + public required string Message { get; set; } + + /// Source label of the hook that errored (e.g. the plugin it was loaded from), when known. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("source")] + public string? Source { get; set; } + + /// Error stack trace, when available. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("stack")] + public string? Stack { get; set; } +} + +/// Metadata about the prompt template and its construction. +/// Nested data type for SystemMessageMetadata. +public sealed partial class SystemMessageMetadata +{ + /// Version identifier of the prompt template used. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("promptVersion")] + public string? PromptVersion { get; set; } + + /// Template variables used when constructing the prompt. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("variables")] + public IDictionary? Variables { get; set; } +} + +/// System notification metadata for a background agent that completed or failed, including agent ID, type, status, description, and prompt. +/// The agent_completed variant of . +public sealed partial class SystemNotificationAgentCompleted : SystemNotification +{ + /// + [JsonIgnore] + public override string Type => "agent_completed"; + + /// Unique task identifier. + [JsonPropertyName("agentId")] + public required string AgentId { get; set; } + + /// Type of the agent (e.g., explore, task, general-purpose). + [JsonPropertyName("agentType")] + public required string AgentType { get; set; } + + /// Human-readable description of the agent task. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("description")] + public string? Description { get; set; } + + /// Friendly, non-unique name intended for display. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("displayName")] + public string? DisplayName { get; set; } + + /// The full prompt given to the background agent. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("prompt")] + public string? Prompt { get; set; } + + /// Whether the agent completed successfully or failed. + [JsonPropertyName("status")] + public required SystemNotificationAgentCompletedStatus Status { get; set; } +} + +/// System notification metadata for a background agent that became idle, including agent ID, type, and description. +/// The agent_idle variant of . +public sealed partial class SystemNotificationAgentIdle : SystemNotification +{ + /// + [JsonIgnore] + public override string Type => "agent_idle"; + + /// Unique task identifier. + [JsonPropertyName("agentId")] + public required string AgentId { get; set; } + + /// Type of the agent (e.g., explore, task, general-purpose). + [JsonPropertyName("agentType")] public required string AgentType { get; set; } /// Human-readable description of the agent task. @@ -9632,11 +10438,38 @@ public override bool? ManagedApprovalRequired public required string Url { get; set; } } +/// Bounded runtime attribution, independent of free-text rationale. Telemetry revalidates this vocabulary before standard collection. +/// Nested data type for PermissionApprovalEvaluation. +public sealed partial class PermissionApprovalEvaluation +{ + /// Stage that produced this attribution. + [JsonPropertyName("evaluationStage")] + public required PermissionApprovalEvaluationEvaluationStage EvaluationStage { get; set; } + + /// Whether the request invoked the judge interface. A cached recommendation retains the original attempt fact. Omitted means unknown, including inherited outcomes. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("judgeAttempted")] + public bool? JudgeAttempted { get; set; } + + /// Status of the local judge interface, not proof of a model network call. + [JsonPropertyName("judgeStatus")] + public required PermissionApprovalEvaluationJudgeStatus JudgeStatus { get; set; } + + /// Machine-readable runtime gate reason, never a command, path or human rationale. + [JsonPropertyName("reasonCode")] + public required PermissionApprovalEvaluationReasonCode ReasonCode { get; set; } +} + /// Assisted-approval judge information attached to a permission request. Present only in assisted mode; its absence means the judge did not evaluate the request. The `recommendation` conveys the judge's disposition for this request. /// Nested data type for PermissionAssistedApproval. [Experimental(Diagnostics.Experimental)] public sealed partial class PermissionAssistedApproval { + /// Runtime reason and judge-call metadata. Absent on older events; missing metadata means unknown, not that the judge was skipped. + [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] + [JsonPropertyName("evaluation")] + public PermissionApprovalEvaluation? Evaluation { get; set; } + /// Classified cause of an `error` recommendation. Absent for every other recommendation. [JsonIgnore(Condition = JsonIgnoreCondition.WhenWritingNull)] [JsonPropertyName("failureReason")] @@ -11946,45 +12779,395 @@ public override void Write(Utf8JsonWriter writer, AutopilotObjectiveChangedStatu } } -/// Origin of an effective session model change. +/// Live indexed-search state for this session activation, never inferred from persisted history. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ModelChangeSource : IEquatable +public readonly struct IndexedSearchState : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ModelChangeSource(string value) + public IndexedSearchState(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The user selected a model directly with `/model <id>`. - public static ModelChangeSource ModelCommand { get; } = new("model_command"); + /// Indexed search is not active for this session. + public static IndexedSearchState Disabled { get; } = new("disabled"); - /// The user selected the model with `/settings`. - public static ModelChangeSource SettingsCommand { get; } = new("settings_command"); + /// Indexed-search startup is in progress. + public static IndexedSearchState Starting { get; } = new("starting"); - /// The user selected the model with the `/config` alias. - public static ModelChangeSource ConfigCommand { get; } = new("config_command"); + /// The indexed-search server started successfully; its index may still be warming. + public static IndexedSearchState Enabled { get; } = new("enabled"); - /// The user selected the model in the model picker, including the picker opened by bare `/model`. - public static ModelChangeSource ModelPicker { get; } = new("model_picker"); + /// The indexed-search server and its index are ready. + public static IndexedSearchState Ready { get; } = new("ready"); - /// Organization-managed settings selected the model. - public static ModelChangeSource ManagedSettings { get; } = new("managed_settings"); + /// Indexed-search startup or the active server failed. + public static IndexedSearchState Failed { get; } = new("failed"); - /// Repository settings selected the model. - public static ModelChangeSource RepoSettings { get; } = new("repo_settings"); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(IndexedSearchState left, IndexedSearchState right) => left.Equals(right); - /// Startup model resolution selected the model. - public static ModelChangeSource Startup { get; } = new("startup"); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(IndexedSearchState left, IndexedSearchState right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is IndexedSearchState other && Equals(other); + + /// + public bool Equals(IndexedSearchState other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override IndexedSearchState Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, IndexedSearchState value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(IndexedSearchState)); + } + } +} + +/// Configuration, policy, or workspace condition that disabled indexed search. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct IndexedSearchDisabledReason : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public IndexedSearchDisabledReason(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Indexed search was explicitly disabled by the environment. + public static IndexedSearchDisabledReason UseTgrepFalse { get; } = new("use_tgrep_false"); + + /// Search uses the external ripgrep binary instead of bundled search. + public static IndexedSearchDisabledReason UseBuiltinRipgrepFalse { get; } = new("use_builtin_ripgrep_false"); + + /// Organization policy disables indexed search. + public static IndexedSearchDisabledReason Organization { get; } = new("organization"); + + /// Authentication has not resolved organization policy. + public static IndexedSearchDisabledReason OrganizationPolicyAuthPending { get; } = new("organization_policy_auth_pending"); + + /// Organization policy could not be determined. + public static IndexedSearchDisabledReason OrganizationPolicyUnknown { get; } = new("organization_policy_unknown"); + + /// The workspace uses a virtualized or network filesystem. + public static IndexedSearchDisabledReason VirtualFilesystem { get; } = new("virtual_filesystem"); + + /// The workspace is inside a Windows cloud-sync root. + public static IndexedSearchDisabledReason CloudSyncRoot { get; } = new("cloud_sync_root"); + + /// The Windows cloud-sync safety check failed. + public static IndexedSearchDisabledReason CloudSyncDetectionFailed { get; } = new("cloud_sync_detection_failed"); + + /// The workspace is not available on the runtime's local filesystem. + public static IndexedSearchDisabledReason WorkspaceNotLocal { get; } = new("workspace_not_local"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(IndexedSearchDisabledReason left, IndexedSearchDisabledReason right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(IndexedSearchDisabledReason left, IndexedSearchDisabledReason right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is IndexedSearchDisabledReason other && Equals(other); + + /// + public bool Equals(IndexedSearchDisabledReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override IndexedSearchDisabledReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, IndexedSearchDisabledReason value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(IndexedSearchDisabledReason)); + } + } +} + +/// Result of an indexed-search startup attempt. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct IndexedSearchOutcome : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public IndexedSearchOutcome(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// A new indexed-search server was started. + public static IndexedSearchOutcome Started { get; } = new("started"); + + /// The repository has too few files for automatic indexing. + public static IndexedSearchOutcome SkippedBelowThreshold { get; } = new("skipped_below_threshold"); + + /// No Git repository was found and indexing was not forced. + public static IndexedSearchOutcome SkippedNoGitroot { get; } = new("skipped_no_gitroot"); + + /// Configuration, policy, or workspace safety disabled indexing. + public static IndexedSearchOutcome SkippedDisabled { get; } = new("skipped_disabled"); + + /// An existing indexed-search server was reused. + public static IndexedSearchOutcome ReusedExisting { get; } = new("reused_existing"); + + /// The startup attempt failed. + public static IndexedSearchOutcome Failed { get; } = new("failed"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(IndexedSearchOutcome left, IndexedSearchOutcome right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(IndexedSearchOutcome left, IndexedSearchOutcome right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is IndexedSearchOutcome other && Equals(other); + + /// + public bool Equals(IndexedSearchOutcome other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override IndexedSearchOutcome Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, IndexedSearchOutcome value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(IndexedSearchOutcome)); + } + } +} + +/// Category of an indexed-search server failure. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct IndexedSearchErrorType : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public IndexedSearchErrorType(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The indexed-search server could not be spawned. + public static IndexedSearchErrorType SpawnError { get; } = new("spawn_error"); + + /// The indexed-search server exited unexpectedly. + public static IndexedSearchErrorType UnexpectedExit { get; } = new("unexpected_exit"); + + /// The indexed-search server was terminated by a signal. + public static IndexedSearchErrorType KilledBySignal { get; } = new("killed_by_signal"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(IndexedSearchErrorType left, IndexedSearchErrorType right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(IndexedSearchErrorType left, IndexedSearchErrorType right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is IndexedSearchErrorType other && Equals(other); + + /// + public bool Equals(IndexedSearchErrorType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override IndexedSearchErrorType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, IndexedSearchErrorType value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(IndexedSearchErrorType)); + } + } +} + +/// Phase of an incremental indexed-search update. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct IndexedSearchIncrementalPhase : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public IndexedSearchIncrementalPhase(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// A workspace scan found changes to index. + public static IndexedSearchIncrementalPhase ChangesDetected { get; } = new("changes_detected"); + + /// The incremental index update completed. + public static IndexedSearchIncrementalPhase Updated { get; } = new("updated"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(IndexedSearchIncrementalPhase left, IndexedSearchIncrementalPhase right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(IndexedSearchIncrementalPhase left, IndexedSearchIncrementalPhase right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is IndexedSearchIncrementalPhase other && Equals(other); + + /// + public bool Equals(IndexedSearchIncrementalPhase other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override IndexedSearchIncrementalPhase Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, IndexedSearchIncrementalPhase value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(IndexedSearchIncrementalPhase)); + } + } +} + +/// Origin of an effective session model change. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct ModelChangeSource : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public ModelChangeSource(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The user selected a model directly with `/model <id>`. + public static ModelChangeSource ModelCommand { get; } = new("model_command"); + + /// The user selected the model with `/settings`. + public static ModelChangeSource SettingsCommand { get; } = new("settings_command"); + + /// The user selected the model with the `/config` alias. + public static ModelChangeSource ConfigCommand { get; } = new("config_command"); + + /// The user selected the model in the model picker, including the picker opened by bare `/model`. + public static ModelChangeSource ModelPicker { get; } = new("model_picker"); + + /// Organization-managed settings selected the model. + public static ModelChangeSource ManagedSettings { get; } = new("managed_settings"); + + /// Repository settings selected the model. + public static ModelChangeSource RepoSettings { get; } = new("repo_settings"); + + /// Startup model resolution selected the model. + public static ModelChangeSource Startup { get; } = new("startup"); /// Selecting an agent selected its configured model. public static ModelChangeSource Agent { get; } = new("agent"); @@ -11995,6 +13178,9 @@ public ModelChangeSource(string value) /// The runtime selected the model automatically, such as rate-limit recovery or refusal fallback. public static ModelChangeSource Automatic { get; } = new("automatic"); + /// The user selected the promoted model from the changeboarding card or its keyboard shortcut. + public static ModelChangeSource ChangeboardingShortcut { get; } = new("changeboarding_shortcut"); + /// An SDK or RPC caller selected the model. public static ModelChangeSource Sdk { get; } = new("sdk"); @@ -12547,45 +13733,39 @@ public override void Write(Utf8JsonWriter writer, CompactionTrigger value, JsonS } } -/// Semantic result of evaluating a task completion request. +/// Category of structured task blocker. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct TaskCompletionOutcome : IEquatable +public readonly struct TaskBlockerKind : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public TaskCompletionOutcome(string value) + public TaskBlockerKind(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The completion request was accepted and the objective is complete. - public static TaskCompletionOutcome Completed { get; } = new("completed"); - - /// The completion request was rejected because more work or validation remains. - public static TaskCompletionOutcome Continue { get; } = new("continue"); - - /// Completion cannot proceed without intervention; the active objective is paused when one is identified. - public static TaskCompletionOutcome Blocked { get; } = new("blocked"); + /// Autopilot permission recovery requires intervention or has no safe autonomous path. + public static TaskBlockerKind PermissionRecovery { get; } = new("permission_recovery"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(TaskCompletionOutcome left, TaskCompletionOutcome right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(TaskBlockerKind left, TaskBlockerKind right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(TaskCompletionOutcome left, TaskCompletionOutcome right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(TaskBlockerKind left, TaskBlockerKind right) => !(left == right); /// - public override bool Equals(object? obj) => obj is TaskCompletionOutcome other && Equals(other); + public override bool Equals(object? obj) => obj is TaskBlockerKind other && Equals(other); /// - public bool Equals(TaskCompletionOutcome other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(TaskBlockerKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -12593,69 +13773,72 @@ public TaskCompletionOutcome(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override TaskCompletionOutcome Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override TaskBlockerKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, TaskCompletionOutcome value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, TaskBlockerKind value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(TaskCompletionOutcome)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(TaskBlockerKind)); } } } -/// Structured terminal status from a tool completion event. +/// Runtime handling applied to a recovery attempt. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct CompletionReceiptToolStatus : IEquatable +public readonly struct PermissionRecoveryAttemptDisposition : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public CompletionReceiptToolStatus(string value) + public PermissionRecoveryAttemptDisposition(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The tool completed successfully. - public static CompletionReceiptToolStatus Success { get; } = new("success"); + /// The request was denied without prompting so the agent could try an alternative. + public static PermissionRecoveryAttemptDisposition Deferred { get; } = new("deferred"); - /// The tool failed without a more specific structured status. - public static CompletionReceiptToolStatus Failure { get; } = new("failure"); + /// The request was surfaced to an interactive responder. + public static PermissionRecoveryAttemptDisposition Prompted { get; } = new("prompted"); - /// The tool exceeded its time budget. - public static CompletionReceiptToolStatus Timeout { get; } = new("timeout"); + /// The interactive responder approved the request. + public static PermissionRecoveryAttemptDisposition Approved { get; } = new("approved"); - /// The user rejected the tool call. - public static CompletionReceiptToolStatus Rejected { get; } = new("rejected"); + /// The interactive responder denied the request or became unavailable. + public static PermissionRecoveryAttemptDisposition Denied { get; } = new("denied"); - /// The permissions service denied the tool call. - public static CompletionReceiptToolStatus Denied { get; } = new("denied"); + /// The request exhausted unattended recovery and produced a blocked outcome. + public static PermissionRecoveryAttemptDisposition Blocked { get; } = new("blocked"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(CompletionReceiptToolStatus left, CompletionReceiptToolStatus right) => left.Equals(right); + /// A tool call succeeded as an equivalent alternative. + public static PermissionRecoveryAttemptDisposition Succeeded { get; } = new("succeeded"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(CompletionReceiptToolStatus left, CompletionReceiptToolStatus right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionRecoveryAttemptDisposition left, PermissionRecoveryAttemptDisposition right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionRecoveryAttemptDisposition left, PermissionRecoveryAttemptDisposition right) => !(left == right); /// - public override bool Equals(object? obj) => obj is CompletionReceiptToolStatus other && Equals(other); + public override bool Equals(object? obj) => obj is PermissionRecoveryAttemptDisposition other && Equals(other); /// - public bool Equals(CompletionReceiptToolStatus other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(PermissionRecoveryAttemptDisposition other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -12663,63 +13846,75 @@ public CompletionReceiptToolStatus(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override CompletionReceiptToolStatus Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override PermissionRecoveryAttemptDisposition Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, CompletionReceiptToolStatus value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, PermissionRecoveryAttemptDisposition value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CompletionReceiptToolStatus)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionRecoveryAttemptDisposition)); } } } -/// Runtime reason the completion decision was accepted. +/// Controlled reason for an individual attempt disposition. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct CompletionReceiptStopReason : IEquatable +public readonly struct PermissionRecoveryAttemptReason : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public CompletionReceiptStopReason(string value) + public PermissionRecoveryAttemptReason(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The model reached a natural terminal response. - public static CompletionReceiptStopReason Natural { get; } = new("natural"); + /// The attempt required permission that Assisted Permissions could not grant. + public static PermissionRecoveryAttemptReason PermissionRequired { get; } = new("permission_required"); - /// A terminal tool ended the interaction. - public static CompletionReceiptStopReason TerminalTool { get; } = new("terminal_tool"); + /// The request repeated an earlier attempt. + public static PermissionRecoveryAttemptReason RepeatedAttempt { get; } = new("repeated_attempt"); - /// The configured agentStop continuation limit was reached. - public static CompletionReceiptStopReason AgentStopBlockLimit { get; } = new("agent_stop_block_limit"); + /// The request exceeded the bounded number of distinct attempts. + public static PermissionRecoveryAttemptReason AttemptsExhausted { get; } = new("attempts_exhausted"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(CompletionReceiptStopReason left, CompletionReceiptStopReason right) => left.Equals(right); + /// The interactive responder approved the request. + public static PermissionRecoveryAttemptReason PermissionApproved { get; } = new("permission_approved"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(CompletionReceiptStopReason left, CompletionReceiptStopReason right) => !(left == right); + /// The interactive responder denied the request. + public static PermissionRecoveryAttemptReason PermissionDenied { get; } = new("permission_denied"); + + /// The interactive responder became unavailable. + public static PermissionRecoveryAttemptReason ResponderUnavailable { get; } = new("responder_unavailable"); + + /// The tool call succeeded without the blocked permission. + public static PermissionRecoveryAttemptReason EquivalentAlternativeSucceeded { get; } = new("equivalent_alternative_succeeded"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionRecoveryAttemptReason left, PermissionRecoveryAttemptReason right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionRecoveryAttemptReason left, PermissionRecoveryAttemptReason right) => !(left == right); /// - public override bool Equals(object? obj) => obj is CompletionReceiptStopReason other && Equals(other); + public override bool Equals(object? obj) => obj is PermissionRecoveryAttemptReason other && Equals(other); /// - public bool Equals(CompletionReceiptStopReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(PermissionRecoveryAttemptReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -12727,61 +13922,63 @@ public CompletionReceiptStopReason(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override CompletionReceiptStopReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override PermissionRecoveryAttemptReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, CompletionReceiptStopReason value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, PermissionRecoveryAttemptReason value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CompletionReceiptStopReason)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionRecoveryAttemptReason)); } } } -/// Kind of turn for which HydraFusion routing is running. -[Experimental(Diagnostics.Experimental)] +/// Relationship of an attempt to earlier permission requests. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct FusionTurnKind : IEquatable +public readonly struct PermissionRecoveryAttemptRelation : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public FusionTurnKind(string value) + public PermissionRecoveryAttemptRelation(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// A user-message turn. - public static FusionTurnKind User { get; } = new("user"); + /// The first denied permission request in the episode. + public static PermissionRecoveryAttemptRelation Initial { get; } = new("initial"); - /// A conversation-compaction turn. - public static FusionTurnKind Compaction { get; } = new("compaction"); + /// A request equivalent to an earlier attempt. + public static PermissionRecoveryAttemptRelation Retry { get; } = new("retry"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(FusionTurnKind left, FusionTurnKind right) => left.Equals(right); + /// A distinct request or a successful alternative tool call. + public static PermissionRecoveryAttemptRelation Alternative { get; } = new("alternative"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(FusionTurnKind left, FusionTurnKind right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionRecoveryAttemptRelation left, PermissionRecoveryAttemptRelation right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionRecoveryAttemptRelation left, PermissionRecoveryAttemptRelation right) => !(left == right); /// - public override bool Equals(object? obj) => obj is FusionTurnKind other && Equals(other); + public override bool Equals(object? obj) => obj is PermissionRecoveryAttemptRelation other && Equals(other); /// - public bool Equals(FusionTurnKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(PermissionRecoveryAttemptRelation other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -12789,61 +13986,60 @@ public FusionTurnKind(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override FusionTurnKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override PermissionRecoveryAttemptRelation Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, FusionTurnKind value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, PermissionRecoveryAttemptRelation value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionTurnKind)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionRecoveryAttemptRelation)); } } } -/// Server-recommended routing behavior for a later HydraFusion turn. -[Experimental(Diagnostics.Experimental)] +/// Action selected when autonomous recovery cannot continue. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct FusionFollowUpAction : IEquatable +public readonly struct PermissionRecoveryOnBlocked : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public FusionFollowUpAction(string value) + public PermissionRecoveryOnBlocked(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Reuse the durable primary model without routing. - public static FusionFollowUpAction ReusePrimary { get; } = new("reuse_primary"); + /// Surface the existing permission prompt to a response-capable client. + public static PermissionRecoveryOnBlocked Ask { get; } = new("ask"); - /// Request a new routing decision. - public static FusionFollowUpAction Reroute { get; } = new("reroute"); + /// Return a structured unsuccessful blocked outcome because no responder is available. + public static PermissionRecoveryOnBlocked Fail { get; } = new("fail"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(FusionFollowUpAction left, FusionFollowUpAction right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionRecoveryOnBlocked left, PermissionRecoveryOnBlocked right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(FusionFollowUpAction left, FusionFollowUpAction right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionRecoveryOnBlocked left, PermissionRecoveryOnBlocked right) => !(left == right); /// - public override bool Equals(object? obj) => obj is FusionFollowUpAction other && Equals(other); + public override bool Equals(object? obj) => obj is PermissionRecoveryOnBlocked other && Equals(other); /// - public bool Equals(FusionFollowUpAction other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(PermissionRecoveryOnBlocked other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -12851,64 +14047,75 @@ public FusionFollowUpAction(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override FusionFollowUpAction Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override PermissionRecoveryOnBlocked Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, FusionFollowUpAction value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, PermissionRecoveryOnBlocked value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionFollowUpAction)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionRecoveryOnBlocked)); } } } -/// Validated HydraFusion execution pattern. -[Experimental(Diagnostics.Experimental)] +/// Controlled reason for a permission-recovery episode transition. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct FusionPattern : IEquatable +public readonly struct PermissionRecoveryReason : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public FusionPattern(string value) + public PermissionRecoveryReason(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Run one primary solver phase. - public static FusionPattern Single { get; } = new("single"); + /// An action required permission that Assisted Permissions could not grant. + public static PermissionRecoveryReason PermissionRequired { get; } = new("permission_required"); - /// Run a primary phase, a judge, and an optional repair. - public static FusionPattern Cascade { get; } = new("cascade"); + /// The agent repeated an equivalent permission request instead of making progress. + public static PermissionRecoveryReason RepeatedAttempt { get; } = new("repeated_attempt"); - /// Run a primary draft, a read-only critique, and a revision. - public static FusionPattern Critique { get; } = new("critique"); + /// The bounded number of distinct permission attempts was exhausted. + public static PermissionRecoveryReason AttemptsExhausted { get; } = new("attempts_exhausted"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(FusionPattern left, FusionPattern right) => left.Equals(right); + /// A responder approved the escalated permission request. + public static PermissionRecoveryReason PermissionApproved { get; } = new("permission_approved"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(FusionPattern left, FusionPattern right) => !(left == right); + /// A responder denied the escalated permission request. + public static PermissionRecoveryReason PermissionDenied { get; } = new("permission_denied"); + + /// The response-capable client became unavailable while escalation was pending. + public static PermissionRecoveryReason ResponderUnavailable { get; } = new("responder_unavailable"); + + /// A later tool call succeeded without requiring the blocked permission. + public static PermissionRecoveryReason EquivalentAlternativeSucceeded { get; } = new("equivalent_alternative_succeeded"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionRecoveryReason left, PermissionRecoveryReason right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionRecoveryReason left, PermissionRecoveryReason right) => !(left == right); /// - public override bool Equals(object? obj) => obj is FusionPattern other && Equals(other); + public override bool Equals(object? obj) => obj is PermissionRecoveryReason other && Equals(other); /// - public bool Equals(FusionPattern other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(PermissionRecoveryReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -12916,76 +14123,66 @@ public FusionPattern(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override FusionPattern Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override PermissionRecoveryReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, FusionPattern value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, PermissionRecoveryReason value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionPattern)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionRecoveryReason)); } } } -/// HydraFusion phase kind. -[Experimental(Diagnostics.Experimental)] +/// Lifecycle state of a permission-recovery episode. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct FusionPhaseKind : IEquatable +public readonly struct PermissionRecoveryStatus : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public FusionPhaseKind(string value) + public PermissionRecoveryStatus(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Primary solver phase. - public static FusionPhaseKind Primary { get; } = new("primary"); - - /// Read-only cascade judge phase. - public static FusionPhaseKind Judge { get; } = new("judge"); - - /// Cascade repair phase. - public static FusionPhaseKind Repair { get; } = new("repair"); - - /// Initial critique-pattern draft phase. - public static FusionPhaseKind Draft { get; } = new("draft"); + /// Autopilot may try a bounded equivalent alternative. + public static PermissionRecoveryStatus Recovering { get; } = new("recovering"); - /// Read-only critique phase. - public static FusionPhaseKind Critic { get; } = new("critic"); + /// An interactive permission response is required. + public static PermissionRecoveryStatus AwaitingApproval { get; } = new("awaiting_approval"); - /// Critique-pattern revision phase. - public static FusionPhaseKind Revision { get; } = new("revision"); + /// The episode ended through approval or a successful equivalent alternative. + public static PermissionRecoveryStatus Resolved { get; } = new("resolved"); - /// Follow-up phase continuing from the resolved model. - public static FusionPhaseKind FollowUp { get; } = new("follow_up"); + /// No autonomous path remains and the task requires intervention. + public static PermissionRecoveryStatus Blocked { get; } = new("blocked"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(FusionPhaseKind left, FusionPhaseKind right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionRecoveryStatus left, PermissionRecoveryStatus right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(FusionPhaseKind left, FusionPhaseKind right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionRecoveryStatus left, PermissionRecoveryStatus right) => !(left == right); /// - public override bool Equals(object? obj) => obj is FusionPhaseKind other && Equals(other); + public override bool Equals(object? obj) => obj is PermissionRecoveryStatus other && Equals(other); /// - public bool Equals(FusionPhaseKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(PermissionRecoveryStatus other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -12993,61 +14190,63 @@ public FusionPhaseKind(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override FusionPhaseKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override PermissionRecoveryStatus Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, FusionPhaseKind value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, PermissionRecoveryStatus value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionPhaseKind)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionRecoveryStatus)); } } } -/// Conversation scope in which a HydraFusion phase executes. -[Experimental(Diagnostics.Experimental)] +/// Semantic result of evaluating a task completion request. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct FusionConversationScope : IEquatable +public readonly struct TaskCompletionOutcome : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public FusionConversationScope(string value) + public TaskCompletionOutcome(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Canonical root conversation history. - public static FusionConversationScope Root { get; } = new("root"); + /// The completion request was accepted and the objective is complete. + public static TaskCompletionOutcome Completed { get; } = new("completed"); - /// Isolated read-only review history that does not enter the root conversation. - public static FusionConversationScope Review { get; } = new("review"); + /// The completion request was rejected because more work or validation remains. + public static TaskCompletionOutcome Continue { get; } = new("continue"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(FusionConversationScope left, FusionConversationScope right) => left.Equals(right); + /// Completion cannot proceed without intervention; the active objective is paused when one is identified. + public static TaskCompletionOutcome Blocked { get; } = new("blocked"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(FusionConversationScope left, FusionConversationScope right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(TaskCompletionOutcome left, TaskCompletionOutcome right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(TaskCompletionOutcome left, TaskCompletionOutcome right) => !(left == right); /// - public override bool Equals(object? obj) => obj is FusionConversationScope other && Equals(other); + public override bool Equals(object? obj) => obj is TaskCompletionOutcome other && Equals(other); /// - public bool Equals(FusionConversationScope other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(TaskCompletionOutcome other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13055,66 +14254,69 @@ public FusionConversationScope(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override FusionConversationScope Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override TaskCompletionOutcome Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, FusionConversationScope value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, TaskCompletionOutcome value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionConversationScope)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(TaskCompletionOutcome)); } } } -/// The agent mode that was active when this message was sent. +/// Structured terminal status from a tool completion event. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct UserMessageAgentMode : IEquatable +public readonly struct CompletionReceiptToolStatus : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public UserMessageAgentMode(string value) + public CompletionReceiptToolStatus(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The agent is responding interactively to the user. - public static UserMessageAgentMode Interactive { get; } = new("interactive"); + /// The tool completed successfully. + public static CompletionReceiptToolStatus Success { get; } = new("success"); - /// The agent is preparing a plan before making changes. - public static UserMessageAgentMode Plan { get; } = new("plan"); + /// The tool failed without a more specific structured status. + public static CompletionReceiptToolStatus Failure { get; } = new("failure"); - /// The agent is working autonomously toward task completion. - public static UserMessageAgentMode Autopilot { get; } = new("autopilot"); + /// The tool exceeded its time budget. + public static CompletionReceiptToolStatus Timeout { get; } = new("timeout"); - /// The agent is in shell-focused UI mode. - public static UserMessageAgentMode Shell { get; } = new("shell"); + /// The user rejected the tool call. + public static CompletionReceiptToolStatus Rejected { get; } = new("rejected"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(UserMessageAgentMode left, UserMessageAgentMode right) => left.Equals(right); + /// The permissions service denied the tool call. + public static CompletionReceiptToolStatus Denied { get; } = new("denied"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(UserMessageAgentMode left, UserMessageAgentMode right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CompletionReceiptToolStatus left, CompletionReceiptToolStatus right) => left.Equals(right); - /// - public override bool Equals(object? obj) => obj is UserMessageAgentMode other && Equals(other); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CompletionReceiptToolStatus left, CompletionReceiptToolStatus right) => !(left == right); /// - public bool Equals(UserMessageAgentMode other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public override bool Equals(object? obj) => obj is CompletionReceiptToolStatus other && Equals(other); + + /// + public bool Equals(CompletionReceiptToolStatus other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13122,60 +14324,63 @@ public UserMessageAgentMode(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override UserMessageAgentMode Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override CompletionReceiptToolStatus Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, UserMessageAgentMode value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, CompletionReceiptToolStatus value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(UserMessageAgentMode)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CompletionReceiptToolStatus)); } } } -/// Why the binary data is absent: it exceeded the inline size limit, or its asset was unavailable. +/// Runtime reason the completion decision was accepted. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct OmittedBinaryOmittedReason : IEquatable +public readonly struct CompletionReceiptStopReason : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public OmittedBinaryOmittedReason(string value) + public CompletionReceiptStopReason(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Bytes exceeded the session's inline size limit. - public static OmittedBinaryOmittedReason TooLarge { get; } = new("too_large"); + /// The model reached a natural terminal response. + public static CompletionReceiptStopReason Natural { get; } = new("natural"); - /// The referenced binary asset could not be found (e.g. a truncated log). - public static OmittedBinaryOmittedReason AssetUnavailable { get; } = new("asset_unavailable"); + /// A terminal tool ended the interaction. + public static CompletionReceiptStopReason TerminalTool { get; } = new("terminal_tool"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(OmittedBinaryOmittedReason left, OmittedBinaryOmittedReason right) => left.Equals(right); + /// The configured agentStop continuation limit was reached. + public static CompletionReceiptStopReason AgentStopBlockLimit { get; } = new("agent_stop_block_limit"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(OmittedBinaryOmittedReason left, OmittedBinaryOmittedReason right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CompletionReceiptStopReason left, CompletionReceiptStopReason right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CompletionReceiptStopReason left, CompletionReceiptStopReason right) => !(left == right); /// - public override bool Equals(object? obj) => obj is OmittedBinaryOmittedReason other && Equals(other); + public override bool Equals(object? obj) => obj is CompletionReceiptStopReason other && Equals(other); /// - public bool Equals(OmittedBinaryOmittedReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(CompletionReceiptStopReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13183,63 +14388,123 @@ public OmittedBinaryOmittedReason(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override OmittedBinaryOmittedReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override CompletionReceiptStopReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, OmittedBinaryOmittedReason value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, CompletionReceiptStopReason value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(OmittedBinaryOmittedReason)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CompletionReceiptStopReason)); } } } -/// Type of GitHub reference. +/// Kind of turn for which HydraFusion routing is running. +[Experimental(Diagnostics.Experimental)] [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct AttachmentGitHubReferenceType : IEquatable +public readonly struct FusionTurnKind : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public AttachmentGitHubReferenceType(string value) + public FusionTurnKind(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// GitHub issue reference. - public static AttachmentGitHubReferenceType Issue { get; } = new("issue"); + /// A user-message turn. + public static FusionTurnKind User { get; } = new("user"); - /// GitHub pull request reference. - public static AttachmentGitHubReferenceType Pr { get; } = new("pr"); + /// A conversation-compaction turn. + public static FusionTurnKind Compaction { get; } = new("compaction"); - /// GitHub discussion reference. - public static AttachmentGitHubReferenceType Discussion { get; } = new("discussion"); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(FusionTurnKind left, FusionTurnKind right) => left.Equals(right); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(AttachmentGitHubReferenceType left, AttachmentGitHubReferenceType right) => left.Equals(right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(FusionTurnKind left, FusionTurnKind right) => !(left == right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(AttachmentGitHubReferenceType left, AttachmentGitHubReferenceType right) => !(left == right); + /// + public override bool Equals(object? obj) => obj is FusionTurnKind other && Equals(other); /// - public override bool Equals(object? obj) => obj is AttachmentGitHubReferenceType other && Equals(other); + public bool Equals(FusionTurnKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// - public bool Equals(AttachmentGitHubReferenceType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override FusionTurnKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, FusionTurnKind value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionTurnKind)); + } + } +} + +/// Server-recommended routing behavior for a later HydraFusion turn. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct FusionFollowUpAction : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public FusionFollowUpAction(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Reuse the durable primary model without routing. + public static FusionFollowUpAction ReusePrimary { get; } = new("reuse_primary"); + + /// Request a new routing decision. + public static FusionFollowUpAction Reroute { get; } = new("reroute"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(FusionFollowUpAction left, FusionFollowUpAction right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(FusionFollowUpAction left, FusionFollowUpAction right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is FusionFollowUpAction other && Equals(other); + + /// + public bool Equals(FusionFollowUpAction other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13247,63 +14512,64 @@ public AttachmentGitHubReferenceType(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override AttachmentGitHubReferenceType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override FusionFollowUpAction Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, AttachmentGitHubReferenceType value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, FusionFollowUpAction value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AttachmentGitHubReferenceType)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionFollowUpAction)); } } } -/// How this user message was delivered to the agentic loop, relative to whether the loop was already running. This is the timing axis only; the message's origin (human vs. system/command/schedule/skill/etc.) is carried separately by `source`. A system-injected message has a delivery too — e.g. a background-task notification waking an idle agent is `idle`, the same mechanism as a human starting a fresh turn. +/// Validated HydraFusion execution pattern. +[Experimental(Diagnostics.Experimental)] [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct UserMessageDelivery : IEquatable +public readonly struct FusionPattern : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public UserMessageDelivery(string value) + public FusionPattern(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Delivered while the loop was idle; starts its own run immediately (a human's fresh turn, or a system notification waking an idle agent). - public static UserMessageDelivery Idle { get; } = new("idle"); + /// Run one primary solver phase. + public static FusionPattern Single { get; } = new("single"); - /// Injected into the current in-flight run while the agent was busy (immediate mode). - public static UserMessageDelivery Steering { get; } = new("steering"); + /// Run a primary phase, a judge, and an optional repair. + public static FusionPattern Cascade { get; } = new("cascade"); - /// Enqueued while the agent was busy; processed as its own run afterward. - public static UserMessageDelivery Queued { get; } = new("queued"); + /// Run a primary draft, a read-only critique, and a revision. + public static FusionPattern Critique { get; } = new("critique"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(UserMessageDelivery left, UserMessageDelivery right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(FusionPattern left, FusionPattern right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(UserMessageDelivery left, UserMessageDelivery right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(FusionPattern left, FusionPattern right) => !(left == right); /// - public override bool Equals(object? obj) => obj is UserMessageDelivery other && Equals(other); + public override bool Equals(object? obj) => obj is FusionPattern other && Equals(other); /// - public bool Equals(UserMessageDelivery other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(FusionPattern other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13311,66 +14577,1212 @@ public UserMessageDelivery(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override UserMessageDelivery Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override FusionPattern Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, UserMessageDelivery value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, FusionPattern value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(UserMessageDelivery)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionPattern)); } } } -/// What the agent was doing when the user interrupted it. +/// HydraFusion phase kind. +[Experimental(Diagnostics.Experimental)] [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct AgentInterruptedActivity : IEquatable +public readonly struct FusionPhaseKind : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public AgentInterruptedActivity(string value) + public FusionPhaseKind(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// A request to the model was open. - public static AgentInterruptedActivity ModelCall { get; } = new("model_call"); + /// Primary solver phase. + public static FusionPhaseKind Primary { get; } = new("primary"); - /// The turn was sleeping between retry attempts. - public static AgentInterruptedActivity RetryBackoff { get; } = new("retry_backoff"); + /// Read-only cascade judge phase. + public static FusionPhaseKind Judge { get; } = new("judge"); - /// One or more tools were executing. - public static AgentInterruptedActivity ToolCall { get; } = new("tool_call"); + /// Cascade repair phase. + public static FusionPhaseKind Repair { get; } = new("repair"); - /// Background sub-agents were running while the main loop was idle. - public static AgentInterruptedActivity BackgroundAgent { get; } = new("background_agent"); + /// Initial critique-pattern draft phase. + public static FusionPhaseKind Draft { get; } = new("draft"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(AgentInterruptedActivity left, AgentInterruptedActivity right) => left.Equals(right); + /// Read-only critique phase. + public static FusionPhaseKind Critic { get; } = new("critic"); + + /// Critique-pattern revision phase. + public static FusionPhaseKind Revision { get; } = new("revision"); + + /// Follow-up phase continuing from the resolved model. + public static FusionPhaseKind FollowUp { get; } = new("follow_up"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(FusionPhaseKind left, FusionPhaseKind right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(FusionPhaseKind left, FusionPhaseKind right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is FusionPhaseKind other && Equals(other); + + /// + public bool Equals(FusionPhaseKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override FusionPhaseKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, FusionPhaseKind value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionPhaseKind)); + } + } +} + +/// Conversation scope in which a HydraFusion phase executes. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct FusionConversationScope : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public FusionConversationScope(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Canonical root conversation history. + public static FusionConversationScope Root { get; } = new("root"); + + /// Isolated read-only review history that does not enter the root conversation. + public static FusionConversationScope Review { get; } = new("review"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(FusionConversationScope left, FusionConversationScope right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(FusionConversationScope left, FusionConversationScope right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is FusionConversationScope other && Equals(other); + + /// + public bool Equals(FusionConversationScope other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override FusionConversationScope Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, FusionConversationScope value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionConversationScope)); + } + } +} + +/// The agent mode that was active when this message was sent. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct UserMessageAgentMode : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public UserMessageAgentMode(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The agent is responding interactively to the user. + public static UserMessageAgentMode Interactive { get; } = new("interactive"); + + /// The agent is preparing a plan before making changes. + public static UserMessageAgentMode Plan { get; } = new("plan"); + + /// The agent is working autonomously toward task completion. + public static UserMessageAgentMode Autopilot { get; } = new("autopilot"); + + /// The agent is in shell-focused UI mode. + public static UserMessageAgentMode Shell { get; } = new("shell"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(UserMessageAgentMode left, UserMessageAgentMode right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(UserMessageAgentMode left, UserMessageAgentMode right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is UserMessageAgentMode other && Equals(other); + + /// + public bool Equals(UserMessageAgentMode other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override UserMessageAgentMode Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, UserMessageAgentMode value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(UserMessageAgentMode)); + } + } +} + +/// Why the binary data is absent: it exceeded the inline size limit, or its asset was unavailable. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct OmittedBinaryOmittedReason : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public OmittedBinaryOmittedReason(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Bytes exceeded the session's inline size limit. + public static OmittedBinaryOmittedReason TooLarge { get; } = new("too_large"); + + /// The referenced binary asset could not be found (e.g. a truncated log). + public static OmittedBinaryOmittedReason AssetUnavailable { get; } = new("asset_unavailable"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(OmittedBinaryOmittedReason left, OmittedBinaryOmittedReason right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(OmittedBinaryOmittedReason left, OmittedBinaryOmittedReason right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is OmittedBinaryOmittedReason other && Equals(other); + + /// + public bool Equals(OmittedBinaryOmittedReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override OmittedBinaryOmittedReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, OmittedBinaryOmittedReason value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(OmittedBinaryOmittedReason)); + } + } +} + +/// Type of GitHub reference. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct AttachmentGitHubReferenceType : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public AttachmentGitHubReferenceType(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// GitHub issue reference. + public static AttachmentGitHubReferenceType Issue { get; } = new("issue"); + + /// GitHub pull request reference. + public static AttachmentGitHubReferenceType Pr { get; } = new("pr"); + + /// GitHub discussion reference. + public static AttachmentGitHubReferenceType Discussion { get; } = new("discussion"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(AttachmentGitHubReferenceType left, AttachmentGitHubReferenceType right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(AttachmentGitHubReferenceType left, AttachmentGitHubReferenceType right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is AttachmentGitHubReferenceType other && Equals(other); + + /// + public bool Equals(AttachmentGitHubReferenceType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override AttachmentGitHubReferenceType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, AttachmentGitHubReferenceType value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AttachmentGitHubReferenceType)); + } + } +} + +/// How this user message was delivered to the agentic loop, relative to whether the loop was already running. This is the timing axis only; the message's origin (human vs. system/command/schedule/skill/etc.) is carried separately by `source`. A system-injected message has a delivery too — e.g. a background-task notification waking an idle agent is `idle`, the same mechanism as a human starting a fresh turn. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct UserMessageDelivery : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public UserMessageDelivery(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Delivered while the loop was idle; starts its own run immediately (a human's fresh turn, or a system notification waking an idle agent). + public static UserMessageDelivery Idle { get; } = new("idle"); + + /// Injected into the current in-flight run while the agent was busy (immediate mode). + public static UserMessageDelivery Steering { get; } = new("steering"); + + /// Enqueued while the agent was busy; processed as its own run afterward. + public static UserMessageDelivery Queued { get; } = new("queued"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(UserMessageDelivery left, UserMessageDelivery right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(UserMessageDelivery left, UserMessageDelivery right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is UserMessageDelivery other && Equals(other); + + /// + public bool Equals(UserMessageDelivery other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override UserMessageDelivery Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, UserMessageDelivery value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(UserMessageDelivery)); + } + } +} + +/// What the agent was doing when the user interrupted it. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct AgentInterruptedActivity : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public AgentInterruptedActivity(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// A request to the model was open. + public static AgentInterruptedActivity ModelCall { get; } = new("model_call"); + + /// The turn was sleeping between retry attempts. + public static AgentInterruptedActivity RetryBackoff { get; } = new("retry_backoff"); + + /// One or more tools were executing. + public static AgentInterruptedActivity ToolCall { get; } = new("tool_call"); + + /// Background sub-agents were running while the main loop was idle. + public static AgentInterruptedActivity BackgroundAgent { get; } = new("background_agent"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(AgentInterruptedActivity left, AgentInterruptedActivity right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(AgentInterruptedActivity left, AgentInterruptedActivity right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is AgentInterruptedActivity other && Equals(other); + + /// + public bool Equals(AgentInterruptedActivity other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override AgentInterruptedActivity Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, AgentInterruptedActivity value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AgentInterruptedActivity)); + } + } +} + +/// Where the interruption landed relative to the first streamed token. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct AgentInterruptedCancelPhase : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public AgentInterruptedCancelPhase(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// No output had been produced when the request was cancelled. + public static AgentInterruptedCancelPhase PreFirstToken { get; } = new("pre_first_token"); + + /// The response was already streaming when the request was cancelled. + public static AgentInterruptedCancelPhase MidStream { get; } = new("mid_stream"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(AgentInterruptedCancelPhase left, AgentInterruptedCancelPhase right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(AgentInterruptedCancelPhase left, AgentInterruptedCancelPhase right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is AgentInterruptedCancelPhase other && Equals(other); + + /// + public bool Equals(AgentInterruptedCancelPhase other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override AgentInterruptedCancelPhase Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, AgentInterruptedCancelPhase value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AgentInterruptedCancelPhase)); + } + } +} + +/// Transport used for a failed model call. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct ModelCallFailureTransport : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public ModelCallFailureTransport(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// HTTP transport, including SSE streams. + public static ModelCallFailureTransport Http { get; } = new("http"); + + /// WebSocket transport. + public static ModelCallFailureTransport Websocket { get; } = new("websocket"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(ModelCallFailureTransport left, ModelCallFailureTransport right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(ModelCallFailureTransport left, ModelCallFailureTransport right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is ModelCallFailureTransport other && Equals(other); + + /// + public bool Equals(ModelCallFailureTransport other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override ModelCallFailureTransport Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, ModelCallFailureTransport value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFailureTransport)); + } + } +} + +/// Content-safe activity observed while a HydraFusion phase is running. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct FusionPhaseActivityKind : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public FusionPhaseActivityKind(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The provider produced additional private output bytes. + public static FusionPhaseActivityKind ModelOutput { get; } = new("model_output"); + + /// A tool began executing inside the phase. + public static FusionPhaseActivityKind ToolStarted { get; } = new("tool_started"); + + /// A tool finished executing inside the phase. + public static FusionPhaseActivityKind ToolCompleted { get; } = new("tool_completed"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(FusionPhaseActivityKind left, FusionPhaseActivityKind right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(FusionPhaseActivityKind left, FusionPhaseActivityKind right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is FusionPhaseActivityKind other && Equals(other); + + /// + public bool Equals(FusionPhaseActivityKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override FusionPhaseActivityKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, FusionPhaseActivityKind value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionPhaseActivityKind)); + } + } +} + +/// How a durable phase checkpoint contributes its exact message to canonical root history. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct FusionProjectionMode : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public FusionProjectionMode(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Append the exact root message immediately. + public static FusionProjectionMode Append { get; } = new("append"); + + /// Hold a terminal message outside canonical history until the final commit selects it. + public static FusionProjectionMode Staged { get; } = new("staged"); + + /// Do not project the checkpoint into root history. + public static FusionProjectionMode None { get; } = new("none"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(FusionProjectionMode left, FusionProjectionMode right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(FusionProjectionMode left, FusionProjectionMode right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is FusionProjectionMode other && Equals(other); + + /// + public bool Equals(FusionProjectionMode other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override FusionProjectionMode Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, FusionProjectionMode value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionProjectionMode)); + } + } +} + +/// Durable outcome status of a HydraFusion phase. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct FusionPhaseStatus : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public FusionPhaseStatus(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The phase completed successfully. + public static FusionPhaseStatus Succeeded { get; } = new("succeeded"); + + /// The phase failed. + public static FusionPhaseStatus Failed { get; } = new("failed"); + + /// The phase was cancelled. + public static FusionPhaseStatus Cancelled { get; } = new("cancelled"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(FusionPhaseStatus left, FusionPhaseStatus right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(FusionPhaseStatus left, FusionPhaseStatus right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is FusionPhaseStatus other && Equals(other); + + /// + public bool Equals(FusionPhaseStatus other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override FusionPhaseStatus Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, FusionPhaseStatus value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionPhaseStatus)); + } + } +} + +/// Tool call type: "function" for standard tool calls, "custom" for grammar-based tool calls. Defaults to "function" when absent. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct AssistantMessageToolRequestType : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public AssistantMessageToolRequestType(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Standard function-style tool call. + public static AssistantMessageToolRequestType Function { get; } = new("function"); + + /// Custom grammar-based tool call. + public static AssistantMessageToolRequestType Custom { get; } = new("custom"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(AssistantMessageToolRequestType left, AssistantMessageToolRequestType right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(AssistantMessageToolRequestType left, AssistantMessageToolRequestType right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is AssistantMessageToolRequestType other && Equals(other); + + /// + public bool Equals(AssistantMessageToolRequestType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override AssistantMessageToolRequestType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, AssistantMessageToolRequestType value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AssistantMessageToolRequestType)); + } + } +} + +/// The system that produced a citation. +[Experimental(Diagnostics.Experimental)] +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct CitationProvider : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public CitationProvider(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Citation produced by an Anthropic (Claude) model response. + public static CitationProvider Anthropic { get; } = new("anthropic"); + + /// Citation produced by an OpenAI model response. + public static CitationProvider Openai { get; } = new("openai"); + + /// Citation synthesized client-side by the runtime from tool output. + public static CitationProvider Client { get; } = new("client"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(CitationProvider left, CitationProvider right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(CitationProvider left, CitationProvider right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is CitationProvider other && Equals(other); + + /// + public bool Equals(CitationProvider other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override CitationProvider Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, CitationProvider value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CitationProvider)); + } + } +} + +/// Hosted program caller type. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct AssistantMessageToolRequestCallerType : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public AssistantMessageToolRequestCallerType(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Gets the program value. + public static AssistantMessageToolRequestCallerType Program { get; } = new("program"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(AssistantMessageToolRequestCallerType left, AssistantMessageToolRequestCallerType right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(AssistantMessageToolRequestCallerType left, AssistantMessageToolRequestCallerType right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is AssistantMessageToolRequestCallerType other && Equals(other); + + /// + public bool Equals(AssistantMessageToolRequestCallerType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override AssistantMessageToolRequestCallerType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, AssistantMessageToolRequestCallerType value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AssistantMessageToolRequestCallerType)); + } + } +} + +/// API endpoint used for this model call, matching CAPI supported_endpoints vocabulary. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct AssistantUsageApiEndpoint : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public AssistantUsageApiEndpoint(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Chat Completions API endpoint. + public static AssistantUsageApiEndpoint ChatCompletions { get; } = new("/chat/completions"); + + /// Anthropic Messages API endpoint. + public static AssistantUsageApiEndpoint V1Messages { get; } = new("/v1/messages"); + + /// Responses API endpoint. + public static AssistantUsageApiEndpoint Responses { get; } = new("/responses"); + + /// WebSocket Responses API endpoint. + public static AssistantUsageApiEndpoint WsResponses { get; } = new("ws:/responses"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(AssistantUsageApiEndpoint left, AssistantUsageApiEndpoint right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(AssistantUsageApiEndpoint left, AssistantUsageApiEndpoint right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is AssistantUsageApiEndpoint other && Equals(other); + + /// + public bool Equals(AssistantUsageApiEndpoint other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override AssistantUsageApiEndpoint Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, AssistantUsageApiEndpoint value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AssistantUsageApiEndpoint)); + } + } +} + +/// Transport used for a successful model call. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct AssistantUsageTransport : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public AssistantUsageTransport(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// HTTP transport, including SSE streams. + public static AssistantUsageTransport Http { get; } = new("http"); + + /// WebSocket transport. + public static AssistantUsageTransport Websocket { get; } = new("websocket"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(AssistantUsageTransport left, AssistantUsageTransport right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(AssistantUsageTransport left, AssistantUsageTransport right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is AssistantUsageTransport other && Equals(other); + + /// + public bool Equals(AssistantUsageTransport other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override AssistantUsageTransport Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, AssistantUsageTransport value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AssistantUsageTransport)); + } + } +} + +/// For HTTP 400 failures only: whether the response carried a structured CAPI error envelope (structured_error, a deterministic validation failure) or no error body (bodyless, the transient gateway/proxy signature). Absent for non-400 failures. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct ModelCallFailureBadRequestKind : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public ModelCallFailureBadRequestKind(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The 400 response carried no error body (transient gateway/proxy signature). + public static ModelCallFailureBadRequestKind Bodyless { get; } = new("bodyless"); + + /// The 400 response carried a structured CAPI error envelope (deterministic validation failure). + public static ModelCallFailureBadRequestKind StructuredError { get; } = new("structured_error"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(ModelCallFailureBadRequestKind left, ModelCallFailureBadRequestKind right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(ModelCallFailureBadRequestKind left, ModelCallFailureBadRequestKind right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is ModelCallFailureBadRequestKind other && Equals(other); + + /// + public bool Equals(ModelCallFailureBadRequestKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override ModelCallFailureBadRequestKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, ModelCallFailureBadRequestKind value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFailureBadRequestKind)); + } + } +} + +/// Boundary that produced a model call failure. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct ModelCallFailureKind : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public ModelCallFailureKind(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The provider returned an API error response. + public static ModelCallFailureKind Api { get; } = new("api"); + + /// The request transport failed before a usable API response completed. + public static ModelCallFailureKind Transport { get; } = new("transport"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(ModelCallFailureKind left, ModelCallFailureKind right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(AgentInterruptedActivity left, AgentInterruptedActivity right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(ModelCallFailureKind left, ModelCallFailureKind right) => !(left == right); /// - public override bool Equals(object? obj) => obj is AgentInterruptedActivity other && Equals(other); + public override bool Equals(object? obj) => obj is ModelCallFailureKind other && Equals(other); /// - public bool Equals(AgentInterruptedActivity other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(ModelCallFailureKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13378,60 +15790,63 @@ public AgentInterruptedActivity(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override AgentInterruptedActivity Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override ModelCallFailureKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, AgentInterruptedActivity value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, ModelCallFailureKind value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AgentInterruptedActivity)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFailureKind)); } } } -/// Where the interruption landed relative to the first streamed token. +/// Where the failed model call originated. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct AgentInterruptedCancelPhase : IEquatable +public readonly struct ModelCallFailureSource : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public AgentInterruptedCancelPhase(string value) + public ModelCallFailureSource(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// No output had been produced when the request was cancelled. - public static AgentInterruptedCancelPhase PreFirstToken { get; } = new("pre_first_token"); + /// Model call from the top-level agent. + public static ModelCallFailureSource TopLevel { get; } = new("top_level"); - /// The response was already streaming when the request was cancelled. - public static AgentInterruptedCancelPhase MidStream { get; } = new("mid_stream"); + /// Model call from a sub-agent. + public static ModelCallFailureSource Subagent { get; } = new("subagent"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(AgentInterruptedCancelPhase left, AgentInterruptedCancelPhase right) => left.Equals(right); + /// Model call from MCP sampling. + public static ModelCallFailureSource McpSampling { get; } = new("mcp_sampling"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(AgentInterruptedCancelPhase left, AgentInterruptedCancelPhase right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(ModelCallFailureSource left, ModelCallFailureSource right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(ModelCallFailureSource left, ModelCallFailureSource right) => !(left == right); /// - public override bool Equals(object? obj) => obj is AgentInterruptedCancelPhase other && Equals(other); + public override bool Equals(object? obj) => obj is ModelCallFailureSource other && Equals(other); /// - public bool Equals(AgentInterruptedCancelPhase other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(ModelCallFailureSource other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13439,60 +15854,66 @@ public AgentInterruptedCancelPhase(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override AgentInterruptedCancelPhase Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override ModelCallFailureSource Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, AgentInterruptedCancelPhase value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, ModelCallFailureSource value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AgentInterruptedCancelPhase)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFailureSource)); } } } -/// Transport used for a failed model call. +/// Final outcome of one logical model dispatch after response acceptance processing. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ModelCallFailureTransport : IEquatable +public readonly struct ModelCallFinishedOutcome : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ModelCallFailureTransport(string value) + public ModelCallFinishedOutcome(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// HTTP transport, including SSE streams. - public static ModelCallFailureTransport Http { get; } = new("http"); + /// The provider response was accepted for continued agent processing. + public static ModelCallFinishedOutcome Success { get; } = new("success"); - /// WebSocket transport. - public static ModelCallFailureTransport Websocket { get; } = new("websocket"); + /// The dispatch ended with a provider or transport error. + public static ModelCallFinishedOutcome Error { get; } = new("error"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(ModelCallFailureTransport left, ModelCallFailureTransport right) => left.Equals(right); + /// The dispatch was cancelled before an accepted response was produced. + public static ModelCallFinishedOutcome Cancelled { get; } = new("cancelled"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(ModelCallFailureTransport left, ModelCallFailureTransport right) => !(left == right); + /// The provider response was rejected during post-response acceptance processing. + public static ModelCallFinishedOutcome Rejected { get; } = new("rejected"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(ModelCallFinishedOutcome left, ModelCallFinishedOutcome right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(ModelCallFinishedOutcome left, ModelCallFinishedOutcome right) => !(left == right); /// - public override bool Equals(object? obj) => obj is ModelCallFailureTransport other && Equals(other); + public override bool Equals(object? obj) => obj is ModelCallFinishedOutcome other && Equals(other); /// - public bool Equals(ModelCallFailureTransport other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(ModelCallFinishedOutcome other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13500,64 +15921,66 @@ public ModelCallFailureTransport(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override ModelCallFailureTransport Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override ModelCallFinishedOutcome Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, ModelCallFailureTransport value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, ModelCallFinishedOutcome value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFailureTransport)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFinishedOutcome)); } } } -/// Content-safe activity observed while a HydraFusion phase is running. -[Experimental(Diagnostics.Experimental)] +/// Finite reason code describing why the current turn was aborted. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct FusionPhaseActivityKind : IEquatable +public readonly struct AbortReason : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public FusionPhaseActivityKind(string value) + public AbortReason(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The provider produced additional private output bytes. - public static FusionPhaseActivityKind ModelOutput { get; } = new("model_output"); + /// The local user requested the abort, for example by pressing Ctrl+C in the CLI. + public static AbortReason UserInitiated { get; } = new("user_initiated"); - /// A tool began executing inside the phase. - public static FusionPhaseActivityKind ToolStarted { get; } = new("tool_started"); + /// A remote command requested the abort. + public static AbortReason RemoteCommand { get; } = new("remote_command"); - /// A tool finished executing inside the phase. - public static FusionPhaseActivityKind ToolCompleted { get; } = new("tool_completed"); + /// An MCP server delivered a user.abort notification. + public static AbortReason UserAbort { get; } = new("user_abort"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(FusionPhaseActivityKind left, FusionPhaseActivityKind right) => left.Equals(right); + /// Autopilot stopped the run because the active objective reached its user-set --max-ai-credits limit. + public static AbortReason AutopilotCreditLimit { get; } = new("autopilot_credit_limit"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(FusionPhaseActivityKind left, FusionPhaseActivityKind right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(AbortReason left, AbortReason right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(AbortReason left, AbortReason right) => !(left == right); /// - public override bool Equals(object? obj) => obj is FusionPhaseActivityKind other && Equals(other); + public override bool Equals(object? obj) => obj is AbortReason other && Equals(other); /// - public bool Equals(FusionPhaseActivityKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(AbortReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13565,64 +15988,69 @@ public FusionPhaseActivityKind(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override FusionPhaseActivityKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override AbortReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, FusionPhaseActivityKind value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, AbortReason value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionPhaseActivityKind)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AbortReason)); } } } -/// How a durable phase checkpoint contributes its exact message to canonical root history. -[Experimental(Diagnostics.Experimental)] +/// Configuration source: user, workspace, plugin, builtin, or managed. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct FusionProjectionMode : IEquatable +public readonly struct McpServerSource : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public FusionProjectionMode(string value) + public McpServerSource(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Append the exact root message immediately. - public static FusionProjectionMode Append { get; } = new("append"); + /// Server configured in the user's global MCP configuration. + public static McpServerSource User { get; } = new("user"); - /// Hold a terminal message outside canonical history until the final commit selects it. - public static FusionProjectionMode Staged { get; } = new("staged"); + /// Server configured by the current workspace. + public static McpServerSource Workspace { get; } = new("workspace"); - /// Do not project the checkpoint into root history. - public static FusionProjectionMode None { get; } = new("none"); + /// Server contributed by an installed plugin. + public static McpServerSource Plugin { get; } = new("plugin"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(FusionProjectionMode left, FusionProjectionMode right) => left.Equals(right); + /// Server bundled with the runtime. + public static McpServerSource Builtin { get; } = new("builtin"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(FusionProjectionMode left, FusionProjectionMode right) => !(left == right); + /// Server supplied by a trusted host-managed catalog. + public static McpServerSource Managed { get; } = new("managed"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(McpServerSource left, McpServerSource right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(McpServerSource left, McpServerSource right) => !(left == right); /// - public override bool Equals(object? obj) => obj is FusionProjectionMode other && Equals(other); + public override bool Equals(object? obj) => obj is McpServerSource other && Equals(other); /// - public bool Equals(FusionProjectionMode other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(McpServerSource other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13630,64 +16058,66 @@ public FusionProjectionMode(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override FusionProjectionMode Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override McpServerSource Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, FusionProjectionMode value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, McpServerSource value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionProjectionMode)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(McpServerSource)); } } } -/// Durable outcome status of a HydraFusion phase. -[Experimental(Diagnostics.Experimental)] +/// Transport mechanism: stdio, http, sse (deprecated), or memory (in-process MCP server). [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct FusionPhaseStatus : IEquatable +public readonly struct McpServerTransport : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public FusionPhaseStatus(string value) + public McpServerTransport(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The phase completed successfully. - public static FusionPhaseStatus Succeeded { get; } = new("succeeded"); + /// Server communicates over stdio with a local child process. + public static McpServerTransport Stdio { get; } = new("stdio"); - /// The phase failed. - public static FusionPhaseStatus Failed { get; } = new("failed"); + /// Server communicates over streamable HTTP. + public static McpServerTransport Http { get; } = new("http"); - /// The phase was cancelled. - public static FusionPhaseStatus Cancelled { get; } = new("cancelled"); + /// Server communicates over Server-Sent Events (deprecated). + public static McpServerTransport Sse { get; } = new("sse"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(FusionPhaseStatus left, FusionPhaseStatus right) => left.Equals(right); + /// Server is backed by an in-memory runtime implementation. + public static McpServerTransport Memory { get; } = new("memory"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(FusionPhaseStatus left, FusionPhaseStatus right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(McpServerTransport left, McpServerTransport right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(McpServerTransport left, McpServerTransport right) => !(left == right); /// - public override bool Equals(object? obj) => obj is FusionPhaseStatus other && Equals(other); + public override bool Equals(object? obj) => obj is McpServerTransport other && Equals(other); /// - public bool Equals(FusionPhaseStatus other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(McpServerTransport other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13695,60 +16125,60 @@ public FusionPhaseStatus(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override FusionPhaseStatus Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override McpServerTransport Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, FusionPhaseStatus value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, McpServerTransport value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(FusionPhaseStatus)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(McpServerTransport)); } } } -/// Tool call type: "function" for standard tool calls, "custom" for grammar-based tool calls. Defaults to "function" when absent. +/// Allowed values for the `ToolExecutionStartToolDescriptionMetaUIVisibility` enumeration. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct AssistantMessageToolRequestType : IEquatable +public readonly struct ToolExecutionStartToolDescriptionMetaUIVisibility : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public AssistantMessageToolRequestType(string value) + public ToolExecutionStartToolDescriptionMetaUIVisibility(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Standard function-style tool call. - public static AssistantMessageToolRequestType Function { get; } = new("function"); + /// Tool is callable by the model (LLM tool surface). + public static ToolExecutionStartToolDescriptionMetaUIVisibility Model { get; } = new("model"); - /// Custom grammar-based tool call. - public static AssistantMessageToolRequestType Custom { get; } = new("custom"); + /// Tool is callable by the MCP App view (iframe) via session.mcp.apps.callTool. + public static ToolExecutionStartToolDescriptionMetaUIVisibility App { get; } = new("app"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(AssistantMessageToolRequestType left, AssistantMessageToolRequestType right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(ToolExecutionStartToolDescriptionMetaUIVisibility left, ToolExecutionStartToolDescriptionMetaUIVisibility right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(AssistantMessageToolRequestType left, AssistantMessageToolRequestType right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(ToolExecutionStartToolDescriptionMetaUIVisibility left, ToolExecutionStartToolDescriptionMetaUIVisibility right) => !(left == right); /// - public override bool Equals(object? obj) => obj is AssistantMessageToolRequestType other && Equals(other); + public override bool Equals(object? obj) => obj is ToolExecutionStartToolDescriptionMetaUIVisibility other && Equals(other); /// - public bool Equals(AssistantMessageToolRequestType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(ToolExecutionStartToolDescriptionMetaUIVisibility other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13756,64 +16186,60 @@ public AssistantMessageToolRequestType(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override AssistantMessageToolRequestType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override ToolExecutionStartToolDescriptionMetaUIVisibility Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, AssistantMessageToolRequestType value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, ToolExecutionStartToolDescriptionMetaUIVisibility value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AssistantMessageToolRequestType)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ToolExecutionStartToolDescriptionMetaUIVisibility)); } } } -/// The system that produced a citation. -[Experimental(Diagnostics.Experimental)] +/// Binary result type discriminator. Use "image" for images and "resource" for other binary data. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct CitationProvider : IEquatable +public readonly struct PersistedBinaryImageType : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public CitationProvider(string value) + public PersistedBinaryImageType(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Citation produced by an Anthropic (Claude) model response. - public static CitationProvider Anthropic { get; } = new("anthropic"); - - /// Citation produced by an OpenAI model response. - public static CitationProvider Openai { get; } = new("openai"); + /// Binary image data. + public static PersistedBinaryImageType Image { get; } = new("image"); - /// Citation synthesized client-side by the runtime from tool output. - public static CitationProvider Client { get; } = new("client"); + /// Other binary resource data. + public static PersistedBinaryImageType Resource { get; } = new("resource"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(CitationProvider left, CitationProvider right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PersistedBinaryImageType left, PersistedBinaryImageType right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(CitationProvider left, CitationProvider right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PersistedBinaryImageType left, PersistedBinaryImageType right) => !(left == right); /// - public override bool Equals(object? obj) => obj is CitationProvider other && Equals(other); + public override bool Equals(object? obj) => obj is PersistedBinaryImageType other && Equals(other); /// - public bool Equals(CitationProvider other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(PersistedBinaryImageType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13821,57 +16247,60 @@ public CitationProvider(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override CitationProvider Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override PersistedBinaryImageType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, CitationProvider value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, PersistedBinaryImageType value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(CitationProvider)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PersistedBinaryImageType)); } } } -/// Hosted program caller type. +/// Binary result type discriminator. Use "image" for images and "resource" for other binary data. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct AssistantMessageToolRequestCallerType : IEquatable +public readonly struct OmittedBinaryType : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public AssistantMessageToolRequestCallerType(string value) + public OmittedBinaryType(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Gets the program value. - public static AssistantMessageToolRequestCallerType Program { get; } = new("program"); + /// Binary image data. + public static OmittedBinaryType Image { get; } = new("image"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(AssistantMessageToolRequestCallerType left, AssistantMessageToolRequestCallerType right) => left.Equals(right); + /// Other binary resource data. + public static OmittedBinaryType Resource { get; } = new("resource"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(AssistantMessageToolRequestCallerType left, AssistantMessageToolRequestCallerType right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(OmittedBinaryType left, OmittedBinaryType right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(OmittedBinaryType left, OmittedBinaryType right) => !(left == right); /// - public override bool Equals(object? obj) => obj is AssistantMessageToolRequestCallerType other && Equals(other); + public override bool Equals(object? obj) => obj is OmittedBinaryType other && Equals(other); /// - public bool Equals(AssistantMessageToolRequestCallerType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(OmittedBinaryType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13879,66 +16308,60 @@ public AssistantMessageToolRequestCallerType(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override AssistantMessageToolRequestCallerType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override OmittedBinaryType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, AssistantMessageToolRequestCallerType value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, OmittedBinaryType value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AssistantMessageToolRequestCallerType)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(OmittedBinaryType)); } } } -/// API endpoint used for this model call, matching CAPI supported_endpoints vocabulary. +/// Binary result type discriminator. Use "image" for images and "resource" for other binary data. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct AssistantUsageApiEndpoint : IEquatable +public readonly struct BinaryAssetReferenceType : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public AssistantUsageApiEndpoint(string value) + public BinaryAssetReferenceType(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Chat Completions API endpoint. - public static AssistantUsageApiEndpoint ChatCompletions { get; } = new("/chat/completions"); - - /// Anthropic Messages API endpoint. - public static AssistantUsageApiEndpoint V1Messages { get; } = new("/v1/messages"); - - /// Responses API endpoint. - public static AssistantUsageApiEndpoint Responses { get; } = new("/responses"); + /// Binary image data. + public static BinaryAssetReferenceType Image { get; } = new("image"); - /// WebSocket Responses API endpoint. - public static AssistantUsageApiEndpoint WsResponses { get; } = new("ws:/responses"); + /// Other binary resource data. + public static BinaryAssetReferenceType Resource { get; } = new("resource"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(AssistantUsageApiEndpoint left, AssistantUsageApiEndpoint right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(BinaryAssetReferenceType left, BinaryAssetReferenceType right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(AssistantUsageApiEndpoint left, AssistantUsageApiEndpoint right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(BinaryAssetReferenceType left, BinaryAssetReferenceType right) => !(left == right); /// - public override bool Equals(object? obj) => obj is AssistantUsageApiEndpoint other && Equals(other); + public override bool Equals(object? obj) => obj is BinaryAssetReferenceType other && Equals(other); /// - public bool Equals(AssistantUsageApiEndpoint other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(BinaryAssetReferenceType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -13946,60 +16369,60 @@ public AssistantUsageApiEndpoint(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override AssistantUsageApiEndpoint Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override BinaryAssetReferenceType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, AssistantUsageApiEndpoint value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, BinaryAssetReferenceType value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AssistantUsageApiEndpoint)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(BinaryAssetReferenceType)); } } } -/// Transport used for a successful model call. +/// Theme variant this icon is intended for. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct AssistantUsageTransport : IEquatable +public readonly struct ToolExecutionCompleteContentResourceLinkIconTheme : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public AssistantUsageTransport(string value) + public ToolExecutionCompleteContentResourceLinkIconTheme(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// HTTP transport, including SSE streams. - public static AssistantUsageTransport Http { get; } = new("http"); + /// Icon intended for light themes. + public static ToolExecutionCompleteContentResourceLinkIconTheme Light { get; } = new("light"); - /// WebSocket transport. - public static AssistantUsageTransport Websocket { get; } = new("websocket"); + /// Icon intended for dark themes. + public static ToolExecutionCompleteContentResourceLinkIconTheme Dark { get; } = new("dark"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(AssistantUsageTransport left, AssistantUsageTransport right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(ToolExecutionCompleteContentResourceLinkIconTheme left, ToolExecutionCompleteContentResourceLinkIconTheme right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(AssistantUsageTransport left, AssistantUsageTransport right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(ToolExecutionCompleteContentResourceLinkIconTheme left, ToolExecutionCompleteContentResourceLinkIconTheme right) => !(left == right); /// - public override bool Equals(object? obj) => obj is AssistantUsageTransport other && Equals(other); + public override bool Equals(object? obj) => obj is ToolExecutionCompleteContentResourceLinkIconTheme other && Equals(other); /// - public bool Equals(AssistantUsageTransport other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(ToolExecutionCompleteContentResourceLinkIconTheme other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14007,60 +16430,60 @@ public AssistantUsageTransport(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override AssistantUsageTransport Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override ToolExecutionCompleteContentResourceLinkIconTheme Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, AssistantUsageTransport value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, ToolExecutionCompleteContentResourceLinkIconTheme value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AssistantUsageTransport)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ToolExecutionCompleteContentResourceLinkIconTheme)); } } } -/// For HTTP 400 failures only: whether the response carried a structured CAPI error envelope (structured_error, a deterministic validation failure) or no error body (bodyless, the transient gateway/proxy signature). Absent for non-400 failures. +/// Allowed values for the `ToolExecutionCompleteToolDescriptionMetaUIVisibility` enumeration. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ModelCallFailureBadRequestKind : IEquatable +public readonly struct ToolExecutionCompleteToolDescriptionMetaUIVisibility : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ModelCallFailureBadRequestKind(string value) + public ToolExecutionCompleteToolDescriptionMetaUIVisibility(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The 400 response carried no error body (transient gateway/proxy signature). - public static ModelCallFailureBadRequestKind Bodyless { get; } = new("bodyless"); + /// Tool is callable by the model (LLM tool surface). + public static ToolExecutionCompleteToolDescriptionMetaUIVisibility Model { get; } = new("model"); - /// The 400 response carried a structured CAPI error envelope (deterministic validation failure). - public static ModelCallFailureBadRequestKind StructuredError { get; } = new("structured_error"); + /// Tool is callable by the MCP App view (iframe) via session.mcp.apps.callTool. + public static ToolExecutionCompleteToolDescriptionMetaUIVisibility App { get; } = new("app"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(ModelCallFailureBadRequestKind left, ModelCallFailureBadRequestKind right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(ToolExecutionCompleteToolDescriptionMetaUIVisibility left, ToolExecutionCompleteToolDescriptionMetaUIVisibility right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(ModelCallFailureBadRequestKind left, ModelCallFailureBadRequestKind right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(ToolExecutionCompleteToolDescriptionMetaUIVisibility left, ToolExecutionCompleteToolDescriptionMetaUIVisibility right) => !(left == right); /// - public override bool Equals(object? obj) => obj is ModelCallFailureBadRequestKind other && Equals(other); + public override bool Equals(object? obj) => obj is ToolExecutionCompleteToolDescriptionMetaUIVisibility other && Equals(other); /// - public bool Equals(ModelCallFailureBadRequestKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(ToolExecutionCompleteToolDescriptionMetaUIVisibility other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14068,60 +16491,63 @@ public ModelCallFailureBadRequestKind(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override ModelCallFailureBadRequestKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override ToolExecutionCompleteToolDescriptionMetaUIVisibility Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, ModelCallFailureBadRequestKind value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, ToolExecutionCompleteToolDescriptionMetaUIVisibility value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFailureBadRequestKind)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ToolExecutionCompleteToolDescriptionMetaUIVisibility)); } } } -/// Boundary that produced a model call failure. +/// What triggered the skill invocation: `user-invoked` (explicit user action, such as via a slash command or UI affordance), `agent-invoked` (agent requested the skill), or `context-load` (loaded as part of another context, such as preloading skills configured on a custom agent or subagent). [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ModelCallFailureKind : IEquatable +public readonly struct SkillInvokedTrigger : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ModelCallFailureKind(string value) + public SkillInvokedTrigger(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The provider returned an API error response. - public static ModelCallFailureKind Api { get; } = new("api"); + /// Skill invocation requested explicitly by the user, such as via a slash command or UI affordance. + public static SkillInvokedTrigger UserInvoked { get; } = new("user-invoked"); - /// The request transport failed before a usable API response completed. - public static ModelCallFailureKind Transport { get; } = new("transport"); + /// Skill invocation requested by the agent. + public static SkillInvokedTrigger AgentInvoked { get; } = new("agent-invoked"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(ModelCallFailureKind left, ModelCallFailureKind right) => left.Equals(right); + /// Skill content loaded as part of another context, such as a configured custom agent or subagent. + public static SkillInvokedTrigger ContextLoad { get; } = new("context-load"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(ModelCallFailureKind left, ModelCallFailureKind right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SkillInvokedTrigger left, SkillInvokedTrigger right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SkillInvokedTrigger left, SkillInvokedTrigger right) => !(left == right); /// - public override bool Equals(object? obj) => obj is ModelCallFailureKind other && Equals(other); + public override bool Equals(object? obj) => obj is SkillInvokedTrigger other && Equals(other); /// - public bool Equals(ModelCallFailureKind other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SkillInvokedTrigger other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14129,63 +16555,66 @@ public ModelCallFailureKind(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override ModelCallFailureKind Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SkillInvokedTrigger Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, ModelCallFailureKind value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SkillInvokedTrigger value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFailureKind)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SkillInvokedTrigger)); } } } -/// Where the failed model call originated. +/// Process-containment backend selected for the host platform. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ModelCallFailureSource : IEquatable +public readonly struct SandboxBackend : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ModelCallFailureSource(string value) + public SandboxBackend(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Model call from the top-level agent. - public static ModelCallFailureSource TopLevel { get; } = new("top_level"); + /// Apple Seatbelt process sandbox. + public static SandboxBackend Seatbelt { get; } = new("seatbelt"); - /// Model call from a sub-agent. - public static ModelCallFailureSource Subagent { get; } = new("subagent"); + /// Linux Bubblewrap process sandbox. + public static SandboxBackend Bubblewrap { get; } = new("bubblewrap"); - /// Model call from MCP sampling. - public static ModelCallFailureSource McpSampling { get; } = new("mcp_sampling"); + /// Windows ProcessContainer sandbox. + public static SandboxBackend ProcessContainer { get; } = new("process_container"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(ModelCallFailureSource left, ModelCallFailureSource right) => left.Equals(right); + /// No supported process-containment backend is available. + public static SandboxBackend Unsupported { get; } = new("unsupported"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(ModelCallFailureSource left, ModelCallFailureSource right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxBackend left, SandboxBackend right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxBackend left, SandboxBackend right) => !(left == right); /// - public override bool Equals(object? obj) => obj is ModelCallFailureSource other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxBackend other && Equals(other); /// - public bool Equals(ModelCallFailureSource other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxBackend other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14193,66 +16622,75 @@ public ModelCallFailureSource(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override ModelCallFailureSource Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxBackend Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, ModelCallFailureSource value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxBackend value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFailureSource)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxBackend)); } } } -/// Final outcome of one logical model dispatch after response acceptance processing. +/// Customer-controllable sandbox governance area. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ModelCallFinishedOutcome : IEquatable +public readonly struct SandboxControl : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ModelCallFinishedOutcome(string value) + public SandboxControl(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The provider response was accepted for continued agent processing. - public static ModelCallFinishedOutcome Success { get; } = new("success"); + /// Process containment and sandbox spawn behavior. + public static SandboxControl Process { get; } = new("process"); - /// The dispatch ended with a provider or transport error. - public static ModelCallFinishedOutcome Error { get; } = new("error"); + /// Filesystem read, write, and deny policy. + public static SandboxControl Filesystem { get; } = new("filesystem"); - /// The dispatch was cancelled before an accepted response was produced. - public static ModelCallFinishedOutcome Cancelled { get; } = new("cancelled"); + /// Outbound and local-network access policy. + public static SandboxControl Network { get; } = new("network"); - /// The provider response was rejected during post-response acceptance processing. - public static ModelCallFinishedOutcome Rejected { get; } = new("rejected"); + /// Selection of the sandbox or built-in enforcement route. + public static SandboxControl Routing { get; } = new("routing"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(ModelCallFinishedOutcome left, ModelCallFinishedOutcome right) => left.Equals(right); + /// Decisions to run outside the process sandbox, whether requested by the model or resolved by a person. + public static SandboxControl Bypass { get; } = new("bypass"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(ModelCallFinishedOutcome left, ModelCallFinishedOutcome right) => !(left == right); + /// Credential and keychain capability injection. + public static SandboxControl Credentials { get; } = new("credentials"); + + /// Host-platform and backend support behavior. + public static SandboxControl Platform { get; } = new("platform"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxControl left, SandboxControl right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxControl left, SandboxControl right) => !(left == right); /// - public override bool Equals(object? obj) => obj is ModelCallFinishedOutcome other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxControl other && Equals(other); /// - public bool Equals(ModelCallFinishedOutcome other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxControl other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14260,66 +16698,60 @@ public ModelCallFinishedOutcome(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override ModelCallFinishedOutcome Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxControl Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, ModelCallFinishedOutcome value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxControl value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ModelCallFinishedOutcome)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxControl)); } } } -/// Finite reason code describing why the current turn was aborted. +/// Finite reason why sandbox enforcement is weaker than configured. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct AbortReason : IEquatable +public readonly struct SandboxDegradationReason : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public AbortReason(string value) + public SandboxDegradationReason(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// The local user requested the abort, for example by pressing Ctrl+C in the CLI. - public static AbortReason UserInitiated { get; } = new("user_initiated"); - - /// A remote command requested the abort. - public static AbortReason RemoteCommand { get; } = new("remote_command"); - - /// An MCP server delivered a user.abort notification. - public static AbortReason UserAbort { get; } = new("user_abort"); + /// The selected backend cannot enforce per-path deny rules. + public static SandboxDegradationReason DeniedPathsUnsupported { get; } = new("denied_paths_unsupported"); - /// Autopilot stopped the run because the active objective reached its user-set --max-ai-credits limit. - public static AbortReason AutopilotCreditLimit { get; } = new("autopilot_credit_limit"); + /// The host platform has no supported process-containment backend. + public static SandboxDegradationReason UnsupportedPlatform { get; } = new("unsupported_platform"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(AbortReason left, AbortReason right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxDegradationReason left, SandboxDegradationReason right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(AbortReason left, AbortReason right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxDegradationReason left, SandboxDegradationReason right) => !(left == right); /// - public override bool Equals(object? obj) => obj is AbortReason other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxDegradationReason other && Equals(other); /// - public bool Equals(AbortReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxDegradationReason other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14327,69 +16759,72 @@ public AbortReason(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override AbortReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxDegradationReason Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, AbortReason value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxDegradationReason value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(AbortReason)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxDegradationReason)); } } } -/// Configuration source: user, workspace, plugin, builtin, or managed. +/// Runtime boundary that enforced or routed a sandbox decision. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct McpServerSource : IEquatable +public readonly struct SandboxEnforcementPoint : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public McpServerSource(string value) + public SandboxEnforcementPoint(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Server configured in the user's global MCP configuration. - public static McpServerSource User { get; } = new("user"); + /// Shell command process containment. + public static SandboxEnforcementPoint Shell { get; } = new("shell"); - /// Server configured by the current workspace. - public static McpServerSource Workspace { get; } = new("workspace"); + /// Built-in filesystem policy enforcement. + public static SandboxEnforcementPoint BuiltinFilesystem { get; } = new("builtin_filesystem"); - /// Server contributed by an installed plugin. - public static McpServerSource Plugin { get; } = new("plugin"); + /// Search-tool sandbox or policy enforcement. + public static SandboxEnforcementPoint Search { get; } = new("search"); - /// Server bundled with the runtime. - public static McpServerSource Builtin { get; } = new("builtin"); + /// Web-fetch network policy enforcement. + public static SandboxEnforcementPoint WebFetch { get; } = new("web_fetch"); - /// Server supplied by a trusted host-managed catalog. - public static McpServerSource Managed { get; } = new("managed"); + /// Model Context Protocol server routing. + public static SandboxEnforcementPoint Mcp { get; } = new("mcp"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(McpServerSource left, McpServerSource right) => left.Equals(right); + /// Language server process routing. + public static SandboxEnforcementPoint Lsp { get; } = new("lsp"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(McpServerSource left, McpServerSource right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxEnforcementPoint left, SandboxEnforcementPoint right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxEnforcementPoint left, SandboxEnforcementPoint right) => !(left == right); /// - public override bool Equals(object? obj) => obj is McpServerSource other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxEnforcementPoint other && Equals(other); /// - public bool Equals(McpServerSource other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxEnforcementPoint other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14397,66 +16832,81 @@ public McpServerSource(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override McpServerSource Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxEnforcementPoint Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, McpServerSource value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxEnforcementPoint value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(McpServerSource)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxEnforcementPoint)); } } } -/// Transport mechanism: stdio, http, sse (deprecated), or memory (in-process MCP server). +/// Finite result of a sandbox decision. Each `SandboxDecisionData` variant uses a disjoint subset: `policy_resolved` is `resolved | degraded`, `spawn_completed` and `permissive_retry_completed` are `succeeded | failed`, `enforcement_state` is `engaged | inactive | failed`, `access_denied` is `denied`, and escalation decisions are `approved | declined`. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct McpServerTransport : IEquatable +public readonly struct SandboxOutcome : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public McpServerTransport(string value) + public SandboxOutcome(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Server communicates over stdio with a local child process. - public static McpServerTransport Stdio { get; } = new("stdio"); + /// The sandbox policy resolved successfully. Describes configuration only and makes no claim that a backend engaged. + public static SandboxOutcome Resolved { get; } = new("resolved"); - /// Server communicates over streamable HTTP. - public static McpServerTransport Http { get; } = new("http"); + /// No sandbox governed the workload. + public static SandboxOutcome Inactive { get; } = new("inactive"); - /// Server communicates over Server-Sent Events (deprecated). - public static McpServerTransport Sse { get; } = new("sse"); + /// A runtime-owned containment backend accepted the workload. Evidence of engagement, not of verified containment for the workload's lifetime. + public static SandboxOutcome Engaged { get; } = new("engaged"); - /// Server is backed by an in-memory runtime implementation. - public static McpServerTransport Memory { get; } = new("memory"); + /// The sandbox operation completed successfully. + public static SandboxOutcome Succeeded { get; } = new("succeeded"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(McpServerTransport left, McpServerTransport right) => left.Equals(right); + /// The sandbox operation failed. + public static SandboxOutcome Failed { get; } = new("failed"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(McpServerTransport left, McpServerTransport right) => !(left == right); + /// The sandbox is active with one or more controls weakened by platform limitations or an explicitly selected relaxed mode. + public static SandboxOutcome Degraded { get; } = new("degraded"); + + /// An enforcement check refused the requested access. + public static SandboxOutcome Denied { get; } = new("denied"); + + /// A request to run outside the process sandbox was granted. + public static SandboxOutcome Approved { get; } = new("approved"); + + /// A request to run outside the process sandbox was not granted. + public static SandboxOutcome Declined { get; } = new("declined"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxOutcome left, SandboxOutcome right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxOutcome left, SandboxOutcome right) => !(left == right); /// - public override bool Equals(object? obj) => obj is McpServerTransport other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxOutcome other && Equals(other); /// - public bool Equals(McpServerTransport other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxOutcome other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14464,60 +16914,66 @@ public McpServerTransport(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override McpServerTransport Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxOutcome Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, McpServerTransport value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxOutcome value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(McpServerTransport)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxOutcome)); } } } -/// Allowed values for the `ToolExecutionStartToolDescriptionMetaUIVisibility` enumeration. +/// Host operating-system family used for sandbox enforcement. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ToolExecutionStartToolDescriptionMetaUIVisibility : IEquatable +public readonly struct SandboxPlatform : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ToolExecutionStartToolDescriptionMetaUIVisibility(string value) + public SandboxPlatform(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Tool is callable by the model (LLM tool surface). - public static ToolExecutionStartToolDescriptionMetaUIVisibility Model { get; } = new("model"); + /// Apple macOS host. + public static SandboxPlatform Macos { get; } = new("macos"); - /// Tool is callable by the MCP App view (iframe) via session.mcp.apps.callTool. - public static ToolExecutionStartToolDescriptionMetaUIVisibility App { get; } = new("app"); + /// Linux host. + public static SandboxPlatform Linux { get; } = new("linux"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(ToolExecutionStartToolDescriptionMetaUIVisibility left, ToolExecutionStartToolDescriptionMetaUIVisibility right) => left.Equals(right); + /// Microsoft Windows host. + public static SandboxPlatform Windows { get; } = new("windows"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(ToolExecutionStartToolDescriptionMetaUIVisibility left, ToolExecutionStartToolDescriptionMetaUIVisibility right) => !(left == right); + /// Host platform outside the explicitly supported families. + public static SandboxPlatform Other { get; } = new("other"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxPlatform left, SandboxPlatform right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxPlatform left, SandboxPlatform right) => !(left == right); /// - public override bool Equals(object? obj) => obj is ToolExecutionStartToolDescriptionMetaUIVisibility other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxPlatform other && Equals(other); /// - public bool Equals(ToolExecutionStartToolDescriptionMetaUIVisibility other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxPlatform other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14525,60 +16981,60 @@ public ToolExecutionStartToolDescriptionMetaUIVisibility(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override ToolExecutionStartToolDescriptionMetaUIVisibility Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxPlatform Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, ToolExecutionStartToolDescriptionMetaUIVisibility value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxPlatform value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ToolExecutionStartToolDescriptionMetaUIVisibility)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxPlatform)); } } } -/// Binary result type discriminator. Use "image" for images and "resource" for other binary data. +/// Origin of the effective sandbox policy. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct PersistedBinaryImageType : IEquatable +public readonly struct SandboxPolicySource : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public PersistedBinaryImageType(string value) + public SandboxPolicySource(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Binary image data. - public static PersistedBinaryImageType Image { get; } = new("image"); + /// Runtime default sandbox policy. + public static SandboxPolicySource DefaultPolicy { get; } = new("default_policy"); - /// Other binary resource data. - public static PersistedBinaryImageType Resource { get; } = new("resource"); + /// User-configured sandbox policy merged with runtime-required grants. + public static SandboxPolicySource UserPolicy { get; } = new("user_policy"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(PersistedBinaryImageType left, PersistedBinaryImageType right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxPolicySource left, SandboxPolicySource right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(PersistedBinaryImageType left, PersistedBinaryImageType right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxPolicySource left, SandboxPolicySource right) => !(left == right); /// - public override bool Equals(object? obj) => obj is PersistedBinaryImageType other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxPolicySource other && Equals(other); /// - public bool Equals(PersistedBinaryImageType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxPolicySource other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14586,60 +17042,63 @@ public PersistedBinaryImageType(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override PersistedBinaryImageType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxPolicySource Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, PersistedBinaryImageType value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxPolicySource value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PersistedBinaryImageType)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxPolicySource)); } } } -/// Binary result type discriminator. Use "image" for images and "resource" for other binary data. +/// Bounded classification of effective sandbox proxy routing. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct OmittedBinaryType : IEquatable +public readonly struct SandboxProxyMode : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public OmittedBinaryType(string value) + public SandboxProxyMode(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Binary image data. - public static OmittedBinaryType Image { get; } = new("image"); + /// No sandbox proxy is configured. + public static SandboxProxyMode None { get; } = new("none"); - /// Other binary resource data. - public static OmittedBinaryType Resource { get; } = new("resource"); + /// Traffic routes through a loopback proxy. + public static SandboxProxyMode Loopback { get; } = new("loopback"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(OmittedBinaryType left, OmittedBinaryType right) => left.Equals(right); + /// Traffic routes through a non-loopback proxy endpoint. + public static SandboxProxyMode External { get; } = new("external"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(OmittedBinaryType left, OmittedBinaryType right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxProxyMode left, SandboxProxyMode right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxProxyMode left, SandboxProxyMode right) => !(left == right); /// - public override bool Equals(object? obj) => obj is OmittedBinaryType other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxProxyMode other && Equals(other); /// - public bool Equals(OmittedBinaryType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxProxyMode other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14647,60 +17106,63 @@ public OmittedBinaryType(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override OmittedBinaryType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxProxyMode Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, OmittedBinaryType value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxProxyMode value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(OmittedBinaryType)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxProxyMode)); } } } -/// Binary result type discriminator. Use "image" for images and "resource" for other binary data. +/// Runtime observation backing an enforcement-state or denial claim. Absent on `enforcement_state` when no observation backs the state. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct BinaryAssetReferenceType : IEquatable +public readonly struct SandboxAttestation : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public BinaryAssetReferenceType(string value) + public SandboxAttestation(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Binary image data. - public static BinaryAssetReferenceType Image { get; } = new("image"); + /// A containment backend accepted and applied the spawn request. + public static SandboxAttestation SpawnSucceeded { get; } = new("spawn_succeeded"); - /// Other binary resource data. - public static BinaryAssetReferenceType Resource { get; } = new("resource"); + /// The spawn was refused for lack of a usable containment backend. + public static SandboxAttestation Unsupported { get; } = new("unsupported"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(BinaryAssetReferenceType left, BinaryAssetReferenceType right) => left.Equals(right); + /// A runtime-owned policy check ran and returned a verdict. Attests the check, not that the caller honoured it. + public static SandboxAttestation BuiltinPolicyChecked { get; } = new("builtin_policy_checked"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(BinaryAssetReferenceType left, BinaryAssetReferenceType right) => !(left == right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxAttestation left, SandboxAttestation right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxAttestation left, SandboxAttestation right) => !(left == right); /// - public override bool Equals(object? obj) => obj is BinaryAssetReferenceType other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxAttestation other && Equals(other); /// - public bool Equals(BinaryAssetReferenceType other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxAttestation other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14708,60 +17170,66 @@ public BinaryAssetReferenceType(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override BinaryAssetReferenceType Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxAttestation Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, BinaryAssetReferenceType value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxAttestation value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(BinaryAssetReferenceType)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxAttestation)); } } } -/// Theme variant this icon is intended for. +/// How strong the evidence behind a denial is. A denial the sandbox itself recorded is a fact; one inferred from a command's output text is a judgement, and an analysis that cannot tell them apart will treat a false positive as enforcement. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ToolExecutionCompleteContentResourceLinkIconTheme : IEquatable +public readonly struct SandboxDenialConfidence : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ToolExecutionCompleteContentResourceLinkIconTheme(string value) + public SandboxDenialConfidence(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Icon intended for light themes. - public static ToolExecutionCompleteContentResourceLinkIconTheme Light { get; } = new("light"); + /// The sandbox's own denial capture recorded the refused access. The strongest evidence available: the kernel observed it, not the runtime. + public static SandboxDenialConfidence Captured { get; } = new("captured"); - /// Icon intended for dark themes. - public static ToolExecutionCompleteContentResourceLinkIconTheme Dark { get; } = new("dark"); + /// The command named a path that the effective policy independently denies. No capture confirmed it, but the policy did. + public static SandboxDenialConfidence PolicyCorroborated { get; } = new("policy_corroborated"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(ToolExecutionCompleteContentResourceLinkIconTheme left, ToolExecutionCompleteContentResourceLinkIconTheme right) => left.Equals(right); + /// The failure carried a fingerprint the sandbox itself emits, so the sandbox is known to have refused something even though the resource was not confirmed. + public static SandboxDenialConfidence SandboxReported { get; } = new("sandbox_reported"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(ToolExecutionCompleteContentResourceLinkIconTheme left, ToolExecutionCompleteContentResourceLinkIconTheme right) => !(left == right); + /// Classified from the command's own output text alone. The weakest evidence: a command that merely prints sandbox-like wording reaches this level. + public static SandboxDenialConfidence OutputClassified { get; } = new("output_classified"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxDenialConfidence left, SandboxDenialConfidence right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxDenialConfidence left, SandboxDenialConfidence right) => !(left == right); /// - public override bool Equals(object? obj) => obj is ToolExecutionCompleteContentResourceLinkIconTheme other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxDenialConfidence other && Equals(other); /// - public bool Equals(ToolExecutionCompleteContentResourceLinkIconTheme other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxDenialConfidence other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14769,60 +17237,93 @@ public ToolExecutionCompleteContentResourceLinkIconTheme(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override ToolExecutionCompleteContentResourceLinkIconTheme Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxDenialConfidence Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, ToolExecutionCompleteContentResourceLinkIconTheme value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxDenialConfidence value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ToolExecutionCompleteContentResourceLinkIconTheme)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxDenialConfidence)); } } } -/// Allowed values for the `ToolExecutionCompleteToolDescriptionMetaUIVisibility` enumeration. +/// Bounded class of access an enforcement check refused. Raw resources, commands, and process names accompany it only when content capture is enabled; diagnostic text and matched rules are never exported. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct ToolExecutionCompleteToolDescriptionMetaUIVisibility : IEquatable +public readonly struct SandboxDenialClass : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public ToolExecutionCompleteToolDescriptionMetaUIVisibility(string value) + public SandboxDenialClass(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Tool is callable by the model (LLM tool surface). - public static ToolExecutionCompleteToolDescriptionMetaUIVisibility Model { get; } = new("model"); + /// A read was refused because the effective policy does not grant it. + public static SandboxDenialClass FilesystemRead { get; } = new("filesystem_read"); - /// Tool is callable by the MCP App view (iframe) via session.mcp.apps.callTool. - public static ToolExecutionCompleteToolDescriptionMetaUIVisibility App { get; } = new("app"); + /// A write was refused. Distinct from `filesystem_read` because a read-only grant denies writes to a path it otherwise permits. + public static SandboxDenialClass FilesystemWrite { get; } = new("filesystem_write"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(ToolExecutionCompleteToolDescriptionMetaUIVisibility left, ToolExecutionCompleteToolDescriptionMetaUIVisibility right) => left.Equals(right); + /// A process could not start because the sandbox refused a required process-scoped resource. Currently emitted for the Windows MSYS `BaseNamedObjects` fork failure confirmed by learning-mode capture. + public static SandboxDenialClass ProcessStartup { get; } = new("process_startup"); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(ToolExecutionCompleteToolDescriptionMetaUIVisibility left, ToolExecutionCompleteToolDescriptionMetaUIVisibility right) => !(left == right); + /// Windows registry access was refused and correlated with capture evidence. + public static SandboxDenialClass RegistryAccess { get; } = new("registry_access"); + + /// Windows ALPC or RPC access was refused and correlated with capture evidence. + public static SandboxDenialClass IpcAccess { get; } = new("ipc_access"); + + /// Access to another Windows process was refused and correlated with capture evidence. + public static SandboxDenialClass ProcessAccess { get; } = new("process_access"); + + /// Windows job-object access was refused and correlated with capture evidence. + public static SandboxDenialClass JobAccess { get; } = new("job_access"); + + /// Windows UI-handle access was refused and correlated with capture evidence. + public static SandboxDenialClass UiAccess { get; } = new("ui_access"); + + /// Windows service-control-manager access was refused and correlated with capture evidence. + public static SandboxDenialClass ServiceAccess { get; } = new("service_access"); + + /// An outbound connection was refused by `network.allowOutbound`. + public static SandboxDenialClass NetworkOutbound { get; } = new("network_outbound"); + + /// A connection to a local or loopback destination was refused by `network.allowLocalNetwork`. + public static SandboxDenialClass NetworkLocal { get; } = new("network_local"); + + /// A destination was refused by the sandbox host allow/deny rules. + public static SandboxDenialClass NetworkHost { get; } = new("network_host"); + + /// The sandbox's denial capture recorded a refusal its record does not attribute to a more specific control: an unclassified resource (registry, COM, section object) or an AppContainer capability with no network meaning. Deliberately generic — the capture proves the denial happened, and naming a narrower class than the record supports would be a guess. + public static SandboxDenialClass OtherAccess { get; } = new("other_access"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxDenialClass left, SandboxDenialClass right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxDenialClass left, SandboxDenialClass right) => !(left == right); /// - public override bool Equals(object? obj) => obj is ToolExecutionCompleteToolDescriptionMetaUIVisibility other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxDenialClass other && Equals(other); /// - public bool Equals(ToolExecutionCompleteToolDescriptionMetaUIVisibility other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxDenialClass other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14830,63 +17331,63 @@ public ToolExecutionCompleteToolDescriptionMetaUIVisibility(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override ToolExecutionCompleteToolDescriptionMetaUIVisibility Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxDenialClass Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, ToolExecutionCompleteToolDescriptionMetaUIVisibility value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxDenialClass value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(ToolExecutionCompleteToolDescriptionMetaUIVisibility)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxDenialClass)); } } } -/// What triggered the skill invocation: `user-invoked` (explicit user action, such as via a slash command or UI affordance), `agent-invoked` (agent requested the skill), or `context-load` (loaded as part of another context, such as preloading skills configured on a custom agent or subagent). +/// Where a request to run outside the process sandbox originated. Orthogonal to the outcome: the same verdict means a different thing depending on where the request came from. [JsonConverter(typeof(Converter))] [DebuggerDisplay("{Value,nq}")] -public readonly struct SkillInvokedTrigger : IEquatable +public readonly struct SandboxBypassSource : IEquatable { private readonly string? _value; - /// Initializes a new instance of the struct. - /// The value to associate with this . + /// Initializes a new instance of the struct. + /// The value to associate with this . [JsonConstructor] - public SkillInvokedTrigger(string value) + public SandboxBypassSource(string value) { ArgumentException.ThrowIfNullOrWhiteSpace(value); _value = value; } - /// Gets the value associated with this . + /// Gets the value associated with this . public string Value => _value ?? string.Empty; - /// Skill invocation requested explicitly by the user, such as via a slash command or UI affordance. - public static SkillInvokedTrigger UserInvoked { get; } = new("user-invoked"); + /// No longer produced. The model could once ask for a bypass in the tool call itself; no tool exposes that parameter now. Retained so historical events still deserialize. + public static SandboxBypassSource ModelRequested { get; } = new("model_requested"); - /// Skill invocation requested by the agent. - public static SkillInvokedTrigger AgentInvoked { get; } = new("agent-invoked"); + /// The runtime raised the prompt itself — either after a sandboxed attempt looked blocked, or before a run the sandbox cannot enforce at all, such as a detached command — and a person answered it. In the second case nothing had executed when the decision was made. + public static SandboxBypassSource UserPrompted { get; } = new("user_prompted"); - /// Skill content loaded as part of another context, such as a configured custom agent or subagent. - public static SkillInvokedTrigger ContextLoad { get; } = new("context-load"); + /// The runtime raised the prompt itself — after a sandboxed attempt looked blocked, or before a run it cannot enforce — but the permission flow produced no confirmed human answer. This includes unavailable or unreadable prompts, cancellation, and automated rule, hook, or content-exclusion denials. + public static SandboxBypassSource PromptUnavailable { get; } = new("prompt_unavailable"); - /// Returns a value indicating whether two instances are equivalent. - public static bool operator ==(SkillInvokedTrigger left, SkillInvokedTrigger right) => left.Equals(right); + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(SandboxBypassSource left, SandboxBypassSource right) => left.Equals(right); - /// Returns a value indicating whether two instances are not equivalent. - public static bool operator !=(SkillInvokedTrigger left, SkillInvokedTrigger right) => !(left == right); + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(SandboxBypassSource left, SandboxBypassSource right) => !(left == right); /// - public override bool Equals(object? obj) => obj is SkillInvokedTrigger other && Equals(other); + public override bool Equals(object? obj) => obj is SandboxBypassSource other && Equals(other); /// - public bool Equals(SkillInvokedTrigger other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + public bool Equals(SandboxBypassSource other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); /// public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); @@ -14894,20 +17395,20 @@ public SkillInvokedTrigger(string value) /// public override string ToString() => Value; - /// Provides a for serializing instances. + /// Provides a for serializing instances. [EditorBrowsable(EditorBrowsableState.Never)] - public sealed class Converter : JsonConverter + public sealed class Converter : JsonConverter { /// - public override SkillInvokedTrigger Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + public override SandboxBypassSource Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) { return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); } /// - public override void Write(Utf8JsonWriter writer, SkillInvokedTrigger value, JsonSerializerOptions options) + public override void Write(Utf8JsonWriter writer, SandboxBypassSource value, JsonSerializerOptions options) { - GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SkillInvokedTrigger)); + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(SandboxBypassSource)); } } } @@ -15428,6 +17929,282 @@ public override void Write(Utf8JsonWriter writer, PermissionRequestMemoryAction } } +/// Stage that produced this attribution. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct PermissionApprovalEvaluationEvaluationStage : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public PermissionApprovalEvaluationEvaluationStage(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// The attribution stage is unknown. + public static PermissionApprovalEvaluationEvaluationStage Unknown { get; } = new("unknown"); + + /// The request resolved before assisted-approval evaluation. + public static PermissionApprovalEvaluationEvaluationStage NotReached { get; } = new("not_reached"); + + /// A runtime gate skipped the judge. + public static PermissionApprovalEvaluationEvaluationStage PreJudge { get; } = new("pre_judge"); + + /// The judge interface produced the evaluation. + public static PermissionApprovalEvaluationEvaluationStage Judge { get; } = new("judge"); + + /// A cached recommendation or another request's outcome was reused. + public static PermissionApprovalEvaluationEvaluationStage Reuse { get; } = new("reuse"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionApprovalEvaluationEvaluationStage left, PermissionApprovalEvaluationEvaluationStage right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionApprovalEvaluationEvaluationStage left, PermissionApprovalEvaluationEvaluationStage right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is PermissionApprovalEvaluationEvaluationStage other && Equals(other); + + /// + public bool Equals(PermissionApprovalEvaluationEvaluationStage other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override PermissionApprovalEvaluationEvaluationStage Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, PermissionApprovalEvaluationEvaluationStage value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionApprovalEvaluationEvaluationStage)); + } + } +} + +/// Status of the local judge interface, not proof of a model network call. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct PermissionApprovalEvaluationJudgeStatus : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public PermissionApprovalEvaluationJudgeStatus(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// No authoritative attribution is available. + public static PermissionApprovalEvaluationJudgeStatus Unknown { get; } = new("unknown"); + + /// This evaluation did not invoke the judge interface. + public static PermissionApprovalEvaluationJudgeStatus NotCalled { get; } = new("not_called"); + + /// The judge interface returned a usable verdict. + public static PermissionApprovalEvaluationJudgeStatus Completed { get; } = new("completed"); + + /// The judge interface returned an error. + public static PermissionApprovalEvaluationJudgeStatus Failed { get; } = new("failed"); + + /// This evaluation reused a cached recommendation. + public static PermissionApprovalEvaluationJudgeStatus Cached { get; } = new("cached"); + + /// This request inherited another decision without local judge attribution. + public static PermissionApprovalEvaluationJudgeStatus Inherited { get; } = new("inherited"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionApprovalEvaluationJudgeStatus left, PermissionApprovalEvaluationJudgeStatus right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionApprovalEvaluationJudgeStatus left, PermissionApprovalEvaluationJudgeStatus right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is PermissionApprovalEvaluationJudgeStatus other && Equals(other); + + /// + public bool Equals(PermissionApprovalEvaluationJudgeStatus other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override PermissionApprovalEvaluationJudgeStatus Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, PermissionApprovalEvaluationJudgeStatus value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionApprovalEvaluationJudgeStatus)); + } + } +} + +/// Machine-readable runtime gate reason, never a command, path or human rationale. +[JsonConverter(typeof(Converter))] +[DebuggerDisplay("{Value,nq}")] +public readonly struct PermissionApprovalEvaluationReasonCode : IEquatable +{ + private readonly string? _value; + + /// Initializes a new instance of the struct. + /// The value to associate with this . + [JsonConstructor] + public PermissionApprovalEvaluationReasonCode(string value) + { + ArgumentException.ThrowIfNullOrWhiteSpace(value); + _value = value; + } + + /// Gets the value associated with this . + public string Value => _value ?? string.Empty; + + /// Attribution is missing or outside the supported vocabulary. + public static PermissionApprovalEvaluationReasonCode Unknown { get; } = new("unknown"); + + /// The request resolved before assisted-approval evaluation. + public static PermissionApprovalEvaluationReasonCode NotReached { get; } = new("not-reached"); + + /// Assisted approval was inactive for this request. + public static PermissionApprovalEvaluationReasonCode Inactive { get; } = new("inactive"); + + /// The judge was skipped because authorization extraction could not safely establish a complete recent history. + public static PermissionApprovalEvaluationReasonCode AuthorizationHistoryIncomplete { get; } = new("authorization-history-incomplete"); + + /// Managed policy required a human decision. + public static PermissionApprovalEvaluationReasonCode ManagedApprovalRequired { get; } = new("managed-approval-required"); + + /// The request asked to bypass sandbox restrictions. + public static PermissionApprovalEvaluationReasonCode SandboxBypass { get; } = new("sandbox-bypass"); + + /// An action field exceeded the judge input limit. + public static PermissionApprovalEvaluationReasonCode ActionTooLong { get; } = new("action-too-long"); + + /// The script path was not authorized for inspection. + public static PermissionApprovalEvaluationReasonCode PathNotAuthorized { get; } = new("path-not-authorized"); + + /// The script working directory was invalid. + public static PermissionApprovalEvaluationReasonCode InvalidWorkingDirectory { get; } = new("invalid-working-directory"); + + /// The script snapshot could not be read. + public static PermissionApprovalEvaluationReasonCode Unreadable { get; } = new("unreadable"); + + /// The script path was not a regular file. + public static PermissionApprovalEvaluationReasonCode NotRegularFile { get; } = new("not-regular-file"); + + /// The script snapshot exceeded the size limit. + public static PermissionApprovalEvaluationReasonCode TooLarge { get; } = new("too-large"); + + /// The script snapshot was not UTF-8. + public static PermissionApprovalEvaluationReasonCode NonUtf8 { get; } = new("non-utf8"); + + /// The script interpreter could not be inspected. + public static PermissionApprovalEvaluationReasonCode InterpreterUnavailable { get; } = new("interpreter-unavailable"); + + /// The interpreter snapshot exceeded the size limit. + public static PermissionApprovalEvaluationReasonCode InterpreterTooLarge { get; } = new("interpreter-too-large"); + + /// The shell environment could not be reviewed. + public static PermissionApprovalEvaluationReasonCode ShellEnvironmentUnreviewable { get; } = new("shell-environment-unreviewable"); + + /// A script path could not be represented for review. + public static PermissionApprovalEvaluationReasonCode UnrepresentablePath { get; } = new("unrepresentable-path"); + + /// An interpreter wrapped a script that could not be reviewed. + public static PermissionApprovalEvaluationReasonCode InterpreterWrappedScript { get; } = new("interpreter-wrapped-script"); + + /// The script invocation could not be reviewed. + public static PermissionApprovalEvaluationReasonCode UnreviewableScriptInvocation { get; } = new("unreviewable-script-invocation"); + + /// The script argument binding could not be reviewed. + public static PermissionApprovalEvaluationReasonCode ArgumentBindingUnreviewable { get; } = new("argument-binding-unreviewable"); + + /// The script review metadata was malformed. + public static PermissionApprovalEvaluationReasonCode MalformedScriptActionReview { get; } = new("malformed-script-action-review"); + + /// The script snapshot manifest was malformed. + public static PermissionApprovalEvaluationReasonCode MalformedScriptActionManifest { get; } = new("malformed-script-action-manifest"); + + /// Script review was unavailable. + public static PermissionApprovalEvaluationReasonCode Unavailable { get; } = new("unavailable"); + + /// The judge interface returned a usable verdict. + public static PermissionApprovalEvaluationReasonCode JudgeVerdict { get; } = new("judge-verdict"); + + /// The judge interface returned an error. + public static PermissionApprovalEvaluationReasonCode JudgeError { get; } = new("judge-error"); + + /// The request inherited an outcome from another decision. + public static PermissionApprovalEvaluationReasonCode Inherited { get; } = new("inherited"); + + /// Returns a value indicating whether two instances are equivalent. + public static bool operator ==(PermissionApprovalEvaluationReasonCode left, PermissionApprovalEvaluationReasonCode right) => left.Equals(right); + + /// Returns a value indicating whether two instances are not equivalent. + public static bool operator !=(PermissionApprovalEvaluationReasonCode left, PermissionApprovalEvaluationReasonCode right) => !(left == right); + + /// + public override bool Equals(object? obj) => obj is PermissionApprovalEvaluationReasonCode other && Equals(other); + + /// + public bool Equals(PermissionApprovalEvaluationReasonCode other) => string.Equals(Value, other.Value, StringComparison.OrdinalIgnoreCase); + + /// + public override int GetHashCode() => StringComparer.OrdinalIgnoreCase.GetHashCode(Value); + + /// + public override string ToString() => Value; + + /// Provides a for serializing instances. + [EditorBrowsable(EditorBrowsableState.Never)] + public sealed class Converter : JsonConverter + { + /// + public override PermissionApprovalEvaluationReasonCode Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options) + { + return new(GeneratedStringEnumJson.ReadValue(ref reader, typeToConvert)); + } + + /// + public override void Write(Utf8JsonWriter writer, PermissionApprovalEvaluationReasonCode value, JsonSerializerOptions options) + { + GeneratedStringEnumJson.WriteValue(writer, value.Value, typeof(PermissionApprovalEvaluationReasonCode)); + } + } +} + /// Why the assisted-approval judge produced no usable recommendation. Present only alongside an `error` recommendation, where the human-readable reason is a fixed string and therefore cannot distinguish these cases. Intended to make a judge failure reportable by a consumer that has no access to the host's logs. [Experimental(Diagnostics.Experimental)] [JsonConverter(typeof(Converter))] @@ -17469,6 +20246,7 @@ public override void Write(Utf8JsonWriter writer, ExtensionsLoadedExtensionStatu [JsonSerializable(typeof(OmittedBinaryResult))] [JsonSerializable(typeof(PendingMessagesModifiedData))] [JsonSerializable(typeof(PendingMessagesModifiedEvent))] +[JsonSerializable(typeof(PermissionApprovalEvaluation))] [JsonSerializable(typeof(PermissionAssentDetectedData))] [JsonSerializable(typeof(PermissionAssentDetectedEvent))] [JsonSerializable(typeof(PermissionAssistedApproval))] @@ -17498,6 +20276,8 @@ public override void Write(Utf8JsonWriter writer, ExtensionsLoadedExtensionStatu [JsonSerializable(typeof(PermissionPromptRequestRead))] [JsonSerializable(typeof(PermissionPromptRequestUrl))] [JsonSerializable(typeof(PermissionPromptRequestWrite))] +[JsonSerializable(typeof(PermissionRecoveryAttempt))] +[JsonSerializable(typeof(PermissionRecoveryData))] [JsonSerializable(typeof(PermissionRequest))] [JsonSerializable(typeof(PermissionRequestCustomTool))] [JsonSerializable(typeof(PermissionRequestExtensionEnvAccess))] @@ -17531,12 +20311,21 @@ public override void Write(Utf8JsonWriter writer, ExtensionsLoadedExtensionStatu [JsonSerializable(typeof(PersistedBinaryResult))] [JsonSerializable(typeof(PromptCacheBreakData))] [JsonSerializable(typeof(PromptCacheBreakEvent))] +[JsonSerializable(typeof(ResponsesReasoning))] [JsonSerializable(typeof(SamplingCompletedData))] [JsonSerializable(typeof(SamplingCompletedEvent))] [JsonSerializable(typeof(SamplingRequestedData))] [JsonSerializable(typeof(SamplingRequestedEvent))] [JsonSerializable(typeof(SandboxDecisionData))] +[JsonSerializable(typeof(SandboxDecisionDataAccessDenied))] +[JsonSerializable(typeof(SandboxDecisionDataBypassDecided))] +[JsonSerializable(typeof(SandboxDecisionDataEnforcementState))] +[JsonSerializable(typeof(SandboxDecisionDataPermissiveRetryCompleted))] +[JsonSerializable(typeof(SandboxDecisionDataPermissiveRetryDecided))] +[JsonSerializable(typeof(SandboxDecisionDataPolicyResolved))] +[JsonSerializable(typeof(SandboxDecisionDataSpawnCompleted))] [JsonSerializable(typeof(SandboxDecisionEvent))] +[JsonSerializable(typeof(SandboxFilesystemPolicyDetails))] [JsonSerializable(typeof(SessionAutoModeResolvedData))] [JsonSerializable(typeof(SessionAutoModeResolvedEvent))] [JsonSerializable(typeof(SessionAutoTierRecommendationData))] @@ -17594,6 +20383,12 @@ public override void Write(Utf8JsonWriter writer, ExtensionsLoadedExtensionStatu [JsonSerializable(typeof(SessionHandoffEvent))] [JsonSerializable(typeof(SessionIdleData))] [JsonSerializable(typeof(SessionIdleEvent))] +[JsonSerializable(typeof(SessionIndexedSearchData))] +[JsonSerializable(typeof(SessionIndexedSearchDataIncremental))] +[JsonSerializable(typeof(SessionIndexedSearchDataServerError))] +[JsonSerializable(typeof(SessionIndexedSearchDataStartup))] +[JsonSerializable(typeof(SessionIndexedSearchDataStatus))] +[JsonSerializable(typeof(SessionIndexedSearchEvent))] [JsonSerializable(typeof(SessionInfoData))] [JsonSerializable(typeof(SessionInfoEvent))] [JsonSerializable(typeof(SessionLimitsConfig))] @@ -17620,6 +20415,8 @@ public override void Write(Utf8JsonWriter writer, ExtensionsLoadedExtensionStatu [JsonSerializable(typeof(SessionModeNoticeDeliveredEvent))] [JsonSerializable(typeof(SessionModelChangeData))] [JsonSerializable(typeof(SessionModelChangeEvent))] +[JsonSerializable(typeof(SessionPermissionRecoveryData))] +[JsonSerializable(typeof(SessionPermissionRecoveryEvent))] [JsonSerializable(typeof(SessionPermissionsChangedData))] [JsonSerializable(typeof(SessionPermissionsChangedEvent))] [JsonSerializable(typeof(SessionPlanChangedData))] @@ -17707,6 +20504,7 @@ public override void Write(Utf8JsonWriter writer, ExtensionsLoadedExtensionStatu [JsonSerializable(typeof(SystemNotificationShellCompleted))] [JsonSerializable(typeof(SystemNotificationShellDetachedCompleted))] [JsonSerializable(typeof(SystemNotificationUnclassified))] +[JsonSerializable(typeof(TaskBlocker))] [JsonSerializable(typeof(ToolExecutionCompleteContent))] [JsonSerializable(typeof(ToolExecutionCompleteContentAudio))] [JsonSerializable(typeof(ToolExecutionCompleteContentImage))] diff --git a/dotnet/test/Unit/SessionEventSerializationTests.cs b/dotnet/test/Unit/SessionEventSerializationTests.cs index 6f1b5283e0..c27b237f21 100644 --- a/dotnet/test/Unit/SessionEventSerializationTests.cs +++ b/dotnet/test/Unit/SessionEventSerializationTests.cs @@ -3,12 +3,78 @@ *--------------------------------------------------------------------------------------------*/ using System.Text.Json; +using System.Text.Json.Nodes; using Xunit; namespace GitHub.Copilot.Test.Unit; public class SessionEventSerializationTests { + [Theory] + [InlineData("session.idle", "{}")] + [InlineData("user.message", """{"content":"hello"}""")] + public void ObjectEvent_PreservesCompleteEnvelope(string eventType, string data) + { + var wire = $$""" + { + "id":"11111111-1111-1111-1111-111111111111", + "timestamp":"2026-09-18T22:00:00+00:00", + "parentId":"22222222-2222-2222-2222-222222222222", + "type":"{{eventType}}", + "data":{{data}} + } + """; + var decoded = SessionEvent.FromJson(wire); + Assert.Equal(eventType, decoded.Type); + Assert.True(JsonNode.DeepEquals(JsonNode.Parse(wire), JsonNode.Parse(decoded.ToJson()))); + } + + [Theory] + [InlineData("session.indexed_search", "status", """{"state":"ready"}""")] + [InlineData("session.indexed_search", "startup", """{"outcome":"started","startupDurationMs":1.5,"forcedByEnv":false,"warmStart":false,"fileCount":0,"eligible":false,"errorMessage":"diagnostic"}""")] + [InlineData("session.indexed_search", "server_error", """{"errorType":"unexpected_exit","exitCode":0,"errorMessage":"diagnostic"}""")] + [InlineData("session.indexed_search", "incremental", """{"phase":"updated","changedFileCount":0,"addedFileCount":1,"deletedFileCount":0,"totalChangeCount":1,"walkDurationMs":0.5,"updateDurationMs":1.25,"totalDurationMs":1.75}""")] + [InlineData("sandbox.decision", "policy_resolved", """{"backend":"seatbelt","policySource":"default_policy","readwritePathsCount":0,"readonlyPathsCount":1,"deniedPathsCount":0,"addCurrentWorkingDirectory":false,"allowOutbound":false,"allowLocalNetwork":false,"proxyMode":"none","allowBypass":false,"gitAuth":false,"ghAuth":false,"keychainAccess":false}""")] + [InlineData("sandbox.decision", "spawn_completed", """{"backend":"seatbelt","durationMs":1.5}""")] + [InlineData("sandbox.decision", "enforcement_state", """{"backend":"seatbelt","command":"echo test","attestation":"spawn_succeeded"}""")] + [InlineData("sandbox.decision", "access_denied", """{"denialClass":"filesystem_read","attestation":"builtin_policy_checked","deniedResource":"/example","command":"cat example"}""")] + [InlineData("sandbox.decision", "bypass_decided", """{"source":"user_prompted","deniedResource":"/example"}""")] + [InlineData("sandbox.decision", "permissive_retry_decided", """{"source":"model_requested","command":"echo test"}""")] + [InlineData("sandbox.decision", "permissive_retry_completed", """{"processName":"example","command":"echo test"}""")] + public void UnionEvent_PreservesCompleteEnvelope(string eventType, string kind, string fields) + { + var data = eventType == "sandbox.decision" + ? JsonNode.Parse("""{"control":"process","outcome":"resolved","platform":"macos","enforcementPoint":"shell","toolCallId":"tool-1"}""")!.AsObject() + : new JsonObject(); + data["kind"] = kind; + foreach (var field in JsonNode.Parse(fields)!.AsObject()) + { + data[field.Key] = field.Value?.DeepClone(); + } + var envelope = new JsonObject + { + ["id"] = "11111111-1111-1111-1111-111111111111", + ["timestamp"] = "2026-09-18T22:00:00+00:00", + ["parentId"] = "22222222-2222-2222-2222-222222222222", + ["ephemeral"] = true, + ["agentId"] = "agent-1", + ["type"] = eventType, + ["data"] = data, + }; + + var decoded = SessionEvent.FromJson(envelope.ToJsonString()); + Assert.Equal(eventType, decoded.Type); + if (eventType == "session.indexed_search") + { + Assert.IsType(decoded); + } + else + { + Assert.IsType(decoded); + } + Assert.True(JsonNode.DeepEquals(envelope, JsonNode.Parse(decoded.ToJson()))); + } + public static TheoryData AutoTiers => new() { { AutoTier.Efficiency, "efficiency" }, diff --git a/go/rpc/zrpc.go b/go/rpc/zrpc.go index e974c9ed62..2bc2757f34 100644 --- a/go/rpc/zrpc.go +++ b/go/rpc/zrpc.go @@ -1443,6 +1443,21 @@ type CardDigest struct { // Experimental: CardDigestValue is part of an experimental API and may change or be removed. type CardDigestValue string +// Where and when an Agent Plugin catalog reference was observed. Discovery provenance +// deliberately carries no descriptor URL, raw data, candidate handle, or content digest. +// Experimental: CatalogAgentPluginCandidateProvenance is part of an experimental API and +// may change or be removed. +type CatalogAgentPluginCandidateProvenance struct { + // Host of the catalog authority that advertised the reference, without path, query, or + // credentials. Inert untrusted data. + Authority string `json:"authority"` + // Canonical Agent Plugin media type. + MediaType CatalogAgentPluginMediaType `json:"mediaType"` + // ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a + // retrieval or validation timestamp. + ObservedAt string `json:"observedAt"` +} + // Where and when an AI skill catalog reference was observed. Discovery provenance // deliberately carries no content digest because search does not establish the exact // validated content a later plan will bind. @@ -1453,14 +1468,15 @@ type CatalogAiSkillCandidateProvenance struct { // credentials. Inert untrusted data. Authority string `json:"authority"` // Media type advertised for the referenced AI skill card - MediaType CatalogAiSkillCandidateProvenanceMediaType `json:"mediaType"` + MediaType CatalogAiSkillMediaType `json:"mediaType"` // ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a // retrieval or validation timestamp. ObservedAt string `json:"observedAt"` } -// One inert catalog result, represented as an MCP server or discovery-only AI skill variant -// so kind, media type, provenance, and installability cannot contradict each other. +// One inert catalog result, represented as an MCP server, discovery-only AI skill, or +// opt-in Agent Plugin variant so kind, media type, provenance, and available operations +// cannot contradict each other. // Experimental: CatalogCandidate is part of an experimental API and may change or be // removed. type CatalogCandidate interface { @@ -1478,6 +1494,48 @@ func (r RawCatalogCandidateData) Kind() CatalogCandidateKind { return r.Discriminator } +// An inert Agent Plugin catalog result. Its canonical catalog identity, declared version, +// repository source claim, and explicit compatibility tags are safe to correlate, while its +// descriptor, URL, raw data, and installed-plugin state remain runtime-private. This +// contract-only variant does not mint or expose a candidate handle. +// Experimental: CatalogAgentPluginCandidate is part of an experimental API and may change +// or be removed. +type CatalogAgentPluginCandidate struct { + // Explicit validated compatibility tags, in canonical order. An empty list means the source + // declared no recognised compatibility; clients must not infer compatibility from other + // fields. `canvas-only` requires both `canvas` and `github-copilot`. + CompatibilityTags []CatalogAgentPluginCompatibilityTag `json:"compatibilityTags"` + // Description taken verbatim from the card. Inert untrusted text. + Description *string `json:"description,omitempty"` + // Display name taken verbatim from the card. Inert untrusted text. + DisplayName string `json:"displayName"` + // Validated, normalised catalogue resource URN. This identity comes only from the catalog + // identifier and is never inferred from display text or installed-plugin state. + Identity string `json:"identity"` + // Canonical Agent Plugin media type. + MediaType CatalogAgentPluginMediaType `json:"mediaType"` + // Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw + // data, or content digest. + Provenance CatalogAgentPluginCandidateProvenance `json:"provenance"` + // Publisher taken verbatim from the card. Inert untrusted text. + Publisher *string `json:"publisher,omitempty"` + // Bounded repository provenance declared through the catalog's sourceSet and repoPath + // metadata. It contains no descriptor URL. + Source CatalogPluginRepositorySource `json:"source"` + // Versioned trust metadata observed from the catalog authority. Optional for protocol-3 + // compatibility and emitted only when the caller also requires the trust-snapshot + // capability. + Trust CatalogTrustSnapshot `json:"trust,omitempty"` + // Optional version declared by the catalog source. Omitted rather than guessed when the + // source supplies no version. + Version *string `json:"version,omitempty"` +} + +func (CatalogAgentPluginCandidate) catalogCandidate() {} +func (CatalogAgentPluginCandidate) Kind() CatalogCandidateKind { + return CatalogCandidateKindPlugin +} + // An inert AI skill catalog result. AI skills are discovery-only and cannot be represented // as installable through this surface. // Experimental: CatalogAiSkillCandidate is part of an experimental API and may change or be @@ -1494,9 +1552,9 @@ type CatalogAiSkillCandidate struct { // ISO 8601 timestamp after which the handle is stale and will be rejected. HandleExpiresAt string `json:"handleExpiresAt"` // AI skills are discovery-only and cannot be installed through this surface - Installability CatalogAiSkillCandidateInstallability `json:"installability"` + Installability CatalogAiSkillInstallability `json:"installability"` // Media type of the underlying AI skill card - MediaType CatalogAiSkillCandidateMediaType `json:"mediaType"` + MediaType CatalogAiSkillMediaType `json:"mediaType"` // Where the catalog reference was observed, without the card itself or any content digest. Provenance CatalogAiSkillCandidateProvenance `json:"provenance"` // Publisher taken verbatim from the card. Inert untrusted text. @@ -1646,14 +1704,90 @@ type CatalogMCPServerCandidateProvenance struct { // Experimental: CatalogNegotiatedContract is part of an experimental API and may change or // be removed. type CatalogNegotiatedContract struct { - // Wire features the runtime understood for this operation. Always a superset of the - // caller's required features, because any shortfall is a refusal instead. Operation - // availability remains a separate typed result. + // Wire features the runtime understood for this operation. Includes the five original + // catalog capabilities and only explicitly requested supported additions, in supported + // order without duplicates. Capabilities that introduce new success-union variants or + // operations are therefore included only when explicitly required, preserving older + // protocol-v3 clients. Always a superset of the caller's required features, because any + // shortfall is a refusal instead. Operation availability remains a separate typed result. GrantedCapabilities []CatalogCapability `json:"grantedCapabilities"` // Protocol version of the runtime that served the request. RuntimeProtocolVersion int64 `json:"runtimeProtocolVersion"` } +// Syntactically validated GitHub repository provenance declared by catalog metadata. This +// is a source claim rather than proof that the descriptor URL resolves to the repository. +// Experimental: CatalogPluginRepositorySource is part of an experimental API and may change +// or be removed. +type CatalogPluginRepositorySource struct { + // Case-preserving safe relative POSIX path derived from metadata.repoPath. + Path string `json:"path"` + // Canonical lowercase owner/repository name derived from metadata.sourceSet. + Repository string `json:"repository"` +} + +// Canonical catalogue resource identity. The runtime rewrites accepted urn:ai and urn:air +// identifiers to urn:air, lowercases the authority, and preserves the remaining resource +// components. +// Experimental: CatalogResourceIdentity is part of an experimental API and may change or be +// removed. +type CatalogResourceIdentity string + +// Bounded source-declared resource version, preserved exactly after validation and never +// inferred. +// Experimental: CatalogResourceVersion is part of an experimental API and may change or be +// removed. +type CatalogResourceVersion string + +// An explicit numbered-page request. The SDK treats the token as opaque; only the runtime +// decodes it and changes its targetPage. Authority validation binds navigation to the +// original search. No snapshot stability or token TTL is promised. +// Experimental: CatalogSearchPage is part of an experimental API and may change or be +// removed. +type CatalogSearchPage struct { + // Requested one-based page. Must not exceed either the token's signed pageCount or the + // navigation window ceil(1000 / pageSize). Repeat the search without page to discover newly + // available pages beyond that signed pageCount. + Number int32 `json:"number"` + // Opaque authority-issued pagination token from an earlier response. Never decode, modify + // or log it in an SDK consumer. + Token string `json:"token"` +} + +// Authority-reported navigation metadata, returned only to callers requiring +// catalog-search-pagination and only when a supported token is present. Tokenless +// first-page and continuation responses omit this object; no counts are inferred from +// candidates. The opaque token may be retained for previous or numbered navigation even +// when hasNextPage is false. +// Experimental: CatalogSearchPagination is part of an experimental API and may change or be +// removed. +type CatalogSearchPagination struct { + // One-based page returned by the authority. + CurrentPage int32 `json:"currentPage"` + // Whether the authority token advertises a valid next target within the navigation window. + // Not inferred from token presence, truncated, or currentPage being less than pageCount. + HasNextPage bool `json:"hasNextPage"` + // Navigation window ceiling ceil(1000 / pageSize), not the number of existing pages. Legal + // targets must not exceed this ceiling or the token's signed pageCount. + MaxPage int32 `json:"maxPage"` + // Backend-reported page count, which may exceed maxPage. Present pagination metadata always + // describes a multi-page result; zero- and single-page responses omit pagination. + // Navigation targets must also be within the signed pageCount carried by the supplied token. + PageCount int64 `json:"pageCount"` + // Page size bound to the search, equal to the effective request limit. + PageSize int32 `json:"pageSize"` + // Opaque authority-issued pagination token. Only the runtime decodes it or changes + // targetPage; SDK consumers must not decode, modify or log it. It has no runtime-created + // expiry or cache. + Token string `json:"token"` + // Backend-reported count for this response, not the number of returned candidates. Its + // relationship to the full query result set is unknown. + TotalCount int64 `json:"totalCount"` + // The relationship of totalCount to the complete query result set is unknown; neither + // exactness nor a lower-bound guarantee is implied. + TotalCountRelation CatalogSearchTotalCountRelation `json:"totalCountRelation"` +} + // A bounded catalog search. Both the query length and the result count are capped by the // schema so a caller cannot request an unbounded scan. // Experimental: CatalogSearchRequest is part of an experimental API and may change or be @@ -1661,11 +1795,17 @@ type CatalogNegotiatedContract struct { type CatalogSearchRequest struct { // Protocol version and capabilities the caller requires. Contract CatalogClientContract `json:"contract"` - // Restrict results to these candidate kinds. When omitted, every kind the runtime supports - // is searched. + // Restrict results to these candidate kinds. Agent Plugins are opt-in and require the + // `agent-plugin-discovery` capability so protocol-v3 clients generated before that variant + // cannot receive an unknown result; when omitted, the backwards-compatible MCP server and + // AI skill kinds are searched. Kinds []CatalogCandidateKind `json:"kinds,omitzero"` // Maximum number of candidates to return. Defaults to 10 when omitted. Limit *int32 `json:"limit,omitempty"` + // Numbered navigation using metadata from an earlier response. Requires + // catalog-search-pagination and the same query, kinds and effective limit. Omit for a fresh + // first-page search. + Page *CatalogSearchPage `json:"page,omitempty"` // Free-text search query. Persisted as tool input for session continuity, but omitted from // telemetry. Query string `json:"query"` @@ -1728,8 +1868,9 @@ func (CatalogContractViolationError) Kind() CatalogSearchResultKind { return CatalogSearchResultKindContractViolation } -// The request was rejected before any work was done, because a bounded field fell outside -// its permitted range or a required field was unusable. +// The request was rejected because a bounded field fell outside its permitted range or a +// required field was unusable. Pagination may also be rejected by the authority after a +// continuation request; repeat the search without page. // Experimental: CatalogInvalidRequestError is part of an experimental API and may change or // be removed. type CatalogInvalidRequestError struct { @@ -1832,7 +1973,8 @@ func (CatalogPolicyRejectedError) Kind() CatalogSearchResultKind { return CatalogSearchResultKindPolicyRejected } -// A completed catalog search: inert candidate summaries, each carrying a single-use handle. +// A completed catalog search containing inert candidate summaries. MCP server and AI skill +// variants carry a single-use handle; the Agent Plugin variant is handleless. // Experimental: CatalogSearchSucceeded is part of an experimental API and may change or be // removed. type CatalogSearchSucceeded struct { @@ -1841,6 +1983,10 @@ type CatalogSearchSucceeded struct { Candidates []CatalogCandidate `json:"candidates"` // Protocol version and capabilities the runtime honoured. Negotiated CatalogNegotiatedContract `json:"negotiated"` + // Navigation metadata for callers explicitly requiring catalog-search-pagination. Omitted + // when the authority returns no token, including tokenless first-page and continuation + // responses. Counts are never substituted from candidates.length. + Pagination *CatalogSearchPagination `json:"pagination,omitempty"` // Pseudonymous identifier for this search, issued by the runtime or by the catalog // authority it queried and never by the caller, so it cannot be forged or replayed to // attribute an install to a search that never happened. Always present on a success, so a @@ -1848,7 +1994,9 @@ type CatalogSearchSucceeded struct { // person: it is derived from no user, account, device, or query data, and must never be // joined with user identity to re-identify anyone. SearchID string `json:"searchId"` - // Whether further matches existed beyond the requested limit. + // Legacy indication that the authority returned a page token. Preserved for compatibility; + // this is not a has-next-page indicator. Use pagination.hasNextPage when pagination + // metadata is present. Truncated bool `json:"truncated"` } @@ -1910,6 +2058,182 @@ func (CatalogUnsupportedKindError) Kind() CatalogSearchResultKind { return CatalogSearchResultKindUnsupportedKind } +// Terminates one retained catalog selection group through an opaque reference previously +// returned by the model-safe search projection. +// Experimental: CatalogSelectionRequest is part of an experimental API and may change or be +// removed. +type CatalogSelectionRequest struct { + // Protocol version and capabilities the caller requires. + Contract CatalogClientContract `json:"contract"` + // The terminal outcome declared by the caller. Timed-out means the host's live interaction + // deadline elapsed; a reference whose runtime TTL elapsed is rejected separately as stale. + Outcome CatalogSelectionDecision `json:"outcome"` + // Opaque runtime-instance scoped reference to one visible candidate. For a non-selected + // outcome, any candidate reference from the same search closes that search's retained group. + SelectionRef string `json:"selectionRef"` + // Locally owned root session whose retained search state is being resolved. + SessionID string `json:"sessionId"` +} + +// Typed outcome of catalog.select. Only the selected host result carries a fresh candidate +// handle; the model-facing projection removes both that handle and searchId. +// Experimental: CatalogSelectionResult is part of an experimental API and may change or be +// removed. +type CatalogSelectionResult interface { + catalogSelectionResult() + catalogSelectionResultKind() CatalogSelectionResultKind +} + +type RawCatalogSelectionResultData struct { + Discriminator CatalogSelectionResultKind + Raw json.RawMessage +} + +func (RawCatalogSelectionResultData) catalogSelectionResult() {} +func (r RawCatalogSelectionResultData) catalogSelectionResultKind() CatalogSelectionResultKind { + return r.Discriminator +} +func (CatalogInvalidRequestError) catalogSelectionResult() {} +func (CatalogInvalidRequestError) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindInvalidRequest +} +func (CatalogNegotiationRefusedError) catalogSelectionResult() {} +func (CatalogNegotiationRefusedError) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindNegotiationRefused +} + +// The caller cancelled the selection interaction and the retained search state was released. +// Experimental: CatalogSelectionCancelled is part of an experimental API and may change or +// be removed. +type CatalogSelectionCancelled struct { + // The search identifier privately bound to the released selection group. + SearchID string `json:"searchId"` +} + +func (CatalogSelectionCancelled) catalogSelectionResult() {} +func (CatalogSelectionCancelled) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindCancelled +} + +// The caller explicitly declined every candidate and the retained search state was released. +// Experimental: CatalogSelectionDeclined is part of an experimental API and may change or +// be removed. +type CatalogSelectionDeclined struct { + // The search identifier privately bound to the released selection group. + SearchID string `json:"searchId"` +} + +func (CatalogSelectionDeclined) catalogSelectionResult() {} +func (CatalogSelectionDeclined) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindDeclined +} + +// The selection reference belongs to another runtime instance or session. +// Experimental: CatalogSelectionForeign is part of an experimental API and may change or be +// removed. +type CatalogSelectionForeign struct { + // Human-readable explanation safe to surface. Never contains the presented reference or + // private candidate state. + Message string `json:"message"` +} + +func (CatalogSelectionForeign) catalogSelectionResult() {} +func (CatalogSelectionForeign) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindForeign +} + +// The selection reference was malformed or unknown. +// Experimental: CatalogSelectionInvalid is part of an experimental API and may change or be +// removed. +type CatalogSelectionInvalid struct { + // Human-readable explanation safe to surface. Never contains the presented reference or + // private candidate state. + Message string `json:"message"` +} + +func (CatalogSelectionInvalid) catalogSelectionResult() {} +func (CatalogSelectionInvalid) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindInvalid +} + +// The selection group was already terminated or its pending host hand-off was already +// claimed. +// Experimental: CatalogSelectionReplayed is part of an experimental API and may change or +// be removed. +type CatalogSelectionReplayed struct { + // Human-readable explanation safe to surface. Never contains the presented reference or + // private candidate state. + Message string `json:"message"` +} + +func (CatalogSelectionReplayed) catalogSelectionResult() {} +func (CatalogSelectionReplayed) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindReplayed +} + +// The chosen candidate was transferred into a fresh bounded single-use handle for a later +// explicit planning request. +// Experimental: CatalogSelectionSelected is part of an experimental API and may change or +// be removed. +type CatalogSelectionSelected struct { + // Fresh single-use candidate handle accepted by mcp.planInstall. Returned only to the + // native host and never included in model-tool output. + CandidateHandle string `json:"candidateHandle"` + // The exact search identifier privately bound to the selected candidate. + SearchID string `json:"searchId"` +} + +func (CatalogSelectionSelected) catalogSelectionResult() {} +func (CatalogSelectionSelected) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindSelected +} + +// The runtime-enforced selection reference lifetime elapsed before the request arrived. +// Experimental: CatalogSelectionStale is part of an experimental API and may change or be +// removed. +type CatalogSelectionStale struct { + // Human-readable explanation safe to surface. Never contains the presented reference or + // private candidate state. + Message string `json:"message"` +} + +func (CatalogSelectionStale) catalogSelectionResult() {} +func (CatalogSelectionStale) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindStale +} + +// The host declared that its live selection interaction timed out, and the retained search +// state was released. +// Experimental: CatalogSelectionTimedOut is part of an experimental API and may change or +// be removed. +type CatalogSelectionTimedOut struct { + // The search identifier privately bound to the released selection group. + SearchID string `json:"searchId"` +} + +func (CatalogSelectionTimedOut) catalogSelectionResult() {} +func (CatalogSelectionTimedOut) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindTimedOut +} + +// The presented opaque handle was issued for another catalog operation. +// Experimental: CatalogSelectionWrongKind is part of an experimental API and may change or +// be removed. +type CatalogSelectionWrongKind struct { + // Human-readable explanation safe to surface. Never contains the presented reference or + // private candidate state. + Message string `json:"message"` +} + +func (CatalogSelectionWrongKind) catalogSelectionResult() {} +func (CatalogSelectionWrongKind) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindWrongKind +} +func (CatalogUnavailableError) catalogSelectionResult() {} +func (CatalogUnavailableError) catalogSelectionResultKind() CatalogSelectionResultKind { + return CatalogSelectionResultKindUnavailable +} + // Where and when the runtime observed the trust metadata. Observation time is not the // authority's evaluation time and must not be used to infer staleness. // Experimental: CatalogTrustProvenance is part of an experimental API and may change or be @@ -2434,6 +2758,8 @@ type CopilotUserResponse struct { CopilotPlan *string `json:"copilot_plan,omitempty"` // Endpoint URLs from the raw Copilot `/copilot_internal/v2/token` user-response passthrough. Endpoints *CopilotUserResponseEndpoints `json:"endpoints,omitempty"` + // Enterprises that provide the user's Copilot license, each with a stable numeric ID. + EnterpriseList []CopilotUserResponseEnterpriseListItem `json:"enterprise_list,omitzero"` // Whether MCP (Model Context Protocol) support is enabled for the user. IsMCPEnabled *bool `json:"is_mcp_enabled,omitempty"` // Whether the user is a GitHub/Microsoft staff member. @@ -2484,6 +2810,11 @@ type CopilotUserResponseEndpoints struct { Telemetry *string `json:"telemetry,omitempty"` } +type CopilotUserResponseEnterpriseListItem struct { + // Numeric database ID of the enterprise. + ID int64 `json:"id"` +} + type CopilotUserResponseOrganizationListItem struct { // Numeric database ID of the organization. ID *float64 `json:"id,omitempty"` @@ -4722,6 +5053,10 @@ type InstalledPluginInfo struct { DirectSourceID *string `json:"directSourceId,omitempty"` // Whether the plugin is currently enabled for new sessions Enabled bool `json:"enabled"` + // Whether the managed desired plugin currently has an installed or live record. Set to + // false for a managed desired entry retained in the listing after installation or + // reconciliation failed. + Installed *bool `json:"installed,omitempty"` // Absolute path of the marketplace directory a live plugin was resolved from. Present only // on live, never-persisted records — a plugin belonging to a directory/local marketplace, // which is loaded from its real directory on every pass instead of a copy under the @@ -4729,6 +5064,11 @@ type InstalledPluginInfo struct { // plugin is always present on disk, so `enabled` is its only meaningful state and it is // never "not installed". InstalledFrom *string `json:"installedFrom,omitempty"` + // Whether enterprise managed settings control this plugin's enabled state. + Managed *bool `json:"managed,omitempty"` + // The enabled state required by enterprise managed settings, when this plugin spec is + // managed. + ManagedDesiredEnabled *bool `json:"managedDesiredEnabled,omitempty"` // Marketplace the plugin came from. Empty string ("") for direct repo / URL / local // installs. Marketplace string `json:"marketplace"` @@ -5198,6 +5538,55 @@ type ManagedSettingsReadResult struct { SettingsJSON any `json:"settingsJson,omitempty"` } +// Enterprise managed-settings resolution: the effective managed settings the session +// applied and which channels contributed, so SDK clients can show users what is +// enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on +// resume, and on account switch. This is an ephemeral live snapshot (delivered to +// subscribers but not persisted to the session event log), because at session start it +// resolves before `session.start` is emitted. Device values take precedence over server +// values, then the policy helper, per ordinary key, while permissions compose restrictively +// across device, server, policy-helper, and SDK-client layers. The account-scoped +// `getManagedSettings()` API does not include session-local client injection. Marked +// experimental while the managed-settings surface stabilizes. +// Experimental: ManagedSettingsResolvedData is part of an experimental API and may change +// or be removed. +type ManagedSettingsResolvedData struct { + // Whether enterprise policy disables bypass-permissions ("yolo") mode for this session. + // Deny-wins across layers, and forced on when `failClosed` is true. + BypassPermissionsDisabled bool `json:"bypassPermissionsDisabled"` + // Whether a session-local permissions layer injected by the SDK host was present + ClientManaged *bool `json:"clientManaged,omitempty"` + // Whether an actual device MDM/plist/registry/file managed-settings layer was present + DeviceManaged bool `json:"deviceManaged"` + // Whether managed policy could not be determined (e.g. a failed server fetch) and the + // session fell back to the fail-closed restriction. When true, restrictions such as + // disabling bypass-permissions are enforced even though `settings` may be absent. + FailClosed bool `json:"failClosed"` + // The setting keys under enterprise management in the effective managed settings (e.g. + // `model`, `enabledPlugins`, `permissions`). Empty when no managed settings are in force. + ManagedKeys []string `json:"managedKeys"` + // Whether at least two managed sources supplied permission allowlists, so enforcement + // intersects them and the flattened settings payload omits `permissions.allow`. + PermissionsAllowIntersected *bool `json:"permissionsAllowIntersected,omitempty"` + // Whether the policy-helper managed-settings layer was present. The policy helper is the + // weakest channel: it fills keys no enterprise source set and can never replace one. + PolicyHelperManaged *bool `json:"policyHelperManaged,omitempty"` + // Whether the effective sandbox policy forces the sandbox on *only* because managed policy + // could not be determined, rather than because the policy requires it. Lets clients tell a + // user whose `--no-sandbox` was overridden that the sandbox stayed on as a fail-closed + // fallback, instead of attributing it to an administrator who set no such policy. + SandboxEnabledByUndeterminedPolicy *bool `json:"sandboxEnabledByUndeterminedPolicy,omitempty"` + // Whether the server (account/org) managed-settings layer was present + ServerManaged bool `json:"serverManaged"` + // The effective (resolved) managed settings values, so clients can render exactly what is + // enforced. Absent when no managed policy is in force. + Settings any `json:"settings,omitempty"` + // Channel summary: `server`, `device`, `client`, or `policyHelper` when exactly one channel + // contributed; `mixed` when multiple channels contributed; otherwise `none`. Consult the + // per-channel booleans for exact provenance. + Source ManagedSettingsResolvedSource `json:"source"` +} + // Result of registering a new marketplace. // Experimental: MarketplaceAddResult is part of an experimental API and may change or be // removed. @@ -5217,9 +5606,15 @@ type MarketplaceBrowseResult struct { // Registered marketplace summary. // Experimental: MarketplaceInfo is part of an experimental API and may change or be removed. type MarketplaceInfo struct { + // Whether the managed marketplace currently resolved into the runtime marketplace registry. + // Set to false when the desired managed entry is retained for governance visibility after + // loading or reconciliation failed. + Available *bool `json:"available,omitempty"` // True when this is a default marketplace shipped with the runtime. Defaults are not // removable. IsDefault *bool `json:"isDefault,omitempty"` + // Whether enterprise managed settings provide and control this marketplace entry. + Managed *bool `json:"managed,omitempty"` // Marketplace name (matches the @marketplace suffix in plugin specs) Name string `json:"name"` // Human-readable description of where the marketplace data is fetched from (e.g. "GitHub: @@ -5773,8 +6168,9 @@ type MCPHostState struct { // no raw card, no install specification, and no secret value. // Experimental: MCPInstallPlan is part of an experimental API and may change or be removed. type MCPInstallPlan struct { - // The configuration changes installing would make, described rather than serialised, so the - // mutable configuration payload stays behind the runtime boundary. + // Alternative configuration changes, with exactly one entry for each transportChoices entry + // in the same order. Only the entry for the subsequently selected transport applies; these + // are not cumulative writes. Payloads remain behind the runtime boundary. ConfigurationChanges []MCPPlanConfigurationChange `json:"configurationChanges"` // Normalised identity of the server the plan would install. Identity MCPPlanResourceIdentity `json:"identity"` @@ -5796,8 +6192,10 @@ type MCPInstallPlan struct { // Whether applying this plan would require an MCP reload to take effect. Planning itself // never reloads. ReloadRequired bool `json:"reloadRequired"` - // Whether the plan cannot be applied without further input, because a required value has no - // default or a secret must be supplied. + // True only when every eligible transport choice needs additional values or secrets. False + // means at least one choice needs no additional configuration, not that every choice is + // ready. A later apply operation must validate the selected choice's own inputs, secrets + // and policy after explicit confirmation. RequiresInteractiveConfiguration bool `json:"requiresInteractiveConfiguration"` // Configuration scope and key the plan would write to. Target MCPPlanTarget `json:"target"` @@ -6054,8 +6452,9 @@ type MCPOauthRespondResult struct { Success bool `json:"success"` } -// One change applying the plan would make, described rather than serialised so the -// configuration payload stays behind the runtime boundary. +// The configuration-change alternative for the transportChoices entry at the same index. +// Only the selected alternative is applied; entries are not cumulative. The payload stays +// behind the runtime boundary. // Experimental: MCPPlanConfigurationChange is part of an experimental API and may change or // be removed. type MCPPlanConfigurationChange struct { @@ -6236,11 +6635,10 @@ type MCPPlanInstallSourceCandidate struct { // rejected. CandidateHandle string `json:"candidateHandle"` // The runtime- or authority-minted `searchId` returned with the search that produced this - // candidate. A search implementation binds it to private candidate-handle context; a - // planning implementation must verify that context before returning a plan. The unavailable - // planning implementation in this contract layer validates presence but does not claim the - // verification has occurred. It identifies a search rather than a person and must never be - // joined with user identity to re-identify anyone. + // candidate. Planning verifies the private correlation and atomically consumes a matching + // candidate before downstream work, including attempts that subsequently fail or report + // unavailable. A mismatched search does not consume the candidate. It identifies a search + // rather than a person and must never be joined with user identity to re-identify anyone. SearchID string `json:"searchId"` } @@ -6817,6 +7215,10 @@ type MCPServerConfigHTTP struct { Oidc MCPServerAuthConfig `json:"oidc,omitempty"` // Telemetry-obfuscation policy for this server's tools. SafeForTelemetry MCPSafeForTelemetry `json:"safeForTelemetry,omitempty"` + // Milliseconds this server may spend connecting before the CLI warns that it is taking + // longer than expected. Presentation only: it does not change how long the connection is + // allowed to take. + SlowConnectionThresholdMs *int64 `json:"slowConnectionThresholdMs,omitempty"` // The origin of this server configuration. Source *MCPServerSource `json:"source,omitempty"` // Source file path recorded while loading the config. @@ -6881,6 +7283,10 @@ type MCPServerConfigStdio struct { Oidc MCPServerAuthConfig `json:"oidc,omitempty"` // Telemetry-obfuscation policy for this server's tools. SafeForTelemetry MCPSafeForTelemetry `json:"safeForTelemetry,omitempty"` + // Milliseconds this server may spend connecting before the CLI warns that it is taking + // longer than expected. Presentation only: it does not change how long the connection is + // allowed to take. + SlowConnectionThresholdMs *int64 `json:"slowConnectionThresholdMs,omitempty"` // The origin of this server configuration. Source *MCPServerSource `json:"source,omitempty"` // Source file path recorded while loading the config. @@ -7044,6 +7450,10 @@ type MCPServerConfigMemory struct { // Internal: ServerInstance is part of the SDK's internal API surface and is not intended // for external use. ServerInstance any `json:"serverInstance"` + // Milliseconds this server may spend connecting before the CLI warns that it is taking + // longer than expected. Presentation only: it does not change how long the connection is + // allowed to take. + SlowConnectionThresholdMs *int64 `json:"slowConnectionThresholdMs,omitempty"` // The origin of this server configuration. Source *MCPServerSource `json:"source,omitempty"` // Source file path recorded while loading the config. @@ -7470,6 +7880,9 @@ type Model struct { // Experimental: ModelApplyStartupOverlayRequest is part of an experimental API and may // change or be removed. type ModelApplyStartupOverlayRequest struct { + // Effective default Auto routing preference from user and managed settings. Applies only to + // fresh sessions and never replaces a per-session selection. + AutoTier *AutoTier `json:"autoTier,omitempty"` // Model explicitly selected by the CLI, when provided. CLIModel *string `json:"cliModel,omitempty"` // Whether the overlay is being applied while resuming a deferred session. @@ -7922,6 +8335,9 @@ type ModelSwitchToResult struct { ModelState *CurrentModel `json:"modelState,omitempty"` // Persistence failure encountered after applying the model switch. PersistenceError *string `json:"persistenceError,omitempty"` + // Stable queue item identifier when this request was enqueued. Remains present if the item + // drains before the response is returned. + QueueID *string `json:"queueId,omitempty"` // Lifecycle result for the requested switch Status *string `json:"status,omitempty"` // User-facing warning produced while applying the model switch. @@ -8132,6 +8548,9 @@ type OptionsUpdateAdditionalContentExclusionPolicyRuleSource struct { // Experimental: PendingPermissionRequest is part of an experimental API and may change or // be removed. type PendingPermissionRequest struct { + // Permission-recovery episode that authorized this request to surface for interactive + // attention + RecoveryEpisodeID *string `json:"recoveryEpisodeId,omitempty"` // The user-facing permission prompt details (commands, write, read, mcp, url, memory, // custom-tool, path, hook) Request PermissionPromptRequest `json:"request"` @@ -8913,6 +9332,47 @@ type PermissionPromptShownNotification struct { Message string `json:"message"` } +// Experimental: PermissionRecoveryAttempt is part of an experimental API and may change or +// be removed. +type PermissionRecoveryAttempt struct { + // Unique identifier for this attempt record + AttemptID string `json:"attemptId"` + // How the runtime handled this attempt + Disposition PermissionRecoveryAttemptDisposition `json:"disposition"` + // One-based position of this attempt in the episode + Ordinal int64 `json:"ordinal"` + // Controlled permission request kind, such as shell, path, URL, or tool + PermissionKind string `json:"permissionKind"` + // Controlled reason for the attempt disposition + Reason PermissionRecoveryAttemptReason `json:"reason"` + // Relationship between this attempt and earlier attempts in the episode + Relation PermissionRecoveryAttemptRelation `json:"relation"` + // SHA-256 fingerprint of normalized request data; raw permission arguments are not included + RequestFingerprint string `json:"requestFingerprint"` + // Tool-call identifier associated with this attempt, when available + ToolCallID *string `json:"toolCallId,omitempty"` +} + +// Authoritative snapshot of an Autopilot permission-recovery episode +// Experimental: PermissionRecoveryData is part of an experimental API and may change or be +// removed. +type PermissionRecoveryData struct { + // Ordered privacy-safe record of permission attempts and the successful alternative, when + // any + Attempts []PermissionRecoveryAttempt `json:"attempts"` + // Stable identifier shared by every transition in this recovery episode + EpisodeID string `json:"episodeId"` + // Maximum number of distinct autonomous permission attempts allowed before escalation + MaxAttempts int64 `json:"maxAttempts"` + // Policy selected from the current client's response capability; mode or client changes may + // update it during recovery + OnBlocked PermissionRecoveryOnBlocked `json:"onBlocked"` + // Controlled reason for the latest episode transition + Reason PermissionRecoveryReason `json:"reason"` + // Current lifecycle state of the recovery episode + Status PermissionRecoveryStatus `json:"status"` +} + // Indicates whether the permission decision was applied; false when the request was already // resolved. // Experimental: PermissionRequestResult is part of an experimental API and may change or be @@ -9489,12 +9949,24 @@ type PlanUpdateRequest struct { // Session plugin metadata, with name, marketplace, optional version, and enabled state. // Experimental: Plugin is part of an experimental API and may change or be removed. type Plugin struct { + // Opaque stable identity for a direct plugin source. + DirectSourceID *string `json:"directSourceId,omitempty"` // Whether the plugin is currently enabled Enabled bool `json:"enabled"` + // Whether this managed desired plugin has an installed or live record. + Installed *bool `json:"installed,omitempty"` + // Absolute marketplace directory for a live plugin. + InstalledFrom *string `json:"installedFrom,omitempty"` + // Whether enterprise managed settings control this plugin. + Managed *bool `json:"managed,omitempty"` + // Enabled state required by enterprise managed settings. + ManagedDesiredEnabled *bool `json:"managedDesiredEnabled,omitempty"` // Marketplace the plugin came from Marketplace string `json:"marketplace"` // Plugin name Name string `json:"name"` + // Runtime plugin provenance, such as "builtin". + Source *string `json:"source,omitempty"` // Installed version Version *string `json:"version,omitempty"` } @@ -10392,6 +10864,27 @@ type PushGitHubRepoRef struct { Owner string `json:"owner"` } +// Append to one pending steering message without changing its identity or delivery position. +// Experimental: QueueAppendSteeringRequest is part of an experimental API and may change or +// be removed. +type QueueAppendSteeringRequest struct { + // Mode captured at submission. Only steering messages in the same mode may be combined. + AgentMode SendAgentMode `json:"agentMode"` + // Attachments to add after the message's existing attachments. An empty list preserves the + // existing attachments. + Attachments []Attachment `json:"attachments"` + // Display text to append to the existing preview after a blank line. + DisplayPrompt string `json:"displayPrompt"` + // Expected current prompt, including any previous appends. The runtime applies plan-mode + // normalization before comparing and refuses a changed message. + ExpectedPrompt string `json:"expectedPrompt"` + // Message identity returned by send, not the queue item id. Only unclaimed user steering + // messages are eligible. + MessageID string `json:"messageId"` + // Text to append after a blank line. + Prompt string `json:"prompt"` +} + // Inputs for starting a deferred-idle drain. // Experimental: QueueBeginDeferredIdleDrainRequest is part of an experimental API and may // change or be removed. @@ -10679,6 +11172,8 @@ type QueueSetDrainPausedRequest struct { // Experimental: QueueSnapshotResult is part of an experimental API and may change or be // removed. type QueueSnapshotResult struct { + // Queue item identifier of a model switch that has been dequeued but not yet applied. + InFlightModelChangeID *string `json:"inFlightModelChangeId,omitempty"` // Insertion orders for queued items, aligned with `items`. ItemOrders []int64 `json:"itemOrders,omitzero"` // User-facing pending items in FIFO order. @@ -10709,6 +11204,18 @@ type QueueUpdateTextResult struct { Updated bool `json:"updated"` } +// Conditional withdrawal of a single user message, before the runtime claims it for +// delivery. +// Experimental: QueueWithdrawMessageRequest is part of an experimental API and may change +// or be removed. +type QueueWithdrawMessageRequest struct { + // The prompt originally sent. A message edited since submission is not withdrawn, so an + // obsolete draft cannot replace the edit. + ExpectedPrompt string `json:"expectedPrompt"` + // Message identity returned by send, not the queue item id. Batch messages are not eligible. + MessageID string `json:"messageId"` +} + // Event type to register consumer interest for, used by runtime gating logic. // Experimental: RegisterEventInterestParams is part of an experimental API and may change // or be removed. @@ -11129,12 +11636,11 @@ type SandboxConfigUserPolicyNetwork struct { // A domain also denies all its subdomains. IP addresses match exactly; *.example.com // matches strict subdomains, and * denies every host. BlockedHosts []string `json:"blockedHosts,omitzero"` - // HTTP(S) proxy for sandboxed traffic. With host rules, this is the built-in local proxy's - // upstream; credentials stay in the runtime, and Linux and macOS restrict the child to the - // local listener. Without host rules, Linux restricts egress to this endpoint but rejects - // credentials, and macOS proxying is cooperative. Windows enforcement depends on the - // application's networking stack. Configure credentials in the separate username/password - // fields. The transient local listener URL is never persisted. + // HTTP(S) proxy for sandboxed traffic. This is the built-in local proxy's upstream: every + // sandboxed command reaches it through a loopback listener, so credentials stay in the + // runtime and never reach the child. On Windows the sandbox also needs local network + // access, because it reaches that listener over host loopback. Configure credentials in the + // separate username/password fields. The transient local listener URL is never persisted. Proxy *SandboxConfigUserPolicyNetworkProxy `json:"proxy,omitempty"` } @@ -12080,7 +12586,12 @@ type SessionFSSetProviderCapabilities struct { } // Initial working directory, session-state path layout, and path conventions used to -// register the calling SDK client as the session filesystem provider. +// register the calling SDK client as the session filesystem provider. A registered provider +// is authoritative for path interpretation and filesystem facts used by workspace +// permission validation. Paths are interpreted lexically; home-relative paths (`~` and +// `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until +// provider-side canonicalization is supported, providers must not expose symlinks inside +// allowed roots that escape those roots. // Experimental: SessionFSSetProviderRequest is part of an experimental API and may change // or be removed. type SessionFSSetProviderRequest struct { @@ -12088,7 +12599,9 @@ type SessionFSSetProviderRequest struct { Capabilities *SessionFSSetProviderCapabilities `json:"capabilities,omitempty"` // Path conventions used by this filesystem Conventions SessionFSSetProviderConventions `json:"conventions"` - // Initial working directory for sessions + // Absolute initial working directory for sessions. Registering the provider establishes + // this path as the root of its virtual namespace; the runtime does not require the provider + // to materialize or stat it before creating a session. InitialCwd string `json:"initialCwd"` // Path within each session's SessionFs where the runtime stores files for that session SessionStatePath string `json:"sessionStatePath"` @@ -12579,8 +13092,8 @@ type SessionManagedPermissions struct { Ask []string `json:"ask,omitzero"` // Permission rules that block matching operations. Deny has highest precedence. Deny []string `json:"deny,omitzero"` - // When set to `disable`, prevents bypass/allow-all permission modes. `allow-auto-only` - // blocks full allow-all but permits advisory auto-approval. Any other value is accepted + // When set to `disable`, prevents bypass/allow-all permission modes. Advisory auto-approval + // remains available because normal prompt paths stay active. Any other value is accepted // rather than failing the session, but is enforced as `disable`: the key is only present to // restrict something, so a mode this runtime cannot interpret fails closed to the most // restrictive one it knows. Omit the key entirely to impose no restriction. @@ -12663,6 +13176,9 @@ type SessionMetadataSnapshot struct { ClientName *string `json:"clientName,omitempty"` // The current agent mode for this session (e.g., 'interactive', 'plan', 'autopilot') CurrentMode MetadataSnapshotCurrentMode `json:"currentMode"` + // Live indexed-search state for this session activation. Omitted by runtimes that do not + // expose indexed-search status; absence does not indicate enablement. + IndexedSearch *IndexedSearchState `json:"indexedSearch,omitempty"` // User-provided name supplied at session construction (via `--name`), if any. Immutable // after construction. InitialName *string `json:"initialName,omitempty"` @@ -13197,6 +13713,54 @@ type SessionPlanDeleteResult struct { type SessionPlanUpdateResult struct { } +// Plugin names (or specs) to disable in the session's authoritative working directory. +// Experimental: SessionPluginsDisableRequest is part of an experimental API and may change +// or be removed. +type SessionPluginsDisableRequest struct { + // Plugin names or "plugin@marketplace" specs to disable. Unknown names are ignored. + // Non-marketplace direct installs cannot be disabled via this API; uninstall them instead. + // Plugin-owned MCP servers are stopped in active sessions immediately; other plugin + // contributions remain available until each session reloads plugins. + Names []string `json:"names"` +} + +// Experimental: SessionPluginsDisableResult is part of an experimental API and may change +// or be removed. +type SessionPluginsDisableResult struct { +} + +// Plugin names (or specs) to enable in the session's authoritative working directory. +// Experimental: SessionPluginsEnableRequest is part of an experimental API and may change +// or be removed. +type SessionPluginsEnableRequest struct { + // Plugin names or "plugin@marketplace" specs to enable. Unknown names are ignored. + // Non-marketplace direct installs are always enabled and cannot be toggled via this API. + Names []string `json:"names"` +} + +// Experimental: SessionPluginsEnableResult is part of an experimental API and may change or +// be removed. +type SessionPluginsEnableResult struct { +} + +// Plugin source resolved relative to the session's authoritative working directory. +// Experimental: SessionPluginsInstallRequest is part of an experimental API and may change +// or be removed. +type SessionPluginsInstallRequest struct { + // Plugin install spec. Accepts the same forms as the CLI: "plugin@marketplace" (marketplace + // install), "owner/repo" or "owner/repo:subpath" (GitHub direct), an http/https/ssh URL, or + // a local path. Direct (non-marketplace) installs are deprecated and will produce a + // deprecationWarning in the result. + Source string `json:"source"` +} + +// Experimental: SessionPluginsMarketplacesRefreshRequest is part of an experimental API and +// may change or be removed. +type SessionPluginsMarketplacesRefreshRequest struct { + // Marketplace name to refresh. When omitted, every registered marketplace is refreshed. + Name *string `json:"name,omitempty"` +} + // Experimental: SessionPluginsReloadRequest is part of an experimental API and may change // or be removed. type SessionPluginsReloadRequest struct { @@ -13221,6 +13785,11 @@ type SessionPluginsReloadRequest struct { type SessionPluginsReloadResult struct { } +// Experimental: SessionPluginsUninstallResult is part of an experimental API and may change +// or be removed. +type SessionPluginsUninstallResult struct { +} + // Experimental: SessionProviderGetEndpointRequest is part of an experimental API and may // change or be removed. type SessionProviderGetEndpointRequest struct { @@ -14176,6 +14745,13 @@ type SessionUpdateOptionsResult struct { Success bool `json:"success"` } +// Experimental: SessionWorkflowPauseAtCheckpointResult is part of an experimental API and +// may change or be removed. +type SessionWorkflowPauseAtCheckpointResult struct { + // Whether this execution attempt must pause or may continue. + Action WorkflowPauseCheckpointAction `json:"action"` +} + // Updated working directory and git context. Emitted as the new payload of // `session.context_changed`. // Experimental: SessionWorkingDirectoryContext is part of an experimental API and may @@ -14980,6 +15556,19 @@ type SystemMessageBlock struct { IsStatic *bool `json:"isStatic,omitempty"` } +// Structured reason that the task cannot continue without intervention +// Experimental: TaskBlocker is part of an experimental API and may change or be removed. +type TaskBlocker struct { + // Category of intervention that blocked the task + Kind TaskBlockerKind `json:"kind"` + // Permission-recovery episode that produced this blocker + PermissionRecovery PermissionRecoveryData `json:"permissionRecovery"` + // Controlled reason for the current blocked state + Reason PermissionRecoveryReason `json:"reason"` + // Whether a later user response or steering message can resume the task + Resumable bool `json:"resumable"` +} + // Public owner attribution for a client-owned task. Identifiers are opaque and never // authorize requests. // Experimental: TaskClientOwner is part of an experimental API and may change or be removed. @@ -15080,6 +15669,8 @@ func (TaskClientUpdateProgress) Kind() TaskClientUpdateKind { // Experimental: TaskCompleteData is part of an experimental API and may change or be // removed. type TaskCompleteData struct { + // Structured blocker details when outcome is blocked + Blocker *TaskBlocker `json:"blocker,omitempty"` // Active autopilot objective ID evaluated by the completion reviewer ObjectiveID *int64 `json:"objectiveId,omitempty"` // Semantic completion decision. Absent on legacy events and invalid tool calls @@ -16645,11828 +17236,13689 @@ type VisibilitySetResult struct { Synced bool `json:"synced"` } -// A single changed file and its unified diff. -// Experimental: WorkspaceDiffFileChange is part of an experimental API and may change or be +// Parameters for cooperatively aborting a workflow body. +// Experimental: WorkflowAbortRequest is part of an experimental API and may change or be // removed. -type WorkspaceDiffFileChange struct { - // Type of change represented by this file diff. - ChangeType WorkspaceDiffFileChangeType `json:"changeType"` - // Unified diff content for the file. Empty when the diff was truncated. - Diff string `json:"diff"` - // Whether the diff content was omitted because it exceeded the per-file size limit. - IsTruncated *bool `json:"isTruncated,omitempty"` - // Original file path for renamed files. - OldPath *string `json:"oldPath,omitempty"` - // Path to the changed file, relative to the workspace root when the file lives under it. A - // file changed outside the workspace root keeps a `../`-relative path, or an absolute path - // when no relative path exists (for example a different Windows drive). - Path string `json:"path"` +type WorkflowAbortRequest struct { + // Opaque token identifying the execution attempt to abort. + ExecutionToken string `json:"executionToken"` + // Workflow run identifier. + RunID string `json:"runId"` + // Target session identifier + SessionID string `json:"sessionId"` } -// Workspace diff result for the requested mode. -// Experimental: WorkspaceDiffResult is part of an experimental API and may change or be +// Acknowledgement that a workflow request was accepted. +// Experimental: WorkflowAckResult is part of an experimental API and may change or be // removed. -type WorkspaceDiffResult struct { - // Default branch used for a branch diff, when branch mode was requested. - BaseBranch *string `json:"baseBranch,omitempty"` - // Changed files and their unified diffs. - Changes []WorkspaceDiffFileChange `json:"changes"` - // Whether the requested diff fell back to unstaged changes, either because branch diff - // failed or session diff was unavailable. - IsFallback bool `json:"isFallback"` - // Effective mode used for the returned changes. - Mode WorkspaceDiffMode `json:"mode"` - // Diff mode requested by the client. - RequestedMode WorkspaceDiffMode `json:"requestedMode"` - // Why the session diff could not be produced, when applicable. Set only when `session` mode - // was requested and `isFallback` is true, so a client can tell the permanent - // `file-change-tracking-disabled` apart from the transient `session-busy`, which the same - // request answers once the session settles. Never set for `unstaged` or `branch` mode, and - // never `unsupported-remote-session`: a remote session's captures live on its own host, so - // a `session`-mode diff is rejected for one rather than answered with a controller-side - // fallback. - UnavailableReason *HistoryRewindUnavailableReason `json:"unavailableReason,omitempty"` -} - -// Compaction summary checkpoint to persist. -// Experimental: WorkspacesAddSummaryRequest is part of an experimental API and may change -// or be removed. -type WorkspacesAddSummaryRequest struct { - // Markdown summary content to persist. - Content string `json:"content"` - // Summary title shown in checkpoint listings. - Title string `json:"title"` +type WorkflowAckResult struct { } -// Persisted summary metadata and refreshed workspace metadata. -// Experimental: WorkspacesAddSummaryResult is part of an experimental API and may change or -// be removed. -type WorkspacesAddSummaryResult struct { - // Metadata for the persisted summary. - Summary any `json:"summary,omitempty"` - // Refreshed metadata for the containing workspace. - Workspace any `json:"workspace,omitempty"` +// Options for one workflow-scoped subagent call. +// Experimental: WorkflowAgentOptions is part of an experimental API and may change or be +// removed. +type WorkflowAgentOptions struct { + // Optional built-in or custom agent name whose definition configures the subagent. + Agent *string `json:"agent,omitempty"` + // Optional context tier override for the subagent. + ContextTier *ContextTier `json:"contextTier,omitempty"` + // Optional label distinguishing otherwise identical memoized agent calls. + Label *string `json:"label,omitempty"` + // Optional model identifier for the subagent. + Model *string `json:"model,omitempty"` + // Optional reasoning effort override for the subagent. + ReasoningEffort *string `json:"reasoningEffort,omitempty"` + // Optional JSON Schema for structured agent output. + Schema any `json:"schema,omitempty"` } -// Whether the autopilot objective file exists. -// Experimental: WorkspacesAutopilotObjectiveExistsResult is part of an experimental API and -// may change or be removed. -type WorkspacesAutopilotObjectiveExistsResult struct { - // True when the objective file exists. - Exists bool `json:"exists"` +// Parameters for one workflow-scoped subagent call. +// Experimental: WorkflowAgentRequest is part of an experimental API and may change or be +// removed. +type WorkflowAgentRequest struct { + // Opaque token identifying the current workflow execution attempt. + ExecutionToken string `json:"executionToken"` + // Subagent execution options. + Opts WorkflowAgentOptions `json:"opts"` + // Prompt to send to the subagent. + Prompt string `json:"prompt"` + // Workflow run identifier that owns the subagent. + WorkflowRunID string `json:"workflowRunId"` } -// Workspace checkpoint metadata with assigned number, human-readable title, and checkpoint -// filename. -// Experimental: WorkspacesCheckpoints is part of an experimental API and may change or be +// Result of one workflow-scoped subagent call. +// Experimental: WorkflowAgentResult is part of an experimental API and may change or be // removed. -type WorkspacesCheckpoints struct { - // Filename of the checkpoint within the workspace checkpoints directory - Filename string `json:"filename"` - // Checkpoint number assigned by the workspace manager - Number int64 `json:"number"` - // Human-readable checkpoint title - Title string `json:"title"` +type WorkflowAgentResult struct { + // Agent result, omitted when the agent produced no result. + Result any `json:"result,omitempty"` } -// Directory to create within the session workspace files directory. -// Experimental: WorkspacesCreateDirectoryRequest is part of an experimental API and may -// change or be removed. -type WorkspacesCreateDirectoryRequest struct { - // Slash-separated relative path within the workspace files directory - Path string `json:"path"` - // Whether to create missing parent directories. Defaults to false. - Recursive *bool `json:"recursive,omitempty"` +// Prompt-safe durable identity and live status for a direct workflow agent. +// Experimental: WorkflowAgentSummary is part of an experimental API and may change or be +// removed. +type WorkflowAgentSummary struct { + // Accumulated active agent time in milliseconds. + ActiveMs int64 `json:"activeMs"` + // Prompt-safe live activity text. + Activity *string `json:"activity,omitempty"` + // Stable direct-agent identifier. + AgentID string `json:"agentId"` + // Registered agent type. + AgentType string `json:"agentType"` + // Epoch milliseconds when the agent completed. + CompletedAt *int64 `json:"completedAt,omitempty"` + // Friendly, non-unique name intended for display + DisplayName *string `json:"displayName,omitempty"` + // Friendly, non-unique name intended for display + Label string `json:"label"` + // Phase identifier active when the agent was launched, or null. + PhaseID *string `json:"phaseId"` + // Model requested when the agent was launched. + RequestedModel *string `json:"requestedModel,omitempty"` + // Concrete model resolved for the agent. + ResolvedModel *string `json:"resolvedModel,omitempty"` + // Owning workflow run identifier. + RunID string `json:"runId"` + // Epoch milliseconds when the agent started. + StartedAt *int64 `json:"startedAt,omitempty"` + // Current durable or live agent status. + Status string `json:"status"` + // Tool-call identifier that launched the agent. + ToolCallID string `json:"toolCallId"` } -// Relative path and UTF-8 content for the workspace file to create or overwrite. -// Experimental: WorkspacesCreateFileRequest is part of an experimental API and may change -// or be removed. -type WorkspacesCreateFileRequest struct { - // File content to write as a UTF-8 string - Content string `json:"content"` - // Slash-separated relative path within the workspace files directory - Path string `json:"path"` +// Parameters for cancelling a workflow run. +// Experimental: WorkflowCancelRequest is part of an experimental API and may change or be +// removed. +type WorkflowCancelRequest struct { + // Workflow run identifier. + RunID string `json:"runId"` } -// Result of deleting the autopilot objective file. -// Experimental: WorkspacesDeleteAutopilotObjectiveResult is part of an experimental API and -// may change or be removed. -type WorkspacesDeleteAutopilotObjectiveResult struct { - // True when a file was deleted. - Deleted bool `json:"deleted"` +// Current workflow phase identity. +// Experimental: WorkflowCurrentPhase is part of an experimental API and may change or be +// removed. +type WorkflowCurrentPhase struct { + // Current phase identifier. + ID string `json:"id"` + // Zero-based declared phase ordinal, or null for an undeclared phase. + Ordinal *int64 `json:"ordinal"` } -// Parameters for computing a workspace diff. -// Experimental: WorkspacesDiffRequest is part of an experimental API and may change or be +// Declared or approved workflow resource ceilings. +// Experimental: WorkflowDeclaredLimits is part of an experimental API and may change or be // removed. -type WorkspacesDiffRequest struct { - // When true, ignore whitespace-only changes (git `--ignore-all-space`). Defaults to false. - IgnoreWhitespace *bool `json:"ignoreWhitespace,omitempty"` - // Diff mode requested by the client. - Mode WorkspaceDiffMode `json:"mode"` +type WorkflowDeclaredLimits struct { + // Maximum AI credits consumed by subagents and descendants. + MaxAiCredits *float64 `json:"maxAiCredits,omitempty"` + // Maximum concurrently active subagents. + MaxConcurrentSubagents *int64 `json:"maxConcurrentSubagents,omitempty"` + // Maximum total subagents spawned by the run. + MaxTotalSubagents *int64 `json:"maxTotalSubagents,omitempty"` + // Maximum accumulated active execution time in seconds. + TimeoutSeconds *float64 `json:"timeoutSeconds,omitempty"` } -// Optional session context used when creating a local workspace. -// Experimental: WorkspacesEnsureRequest is part of an experimental API and may change or be +// Parameters sent to the owning extension to execute a workflow closure. +// Experimental: WorkflowExecuteRequest is part of an experimental API and may change or be // removed. -type WorkspacesEnsureRequest struct { - // Opaque workspace context supplied by the session host. - Context any `json:"context,omitempty"` +type WorkflowExecuteRequest struct { + // Workflow input value. + Args any `json:"args"` + // Opaque token identifying this workflow execution attempt. + ExecutionToken string `json:"executionToken"` + // Registered workflow name. + Name string `json:"name"` + // Workflow run identifier. + RunID string `json:"runId"` + // Target session identifier + SessionID string `json:"sessionId"` } -// Current workspace metadata for the session, including its absolute filesystem path when -// available. -// Experimental: WorkspacesGetWorkspaceResult is part of an experimental API and may change -// or be removed. -type WorkspacesGetWorkspaceResult struct { - // Absolute filesystem path to the workspace directory. Omitted when the session has no - // workspace (e.g. remote sessions). - Path *string `json:"path,omitempty"` - // Current workspace metadata, or null if not available - Workspace *WorkspacesGetWorkspaceResultWorkspace `json:"workspace"` +// Result returned by an extension workflow closure. +// Experimental: WorkflowExecuteResult is part of an experimental API and may change or be +// removed. +type WorkflowExecuteResult struct { + // Workflow result value. + Result any `json:"result,omitempty"` } -type WorkspacesGetWorkspaceResultWorkspace struct { - // Current Git branch. - Branch *string `json:"branch,omitempty"` - // Whether the per-session Chronicle upgrade prompt was dismissed for the workspace. - ChronicleSyncDismissed *bool `json:"chronicle_sync_dismissed,omitempty"` - // Name of the client that created the workspace. - ClientName *string `json:"client_name,omitempty"` - // Timestamp when the workspace was created. - CreatedAt *time.Time `json:"created_at,omitempty"` - // Current working directory associated with the workspace. - Cwd *string `json:"cwd,omitempty"` - // Git repository root associated with the workspace. - GitRoot *string `json:"git_root,omitempty"` - // Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration. - HostType *WorkspacesWorkspaceDetailsHostType `json:"host_type,omitempty"` - // Stable workspace identifier. - ID string `json:"id"` - // Most recent Mission Control event identifier observed for the workspace. - McLastEventID *string `json:"mc_last_event_id,omitempty"` - // Mission Control session identifier associated with the workspace. - McSessionID *string `json:"mc_session_id,omitempty"` - // Mission Control task identifier associated with the workspace. - McTaskID *string `json:"mc_task_id,omitempty"` - // Workspace display name. - Name *string `json:"name,omitempty"` - // Whether the workspace session can be steered remotely. - RemoteSteerable *bool `json:"remote_steerable,omitempty"` - // Repository identifier associated with the workspace. - Repository *string `json:"repository,omitempty"` - // Number of persisted summaries in the workspace. - SummaryCount *int64 `json:"summary_count,omitempty"` - // Timestamp when the workspace was last updated. - UpdatedAt *time.Time `json:"updated_at,omitempty"` - // Whether the workspace name was explicitly chosen by the user. - UserNamed *bool `json:"user_named,omitempty"` +// Parameters for paging workflow progress. +// Experimental: WorkflowGetRunProgressRequest is part of an experimental API and may change +// or be removed. +type WorkflowGetRunProgressRequest struct { + // Exclusive forward cursor. + AfterSeq *int64 `json:"afterSeq,omitempty"` + // Exclusive backward cursor. + BeforeSeq *int64 `json:"beforeSeq,omitempty"` + // Maximum records to return. Defaults to 200 and is capped at 500. + Limit *int32 `json:"limit,omitempty"` + // Optional phase identifier used to scope records and cursors. + PhaseID *string `json:"phaseId,omitempty"` + // Workflow run identifier. + RunID string `json:"runId"` } -// Workspace checkpoints in chronological order; empty when the workspace is not enabled. -// Experimental: WorkspacesListCheckpointsResult is part of an experimental API and may -// change or be removed. -type WorkspacesListCheckpointsResult struct { - // Workspace checkpoints in chronological order. Empty when workspace is not enabled. - Checkpoints []WorkspacesCheckpoints `json:"checkpoints"` +// Parameters for retrieving a workflow run. +// Experimental: WorkflowGetRunRequest is part of an experimental API and may change or be +// removed. +type WorkflowGetRunRequest struct { + // Workflow run identifier. + RunID string `json:"runId"` } -// Relative paths of files stored in the session workspace files directory. -// Experimental: WorkspacesListFilesResult is part of an experimental API and may change or +// Parameters for reading a workflow journal entry. +// Experimental: WorkflowJournalGetRequest is part of an experimental API and may change or // be removed. -type WorkspacesListFilesResult struct { - // Slash-separated relative file paths in the workspace files directory - Files []string `json:"files"` +type WorkflowJournalGetRequest struct { + // Opaque token identifying the current workflow execution attempt. + ExecutionToken string `json:"executionToken"` + // Namespaced journal key. + Key string `json:"key"` + // Workflow run identifier. + RunID string `json:"runId"` } -// Autopilot objective file content, or null when missing. -// Experimental: WorkspacesReadAutopilotObjectiveResult is part of an experimental API and -// may change or be removed. -type WorkspacesReadAutopilotObjectiveResult struct { - // Autopilot objective file content, or null when missing. - Content *string `json:"content"` +// Result of reading a workflow journal entry. +// Experimental: WorkflowJournalGetResult is part of an experimental API and may change or +// be removed. +type WorkflowJournalGetResult struct { + // Whether the journal contained the requested key. + Hit bool `json:"hit"` + // Cached JSON result. The hit field distinguishes a cached JSON null from a miss. + ResultJSON any `json:"resultJson,omitempty"` } -// Checkpoint number to read. -// Experimental: WorkspacesReadCheckpointRequest is part of an experimental API and may -// change or be removed. -type WorkspacesReadCheckpointRequest struct { - // Checkpoint number to read - Number int64 `json:"number"` +// Parameters for storing a workflow journal entry. +// Experimental: WorkflowJournalPutRequest is part of an experimental API and may change or +// be removed. +type WorkflowJournalPutRequest struct { + // Opaque token identifying the current workflow execution attempt. + ExecutionToken string `json:"executionToken"` + // Namespaced journal key. + Key string `json:"key"` + // JSON result to memoize. + ResultJSON any `json:"resultJson"` + // Workflow run identifier. + RunID string `json:"runId"` } -// Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing. -// Experimental: WorkspacesReadCheckpointResult is part of an experimental API and may -// change or be removed. -type WorkspacesReadCheckpointResult struct { - // Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing - Content *string `json:"content"` +// Parameters for paging workflow runs. +// Experimental: WorkflowListRunsRequest is part of an experimental API and may change or be +// removed. +type WorkflowListRunsRequest struct { + // Exclusive forward cursor. + AfterSeq *int64 `json:"afterSeq,omitempty"` + // Exclusive backward cursor. + BeforeSeq *int64 `json:"beforeSeq,omitempty"` + // Maximum terminal runs to return. Defaults to 200 and is capped at 500. + Limit *int32 `json:"limit,omitempty"` } -// Relative path of the workspace file to read. -// Experimental: WorkspacesReadFileRequest is part of an experimental API and may change or -// be removed. -type WorkspacesReadFileRequest struct { - // Slash-separated relative path within the workspace files directory - Path string `json:"path"` +// A page of workflow runs in durable creation order. +// Experimental: WorkflowListRunsResult is part of an experimental API and may change or be +// removed. +type WorkflowListRunsResult struct { + // Whether terminal runs newer than this page exist. + HasMoreNewer *bool `json:"hasMoreNewer,omitempty"` + // Newest terminal-run cursor in this page, or null when the terminal window is empty. + NewestSeq *int64 `json:"newestSeq,omitempty"` + // Oldest terminal-run cursor in this page, or null when the terminal window is empty. + OldestSeq *int64 `json:"oldestSeq,omitempty"` + // Number of terminal runs older than this page. + OmittedOlder *int64 `json:"omittedOlder,omitempty"` + // Workflow run summaries in durable creation order. + Runs []WorkflowRunSummary `json:"runs"` } -// Contents of the requested workspace file as a UTF-8 string. -// Experimental: WorkspacesReadFileResult is part of an experimental API and may change or -// be removed. -type WorkspacesReadFileResult struct { - // File content as a UTF-8 string - Content string `json:"content"` +// One ordered workflow progress line. +// Experimental: WorkflowLogLine is part of an experimental API and may change or be removed. +type WorkflowLogLine struct { + // Progress line kind. + Kind WorkflowLogLineKind `json:"kind"` + // Monotonic sequence number within the workflow run. + Seq int64 `json:"seq"` + // Progress text. + Text string `json:"text"` } -// File or directory to remove from the session workspace files directory. -// Experimental: WorkspacesRemovePathRequest is part of an experimental API and may change -// or be removed. -type WorkspacesRemovePathRequest struct { - // Whether a missing path should be treated as success. Defaults to false. - Force *bool `json:"force,omitempty"` - // Slash-separated relative path within the workspace files directory - Path string `json:"path"` - // Whether to remove directory contents recursively. Defaults to false. - Recursive *bool `json:"recursive,omitempty"` +// Parameters for recording workflow progress. +// Experimental: WorkflowLogRequest is part of an experimental API and may change or be +// removed. +type WorkflowLogRequest struct { + // Opaque token identifying the current workflow execution attempt. + ExecutionToken string `json:"executionToken"` + // Ordered progress lines to append. + Lines []WorkflowLogLine `json:"lines"` + // Workflow run identifier. + RunID string `json:"runId"` } -// Source and destination paths for a rename within the session workspace files directory. -// Experimental: WorkspacesRenamePathRequest is part of an experimental API and may change +// Parameters for an owned durable pause checkpoint. +// Experimental: WorkflowPauseCheckpointRequest is part of an experimental API and may +// change or be removed. +type WorkflowPauseCheckpointRequest struct { + // Opaque token identifying the execution attempt that reached the checkpoint. + ExecutionToken string `json:"executionToken"` + // Stable author-defined checkpoint key. + Key string `json:"key"` + // Workflow run identifier. + RunID string `json:"runId"` +} + +// Experimental: WorkflowPauseCheckpointResult is part of an experimental API and may change // or be removed. -type WorkspacesRenamePathRequest struct { - // Slash-separated destination path relative to the workspace files directory - Destination string `json:"destination"` - // Slash-separated source path relative to the workspace files directory - Source string `json:"source"` +type WorkflowPauseCheckpointResult struct { + // Whether this execution attempt must pause or may continue. + Action WorkflowPauseCheckpointAction `json:"action"` } -// Pasted content to save as a UTF-8 file in the session workspace. -// Experimental: WorkspacesSaveLargePasteRequest is part of an experimental API and may -// change or be removed. -type WorkspacesSaveLargePasteRequest struct { - // Pasted content to save as a UTF-8 file - Content string `json:"content"` +// Durable metadata describing who initiated a workflow pause. +// Experimental: WorkflowPauseInfo is part of an experimental API and may change or be +// removed. +type WorkflowPauseInfo interface { + workflowPauseInfo() + Type() WorkflowPauseInfoType } -// Descriptor for the saved paste file, or null when the workspace is unavailable. -// Experimental: WorkspacesSaveLargePasteResult is part of an experimental API and may -// change or be removed. -type WorkspacesSaveLargePasteResult struct { - // Saved-paste descriptor, or null when the workspace is unavailable (e.g. CCA runtime, - // non-infinite sessions, remote sessions) - Saved *WorkspacesSaveLargePasteResultSaved `json:"saved"` +type RawWorkflowPauseInfoData struct { + Discriminator WorkflowPauseInfoType + Raw json.RawMessage } -type WorkspacesSaveLargePasteResultSaved struct { - // Filename within the workspace files directory - Filename string `json:"filename"` - // Absolute filesystem path to the saved paste file - FilePath string `json:"filePath"` - // Size of the saved file in bytes - SizeBytes int64 `json:"sizeBytes"` +func (RawWorkflowPauseInfoData) workflowPauseInfo() {} +func (r RawWorkflowPauseInfoData) Type() WorkflowPauseInfoType { + return r.Discriminator } -// Relative path of the workspace file or directory to inspect. -// Experimental: WorkspacesStatFileRequest is part of an experimental API and may change or -// be removed. -type WorkspacesStatFileRequest struct { - // Slash-separated relative path within the workspace files directory - Path string `json:"path"` +type WorkflowPauseInfoCheckpoint struct { + // Stable author-defined checkpoint key that initiated the pause. + Key string `json:"key"` } -// Filesystem metadata for a path in the session workspace files directory. -// Experimental: WorkspacesStatFileResult is part of an experimental API and may change or -// be removed. -type WorkspacesStatFileResult struct { - // Creation time in Unix epoch milliseconds - BirthtimeMs float64 `json:"birthtimeMs"` - // Whether the path identifies a directory - IsDirectory bool `json:"isDirectory"` - // Whether the path identifies a regular file - IsFile bool `json:"isFile"` - // Last modification time in Unix epoch milliseconds - MtimeMs float64 `json:"mtimeMs"` - // Size in bytes - Size float64 `json:"size"` +func (WorkflowPauseInfoCheckpoint) workflowPauseInfo() {} +func (WorkflowPauseInfoCheckpoint) Type() WorkflowPauseInfoType { + return WorkflowPauseInfoTypeCheckpoint } -// Rollback point for local workspace summaries. -// Experimental: WorkspacesTruncateSummariesRequest is part of an experimental API and may -// change or be removed. -type WorkspacesTruncateSummariesRequest struct { - // Number of newest summaries to keep. - KeepCount int64 `json:"keepCount"` +type WorkflowPauseInfoUser struct { } -// Public-facing projection of workspace metadata for SDK / TUI consumers -// Experimental: WorkspaceSummary is part of an experimental API and may change or be +func (WorkflowPauseInfoUser) workflowPauseInfo() {} +func (WorkflowPauseInfoUser) Type() WorkflowPauseInfoType { + return WorkflowPauseInfoTypeUser +} + +// Parameters for pausing a running workflow. +// Experimental: WorkflowPauseRequest is part of an experimental API and may change or be // removed. -type WorkspaceSummary struct { - // Branch checked out at session start, if any - Branch *string `json:"branch,omitempty"` - // ISO 8601 timestamp when the workspace was created - CreatedAt *time.Time `json:"created_at,omitempty"` - // Current working directory at session start - Cwd *string `json:"cwd,omitempty"` - // Resolved git root for cwd, if any - GitRoot *string `json:"git_root,omitempty"` - // Repository host type, if known - HostType *WorkspaceSummaryHostType `json:"host_type,omitempty"` - // Workspace identifier (1:1 with sessionId) - ID string `json:"id"` - // Display name for the session, if set - Name *string `json:"name,omitempty"` - // Repository identifier in 'owner/repo' or 'org/project/repo' format, if any - Repository *string `json:"repository,omitempty"` - // ISO 8601 timestamp when the workspace was last updated - UpdatedAt *time.Time `json:"updated_at,omitempty"` - // Whether the display name was explicitly set by the user - UserNamed *bool `json:"user_named,omitempty"` +type WorkflowPauseRequest struct { + // Workflow run identifier. + RunID string `json:"runId"` } -// Workspace metadata fields to update. -// Experimental: WorkspacesUpdateMetadataRequest is part of an experimental API and may -// change or be removed. -type WorkspacesUpdateMetadataRequest struct { - // Opaque workspace context supplied by the session host. - Context any `json:"context,omitempty"` - // Optional workspace display name override. - Name *string `json:"name,omitempty"` +// Durable lifecycle and timing for one workflow phase. +// Experimental: WorkflowPhaseObservation is part of an experimental API and may change or +// be removed. +type WorkflowPhaseObservation struct { + // Completed active time accumulated by this phase in milliseconds. + AccumulatedActiveMs int64 `json:"accumulatedActiveMs"` + // Epoch milliseconds when this phase completed; for a skipped phase, the synthetic skip + // timestamp (equal to `startedAt`). + CompletedAt *int64 `json:"completedAt,omitempty"` + // Current live active time for this phase in milliseconds. + CurrentActiveMs int64 `json:"currentActiveMs"` + // Optional human-readable phase detail. + Detail *string `json:"detail,omitempty"` + // Number of times execution entered this phase. + EntryCount int64 `json:"entryCount"` + // Phase identifier. + ID string `json:"id"` + // Most recent run attempt that entered this phase, or `0` if the phase has never been + // entered. + LastEnteredRunAttempt int64 `json:"lastEnteredRunAttempt"` + // Direct agents in this phase that are currently live. + LiveAgentCount int64 `json:"liveAgentCount"` + // Zero-based declared phase ordinal, or null for an undeclared phase. + Ordinal *int64 `json:"ordinal"` + // Epoch milliseconds when this phase first started; for a skipped phase, the synthetic skip + // timestamp (equal to `completedAt`). + StartedAt *int64 `json:"startedAt,omitempty"` + // Derived lifecycle state of the phase. + Status WorkflowPhaseStatus `json:"status"` + // Human-readable phase title. + Title string `json:"title"` + // Total direct agents associated with this phase. + TotalAgentCount int64 `json:"totalAgentCount"` } -// Autopilot objective file content to persist. -// Experimental: WorkspacesWriteAutopilotObjectiveRequest is part of an experimental API and -// may change or be removed. -type WorkspacesWriteAutopilotObjectiveRequest struct { - // Autopilot objective file content. - Content string `json:"content"` +// One durable workflow progress record. +// Experimental: WorkflowProgressLine is part of an experimental API and may change or be +// removed. +type WorkflowProgressLine struct { + // Resume attempt that emitted this record. + Attempt int64 `json:"attempt"` + // Progress record kind. + Kind WorkflowLogLineKind `json:"kind"` + // Phase active when the record was emitted, or null before any phase. + PhaseID *string `json:"phaseId"` + // Epoch milliseconds when the record was persisted. + RecordedAt int64 `json:"recordedAt"` + // Global monotonic sequence number within the run. + Seq int64 `json:"seq"` + // Prompt-safe progress text. + Text string `json:"text"` } -// Result of writing the autopilot objective file. -// Experimental: WorkspacesWriteAutopilotObjectiveResult is part of an experimental API and -// may change or be removed. -type WorkspacesWriteAutopilotObjectiveResult struct { - // Filesystem operation performed. - Operation string `json:"operation"` +// A bidirectional page of workflow progress. +// Experimental: WorkflowProgressPage is part of an experimental API and may change or be +// removed. +type WorkflowProgressPage struct { + // Whether progress records newer than this page exist. + HasMoreNewer bool `json:"hasMoreNewer"` + // Whether progress records older than this page exist. + HasMoreOlder bool `json:"hasMoreOlder"` + // Newest sequence number in this page, or null when empty. + NewestSeq *int64 `json:"newestSeq"` + // Oldest sequence number in this page, or null when empty. + OldestSeq *int64 `json:"oldestSeq"` + // Progress records in sequence order. + Records []WorkflowProgressLine `json:"records"` + // Run revision reflected by this page. + Revision int64 `json:"revision"` } -// Finite reason code describing why the current turn was aborted -// Experimental: AbortReason is part of an experimental API and may change or be removed. -type AbortReason string +// Parameters for resuming a workflow run from its persisted identity. +// Experimental: WorkflowResumeRequest is part of an experimental API and may change or be +// removed. +type WorkflowResumeRequest struct { + // Optional per-invocation resource ceiling overrides. + Limits *WorkflowRunLimits `json:"limits,omitempty"` + // Whether to emit workflow phase names to the session transcript. + LogPhaseNames *bool `json:"logPhaseNames,omitempty"` + // Whether to notify the originating session when the workflow completes. + NotifyOnComplete *bool `json:"notifyOnComplete,omitempty"` + // Workflow run identifier. + RunID string `json:"runId"` +} -const ( - // Autopilot stopped the run because the active objective reached its user-set - // --max-ai-credits limit. - AbortReasonAutopilotCreditLimit AbortReason = "autopilot_credit_limit" - // A remote command requested the abort. - AbortReasonRemoteCommand AbortReason = "remote_command" - // An MCP server delivered a user.abort notification. - AbortReasonUserAbort AbortReason = "user_abort" - // The local user requested the abort, for example by pressing Ctrl+C in the CLI. - AbortReasonUserInitiated AbortReason = "user_initiated" -) +// Resolved persisted workflow identity and resumed run envelope. +// Experimental: WorkflowResumeResult is part of an experimental API and may change or be +// removed. +type WorkflowResumeResult struct { + // Terminal resumed run envelope. + Run WorkflowRunResult `json:"run"` + // Persisted workflow name resolved for the resumed run. + WorkflowName string `json:"workflowName"` +} -// Resolved Anthropic adaptive-thinking capability for a model. -// Experimental: AdaptiveThinkingSupport is part of an experimental API and may change or be +// Durable workflow resource consumption. +// Experimental: WorkflowRunConsumed is part of an experimental API and may change or be // removed. -type AdaptiveThinkingSupport string +type WorkflowRunConsumed struct { + // Accumulated active execution time in milliseconds. + ActiveMs int64 `json:"activeMs"` + // AI usage consumed by the run in nano-AIU. + NanoAiu int64 `json:"nanoAiu"` + // Total subagents spawned by the run. + Subagents int64 `json:"subagents"` +} -const ( - // The model accepts only thinking.type='adaptive'; 'enabled', 'disabled', and an omitted - // thinking block all fail with HTTP 400 (e.g. fable, mythos) - AdaptiveThinkingSupportAdaptiveOnly AdaptiveThinkingSupport = "adaptive_only" - // The model accepts adaptive thinking but also accepts thinking.type='enabled' - AdaptiveThinkingSupportOptional AdaptiveThinkingSupport = "optional" - // The model defaults to adaptive thinking and rejects thinking.type='enabled' with HTTP - // 400, but still accepts thinking.type='disabled' (e.g. opus-4.7/4.8/5, sonnet-5) - AdaptiveThinkingSupportRequired AdaptiveThinkingSupport = "required" - // The model does not accept thinking.type='adaptive' - AdaptiveThinkingSupportUnsupported AdaptiveThinkingSupport = "unsupported" -) +// Full workflow run observability detail. +// Experimental: WorkflowRunDetail is part of an experimental API and may change or be +// removed. +type WorkflowRunDetail struct { + // Epoch milliseconds when the current active segment started, or null while inactive. + ActiveSegmentStartedAt *int64 `json:"activeSegmentStartedAt"` + // Durable identities and live statuses for direct workflow agents. + Agents []WorkflowAgentSummary `json:"agents"` + // Approved effective resource ceilings, or null until approved. + Approved *WorkflowDeclaredLimits `json:"approved"` + // Whether the durable run state currently passes runtime resume eligibility checks. + CanResume bool `json:"canResume"` + // Epoch milliseconds when the run completed, or null while nonterminal. + CompletedAt *int64 `json:"completedAt"` + // Durable resource consumption. + Consumed WorkflowRunConsumed `json:"consumed"` + // Epoch milliseconds when the run was created. + CreatedAt int64 `json:"createdAt"` + // Current phase identity, or null before any phase is entered. + CurrentPhase *WorkflowCurrentPhase `json:"currentPhase"` + // Resource ceilings declared by the workflow. + DeclaredLimits WorkflowDeclaredLimits `json:"declaredLimits"` + // Number of phases declared by the workflow. + DeclaredPhaseCount int64 `json:"declaredPhaseCount"` + // Human-readable workflow description. + Description string `json:"description"` + // Number of direct workflow agents currently live. + LiveAgentCount int64 `json:"liveAgentCount"` + // Epoch milliseconds when this live-overlay snapshot was observed. + ObservedAt int64 `json:"observedAt"` + // Lifecycle and timing observations for each workflow phase. + Phases []WorkflowPhaseObservation `json:"phases"` + // Bidirectional page of durable workflow progress. + Progress WorkflowProgressPage `json:"progress"` + // Monotonic durable run revision. + Revision int64 `json:"revision"` + // Workflow run identifier. + RunID string `json:"runId"` + // Epoch milliseconds when execution first started, or null before start. + StartedAt *int64 `json:"startedAt"` + // Current workflow run status. + Status WorkflowRunStatus `json:"status"` + // Terminal run outcome, or null while nonterminal. + Terminal *WorkflowRunTerminal `json:"terminal"` + // Total direct workflow agents spawned across all attempts. + TotalSpawnedAgentCount int64 `json:"totalSpawnedAgentCount"` + // Epoch milliseconds when the durable run was last updated. + UpdatedAt int64 `json:"updatedAt"` + // Registered workflow name. + WorkflowName string `json:"workflowName"` +} -// Which tier this directory belongs to -// Experimental: AgentDiscoveryPathScope is part of an experimental API and may change or be +// Machine-readable workflow run failure. +// Experimental: WorkflowRunFailure is part of an experimental API and may change or be // removed. -type AgentDiscoveryPathScope string +type WorkflowRunFailure interface { + workflowRunFailure() + Type() WorkflowRunFailureType +} -const ( - // A project's repository agent directory. - AgentDiscoveryPathScopeProject AgentDiscoveryPathScope = "project" - // The user's personal agent configuration directory. - AgentDiscoveryPathScopeUser AgentDiscoveryPathScope = "user" -) +type RawWorkflowRunFailureData struct { + Discriminator WorkflowRunFailureType + Raw json.RawMessage +} -// Where the agent definition was loaded from -// Experimental: AgentInfoSource is part of an experimental API and may change or be removed. -type AgentInfoSource string - -const ( - // Agent built into the Copilot runtime. - AgentInfoSourceBuiltin AgentInfoSource = "builtin" - // Agent inherited from a parent project or workspace. - AgentInfoSourceInherited AgentInfoSource = "inherited" - // Agent contributed by an installed plugin. - AgentInfoSourcePlugin AgentInfoSource = "plugin" - // Agent loaded from the current project's repository configuration. - AgentInfoSourceProject AgentInfoSource = "project" - // Agent provided by a remote runtime or service. - AgentInfoSourceRemote AgentInfoSource = "remote" - // Agent loaded from the user's personal agent configuration. - AgentInfoSourceUser AgentInfoSource = "user" -) +func (RawWorkflowRunFailureData) workflowRunFailure() {} +func (r RawWorkflowRunFailureData) Type() WorkflowRunFailureType { + return r.Discriminator +} -// Whether configured models are advisory preferences or required constraints -// Experimental: AgentModelPolicy is part of an experimental API and may change or be -// removed. -type AgentModelPolicy string +// The run stopped because its usage accounting could not be completed. +type WorkflowRunFailureWorkflowAccountingIncomplete struct { + // Confirmed usage in nano-AIU, representing the floor of what the run spent. + DrainedNanoAiu int64 `json:"drainedNanoAiu"` + // Workflow run identifier. + RunID string `json:"runId"` +} -const ( - // Treat the authored models as advisory preferences that callers may override. - AgentModelPolicyPreferred AgentModelPolicy = "preferred" - // Require subagent execution to use one of the authored models. - AgentModelPolicyRequired AgentModelPolicy = "required" -) +func (WorkflowRunFailureWorkflowAccountingIncomplete) workflowRunFailure() {} +func (WorkflowRunFailureWorkflowAccountingIncomplete) Type() WorkflowRunFailureType { + return WorkflowRunFailureTypeWorkflowAccountingIncomplete +} -// Kind of attention required when status === "attention". Meaningful only when status === -// "attention". -// Experimental: AgentRegistryLiveTargetEntryAttentionKind is part of an experimental API -// and may change or be removed. -type AgentRegistryLiveTargetEntryAttentionKind string +type WorkflowRunFailureWorkflowDurableFailure struct { + // Stable failure code. + Code string `json:"code"` + // Execution-critical durable operation that failed. + Operation WorkflowDurableOperation `json:"operation"` + // Workflow run identifier. + RunID string `json:"runId"` +} -const ( - // Session is waiting on an elicitation prompt - AgentRegistryLiveTargetEntryAttentionKindElicitation AgentRegistryLiveTargetEntryAttentionKind = "elicitation" - // Session is blocked on an unrecoverable error - AgentRegistryLiveTargetEntryAttentionKindError AgentRegistryLiveTargetEntryAttentionKind = "error" - // Session is waiting for the user to approve or reject a plan - AgentRegistryLiveTargetEntryAttentionKindExitPlan AgentRegistryLiveTargetEntryAttentionKind = "exit_plan" - // Session is waiting for a tool-permission decision - AgentRegistryLiveTargetEntryAttentionKindPermission AgentRegistryLiveTargetEntryAttentionKind = "permission" - // Session is waiting for free-form user input - AgentRegistryLiveTargetEntryAttentionKindUserInput AgentRegistryLiveTargetEntryAttentionKind = "user_input" -) +func (WorkflowRunFailureWorkflowDurableFailure) workflowRunFailure() {} +func (WorkflowRunFailureWorkflowDurableFailure) Type() WorkflowRunFailureType { + return WorkflowRunFailureTypeWorkflowDurableFailure +} -// Process kind tag for the registry entry -// Experimental: AgentRegistryLiveTargetEntryKind is part of an experimental API and may -// change or be removed. -type AgentRegistryLiveTargetEntryKind string +type WorkflowRunFailureWorkflowLimitReached struct { + // Resource ceiling that stopped the run. + Kind WorkflowRunFailureKind `json:"kind"` + // Workflow run identifier. + RunID string `json:"runId"` + // Suggested larger ceiling when the runtime can derive one safely. + SuggestedValue *float64 `json:"suggestedValue,omitempty"` + // Approved effective ceiling that was reached. + Value float64 `json:"value"` +} -const ( - // Headless `--server --managed-server` child spawned by a controller - AgentRegistryLiveTargetEntryKindManagedServer AgentRegistryLiveTargetEntryKind = "managed-server" - // Interactive Copilot CLI exposing a UI server (legacy/normal CLI process) - AgentRegistryLiveTargetEntryKindUIServer AgentRegistryLiveTargetEntryKind = "ui-server" -) +func (WorkflowRunFailureWorkflowLimitReached) workflowRunFailure() {} +func (WorkflowRunFailureWorkflowLimitReached) Type() WorkflowRunFailureType { + return WorkflowRunFailureTypeWorkflowLimitReached +} -// How the most recent turn ended (clean vs aborted). Lets the renderer distinguish done -// from done_cancelled. -// Experimental: AgentRegistryLiveTargetEntryLastTerminalEvent is part of an experimental -// API and may change or be removed. -type AgentRegistryLiveTargetEntryLastTerminalEvent string +// The extension that owns the workflow disconnected while the run was executing, so the +// host halted it. The run's journaled subagent results are preserved so a resume can reuse +// them. +type WorkflowRunFailureWorkflowProviderDisconnected struct { + // Workflow run identifier. + RunID string `json:"runId"` +} -const ( - // Last turn was aborted (e.g. user interrupted) - AgentRegistryLiveTargetEntryLastTerminalEventAbort AgentRegistryLiveTargetEntryLastTerminalEvent = "abort" - // Last turn ended cleanly (model returned a final assistant message) - AgentRegistryLiveTargetEntryLastTerminalEventTurnEnd AgentRegistryLiveTargetEntryLastTerminalEvent = "turn_end" -) +func (WorkflowRunFailureWorkflowProviderDisconnected) workflowRunFailure() {} +func (WorkflowRunFailureWorkflowProviderDisconnected) Type() WorkflowRunFailureType { + return WorkflowRunFailureTypeWorkflowProviderDisconnected +} -// Coarse lifecycle status of the foreground session -// Experimental: AgentRegistryLiveTargetEntryStatus is part of an experimental API and may -// change or be removed. -type AgentRegistryLiveTargetEntryStatus string +type WorkflowRunFailureWorkflowResumeDeclined struct { + // Human-readable reason the resume did not proceed. + Reason string `json:"reason"` + // Workflow run identifier whose changed limits were declined. + RunID string `json:"runId"` +} -const ( - // Session needs user attention (see attentionKind for the specific reason) - AgentRegistryLiveTargetEntryStatusAttention AgentRegistryLiveTargetEntryStatus = "attention" - // Last turn completed successfully - AgentRegistryLiveTargetEntryStatusDone AgentRegistryLiveTargetEntryStatus = "done" - // Session is idle, waiting for input - AgentRegistryLiveTargetEntryStatusWaiting AgentRegistryLiveTargetEntryStatus = "waiting" - // Session is actively processing a turn - AgentRegistryLiveTargetEntryStatusWorking AgentRegistryLiveTargetEntryStatus = "working" -) +func (WorkflowRunFailureWorkflowResumeDeclined) workflowRunFailure() {} +func (WorkflowRunFailureWorkflowResumeDeclined) Type() WorkflowRunFailureType { + return WorkflowRunFailureTypeWorkflowResumeDeclined +} -// Categorized reason for log-open failure -// Experimental: AgentRegistryLogCaptureOpenErrorReason is part of an experimental API and -// may change or be removed. -type AgentRegistryLogCaptureOpenErrorReason string +// Wire-only per-invocation workflow resource ceiling overrides. +// Experimental: WorkflowRunLimits is part of an experimental API and may change or be +// removed. +type WorkflowRunLimits struct { + // Maximum AI credits consumed by workflow subagents and their descendants. The post-paid + // ceiling is soft: parallel turns can settle beyond it before the run stops. + MaxAiCredits *float64 `json:"maxAiCredits,omitempty"` + // Maximum number of workflow subagents that may run concurrently. + MaxConcurrentSubagents *int64 `json:"maxConcurrentSubagents,omitempty"` + // Maximum total number of workflow subagents that may be admitted. + MaxTotalSubagents *int64 `json:"maxTotalSubagents,omitempty"` + // Maximum accumulated active-execution time in seconds. Active execution includes the + // entire extension body, subprocess waits, queued-agent waits, and sleeps; time between + // resumed attempts is not counted. + TimeoutSeconds *float64 `json:"timeoutSeconds,omitempty"` +} -const ( - // No space left on device - AgentRegistryLogCaptureOpenErrorReasonDiskFull AgentRegistryLogCaptureOpenErrorReason = "disk_full" - // Other / uncategorized open failure - AgentRegistryLogCaptureOpenErrorReasonOther AgentRegistryLogCaptureOpenErrorReason = "other" - // Filesystem permission denied opening the log file - AgentRegistryLogCaptureOpenErrorReasonPermission AgentRegistryLogCaptureOpenErrorReason = "permission" -) +// Options controlling workflow invocation. +// Experimental: WorkflowRunOptions is part of an experimental API and may change or be +// removed. +type WorkflowRunOptions struct { + // Per-invocation resource ceiling overrides. + Limits *WorkflowRunLimits `json:"limits,omitempty"` + // Whether to emit workflow phase names to the session transcript. + LogPhaseNames *bool `json:"logPhaseNames,omitempty"` + // Whether to notify the originating session when the workflow completes. + NotifyOnComplete *bool `json:"notifyOnComplete,omitempty"` + // Run identifier whose journal and progress should seed this resumed run. + ResumeFromRunID *string `json:"resumeFromRunId,omitempty"` +} -// Permission posture for the new session. 'yolo' requires the controller-local session to -// currently be in allow-all mode. -// Experimental: AgentRegistrySpawnPermissionMode is part of an experimental API and may -// change or be removed. -type AgentRegistrySpawnPermissionMode string +// Parameters for invoking a registered workflow. +// Experimental: WorkflowRunRequest is part of an experimental API and may change or be +// removed. +type WorkflowRunRequest struct { + // Workflow input value. + Args any `json:"args"` + // Registered workflow name. + Name string `json:"name"` + // Workflow invocation options. + Options *WorkflowRunOptions `json:"options,omitempty"` +} -const ( - // Standard permission posture (prompts for each request) - AgentRegistrySpawnPermissionModeDefault AgentRegistrySpawnPermissionMode = "default" - // Full allow-all (requires the controller-local session to currently be in allow-all mode) - AgentRegistrySpawnPermissionModeYolo AgentRegistrySpawnPermissionMode = "yolo" -) +// Complete current or terminal workflow run envelope. +// Experimental: WorkflowRunResult is part of an experimental API and may change or be +// removed. +type WorkflowRunResult struct { + // One-based execution attempt represented by this envelope. Absent before the first attempt + // starts or when returned by an older runtime. + Attempt *int64 `json:"attempt,omitempty"` + // Error message for an errored run. + Error *string `json:"error,omitempty"` + // Machine-readable failure details for a halted or errored run. + Failure WorkflowRunFailure `json:"failure,omitempty"` + // Structured pause initiator metadata for a paused attempt. + PauseInfo WorkflowPauseInfo `json:"pauseInfo,omitempty"` + // Reason for a halted or cancelled run. + Reason *string `json:"reason,omitempty"` + // Completed workflow result. + Result any `json:"result,omitempty"` + // Workflow run identifier. + RunID string `json:"runId"` + // Partial journal and progress snapshot for a halted, cancelled, or errored run. + Snapshot any `json:"snapshot,omitempty"` + // Current or terminal workflow run status. + Status WorkflowRunStatus `json:"status"` +} -// Kind discriminator for AgentRegistrySpawnResult. -type AgentRegistrySpawnResultKind string +// Durable workflow run summary with read-time live overlays. +// Experimental: WorkflowRunSummary is part of an experimental API and may change or be +// removed. +type WorkflowRunSummary struct { + // Epoch milliseconds when the current active segment started, or null while inactive. + ActiveSegmentStartedAt *int64 `json:"activeSegmentStartedAt"` + // Approved effective resource ceilings, or null until approved. + Approved *WorkflowDeclaredLimits `json:"approved"` + // Whether the durable run state currently passes runtime resume eligibility checks. + CanResume bool `json:"canResume"` + // Epoch milliseconds when the run completed, or null while nonterminal. + CompletedAt *int64 `json:"completedAt"` + // Durable resource consumption. + Consumed WorkflowRunConsumed `json:"consumed"` + // Epoch milliseconds when the run was created. + CreatedAt int64 `json:"createdAt"` + // Current phase identity, or null before any phase is entered. + CurrentPhase *WorkflowCurrentPhase `json:"currentPhase"` + // Resource ceilings declared by the workflow. + DeclaredLimits WorkflowDeclaredLimits `json:"declaredLimits"` + // Number of phases declared by the workflow. + DeclaredPhaseCount int64 `json:"declaredPhaseCount"` + // Human-readable workflow description. + Description string `json:"description"` + // Number of direct workflow agents currently live. + LiveAgentCount int64 `json:"liveAgentCount"` + // Epoch milliseconds when this live-overlay snapshot was observed. + ObservedAt int64 `json:"observedAt"` + // Monotonic durable run revision. + Revision int64 `json:"revision"` + // Workflow run identifier. + RunID string `json:"runId"` + // Epoch milliseconds when execution first started, or null before start. + StartedAt *int64 `json:"startedAt"` + // Current workflow run status. + Status WorkflowRunStatus `json:"status"` + // Terminal run outcome, or null while nonterminal. + Terminal *WorkflowRunTerminal `json:"terminal"` + // Total direct workflow agents spawned across all attempts. + TotalSpawnedAgentCount int64 `json:"totalSpawnedAgentCount"` + // Epoch milliseconds when the durable run was last updated. + UpdatedAt int64 `json:"updatedAt"` + // Registered workflow name. + WorkflowName string `json:"workflowName"` +} -const ( - AgentRegistrySpawnResultKindRegistryTimeout AgentRegistrySpawnResultKind = "registry-timeout" - AgentRegistrySpawnResultKindSpawned AgentRegistrySpawnResultKind = "spawned" - AgentRegistrySpawnResultKindSpawnError AgentRegistrySpawnResultKind = "spawn-error" - AgentRegistrySpawnResultKindValidationError AgentRegistrySpawnResultKind = "validation-error" -) +// Prompt-safe terminal workflow outcome. +// Experimental: WorkflowRunTerminal is part of an experimental API and may change or be +// removed. +type WorkflowRunTerminal struct { + // Human-readable terminal error. + Error *string `json:"error,omitempty"` + // Machine-readable terminal failure. + Failure WorkflowRunFailure `json:"failure,omitempty"` + // Pause initiator metadata, or null when the run did not pause. + PauseInfo WorkflowPauseInfo `json:"pauseInfo"` + // Human-readable terminal reason. + Reason *string `json:"reason,omitempty"` + // Prompt-safe preview of the completed result. + ResultPreview *string `json:"resultPreview,omitempty"` +} -// Which parameter field was invalid. Omitted when the rejection is not field-specific. -// Experimental: AgentRegistrySpawnValidationErrorField is part of an experimental API and -// may change or be removed. -type AgentRegistrySpawnValidationErrorField string +// Internal parameters for resuming a workflow run from a tool. +// Experimental: WorkflowToolResumeRequest is part of an experimental API and may change or +// be removed. +// Internal: WorkflowToolResumeRequest is an internal SDK API and is not part of the public +// surface. +type WorkflowToolResumeRequest struct { + // Optional per-invocation resource ceiling overrides. + Limits *WorkflowRunLimits `json:"limits,omitempty"` + // Workflow run identifier. + RunID string `json:"runId"` + // Opaque identifier of the originating tool call. + ToolCallID *string `json:"toolCallId,omitempty"` +} -const ( - // The agentName parameter - AgentRegistrySpawnValidationErrorFieldAgentName AgentRegistrySpawnValidationErrorField = "agentName" - // The cwd parameter - AgentRegistrySpawnValidationErrorFieldCwd AgentRegistrySpawnValidationErrorField = "cwd" - // The model parameter - AgentRegistrySpawnValidationErrorFieldModel AgentRegistrySpawnValidationErrorField = "model" - // The session name parameter - AgentRegistrySpawnValidationErrorFieldName AgentRegistrySpawnValidationErrorField = "name" - // The permissionMode parameter - AgentRegistrySpawnValidationErrorFieldPermissionMode AgentRegistrySpawnValidationErrorField = "permissionMode" -) +// Options for an internal tool-originated workflow invocation. +// Experimental: WorkflowToolRunOptions is part of an experimental API and may change or be +// removed. +// Internal: WorkflowToolRunOptions is an internal SDK API and is not part of the public +// surface. +type WorkflowToolRunOptions struct { + // Per-invocation resource ceiling overrides. + Limits *WorkflowRunLimits `json:"limits,omitempty"` + // Run identifier whose journal and progress should seed this resumed run. + ResumeFromRunID *string `json:"resumeFromRunId,omitempty"` +} -// Categorized reason for the rejection. Low-cardinality enum so telemetry can aggregate by -// reason without leaking raw paths or agent/model names. -// Experimental: AgentRegistrySpawnValidationErrorReason is part of an experimental API and -// may change or be removed. -type AgentRegistrySpawnValidationErrorReason string +// Internal parameters for invoking a registered workflow from a tool. +// Experimental: WorkflowToolRunRequest is part of an experimental API and may change or be +// removed. +// Internal: WorkflowToolRunRequest is an internal SDK API and is not part of the public +// surface. +type WorkflowToolRunRequest struct { + // Workflow input value. + Args any `json:"args"` + // Registered workflow name. + Name string `json:"name"` + // Tool-originated workflow invocation options. + Options *WorkflowToolRunOptions `json:"options,omitempty"` + // Opaque identifier of the originating tool call. + ToolCallID *string `json:"toolCallId,omitempty"` +} -const ( - // Provided cwd exists but is not a directory - AgentRegistrySpawnValidationErrorReasonCwdNotDirectory AgentRegistrySpawnValidationErrorReason = "cwd-not-directory" - // Provided cwd does not exist on disk - AgentRegistrySpawnValidationErrorReasonCwdNotFound AgentRegistrySpawnValidationErrorReason = "cwd-not-found" - // Session name failed validateSessionName - AgentRegistrySpawnValidationErrorReasonInvalidName AgentRegistrySpawnValidationErrorReason = "invalid-name" - // Requested agent name was not found in builtin or custom agents - AgentRegistrySpawnValidationErrorReasonUnknownAgent AgentRegistrySpawnValidationErrorReason = "unknown-agent" - // Requested model is not available to this session - AgentRegistrySpawnValidationErrorReasonUnknownModel AgentRegistrySpawnValidationErrorReason = "unknown-model" - // Caller asked for permissionMode='yolo' but the controller is not currently in allow-all - // mode - AgentRegistrySpawnValidationErrorReasonYoloNotAllowed AgentRegistrySpawnValidationErrorReason = "yolo-not-allowed" -) - -// Type of GitHub reference -// Experimental: AttachmentGitHubReferenceType is part of an experimental API and may change -// or be removed. -type AttachmentGitHubReferenceType string - -const ( - // GitHub discussion reference. - AttachmentGitHubReferenceTypeDiscussion AttachmentGitHubReferenceType = "discussion" - // GitHub issue reference. - AttachmentGitHubReferenceTypeIssue AttachmentGitHubReferenceType = "issue" - // GitHub pull request reference. - AttachmentGitHubReferenceTypePr AttachmentGitHubReferenceType = "pr" -) - -// Type discriminator for Attachment. -type AttachmentType string - -const ( - AttachmentTypeBlob AttachmentType = "blob" - AttachmentTypeDirectory AttachmentType = "directory" - AttachmentTypeExtensionContext AttachmentType = "extension_context" - AttachmentTypeFile AttachmentType = "file" - AttachmentTypeGitHubActionsJob AttachmentType = "github_actions_job" - AttachmentTypeGitHubCommit AttachmentType = "github_commit" - AttachmentTypeGitHubFile AttachmentType = "github_file" - AttachmentTypeGitHubFileDiff AttachmentType = "github_file_diff" - AttachmentTypeGitHubReference AttachmentType = "github_reference" - AttachmentTypeGitHubRelease AttachmentType = "github_release" - AttachmentTypeGitHubRepository AttachmentType = "github_repository" - AttachmentTypeGitHubSnippet AttachmentType = "github_snippet" - AttachmentTypeGitHubTreeComparison AttachmentType = "github_tree_comparison" - AttachmentTypeGitHubURL AttachmentType = "github_url" - AttachmentTypeSelection AttachmentType = "selection" -) - -// Type discriminator for AuthInfo. -// Experimental: AuthInfoType is part of an experimental API and may change or be removed. -type AuthInfoType string - -const ( - AuthInfoTypeAPIKey AuthInfoType = "api-key" - AuthInfoTypeCopilotAPIToken AuthInfoType = "copilot-api-token" - AuthInfoTypeEnv AuthInfoType = "env" - AuthInfoTypeGhCLI AuthInfoType = "gh-cli" - AuthInfoTypeHMAC AuthInfoType = "hmac" - AuthInfoTypeToken AuthInfoType = "token" - AuthInfoTypeTokenProvider AuthInfoType = "token-provider" - AuthInfoTypeUser AuthInfoType = "user" -) - -// Current normalized autopilot objective lifecycle status. -// Experimental: AutopilotObjectiveStatus is part of an experimental API and may change or -// be removed. -type AutopilotObjectiveStatus string - -const ( - // The objective is actively running. - AutopilotObjectiveStatusActive AutopilotObjectiveStatus = "active" - // The objective completed. - AutopilotObjectiveStatusCompleted AutopilotObjectiveStatus = "completed" - // The objective is paused and may be resumed. - AutopilotObjectiveStatusPaused AutopilotObjectiveStatus = "paused" -) - -// Routing preference used when the session model is `auto`. `fast` is an integrator-only -// latency preset and is not a first-party GitHub Copilot product preference. -// Experimental: AutoTier is part of an experimental API and may change or be removed. -type AutoTier string - -const ( - // Balance efficiency and intelligence. - AutoTierBalance AutoTier = "balance" - // Optimize for efficiency. - AutoTierEfficiency AutoTier = "efficiency" - // Integrator-only preset that optimizes for latency. - AutoTierFast AutoTier = "fast" - // Optimize for intelligence. - AutoTierIntelligence AutoTier = "intelligence" -) +// A single changed file and its unified diff. +// Experimental: WorkspaceDiffFileChange is part of an experimental API and may change or be +// removed. +type WorkspaceDiffFileChange struct { + // Type of change represented by this file diff. + ChangeType WorkspaceDiffFileChangeType `json:"changeType"` + // Unified diff content for the file. Empty when the diff was truncated. + Diff string `json:"diff"` + // Whether the diff content was omitted because it exceeded the per-file size limit. + IsTruncated *bool `json:"isTruncated,omitempty"` + // Original file path for renamed files. + OldPath *string `json:"oldPath,omitempty"` + // Path to the changed file, relative to the workspace root when the file lives under it. A + // file changed outside the workspace root keeps a `../`-relative path, or an absolute path + // when no relative path exists (for example a different Windows drive). + Path string `json:"path"` +} -// Custom input-format kind. -// Experimental: BuiltinToolFormatType is part of an experimental API and may change or be +// Workspace diff result for the requested mode. +// Experimental: WorkspaceDiffResult is part of an experimental API and may change or be // removed. -type BuiltinToolFormatType string +type WorkspaceDiffResult struct { + // Default branch used for a branch diff, when branch mode was requested. + BaseBranch *string `json:"baseBranch,omitempty"` + // Changed files and their unified diffs. + Changes []WorkspaceDiffFileChange `json:"changes"` + // Whether the requested diff fell back to unstaged changes, either because branch diff + // failed or session diff was unavailable. + IsFallback bool `json:"isFallback"` + // Effective mode used for the returned changes. + Mode WorkspaceDiffMode `json:"mode"` + // Diff mode requested by the client. + RequestedMode WorkspaceDiffMode `json:"requestedMode"` + // Why the session diff could not be produced, when applicable. Set only when `session` mode + // was requested and `isFallback` is true, so a client can tell the permanent + // `file-change-tracking-disabled` apart from the transient `session-busy`, which the same + // request answers once the session settles. Never set for `unstaged` or `branch` mode, and + // never `unsupported-remote-session`: a remote session's captures live on its own host, so + // a `session`-mode diff is rejected for one rather than answered with a controller-side + // fallback. + UnavailableReason *HistoryRewindUnavailableReason `json:"unavailableReason,omitempty"` +} -const ( - // The tool input is parsed with the supplied grammar. - BuiltinToolFormatTypeGrammar BuiltinToolFormatType = "grammar" -) +// Compaction summary checkpoint to persist. +// Experimental: WorkspacesAddSummaryRequest is part of an experimental API and may change +// or be removed. +type WorkspacesAddSummaryRequest struct { + // Markdown summary content to persist. + Content string `json:"content"` + // Summary title shown in checkpoint listings. + Title string `json:"title"` +} -// Root JSON Schema type for a built-in tool input. -// Experimental: BuiltinToolInputSchemaType is part of an experimental API and may change or +// Persisted summary metadata and refreshed workspace metadata. +// Experimental: WorkspacesAddSummaryResult is part of an experimental API and may change or // be removed. -type BuiltinToolInputSchemaType string +type WorkspacesAddSummaryResult struct { + // Metadata for the persisted summary. + Summary any `json:"summary,omitempty"` + // Refreshed metadata for the containing workspace. + Workspace any `json:"workspace,omitempty"` +} -const ( - // The tool accepts a JSON object. - BuiltinToolInputSchemaTypeObject BuiltinToolInputSchemaType = "object" -) +// Whether the autopilot objective file exists. +// Experimental: WorkspacesAutopilotObjectiveExistsResult is part of an experimental API and +// may change or be removed. +type WorkspacesAutopilotObjectiveExistsResult struct { + // True when the objective file exists. + Exists bool `json:"exists"` +} -// Canonical digest algorithm for a validated MCP card -// Experimental: CardDigestAlgorithm is part of an experimental API and may change or be +// Workspace checkpoint metadata with assigned number, human-readable title, and checkpoint +// filename. +// Experimental: WorkspacesCheckpoints is part of an experimental API and may change or be // removed. -type CardDigestAlgorithm string - -const ( - // SHA-256 over RFC 8785 canonical JSON encoded as UTF-8. - CardDigestAlgorithmSha256Rfc8785 CardDigestAlgorithm = "sha256-rfc8785" -) - -// AI skills are discovery-only and cannot be installed through this surface -type CatalogAiSkillCandidateInstallability string +type WorkspacesCheckpoints struct { + // Filename of the checkpoint within the workspace checkpoints directory + Filename string `json:"filename"` + // Checkpoint number assigned by the workspace manager + Number int64 `json:"number"` + // Human-readable checkpoint title + Title string `json:"title"` +} -const ( - CatalogAiSkillCandidateInstallabilityNotInstallableKind CatalogAiSkillCandidateInstallability = "not-installable-kind" -) +// Directory to create within the session workspace files directory. +// Experimental: WorkspacesCreateDirectoryRequest is part of an experimental API and may +// change or be removed. +type WorkspacesCreateDirectoryRequest struct { + // Slash-separated relative path within the workspace files directory + Path string `json:"path"` + // Whether to create missing parent directories. Defaults to false. + Recursive *bool `json:"recursive,omitempty"` +} -// Media type of the underlying AI skill card -type CatalogAiSkillCandidateMediaType string +// Relative path and UTF-8 content for the workspace file to create or overwrite. +// Experimental: WorkspacesCreateFileRequest is part of an experimental API and may change +// or be removed. +type WorkspacesCreateFileRequest struct { + // File content to write as a UTF-8 string + Content string `json:"content"` + // Slash-separated relative path within the workspace files directory + Path string `json:"path"` +} -const ( - CatalogAiSkillCandidateMediaTypeApplicationAiSkill CatalogAiSkillCandidateMediaType = "application/ai-skill" -) +// Result of deleting the autopilot objective file. +// Experimental: WorkspacesDeleteAutopilotObjectiveResult is part of an experimental API and +// may change or be removed. +type WorkspacesDeleteAutopilotObjectiveResult struct { + // True when a file was deleted. + Deleted bool `json:"deleted"` +} -// Media type advertised for the referenced AI skill card -type CatalogAiSkillCandidateProvenanceMediaType string +// Parameters for computing a workspace diff. +// Experimental: WorkspacesDiffRequest is part of an experimental API and may change or be +// removed. +type WorkspacesDiffRequest struct { + // When true, ignore whitespace-only changes (git `--ignore-all-space`). Defaults to false. + IgnoreWhitespace *bool `json:"ignoreWhitespace,omitempty"` + // Diff mode requested by the client. + Mode WorkspaceDiffMode `json:"mode"` +} -const ( - CatalogAiSkillCandidateProvenanceMediaTypeApplicationAiSkill CatalogAiSkillCandidateProvenanceMediaType = "application/ai-skill" -) +// Optional session context used when creating a local workspace. +// Experimental: WorkspacesEnsureRequest is part of an experimental API and may change or be +// removed. +type WorkspacesEnsureRequest struct { + // Opaque workspace context supplied by the session host. + Context any `json:"context,omitempty"` +} -// Why the catalog authority did not accept the caller's identity -// Experimental: CatalogAuthenticationRequiredReason is part of an experimental API and may -// change or be removed. -type CatalogAuthenticationRequiredReason string +// Current workspace metadata for the session, including its absolute filesystem path when +// available. +// Experimental: WorkspacesGetWorkspaceResult is part of an experimental API and may change +// or be removed. +type WorkspacesGetWorkspaceResult struct { + // Absolute filesystem path to the workspace directory. Omitted when the session has no + // workspace (e.g. remote sessions). + Path *string `json:"path,omitempty"` + // Current workspace metadata, or null if not available + Workspace *WorkspacesGetWorkspaceResultWorkspace `json:"workspace"` +} -const ( - // A credential was presented and its lifetime has elapsed. A silent refresh is worth - // attempting before prompting anyone. - CatalogAuthenticationRequiredReasonCredentialExpired CatalogAuthenticationRequiredReason = "credential-expired" - // A credential was presented and the authority refused it, for example because it was - // revoked, malformed, or issued for another audience. Refreshing the same rejected - // credential is not useful; the caller must sign in again. - CatalogAuthenticationRequiredReasonCredentialRejected CatalogAuthenticationRequiredReason = "credential-rejected" - // No credential was presented, so there is nothing to refresh and the caller must sign in. - CatalogAuthenticationRequiredReasonNoCredential CatalogAuthenticationRequiredReason = "no-credential" -) +type WorkspacesGetWorkspaceResultWorkspace struct { + // Current Git branch. + Branch *string `json:"branch,omitempty"` + // Whether the per-session Chronicle upgrade prompt was dismissed for the workspace. + ChronicleSyncDismissed *bool `json:"chronicle_sync_dismissed,omitempty"` + // Name of the client that created the workspace. + ClientName *string `json:"client_name,omitempty"` + // Timestamp when the workspace was created. + CreatedAt *time.Time `json:"created_at,omitempty"` + // Current working directory associated with the workspace. + Cwd *string `json:"cwd,omitempty"` + // Git repository root associated with the workspace. + GitRoot *string `json:"git_root,omitempty"` + // Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration. + HostType *WorkspacesWorkspaceDetailsHostType `json:"host_type,omitempty"` + // Stable workspace identifier. + ID string `json:"id"` + // Most recent Mission Control event identifier observed for the workspace. + McLastEventID *string `json:"mc_last_event_id,omitempty"` + // Mission Control session identifier associated with the workspace. + McSessionID *string `json:"mc_session_id,omitempty"` + // Mission Control task identifier associated with the workspace. + McTaskID *string `json:"mc_task_id,omitempty"` + // Workspace display name. + Name *string `json:"name,omitempty"` + // Whether the workspace session can be steered remotely. + RemoteSteerable *bool `json:"remote_steerable,omitempty"` + // Repository identifier associated with the workspace. + Repository *string `json:"repository,omitempty"` + // Number of persisted summaries in the workspace. + SummaryCount *int64 `json:"summary_count,omitempty"` + // Timestamp when the workspace was last updated. + UpdatedAt *time.Time `json:"updated_at,omitempty"` + // Whether the workspace name was explicitly chosen by the user. + UserNamed *bool `json:"user_named,omitempty"` +} -// Kind discriminator for CatalogCandidate. -// Experimental: CatalogCandidateKind is part of an experimental API and may change or be -// removed. -type CatalogCandidateKind string +// Workspace checkpoints in chronological order; empty when the workspace is not enabled. +// Experimental: WorkspacesListCheckpointsResult is part of an experimental API and may +// change or be removed. +type WorkspacesListCheckpointsResult struct { + // Workspace checkpoints in chronological order. Empty when workspace is not enabled. + Checkpoints []WorkspacesCheckpoints `json:"checkpoints"` +} -const ( - CatalogCandidateKindAiSkill CatalogCandidateKind = "ai-skill" - CatalogCandidateKindMCPServer CatalogCandidateKind = "mcp-server" -) +// Relative paths of files stored in the session workspace files directory. +// Experimental: WorkspacesListFilesResult is part of an experimental API and may change or +// be removed. +type WorkspacesListFilesResult struct { + // Slash-separated relative file paths in the workspace files directory + Files []string `json:"files"` +} -// Kind discriminator for CatalogCandidateSource. -type CatalogCandidateSourceKind string +// Autopilot objective file content, or null when missing. +// Experimental: WorkspacesReadAutopilotObjectiveResult is part of an experimental API and +// may change or be removed. +type WorkspacesReadAutopilotObjectiveResult struct { + // Autopilot objective file content, or null when missing. + Content *string `json:"content"` +} -const ( - CatalogCandidateSourceKindEmbedded CatalogCandidateSourceKind = "embedded" - CatalogCandidateSourceKindURL CatalogCandidateSourceKind = "url" -) +// Checkpoint number to read. +// Experimental: WorkspacesReadCheckpointRequest is part of an experimental API and may +// change or be removed. +type WorkspacesReadCheckpointRequest struct { + // Checkpoint number to read + Number int64 `json:"number"` +} -// A wire feature a caller can require of the catalog surface, negotiated per request. A -// grant means the runtime understands the feature's contract, not that the deployment has -// enabled the operation; typed unavailable results report availability separately. -// Experimental: CatalogCapability is part of an experimental API and may change or be -// removed. -type CatalogCapability string +// Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing. +// Experimental: WorkspacesReadCheckpointResult is part of an experimental API and may +// change or be removed. +type WorkspacesReadCheckpointResult struct { + // Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing + Content *string `json:"content"` +} -const ( - // Understands `application/ai-skill` candidates as discovery-only and typed non-installable. - CatalogCapabilityAiSkillDiscovery CatalogCapability = "ai-skill-discovery" - // Understands the legacy `application/mcp-server+json` media type. - CatalogCapabilityLegacyMCPServerCard CatalogCapability = "legacy-mcp-server-card" - // Understands side-effect-free MCP install-plan requests, results, and plan handles; - // `planning-unavailable` separately reports that planning is not enabled. - CatalogCapabilityMCPInstallPlanning CatalogCapability = "mcp-install-planning" - // Understands the current `application/mcp-server-card+json` media type. - CatalogCapabilityMCPServerCard CatalogCapability = "mcp-server-card" - // Understands plans that enumerate every eligible transport rather than a single preferred - // one. - CatalogCapabilityMultipleTransportChoice CatalogCapability = "multiple-transport-choice" - // Understands versioned candidate trust snapshots. Protocol-3 callers must require this - // capability before the runtime adds the optional snapshot field. - CatalogCapabilityTrustSnapshot CatalogCapability = "trust-snapshot" -) +// Relative path of the workspace file to read. +// Experimental: WorkspacesReadFileRequest is part of an experimental API and may change or +// be removed. +type WorkspacesReadFileRequest struct { + // Slash-separated relative path within the workspace files directory + Path string `json:"path"` +} -// Which wire-contract rule an upstream response broke -// Experimental: CatalogContractViolationReason is part of an experimental API and may -// change or be removed. -type CatalogContractViolationReason string +// Contents of the requested workspace file as a UTF-8 string. +// Experimental: WorkspacesReadFileResult is part of an experimental API and may change or +// be removed. +type WorkspacesReadFileResult struct { + // File content as a UTF-8 string + Content string `json:"content"` +} -const ( - // A result carried both a URL and embedded data, when exactly one is permitted. - CatalogContractViolationReasonBothURLAndData CatalogContractViolationReason = "both-url-and-data" - // Two results claimed the same normalised identity. - CatalogContractViolationReasonDuplicateIdentity CatalogContractViolationReason = "duplicate-identity" - // A result carried neither a URL nor embedded data, when exactly one is required. - CatalogContractViolationReasonNeitherURLNorData CatalogContractViolationReason = "neither-url-nor-data" - // A result declared no media type, or one this contract does not model. - CatalogContractViolationReasonUnknownMediaType CatalogContractViolationReason = "unknown-media-type" -) +// File or directory to remove from the session workspace files directory. +// Experimental: WorkspacesRemovePathRequest is part of an experimental API and may change +// or be removed. +type WorkspacesRemovePathRequest struct { + // Whether a missing path should be treated as success. Defaults to false. + Force *bool `json:"force,omitempty"` + // Slash-separated relative path within the workspace files directory + Path string `json:"path"` + // Whether to remove directory contents recursively. Defaults to false. + Recursive *bool `json:"recursive,omitempty"` +} -// Why a presented handle was rejected -// Experimental: CatalogHandleRejectionReason is part of an experimental API and may change +// Source and destination paths for a rename within the session workspace files directory. +// Experimental: WorkspacesRenamePathRequest is part of an experimental API and may change // or be removed. -type CatalogHandleRejectionReason string +type WorkspacesRenamePathRequest struct { + // Slash-separated destination path relative to the workspace files directory + Destination string `json:"destination"` + // Slash-separated source path relative to the workspace files directory + Source string `json:"source"` +} -const ( - // The handle was issued by a different runtime instance. - CatalogHandleRejectionReasonForeign CatalogHandleRejectionReason = "foreign" - // The handle is unparseable, unknown, or was issued for a different operation. - CatalogHandleRejectionReasonInvalid CatalogHandleRejectionReason = "invalid" - // The handle has already been used, and handles are single-use. - CatalogHandleRejectionReasonReplayed CatalogHandleRejectionReason = "replayed" - // The handle's time to live has elapsed. - CatalogHandleRejectionReasonStale CatalogHandleRejectionReason = "stale" -) +// Pasted content to save as a UTF-8 file in the session workspace. +// Experimental: WorkspacesSaveLargePasteRequest is part of an experimental API and may +// change or be removed. +type WorkspacesSaveLargePasteRequest struct { + // Pasted content to save as a UTF-8 file + Content string `json:"content"` +} -// Which kind of opaque handle was presented -// Experimental: CatalogHandleType is part of an experimental API and may change or be -// removed. -type CatalogHandleType string +// Descriptor for the saved paste file, or null when the workspace is unavailable. +// Experimental: WorkspacesSaveLargePasteResult is part of an experimental API and may +// change or be removed. +type WorkspacesSaveLargePasteResult struct { + // Saved-paste descriptor, or null when the workspace is unavailable (e.g. CCA runtime, + // non-infinite sessions, remote sessions) + Saved *WorkspacesSaveLargePasteResultSaved `json:"saved"` +} -const ( - // A search candidate handle. - CatalogHandleTypeCandidate CatalogHandleType = "candidate" - // An install plan handle. - CatalogHandleTypePlan CatalogHandleType = "plan" -) +type WorkspacesSaveLargePasteResultSaved struct { + // Filename within the workspace files directory + Filename string `json:"filename"` + // Absolute filesystem path to the saved paste file + FilePath string `json:"filePath"` + // Size of the saved file in bytes + SizeBytes int64 `json:"sizeBytes"` +} -// Which request field was rejected before any work was done -// Experimental: CatalogInvalidRequestField is part of an experimental API and may change or +// Relative path of the workspace file or directory to inspect. +// Experimental: WorkspacesStatFileRequest is part of an experimental API and may change or // be removed. -type CatalogInvalidRequestField string - -const ( - // The supplied card was missing its media type, URL, or data. - CatalogInvalidRequestFieldCard CatalogInvalidRequestField = "card" - // The negotiation block was missing or malformed. - CatalogInvalidRequestFieldContract CatalogInvalidRequestField = "contract" - // The requested candidate kinds were empty or contained a duplicate. - CatalogInvalidRequestFieldKinds CatalogInvalidRequestField = "kinds" - // The requested result count fell outside its permitted range. - CatalogInvalidRequestFieldLimit CatalogInvalidRequestField = "limit" - // The search query was empty or longer than permitted. - CatalogInvalidRequestFieldQuery CatalogInvalidRequestField = "query" - // The requested configuration scope is not one this runtime writes. - CatalogInvalidRequestFieldScope CatalogInvalidRequestField = "scope" - // The plan source was missing or malformed. - CatalogInvalidRequestFieldSource CatalogInvalidRequestField = "source" -) +type WorkspacesStatFileRequest struct { + // Slash-separated relative path within the workspace files directory + Path string `json:"path"` +} -// How a card failed validation -// Experimental: CatalogMalformedCardReason is part of an experimental API and may change or +// Filesystem metadata for a path in the session workspace files directory. +// Experimental: WorkspacesStatFileResult is part of an experimental API and may change or // be removed. -type CatalogMalformedCardReason string +type WorkspacesStatFileResult struct { + // Creation time in Unix epoch milliseconds + BirthtimeMs float64 `json:"birthtimeMs"` + // Whether the path identifies a directory + IsDirectory bool `json:"isDirectory"` + // Whether the path identifies a regular file + IsFile bool `json:"isFile"` + // Last modification time in Unix epoch milliseconds + MtimeMs float64 `json:"mtimeMs"` + // Size in bytes + Size float64 `json:"size"` +} -const ( - // The document is not well-formed JSON. - CatalogMalformedCardReasonInvalidJSON CatalogMalformedCardReason = "invalid-json" - // A field the media type requires is absent. - CatalogMalformedCardReasonMissingRequiredField CatalogMalformedCardReason = "missing-required-field" - // The document does not satisfy its media type's schema. - CatalogMalformedCardReasonSchemaViolation CatalogMalformedCardReason = "schema-violation" - // The document exceeded the permitted size. - CatalogMalformedCardReasonSizeLimitExceeded CatalogMalformedCardReason = "size-limit-exceeded" - // The declared media type is not one this runtime understands. - CatalogMalformedCardReasonUnsupportedMediaType CatalogMalformedCardReason = "unsupported-media-type" -) +// Rollback point for local workspace summaries. +// Experimental: WorkspacesTruncateSummariesRequest is part of an experimental API and may +// change or be removed. +type WorkspacesTruncateSummariesRequest struct { + // Number of newest summaries to keep. + KeepCount int64 `json:"keepCount"` +} -// Whether an MCP server candidate can be planned for installation -// Experimental: CatalogMCPServerInstallability is part of an experimental API and may +// Public-facing projection of workspace metadata for SDK / TUI consumers +// Experimental: WorkspaceSummary is part of an experimental API and may change or be +// removed. +type WorkspaceSummary struct { + // Branch checked out at session start, if any + Branch *string `json:"branch,omitempty"` + // ISO 8601 timestamp when the workspace was created + CreatedAt *time.Time `json:"created_at,omitempty"` + // Current working directory at session start + Cwd *string `json:"cwd,omitempty"` + // Resolved git root for cwd, if any + GitRoot *string `json:"git_root,omitempty"` + // Repository host type, if known + HostType *WorkspaceSummaryHostType `json:"host_type,omitempty"` + // Workspace identifier (1:1 with sessionId) + ID string `json:"id"` + // Display name for the session, if set + Name *string `json:"name,omitempty"` + // Repository identifier in 'owner/repo' or 'org/project/repo' format, if any + Repository *string `json:"repository,omitempty"` + // ISO 8601 timestamp when the workspace was last updated + UpdatedAt *time.Time `json:"updated_at,omitempty"` + // Whether the display name was explicitly set by the user + UserNamed *bool `json:"user_named,omitempty"` +} + +// Workspace metadata fields to update. +// Experimental: WorkspacesUpdateMetadataRequest is part of an experimental API and may // change or be removed. -type CatalogMCPServerInstallability string +type WorkspacesUpdateMetadataRequest struct { + // Opaque workspace context supplied by the session host. + Context any `json:"context,omitempty"` + // Optional workspace display name override. + Name *string `json:"name,omitempty"` +} -const ( - // An install plan can be computed for this MCP server candidate. - CatalogMCPServerInstallabilityInstallable CatalogMCPServerInstallability = "installable" - // Policy forbids installing this MCP server candidate. - CatalogMCPServerInstallabilityNotInstallablePolicy CatalogMCPServerInstallability = "not-installable-policy" -) +// Autopilot objective file content to persist. +// Experimental: WorkspacesWriteAutopilotObjectiveRequest is part of an experimental API and +// may change or be removed. +type WorkspacesWriteAutopilotObjectiveRequest struct { + // Autopilot objective file content. + Content string `json:"content"` +} -// Media type a catalog card is interpreted as -// Experimental: CatalogMediaType is part of an experimental API and may change or be -// removed. -type CatalogMediaType string +// Result of writing the autopilot objective file. +// Experimental: WorkspacesWriteAutopilotObjectiveResult is part of an experimental API and +// may change or be removed. +type WorkspacesWriteAutopilotObjectiveResult struct { + // Filesystem operation performed. + Operation string `json:"operation"` +} + +// Finite reason code describing why the current turn was aborted +// Experimental: AbortReason is part of an experimental API and may change or be removed. +type AbortReason string const ( - // An AI skill card. Representable and searchable, but typed non-installable. - CatalogMediaTypeApplicationAiSkill CatalogMediaType = "application/ai-skill" - // The current MCP server card media type. - CatalogMediaTypeApplicationMCPServerCardJSON CatalogMediaType = "application/mcp-server-card+json" - // The legacy MCP server card media type, accepted for compatibility. - CatalogMediaTypeApplicationMCPServerJSON CatalogMediaType = "application/mcp-server+json" + // Autopilot stopped the run because the active objective reached its user-set + // --max-ai-credits limit. + AbortReasonAutopilotCreditLimit AbortReason = "autopilot_credit_limit" + // A remote command requested the abort. + AbortReasonRemoteCommand AbortReason = "remote_command" + // An MCP server delivered a user.abort notification. + AbortReasonUserAbort AbortReason = "user_abort" + // The local user requested the abort, for example by pressing Ctrl+C in the CLI. + AbortReasonUserInitiated AbortReason = "user_initiated" ) -// Why capability and protocol-version negotiation refused a caller -// Experimental: CatalogNegotiationRefusedReason is part of an experimental API and may -// change or be removed. -type CatalogNegotiationRefusedReason string +// Resolved Anthropic adaptive-thinking capability for a model. +// Experimental: AdaptiveThinkingSupport is part of an experimental API and may change or be +// removed. +type AdaptiveThinkingSupport string const ( - // The caller requires at least one capability this runtime cannot honour. - CatalogNegotiationRefusedReasonUnsupportedCapability CatalogNegotiationRefusedReason = "unsupported-capability" - // The caller's protocol version is below the lowest this runtime serves. - CatalogNegotiationRefusedReasonUnsupportedProtocolVersion CatalogNegotiationRefusedReason = "unsupported-protocol-version" + // The model accepts only thinking.type='adaptive'; 'enabled', 'disabled', and an omitted + // thinking block all fail with HTTP 400 (e.g. fable, mythos) + AdaptiveThinkingSupportAdaptiveOnly AdaptiveThinkingSupport = "adaptive_only" + // The model accepts adaptive thinking but also accepts thinking.type='enabled' + AdaptiveThinkingSupportOptional AdaptiveThinkingSupport = "optional" + // The model defaults to adaptive thinking and rejects thinking.type='enabled' with HTTP + // 400, but still accepts thinking.type='disabled' (e.g. opus-4.7/4.8/5, sonnet-5) + AdaptiveThinkingSupportRequired AdaptiveThinkingSupport = "required" + // The model does not accept thinking.type='adaptive' + AdaptiveThinkingSupportUnsupported AdaptiveThinkingSupport = "unsupported" ) -// Categorised network failure, low cardinality so it can be aggregated without carrying a -// URL -// Experimental: CatalogNetworkFailureReason is part of an experimental API and may change -// or be removed. -type CatalogNetworkFailureReason string +// Which tier this directory belongs to +// Experimental: AgentDiscoveryPathScope is part of an experimental API and may change or be +// removed. +type AgentDiscoveryPathScope string const ( - // The connection was refused or reset. - CatalogNetworkFailureReasonConnectionRefused CatalogNetworkFailureReason = "connection-refused" - // The authority's name could not be resolved. - CatalogNetworkFailureReasonDns CatalogNetworkFailureReason = "dns" - // The authority returned another status the runtime treats as a failure. - CatalogNetworkFailureReasonHTTPStatus CatalogNetworkFailureReason = "http-status" - // No network is available, so nothing was attempted. - CatalogNetworkFailureReasonOffline CatalogNetworkFailureReason = "offline" - // The configured proxy returned 407 and requires authentication. - CatalogNetworkFailureReasonProxyAuthenticationRequired CatalogNetworkFailureReason = "proxy-authentication-required" - // The authority rate-limited requests and supplied or implied a bounded cooldown. - CatalogNetworkFailureReasonRateLimited CatalogNetworkFailureReason = "rate-limited" - // A redirect was refused by the runtime's redirect policy. - CatalogNetworkFailureReasonRedirectRejected CatalogNetworkFailureReason = "redirect-rejected" - // The response exceeded the permitted size. - CatalogNetworkFailureReasonResponseTooLarge CatalogNetworkFailureReason = "response-too-large" - // The authority returned a transient 5xx response. - CatalogNetworkFailureReasonServiceUnavailable CatalogNetworkFailureReason = "service-unavailable" - // The request exceeded its time budget. - CatalogNetworkFailureReasonTimeout CatalogNetworkFailureReason = "timeout" - // The TLS handshake or certificate validation failed. - CatalogNetworkFailureReasonTls CatalogNetworkFailureReason = "tls" + // A project's repository agent directory. + AgentDiscoveryPathScopeProject AgentDiscoveryPathScope = "project" + // The user's personal agent configuration directory. + AgentDiscoveryPathScopeUser AgentDiscoveryPathScope = "user" ) -// Why a discoverable candidate cannot be installed -// Experimental: CatalogNotInstallableReason is part of an experimental API and may change -// or be removed. -type CatalogNotInstallableReason string +// Where the agent definition was loaded from +// Experimental: AgentInfoSource is part of an experimental API and may change or be removed. +type AgentInfoSource string const ( - // AI skills are discoverable but have no typed importer in this phase. - CatalogNotInstallableReasonAiSkillNotInstallable CatalogNotInstallableReason = "ai-skill-not-installable" - // This kind of resource is not installable through this surface. - CatalogNotInstallableReasonKindNotInstallable CatalogNotInstallableReason = "kind-not-installable" - // Policy forbids installing this candidate. - CatalogNotInstallableReasonPolicyForbids CatalogNotInstallableReason = "policy-forbids" + // Agent built into the Copilot runtime. + AgentInfoSourceBuiltin AgentInfoSource = "builtin" + // Agent inherited from a parent project or workspace. + AgentInfoSourceInherited AgentInfoSource = "inherited" + // Agent contributed by an installed plugin. + AgentInfoSourcePlugin AgentInfoSource = "plugin" + // Agent loaded from the current project's repository configuration. + AgentInfoSourceProject AgentInfoSource = "project" + // Agent provided by a remote runtime or service. + AgentInfoSourceRemote AgentInfoSource = "remote" + // Agent loaded from the user's personal agent configuration. + AgentInfoSourceUser AgentInfoSource = "user" ) -// Kind discriminator for CatalogSearchResult. -type CatalogSearchResultKind string +// Whether configured models are advisory preferences or required constraints +// Experimental: AgentModelPolicy is part of an experimental API and may change or be +// removed. +type AgentModelPolicy string const ( - CatalogSearchResultKindAuthenticationRequired CatalogSearchResultKind = "authentication-required" - CatalogSearchResultKindContractViolation CatalogSearchResultKind = "contract-violation" - CatalogSearchResultKindInvalidRequest CatalogSearchResultKind = "invalid-request" - CatalogSearchResultKindMalformedCard CatalogSearchResultKind = "malformed-card" - CatalogSearchResultKindNegotiationRefused CatalogSearchResultKind = "negotiation-refused" - CatalogSearchResultKindNetworkFailure CatalogSearchResultKind = "network-failure" - CatalogSearchResultKindPolicyRejected CatalogSearchResultKind = "policy-rejected" - CatalogSearchResultKindSucceeded CatalogSearchResultKind = "succeeded" - CatalogSearchResultKindUnavailable CatalogSearchResultKind = "unavailable" - CatalogSearchResultKindUnsafeRetrieval CatalogSearchResultKind = "unsafe-retrieval" - CatalogSearchResultKindUnsupportedKind CatalogSearchResultKind = "unsupported-kind" + // Treat the authored models as advisory preferences that callers may override. + AgentModelPolicyPreferred AgentModelPolicy = "preferred" + // Require subagent execution to use one of the authored models. + AgentModelPolicyRequired AgentModelPolicy = "required" ) -// Authority-computed exposure eligibility, kept separate from tier. The current tier-only -// Agent Finder response maps to `unknown`, never to a locally inferred eligibility. -// Experimental: CatalogTrustEligibility is part of an experimental API and may change or be -// removed. -type CatalogTrustEligibility string +// Kind of attention required when status === "attention". Meaningful only when status === +// "attention". +// Experimental: AgentRegistryLiveTargetEntryAttentionKind is part of an experimental API +// and may change or be removed. +type AgentRegistryLiveTargetEntryAttentionKind string const ( - // Eligible for default catalogue exposure. - CatalogTrustEligibilityDefault CatalogTrustEligibility = "default" - // Eligible only when expanded or community results are requested. - CatalogTrustEligibilityExpanded CatalogTrustEligibility = "expanded" - // Not eligible for normal catalogue exposure. - CatalogTrustEligibilityHidden CatalogTrustEligibility = "hidden" - // The authority did not supply an eligibility decision. - CatalogTrustEligibilityUnknown CatalogTrustEligibility = "unknown" + // Session is waiting on an elicitation prompt + AgentRegistryLiveTargetEntryAttentionKindElicitation AgentRegistryLiveTargetEntryAttentionKind = "elicitation" + // Session is blocked on an unrecoverable error + AgentRegistryLiveTargetEntryAttentionKindError AgentRegistryLiveTargetEntryAttentionKind = "error" + // Session is waiting for the user to approve or reject a plan + AgentRegistryLiveTargetEntryAttentionKindExitPlan AgentRegistryLiveTargetEntryAttentionKind = "exit_plan" + // Session is waiting for a tool-permission decision + AgentRegistryLiveTargetEntryAttentionKindPermission AgentRegistryLiveTargetEntryAttentionKind = "permission" + // Session is waiting for free-form user input + AgentRegistryLiveTargetEntryAttentionKindUserInput AgentRegistryLiveTargetEntryAttentionKind = "user_input" ) -// The authority omitted trust metadata. -// Experimental: CatalogTrustSnapshotAbsentStatus is part of an experimental API and may +// Process kind tag for the registry entry +// Experimental: AgentRegistryLiveTargetEntryKind is part of an experimental API and may // change or be removed. -type CatalogTrustSnapshotAbsentStatus string +type AgentRegistryLiveTargetEntryKind string const ( - // The authority omitted trust metadata. - CatalogTrustSnapshotAbsentStatusAbsent CatalogTrustSnapshotAbsentStatus = "absent" + // Headless `--server --managed-server` child spawned by a controller + AgentRegistryLiveTargetEntryKindManagedServer AgentRegistryLiveTargetEntryKind = "managed-server" + // Interactive Copilot CLI exposing a UI server (legacy/normal CLI process) + AgentRegistryLiveTargetEntryKindUIServer AgentRegistryLiveTargetEntryKind = "ui-server" ) -// A recognised T1 or T2 service tier was observed. -// Experimental: CatalogTrustSnapshotCurrentStatus is part of an experimental API and may -// change or be removed. -type CatalogTrustSnapshotCurrentStatus string +// How the most recent turn ended (clean vs aborted). Lets the renderer distinguish done +// from done_cancelled. +// Experimental: AgentRegistryLiveTargetEntryLastTerminalEvent is part of an experimental +// API and may change or be removed. +type AgentRegistryLiveTargetEntryLastTerminalEvent string const ( - // A recognised T1 or T2 service tier was observed. - CatalogTrustSnapshotCurrentStatusCurrent CatalogTrustSnapshotCurrentStatus = "current" + // Last turn was aborted (e.g. user interrupted) + AgentRegistryLiveTargetEntryLastTerminalEventAbort AgentRegistryLiveTargetEntryLastTerminalEvent = "abort" + // Last turn ended cleanly (model returned a final assistant message) + AgentRegistryLiveTargetEntryLastTerminalEventTurnEnd AgentRegistryLiveTargetEntryLastTerminalEvent = "turn_end" ) -// The authority explicitly reported a downgraded assessment. -// Experimental: CatalogTrustSnapshotDowngradedStatus is part of an experimental API and may +// Coarse lifecycle status of the foreground session +// Experimental: AgentRegistryLiveTargetEntryStatus is part of an experimental API and may // change or be removed. -type CatalogTrustSnapshotDowngradedStatus string +type AgentRegistryLiveTargetEntryStatus string const ( - // The authority explicitly reported a downgraded assessment. - CatalogTrustSnapshotDowngradedStatusDowngraded CatalogTrustSnapshotDowngradedStatus = "downgraded" + // Session needs user attention (see attentionKind for the specific reason) + AgentRegistryLiveTargetEntryStatusAttention AgentRegistryLiveTargetEntryStatus = "attention" + // Last turn completed successfully + AgentRegistryLiveTargetEntryStatusDone AgentRegistryLiveTargetEntryStatus = "done" + // Session is idle, waiting for input + AgentRegistryLiveTargetEntryStatusWaiting AgentRegistryLiveTargetEntryStatus = "waiting" + // Session is actively processing a turn + AgentRegistryLiveTargetEntryStatusWorking AgentRegistryLiveTargetEntryStatus = "working" ) -// The trust field was empty, unbounded, or had the wrong JSON type. -// Experimental: CatalogTrustSnapshotMalformedStatus is part of an experimental API and may -// change or be removed. -type CatalogTrustSnapshotMalformedStatus string +// Categorized reason for log-open failure +// Experimental: AgentRegistryLogCaptureOpenErrorReason is part of an experimental API and +// may change or be removed. +type AgentRegistryLogCaptureOpenErrorReason string const ( - // The trust field was empty, unbounded, or had the wrong JSON type. - CatalogTrustSnapshotMalformedStatusMalformed CatalogTrustSnapshotMalformedStatus = "malformed" + // No space left on device + AgentRegistryLogCaptureOpenErrorReasonDiskFull AgentRegistryLogCaptureOpenErrorReason = "disk_full" + // Other / uncategorized open failure + AgentRegistryLogCaptureOpenErrorReasonOther AgentRegistryLogCaptureOpenErrorReason = "other" + // Filesystem permission denied opening the log file + AgentRegistryLogCaptureOpenErrorReasonPermission AgentRegistryLogCaptureOpenErrorReason = "permission" ) -// The authority explicitly revoked its assessment. -// Experimental: CatalogTrustSnapshotRevokedStatus is part of an experimental API and may +// Permission posture for the new session. 'yolo' requires the controller-local session to +// currently be in allow-all mode. +// Experimental: AgentRegistrySpawnPermissionMode is part of an experimental API and may // change or be removed. -type CatalogTrustSnapshotRevokedStatus string +type AgentRegistrySpawnPermissionMode string const ( - // The authority explicitly revoked its assessment. - CatalogTrustSnapshotRevokedStatusRevoked CatalogTrustSnapshotRevokedStatus = "revoked" + // Standard permission posture (prompts for each request) + AgentRegistrySpawnPermissionModeDefault AgentRegistrySpawnPermissionMode = "default" + // Full allow-all (requires the controller-local session to currently be in allow-all mode) + AgentRegistrySpawnPermissionModeYolo AgentRegistrySpawnPermissionMode = "yolo" ) -// SchemaVersion discriminator for CatalogTrustSnapshot. -// Experimental: CatalogTrustSnapshotSchemaVersion is part of an experimental API and may -// change or be removed. -type CatalogTrustSnapshotSchemaVersion string +// Kind discriminator for AgentRegistrySpawnResult. +type AgentRegistrySpawnResultKind string const ( - CatalogTrustSnapshotSchemaVersionV1 CatalogTrustSnapshotSchemaVersion = "v1" + AgentRegistrySpawnResultKindRegistryTimeout AgentRegistrySpawnResultKind = "registry-timeout" + AgentRegistrySpawnResultKindSpawned AgentRegistrySpawnResultKind = "spawned" + AgentRegistrySpawnResultKindSpawnError AgentRegistrySpawnResultKind = "spawn-error" + AgentRegistrySpawnResultKindValidationError AgentRegistrySpawnResultKind = "validation-error" ) -// The authority explicitly marked its assessment stale. -// Experimental: CatalogTrustSnapshotStaleStatus is part of an experimental API and may -// change or be removed. -type CatalogTrustSnapshotStaleStatus string +// Which parameter field was invalid. Omitted when the rejection is not field-specific. +// Experimental: AgentRegistrySpawnValidationErrorField is part of an experimental API and +// may change or be removed. +type AgentRegistrySpawnValidationErrorField string const ( - // The authority explicitly marked its assessment stale. - CatalogTrustSnapshotStaleStatusStale CatalogTrustSnapshotStaleStatus = "stale" + // The agentName parameter + AgentRegistrySpawnValidationErrorFieldAgentName AgentRegistrySpawnValidationErrorField = "agentName" + // The cwd parameter + AgentRegistrySpawnValidationErrorFieldCwd AgentRegistrySpawnValidationErrorField = "cwd" + // The model parameter + AgentRegistrySpawnValidationErrorFieldModel AgentRegistrySpawnValidationErrorField = "model" + // The session name parameter + AgentRegistrySpawnValidationErrorFieldName AgentRegistrySpawnValidationErrorField = "name" + // The permissionMode parameter + AgentRegistrySpawnValidationErrorFieldPermissionMode AgentRegistrySpawnValidationErrorField = "permissionMode" ) -// The authority supplied a bounded trust value this runtime does not understand. -// Experimental: CatalogTrustSnapshotUnsupportedStatus is part of an experimental API and +// Categorized reason for the rejection. Low-cardinality enum so telemetry can aggregate by +// reason without leaking raw paths or agent/model names. +// Experimental: AgentRegistrySpawnValidationErrorReason is part of an experimental API and // may change or be removed. -type CatalogTrustSnapshotUnsupportedStatus string +type AgentRegistrySpawnValidationErrorReason string const ( - // The authority supplied a bounded trust value this runtime does not understand. - CatalogTrustSnapshotUnsupportedStatusUnsupported CatalogTrustSnapshotUnsupportedStatus = "unsupported" + // Provided cwd exists but is not a directory + AgentRegistrySpawnValidationErrorReasonCwdNotDirectory AgentRegistrySpawnValidationErrorReason = "cwd-not-directory" + // Provided cwd does not exist on disk + AgentRegistrySpawnValidationErrorReasonCwdNotFound AgentRegistrySpawnValidationErrorReason = "cwd-not-found" + // Session name failed validateSessionName + AgentRegistrySpawnValidationErrorReasonInvalidName AgentRegistrySpawnValidationErrorReason = "invalid-name" + // Requested agent name was not found in builtin or custom agents + AgentRegistrySpawnValidationErrorReasonUnknownAgent AgentRegistrySpawnValidationErrorReason = "unknown-agent" + // Requested model is not available to this session + AgentRegistrySpawnValidationErrorReasonUnknownModel AgentRegistrySpawnValidationErrorReason = "unknown-model" + // Caller asked for permissionMode='yolo' but the controller is not currently in allow-all + // mode + AgentRegistrySpawnValidationErrorReasonYoloNotAllowed AgentRegistrySpawnValidationErrorReason = "yolo-not-allowed" ) -// Bounded authority that supplied a catalogue trust observation -// Experimental: CatalogTrustSource is part of an experimental API and may change or be -// removed. -type CatalogTrustSource string +// Type of GitHub reference +// Experimental: AttachmentGitHubReferenceType is part of an experimental API and may change +// or be removed. +type AttachmentGitHubReferenceType string const ( - // GitHub Agent Finder supplied the trust field on its search result. - CatalogTrustSourceAgentFinder CatalogTrustSource = "agent-finder" + // GitHub discussion reference. + AttachmentGitHubReferenceTypeDiscussion AttachmentGitHubReferenceType = "discussion" + // GitHub issue reference. + AttachmentGitHubReferenceTypeIssue AttachmentGitHubReferenceType = "issue" + // GitHub pull request reference. + AttachmentGitHubReferenceTypePr AttachmentGitHubReferenceType = "pr" ) -// Service-computed trust tier currently emitted by Agent Finder. It is independent of -// search score, popularity, and client-side ranking. -// Experimental: CatalogTrustTier is part of an experimental API and may change or be -// removed. -type CatalogTrustTier string +// Type discriminator for Attachment. +type AttachmentType string const ( - // Tier one as assigned by the catalogue authority. - CatalogTrustTierT1 CatalogTrustTier = "T1" - // Tier two as assigned by the catalogue authority. - CatalogTrustTierT2 CatalogTrustTier = "T2" + AttachmentTypeBlob AttachmentType = "blob" + AttachmentTypeDirectory AttachmentType = "directory" + AttachmentTypeExtensionContext AttachmentType = "extension_context" + AttachmentTypeFile AttachmentType = "file" + AttachmentTypeGitHubActionsJob AttachmentType = "github_actions_job" + AttachmentTypeGitHubCommit AttachmentType = "github_commit" + AttachmentTypeGitHubFile AttachmentType = "github_file" + AttachmentTypeGitHubFileDiff AttachmentType = "github_file_diff" + AttachmentTypeGitHubReference AttachmentType = "github_reference" + AttachmentTypeGitHubRelease AttachmentType = "github_release" + AttachmentTypeGitHubRepository AttachmentType = "github_repository" + AttachmentTypeGitHubSnippet AttachmentType = "github_snippet" + AttachmentTypeGitHubTreeComparison AttachmentType = "github_tree_comparison" + AttachmentTypeGitHubURL AttachmentType = "github_url" + AttachmentTypeSelection AttachmentType = "selection" ) -// Why a catalog operation is not available on this runtime -// Experimental: CatalogUnavailableReason is part of an experimental API and may change or -// be removed. -type CatalogUnavailableReason string +// Type discriminator for AuthInfo. +// Experimental: AuthInfoType is part of an experimental API and may change or be removed. +type AuthInfoType string const ( - // No catalog authority is configured for this runtime. - CatalogUnavailableReasonAuthorityNotConfigured CatalogUnavailableReason = "authority-not-configured" - // The surface is disabled by policy on this runtime. - CatalogUnavailableReasonDisabledByPolicy CatalogUnavailableReason = "disabled-by-policy" - // Install planning is not wired up on this runtime build. - CatalogUnavailableReasonPlanningUnavailable CatalogUnavailableReason = "planning-unavailable" - // Bounded search is not wired up on this runtime build. - CatalogUnavailableReasonSearchUnavailable CatalogUnavailableReason = "search-unavailable" + AuthInfoTypeAPIKey AuthInfoType = "api-key" + AuthInfoTypeCopilotAPIToken AuthInfoType = "copilot-api-token" + AuthInfoTypeEnv AuthInfoType = "env" + AuthInfoTypeGhCLI AuthInfoType = "gh-cli" + AuthInfoTypeHMAC AuthInfoType = "hmac" + AuthInfoTypeToken AuthInfoType = "token" + AuthInfoTypeTokenProvider AuthInfoType = "token-provider" + AuthInfoTypeUser AuthInfoType = "user" ) -// Why no usable transport could be offered -// Experimental: CatalogUnavailableTransportReason is part of an experimental API and may -// change or be removed. -type CatalogUnavailableTransportReason string +// Current normalized autopilot objective lifecycle status. +// Experimental: AutopilotObjectiveStatus is part of an experimental API and may change or +// be removed. +type AutopilotObjectiveStatus string const ( - // The card advertises no transport this runtime can use. - CatalogUnavailableTransportReasonNoEligibleTransport CatalogUnavailableTransportReason = "no-eligible-transport" - // Eligible remotes could not be enumerated, so no explicit choice can be offered. - CatalogUnavailableTransportReasonRemoteEnumerationUnavailable CatalogUnavailableTransportReason = "remote-enumeration-unavailable" - // Every advertised transport is of a kind this runtime does not implement. - CatalogUnavailableTransportReasonTransportNotSupported CatalogUnavailableTransportReason = "transport-not-supported" + // The objective is actively running. + AutopilotObjectiveStatusActive AutopilotObjectiveStatus = "active" + // The objective completed. + AutopilotObjectiveStatusCompleted AutopilotObjectiveStatus = "completed" + // The objective is paused and may be resumed. + AutopilotObjectiveStatusPaused AutopilotObjectiveStatus = "paused" ) -// Which hardened-fetch control refused a retrieval -// Experimental: CatalogUnsafeRetrievalReason is part of an experimental API and may change -// or be removed. -type CatalogUnsafeRetrievalReason string +// Routing preference used when the session model is `auto`. `fast` is an integrator-only +// latency preset and is not a first-party GitHub Copilot product preference. +// Experimental: AutoTier is part of an experimental API and may change or be removed. +type AutoTier string const ( - // The URL resolved to a loopback, private, link-local, or cloud metadata address. - CatalogUnsafeRetrievalReasonBlockedAddress CatalogUnsafeRetrievalReason = "blocked-address" - // The URL used a scheme the runtime refuses to fetch. - CatalogUnsafeRetrievalReasonBlockedScheme CatalogUnsafeRetrievalReason = "blocked-scheme" - // The URL embedded credentials. - CatalogUnsafeRetrievalReasonCredentialsInURL CatalogUnsafeRetrievalReason = "credentials-in-url" - // The authority is not permitted for card retrieval. - CatalogUnsafeRetrievalReasonHostNotPermitted CatalogUnsafeRetrievalReason = "host-not-permitted" - // The configured proxy policy refused the request. - CatalogUnsafeRetrievalReasonProxyRejected CatalogUnsafeRetrievalReason = "proxy-rejected" - // A redirect target resolved to a blocked address. - CatalogUnsafeRetrievalReasonRedirectToBlockedAddress CatalogUnsafeRetrievalReason = "redirect-to-blocked-address" + // Balance efficiency and intelligence. + AutoTierBalance AutoTier = "balance" + // Optimize for efficiency. + AutoTierEfficiency AutoTier = "efficiency" + // Integrator-only preset that optimizes for latency. + AutoTierFast AutoTier = "fast" + // Optimize for intelligence. + AutoTierIntelligence AutoTier = "intelligence" ) -// Why the runtime requests client-task cancellation. -// Experimental: ClientTaskCancelReason is part of an experimental API and may change or be +// Custom input-format kind. +// Experimental: BuiltinToolFormatType is part of an experimental API and may change or be // removed. -type ClientTaskCancelReason string +type BuiltinToolFormatType string const ( - // A caller requested task cancellation. - ClientTaskCancelReasonCancelRequested ClientTaskCancelReason = "cancel_requested" - // The session is shutting down. - ClientTaskCancelReasonSessionShutdown ClientTaskCancelReason = "session_shutdown" + // The tool input is parsed with the supplied grammar. + BuiltinToolFormatTypeGrammar BuiltinToolFormatType = "grammar" ) -// Whether a pending slash-command invocation effect was applied or cancelled by the host. -// Experimental: CommandsInvocationEffectOutcome is part of an experimental API and may -// change or be removed. -type CommandsInvocationEffectOutcome string +// Root JSON Schema type for a built-in tool input. +// Experimental: BuiltinToolInputSchemaType is part of an experimental API and may change or +// be removed. +type BuiltinToolInputSchemaType string const ( - // The host applied the pending invocation effect. - CommandsInvocationEffectOutcomeApplied CommandsInvocationEffectOutcome = "applied" - // The host cancelled the pending invocation effect, so any provisional state must be - // reverted. - CommandsInvocationEffectOutcomeCancelled CommandsInvocationEffectOutcome = "cancelled" + // The tool accepts a JSON object. + BuiltinToolInputSchemaTypeObject BuiltinToolInputSchemaType = "object" ) -// Experimental: CommandsInvocationOrigin is part of an experimental API and may change or -// be removed. -type CommandsInvocationOrigin string +// Canonical digest algorithm for a validated MCP card +// Experimental: CardDigestAlgorithm is part of an experimental API and may change or be +// removed. +type CardDigestAlgorithm string const ( - CommandsInvocationOriginSettings CommandsInvocationOrigin = "settings" + // SHA-256 over RFC 8785 canonical JSON encoded as UTF-8. + CardDigestAlgorithmSha256Rfc8785 CardDigestAlgorithm = "sha256-rfc8785" ) -// Neutral SDK discriminator for the connected remote session kind. -// Experimental: ConnectedRemoteSessionMetadataKind is part of an experimental API and may +// Discriminator for an Agent Plugin candidate +// Experimental: CatalogAgentPluginCandidateKind is part of an experimental API and may // change or be removed. -type ConnectedRemoteSessionMetadataKind string +type CatalogAgentPluginCandidateKind string const ( - // GitHub Copilot coding agent session. - ConnectedRemoteSessionMetadataKindCodingAgent ConnectedRemoteSessionMetadataKind = "coding-agent" - // Remote CLI session. - ConnectedRemoteSessionMetadataKindRemoteSession ConnectedRemoteSessionMetadataKind = "remote-session" + // An Agent Plugin. + CatalogAgentPluginCandidateKindPlugin CatalogAgentPluginCandidateKind = "plugin" ) -// Controls how MCP tool result content is filtered: none leaves content unchanged, markdown -// sanitizes HTML while preserving Markdown-friendly output, and hidden_characters removes -// characters that can hide directives. -// Experimental: ContentFilterMode is part of an experimental API and may change or be -// removed. -type ContentFilterMode string +// Explicit Agent Plugin compatibility declared by exact catalog tags. Clients must not +// infer these values from display text or other metadata. +// Experimental: CatalogAgentPluginCompatibilityTag is part of an experimental API and may +// change or be removed. +type CatalogAgentPluginCompatibilityTag string const ( - // Remove characters that can hide directives. - ContentFilterModeHiddenCharacters ContentFilterMode = "hidden_characters" - // Sanitize HTML while preserving Markdown-friendly output. - ContentFilterModeMarkdown ContentFilterMode = "markdown" - // Leave MCP tool result content unchanged. - ContentFilterModeNone ContentFilterMode = "none" + // The plugin contributes at least one GitHub Copilot Canvas. + CatalogAgentPluginCompatibilityTagCanvas CatalogAgentPluginCompatibilityTag = "canvas" + // The plugin depends on Canvas for its intended functionality. + CatalogAgentPluginCompatibilityTagCanvasOnly CatalogAgentPluginCompatibilityTag = "canvas-only" + // The plugin targets GitHub Copilot. + CatalogAgentPluginCompatibilityTagGitHubCopilot CatalogAgentPluginCompatibilityTag = "github-copilot" ) -// Context tier for models that support multiple context-window sizes. -// Experimental: ContextTier is part of an experimental API and may change or be removed. -type ContextTier string +// Canonical Agent Plugin media type +// Experimental: CatalogAgentPluginMediaType is part of an experimental API and may change +// or be removed. +type CatalogAgentPluginMediaType string const ( - // Use the model's default context window. - ContextTierDefault ContextTier = "default" - // Pin the session to the long-context tier when supported. - ContextTierLongContext ContextTier = "long_context" + // A GitHub Copilot Agent Plugin descriptor. + CatalogAgentPluginMediaTypeApplicationVndGitHubCopilotPlugin CatalogAgentPluginMediaType = "application/vnd.github.copilot-plugin" ) -// Authentication host (always the public GitHub host). -type CopilotAPITokenAuthInfoHost string +// Discriminator for an AI skill candidate +// Experimental: CatalogAiSkillCandidateKind is part of an experimental API and may change +// or be removed. +type CatalogAiSkillCandidateKind string const ( - CopilotAPITokenAuthInfoHostHTTPSGitHubCom CopilotAPITokenAuthInfoHost = "https://github.com" + // An AI skill. + CatalogAiSkillCandidateKindAiSkill CatalogAiSkillCandidateKind = "ai-skill" ) -// Kind discriminator for DebugCollectLogsDestination. -type DebugCollectLogsDestinationKind string +// Typed non-installable state for an AI skill candidate +// Experimental: CatalogAiSkillInstallability is part of an experimental API and may change +// or be removed. +type CatalogAiSkillInstallability string const ( - DebugCollectLogsDestinationKindArchive DebugCollectLogsDestinationKind = "archive" - DebugCollectLogsDestinationKindDirectory DebugCollectLogsDestinationKind = "directory" + // AI skills are discovery-only on this surface. + CatalogAiSkillInstallabilityNotInstallableKind CatalogAiSkillInstallability = "not-installable-kind" ) -// Kind of caller-provided debug log entry. -// Experimental: DebugCollectLogsEntryKind is part of an experimental API and may change or -// be removed. -type DebugCollectLogsEntryKind string +// Canonical AI skill media type +// Experimental: CatalogAiSkillMediaType is part of an experimental API and may change or be +// removed. +type CatalogAiSkillMediaType string const ( - // Include files from a server-local directory recursively. - DebugCollectLogsEntryKindDirectory DebugCollectLogsEntryKind = "directory" - // Include a single server-local file. - DebugCollectLogsEntryKindFile DebugCollectLogsEntryKind = "file" + // An AI skill card. + CatalogAiSkillMediaTypeApplicationAiSkill CatalogAiSkillMediaType = "application/ai-skill" ) -// How a collected debug entry should be redacted before being staged. -// Experimental: DebugCollectLogsRedaction is part of an experimental API and may change or -// be removed. -type DebugCollectLogsRedaction string +// Why the catalog authority did not accept the caller's identity +// Experimental: CatalogAuthenticationRequiredReason is part of an experimental API and may +// change or be removed. +type CatalogAuthenticationRequiredReason string const ( - // Redact each non-empty line as a session event JSON object, falling back to plain-text - // redaction for malformed lines. - DebugCollectLogsRedactionEventsJsonl DebugCollectLogsRedaction = "events-jsonl" - // No redaction is applied. The caller must ensure any necessary redaction is performed - // before this call. - DebugCollectLogsRedactionNone DebugCollectLogsRedaction = "none" - // Redact the file as plain UTF-8 log text. - DebugCollectLogsRedactionPlainText DebugCollectLogsRedaction = "plain-text" + // A credential was presented and its lifetime has elapsed. A silent refresh is worth + // attempting before prompting anyone. + CatalogAuthenticationRequiredReasonCredentialExpired CatalogAuthenticationRequiredReason = "credential-expired" + // A credential was presented and the authority refused it, for example because it was + // revoked, malformed, or issued for another audience. Refreshing the same rejected + // credential is not useful; the caller must sign in again. + CatalogAuthenticationRequiredReasonCredentialRejected CatalogAuthenticationRequiredReason = "credential-rejected" + // No credential was presented, so there is nothing to refresh and the caller must sign in. + CatalogAuthenticationRequiredReasonNoCredential CatalogAuthenticationRequiredReason = "no-credential" ) -// Destination kind that was written. -// Experimental: DebugCollectLogsResultKind is part of an experimental API and may change or -// be removed. -type DebugCollectLogsResultKind string +// Kind discriminator for CatalogCandidate. +// Experimental: CatalogCandidateKind is part of an experimental API and may change or be +// removed. +type CatalogCandidateKind string const ( - // A .tgz archive was written. - DebugCollectLogsResultKindArchive DebugCollectLogsResultKind = "archive" - // A directory containing the collected files was written. - DebugCollectLogsResultKindDirectory DebugCollectLogsResultKind = "directory" + CatalogCandidateKindAiSkill CatalogCandidateKind = "ai-skill" + CatalogCandidateKindMCPServer CatalogCandidateKind = "mcp-server" + CatalogCandidateKindPlugin CatalogCandidateKind = "plugin" ) -// Source category for a collected debug bundle entry. -// Experimental: DebugCollectLogsSource is part of an experimental API and may change or be -// removed. -type DebugCollectLogsSource string +// Kind discriminator for CatalogCandidateSource. +type CatalogCandidateSourceKind string const ( - // Caller-provided diagnostic entry. - DebugCollectLogsSourceAdditional DebugCollectLogsSource = "additional" - // Session event log. - DebugCollectLogsSourceEvents DebugCollectLogsSource = "events" - // Process log for the session. - DebugCollectLogsSourceProcessLog DebugCollectLogsSource = "process-log" - // Interactive shell log for the session. - DebugCollectLogsSourceShellLog DebugCollectLogsSource = "shell-log" + CatalogCandidateSourceKindEmbedded CatalogCandidateSourceKind = "embedded" + CatalogCandidateSourceKindURL CatalogCandidateSourceKind = "url" ) -// Effective extension loading and agent-management mode -// Experimental: DiscoveredExtensionMode is part of an experimental API and may change or be +// A wire feature a caller can require of the catalog surface, negotiated per request. A +// grant means the runtime understands the feature's contract, not that the deployment has +// enabled the operation; typed unavailable results report availability separately. +// Experimental: CatalogCapability is part of an experimental API and may change or be // removed. -type DiscoveredExtensionMode string +type CatalogCapability string const ( - // Extensions are not loaded. - DiscoveredExtensionModeDisabled DiscoveredExtensionMode = "disabled" - // Extensions are loaded and the agent can create, reload, and manage them. - DiscoveredExtensionModeLoadAndAugment DiscoveredExtensionMode = "load_and_augment" - // Extensions are loaded, but the agent cannot create, reload, or manage them. - DiscoveredExtensionModeLoadOnly DiscoveredExtensionMode = "load_only" + // Understands opt-in `application/vnd.github.copilot-plugin` candidates and their typed + // identity, version, source, and compatibility fields. + CatalogCapabilityAgentPluginDiscovery CatalogCapability = "agent-plugin-discovery" + // Understands `application/ai-skill` candidates as discovery-only and typed non-installable. + CatalogCapabilityAiSkillDiscovery CatalogCapability = "ai-skill-discovery" + // Understands explicit numbered navigation and authority-reported pagination metadata with + // opaque tokens. Advertised and granted only when requested. + CatalogCapabilityCatalogSearchPagination CatalogCapability = "catalog-search-pagination" + // Understands exact candidate selection through model-safe opaque references and host-only + // candidate-handle hand-off. + CatalogCapabilityCatalogSelection CatalogCapability = "catalog-selection" + // Understands the legacy `application/mcp-server+json` media type. + CatalogCapabilityLegacyMCPServerCard CatalogCapability = "legacy-mcp-server-card" + // Understands side-effect-free MCP install-plan requests, results, and plan handles; + // `planning-unavailable` separately reports that planning is not enabled. + CatalogCapabilityMCPInstallPlanning CatalogCapability = "mcp-install-planning" + // Understands the current `application/mcp-server-card+json` media type. + CatalogCapabilityMCPServerCard CatalogCapability = "mcp-server-card" + // Understands plans that enumerate every eligible transport rather than a single preferred + // one. + CatalogCapabilityMultipleTransportChoice CatalogCapability = "multiple-transport-choice" + // Understands versioned candidate trust snapshots. Protocol-3 callers must require this + // capability before the runtime adds the optional snapshot field. + CatalogCapabilityTrustSnapshot CatalogCapability = "trust-snapshot" ) -// Persisted extension discovery source -// Experimental: DiscoveredExtensionSource is part of an experimental API and may change or -// be removed. -type DiscoveredExtensionSource string +// Which wire-contract rule an upstream response broke +// Experimental: CatalogContractViolationReason is part of an experimental API and may +// change or be removed. +type CatalogContractViolationReason string const ( - // Extension contributed by an installed plugin. - DiscoveredExtensionSourcePlugin DiscoveredExtensionSource = "plugin" - // Extension discovered from the user's extensions directory. - DiscoveredExtensionSourceUser DiscoveredExtensionSource = "user" + // A result carried both a URL and embedded data, when exactly one is permitted. + CatalogContractViolationReasonBothURLAndData CatalogContractViolationReason = "both-url-and-data" + // Two results claimed the same collision key: normalised identity for existing kinds, or + // normalised identity and declared version for Agent Plugins. + CatalogContractViolationReasonDuplicateIdentity CatalogContractViolationReason = "duplicate-identity" + // A result carried neither a URL nor embedded data, when exactly one is required. + CatalogContractViolationReasonNeitherURLNorData CatalogContractViolationReason = "neither-url-nor-data" + // A result declared no media type, or one this contract does not model. + CatalogContractViolationReasonUnknownMediaType CatalogContractViolationReason = "unknown-media-type" ) -// Server transport type: stdio, http, sse (deprecated), or memory -// Experimental: DiscoveredMCPServerType is part of an experimental API and may change or be -// removed. -type DiscoveredMCPServerType string +// Why a presented handle was rejected +// Experimental: CatalogHandleRejectionReason is part of an experimental API and may change +// or be removed. +type CatalogHandleRejectionReason string const ( - // Server communicates over streamable HTTP. - DiscoveredMCPServerTypeHTTP DiscoveredMCPServerType = "http" - // Server is backed by an in-memory runtime implementation. - DiscoveredMCPServerTypeMemory DiscoveredMCPServerType = "memory" - // Server communicates over Server-Sent Events (deprecated). - DiscoveredMCPServerTypeSSE DiscoveredMCPServerType = "sse" - // Server communicates over stdio with a local child process. - DiscoveredMCPServerTypeStdio DiscoveredMCPServerType = "stdio" + // The handle was issued by a different runtime instance or session. + CatalogHandleRejectionReasonForeign CatalogHandleRejectionReason = "foreign" + // The handle is unparseable or unknown. + CatalogHandleRejectionReasonInvalid CatalogHandleRejectionReason = "invalid" + // The handle has already been used, and handles are single-use. + CatalogHandleRejectionReasonReplayed CatalogHandleRejectionReason = "replayed" + // The supplied search identifier does not match the retained candidate. + CatalogHandleRejectionReasonSearchMismatch CatalogHandleRejectionReason = "search-mismatch" + // The handle's time to live has elapsed. + CatalogHandleRejectionReasonStale CatalogHandleRejectionReason = "stale" + // The handle was issued for another catalog operation. + CatalogHandleRejectionReasonWrongKind CatalogHandleRejectionReason = "wrong-kind" ) -type EventLogTypesString string +// Which kind of opaque handle was presented +// Experimental: CatalogHandleType is part of an experimental API and may change or be +// removed. +type CatalogHandleType string const ( - EventLogTypesStringValue EventLogTypesString = "*" + // A search candidate handle. + CatalogHandleTypeCandidate CatalogHandleType = "candidate" + // An install plan handle. + CatalogHandleTypePlan CatalogHandleType = "plan" + // A model-safe reference to one retained search candidate. + CatalogHandleTypeSelection CatalogHandleType = "selection" ) -// Agent-scope filter: 'primary' returns only main-agent events plus events whose type -// starts with 'subagent.' (matching the typed-subscription default behavior); 'all' returns -// events from all agents (matching wildcard-subscription behavior). Default is 'all' to -// preserve wildcard semantics for catch-up callers. -// Experimental: EventsAgentScope is part of an experimental API and may change or be -// removed. -type EventsAgentScope string +// Which request field was rejected locally or by the catalog authority +// Experimental: CatalogInvalidRequestField is part of an experimental API and may change or +// be removed. +type CatalogInvalidRequestField string const ( - // Return events from all agents. - EventsAgentScopeAll EventsAgentScope = "all" - // Return main-agent events and typed subagent lifecycle events. - EventsAgentScopePrimary EventsAgentScope = "primary" + // The supplied card was missing its media type, URL, or data. + CatalogInvalidRequestFieldCard CatalogInvalidRequestField = "card" + // The negotiation block was missing or malformed. + CatalogInvalidRequestFieldContract CatalogInvalidRequestField = "contract" + // The requested candidate kinds were empty or contained a duplicate. + CatalogInvalidRequestFieldKinds CatalogInvalidRequestField = "kinds" + // The requested result count fell outside its permitted range. + CatalogInvalidRequestFieldLimit CatalogInvalidRequestField = "limit" + // The terminal selection outcome was missing or unsupported. + CatalogInvalidRequestFieldOutcome CatalogInvalidRequestField = "outcome" + // The pagination token or target was invalid, or the authority rejected the continuation. + // Repeat the search without page. + CatalogInvalidRequestFieldPage CatalogInvalidRequestField = "page" + // The search query was empty or longer than permitted. + CatalogInvalidRequestFieldQuery CatalogInvalidRequestField = "query" + // The requested configuration scope is not one this runtime writes. + CatalogInvalidRequestFieldScope CatalogInvalidRequestField = "scope" + // The opaque selection reference was missing or malformed. + CatalogInvalidRequestFieldSelectionRef CatalogInvalidRequestField = "selectionRef" + // The locally owned session identifier was missing or malformed. + CatalogInvalidRequestFieldSessionID CatalogInvalidRequestField = "sessionId" + // The plan source was missing or malformed. + CatalogInvalidRequestFieldSource CatalogInvalidRequestField = "source" ) -// Cursor status: 'ok' means the read succeeded against the requested history; 'expired' -// means the requested continuation is unavailable. Recovery is endpoint-specific: -// session.eventLog.read returns a boundary window of remaining active history that may -// overlap prior pages, while sessions.readPersistedEvents returns an empty terminal page -// and never switches journal generations. An expired persisted read is not successful -// completion; a complete persisted snapshot requires cursorStatus 'ok' and hasMore false. -// Experimental: EventsCursorStatus is part of an experimental API and may change or be -// removed. -type EventsCursorStatus string +// How a card failed validation +// Experimental: CatalogMalformedCardReason is part of an experimental API and may change or +// be removed. +type CatalogMalformedCardReason string const ( - // The requested continuation is unavailable; see the endpoint's recovery semantics. - EventsCursorStatusExpired EventsCursorStatus = "expired" - // The read succeeded against the requested history. - EventsCursorStatusOk EventsCursorStatus = "ok" + // The document is not well-formed JSON. + CatalogMalformedCardReasonInvalidJSON CatalogMalformedCardReason = "invalid-json" + // A field the media type requires is absent. + CatalogMalformedCardReasonMissingRequiredField CatalogMalformedCardReason = "missing-required-field" + // The document does not satisfy its media type's schema. + CatalogMalformedCardReasonSchemaViolation CatalogMalformedCardReason = "schema-violation" + // The document exceeded the permitted size. + CatalogMalformedCardReasonSizeLimitExceeded CatalogMalformedCardReason = "size-limit-exceeded" + // The declared media type is not one this runtime understands. + CatalogMalformedCardReasonUnsupportedMediaType CatalogMalformedCardReason = "unsupported-media-type" ) -// Direction to page through the session's persisted event history. 'forward' pages from the -// cursor toward newer events; 'backward' returns the newest window first (tail-first) and -// pages toward older events. Events within a returned batch are always chronological -// (oldest-to-newest), even for a backward read. -// Experimental: EventsReadDirection is part of an experimental API and may change or be -// removed. -type EventsReadDirection string +// Discriminator for an MCP server candidate +// Experimental: CatalogMCPServerCandidateKind is part of an experimental API and may change +// or be removed. +type CatalogMCPServerCandidateKind string const ( - // Tail-first: return the newest events and page toward older events. - EventsReadDirectionBackward EventsReadDirection = "backward" - // Page from the cursor toward newer events (default). - EventsReadDirectionForward EventsReadDirection = "forward" + // An MCP server. + CatalogMCPServerCandidateKindMCPServer CatalogMCPServerCandidateKind = "mcp-server" ) -// Discovery source: project (.github/extensions/), user (~/.copilot/extensions/), plugin -// (installed plugin), or session (session-state//extensions/) -// Experimental: ExtensionSource is part of an experimental API and may change or be removed. -type ExtensionSource string +// Whether an MCP server candidate can be planned for installation +// Experimental: CatalogMCPServerInstallability is part of an experimental API and may +// change or be removed. +type CatalogMCPServerInstallability string const ( - // Extension contributed by an installed plugin. - ExtensionSourcePlugin ExtensionSource = "plugin" - // Extension discovered from the current project's .github/extensions directory. - ExtensionSourceProject ExtensionSource = "project" - // Extension discovered from the current session's state directory (loaded only for this - // session). - ExtensionSourceSession ExtensionSource = "session" - // Extension discovered from the user's ~/.copilot/extensions directory. - ExtensionSourceUser ExtensionSource = "user" + // An install plan can be computed for this MCP server candidate. + CatalogMCPServerInstallabilityInstallable CatalogMCPServerInstallability = "installable" + // Policy forbids installing this MCP server candidate. + CatalogMCPServerInstallabilityNotInstallablePolicy CatalogMCPServerInstallability = "not-installable-policy" ) -// Current status: running, disabled, failed, or starting -// Experimental: ExtensionStatus is part of an experimental API and may change or be removed. -type ExtensionStatus string +// Media type a catalog card is interpreted as +// Experimental: CatalogMediaType is part of an experimental API and may change or be +// removed. +type CatalogMediaType string const ( - // The extension is installed but disabled. - ExtensionStatusDisabled ExtensionStatus = "disabled" - // The extension failed to start or crashed. - ExtensionStatusFailed ExtensionStatus = "failed" - // The extension process is running. - ExtensionStatusRunning ExtensionStatus = "running" - // The extension process is starting. - ExtensionStatusStarting ExtensionStatus = "starting" + // An AI skill card. Representable and searchable, but typed non-installable. + CatalogMediaTypeApplicationAiSkill CatalogMediaType = "application/ai-skill" + // The current MCP server card media type. + CatalogMediaTypeApplicationMCPServerCardJSON CatalogMediaType = "application/mcp-server-card+json" + // The legacy MCP server card media type, accepted for compatibility. + CatalogMediaTypeApplicationMCPServerJSON CatalogMediaType = "application/mcp-server+json" + // An inert Agent Plugin descriptor. + CatalogMediaTypeApplicationVndGitHubCopilotPlugin CatalogMediaType = "application/vnd.github.copilot-plugin" ) -// Binary result type discriminator. Use "image" for images and "resource" for other binary -// data. -// Experimental: ExternalToolTextResultForLlmBinaryResultsForLlmType is part of an -// experimental API and may change or be removed. -type ExternalToolTextResultForLlmBinaryResultsForLlmType string +// Why capability and protocol-version negotiation refused a caller +// Experimental: CatalogNegotiationRefusedReason is part of an experimental API and may +// change or be removed. +type CatalogNegotiationRefusedReason string const ( - // Binary image data. - ExternalToolTextResultForLlmBinaryResultsForLlmTypeImage ExternalToolTextResultForLlmBinaryResultsForLlmType = "image" - // Other binary resource data. - ExternalToolTextResultForLlmBinaryResultsForLlmTypeResource ExternalToolTextResultForLlmBinaryResultsForLlmType = "resource" + // The caller requires at least one capability this runtime cannot honour. + CatalogNegotiationRefusedReasonUnsupportedCapability CatalogNegotiationRefusedReason = "unsupported-capability" + // The caller's protocol version is below the lowest this runtime serves. + CatalogNegotiationRefusedReasonUnsupportedProtocolVersion CatalogNegotiationRefusedReason = "unsupported-protocol-version" ) -// Theme variant this icon is intended for -// Experimental: ExternalToolTextResultForLlmContentResourceLinkIconTheme is part of an -// experimental API and may change or be removed. -type ExternalToolTextResultForLlmContentResourceLinkIconTheme string +// Categorised network failure, low cardinality so it can be aggregated without carrying a +// URL +// Experimental: CatalogNetworkFailureReason is part of an experimental API and may change +// or be removed. +type CatalogNetworkFailureReason string const ( - // Icon intended for dark themes. - ExternalToolTextResultForLlmContentResourceLinkIconThemeDark ExternalToolTextResultForLlmContentResourceLinkIconTheme = "dark" - // Icon intended for light themes. - ExternalToolTextResultForLlmContentResourceLinkIconThemeLight ExternalToolTextResultForLlmContentResourceLinkIconTheme = "light" + // The connection was refused or reset. + CatalogNetworkFailureReasonConnectionRefused CatalogNetworkFailureReason = "connection-refused" + // The authority's name could not be resolved. + CatalogNetworkFailureReasonDns CatalogNetworkFailureReason = "dns" + // The authority returned another status the runtime treats as a failure. + CatalogNetworkFailureReasonHTTPStatus CatalogNetworkFailureReason = "http-status" + // No network is available, so nothing was attempted. + CatalogNetworkFailureReasonOffline CatalogNetworkFailureReason = "offline" + // The configured proxy returned 407 and requires authentication. + CatalogNetworkFailureReasonProxyAuthenticationRequired CatalogNetworkFailureReason = "proxy-authentication-required" + // The authority rate-limited requests and supplied or implied a bounded cooldown. + CatalogNetworkFailureReasonRateLimited CatalogNetworkFailureReason = "rate-limited" + // A redirect was refused by the runtime's redirect policy. + CatalogNetworkFailureReasonRedirectRejected CatalogNetworkFailureReason = "redirect-rejected" + // The response exceeded the permitted size. + CatalogNetworkFailureReasonResponseTooLarge CatalogNetworkFailureReason = "response-too-large" + // The authority returned a transient 5xx response. + CatalogNetworkFailureReasonServiceUnavailable CatalogNetworkFailureReason = "service-unavailable" + // The request exceeded its time budget. + CatalogNetworkFailureReasonTimeout CatalogNetworkFailureReason = "timeout" + // The TLS handshake or certificate validation failed. + CatalogNetworkFailureReasonTls CatalogNetworkFailureReason = "tls" ) -// Type discriminator for ExternalToolTextResultForLlmContent. -type ExternalToolTextResultForLlmContentType string +// Why a discoverable candidate cannot be installed +// Experimental: CatalogNotInstallableReason is part of an experimental API and may change +// or be removed. +type CatalogNotInstallableReason string const ( - ExternalToolTextResultForLlmContentTypeAudio ExternalToolTextResultForLlmContentType = "audio" - ExternalToolTextResultForLlmContentTypeImage ExternalToolTextResultForLlmContentType = "image" - ExternalToolTextResultForLlmContentTypeResource ExternalToolTextResultForLlmContentType = "resource" - ExternalToolTextResultForLlmContentTypeResourceLink ExternalToolTextResultForLlmContentType = "resource_link" - ExternalToolTextResultForLlmContentTypeShellExit ExternalToolTextResultForLlmContentType = "shell_exit" - ExternalToolTextResultForLlmContentTypeTerminal ExternalToolTextResultForLlmContentType = "terminal" - ExternalToolTextResultForLlmContentTypeText ExternalToolTextResultForLlmContentType = "text" + // AI skills are discoverable but have no typed importer in this phase. + CatalogNotInstallableReasonAiSkillNotInstallable CatalogNotInstallableReason = "ai-skill-not-installable" + // This kind of resource is not installable through this surface. + CatalogNotInstallableReasonKindNotInstallable CatalogNotInstallableReason = "kind-not-installable" + // Policy forbids installing this candidate. + CatalogNotInstallableReasonPolicyForbids CatalogNotInstallableReason = "policy-forbids" ) -// Execution-critical factory storage operation. -// Experimental: FactoryDurableOperation is part of an experimental API and may change or be -// removed. -type FactoryDurableOperation string +// Kind discriminator for CatalogSearchResult. +type CatalogSearchResultKind string const ( - // Persisting active execution time. - FactoryDurableOperationAddElapsed FactoryDurableOperation = "addElapsed" - // Persisting an idempotent model-usage charge. - FactoryDurableOperationChargeCredit FactoryDurableOperation = "chargeCredit" - // Creating the durable run and declared phases. - FactoryDurableOperationCreateRun FactoryDurableOperation = "createRun" - // Persisting the terminal run envelope. - FactoryDurableOperationFinishRun FactoryDurableOperation = "finishRun" - // Reading a journal entry without treating storage failure as a cache miss. - FactoryDurableOperationJournalGet FactoryDurableOperation = "journalGet" - // Persisting a journal entry before reporting success. - FactoryDurableOperationJournalPut FactoryDurableOperation = "journalPut" - // Persisting the transition to running. - FactoryDurableOperationMarkRunStarted FactoryDurableOperation = "markRunStarted" - // Reading the authoritative AI-credit total. - FactoryDurableOperationReconcileCreditTotal FactoryDurableOperation = "reconcileCreditTotal" - // Renewing the durable owner lease that proves this process still owns the run. - FactoryDurableOperationRefreshLease FactoryDurableOperation = "refreshLease" - // Rolling back an uncommitted subagent admission. - FactoryDurableOperationReleaseAgent FactoryDurableOperation = "releaseAgent" - // Persisting subagent admission accounting. - FactoryDurableOperationReserveAgent FactoryDurableOperation = "reserveAgent" + CatalogSearchResultKindAuthenticationRequired CatalogSearchResultKind = "authentication-required" + CatalogSearchResultKindContractViolation CatalogSearchResultKind = "contract-violation" + CatalogSearchResultKindInvalidRequest CatalogSearchResultKind = "invalid-request" + CatalogSearchResultKindMalformedCard CatalogSearchResultKind = "malformed-card" + CatalogSearchResultKindNegotiationRefused CatalogSearchResultKind = "negotiation-refused" + CatalogSearchResultKindNetworkFailure CatalogSearchResultKind = "network-failure" + CatalogSearchResultKindPolicyRejected CatalogSearchResultKind = "policy-rejected" + CatalogSearchResultKindSucceeded CatalogSearchResultKind = "succeeded" + CatalogSearchResultKindUnavailable CatalogSearchResultKind = "unavailable" + CatalogSearchResultKindUnsafeRetrieval CatalogSearchResultKind = "unsafe-retrieval" + CatalogSearchResultKindUnsupportedKind CatalogSearchResultKind = "unsupported-kind" ) -// Kind of factory progress line. -// Experimental: FactoryLogLineKind is part of an experimental API and may change or be -// removed. -type FactoryLogLineKind string +// Relationship of the backend-reported count to the complete query result set. +// Experimental: CatalogSearchTotalCountRelation is part of an experimental API and may +// change or be removed. +type CatalogSearchTotalCountRelation string const ( - // A narrator log line. - FactoryLogLineKindLog FactoryLogLineKind = "log" - // A named factory phase marker. - FactoryLogLineKindPhase FactoryLogLineKind = "phase" + // No exact/full-query or lower-bound guarantee is available. + CatalogSearchTotalCountRelationUnknown CatalogSearchTotalCountRelation = "unknown" ) -// Action the runtime selected for a durable factory pause checkpoint. -// Experimental: FactoryPauseCheckpointAction is part of an experimental API and may change -// or be removed. -type FactoryPauseCheckpointAction string +// Terminal outcome declared for a retained catalog selection group +// Experimental: CatalogSelectionDecision is part of an experimental API and may change or +// be removed. +type CatalogSelectionDecision string const ( - // The checkpoint was committed by a prior paused attempt, so execution may continue. - FactoryPauseCheckpointActionContinue FactoryPauseCheckpointAction = "continue" - // This attempt claimed the checkpoint and must cooperatively stop. - FactoryPauseCheckpointActionPause FactoryPauseCheckpointAction = "pause" + // Cancel the selection interaction without choosing a candidate. + CatalogSelectionDecisionCancelled CatalogSelectionDecision = "cancelled" + // Explicitly decline every candidate in the search. + CatalogSelectionDecisionDeclined CatalogSelectionDecision = "declined" + // Choose the candidate named by selectionRef. + CatalogSelectionDecisionSelected CatalogSelectionDecision = "selected" + // Declare that the host's live interaction deadline elapsed while the reference remained + // valid. + CatalogSelectionDecisionTimedOut CatalogSelectionDecision = "timed-out" ) -// Type discriminator for FactoryPauseInfo. -type FactoryPauseInfoType string +// Kind discriminator for CatalogSelectionResult. +type CatalogSelectionResultKind string const ( - FactoryPauseInfoTypeCheckpoint FactoryPauseInfoType = "checkpoint" - FactoryPauseInfoTypeUser FactoryPauseInfoType = "user" + CatalogSelectionResultKindCancelled CatalogSelectionResultKind = "cancelled" + CatalogSelectionResultKindDeclined CatalogSelectionResultKind = "declined" + CatalogSelectionResultKindForeign CatalogSelectionResultKind = "foreign" + CatalogSelectionResultKindInvalid CatalogSelectionResultKind = "invalid" + CatalogSelectionResultKindInvalidRequest CatalogSelectionResultKind = "invalid-request" + CatalogSelectionResultKindNegotiationRefused CatalogSelectionResultKind = "negotiation-refused" + CatalogSelectionResultKindReplayed CatalogSelectionResultKind = "replayed" + CatalogSelectionResultKindSelected CatalogSelectionResultKind = "selected" + CatalogSelectionResultKindStale CatalogSelectionResultKind = "stale" + CatalogSelectionResultKindTimedOut CatalogSelectionResultKind = "timed-out" + CatalogSelectionResultKindUnavailable CatalogSelectionResultKind = "unavailable" + CatalogSelectionResultKindWrongKind CatalogSelectionResultKind = "wrong-kind" ) -// Derived lifecycle state of a factory phase. -// Experimental: FactoryPhaseStatus is part of an experimental API and may change or be +// Authority-computed exposure eligibility, kept separate from tier. The current tier-only +// Agent Finder response maps to `unknown`, never to a locally inferred eligibility. +// Experimental: CatalogTrustEligibility is part of an experimental API and may change or be // removed. -type FactoryPhaseStatus string +type CatalogTrustEligibility string const ( - // The phase is currently entered and accumulating active time. - FactoryPhaseStatusActive FactoryPhaseStatus = "active" - // The phase was entered and has since been closed. - FactoryPhaseStatusCompleted FactoryPhaseStatus = "completed" - // The phase has not been entered yet. - FactoryPhaseStatusPending FactoryPhaseStatus = "pending" - // The phase was never entered because a later phase was entered or the run reached a - // terminal state. - FactoryPhaseStatusSkipped FactoryPhaseStatus = "skipped" + // Eligible for default catalogue exposure. + CatalogTrustEligibilityDefault CatalogTrustEligibility = "default" + // Eligible only when expanded or community results are requested. + CatalogTrustEligibilityExpanded CatalogTrustEligibility = "expanded" + // Not eligible for normal catalogue exposure. + CatalogTrustEligibilityHidden CatalogTrustEligibility = "hidden" + // The authority did not supply an eligibility decision. + CatalogTrustEligibilityUnknown CatalogTrustEligibility = "unknown" ) -// Cumulative resource ceiling that stopped a factory run. -// Experimental: FactoryRunFailureKind is part of an experimental API and may change or be -// removed. -type FactoryRunFailureKind string +// The authority omitted trust metadata. +// Experimental: CatalogTrustSnapshotAbsentStatus is part of an experimental API and may +// change or be removed. +type CatalogTrustSnapshotAbsentStatus string const ( - // The run's settled subagent model usage exceeded the approved AI-credit ceiling, or no - // headroom remained for another subagent. - FactoryRunFailureKindMaxAiCredits FactoryRunFailureKind = "maxAiCredits" - // The run admitted the approved maximum total number of subagents. - FactoryRunFailureKindMaxTotalSubagents FactoryRunFailureKind = "maxTotalSubagents" - // The run reached the approved accumulated active-execution time in seconds. - FactoryRunFailureKindTimeoutSeconds FactoryRunFailureKind = "timeoutSeconds" + // The authority omitted trust metadata. + CatalogTrustSnapshotAbsentStatusAbsent CatalogTrustSnapshotAbsentStatus = "absent" ) -// Type discriminator for FactoryRunFailure. -type FactoryRunFailureType string +// A recognised T1 or T2 service tier was observed. +// Experimental: CatalogTrustSnapshotCurrentStatus is part of an experimental API and may +// change or be removed. +type CatalogTrustSnapshotCurrentStatus string const ( - FactoryRunFailureTypeFactoryAccountingIncomplete FactoryRunFailureType = "factory_accounting_incomplete" - FactoryRunFailureTypeFactoryDurableFailure FactoryRunFailureType = "factory_durable_failure" - FactoryRunFailureTypeFactoryLimitReached FactoryRunFailureType = "factory_limit_reached" - FactoryRunFailureTypeFactoryProviderDisconnected FactoryRunFailureType = "factory_provider_disconnected" - FactoryRunFailureTypeFactoryResumeDeclined FactoryRunFailureType = "factory_resume_declined" + // A recognised T1 or T2 service tier was observed. + CatalogTrustSnapshotCurrentStatusCurrent CatalogTrustSnapshotCurrentStatus = "current" ) -// Current or terminal state of a factory run. -// Experimental: FactoryRunStatus is part of an experimental API and may change or be -// removed. -type FactoryRunStatus string +// The authority explicitly reported a downgraded assessment. +// Experimental: CatalogTrustSnapshotDowngradedStatus is part of an experimental API and may +// change or be removed. +type CatalogTrustSnapshotDowngradedStatus string const ( - // The run was cancelled before completion. - FactoryRunStatusCancelled FactoryRunStatus = "cancelled" - // The run completed successfully. - FactoryRunStatusCompleted FactoryRunStatus = "completed" - // The factory body failed or reached a cumulative resource ceiling. - FactoryRunStatusError FactoryRunStatus = "error" - // The run was interrupted while resource budget remained. - FactoryRunStatusHalted FactoryRunStatus = "halted" - // The current attempt stopped intentionally and the run may be resumed. - FactoryRunStatusPaused FactoryRunStatus = "paused" - // The run was minted and is awaiting approval. - FactoryRunStatusPending FactoryRunStatus = "pending" - // The run is executing. - FactoryRunStatusRunning FactoryRunStatus = "running" + // The authority explicitly reported a downgraded assessment. + CatalogTrustSnapshotDowngradedStatusDowngraded CatalogTrustSnapshotDowngradedStatus = "downgraded" ) -// Why the runtime is requesting a GitHub credential. -// Experimental: GitHubTokenAcquireReason is part of an experimental API and may change or -// be removed. -type GitHubTokenAcquireReason string +// The trust field was empty, unbounded, or had the wrong JSON type. +// Experimental: CatalogTrustSnapshotMalformedStatus is part of an experimental API and may +// change or be removed. +type CatalogTrustSnapshotMalformedStatus string const ( - // The runtime is acquiring the registration's first credential. - GitHubTokenAcquireReasonInitial GitHubTokenAcquireReason = "initial" - // The runtime is replacing a credential that is approaching expiry. - GitHubTokenAcquireReasonRefresh GitHubTokenAcquireReason = "refresh" + // The trust field was empty, unbounded, or had the wrong JSON type. + CatalogTrustSnapshotMalformedStatusMalformed CatalogTrustSnapshotMalformedStatus = "malformed" ) -// Kind discriminator for GitHubTokenAcquireResult. -// Experimental: GitHubTokenAcquireResultKind is part of an experimental API and may change -// or be removed. -type GitHubTokenAcquireResultKind string +// The authority explicitly revoked its assessment. +// Experimental: CatalogTrustSnapshotRevokedStatus is part of an experimental API and may +// change or be removed. +type CatalogTrustSnapshotRevokedStatus string const ( - GitHubTokenAcquireResultKindCancelled GitHubTokenAcquireResultKind = "cancelled" - GitHubTokenAcquireResultKindToken GitHubTokenAcquireResultKind = "token" + // The authority explicitly revoked its assessment. + CatalogTrustSnapshotRevokedStatusRevoked CatalogTrustSnapshotRevokedStatus = "revoked" ) -// What initiated this compaction request, recorded as the `trigger` on the persisted -// `session.compaction_start` / `session.compaction_complete` events. When absent, the -// compaction is persisted without trigger attribution (initiator unknown). -type HistoryCompactRequestTrigger string +// SchemaVersion discriminator for CatalogTrustSnapshot. +// Experimental: CatalogTrustSnapshotSchemaVersion is part of an experimental API and may +// change or be removed. +type CatalogTrustSnapshotSchemaVersion string const ( - // User-requested compaction, e.g. the /compact command or a direct history.compact call. - HistoryCompactRequestTriggerManual HistoryCompactRequestTrigger = "manual" - // Compaction requested while switching to a model with a smaller context window. - HistoryCompactRequestTriggerModelSwitch HistoryCompactRequestTrigger = "model_switch" + CatalogTrustSnapshotSchemaVersionV1 CatalogTrustSnapshotSchemaVersion = "v1" ) -// Reason a captured file was not restored. -// Experimental: HistoryFileRestoreSkipReason is part of an experimental API and may change -// or be removed. -type HistoryFileRestoreSkipReason string +// The authority explicitly marked its assessment stale. +// Experimental: CatalogTrustSnapshotStaleStatus is part of an experimental API and may +// change or be removed. +type CatalogTrustSnapshotStaleStatus string const ( - // A faithful preimage was not captured. - HistoryFileRestoreSkipReasonSkippedCapture HistoryFileRestoreSkipReason = "skipped-capture" - // The file changed after Copilot's last captured write. - HistoryFileRestoreSkipReasonUserModified HistoryFileRestoreSkipReason = "user-modified" + // The authority explicitly marked its assessment stale. + CatalogTrustSnapshotStaleStatusStale CatalogTrustSnapshotStaleStatus = "stale" ) -// Aggregate file change represented by a rewind preview. -// Experimental: HistoryRewindChangeType is part of an experimental API and may change or be -// removed. -type HistoryRewindChangeType string +// The authority supplied a bounded trust value this runtime does not understand. +// Experimental: CatalogTrustSnapshotUnsupportedStatus is part of an experimental API and +// may change or be removed. +type CatalogTrustSnapshotUnsupportedStatus string const ( - // The discarded turns created the file. - HistoryRewindChangeTypeCreated HistoryRewindChangeType = "created" - // The discarded turns deleted the file. - HistoryRewindChangeTypeDeleted HistoryRewindChangeType = "deleted" - // The discarded turns modified the file. - HistoryRewindChangeTypeModified HistoryRewindChangeType = "modified" + // The authority supplied a bounded trust value this runtime does not understand. + CatalogTrustSnapshotUnsupportedStatusUnsupported CatalogTrustSnapshotUnsupportedStatus = "unsupported" ) -// Scope of a rewind operation. -// Experimental: HistoryRewindMode is part of an experimental API and may change or be +// Bounded authority that supplied a catalogue trust observation +// Experimental: CatalogTrustSource is part of an experimental API and may change or be // removed. -type HistoryRewindMode string +type CatalogTrustSource string const ( - // Discard conversation events while leaving files unchanged. - HistoryRewindModeConversation HistoryRewindMode = "conversation" - // Discard conversation events and restore captured files changed by those turns. - HistoryRewindModeConversationAndFiles HistoryRewindMode = "conversation-and-files" + // GitHub Agent Finder supplied the trust field on its search result. + CatalogTrustSourceAgentFinder CatalogTrustSource = "agent-finder" ) -// Outcome of a rewind request. -// Experimental: HistoryRewindOutcome is part of an experimental API and may change or be +// Service-computed trust tier currently emitted by Agent Finder. It is independent of +// search score, popularity, and client-side ranking. +// Experimental: CatalogTrustTier is part of an experimental API and may change or be // removed. -type HistoryRewindOutcome string +type CatalogTrustTier string const ( - // The conversation was rewound (and, in conversation-and-files mode, captured files were - // restored), but persisted checkpoints could not be cleaned up; reachable in either mode. - HistoryRewindOutcomeCheckpointCleanupFailed HistoryRewindOutcome = "checkpoint-cleanup-failed" - // A conversation-and-files rewind was requested for a session that did not enable capture; - // conversation-only rewinds never produce this. - HistoryRewindOutcomeFileChangeTrackingDisabled HistoryRewindOutcome = "file-change-tracking-disabled" - // File restore failed and all applied file changes were rolled back; only - // conversation-and-files rewinds produce this. - HistoryRewindOutcomeFilesRolledBack HistoryRewindOutcome = "files-rolled-back" - // File restore failed and its rollback could not fully restore the pre-rewind state; only - // conversation-and-files rewinds produce this. - HistoryRewindOutcomeRollbackIncomplete HistoryRewindOutcome = "rollback-incomplete" - // The session still has work that may mutate files or history; reachable in either mode. - HistoryRewindOutcomeSessionBusy HistoryRewindOutcome = "session-busy" - // Files and conversation were rewound, but obsolete file snapshots could not be removed; - // only conversation-and-files rewinds produce this. - HistoryRewindOutcomeSnapshotPruneFailed HistoryRewindOutcome = "snapshot-prune-failed" - // The requested rewind completed; reachable in either mode. - HistoryRewindOutcomeSuccess HistoryRewindOutcome = "success" - // Conversation truncation failed. In conversation-and-files mode any files that were - // restored are left in place because conversation history cannot be un-truncated; in - // conversation-only mode no files are restored. Consult restoredFiles for what, if - // anything, was applied. - HistoryRewindOutcomeTruncationFailed HistoryRewindOutcome = "truncation-failed" - // Remote-backed rewind routing is not supported; reachable in either mode. - HistoryRewindOutcomeUnsupportedRemoteSession HistoryRewindOutcome = "unsupported-remote-session" + // Tier one as assigned by the catalogue authority. + CatalogTrustTierT1 CatalogTrustTier = "T1" + // Tier two as assigned by the catalogue authority. + CatalogTrustTierT2 CatalogTrustTier = "T2" ) -// Reason a rewind read (rewind points, file-restore preview, or session diff) could not be -// answered from the session's file-change captures. -// Experimental: HistoryRewindUnavailableReason is part of an experimental API and may -// change or be removed. -type HistoryRewindUnavailableReason string +// Why a catalog operation is not available on this runtime +// Experimental: CatalogUnavailableReason is part of an experimental API and may change or +// be removed. +type CatalogUnavailableReason string const ( - // The session did not opt into file-change tracking before its first turn. - HistoryRewindUnavailableReasonFileChangeTrackingDisabled HistoryRewindUnavailableReason = "file-change-tracking-disabled" - // The session still has work that may mutate files or history. Transient: the same request - // succeeds once the session settles, so callers should retry rather than treat it as a - // failure. - HistoryRewindUnavailableReasonSessionBusy HistoryRewindUnavailableReason = "session-busy" - // Remote-backed rewind routing is not supported. - HistoryRewindUnavailableReasonUnsupportedRemoteSession HistoryRewindUnavailableReason = "unsupported-remote-session" + // No catalog authority is configured for this runtime. + CatalogUnavailableReasonAuthorityNotConfigured CatalogUnavailableReason = "authority-not-configured" + // The surface is disabled by policy on this runtime. + CatalogUnavailableReasonDisabledByPolicy CatalogUnavailableReason = "disabled-by-policy" + // Install planning is not wired up on this runtime build. + CatalogUnavailableReasonPlanningUnavailable CatalogUnavailableReason = "planning-unavailable" + // Bounded search is not wired up on this runtime build. + CatalogUnavailableReasonSearchUnavailable CatalogUnavailableReason = "search-unavailable" + // Exact candidate selection is not available in this session or runtime. + CatalogUnavailableReasonSelectionUnavailable CatalogUnavailableReason = "selection-unavailable" ) -// Authentication host. HMAC auth always targets the public GitHub host. -type HMACAuthInfoHost string +// Why no usable transport could be offered +// Experimental: CatalogUnavailableTransportReason is part of an experimental API and may +// change or be removed. +type CatalogUnavailableTransportReason string const ( - HMACAuthInfoHostHTTPSGitHubCom HMACAuthInfoHost = "https://github.com" + // The card advertises no transport this runtime can use. + CatalogUnavailableTransportReasonNoEligibleTransport CatalogUnavailableTransportReason = "no-eligible-transport" + // Eligible remotes could not be enumerated, so no explicit choice can be offered. + CatalogUnavailableTransportReasonRemoteEnumerationUnavailable CatalogUnavailableTransportReason = "remote-enumeration-unavailable" + // Every advertised transport is of a kind this runtime does not implement. + CatalogUnavailableTransportReasonTransportNotSupported CatalogUnavailableTransportReason = "transport-not-supported" ) -// Configuration tier that contributed a discovered hook action. -// Experimental: HookOrigin is part of an experimental API and may change or be removed. -type HookOrigin string +// Which hardened-fetch control refused a retrieval +// Experimental: CatalogUnsafeRetrievalReason is part of an experimental API and may change +// or be removed. +type CatalogUnsafeRetrievalReason string const ( - // Hook provided by an enabled installed or explicit plugin. Projectless rows omit - // projectPath and do not expand a project directory. - HookOriginPlugin HookOrigin = "plugin" - // Hook enforced by centrally managed policy. - HookOriginPolicy HookOrigin = "policy" - // Hook loaded from repository settings or the repository hook directory. - HookOriginRepository HookOrigin = "repository" - // Hook loaded from user settings or the user's hook directory. - HookOriginUser HookOrigin = "user" + // The URL resolved to a loopback, private, link-local, or cloud metadata address. + CatalogUnsafeRetrievalReasonBlockedAddress CatalogUnsafeRetrievalReason = "blocked-address" + // The URL used a scheme the runtime refuses to fetch. + CatalogUnsafeRetrievalReasonBlockedScheme CatalogUnsafeRetrievalReason = "blocked-scheme" + // The URL embedded credentials. + CatalogUnsafeRetrievalReasonCredentialsInURL CatalogUnsafeRetrievalReason = "credentials-in-url" + // The authority is not permitted for card retrieval. + CatalogUnsafeRetrievalReasonHostNotPermitted CatalogUnsafeRetrievalReason = "host-not-permitted" + // The configured proxy policy refused the request. + CatalogUnsafeRetrievalReasonProxyRejected CatalogUnsafeRetrievalReason = "proxy-rejected" + // A redirect target resolved to a blocked address. + CatalogUnsafeRetrievalReasonRedirectToBlockedAddress CatalogUnsafeRetrievalReason = "redirect-to-blocked-address" ) -// Hook event name. Discovery emits the file-configurable subset; SDK callbacks additionally -// support callback-only events. -// Experimental: HookType is part of an experimental API and may change or be removed. -type HookType string +// Why the runtime requests client-task cancellation. +// Experimental: ClientTaskCancelReason is part of an experimental API and may change or be +// removed. +type ClientTaskCancelReason string const ( - // Runs when the agent stops. - HookTypeAgentStop HookType = "agentStop" - // Runs when the agent encounters an error. - HookTypeErrorOccurred HookType = "errorOccurred" - // Runs when the agent emits a notification. - HookTypeNotification HookType = "notification" - // Runs when the agent requests permission. - HookTypePermissionRequest HookType = "permissionRequest" - // Runs after an agent result is produced. - HookTypePostResult HookType = "postResult" - // Runs after a tool completes successfully. - HookTypePostToolUse HookType = "postToolUse" - // Runs after a tool fails. - HookTypePostToolUseFailure HookType = "postToolUseFailure" - // Runs before conversation context is compacted. - HookTypePreCompact HookType = "preCompact" - // Runs before an MCP tool is invoked. - HookTypePreMCPToolCall HookType = "preMcpToolCall" - // Runs before a pull request description is generated. - HookTypePrePRDescription HookType = "prePRDescription" - // Runs before a tool is invoked. - HookTypePreToolUse HookType = "preToolUse" - // Runs when a session ends. - HookTypeSessionEnd HookType = "sessionEnd" - // Runs when a session starts. - HookTypeSessionStart HookType = "sessionStart" - // Runs when a subagent starts. - HookTypeSubagentStart HookType = "subagentStart" - // Runs when a subagent stops. - HookTypeSubagentStop HookType = "subagentStop" - // Runs after the user submits a prompt. - HookTypeUserPromptSubmitted HookType = "userPromptSubmitted" - // Runs after the runtime transforms the submitted prompt for the model, before it is added - // to session history. - HookTypeUserPromptTransformed HookType = "userPromptTransformed" + // A caller requested task cancellation. + ClientTaskCancelReasonCancelRequested ClientTaskCancelReason = "cancel_requested" + // The session is shutting down. + ClientTaskCancelReasonSessionShutdown ClientTaskCancelReason = "session_shutdown" ) -// Constant value. Always "github". -type InstalledPluginSourceGitHubSource string +// Whether a pending slash-command invocation effect was applied or cancelled by the host. +// Experimental: CommandsInvocationEffectOutcome is part of an experimental API and may +// change or be removed. +type CommandsInvocationEffectOutcome string const ( - InstalledPluginSourceGitHubSourceGitHub InstalledPluginSourceGitHubSource = "github" + // The host applied the pending invocation effect. + CommandsInvocationEffectOutcomeApplied CommandsInvocationEffectOutcome = "applied" + // The host cancelled the pending invocation effect, so any provisional state must be + // reverted. + CommandsInvocationEffectOutcomeCancelled CommandsInvocationEffectOutcome = "cancelled" ) -// Constant value. Always "local". -type InstalledPluginSourceLocalSource string +// Experimental: CommandsInvocationOrigin is part of an experimental API and may change or +// be removed. +type CommandsInvocationOrigin string const ( - InstalledPluginSourceLocalSourceLocal InstalledPluginSourceLocalSource = "local" + CommandsInvocationOriginSettings CommandsInvocationOrigin = "settings" ) -// Constant value. Always "url". -type InstalledPluginSourceURLSource string +// Neutral SDK discriminator for the connected remote session kind. +// Experimental: ConnectedRemoteSessionMetadataKind is part of an experimental API and may +// change or be removed. +type ConnectedRemoteSessionMetadataKind string const ( - InstalledPluginSourceURLSourceURL InstalledPluginSourceURLSource = "url" + // GitHub Copilot coding agent session. + ConnectedRemoteSessionMetadataKindCodingAgent ConnectedRemoteSessionMetadataKind = "coding-agent" + // Remote CLI session. + ConnectedRemoteSessionMetadataKindRemoteSession ConnectedRemoteSessionMetadataKind = "remote-session" ) -// Whether the target is a single file or a directory of instruction files -// Experimental: InstructionDiscoveryPathKind is part of an experimental API and may change -// or be removed. -type InstructionDiscoveryPathKind string +// Controls how MCP tool result content is filtered: none leaves content unchanged, markdown +// sanitizes HTML while preserving Markdown-friendly output, and hidden_characters removes +// characters that can hide directives. +// Experimental: ContentFilterMode is part of an experimental API and may change or be +// removed. +type ContentFilterMode string const ( - // The target is a directory that holds instruction files. - InstructionDiscoveryPathKindDirectory InstructionDiscoveryPathKind = "directory" - // The target is a single instruction file. - InstructionDiscoveryPathKindFile InstructionDiscoveryPathKind = "file" + // Remove characters that can hide directives. + ContentFilterModeHiddenCharacters ContentFilterMode = "hidden_characters" + // Sanitize HTML while preserving Markdown-friendly output. + ContentFilterModeMarkdown ContentFilterMode = "markdown" + // Leave MCP tool result content unchanged. + ContentFilterModeNone ContentFilterMode = "none" ) -// Which tier this target belongs to -// Experimental: InstructionDiscoveryPathLocation is part of an experimental API and may -// change or be removed. -type InstructionDiscoveryPathLocation string +// Context tier for models that support multiple context-window sizes. +// Experimental: ContextTier is part of an experimental API and may change or be removed. +type ContextTier string const ( - // Instructions live in plugin-provided configuration. - InstructionDiscoveryPathLocationPlugin InstructionDiscoveryPathLocation = "plugin" - // Instructions live in repository-level configuration. - InstructionDiscoveryPathLocationRepository InstructionDiscoveryPathLocation = "repository" - // Instructions live in user-level configuration. - InstructionDiscoveryPathLocationUser InstructionDiscoveryPathLocation = "user" - // Instructions live under the current working directory. - InstructionDiscoveryPathLocationWorkingDirectory InstructionDiscoveryPathLocation = "working-directory" + // Use the model's default context window. + ContextTierDefault ContextTier = "default" + // Pin the session to the long-context tier when supported. + ContextTierLongContext ContextTier = "long_context" ) -// Where this source lives — used for UI grouping -// Experimental: InstructionSourceLocation is part of an experimental API and may change or -// be removed. -type InstructionSourceLocation string +// Authentication host (always the public GitHub host). +type CopilotAPITokenAuthInfoHost string const ( - // Instructions live in plugin-provided configuration. - InstructionSourceLocationPlugin InstructionSourceLocation = "plugin" - // Instructions live in repository-level configuration. - InstructionSourceLocationRepository InstructionSourceLocation = "repository" - // Instructions live in user-level configuration. - InstructionSourceLocationUser InstructionSourceLocation = "user" - // Instructions live under the current working directory. - InstructionSourceLocationWorkingDirectory InstructionSourceLocation = "working-directory" + CopilotAPITokenAuthInfoHostHTTPSGitHubCom CopilotAPITokenAuthInfoHost = "https://github.com" ) -// Category of instruction source — used for merge logic -// Experimental: InstructionSourceType is part of an experimental API and may change or be -// removed. -type InstructionSourceType string +// Kind discriminator for DebugCollectLogsDestination. +type DebugCollectLogsDestinationKind string const ( - // Instructions inherited from child instruction files. - InstructionSourceTypeChildInstructions InstructionSourceType = "child-instructions" - // Instructions loaded from the user's home configuration. - InstructionSourceTypeHome InstructionSourceType = "home" - // Instructions loaded from model-specific files. - InstructionSourceTypeModel InstructionSourceType = "model" - // Instructions discovered from nested agent files. - InstructionSourceTypeNestedAgents InstructionSourceType = "nested-agents" - // Instructions supplied by an installed plugin. - InstructionSourceTypePlugin InstructionSourceType = "plugin" - // Instructions loaded from repository-scoped files. - InstructionSourceTypeRepo InstructionSourceType = "repo" - // Instructions loaded from VS Code instruction files. - InstructionSourceTypeVscode InstructionSourceType = "vscode" + DebugCollectLogsDestinationKindArchive DebugCollectLogsDestinationKind = "archive" + DebugCollectLogsDestinationKindDirectory DebugCollectLogsDestinationKind = "directory" ) -// 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. -// Experimental: LlmInferenceHTTPRequestStartTransport is part of an experimental API and -// may change or be removed. -type LlmInferenceHTTPRequestStartTransport string +// Kind of caller-provided debug log entry. +// Experimental: DebugCollectLogsEntryKind is part of an experimental API and may change or +// be removed. +type DebugCollectLogsEntryKind string const ( - // Plain HTTP or SSE response. Each body chunk is an opaque byte range; the response is a - // status line, headers, and a (possibly streamed) body. - LlmInferenceHTTPRequestStartTransportHTTP LlmInferenceHTTPRequestStartTransport = "http" - // Full-duplex WebSocket channel. Each body chunk maps to exactly one WebSocket message and - // the `binary` flag distinguishes text from binary frames; request and response chunks flow - // concurrently. - LlmInferenceHTTPRequestStartTransportWebsocket LlmInferenceHTTPRequestStartTransport = "websocket" + // Include files from a server-local directory recursively. + DebugCollectLogsEntryKindDirectory DebugCollectLogsEntryKind = "directory" + // Include a single server-local file. + DebugCollectLogsEntryKindFile DebugCollectLogsEntryKind = "file" ) -// Allowed values for the `McpAppsHostContextDetailsAvailableDisplayMode` enumeration. -// Experimental: MCPAppsHostContextDetailsAvailableDisplayMode is part of an experimental -// API and may change or be removed. -type MCPAppsHostContextDetailsAvailableDisplayMode string +// How a collected debug entry should be redacted before being staged. +// Experimental: DebugCollectLogsRedaction is part of an experimental API and may change or +// be removed. +type DebugCollectLogsRedaction string const ( - // Rendered as a fullscreen overlay - MCPAppsHostContextDetailsAvailableDisplayModeFullscreen MCPAppsHostContextDetailsAvailableDisplayMode = "fullscreen" - // Rendered inline within the host conversation surface - MCPAppsHostContextDetailsAvailableDisplayModeInline MCPAppsHostContextDetailsAvailableDisplayMode = "inline" - // Rendered as a picture-in-picture floating panel - MCPAppsHostContextDetailsAvailableDisplayModePip MCPAppsHostContextDetailsAvailableDisplayMode = "pip" + // Redact each non-empty line as a session event JSON object, falling back to plain-text + // redaction for malformed lines. + DebugCollectLogsRedactionEventsJsonl DebugCollectLogsRedaction = "events-jsonl" + // No redaction is applied. The caller must ensure any necessary redaction is performed + // before this call. + DebugCollectLogsRedactionNone DebugCollectLogsRedaction = "none" + // Redact the file as plain UTF-8 log text. + DebugCollectLogsRedactionPlainText DebugCollectLogsRedaction = "plain-text" ) -// Current display mode (SEP-1865) -// Experimental: MCPAppsHostContextDetailsDisplayMode is part of an experimental API and may -// change or be removed. -type MCPAppsHostContextDetailsDisplayMode string +// Destination kind that was written. +// Experimental: DebugCollectLogsResultKind is part of an experimental API and may change or +// be removed. +type DebugCollectLogsResultKind string const ( - // Rendered as a fullscreen overlay - MCPAppsHostContextDetailsDisplayModeFullscreen MCPAppsHostContextDetailsDisplayMode = "fullscreen" - // Rendered inline within the host conversation surface - MCPAppsHostContextDetailsDisplayModeInline MCPAppsHostContextDetailsDisplayMode = "inline" - // Rendered as a picture-in-picture floating panel - MCPAppsHostContextDetailsDisplayModePip MCPAppsHostContextDetailsDisplayMode = "pip" + // A .tgz archive was written. + DebugCollectLogsResultKindArchive DebugCollectLogsResultKind = "archive" + // A directory containing the collected files was written. + DebugCollectLogsResultKindDirectory DebugCollectLogsResultKind = "directory" ) -// Platform type for responsive design -// Experimental: MCPAppsHostContextDetailsPlatform is part of an experimental API and may -// change or be removed. -type MCPAppsHostContextDetailsPlatform string +// Source category for a collected debug bundle entry. +// Experimental: DebugCollectLogsSource is part of an experimental API and may change or be +// removed. +type DebugCollectLogsSource string const ( - // Host runs as a desktop application - MCPAppsHostContextDetailsPlatformDesktop MCPAppsHostContextDetailsPlatform = "desktop" - // Host runs on a mobile device - MCPAppsHostContextDetailsPlatformMobile MCPAppsHostContextDetailsPlatform = "mobile" - // Host runs in a web browser - MCPAppsHostContextDetailsPlatformWeb MCPAppsHostContextDetailsPlatform = "web" + // Caller-provided diagnostic entry. + DebugCollectLogsSourceAdditional DebugCollectLogsSource = "additional" + // Session event log. + DebugCollectLogsSourceEvents DebugCollectLogsSource = "events" + // Process log for the session. + DebugCollectLogsSourceProcessLog DebugCollectLogsSource = "process-log" + // Interactive shell log for the session. + DebugCollectLogsSourceShellLog DebugCollectLogsSource = "shell-log" ) -// UI theme preference per SEP-1865 -// Experimental: MCPAppsHostContextDetailsTheme is part of an experimental API and may -// change or be removed. -type MCPAppsHostContextDetailsTheme string +// Effective extension loading and agent-management mode +// Experimental: DiscoveredExtensionMode is part of an experimental API and may change or be +// removed. +type DiscoveredExtensionMode string const ( - // Dark UI theme - MCPAppsHostContextDetailsThemeDark MCPAppsHostContextDetailsTheme = "dark" - // Light UI theme - MCPAppsHostContextDetailsThemeLight MCPAppsHostContextDetailsTheme = "light" + // Extensions are not loaded. + DiscoveredExtensionModeDisabled DiscoveredExtensionMode = "disabled" + // Extensions are loaded and the agent can create, reload, and manage them. + DiscoveredExtensionModeLoadAndAugment DiscoveredExtensionMode = "load_and_augment" + // Extensions are loaded, but the agent cannot create, reload, or manage them. + DiscoveredExtensionModeLoadOnly DiscoveredExtensionMode = "load_only" ) -// Allowed values for the `McpAppsSetHostContextDetailsAvailableDisplayMode` enumeration. -// Experimental: MCPAppsSetHostContextDetailsAvailableDisplayMode is part of an experimental -// API and may change or be removed. -type MCPAppsSetHostContextDetailsAvailableDisplayMode string +// Persisted extension discovery source +// Experimental: DiscoveredExtensionSource is part of an experimental API and may change or +// be removed. +type DiscoveredExtensionSource string const ( - // Rendered as a fullscreen overlay - MCPAppsSetHostContextDetailsAvailableDisplayModeFullscreen MCPAppsSetHostContextDetailsAvailableDisplayMode = "fullscreen" - // Rendered inline within the host conversation surface - MCPAppsSetHostContextDetailsAvailableDisplayModeInline MCPAppsSetHostContextDetailsAvailableDisplayMode = "inline" - // Rendered as a picture-in-picture floating panel - MCPAppsSetHostContextDetailsAvailableDisplayModePip MCPAppsSetHostContextDetailsAvailableDisplayMode = "pip" + // Extension contributed by an installed plugin. + DiscoveredExtensionSourcePlugin DiscoveredExtensionSource = "plugin" + // Extension discovered from the user's extensions directory. + DiscoveredExtensionSourceUser DiscoveredExtensionSource = "user" ) -// Current display mode (SEP-1865) -// Experimental: MCPAppsSetHostContextDetailsDisplayMode is part of an experimental API and -// may change or be removed. -type MCPAppsSetHostContextDetailsDisplayMode string +// Server transport type: stdio, http, sse (deprecated), or memory +// Experimental: DiscoveredMCPServerType is part of an experimental API and may change or be +// removed. +type DiscoveredMCPServerType string const ( - // Rendered as a fullscreen overlay - MCPAppsSetHostContextDetailsDisplayModeFullscreen MCPAppsSetHostContextDetailsDisplayMode = "fullscreen" - // Rendered inline within the host conversation surface - MCPAppsSetHostContextDetailsDisplayModeInline MCPAppsSetHostContextDetailsDisplayMode = "inline" - // Rendered as a picture-in-picture floating panel - MCPAppsSetHostContextDetailsDisplayModePip MCPAppsSetHostContextDetailsDisplayMode = "pip" + // Server communicates over streamable HTTP. + DiscoveredMCPServerTypeHTTP DiscoveredMCPServerType = "http" + // Server is backed by an in-memory runtime implementation. + DiscoveredMCPServerTypeMemory DiscoveredMCPServerType = "memory" + // Server communicates over Server-Sent Events (deprecated). + DiscoveredMCPServerTypeSSE DiscoveredMCPServerType = "sse" + // Server communicates over stdio with a local child process. + DiscoveredMCPServerTypeStdio DiscoveredMCPServerType = "stdio" ) -// Platform type for responsive design -// Experimental: MCPAppsSetHostContextDetailsPlatform is part of an experimental API and may -// change or be removed. -type MCPAppsSetHostContextDetailsPlatform string +type EventLogTypesString string const ( - // Host runs as a desktop application - MCPAppsSetHostContextDetailsPlatformDesktop MCPAppsSetHostContextDetailsPlatform = "desktop" - // Host runs on a mobile device - MCPAppsSetHostContextDetailsPlatformMobile MCPAppsSetHostContextDetailsPlatform = "mobile" - // Host runs in a web browser - MCPAppsSetHostContextDetailsPlatformWeb MCPAppsSetHostContextDetailsPlatform = "web" + EventLogTypesStringValue EventLogTypesString = "*" ) -// UI theme preference per SEP-1865 -// Experimental: MCPAppsSetHostContextDetailsTheme is part of an experimental API and may -// change or be removed. -type MCPAppsSetHostContextDetailsTheme string +// Agent-scope filter: 'primary' returns only main-agent events plus events whose type +// starts with 'subagent.' (matching the typed-subscription default behavior); 'all' returns +// events from all agents (matching wildcard-subscription behavior). Default is 'all' to +// preserve wildcard semantics for catch-up callers. +// Experimental: EventsAgentScope is part of an experimental API and may change or be +// removed. +type EventsAgentScope string const ( - // Dark UI theme - MCPAppsSetHostContextDetailsThemeDark MCPAppsSetHostContextDetailsTheme = "dark" - // Light UI theme - MCPAppsSetHostContextDetailsThemeLight MCPAppsSetHostContextDetailsTheme = "light" + // Return events from all agents. + EventsAgentScopeAll EventsAgentScope = "all" + // Return main-agent events and typed subagent lifecycle events. + EventsAgentScopePrimary EventsAgentScope = "primary" ) -// Structured MCP elicitation mode. -// Experimental: MCPElicitationFormMode is part of an experimental API and may change or be +// Cursor status: 'ok' means the read succeeded against the requested history; 'expired' +// means the requested continuation is unavailable. Recovery is endpoint-specific: +// session.eventLog.read returns a boundary window of remaining active history that may +// overlap prior pages, while sessions.readPersistedEvents returns an empty terminal page +// and never switches journal generations. An expired persisted read is not successful +// completion; a complete persisted snapshot requires cursorStatus 'ok' and hasMore false. +// Experimental: EventsCursorStatus is part of an experimental API and may change or be // removed. -type MCPElicitationFormMode string +type EventsCursorStatus string const ( - MCPElicitationFormModeForm MCPElicitationFormMode = "form" + // The requested continuation is unavailable; see the endpoint's recovery semantics. + EventsCursorStatusExpired EventsCursorStatus = "expired" + // The read succeeded against the requested history. + EventsCursorStatusOk EventsCursorStatus = "ok" ) -// Kind discriminator for MCPHeadersHandlePendingHeadersRefreshRequest. -type MCPHeadersHandlePendingHeadersRefreshRequestKind string +// Direction to page through the session's persisted event history. 'forward' pages from the +// cursor toward newer events; 'backward' returns the newest window first (tail-first) and +// pages toward older events. Events within a returned batch are always chronological +// (oldest-to-newest), even for a backward read. +// Experimental: EventsReadDirection is part of an experimental API and may change or be +// removed. +type EventsReadDirection string const ( - MCPHeadersHandlePendingHeadersRefreshRequestKindError MCPHeadersHandlePendingHeadersRefreshRequestKind = "error" - MCPHeadersHandlePendingHeadersRefreshRequestKindHeaders MCPHeadersHandlePendingHeadersRefreshRequestKind = "headers" - MCPHeadersHandlePendingHeadersRefreshRequestKindNone MCPHeadersHandlePendingHeadersRefreshRequestKind = "none" + // Tail-first: return the newest events and page toward older events. + EventsReadDirectionBackward EventsReadDirection = "backward" + // Page from the cursor toward newer events (default). + EventsReadDirectionForward EventsReadDirection = "forward" ) -// OAuth grant type override for this login. -// Experimental: MCPOauthLoginGrantType is part of an experimental API and may change or be -// removed. -type MCPOauthLoginGrantType string +// Discovery source: project (.github/extensions/), user (~/.copilot/extensions/), plugin +// (installed plugin), or session (session-state//extensions/) +// Experimental: ExtensionSource is part of an experimental API and may change or be removed. +type ExtensionSource string const ( - // Interactive browser-based OAuth flow using an authorization code, typically with PKCE. - MCPOauthLoginGrantTypeAuthorizationCode MCPOauthLoginGrantType = "authorization_code" - // Headless OAuth flow where a confidential client authenticates directly with a client - // secret. - MCPOauthLoginGrantTypeClientCredentials MCPOauthLoginGrantType = "client_credentials" + // Extension contributed by an installed plugin. + ExtensionSourcePlugin ExtensionSource = "plugin" + // Extension discovered from the current project's .github/extensions directory. + ExtensionSourceProject ExtensionSource = "project" + // Extension discovered from the current session's state directory (loaded only for this + // session). + ExtensionSourceSession ExtensionSource = "session" + // Extension discovered from the user's ~/.copilot/extensions directory. + ExtensionSourceUser ExtensionSource = "user" ) -// Kind discriminator for MCPOauthPendingRequestResponse. -// Experimental: MCPOauthPendingRequestResponseKind is part of an experimental API and may -// change or be removed. -type MCPOauthPendingRequestResponseKind string +// Current status: running, disabled, failed, or starting +// Experimental: ExtensionStatus is part of an experimental API and may change or be removed. +type ExtensionStatus string const ( - MCPOauthPendingRequestResponseKindCancelled MCPOauthPendingRequestResponseKind = "cancelled" - MCPOauthPendingRequestResponseKindToken MCPOauthPendingRequestResponseKind = "token" + // The extension is installed but disabled. + ExtensionStatusDisabled ExtensionStatus = "disabled" + // The extension failed to start or crashed. + ExtensionStatusFailed ExtensionStatus = "failed" + // The extension process is running. + ExtensionStatusRunning ExtensionStatus = "running" + // The extension process is starting. + ExtensionStatusStarting ExtensionStatus = "starting" ) -// Why a passive MCP OAuth probe determined authentication is needed. -// Experimental: MCPOauthProbeNeedsAuthReason is part of an experimental API and may change -// or be removed. -type MCPOauthProbeNeedsAuthReason string +// Binary result type discriminator. Use "image" for images and "resource" for other binary +// data. +// Experimental: ExternalToolTextResultForLlmBinaryResultsForLlmType is part of an +// experimental API and may change or be removed. +type ExternalToolTextResultForLlmBinaryResultsForLlmType string const ( - // No token was sent and the server requires authentication. - MCPOauthProbeNeedsAuthReasonInitial MCPOauthProbeNeedsAuthReason = "initial" - // A cached token was sent and rejected. - MCPOauthProbeNeedsAuthReasonRefresh MCPOauthProbeNeedsAuthReason = "refresh" - // The server returned a 403 insufficient_scope challenge, indicating additional scopes or - // audience are needed. - MCPOauthProbeNeedsAuthReasonUpscope MCPOauthProbeNeedsAuthReason = "upscope" + // Binary image data. + ExternalToolTextResultForLlmBinaryResultsForLlmTypeImage ExternalToolTextResultForLlmBinaryResultsForLlmType = "image" + // Other binary resource data. + ExternalToolTextResultForLlmBinaryResultsForLlmTypeResource ExternalToolTextResultForLlmBinaryResultsForLlmType = "resource" ) -// Status discriminator for MCPOauthProbeResult. -type MCPOauthProbeResultStatus string +// Theme variant this icon is intended for +// Experimental: ExternalToolTextResultForLlmContentResourceLinkIconTheme is part of an +// experimental API and may change or be removed. +type ExternalToolTextResultForLlmContentResourceLinkIconTheme string const ( - MCPOauthProbeResultStatusAuthenticated MCPOauthProbeResultStatus = "authenticated" - MCPOauthProbeResultStatusFailed MCPOauthProbeResultStatus = "failed" - MCPOauthProbeResultStatusNeedsAuth MCPOauthProbeResultStatus = "needs-auth" - MCPOauthProbeResultStatusNoAuthRequired MCPOauthProbeResultStatus = "no-auth-required" + // Icon intended for dark themes. + ExternalToolTextResultForLlmContentResourceLinkIconThemeDark ExternalToolTextResultForLlmContentResourceLinkIconTheme = "dark" + // Icon intended for light themes. + ExternalToolTextResultForLlmContentResourceLinkIconThemeLight ExternalToolTextResultForLlmContentResourceLinkIconTheme = "light" ) -// Whether a planned configuration change would create or modify an entry -// Experimental: MCPPlanConfigurationOperation is part of an experimental API and may change -// or be removed. -type MCPPlanConfigurationOperation string +// Type discriminator for ExternalToolTextResultForLlmContent. +type ExternalToolTextResultForLlmContentType string const ( - // Creates a configuration entry that does not exist yet. - MCPPlanConfigurationOperationAdd MCPPlanConfigurationOperation = "add" - // Modifies a configuration entry that already exists. - MCPPlanConfigurationOperationUpdate MCPPlanConfigurationOperation = "update" + ExternalToolTextResultForLlmContentTypeAudio ExternalToolTextResultForLlmContentType = "audio" + ExternalToolTextResultForLlmContentTypeImage ExternalToolTextResultForLlmContentType = "image" + ExternalToolTextResultForLlmContentTypeResource ExternalToolTextResultForLlmContentType = "resource" + ExternalToolTextResultForLlmContentTypeResourceLink ExternalToolTextResultForLlmContentType = "resource_link" + ExternalToolTextResultForLlmContentTypeShellExit ExternalToolTextResultForLlmContentType = "shell_exit" + ExternalToolTextResultForLlmContentTypeTerminal ExternalToolTextResultForLlmContentType = "terminal" + ExternalToolTextResultForLlmContentTypeText ExternalToolTextResultForLlmContentType = "text" ) -// Discriminator for an enumerated required value -// Experimental: MCPPlanEnumValueType is part of an experimental API and may change or be +// Execution-critical factory storage operation. +// Experimental: FactoryDurableOperation is part of an experimental API and may change or be // removed. -type MCPPlanEnumValueType string +type FactoryDurableOperation string const ( - // One of a fixed, non-empty set of permitted values. - MCPPlanEnumValueTypeEnum MCPPlanEnumValueType = "enum" + // Persisting active execution time. + FactoryDurableOperationAddElapsed FactoryDurableOperation = "addElapsed" + // Persisting an idempotent model-usage charge. + FactoryDurableOperationChargeCredit FactoryDurableOperation = "chargeCredit" + // Creating the durable run and declared phases. + FactoryDurableOperationCreateRun FactoryDurableOperation = "createRun" + // Persisting the terminal run envelope. + FactoryDurableOperationFinishRun FactoryDurableOperation = "finishRun" + // Reading a journal entry without treating storage failure as a cache miss. + FactoryDurableOperationJournalGet FactoryDurableOperation = "journalGet" + // Persisting a journal entry before reporting success. + FactoryDurableOperationJournalPut FactoryDurableOperation = "journalPut" + // Persisting the transition to running. + FactoryDurableOperationMarkRunStarted FactoryDurableOperation = "markRunStarted" + // Reading the authoritative AI-credit total. + FactoryDurableOperationReconcileCreditTotal FactoryDurableOperation = "reconcileCreditTotal" + // Renewing the durable owner lease that proves this process still owns the run. + FactoryDurableOperationRefreshLease FactoryDurableOperation = "refreshLease" + // Rolling back an uncommitted subagent admission. + FactoryDurableOperationReleaseAgent FactoryDurableOperation = "releaseAgent" + // Persisting subagent admission accounting. + FactoryDurableOperationReserveAgent FactoryDurableOperation = "reserveAgent" ) -// Kind discriminator for MCPPlanInstallResult. -type MCPPlanInstallResultKind string +// Kind of factory progress line. +// Experimental: FactoryLogLineKind is part of an experimental API and may change or be +// removed. +type FactoryLogLineKind string const ( - MCPPlanInstallResultKindAuthenticationRequired MCPPlanInstallResultKind = "authentication-required" - MCPPlanInstallResultKindContractViolation MCPPlanInstallResultKind = "contract-violation" - MCPPlanInstallResultKindHandleRejected MCPPlanInstallResultKind = "handle-rejected" - MCPPlanInstallResultKindInvalidRequest MCPPlanInstallResultKind = "invalid-request" - MCPPlanInstallResultKindMalformedCard MCPPlanInstallResultKind = "malformed-card" - MCPPlanInstallResultKindNegotiationRefused MCPPlanInstallResultKind = "negotiation-refused" - MCPPlanInstallResultKindNetworkFailure MCPPlanInstallResultKind = "network-failure" - MCPPlanInstallResultKindNotInstallable MCPPlanInstallResultKind = "not-installable" - MCPPlanInstallResultKindPlanned MCPPlanInstallResultKind = "planned" - MCPPlanInstallResultKindPolicyRejected MCPPlanInstallResultKind = "policy-rejected" - MCPPlanInstallResultKindUnavailable MCPPlanInstallResultKind = "unavailable" - MCPPlanInstallResultKindUnavailableTransport MCPPlanInstallResultKind = "unavailable-transport" - MCPPlanInstallResultKindUnsafeRetrieval MCPPlanInstallResultKind = "unsafe-retrieval" + // A narrator log line. + FactoryLogLineKindLog FactoryLogLineKind = "log" + // A named factory phase marker. + FactoryLogLineKindPhase FactoryLogLineKind = "phase" ) -// Discriminator for a candidate-backed install-plan source -// Experimental: MCPPlanInstallSourceCandidateKind is part of an experimental API and may -// change or be removed. -type MCPPlanInstallSourceCandidateKind string +// Action the runtime selected for a durable factory pause checkpoint. +// Experimental: FactoryPauseCheckpointAction is part of an experimental API and may change +// or be removed. +type FactoryPauseCheckpointAction string const ( - // Plan from a candidate returned by catalog search. - MCPPlanInstallSourceCandidateKindCandidate MCPPlanInstallSourceCandidateKind = "candidate" + // The checkpoint was committed by a prior paused attempt, so execution may continue. + FactoryPauseCheckpointActionContinue FactoryPauseCheckpointAction = "continue" + // This attempt claimed the checkpoint and must cooperatively stop. + FactoryPauseCheckpointActionPause FactoryPauseCheckpointAction = "pause" ) -// Discriminator for a caller-supplied-card install-plan source -// Experimental: MCPPlanInstallSourceCardKind is part of an experimental API and may change -// or be removed. -type MCPPlanInstallSourceCardKind string +// Type discriminator for FactoryPauseInfo. +type FactoryPauseInfoType string const ( - // Plan directly from a caller-supplied card. - MCPPlanInstallSourceCardKindCard MCPPlanInstallSourceCardKind = "card" + FactoryPauseInfoTypeCheckpoint FactoryPauseInfoType = "checkpoint" + FactoryPauseInfoTypeUser FactoryPauseInfoType = "user" ) -// Kind discriminator for MCPPlanInstallSource. -type MCPPlanInstallSourceKind string +// Derived lifecycle state of a factory phase. +// Experimental: FactoryPhaseStatus is part of an experimental API and may change or be +// removed. +type FactoryPhaseStatus string const ( - MCPPlanInstallSourceKindCandidate MCPPlanInstallSourceKind = "candidate" - MCPPlanInstallSourceKindCard MCPPlanInstallSourceKind = "card" + // The phase is currently entered and accumulating active time. + FactoryPhaseStatusActive FactoryPhaseStatus = "active" + // The phase was entered and has since been closed. + FactoryPhaseStatusCompleted FactoryPhaseStatus = "completed" + // The phase has not been entered yet. + FactoryPhaseStatusPending FactoryPhaseStatus = "pending" + // The phase was never entered because a later phase was entered or the run reached a + // terminal state. + FactoryPhaseStatusSkipped FactoryPhaseStatus = "skipped" ) -// Discriminator for a package-backed transport choice -// Experimental: MCPPlanPackageInstallMethod is part of an experimental API and may change -// or be removed. -type MCPPlanPackageInstallMethod string +// Cumulative resource ceiling that stopped a factory run. +// Experimental: FactoryRunFailureKind is part of an experimental API and may change or be +// removed. +type FactoryRunFailureKind string const ( - // Install and run a local package. - MCPPlanPackageInstallMethodPackage MCPPlanPackageInstallMethod = "package" + // The run's settled subagent model usage exceeded the approved AI-credit ceiling, or no + // headroom remained for another subagent. + FactoryRunFailureKindMaxAiCredits FactoryRunFailureKind = "maxAiCredits" + // The run admitted the approved maximum total number of subagents. + FactoryRunFailureKindMaxTotalSubagents FactoryRunFailureKind = "maxTotalSubagents" + // The run reached the approved accumulated active-execution time in seconds. + FactoryRunFailureKindTimeoutSeconds FactoryRunFailureKind = "timeoutSeconds" ) -// Transport exposed by a locally launched package -// Experimental: MCPPlanPackageTransport is part of an experimental API and may change or be -// removed. -type MCPPlanPackageTransport string +// Type discriminator for FactoryRunFailure. +type FactoryRunFailureType string const ( - // A locally launched process spoken to over standard input and output. - MCPPlanPackageTransportStdio MCPPlanPackageTransport = "stdio" + FactoryRunFailureTypeFactoryAccountingIncomplete FactoryRunFailureType = "factory_accounting_incomplete" + FactoryRunFailureTypeFactoryDurableFailure FactoryRunFailureType = "factory_durable_failure" + FactoryRunFailureTypeFactoryLimitReached FactoryRunFailureType = "factory_limit_reached" + FactoryRunFailureTypeFactoryProviderDisconnected FactoryRunFailureType = "factory_provider_disconnected" + FactoryRunFailureTypeFactoryResumeDeclined FactoryRunFailureType = "factory_resume_declined" ) -// What policy decided for a planned server -// Experimental: MCPPlanPolicyDecision is part of an experimental API and may change or be +// Current or terminal state of a factory run. +// Experimental: FactoryRunStatus is part of an experimental API and may change or be // removed. -type MCPPlanPolicyDecision string +type FactoryRunStatus string const ( - // Policy permits the server. - MCPPlanPolicyDecisionAllowed MCPPlanPolicyDecision = "allowed" - // Policy forbids the server, so the plan cannot be applied. - MCPPlanPolicyDecisionBlocked MCPPlanPolicyDecision = "blocked" - // Policy permits the server only after an explicit approval. - MCPPlanPolicyDecisionRequiresApproval MCPPlanPolicyDecision = "requires-approval" + // The run was cancelled before completion. + FactoryRunStatusCancelled FactoryRunStatus = "cancelled" + // The run completed successfully. + FactoryRunStatusCompleted FactoryRunStatus = "completed" + // The factory body failed or reached a cumulative resource ceiling. + FactoryRunStatusError FactoryRunStatus = "error" + // The run was interrupted while resource budget remained. + FactoryRunStatusHalted FactoryRunStatus = "halted" + // The current attempt stopped intentionally and the run may be resumed. + FactoryRunStatusPaused FactoryRunStatus = "paused" + // The run was minted and is awaiting approval. + FactoryRunStatusPending FactoryRunStatus = "pending" + // The run is executing. + FactoryRunStatusRunning FactoryRunStatus = "running" ) -// Which authority produced a policy decision -// Experimental: MCPPlanPolicySource is part of an experimental API and may change or be -// removed. -type MCPPlanPolicySource string +// Why the runtime is requesting a GitHub credential. +// Experimental: GitHubTokenAcquireReason is part of an experimental API and may change or +// be removed. +type GitHubTokenAcquireReason string const ( - // An enterprise allowlist evaluated the server. - MCPPlanPolicySourceEnterpriseAllowlist MCPPlanPolicySource = "enterprise-allowlist" - // Local trust settings evaluated the server. - MCPPlanPolicySourceLocalTrust MCPPlanPolicySource = "local-trust" - // No policy applied, so the server is permitted by default. - MCPPlanPolicySourceNone MCPPlanPolicySource = "none" - // The registry the card came from evaluated the server. - MCPPlanPolicySourceRegistryPolicy MCPPlanPolicySource = "registry-policy" + // The runtime is acquiring the registration's first credential. + GitHubTokenAcquireReasonInitial GitHubTokenAcquireReason = "initial" + // The runtime is replacing a credential that is approaching expiry. + GitHubTokenAcquireReasonRefresh GitHubTokenAcquireReason = "refresh" ) -// Discriminator for a remote-endpoint transport choice -// Experimental: MCPPlanRemoteInstallMethod is part of an experimental API and may change or -// be removed. -type MCPPlanRemoteInstallMethod string +// Kind discriminator for GitHubTokenAcquireResult. +// Experimental: GitHubTokenAcquireResultKind is part of an experimental API and may change +// or be removed. +type GitHubTokenAcquireResultKind string const ( - // Connect to a remote endpoint. - MCPPlanRemoteInstallMethodRemote MCPPlanRemoteInstallMethod = "remote" + GitHubTokenAcquireResultKindCancelled GitHubTokenAcquireResultKind = "cancelled" + GitHubTokenAcquireResultKindToken GitHubTokenAcquireResultKind = "token" ) -// Transport exposed by a remote endpoint -// Experimental: MCPPlanRemoteTransport is part of an experimental API and may change or be -// removed. -type MCPPlanRemoteTransport string +// What initiated this compaction request, recorded as the `trigger` on the persisted +// `session.compaction_start` / `session.compaction_complete` events. When absent, the +// compaction is persisted without trigger attribution (initiator unknown). +type HistoryCompactRequestTrigger string const ( - // An HTTP endpoint. - MCPPlanRemoteTransportHTTP MCPPlanRemoteTransport = "http" - // A server-sent events endpoint. - MCPPlanRemoteTransportSSE MCPPlanRemoteTransport = "sse" - // A streamable HTTP endpoint. - MCPPlanRemoteTransportStreamableHTTP MCPPlanRemoteTransport = "streamable-http" + // User-requested compaction, e.g. the /compact command or a direct history.compact call. + HistoryCompactRequestTriggerManual HistoryCompactRequestTrigger = "manual" + // Compaction requested while switching to a model with a smaller context window. + HistoryCompactRequestTriggerModelSwitch HistoryCompactRequestTrigger = "model_switch" ) -// Discriminator for an enumerated required value -// Experimental: MCPPlanRequiredValueEnumKind is part of an experimental API and may change +// Reason a captured file was not restored. +// Experimental: HistoryFileRestoreSkipReason is part of an experimental API and may change // or be removed. -type MCPPlanRequiredValueEnumKind string +type HistoryFileRestoreSkipReason string const ( - // The value uses a fixed non-empty enumeration. - MCPPlanRequiredValueEnumKindEnum MCPPlanRequiredValueEnumKind = "enum" + // A faithful preimage was not captured. + HistoryFileRestoreSkipReasonSkippedCapture HistoryFileRestoreSkipReason = "skipped-capture" + // The file changed after Copilot's last captured write. + HistoryFileRestoreSkipReasonUserModified HistoryFileRestoreSkipReason = "user-modified" ) -// Kind discriminator for MCPPlanRequiredValue. -type MCPPlanRequiredValueKind string +// Aggregate file change represented by a rewind preview. +// Experimental: HistoryRewindChangeType is part of an experimental API and may change or be +// removed. +type HistoryRewindChangeType string const ( - MCPPlanRequiredValueKindEnum MCPPlanRequiredValueKind = "enum" - MCPPlanRequiredValueKindScalar MCPPlanRequiredValueKind = "scalar" + // The discarded turns created the file. + HistoryRewindChangeTypeCreated HistoryRewindChangeType = "created" + // The discarded turns deleted the file. + HistoryRewindChangeTypeDeleted HistoryRewindChangeType = "deleted" + // The discarded turns modified the file. + HistoryRewindChangeTypeModified HistoryRewindChangeType = "modified" ) -// Discriminator for a scalar required value -// Experimental: MCPPlanRequiredValueScalarKind is part of an experimental API and may -// change or be removed. -type MCPPlanRequiredValueScalarKind string +// Scope of a rewind operation. +// Experimental: HistoryRewindMode is part of an experimental API and may change or be +// removed. +type HistoryRewindMode string const ( - // The value uses one scalar type. - MCPPlanRequiredValueScalarKindScalar MCPPlanRequiredValueScalarKind = "scalar" + // Discard conversation events while leaving files unchanged. + HistoryRewindModeConversation HistoryRewindMode = "conversation" + // Discard conversation events and restore captured files changed by those turns. + HistoryRewindModeConversationAndFiles HistoryRewindMode = "conversation-and-files" ) -// Scalar type a required value must conform to -// Experimental: MCPPlanScalarValueType is part of an experimental API and may change or be +// Outcome of a rewind request. +// Experimental: HistoryRewindOutcome is part of an experimental API and may change or be // removed. -type MCPPlanScalarValueType string +type HistoryRewindOutcome string const ( - // A boolean. - MCPPlanScalarValueTypeBoolean MCPPlanScalarValueType = "boolean" - // A number. - MCPPlanScalarValueTypeNumber MCPPlanScalarValueType = "number" - // A filesystem path. - MCPPlanScalarValueTypePath MCPPlanScalarValueType = "path" - // Free text. - MCPPlanScalarValueTypeString MCPPlanScalarValueType = "string" + // The conversation was rewound (and, in conversation-and-files mode, captured files were + // restored), but persisted checkpoints could not be cleaned up; reachable in either mode. + HistoryRewindOutcomeCheckpointCleanupFailed HistoryRewindOutcome = "checkpoint-cleanup-failed" + // A conversation-and-files rewind was requested for a session that did not enable capture; + // conversation-only rewinds never produce this. + HistoryRewindOutcomeFileChangeTrackingDisabled HistoryRewindOutcome = "file-change-tracking-disabled" + // File restore failed and all applied file changes were rolled back; only + // conversation-and-files rewinds produce this. + HistoryRewindOutcomeFilesRolledBack HistoryRewindOutcome = "files-rolled-back" + // File restore failed and its rollback could not fully restore the pre-rewind state; only + // conversation-and-files rewinds produce this. + HistoryRewindOutcomeRollbackIncomplete HistoryRewindOutcome = "rollback-incomplete" + // The session still has work that may mutate files or history; reachable in either mode. + HistoryRewindOutcomeSessionBusy HistoryRewindOutcome = "session-busy" + // Files and conversation were rewound, but obsolete file snapshots could not be removed; + // only conversation-and-files rewinds produce this. + HistoryRewindOutcomeSnapshotPruneFailed HistoryRewindOutcome = "snapshot-prune-failed" + // The requested rewind completed; reachable in either mode. + HistoryRewindOutcomeSuccess HistoryRewindOutcome = "success" + // Conversation truncation failed. In conversation-and-files mode any files that were + // restored are left in place because conversation history cannot be un-truncated; in + // conversation-only mode no files are restored. Consult restoredFiles for what, if + // anything, was applied. + HistoryRewindOutcomeTruncationFailed HistoryRewindOutcome = "truncation-failed" + // Remote-backed rewind routing is not supported; reachable in either mode. + HistoryRewindOutcomeUnsupportedRemoteSession HistoryRewindOutcome = "unsupported-remote-session" ) -// Configuration scope an MCP install plan targets -// Experimental: MCPPlanScope is part of an experimental API and may change or be removed. -type MCPPlanScope string +// Reason a rewind read (rewind points, file-restore preview, or session diff) could not be +// answered from the session's file-change captures. +// Experimental: HistoryRewindUnavailableReason is part of an experimental API and may +// change or be removed. +type HistoryRewindUnavailableReason string const ( - // The user's own MCP configuration. - MCPPlanScopeUser MCPPlanScope = "user" + // The session did not opt into file-change tracking before its first turn. + HistoryRewindUnavailableReasonFileChangeTrackingDisabled HistoryRewindUnavailableReason = "file-change-tracking-disabled" + // The session still has work that may mutate files or history. Transient: the same request + // succeeds once the session settles, so callers should retry rather than treat it as a + // failure. + HistoryRewindUnavailableReasonSessionBusy HistoryRewindUnavailableReason = "session-busy" + // Remote-backed rewind routing is not supported. + HistoryRewindUnavailableReasonUnsupportedRemoteSession HistoryRewindUnavailableReason = "unsupported-remote-session" ) -// Transport discriminator for MCPPlanTransportChoice. -type MCPPlanTransportChoiceTransport string +// Authentication host. HMAC auth always targets the public GitHub host. +type HMACAuthInfoHost string const ( - MCPPlanTransportChoiceTransportHTTP MCPPlanTransportChoiceTransport = "http" - MCPPlanTransportChoiceTransportSSE MCPPlanTransportChoiceTransport = "sse" - MCPPlanTransportChoiceTransportStdio MCPPlanTransportChoiceTransport = "stdio" - MCPPlanTransportChoiceTransportStreamableHTTP MCPPlanTransportChoiceTransport = "streamable-http" + HMACAuthInfoHostHTTPSGitHubCom HMACAuthInfoHost = "https://github.com" ) -// Where a required value is applied when the planned server is launched -// Experimental: MCPPlanValueCategory is part of an experimental API and may change or be -// removed. -type MCPPlanValueCategory string +// Configuration tier that contributed a discovered hook action. +// Experimental: HookOrigin is part of an experimental API and may change or be removed. +type HookOrigin string const ( - // Set as an environment variable on the launched process. - MCPPlanValueCategoryEnvironmentVariable MCPPlanValueCategory = "environment-variable" - // Sent as a request header to a remote endpoint. - MCPPlanValueCategoryHeader MCPPlanValueCategory = "header" - // Passed to the packaged server itself. - MCPPlanValueCategoryPackageArgument MCPPlanValueCategory = "package-argument" - // Passed to the runtime that launches the package. - MCPPlanValueCategoryRuntimeArgument MCPPlanValueCategory = "runtime-argument" - // Substituted into the remote endpoint URL. - MCPPlanValueCategoryURLVariable MCPPlanValueCategory = "url-variable" + // Hook provided by an enabled installed or explicit plugin. Projectless rows omit + // projectPath and do not expand a project directory. + HookOriginPlugin HookOrigin = "plugin" + // Hook enforced by centrally managed policy. + HookOriginPolicy HookOrigin = "policy" + // Hook loaded from repository settings or the repository hook directory. + HookOriginRepository HookOrigin = "repository" + // Hook loaded from user settings or the user's hook directory. + HookOriginUser HookOrigin = "user" ) -// Outcome of the sampling inference. 'success' produced a response; 'failure' encountered -// an error (including agent-side rejection by content filter or criteria); 'cancelled' the -// caller cancelled this execution via cancelSamplingExecution. -// Experimental: MCPSamplingExecutionAction is part of an experimental API and may change or -// be removed. -type MCPSamplingExecutionAction string +// Hook event name. Discovery emits the file-configurable subset; SDK callbacks additionally +// support callback-only events. +// Experimental: HookType is part of an experimental API and may change or be removed. +type HookType string const ( - // The sampling inference was cancelled before completion. - MCPSamplingExecutionActionCancelled MCPSamplingExecutionAction = "cancelled" - // The sampling inference failed or was rejected. - MCPSamplingExecutionActionFailure MCPSamplingExecutionAction = "failure" - // The sampling inference completed and produced a result. - MCPSamplingExecutionActionSuccess MCPSamplingExecutionAction = "success" + // Runs when the agent stops. + HookTypeAgentStop HookType = "agentStop" + // Runs when the agent encounters an error. + HookTypeErrorOccurred HookType = "errorOccurred" + // Runs when the agent emits a notification. + HookTypeNotification HookType = "notification" + // Runs when the agent requests permission. + HookTypePermissionRequest HookType = "permissionRequest" + // Runs after an agent result is produced. + HookTypePostResult HookType = "postResult" + // Runs after a tool completes successfully. + HookTypePostToolUse HookType = "postToolUse" + // Runs after a tool fails. + HookTypePostToolUseFailure HookType = "postToolUseFailure" + // Runs before conversation context is compacted. + HookTypePreCompact HookType = "preCompact" + // Runs before an MCP tool is invoked. + HookTypePreMCPToolCall HookType = "preMcpToolCall" + // Runs before a pull request description is generated. + HookTypePrePRDescription HookType = "prePRDescription" + // Runs before a tool is invoked. + HookTypePreToolUse HookType = "preToolUse" + // Runs when a session ends. + HookTypeSessionEnd HookType = "sessionEnd" + // Runs when a session starts. + HookTypeSessionStart HookType = "sessionStart" + // Runs when a subagent starts. + HookTypeSubagentStart HookType = "subagentStart" + // Runs when a subagent stops. + HookTypeSubagentStop HookType = "subagentStop" + // Runs after the user submits a prompt. + HookTypeUserPromptSubmitted HookType = "userPromptSubmitted" + // Runs after the runtime transforms the submitted prompt for the model, before it is added + // to session history. + HookTypeUserPromptTransformed HookType = "userPromptTransformed" ) -// Discriminator for an embedded MCP server card -// Experimental: MCPServerCardEmbeddedKind is part of an experimental API and may change or -// be removed. -type MCPServerCardEmbeddedKind string +// Live indexed-search state for this session activation, never inferred from persisted +// history. +// Experimental: IndexedSearchState is part of an experimental API and may change or be +// removed. +type IndexedSearchState string const ( - // Use the embedded card document. - MCPServerCardEmbeddedKindEmbedded MCPServerCardEmbeddedKind = "embedded" + // Indexed search is not active for this session. + IndexedSearchStateDisabled IndexedSearchState = "disabled" + // The indexed-search server started successfully; its index may still be warming. + IndexedSearchStateEnabled IndexedSearchState = "enabled" + // Indexed-search startup or the active server failed. + IndexedSearchStateFailed IndexedSearchState = "failed" + // The indexed-search server and its index are ready. + IndexedSearchStateReady IndexedSearchState = "ready" + // Indexed-search startup is in progress. + IndexedSearchStateStarting IndexedSearchState = "starting" ) -// JSON MCP card media type accepted for install planning -// Experimental: MCPServerCardMediaType is part of an experimental API and may change or be -// removed. -type MCPServerCardMediaType string +// Constant value. Always "github". +type InstalledPluginSourceGitHubSource string const ( - // The current MCP server card media type. - MCPServerCardMediaTypeApplicationMCPServerCardJSON MCPServerCardMediaType = "application/mcp-server-card+json" - // The legacy MCP server card media type, accepted for compatibility. - MCPServerCardMediaTypeApplicationMCPServerJSON MCPServerCardMediaType = "application/mcp-server+json" + InstalledPluginSourceGitHubSourceGitHub InstalledPluginSourceGitHubSource = "github" ) -// Kind discriminator for MCPServerCardReference. -type MCPServerCardReferenceKind string +// Constant value. Always "local". +type InstalledPluginSourceLocalSource string const ( - MCPServerCardReferenceKindEmbedded MCPServerCardReferenceKind = "embedded" - MCPServerCardReferenceKindURL MCPServerCardReferenceKind = "url" + InstalledPluginSourceLocalSourceLocal InstalledPluginSourceLocalSource = "local" ) -// Discriminator for a URL-backed MCP server card -// Experimental: MCPServerCardURLKind is part of an experimental API and may change or be -// removed. -type MCPServerCardURLKind string +// Constant value. Always "url". +type InstalledPluginSourceURLSource string const ( - // Retrieve the card from its URL. - MCPServerCardURLKindURL MCPServerCardURLKind = "url" + InstalledPluginSourceURLSourceURL InstalledPluginSourceURLSource = "url" ) -// Controls if tools provided by this server can be loaded on demand via tool search (auto) -// or always included in the initial tool list (never) -// Experimental: MCPServerConfigDeferTools is part of an experimental API and may change or -// be removed. -type MCPServerConfigDeferTools string +// Whether the target is a single file or a directory of instruction files +// Experimental: InstructionDiscoveryPathKind is part of an experimental API and may change +// or be removed. +type InstructionDiscoveryPathKind string const ( - // Tools may be deferred under certain conditions - MCPServerConfigDeferToolsAuto MCPServerConfigDeferTools = "auto" - // Tools are always included in the initial tool list, even when tool search is enabled. - MCPServerConfigDeferToolsNever MCPServerConfigDeferTools = "never" + // The target is a directory that holds instruction files. + InstructionDiscoveryPathKindDirectory InstructionDiscoveryPathKind = "directory" + // The target is a single instruction file. + InstructionDiscoveryPathKindFile InstructionDiscoveryPathKind = "file" ) -// OAuth grant type to use when authenticating to the remote MCP server. -// Experimental: MCPServerConfigHTTPOauthGrantType is part of an experimental API and may +// Which tier this target belongs to +// Experimental: InstructionDiscoveryPathLocation is part of an experimental API and may // change or be removed. -type MCPServerConfigHTTPOauthGrantType string +type InstructionDiscoveryPathLocation string const ( - // Interactive browser-based authorization code flow with PKCE. - MCPServerConfigHTTPOauthGrantTypeAuthorizationCode MCPServerConfigHTTPOauthGrantType = "authorization_code" - // Headless client credentials flow using the configured OAuth client. - MCPServerConfigHTTPOauthGrantTypeClientCredentials MCPServerConfigHTTPOauthGrantType = "client_credentials" + // Instructions live in plugin-provided configuration. + InstructionDiscoveryPathLocationPlugin InstructionDiscoveryPathLocation = "plugin" + // Instructions live in repository-level configuration. + InstructionDiscoveryPathLocationRepository InstructionDiscoveryPathLocation = "repository" + // Instructions live in user-level configuration. + InstructionDiscoveryPathLocationUser InstructionDiscoveryPathLocation = "user" + // Instructions live under the current working directory. + InstructionDiscoveryPathLocationWorkingDirectory InstructionDiscoveryPathLocation = "working-directory" ) -// Remote transport type. Defaults to "http" when omitted. -// Experimental: MCPServerConfigHTTPType is part of an experimental API and may change or be +// Where this source lives — used for UI grouping +// Experimental: InstructionSourceLocation is part of an experimental API and may change or +// be removed. +type InstructionSourceLocation string + +const ( + // Instructions live in plugin-provided configuration. + InstructionSourceLocationPlugin InstructionSourceLocation = "plugin" + // Instructions live in repository-level configuration. + InstructionSourceLocationRepository InstructionSourceLocation = "repository" + // Instructions live in user-level configuration. + InstructionSourceLocationUser InstructionSourceLocation = "user" + // Instructions live under the current working directory. + InstructionSourceLocationWorkingDirectory InstructionSourceLocation = "working-directory" +) + +// Category of instruction source — used for merge logic +// Experimental: InstructionSourceType is part of an experimental API and may change or be // removed. -type MCPServerConfigHTTPType string +type InstructionSourceType string const ( - // Streamable HTTP transport. - MCPServerConfigHTTPTypeHTTP MCPServerConfigHTTPType = "http" - // Server-Sent Events transport. - MCPServerConfigHTTPTypeSSE MCPServerConfigHTTPType = "sse" + // Instructions inherited from child instruction files. + InstructionSourceTypeChildInstructions InstructionSourceType = "child-instructions" + // Instructions loaded from the user's home configuration. + InstructionSourceTypeHome InstructionSourceType = "home" + // Instructions loaded from model-specific files. + InstructionSourceTypeModel InstructionSourceType = "model" + // Instructions discovered from nested agent files. + InstructionSourceTypeNestedAgents InstructionSourceType = "nested-agents" + // Instructions supplied by an installed plugin. + InstructionSourceTypePlugin InstructionSourceType = "plugin" + // Instructions loaded from repository-scoped files. + InstructionSourceTypeRepo InstructionSourceType = "repo" + // Instructions loaded from VS Code instruction files. + InstructionSourceTypeVscode InstructionSourceType = "vscode" ) -// In-process MCP transport type. -// Experimental: MCPServerConfigMemoryType is part of an experimental API and may change or -// be removed. -type MCPServerConfigMemoryType string +// 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. +// Experimental: LlmInferenceHTTPRequestStartTransport is part of an experimental API and +// may change or be removed. +type LlmInferenceHTTPRequestStartTransport string const ( - MCPServerConfigMemoryTypeMemory MCPServerConfigMemoryType = "memory" + // Plain HTTP or SSE response. Each body chunk is an opaque byte range; the response is a + // status line, headers, and a (possibly streamed) body. + LlmInferenceHTTPRequestStartTransportHTTP LlmInferenceHTTPRequestStartTransport = "http" + // Full-duplex WebSocket channel. Each body chunk maps to exactly one WebSocket message and + // the `binary` flag distinguishes text from binary frames; request and response chunks flow + // concurrently. + LlmInferenceHTTPRequestStartTransportWebsocket LlmInferenceHTTPRequestStartTransport = "websocket" ) -// Local MCP transport type. -// Experimental: MCPServerConfigStdioType is part of an experimental API and may change or -// be removed. -type MCPServerConfigStdioType string +// Summary of which managed-settings channels contributed to the effective session policy. +// Use the per-channel booleans for exact provenance. +// Experimental: ManagedSettingsResolvedSource is part of an experimental API and may change +// or be removed. +type ManagedSettingsResolvedSource string const ( - // Legacy alias for the local stdio transport. - MCPServerConfigStdioTypeLocal MCPServerConfigStdioType = "local" - // Server communicates over stdio with a local child process. - MCPServerConfigStdioTypeStdio MCPServerConfigStdioType = "stdio" + // Only session-local SDK-host injection contributed. + ManagedSettingsResolvedSourceClient ManagedSettingsResolvedSource = "client" + // Only the device MDM/plist/registry/file channel contributed. + ManagedSettingsResolvedSourceDevice ManagedSettingsResolvedSource = "device" + // More than one channel contributed. Ordinary keys resolve device over server over policy + // helper per key, while permissions compose restrictively across all present layers. + ManagedSettingsResolvedSourceMixed ManagedSettingsResolvedSource = "mixed" + // No managed policy is in force (no channel contributed). + ManagedSettingsResolvedSourceNone ManagedSettingsResolvedSource = "none" + // A policy helper registered by device or server policy contributed. Device registration + // takes priority when present. + ManagedSettingsResolvedSourcePolicyHelper ManagedSettingsResolvedSource = "policyHelper" + // Only the server/account channel contributed. + ManagedSettingsResolvedSourceServer ManagedSettingsResolvedSource = "server" ) -// Configuration source: user, workspace, plugin, builtin, or managed -// Experimental: MCPServerSource is part of an experimental API and may change or be removed. -type MCPServerSource string +// Allowed values for the `McpAppsHostContextDetailsAvailableDisplayMode` enumeration. +// Experimental: MCPAppsHostContextDetailsAvailableDisplayMode is part of an experimental +// API and may change or be removed. +type MCPAppsHostContextDetailsAvailableDisplayMode string const ( - // Server bundled with the runtime. - MCPServerSourceBuiltin MCPServerSource = "builtin" - // Server supplied by a trusted host-managed catalog. - MCPServerSourceManaged MCPServerSource = "managed" - // Server contributed by an installed plugin. - MCPServerSourcePlugin MCPServerSource = "plugin" - // Server configured in the user's global MCP configuration. - MCPServerSourceUser MCPServerSource = "user" - // Server configured by the current workspace. - MCPServerSourceWorkspace MCPServerSource = "workspace" + // Rendered as a fullscreen overlay + MCPAppsHostContextDetailsAvailableDisplayModeFullscreen MCPAppsHostContextDetailsAvailableDisplayMode = "fullscreen" + // Rendered inline within the host conversation surface + MCPAppsHostContextDetailsAvailableDisplayModeInline MCPAppsHostContextDetailsAvailableDisplayMode = "inline" + // Rendered as a picture-in-picture floating panel + MCPAppsHostContextDetailsAvailableDisplayModePip MCPAppsHostContextDetailsAvailableDisplayMode = "pip" ) -// Connection status: connected, failed, needs-auth, pending, disabled, stopped, or -// not_configured -// Experimental: MCPServerStatus is part of an experimental API and may change or be removed. -type MCPServerStatus string +// Current display mode (SEP-1865) +// Experimental: MCPAppsHostContextDetailsDisplayMode is part of an experimental API and may +// change or be removed. +type MCPAppsHostContextDetailsDisplayMode string const ( - // The server is connected and available. - MCPServerStatusConnected MCPServerStatus = "connected" - // The server is configured but disabled. - MCPServerStatusDisabled MCPServerStatus = "disabled" - // The server failed to connect or initialize. - MCPServerStatusFailed MCPServerStatus = "failed" - // The server requires authentication before it can connect. - MCPServerStatusNeedsAuth MCPServerStatus = "needs-auth" - // The server is not configured for this session. - MCPServerStatusNotConfigured MCPServerStatus = "not_configured" - // The server connection is still being established. - MCPServerStatusPending MCPServerStatus = "pending" - // The server was intentionally stopped and can be restarted on demand when policy permits; - // a server quarantined by restrictive managed policy stays stopped and cannot be restarted - // until the policy allows it. - MCPServerStatusStopped MCPServerStatus = "stopped" + // Rendered as a fullscreen overlay + MCPAppsHostContextDetailsDisplayModeFullscreen MCPAppsHostContextDetailsDisplayMode = "fullscreen" + // Rendered inline within the host conversation surface + MCPAppsHostContextDetailsDisplayModeInline MCPAppsHostContextDetailsDisplayMode = "inline" + // Rendered as a picture-in-picture floating panel + MCPAppsHostContextDetailsDisplayModePip MCPAppsHostContextDetailsDisplayMode = "pip" ) -// How environment-variable values supplied to MCP servers are resolved. "direct" passes -// literal string values; "indirect" treats values as references (e.g. names of environment -// variables on the host) that the runtime resolves before launch. Defaults to the runtime's -// startup mode; clients that intentionally launch MCP servers with literal values (e.g. CLI -// prompt mode and ACP) set this to "direct". -// Experimental: MCPSetEnvValueModeDetails is part of an experimental API and may change or -// be removed. -type MCPSetEnvValueModeDetails string +// Platform type for responsive design +// Experimental: MCPAppsHostContextDetailsPlatform is part of an experimental API and may +// change or be removed. +type MCPAppsHostContextDetailsPlatform string const ( - // Treat MCP server environment values as literal strings. - MCPSetEnvValueModeDetailsDirect MCPSetEnvValueModeDetails = "direct" - // Treat MCP server environment values as host-side references to resolve before launch. - MCPSetEnvValueModeDetailsIndirect MCPSetEnvValueModeDetails = "indirect" + // Host runs as a desktop application + MCPAppsHostContextDetailsPlatformDesktop MCPAppsHostContextDetailsPlatform = "desktop" + // Host runs on a mobile device + MCPAppsHostContextDetailsPlatformMobile MCPAppsHostContextDetailsPlatform = "mobile" + // Host runs in a web browser + MCPAppsHostContextDetailsPlatformWeb MCPAppsHostContextDetailsPlatform = "web" ) -// Consumer allowed to call an MCP tool. -// Experimental: MCPToolUIVisibility is part of an experimental API and may change or be -// removed. -type MCPToolUIVisibility string +// UI theme preference per SEP-1865 +// Experimental: MCPAppsHostContextDetailsTheme is part of an experimental API and may +// change or be removed. +type MCPAppsHostContextDetailsTheme string const ( - // An MCP App view may call the tool. - MCPToolUIVisibilityApp MCPToolUIVisibility = "app" - // The model may call the tool. - MCPToolUIVisibilityModel MCPToolUIVisibility = "model" + // Dark UI theme + MCPAppsHostContextDetailsThemeDark MCPAppsHostContextDetailsTheme = "dark" + // Light UI theme + MCPAppsHostContextDetailsThemeLight MCPAppsHostContextDetailsTheme = "light" ) -// The current agent mode for this session (e.g., 'interactive', 'plan', 'autopilot') -// Experimental: MetadataSnapshotCurrentMode is part of an experimental API and may change -// or be removed. -type MetadataSnapshotCurrentMode string +// Allowed values for the `McpAppsSetHostContextDetailsAvailableDisplayMode` enumeration. +// Experimental: MCPAppsSetHostContextDetailsAvailableDisplayMode is part of an experimental +// API and may change or be removed. +type MCPAppsSetHostContextDetailsAvailableDisplayMode string const ( - // The agent is working autonomously toward task completion. - MetadataSnapshotCurrentModeAutopilot MetadataSnapshotCurrentMode = "autopilot" - // The agent is responding interactively to the user. - MetadataSnapshotCurrentModeInteractive MetadataSnapshotCurrentMode = "interactive" - // The agent is preparing a plan before making changes. - MetadataSnapshotCurrentModePlan MetadataSnapshotCurrentMode = "plan" + // Rendered as a fullscreen overlay + MCPAppsSetHostContextDetailsAvailableDisplayModeFullscreen MCPAppsSetHostContextDetailsAvailableDisplayMode = "fullscreen" + // Rendered inline within the host conversation surface + MCPAppsSetHostContextDetailsAvailableDisplayModeInline MCPAppsSetHostContextDetailsAvailableDisplayMode = "inline" + // Rendered as a picture-in-picture floating panel + MCPAppsSetHostContextDetailsAvailableDisplayModePip MCPAppsSetHostContextDetailsAvailableDisplayMode = "pip" ) -// Whether the remote task originated from Copilot Coding Agent (cca) or a CLI `--remote` -// invocation. -// Experimental: MetadataSnapshotRemoteMetadataTaskType is part of an experimental API and +// Current display mode (SEP-1865) +// Experimental: MCPAppsSetHostContextDetailsDisplayMode is part of an experimental API and // may change or be removed. -type MetadataSnapshotRemoteMetadataTaskType string +type MCPAppsSetHostContextDetailsDisplayMode string const ( - // Remote task originated from Copilot Coding Agent. - MetadataSnapshotRemoteMetadataTaskTypeCca MetadataSnapshotRemoteMetadataTaskType = "cca" - // Remote task originated from a CLI remote-session invocation. - MetadataSnapshotRemoteMetadataTaskTypeCLI MetadataSnapshotRemoteMetadataTaskType = "cli" + // Rendered as a fullscreen overlay + MCPAppsSetHostContextDetailsDisplayModeFullscreen MCPAppsSetHostContextDetailsDisplayMode = "fullscreen" + // Rendered inline within the host conversation surface + MCPAppsSetHostContextDetailsDisplayModeInline MCPAppsSetHostContextDetailsDisplayMode = "inline" + // Rendered as a picture-in-picture floating panel + MCPAppsSetHostContextDetailsDisplayModePip MCPAppsSetHostContextDetailsDisplayMode = "pip" ) -// Origin of an effective session model change. -// Experimental: ModelChangeSource is part of an experimental API and may change or be -// removed. -type ModelChangeSource string +// Platform type for responsive design +// Experimental: MCPAppsSetHostContextDetailsPlatform is part of an experimental API and may +// change or be removed. +type MCPAppsSetHostContextDetailsPlatform string const ( - // Selecting an agent selected its configured model. - ModelChangeSourceAgent ModelChangeSource = "agent" - // The runtime selected the model automatically, such as rate-limit recovery or refusal - // fallback. - ModelChangeSourceAutomatic ModelChangeSource = "automatic" - // The user selected the model with the `/config` alias. - ModelChangeSourceConfigCommand ModelChangeSource = "config_command" - // Organization-managed settings selected the model. - ModelChangeSourceManagedSettings ModelChangeSource = "managed_settings" - // The user selected a model directly with `/model `. - ModelChangeSourceModelCommand ModelChangeSource = "model_command" - // The user selected the model in the model picker, including the picker opened by bare - // `/model`. - ModelChangeSourceModelPicker ModelChangeSource = "model_picker" - // Entering, leaving, or reconfiguring plan mode selected the model. - ModelChangeSourcePlanMode ModelChangeSource = "plan_mode" - // Repository settings selected the model. - ModelChangeSourceRepoSettings ModelChangeSource = "repo_settings" - // An SDK or RPC caller selected the model. - ModelChangeSourceSDK ModelChangeSource = "sdk" - // The user selected the model with `/settings`. - ModelChangeSourceSettingsCommand ModelChangeSource = "settings_command" - // Startup model resolution selected the model. - ModelChangeSourceStartup ModelChangeSource = "startup" + // Host runs as a desktop application + MCPAppsSetHostContextDetailsPlatformDesktop MCPAppsSetHostContextDetailsPlatform = "desktop" + // Host runs on a mobile device + MCPAppsSetHostContextDetailsPlatformMobile MCPAppsSetHostContextDetailsPlatform = "mobile" + // Host runs in a web browser + MCPAppsSetHostContextDetailsPlatformWeb MCPAppsSetHostContextDetailsPlatform = "web" ) -// Model capability category for grouping in the model picker -// Experimental: ModelPickerCategory is part of an experimental API and may change or be +// UI theme preference per SEP-1865 +// Experimental: MCPAppsSetHostContextDetailsTheme is part of an experimental API and may +// change or be removed. +type MCPAppsSetHostContextDetailsTheme string + +const ( + // Dark UI theme + MCPAppsSetHostContextDetailsThemeDark MCPAppsSetHostContextDetailsTheme = "dark" + // Light UI theme + MCPAppsSetHostContextDetailsThemeLight MCPAppsSetHostContextDetailsTheme = "light" +) + +// Structured MCP elicitation mode. +// Experimental: MCPElicitationFormMode is part of an experimental API and may change or be // removed. -type ModelPickerCategory string +type MCPElicitationFormMode string const ( - // Lightweight model category optimized for faster, lower-cost interactions. - ModelPickerCategoryLightweight ModelPickerCategory = "lightweight" - // Powerful model category optimized for complex tasks. - ModelPickerCategoryPowerful ModelPickerCategory = "powerful" - // Versatile model category suitable for a broad range of tasks. - ModelPickerCategoryVersatile ModelPickerCategory = "versatile" + MCPElicitationFormModeForm MCPElicitationFormMode = "form" ) -// Relative cost tier for token-based billing users -// Experimental: ModelPickerPriceCategory is part of an experimental API and may change or -// be removed. -type ModelPickerPriceCategory string +// Kind discriminator for MCPHeadersHandlePendingHeadersRefreshRequest. +type MCPHeadersHandlePendingHeadersRefreshRequestKind string const ( - // High relative token cost tier. - ModelPickerPriceCategoryHigh ModelPickerPriceCategory = "high" - // Lowest relative token cost tier. - ModelPickerPriceCategoryLow ModelPickerPriceCategory = "low" - // Medium relative token cost tier. - ModelPickerPriceCategoryMedium ModelPickerPriceCategory = "medium" - // Highest relative token cost tier. - ModelPickerPriceCategoryVeryHigh ModelPickerPriceCategory = "very_high" + MCPHeadersHandlePendingHeadersRefreshRequestKindError MCPHeadersHandlePendingHeadersRefreshRequestKind = "error" + MCPHeadersHandlePendingHeadersRefreshRequestKindHeaders MCPHeadersHandlePendingHeadersRefreshRequestKind = "headers" + MCPHeadersHandlePendingHeadersRefreshRequestKindNone MCPHeadersHandlePendingHeadersRefreshRequestKind = "none" ) -// Current policy state for this model -// Experimental: ModelPolicyState is part of an experimental API and may change or be +// OAuth grant type override for this login. +// Experimental: MCPOauthLoginGrantType is part of an experimental API and may change or be // removed. -type ModelPolicyState string +type MCPOauthLoginGrantType string const ( - // The model is disabled by policy. - ModelPolicyStateDisabled ModelPolicyState = "disabled" - // The model is enabled by policy. - ModelPolicyStateEnabled ModelPolicyState = "enabled" - // No explicit policy is configured for the model. - ModelPolicyStateUnconfigured ModelPolicyState = "unconfigured" + // Interactive browser-based OAuth flow using an authorization code, typically with PKCE. + MCPOauthLoginGrantTypeAuthorizationCode MCPOauthLoginGrantType = "authorization_code" + // Headless OAuth flow where a confidential client authenticates directly with a client + // secret. + MCPOauthLoginGrantTypeClientCredentials MCPOauthLoginGrantType = "client_credentials" ) -// Whether the requested preference was already effective or was accepted for later -// transactional activation. -// Experimental: ModelSwitchAutoTierStatus is part of an experimental API and may change or -// be removed. -type ModelSwitchAutoTierStatus string +// Kind discriminator for MCPOauthPendingRequestResponse. +// Experimental: MCPOauthPendingRequestResponseKind is part of an experimental API and may +// change or be removed. +type MCPOauthPendingRequestResponseKind string const ( - // The request was accepted but has not committed. A later user turn using the `auto` model - // must mint and validate the replacement before it becomes effective. - ModelSwitchAutoTierStatusPending ModelSwitchAutoTierStatus = "pending" - // The requested preference is already effective. No activation is pending for it, although - // this request may have cancelled an earlier unclaimed preference reported in - // `supersededAutoTier`. - ModelSwitchAutoTierStatusUnchanged ModelSwitchAutoTierStatus = "unchanged" + MCPOauthPendingRequestResponseKindCancelled MCPOauthPendingRequestResponseKind = "cancelled" + MCPOauthPendingRequestResponseKindToken MCPOauthPendingRequestResponseKind = "token" ) -// Why the binary data is absent: it exceeded the inline size limit, or its asset was -// unavailable -// Experimental: OmittedBinaryOmittedReason is part of an experimental API and may change or -// be removed. -type OmittedBinaryOmittedReason string +// Why a passive MCP OAuth probe determined authentication is needed. +// Experimental: MCPOauthProbeNeedsAuthReason is part of an experimental API and may change +// or be removed. +type MCPOauthProbeNeedsAuthReason string const ( - // The referenced binary asset could not be found (e.g. a truncated log). - OmittedBinaryOmittedReasonAssetUnavailable OmittedBinaryOmittedReason = "asset_unavailable" - // Bytes exceeded the session's inline size limit. - OmittedBinaryOmittedReasonTooLarge OmittedBinaryOmittedReason = "too_large" + // No token was sent and the server requires authentication. + MCPOauthProbeNeedsAuthReasonInitial MCPOauthProbeNeedsAuthReason = "initial" + // A cached token was sent and rejected. + MCPOauthProbeNeedsAuthReasonRefresh MCPOauthProbeNeedsAuthReason = "refresh" + // The server returned a 403 insufficient_scope challenge, indicating additional scopes or + // audience are needed. + MCPOauthProbeNeedsAuthReasonUpscope MCPOauthProbeNeedsAuthReason = "upscope" ) -// Allowed values for the `OptionsUpdateAdditionalContentExclusionPolicyScope` enumeration. -// Experimental: OptionsUpdateAdditionalContentExclusionPolicyScope is part of an -// experimental API and may change or be removed. -type OptionsUpdateAdditionalContentExclusionPolicyScope string +// Status discriminator for MCPOauthProbeResult. +type MCPOauthProbeResultStatus string const ( - // The content exclusion policy applies across all repositories. - OptionsUpdateAdditionalContentExclusionPolicyScopeAll OptionsUpdateAdditionalContentExclusionPolicyScope = "all" - // The content exclusion policy applies to the current repository. - OptionsUpdateAdditionalContentExclusionPolicyScopeRepo OptionsUpdateAdditionalContentExclusionPolicyScope = "repo" + MCPOauthProbeResultStatusAuthenticated MCPOauthProbeResultStatus = "authenticated" + MCPOauthProbeResultStatusFailed MCPOauthProbeResultStatus = "failed" + MCPOauthProbeResultStatusNeedsAuth MCPOauthProbeResultStatus = "needs-auth" + MCPOauthProbeResultStatusNoAuthRequired MCPOauthProbeResultStatus = "no-auth-required" ) -// Context tier for models with tiered pricing. The session uses this to derive effective -// `modelCapabilitiesOverrides` so compaction, truncation, token display, and request limits -// honor the selected tier. -// Experimental: OptionsUpdateContextTier is part of an experimental API and may change or -// be removed. -type OptionsUpdateContextTier string +// Whether a planned configuration change would create or modify an entry +// Experimental: MCPPlanConfigurationOperation is part of an experimental API and may change +// or be removed. +type MCPPlanConfigurationOperation string const ( - // Use the model's default context tier and its standard token limits / pricing. - OptionsUpdateContextTierDefault OptionsUpdateContextTier = "default" - // Use the model's long-context tier (when available) so larger inputs are accepted and - // tier-specific pricing applies. - OptionsUpdateContextTierLongContext OptionsUpdateContextTier = "long_context" + // Creates a configuration entry that does not exist yet. + MCPPlanConfigurationOperationAdd MCPPlanConfigurationOperation = "add" + // Modifies a configuration entry that already exists. + MCPPlanConfigurationOperationUpdate MCPPlanConfigurationOperation = "update" ) -// How env values are passed to MCP servers (`direct` inlines literal values; `indirect` -// resolves at launch). -// Experimental: OptionsUpdateEnvValueMode is part of an experimental API and may change or -// be removed. -type OptionsUpdateEnvValueMode string +// Discriminator for an enumerated required value +// Experimental: MCPPlanEnumValueType is part of an experimental API and may change or be +// removed. +type MCPPlanEnumValueType string const ( - // Pass MCP server environment values as literal strings. - OptionsUpdateEnvValueModeDirect OptionsUpdateEnvValueMode = "direct" - // Resolve MCP server environment values from host-side references. - OptionsUpdateEnvValueModeIndirect OptionsUpdateEnvValueMode = "indirect" + // One of a fixed, non-empty set of permitted values. + MCPPlanEnumValueTypeEnum MCPPlanEnumValueType = "enum" ) -// Reasoning summary mode for supported model clients. -// Experimental: OptionsUpdateReasoningSummary is part of an experimental API and may change -// or be removed. -type OptionsUpdateReasoningSummary string +// Kind discriminator for MCPPlanInstallResult. +type MCPPlanInstallResultKind string const ( - // Request a concise summary of model reasoning. - OptionsUpdateReasoningSummaryConcise OptionsUpdateReasoningSummary = "concise" - // Request a detailed summary of model reasoning. - OptionsUpdateReasoningSummaryDetailed OptionsUpdateReasoningSummary = "detailed" - // Do not request reasoning summaries from the model. - OptionsUpdateReasoningSummaryNone OptionsUpdateReasoningSummary = "none" + MCPPlanInstallResultKindAuthenticationRequired MCPPlanInstallResultKind = "authentication-required" + MCPPlanInstallResultKindContractViolation MCPPlanInstallResultKind = "contract-violation" + MCPPlanInstallResultKindHandleRejected MCPPlanInstallResultKind = "handle-rejected" + MCPPlanInstallResultKindInvalidRequest MCPPlanInstallResultKind = "invalid-request" + MCPPlanInstallResultKindMalformedCard MCPPlanInstallResultKind = "malformed-card" + MCPPlanInstallResultKindNegotiationRefused MCPPlanInstallResultKind = "negotiation-refused" + MCPPlanInstallResultKindNetworkFailure MCPPlanInstallResultKind = "network-failure" + MCPPlanInstallResultKindNotInstallable MCPPlanInstallResultKind = "not-installable" + MCPPlanInstallResultKindPlanned MCPPlanInstallResultKind = "planned" + MCPPlanInstallResultKindPolicyRejected MCPPlanInstallResultKind = "policy-rejected" + MCPPlanInstallResultKindUnavailable MCPPlanInstallResultKind = "unavailable" + MCPPlanInstallResultKindUnavailableTransport MCPPlanInstallResultKind = "unavailable-transport" + MCPPlanInstallResultKindUnsafeRetrieval MCPPlanInstallResultKind = "unsafe-retrieval" ) -// Controls how availableTools (allowlist) and excludedTools (denylist) combine when both -// are set. -// Experimental: OptionsUpdateToolFilterPrecedence is part of an experimental API and may +// Discriminator for a candidate-backed install-plan source +// Experimental: MCPPlanInstallSourceCandidateKind is part of an experimental API and may // change or be removed. -type OptionsUpdateToolFilterPrecedence string +type MCPPlanInstallSourceCandidateKind string const ( - // If availableTools is set, it is the only constraint that applies (excludedTools is - // ignored). Preserves CLI / pre-existing client behavior. Default. - OptionsUpdateToolFilterPrecedenceAvailable OptionsUpdateToolFilterPrecedence = "available" - // A tool is enabled if and only if it matches the allowlist (or the allowlist is unset) AND - // it does not match the denylist. Makes 'all except X' expressible by combining the two - // lists. - OptionsUpdateToolFilterPrecedenceExcluded OptionsUpdateToolFilterPrecedence = "excluded" + // Plan from a candidate returned by catalog search. + MCPPlanInstallSourceCandidateKindCandidate MCPPlanInstallSourceCandidateKind = "candidate" ) -// Kind discriminator for PermissionDecisionApproveForLocationApproval. -type PermissionDecisionApproveForLocationApprovalKind string +// Discriminator for a caller-supplied-card install-plan source +// Experimental: MCPPlanInstallSourceCardKind is part of an experimental API and may change +// or be removed. +type MCPPlanInstallSourceCardKind string const ( - PermissionDecisionApproveForLocationApprovalKindCommands PermissionDecisionApproveForLocationApprovalKind = "commands" - PermissionDecisionApproveForLocationApprovalKindCustomTool PermissionDecisionApproveForLocationApprovalKind = "custom-tool" - PermissionDecisionApproveForLocationApprovalKindExtensionEnvAccess PermissionDecisionApproveForLocationApprovalKind = "extension-env-access" - PermissionDecisionApproveForLocationApprovalKindExtensionManagement PermissionDecisionApproveForLocationApprovalKind = "extension-management" - PermissionDecisionApproveForLocationApprovalKindExtensionPermissionAccess PermissionDecisionApproveForLocationApprovalKind = "extension-permission-access" - PermissionDecisionApproveForLocationApprovalKindFactory PermissionDecisionApproveForLocationApprovalKind = "factory" - PermissionDecisionApproveForLocationApprovalKindMCP PermissionDecisionApproveForLocationApprovalKind = "mcp" - PermissionDecisionApproveForLocationApprovalKindMCPSampling PermissionDecisionApproveForLocationApprovalKind = "mcp-sampling" - PermissionDecisionApproveForLocationApprovalKindMemory PermissionDecisionApproveForLocationApprovalKind = "memory" - PermissionDecisionApproveForLocationApprovalKindRead PermissionDecisionApproveForLocationApprovalKind = "read" - PermissionDecisionApproveForLocationApprovalKindWrite PermissionDecisionApproveForLocationApprovalKind = "write" + // Plan directly from a caller-supplied card. + MCPPlanInstallSourceCardKindCard MCPPlanInstallSourceCardKind = "card" ) -// Kind discriminator for PermissionDecisionApproveForSessionApproval. -type PermissionDecisionApproveForSessionApprovalKind string +// Kind discriminator for MCPPlanInstallSource. +type MCPPlanInstallSourceKind string const ( - PermissionDecisionApproveForSessionApprovalKindCommands PermissionDecisionApproveForSessionApprovalKind = "commands" - PermissionDecisionApproveForSessionApprovalKindCustomTool PermissionDecisionApproveForSessionApprovalKind = "custom-tool" - PermissionDecisionApproveForSessionApprovalKindExtensionEnvAccess PermissionDecisionApproveForSessionApprovalKind = "extension-env-access" - PermissionDecisionApproveForSessionApprovalKindExtensionManagement PermissionDecisionApproveForSessionApprovalKind = "extension-management" - PermissionDecisionApproveForSessionApprovalKindExtensionPermissionAccess PermissionDecisionApproveForSessionApprovalKind = "extension-permission-access" - PermissionDecisionApproveForSessionApprovalKindFactory PermissionDecisionApproveForSessionApprovalKind = "factory" - PermissionDecisionApproveForSessionApprovalKindMCP PermissionDecisionApproveForSessionApprovalKind = "mcp" - PermissionDecisionApproveForSessionApprovalKindMCPSampling PermissionDecisionApproveForSessionApprovalKind = "mcp-sampling" - PermissionDecisionApproveForSessionApprovalKindMemory PermissionDecisionApproveForSessionApprovalKind = "memory" - PermissionDecisionApproveForSessionApprovalKindRead PermissionDecisionApproveForSessionApprovalKind = "read" - PermissionDecisionApproveForSessionApprovalKindWrite PermissionDecisionApproveForSessionApprovalKind = "write" + MCPPlanInstallSourceKindCandidate MCPPlanInstallSourceKind = "candidate" + MCPPlanInstallSourceKindCard MCPPlanInstallSourceKind = "card" ) -// Kind discriminator for PermissionDecision. -type PermissionDecisionKind string +// Discriminator for a package-backed transport choice +// Experimental: MCPPlanPackageInstallMethod is part of an experimental API and may change +// or be removed. +type MCPPlanPackageInstallMethod string const ( - PermissionDecisionKindApproved PermissionDecisionKind = "approved" - PermissionDecisionKindApprovedForLocation PermissionDecisionKind = "approved-for-location" - PermissionDecisionKindApprovedForSession PermissionDecisionKind = "approved-for-session" - PermissionDecisionKindApproveForLocation PermissionDecisionKind = "approve-for-location" - PermissionDecisionKindApproveForSession PermissionDecisionKind = "approve-for-session" - PermissionDecisionKindApproveOnce PermissionDecisionKind = "approve-once" - PermissionDecisionKindApprovePermanently PermissionDecisionKind = "approve-permanently" - PermissionDecisionKindCancelled PermissionDecisionKind = "cancelled" - PermissionDecisionKindDeniedByContentExclusionPolicy PermissionDecisionKind = "denied-by-content-exclusion-policy" - PermissionDecisionKindDeniedByPermissionRequestHook PermissionDecisionKind = "denied-by-permission-request-hook" - PermissionDecisionKindDeniedByRules PermissionDecisionKind = "denied-by-rules" - PermissionDecisionKindDeniedInteractivelyByUser PermissionDecisionKind = "denied-interactively-by-user" - PermissionDecisionKindDeniedNoApprovalRuleAndCouldNotRequestFromUser PermissionDecisionKind = "denied-no-approval-rule-and-could-not-request-from-user" - PermissionDecisionKindReject PermissionDecisionKind = "reject" - PermissionDecisionKindUserNotAvailable PermissionDecisionKind = "user-not-available" -) - -// Disposition of a permission request as observed by the responding client. -// Experimental: PermissionDecisionOutcome is part of an experimental API and may change or -// be removed. -type PermissionDecisionOutcome string - -const ( - // The request was approved automatically without a new human decision. - PermissionDecisionOutcomeAutoApproved PermissionDecisionOutcome = "auto_approved" - // The request was denied without an interactive user decision; source records why. - PermissionDecisionOutcomeAutopilotDenied PermissionDecisionOutcome = "autopilot_denied" - // The response came from an interactive user prompt. - PermissionDecisionOutcomePromptedUser PermissionDecisionOutcome = "prompted_user" + // Install and run a local package. + MCPPlanPackageInstallMethodPackage MCPPlanPackageInstallMethod = "package" ) -// Controlled reason or actor responsible for a permission response. -// Experimental: PermissionDecisionSource is part of an experimental API and may change or -// be removed. -type PermissionDecisionSource string +// Transport exposed by a locally launched package +// Experimental: MCPPlanPackageTransport is part of an experimental API and may change or be +// removed. +type MCPPlanPackageTransport string const ( - // The response followed the assisted-approval judge recommendation. - PermissionDecisionSourceAssistedApproval PermissionDecisionSource = "assisted_approval" - // A live authorization record from an earlier human decision in this session contained the - // proposal, so it ran without another prompt. This is not a new human decision and never - // mints authority of its own. - PermissionDecisionSourceAuthorizationCarryForward PermissionDecisionSource = "authorization_carry_forward" - // The host applied a standing policy or override rather than a judge recommendation or - // human decision. - PermissionDecisionSourceHostPolicy PermissionDecisionSource = "host_policy" - // A human supplied the response through an interactive prompt. - PermissionDecisionSourceHumanResponse PermissionDecisionSource = "human_response" - // The host denied the request because no interactive user response was available. - PermissionDecisionSourceUnattendedFallback PermissionDecisionSource = "unattended_fallback" + // A locally launched process spoken to over standard input and output. + MCPPlanPackageTransportStdio MCPPlanPackageTransport = "stdio" ) -// Client surface that submitted a permission response. -// Experimental: PermissionDecisionSurface is part of an experimental API and may change or -// be removed. -type PermissionDecisionSurface string +// What policy decided for a planned server +// Experimental: MCPPlanPolicyDecision is part of an experimental API and may change or be +// removed. +type MCPPlanPolicyDecision string const ( - // An Agent Client Protocol host. - PermissionDecisionSurfaceAcp PermissionDecisionSurface = "acp" - // The Copilot App client. - PermissionDecisionSurfaceCopilotApp PermissionDecisionSurface = "copilot_app" - // The non-interactive Copilot CLI prompt mode. - PermissionDecisionSurfacePromptMode PermissionDecisionSurface = "prompt_mode" - // A generic Copilot SDK client. - PermissionDecisionSurfaceSDK PermissionDecisionSurface = "sdk" - // The interactive Copilot CLI terminal UI. - PermissionDecisionSurfaceTui PermissionDecisionSurface = "tui" + // Policy permits the server. + MCPPlanPolicyDecisionAllowed MCPPlanPolicyDecision = "allowed" + // Policy forbids the server, so the plan cannot be applied. + MCPPlanPolicyDecisionBlocked MCPPlanPolicyDecision = "blocked" + // Policy permits the server only after an explicit approval. + MCPPlanPolicyDecisionRequiresApproval MCPPlanPolicyDecision = "requires-approval" ) -// Whether the location is a git repo or directory -// Experimental: PermissionLocationType is part of an experimental API and may change or be +// Which authority produced a policy decision +// Experimental: MCPPlanPolicySource is part of an experimental API and may change or be // removed. -type PermissionLocationType string +type MCPPlanPolicySource string const ( - // The permission location is persisted at the working directory. - PermissionLocationTypeDir PermissionLocationType = "dir" - // The permission location is persisted at the git repository root. - PermissionLocationTypeRepo PermissionLocationType = "repo" + // An enterprise allowlist evaluated the server. + MCPPlanPolicySourceEnterpriseAllowlist MCPPlanPolicySource = "enterprise-allowlist" + // Local trust settings evaluated the server. + MCPPlanPolicySourceLocalTrust MCPPlanPolicySource = "local-trust" + // No policy applied, so the server is permitted by default. + MCPPlanPolicySourceNone MCPPlanPolicySource = "none" + // The registry the card came from evaluated the server. + MCPPlanPolicySourceRegistryPolicy MCPPlanPolicySource = "registry-policy" ) -// Current or requested permission mode. -// Experimental: PermissionMode is part of an experimental API and may change or be removed. -type PermissionMode string +// Discriminator for a remote-endpoint transport choice +// Experimental: MCPPlanRemoteInstallMethod is part of an experimental API and may change or +// be removed. +type MCPPlanRemoteInstallMethod string const ( - // Tool, path, and URL permission requests are automatically approved. - PermissionModeAllowAll PermissionMode = "allow-all" - // Permission requests include an LLM safety recommendation; clients may automatically - // approve requests judged acceptable. - PermissionModeAssisted PermissionMode = "assisted" - // Permission requests follow the normal approval flow. - PermissionModeManual PermissionMode = "manual" + // Connect to a remote endpoint. + MCPPlanRemoteInstallMethodRemote MCPPlanRemoteInstallMethod = "remote" ) -// Optional source for permission-mode telemetry. Defaults to `rpc` when omitted for SDK -// callers. -// Experimental: PermissionModeSource is part of an experimental API and may change or be +// Transport exposed by a remote endpoint +// Experimental: MCPPlanRemoteTransport is part of an experimental API and may change or be // removed. -type PermissionModeSource string +type MCPPlanRemoteTransport string const ( - // The mode was set by confirming autopilot behavior. - PermissionModeSourceAutopilotConfirmation PermissionModeSource = "autopilot_confirmation" - // The mode was set from a CLI command-line flag. - PermissionModeSourceCLIFlag PermissionModeSource = "cli_flag" - // The mode was set at startup by authenticated organization targeting. - PermissionModeSourceOrganizationTargeting PermissionModeSource = "organization_targeting" - // The mode was set through an RPC caller. - PermissionModeSourceRPC PermissionModeSource = "rpc" - // The mode was set by a slash command. - PermissionModeSourceSlashCommand PermissionModeSource = "slash_command" - // The mode was set at startup by the `defaultPermissionMode` user setting. - PermissionModeSourceUserSetting PermissionModeSource = "user_setting" + // An HTTP endpoint. + MCPPlanRemoteTransportHTTP MCPPlanRemoteTransport = "http" + // A server-sent events endpoint. + MCPPlanRemoteTransportSSE MCPPlanRemoteTransport = "sse" + // A streamable HTTP endpoint. + MCPPlanRemoteTransportStreamableHTTP MCPPlanRemoteTransport = "streamable-http" ) -// Response capability available to the client when it settled a permission request. -// Experimental: PermissionResponseCapability is part of an experimental API and may change +// Discriminator for an enumerated required value +// Experimental: MCPPlanRequiredValueEnumKind is part of an experimental API and may change // or be removed. -type PermissionResponseCapability string +type MCPPlanRequiredValueEnumKind string const ( - // The client could return an automated response but could not ask a user. - PermissionResponseCapabilityHeadless PermissionResponseCapability = "headless" - // The client could ask a user for this decision. - PermissionResponseCapabilityInteractive PermissionResponseCapability = "interactive" - // The client had no response path available. - PermissionResponseCapabilityNone PermissionResponseCapability = "none" + // The value uses a fixed non-empty enumeration. + MCPPlanRequiredValueEnumKindEnum MCPPlanRequiredValueEnumKind = "enum" ) -// Allowed values for the `PermissionsConfigureAdditionalContentExclusionPolicyScope` -// enumeration. -// Experimental: PermissionsConfigureAdditionalContentExclusionPolicyScope is part of an -// experimental API and may change or be removed. -type PermissionsConfigureAdditionalContentExclusionPolicyScope string +// Kind discriminator for MCPPlanRequiredValue. +type MCPPlanRequiredValueKind string const ( - // The content exclusion policy applies across all repositories. - PermissionsConfigureAdditionalContentExclusionPolicyScopeAll PermissionsConfigureAdditionalContentExclusionPolicyScope = "all" - // The content exclusion policy applies to the current repository. - PermissionsConfigureAdditionalContentExclusionPolicyScopeRepo PermissionsConfigureAdditionalContentExclusionPolicyScope = "repo" + MCPPlanRequiredValueKindEnum MCPPlanRequiredValueKind = "enum" + MCPPlanRequiredValueKindScalar MCPPlanRequiredValueKind = "scalar" ) -// Kind discriminator for PermissionsLocationsAddToolApprovalDetails. -type PermissionsLocationsAddToolApprovalDetailsKind string +// Discriminator for a scalar required value +// Experimental: MCPPlanRequiredValueScalarKind is part of an experimental API and may +// change or be removed. +type MCPPlanRequiredValueScalarKind string const ( - PermissionsLocationsAddToolApprovalDetailsKindCommands PermissionsLocationsAddToolApprovalDetailsKind = "commands" - PermissionsLocationsAddToolApprovalDetailsKindCustomTool PermissionsLocationsAddToolApprovalDetailsKind = "custom-tool" - PermissionsLocationsAddToolApprovalDetailsKindExtensionEnvAccess PermissionsLocationsAddToolApprovalDetailsKind = "extension-env-access" - PermissionsLocationsAddToolApprovalDetailsKindExtensionManagement PermissionsLocationsAddToolApprovalDetailsKind = "extension-management" - PermissionsLocationsAddToolApprovalDetailsKindExtensionPermissionAccess PermissionsLocationsAddToolApprovalDetailsKind = "extension-permission-access" - PermissionsLocationsAddToolApprovalDetailsKindFactory PermissionsLocationsAddToolApprovalDetailsKind = "factory" - PermissionsLocationsAddToolApprovalDetailsKindMCP PermissionsLocationsAddToolApprovalDetailsKind = "mcp" - PermissionsLocationsAddToolApprovalDetailsKindMCPSampling PermissionsLocationsAddToolApprovalDetailsKind = "mcp-sampling" - PermissionsLocationsAddToolApprovalDetailsKindMemory PermissionsLocationsAddToolApprovalDetailsKind = "memory" - PermissionsLocationsAddToolApprovalDetailsKindRead PermissionsLocationsAddToolApprovalDetailsKind = "read" - PermissionsLocationsAddToolApprovalDetailsKindWrite PermissionsLocationsAddToolApprovalDetailsKind = "write" + // The value uses one scalar type. + MCPPlanRequiredValueScalarKindScalar MCPPlanRequiredValueScalarKind = "scalar" ) -// Whether the change applies to ephemeral session-scoped rules (cleared at session end) or -// to location-scoped rules persisted via the location-permissions config file. -// Experimental: PermissionsModifyRulesScope is part of an experimental API and may change -// or be removed. -type PermissionsModifyRulesScope string +// Scalar type a required value must conform to +// Experimental: MCPPlanScalarValueType is part of an experimental API and may change or be +// removed. +type MCPPlanScalarValueType string const ( - // Persist the rule change for this project location. - PermissionsModifyRulesScopeLocation PermissionsModifyRulesScope = "location" - // Apply the rule change only to this session. - PermissionsModifyRulesScopeSession PermissionsModifyRulesScope = "session" + // A boolean. + MCPPlanScalarValueTypeBoolean MCPPlanScalarValueType = "boolean" + // A number. + MCPPlanScalarValueTypeNumber MCPPlanScalarValueType = "number" + // A filesystem path. + MCPPlanScalarValueTypePath MCPPlanScalarValueType = "path" + // Free text. + MCPPlanScalarValueTypeString MCPPlanScalarValueType = "string" ) -// Optional source for allow-all telemetry. Defaults to `rpc` when omitted for SDK callers. -// Experimental: PermissionsSetApproveAllSource is part of an experimental API and may -// change or be removed. -type PermissionsSetApproveAllSource string +// Configuration scope an MCP install plan targets +// Experimental: MCPPlanScope is part of an experimental API and may change or be removed. +type MCPPlanScope string const ( - // Allow-all was enabled by confirming autopilot behavior. - PermissionsSetApproveAllSourceAutopilotConfirmation PermissionsSetApproveAllSource = "autopilot_confirmation" - // Allow-all was enabled from a CLI command-line flag. - PermissionsSetApproveAllSourceCLIFlag PermissionsSetApproveAllSource = "cli_flag" - // Allow-all was enabled through an RPC caller. - PermissionsSetApproveAllSourceRPC PermissionsSetApproveAllSource = "rpc" - // Allow-all was enabled by a slash command. - PermissionsSetApproveAllSourceSlashCommand PermissionsSetApproveAllSource = "slash_command" - // Allow-all was enabled at startup by the `defaultPermissionMode` user setting. - PermissionsSetApproveAllSourceUserSetting PermissionsSetApproveAllSource = "user_setting" + // The user's own MCP configuration. + MCPPlanScopeUser MCPPlanScope = "user" ) -// Where completed plugin content was staged before atomic promotion. -// Experimental: PluginInstallStagingMode is part of an experimental API and may change or -// be removed. -type PluginInstallStagingMode string +// Transport discriminator for MCPPlanTransportChoice. +type MCPPlanTransportChoiceTransport string const ( - // A sibling of the destination plugin directory, used when external staging is unavailable. - PluginInstallStagingModeDestinationSibling PluginInstallStagingMode = "destination_sibling" - // A sibling of the installed-plugins root, outside the recursively watched tree. - PluginInstallStagingModeExternal PluginInstallStagingMode = "external" + MCPPlanTransportChoiceTransportHTTP MCPPlanTransportChoiceTransport = "http" + MCPPlanTransportChoiceTransportSSE MCPPlanTransportChoiceTransport = "sse" + MCPPlanTransportChoiceTransportStdio MCPPlanTransportChoiceTransport = "stdio" + MCPPlanTransportChoiceTransportStreamableHTTP MCPPlanTransportChoiceTransport = "streamable-http" ) -// Experimental: ProtocolAppendMode is part of an experimental API and may change or be +// Where a required value is applied when the planned server is launched +// Experimental: MCPPlanValueCategory is part of an experimental API and may change or be // removed. -type ProtocolAppendMode string +type MCPPlanValueCategory string const ( - ProtocolAppendModeAppend ProtocolAppendMode = "append" + // Set as an environment variable on the launched process. + MCPPlanValueCategoryEnvironmentVariable MCPPlanValueCategory = "environment-variable" + // Sent as a request header to a remote endpoint. + MCPPlanValueCategoryHeader MCPPlanValueCategory = "header" + // Passed to the packaged server itself. + MCPPlanValueCategoryPackageArgument MCPPlanValueCategory = "package-argument" + // Passed to the runtime that launches the package. + MCPPlanValueCategoryRuntimeArgument MCPPlanValueCategory = "runtime-argument" + // Substituted into the remote endpoint URL. + MCPPlanValueCategoryURLVariable MCPPlanValueCategory = "url-variable" ) -// Experimental: ProtocolCustomizeMode is part of an experimental API and may change or be -// removed. -type ProtocolCustomizeMode string +// Outcome of the sampling inference. 'success' produced a response; 'failure' encountered +// an error (including agent-side rejection by content filter or criteria); 'cancelled' the +// caller cancelled this execution via cancelSamplingExecution. +// Experimental: MCPSamplingExecutionAction is part of an experimental API and may change or +// be removed. +type MCPSamplingExecutionAction string const ( - ProtocolCustomizeModeCustomize ProtocolCustomizeMode = "customize" -) - -// Controls whether the runtime may defer loading an external tool definition. -// Experimental: ProtocolExternalToolDefer is part of an experimental API and may change or -// be removed. -type ProtocolExternalToolDefer string - -const ( - // The runtime may defer the tool according to its tool-loading policy. - ProtocolExternalToolDeferAuto ProtocolExternalToolDefer = "auto" - // The runtime must include the tool without deferring it. - ProtocolExternalToolDeferNever ProtocolExternalToolDefer = "never" + // The sampling inference was cancelled before completion. + MCPSamplingExecutionActionCancelled MCPSamplingExecutionAction = "cancelled" + // The sampling inference failed or was rejected. + MCPSamplingExecutionActionFailure MCPSamplingExecutionAction = "failure" + // The sampling inference completed and produced a result. + MCPSamplingExecutionActionSuccess MCPSamplingExecutionAction = "success" ) -// Action discriminator for ProtocolMarkerSectionOverride. -type ProtocolMarkerSectionOverrideAction string +// Discriminator for an embedded MCP server card +// Experimental: MCPServerCardEmbeddedKind is part of an experimental API and may change or +// be removed. +type MCPServerCardEmbeddedKind string const ( - ProtocolMarkerSectionOverrideActionPreserve ProtocolMarkerSectionOverrideAction = "preserve" - ProtocolMarkerSectionOverrideActionTransform ProtocolMarkerSectionOverrideAction = "transform" + // Use the embedded card document. + MCPServerCardEmbeddedKindEmbedded MCPServerCardEmbeddedKind = "embedded" ) -// Experimental: ProtocolReplaceMode is part of an experimental API and may change or be +// JSON MCP card media type accepted for install planning +// Experimental: MCPServerCardMediaType is part of an experimental API and may change or be // removed. -type ProtocolReplaceMode string +type MCPServerCardMediaType string const ( - ProtocolReplaceModeReplace ProtocolReplaceMode = "replace" + // The current MCP server card media type. + MCPServerCardMediaTypeApplicationMCPServerCardJSON MCPServerCardMediaType = "application/mcp-server-card+json" + // The legacy MCP server card media type, accepted for compatibility. + MCPServerCardMediaTypeApplicationMCPServerJSON MCPServerCardMediaType = "application/mcp-server+json" ) -// Experimental: ProtocolStaticSectionAction is part of an experimental API and may change -// or be removed. -type ProtocolStaticSectionAction string +// Kind discriminator for MCPServerCardReference. +type MCPServerCardReferenceKind string const ( - // Append content to the section. - ProtocolStaticSectionActionAppend ProtocolStaticSectionAction = "append" - // Prepend content to the section. - ProtocolStaticSectionActionPrepend ProtocolStaticSectionAction = "prepend" - // Remove the section content. - ProtocolStaticSectionActionRemove ProtocolStaticSectionAction = "remove" - // Replace the section content. - ProtocolStaticSectionActionReplace ProtocolStaticSectionAction = "replace" + MCPServerCardReferenceKindEmbedded MCPServerCardReferenceKind = "embedded" + MCPServerCardReferenceKindURL MCPServerCardReferenceKind = "url" ) -type ProtocolSystemMessageConfigMode string +// Discriminator for a URL-backed MCP server card +// Experimental: MCPServerCardURLKind is part of an experimental API and may change or be +// removed. +type MCPServerCardURLKind string const ( - ProtocolSystemMessageConfigModeAppend ProtocolSystemMessageConfigMode = "append" - ProtocolSystemMessageConfigModeCustomize ProtocolSystemMessageConfigMode = "customize" - ProtocolSystemMessageConfigModeReplace ProtocolSystemMessageConfigMode = "replace" + // Retrieve the card from its URL. + MCPServerCardURLKindURL MCPServerCardURLKind = "url" ) -// Provider transport. Defaults to "http". -// Experimental: ProviderConfigTransport is part of an experimental API and may change or be -// removed. -type ProviderConfigTransport string +// Controls if tools provided by this server can be loaded on demand via tool search (auto) +// or always included in the initial tool list (never) +// Experimental: MCPServerConfigDeferTools is part of an experimental API and may change or +// be removed. +type MCPServerConfigDeferTools string const ( - // HTTP request/streaming transport. - ProviderConfigTransportHTTP ProviderConfigTransport = "http" - // WebSocket transport. - ProviderConfigTransportWebsockets ProviderConfigTransport = "websockets" + // Tools may be deferred under certain conditions + MCPServerConfigDeferToolsAuto MCPServerConfigDeferTools = "auto" + // Tools are always included in the initial tool list, even when tool search is enabled. + MCPServerConfigDeferToolsNever MCPServerConfigDeferTools = "never" ) -// Provider type. Defaults to "openai" for generic OpenAI-compatible APIs. -// Experimental: ProviderConfigType is part of an experimental API and may change or be -// removed. -type ProviderConfigType string +// OAuth grant type to use when authenticating to the remote MCP server. +// Experimental: MCPServerConfigHTTPOauthGrantType is part of an experimental API and may +// change or be removed. +type MCPServerConfigHTTPOauthGrantType string const ( - // Anthropic API endpoint. - ProviderConfigTypeAnthropic ProviderConfigType = "anthropic" - // Azure OpenAI Service endpoint. - ProviderConfigTypeAzure ProviderConfigType = "azure" - // Generic OpenAI-compatible API. - ProviderConfigTypeOpenai ProviderConfigType = "openai" + // Interactive browser-based authorization code flow with PKCE. + MCPServerConfigHTTPOauthGrantTypeAuthorizationCode MCPServerConfigHTTPOauthGrantType = "authorization_code" + // Headless client credentials flow using the configured OAuth client. + MCPServerConfigHTTPOauthGrantTypeClientCredentials MCPServerConfigHTTPOauthGrantType = "client_credentials" ) -// Wire API format (openai/azure only). Defaults to "completions". -// Experimental: ProviderConfigWireAPI is part of an experimental API and may change or be +// Remote transport type. Defaults to "http" when omitted. +// Experimental: MCPServerConfigHTTPType is part of an experimental API and may change or be // removed. -type ProviderConfigWireAPI string +type MCPServerConfigHTTPType string const ( - // OpenAI Chat Completions wire format. - ProviderConfigWireAPICompletions ProviderConfigWireAPI = "completions" - // OpenAI Responses API wire format. - ProviderConfigWireAPIResponses ProviderConfigWireAPI = "responses" + // Streamable HTTP transport. + MCPServerConfigHTTPTypeHTTP MCPServerConfigHTTPType = "http" + // Server-Sent Events transport. + MCPServerConfigHTTPTypeSSE MCPServerConfigHTTPType = "sse" ) -// Transport to be used for provider requests. -// Experimental: ProviderEndpointTransport is part of an experimental API and may change or +// In-process MCP transport type. +// Experimental: MCPServerConfigMemoryType is part of an experimental API and may change or // be removed. -type ProviderEndpointTransport string +type MCPServerConfigMemoryType string const ( - // HTTP request/streaming transport. - ProviderEndpointTransportHTTP ProviderEndpointTransport = "http" - // WebSocket transport. - ProviderEndpointTransportWebsockets ProviderEndpointTransport = "websockets" + MCPServerConfigMemoryTypeMemory MCPServerConfigMemoryType = "memory" ) -// Provider family. Matches the `type` field of a BYOK provider config. -// Experimental: ProviderEndpointType is part of an experimental API and may change or be -// removed. -type ProviderEndpointType string +// Local MCP transport type. +// Experimental: MCPServerConfigStdioType is part of an experimental API and may change or +// be removed. +type MCPServerConfigStdioType string const ( - // Anthropic endpoint (use the Anthropic client library). - ProviderEndpointTypeAnthropic ProviderEndpointType = "anthropic" - // Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). - ProviderEndpointTypeAzure ProviderEndpointType = "azure" - // OpenAI-compatible endpoint (use the OpenAI client library). - ProviderEndpointTypeOpenai ProviderEndpointType = "openai" + // Legacy alias for the local stdio transport. + MCPServerConfigStdioTypeLocal MCPServerConfigStdioType = "local" + // Server communicates over stdio with a local child process. + MCPServerConfigStdioTypeStdio MCPServerConfigStdioType = "stdio" ) -// Wire API to be used, when required for the provider type. -// Experimental: ProviderEndpointWireAPI is part of an experimental API and may change or be -// removed. -type ProviderEndpointWireAPI string +// Configuration source: user, workspace, plugin, builtin, or managed +// Experimental: MCPServerSource is part of an experimental API and may change or be removed. +type MCPServerSource string const ( - // Classic chat-completions request shape. - ProviderEndpointWireAPICompletions ProviderEndpointWireAPI = "completions" - // Newer responses request shape. - ProviderEndpointWireAPIResponses ProviderEndpointWireAPI = "responses" + // Server bundled with the runtime. + MCPServerSourceBuiltin MCPServerSource = "builtin" + // Server supplied by a trusted host-managed catalog. + MCPServerSourceManaged MCPServerSource = "managed" + // Server contributed by an installed plugin. + MCPServerSourcePlugin MCPServerSource = "plugin" + // Server configured in the user's global MCP configuration. + MCPServerSourceUser MCPServerSource = "user" + // Server configured by the current workspace. + MCPServerSourceWorkspace MCPServerSource = "workspace" ) -// Type of GitHub reference -// Experimental: PushAttachmentGitHubReferenceType is part of an experimental API and may -// change or be removed. -type PushAttachmentGitHubReferenceType string +// Connection status: connected, failed, needs-auth, pending, disabled, stopped, or +// not_configured +// Experimental: MCPServerStatus is part of an experimental API and may change or be removed. +type MCPServerStatus string const ( - // GitHub discussion reference. - PushAttachmentGitHubReferenceTypeDiscussion PushAttachmentGitHubReferenceType = "discussion" - // GitHub issue reference. - PushAttachmentGitHubReferenceTypeIssue PushAttachmentGitHubReferenceType = "issue" - // GitHub pull request reference. - PushAttachmentGitHubReferenceTypePr PushAttachmentGitHubReferenceType = "pr" + // The server is connected and available. + MCPServerStatusConnected MCPServerStatus = "connected" + // The server is configured but disabled. + MCPServerStatusDisabled MCPServerStatus = "disabled" + // The server failed to connect or initialize. + MCPServerStatusFailed MCPServerStatus = "failed" + // The server requires authentication before it can connect. + MCPServerStatusNeedsAuth MCPServerStatus = "needs-auth" + // The server is not configured for this session. + MCPServerStatusNotConfigured MCPServerStatus = "not_configured" + // The server connection is still being established. + MCPServerStatusPending MCPServerStatus = "pending" + // The server was intentionally stopped and can be restarted on demand when policy permits; + // a server quarantined by restrictive managed policy stays stopped and cannot be restarted + // until the policy allows it. + MCPServerStatusStopped MCPServerStatus = "stopped" ) -// Type discriminator for PushAttachment. -type PushAttachmentType string +// How environment-variable values supplied to MCP servers are resolved. "direct" passes +// literal string values; "indirect" treats values as references (e.g. names of environment +// variables on the host) that the runtime resolves before launch. Defaults to the runtime's +// startup mode; clients that intentionally launch MCP servers with literal values (e.g. CLI +// prompt mode and ACP) set this to "direct". +// Experimental: MCPSetEnvValueModeDetails is part of an experimental API and may change or +// be removed. +type MCPSetEnvValueModeDetails string const ( - PushAttachmentTypeBlob PushAttachmentType = "blob" - PushAttachmentTypeDirectory PushAttachmentType = "directory" - PushAttachmentTypeExtensionContext PushAttachmentType = "extension_context" - PushAttachmentTypeFile PushAttachmentType = "file" - PushAttachmentTypeGitHubActionsJob PushAttachmentType = "github_actions_job" - PushAttachmentTypeGitHubCommit PushAttachmentType = "github_commit" - PushAttachmentTypeGitHubFile PushAttachmentType = "github_file" - PushAttachmentTypeGitHubFileDiff PushAttachmentType = "github_file_diff" - PushAttachmentTypeGitHubReference PushAttachmentType = "github_reference" - PushAttachmentTypeGitHubRelease PushAttachmentType = "github_release" - PushAttachmentTypeGitHubRepository PushAttachmentType = "github_repository" - PushAttachmentTypeGitHubSnippet PushAttachmentType = "github_snippet" - PushAttachmentTypeGitHubTreeComparison PushAttachmentType = "github_tree_comparison" - PushAttachmentTypeGitHubURL PushAttachmentType = "github_url" - PushAttachmentTypeSelection PushAttachmentType = "selection" + // Treat MCP server environment values as literal strings. + MCPSetEnvValueModeDetailsDirect MCPSetEnvValueModeDetails = "direct" + // Treat MCP server environment values as host-side references to resolve before launch. + MCPSetEnvValueModeDetailsIndirect MCPSetEnvValueModeDetails = "indirect" ) -// Whether this item is a queued user message or a queued slash command / model change -// Experimental: QueuePendingItemsKind is part of an experimental API and may change or be +// Consumer allowed to call an MCP tool. +// Experimental: MCPToolUIVisibility is part of an experimental API and may change or be // removed. -type QueuePendingItemsKind string +type MCPToolUIVisibility string const ( - // A queued slash command or model-change command. - QueuePendingItemsKindCommand QueuePendingItemsKind = "command" - // A queued user message. - QueuePendingItemsKindMessage QueuePendingItemsKind = "message" + // An MCP App view may call the tool. + MCPToolUIVisibilityApp MCPToolUIVisibility = "app" + // The model may call the tool. + MCPToolUIVisibilityModel MCPToolUIVisibility = "model" ) -// Reasoning summary mode to request for supported model clients -// Experimental: ReasoningSummary is part of an experimental API and may change or be -// removed. -type ReasoningSummary string +// The current agent mode for this session (e.g., 'interactive', 'plan', 'autopilot') +// Experimental: MetadataSnapshotCurrentMode is part of an experimental API and may change +// or be removed. +type MetadataSnapshotCurrentMode string const ( - // Request a concise summary of the model's reasoning. - ReasoningSummaryConcise ReasoningSummary = "concise" - // Request a detailed summary of the model's reasoning. - ReasoningSummaryDetailed ReasoningSummary = "detailed" - // Do not request reasoning summaries from the model. - ReasoningSummaryNone ReasoningSummary = "none" + // The agent is working autonomously toward task completion. + MetadataSnapshotCurrentModeAutopilot MetadataSnapshotCurrentMode = "autopilot" + // The agent is responding interactively to the user. + MetadataSnapshotCurrentModeInteractive MetadataSnapshotCurrentMode = "interactive" + // The agent is preparing a plan before making changes. + MetadataSnapshotCurrentModePlan MetadataSnapshotCurrentMode = "plan" ) -// What the user must do to recover from a failure, named as an action rather than as one -// client's affordance. The runtime cannot know which affordance a client offers — a slash -// command, a settings pane, a link — so the accompanying message stays host-agnostic and -// each client renders its own copy from this value. Absent when the runtime knows of no -// action the user can take. -// Experimental: RemediationAction is part of an experimental API and may change or be -// removed. -type RemediationAction string +// Whether the remote task originated from Copilot Coding Agent (cca) or a CLI `--remote` +// invocation. +// Experimental: MetadataSnapshotRemoteMetadataTaskType is part of an experimental API and +// may change or be removed. +type MetadataSnapshotRemoteMetadataTaskType string const ( - // Permit outbound network access in the sandbox policy. - RemediationActionAllowSandboxOutbound RemediationAction = "allow_sandbox_outbound" - // Review or widen the sandbox policy. The blocked path or host is named by the accompanying - // message or by the tool result the action arrived with. - RemediationActionReviewSandboxPolicy RemediationAction = "review_sandbox_policy" - // Inspect which account is currently authenticated before deciding what to change. - RemediationActionShowAccount RemediationAction = "show_account" - // Authenticate again with the Copilot backend. The current credential is absent, expired, - // or rejected. - RemediationActionSignIn RemediationAction = "sign_in" - // Authenticate as a different account. The current account exists but lacks access to the - // requested resource. - RemediationActionSwitchAccount RemediationAction = "switch_account" + // Remote task originated from Copilot Coding Agent. + MetadataSnapshotRemoteMetadataTaskTypeCca MetadataSnapshotRemoteMetadataTaskType = "cca" + // Remote task originated from a CLI remote-session invocation. + MetadataSnapshotRemoteMetadataTaskTypeCLI MetadataSnapshotRemoteMetadataTaskType = "cli" ) -// State discriminator for RemoteControlStatus. -type RemoteControlStatusState string +// Origin of an effective session model change. +// Experimental: ModelChangeSource is part of an experimental API and may change or be +// removed. +type ModelChangeSource string const ( - RemoteControlStatusStateActive RemoteControlStatusState = "active" - RemoteControlStatusStateConnecting RemoteControlStatusState = "connecting" - RemoteControlStatusStateError RemoteControlStatusState = "error" - RemoteControlStatusStateOff RemoteControlStatusState = "off" + // Selecting an agent selected its configured model. + ModelChangeSourceAgent ModelChangeSource = "agent" + // The runtime selected the model automatically, such as rate-limit recovery or refusal + // fallback. + ModelChangeSourceAutomatic ModelChangeSource = "automatic" + // The user selected the promoted model from the changeboarding card or its keyboard + // shortcut. + ModelChangeSourceChangeboardingShortcut ModelChangeSource = "changeboarding_shortcut" + // The user selected the model with the `/config` alias. + ModelChangeSourceConfigCommand ModelChangeSource = "config_command" + // Organization-managed settings selected the model. + ModelChangeSourceManagedSettings ModelChangeSource = "managed_settings" + // The user selected a model directly with `/model `. + ModelChangeSourceModelCommand ModelChangeSource = "model_command" + // The user selected the model in the model picker, including the picker opened by bare + // `/model`. + ModelChangeSourceModelPicker ModelChangeSource = "model_picker" + // Entering, leaving, or reconfiguring plan mode selected the model. + ModelChangeSourcePlanMode ModelChangeSource = "plan_mode" + // Repository settings selected the model. + ModelChangeSourceRepoSettings ModelChangeSource = "repo_settings" + // An SDK or RPC caller selected the model. + ModelChangeSourceSDK ModelChangeSource = "sdk" + // The user selected the model with `/settings`. + ModelChangeSourceSettingsCommand ModelChangeSource = "settings_command" + // Startup model resolution selected the model. + ModelChangeSourceStartup ModelChangeSource = "startup" ) -// What a remote host says one of its sessions is doing right now. Deliberately coarse: this -// is what a host can report for EVERY session in a catalogue listing, without a client -// subscribing to each one. AHP's `SessionSummary.status` is the source today; -// `input-needed` covers both a permission prompt and an `ask_user` question, since the -// summary does not say which. -// Experimental: RemoteSessionHostStatus is part of an experimental API and may change or be +// Model capability category for grouping in the model picker +// Experimental: ModelPickerCategory is part of an experimental API and may change or be // removed. -type RemoteSessionHostStatus string +type ModelPickerCategory string const ( - // The session ended its last turn in an error. - RemoteSessionHostStatusError RemoteSessionHostStatus = "error" - // No turn is running. - RemoteSessionHostStatusIdle RemoteSessionHostStatus = "idle" - // The session is blocked on the user: a permission prompt or an `ask_user` question. - RemoteSessionHostStatusInputNeeded RemoteSessionHostStatus = "input-needed" - // A turn is running. - RemoteSessionHostStatusWorking RemoteSessionHostStatus = "working" + // Lightweight model category optimized for faster, lower-cost interactions. + ModelPickerCategoryLightweight ModelPickerCategory = "lightweight" + // Powerful model category optimized for complex tasks. + ModelPickerCategoryPowerful ModelPickerCategory = "powerful" + // Versatile model category suitable for a broad range of tasks. + ModelPickerCategoryVersatile ModelPickerCategory = "versatile" ) -// Whether the remote task originated from CCA or CLI `--remote`. -// Experimental: RemoteSessionMetadataTaskType is part of an experimental API and may change -// or be removed. -type RemoteSessionMetadataTaskType string +// Relative cost tier for token-based billing users +// Experimental: ModelPickerPriceCategory is part of an experimental API and may change or +// be removed. +type ModelPickerPriceCategory string const ( - // GitHub Copilot coding agent task. - RemoteSessionMetadataTaskTypeCca RemoteSessionMetadataTaskType = "cca" - // CLI remote task. - RemoteSessionMetadataTaskTypeCLI RemoteSessionMetadataTaskType = "cli" + // High relative token cost tier. + ModelPickerPriceCategoryHigh ModelPickerPriceCategory = "high" + // Lowest relative token cost tier. + ModelPickerPriceCategoryLow ModelPickerPriceCategory = "low" + // Medium relative token cost tier. + ModelPickerPriceCategoryMedium ModelPickerPriceCategory = "medium" + // Highest relative token cost tier. + ModelPickerPriceCategoryVeryHigh ModelPickerPriceCategory = "very_high" ) -// Per-session remote mode. "off" disables remote, "export" exports session events to GitHub -// without enabling remote steering, "on" enables both export and remote steering. -// Experimental: RemoteSessionMode is part of an experimental API and may change or be +// Current policy state for this model +// Experimental: ModelPolicyState is part of an experimental API and may change or be // removed. -type RemoteSessionMode string +type ModelPolicyState string const ( - // Export session events to GitHub without enabling remote steering. - RemoteSessionModeExport RemoteSessionMode = "export" - // Disable remote session export and steering. - RemoteSessionModeOff RemoteSessionMode = "off" - // Enable both remote session export and remote steering. - RemoteSessionModeOn RemoteSessionMode = "on" + // The model is disabled by policy. + ModelPolicyStateDisabled ModelPolicyState = "disabled" + // The model is enabled by policy. + ModelPolicyStateEnabled ModelPolicyState = "enabled" + // No explicit policy is configured for the model. + ModelPolicyStateUnconfigured ModelPolicyState = "unconfigured" ) -// Output format discriminator. Currently only json_schema is supported. -type ResponseFormatType string +// Whether the requested preference was already effective or was accepted for later +// transactional activation. +// Experimental: ModelSwitchAutoTierStatus is part of an experimental API and may change or +// be removed. +type ModelSwitchAutoTierStatus string const ( - ResponseFormatTypeJSONSchema ResponseFormatType = "json_schema" + // The request was accepted but has not committed. A later user turn using the `auto` model + // must mint and validate the replacement before it becomes effective. + ModelSwitchAutoTierStatusPending ModelSwitchAutoTierStatus = "pending" + // The requested preference is already effective. No activation is pending for it, although + // this request may have cancelled an earlier unclaimed preference reported in + // `supersededAutoTier`. + ModelSwitchAutoTierStatusUnchanged ModelSwitchAutoTierStatus = "unchanged" ) -// Origin of the sandbox choice supplied by an internal client. -// Experimental: SandboxConfigSource is part of an experimental API and may change or be -// removed. -type SandboxConfigSource string +// Why the binary data is absent: it exceeded the inline size limit, or its asset was +// unavailable +// Experimental: OmittedBinaryOmittedReason is part of an experimental API and may change or +// be removed. +type OmittedBinaryOmittedReason string const ( - // The client applied the default because no sandbox preference was configured. - SandboxConfigSourceNeverConfigured SandboxConfigSource = "never_configured" - // A repository policy selected the sandbox state. - SandboxConfigSourceRepositoryPolicy SandboxConfigSource = "repository_policy" - // The user disabled the sandbox for the current session. - SandboxConfigSourceSessionDisabled SandboxConfigSource = "session_disabled" - // A command-line flag selected the sandbox state for this session. - SandboxConfigSourceSessionFlag SandboxConfigSource = "session_flag" - // The client disabled the sandbox because the host cannot enforce it. - SandboxConfigSourceUnsupportedHost SandboxConfigSource = "unsupported_host" - // The user's persisted settings disabled the sandbox. - SandboxConfigSourceUserDisabled SandboxConfigSource = "user_disabled" - // The user's persisted settings enabled the sandbox. - SandboxConfigSourceUserEnabled SandboxConfigSource = "user_enabled" + // The referenced binary asset could not be found (e.g. a truncated log). + OmittedBinaryOmittedReasonAssetUnavailable OmittedBinaryOmittedReason = "asset_unavailable" + // Bytes exceeded the session's inline size limit. + OmittedBinaryOmittedReasonTooLarge OmittedBinaryOmittedReason = "too_large" ) -// A session-scoped sandbox transition applied while handling a slash command -// Experimental: SandboxSessionChange is part of an experimental API and may change or be -// removed. -type SandboxSessionChange string +// Allowed values for the `OptionsUpdateAdditionalContentExclusionPolicyScope` enumeration. +// Experimental: OptionsUpdateAdditionalContentExclusionPolicyScope is part of an +// experimental API and may change or be removed. +type OptionsUpdateAdditionalContentExclusionPolicyScope string const ( - // The sandbox is off for the rest of this session; nothing was persisted and a new session - // starts from managed policy. - SandboxSessionChangeDisabled SandboxSessionChange = "disabled" - // A previous session-scoped opt-out was cleared and the sandbox is enforced again. - SandboxSessionChangeRestored SandboxSessionChange = "restored" + // The content exclusion policy applies across all repositories. + OptionsUpdateAdditionalContentExclusionPolicyScopeAll OptionsUpdateAdditionalContentExclusionPolicyScope = "all" + // The content exclusion policy applies to the current repository. + OptionsUpdateAdditionalContentExclusionPolicyScopeRepo OptionsUpdateAdditionalContentExclusionPolicyScope = "repo" ) -// The UI mode the agent was in when this message was sent. Defaults to the session's -// current mode. -// Experimental: SendAgentMode is part of an experimental API and may change or be removed. -type SendAgentMode string +// Context tier for models with tiered pricing. The session uses this to derive effective +// `modelCapabilitiesOverrides` so compaction, truncation, token display, and request limits +// honor the selected tier. +// Experimental: OptionsUpdateContextTier is part of an experimental API and may change or +// be removed. +type OptionsUpdateContextTier string const ( - // The agent is working autonomously toward task completion. - SendAgentModeAutopilot SendAgentMode = "autopilot" - // The agent is responding interactively to the user. - SendAgentModeInteractive SendAgentMode = "interactive" - // The agent is preparing a plan before making changes. - SendAgentModePlan SendAgentMode = "plan" - // The agent is in shell-focused UI mode. - SendAgentModeShell SendAgentMode = "shell" + // Use the model's default context tier and its standard token limits / pricing. + OptionsUpdateContextTierDefault OptionsUpdateContextTier = "default" + // Use the model's long-context tier (when available) so larger inputs are accepted and + // tier-specific pricing applies. + OptionsUpdateContextTierLongContext OptionsUpdateContextTier = "long_context" ) -// How to deliver the message. `enqueue` (default) appends to the message queue. `immediate` -// interjects during an in-progress turn. -// Experimental: SendMode is part of an experimental API and may change or be removed. -type SendMode string +// How env values are passed to MCP servers (`direct` inlines literal values; `indirect` +// resolves at launch). +// Experimental: OptionsUpdateEnvValueMode is part of an experimental API and may change or +// be removed. +type OptionsUpdateEnvValueMode string const ( - // Append the message to the normal session queue. - SendModeEnqueue SendMode = "enqueue" - // Interject the message during the in-progress turn. - SendModeImmediate SendMode = "immediate" + // Pass MCP server environment values as literal strings. + OptionsUpdateEnvValueModeDirect OptionsUpdateEnvValueMode = "direct" + // Resolve MCP server environment values from host-side references. + OptionsUpdateEnvValueModeIndirect OptionsUpdateEnvValueMode = "indirect" ) -// Session capability enabled for this session -// Experimental: SessionCapability is part of an experimental API and may change or be -// removed. -type SessionCapability string +// Reasoning summary mode for supported model clients. +// Experimental: OptionsUpdateReasoningSummary is part of an experimental API and may change +// or be removed. +type OptionsUpdateReasoningSummary string const ( - // Interactive ask_user tool support. - SessionCapabilityAskUser SessionCapability = "ask-user" - // Host-provided canvas rendering support. - SessionCapabilityCanvasRenderer SessionCapability = "canvas-renderer" - // Copilot CLI documentation tool and prompt section. - SessionCapabilityCLIDocumentation SessionCapability = "cli-documentation" - // SDK elicitation support. - SessionCapabilityElicitation SessionCapability = "elicitation" - // Interactive CLI identity and behavior. - SessionCapabilityInteractiveMode SessionCapability = "interactive-mode" - // MCP Apps UI passthrough. - SessionCapabilityMCPApps SessionCapability = "mcp-apps" - // Memory tool and memories prompt section. - SessionCapabilityMemory SessionCapability = "memory" - // Plan-mode handling and instructions. - SessionCapabilityPlanMode SessionCapability = "plan-mode" - // Cross-session history tools and session-store SQL prompt/tool metadata. - SessionCapabilitySessionStore SessionCapability = "session-store" - // Automatic hidden system notifications. - SessionCapabilitySystemNotifications SessionCapability = "system-notifications" - // TUI-specific prompt hints such as keyboard shortcuts. - SessionCapabilityTuiHints SessionCapability = "tui-hints" + // Request a concise summary of model reasoning. + OptionsUpdateReasoningSummaryConcise OptionsUpdateReasoningSummary = "concise" + // Request a detailed summary of model reasoning. + OptionsUpdateReasoningSummaryDetailed OptionsUpdateReasoningSummary = "detailed" + // Do not request reasoning summaries from the model. + OptionsUpdateReasoningSummaryNone OptionsUpdateReasoningSummary = "none" ) -// Repository host type -// Experimental: SessionContextHostType is part of an experimental API and may change or be -// removed. -type SessionContextHostType string +// Controls how availableTools (allowlist) and excludedTools (denylist) combine when both +// are set. +// Experimental: OptionsUpdateToolFilterPrecedence is part of an experimental API and may +// change or be removed. +type OptionsUpdateToolFilterPrecedence string const ( - // Session repository is hosted on Azure DevOps. - SessionContextHostTypeADO SessionContextHostType = "ado" - // Session repository is hosted on GitHub. - SessionContextHostTypeGitHub SessionContextHostType = "github" + // If availableTools is set, it is the only constraint that applies (excludedTools is + // ignored). Preserves CLI / pre-existing client behavior. Default. + OptionsUpdateToolFilterPrecedenceAvailable OptionsUpdateToolFilterPrecedence = "available" + // A tool is enabled if and only if it matches the allowlist (or the allowlist is unset) AND + // it does not match the denylist. Makes 'all except X' expressible by combining the two + // lists. + OptionsUpdateToolFilterPrecedenceExcluded OptionsUpdateToolFilterPrecedence = "excluded" ) -// Error classification -// Experimental: SessionFSErrorCode is part of an experimental API and may change or be -// removed. -type SessionFSErrorCode string +// Kind discriminator for PermissionDecisionApproveForLocationApproval. +type PermissionDecisionApproveForLocationApprovalKind string const ( - // The requested path does not exist. - SessionFSErrorCodeENOENT SessionFSErrorCode = "ENOENT" - // The filesystem operation failed for an unspecified reason. - SessionFSErrorCodeUNKNOWN SessionFSErrorCode = "UNKNOWN" + PermissionDecisionApproveForLocationApprovalKindCommands PermissionDecisionApproveForLocationApprovalKind = "commands" + PermissionDecisionApproveForLocationApprovalKindCustomTool PermissionDecisionApproveForLocationApprovalKind = "custom-tool" + PermissionDecisionApproveForLocationApprovalKindExtensionEnvAccess PermissionDecisionApproveForLocationApprovalKind = "extension-env-access" + PermissionDecisionApproveForLocationApprovalKindExtensionManagement PermissionDecisionApproveForLocationApprovalKind = "extension-management" + PermissionDecisionApproveForLocationApprovalKindExtensionPermissionAccess PermissionDecisionApproveForLocationApprovalKind = "extension-permission-access" + PermissionDecisionApproveForLocationApprovalKindFactory PermissionDecisionApproveForLocationApprovalKind = "factory" + PermissionDecisionApproveForLocationApprovalKindMCP PermissionDecisionApproveForLocationApprovalKind = "mcp" + PermissionDecisionApproveForLocationApprovalKindMCPSampling PermissionDecisionApproveForLocationApprovalKind = "mcp-sampling" + PermissionDecisionApproveForLocationApprovalKindMemory PermissionDecisionApproveForLocationApprovalKind = "memory" + PermissionDecisionApproveForLocationApprovalKindRead PermissionDecisionApproveForLocationApprovalKind = "read" + PermissionDecisionApproveForLocationApprovalKindWrite PermissionDecisionApproveForLocationApprovalKind = "write" ) -// Entry type -// Experimental: SessionFSReaddirWithTypesEntryType is part of an experimental API and may -// change or be removed. -type SessionFSReaddirWithTypesEntryType string +// Kind discriminator for PermissionDecisionApproveForSessionApproval. +type PermissionDecisionApproveForSessionApprovalKind string const ( - // The entry is a directory. - SessionFSReaddirWithTypesEntryTypeDirectory SessionFSReaddirWithTypesEntryType = "directory" - // The entry is a file. - SessionFSReaddirWithTypesEntryTypeFile SessionFSReaddirWithTypesEntryType = "file" + PermissionDecisionApproveForSessionApprovalKindCommands PermissionDecisionApproveForSessionApprovalKind = "commands" + PermissionDecisionApproveForSessionApprovalKindCustomTool PermissionDecisionApproveForSessionApprovalKind = "custom-tool" + PermissionDecisionApproveForSessionApprovalKindExtensionEnvAccess PermissionDecisionApproveForSessionApprovalKind = "extension-env-access" + PermissionDecisionApproveForSessionApprovalKindExtensionManagement PermissionDecisionApproveForSessionApprovalKind = "extension-management" + PermissionDecisionApproveForSessionApprovalKindExtensionPermissionAccess PermissionDecisionApproveForSessionApprovalKind = "extension-permission-access" + PermissionDecisionApproveForSessionApprovalKindFactory PermissionDecisionApproveForSessionApprovalKind = "factory" + PermissionDecisionApproveForSessionApprovalKindMCP PermissionDecisionApproveForSessionApprovalKind = "mcp" + PermissionDecisionApproveForSessionApprovalKindMCPSampling PermissionDecisionApproveForSessionApprovalKind = "mcp-sampling" + PermissionDecisionApproveForSessionApprovalKindMemory PermissionDecisionApproveForSessionApprovalKind = "memory" + PermissionDecisionApproveForSessionApprovalKindRead PermissionDecisionApproveForSessionApprovalKind = "read" + PermissionDecisionApproveForSessionApprovalKindWrite PermissionDecisionApproveForSessionApprovalKind = "write" ) -// Path conventions used by this filesystem -// Experimental: SessionFSSetProviderConventions is part of an experimental API and may -// change or be removed. -type SessionFSSetProviderConventions string +// Kind discriminator for PermissionDecision. +type PermissionDecisionKind string const ( - // Paths use POSIX path conventions. - SessionFSSetProviderConventionsPosix SessionFSSetProviderConventions = "posix" - // Paths use Windows path conventions. - SessionFSSetProviderConventionsWindows SessionFSSetProviderConventions = "windows" + PermissionDecisionKindApproved PermissionDecisionKind = "approved" + PermissionDecisionKindApprovedForLocation PermissionDecisionKind = "approved-for-location" + PermissionDecisionKindApprovedForSession PermissionDecisionKind = "approved-for-session" + PermissionDecisionKindApproveForLocation PermissionDecisionKind = "approve-for-location" + PermissionDecisionKindApproveForSession PermissionDecisionKind = "approve-for-session" + PermissionDecisionKindApproveOnce PermissionDecisionKind = "approve-once" + PermissionDecisionKindApprovePermanently PermissionDecisionKind = "approve-permanently" + PermissionDecisionKindCancelled PermissionDecisionKind = "cancelled" + PermissionDecisionKindDeniedByContentExclusionPolicy PermissionDecisionKind = "denied-by-content-exclusion-policy" + PermissionDecisionKindDeniedByPermissionRequestHook PermissionDecisionKind = "denied-by-permission-request-hook" + PermissionDecisionKindDeniedByRules PermissionDecisionKind = "denied-by-rules" + PermissionDecisionKindDeniedInteractivelyByUser PermissionDecisionKind = "denied-interactively-by-user" + PermissionDecisionKindDeniedNoApprovalRuleAndCouldNotRequestFromUser PermissionDecisionKind = "denied-no-approval-rule-and-could-not-request-from-user" + PermissionDecisionKindReject PermissionDecisionKind = "reject" + PermissionDecisionKindUserNotAvailable PermissionDecisionKind = "user-not-available" ) -// How to execute the query: 'exec' for DDL/multi-statement (no results), 'query' for SELECT -// (returns rows), 'run' for INSERT/UPDATE/DELETE (returns rowsAffected) -// Experimental: SessionFSSqliteQueryType is part of an experimental API and may change or +// Disposition of a permission request as observed by the responding client. +// Experimental: PermissionDecisionOutcome is part of an experimental API and may change or // be removed. -type SessionFSSqliteQueryType string +type PermissionDecisionOutcome string const ( - // Execute DDL or multi-statement SQL without returning rows. - SessionFSSqliteQueryTypeExec SessionFSSqliteQueryType = "exec" - // Execute a SELECT-style query and return rows. - SessionFSSqliteQueryTypeQuery SessionFSSqliteQueryType = "query" - // Execute INSERT, UPDATE, or DELETE SQL and return affected-row metadata. - SessionFSSqliteQueryTypeRun SessionFSSqliteQueryType = "run" + // The request was approved automatically without a new human decision. + PermissionDecisionOutcomeAutoApproved PermissionDecisionOutcome = "auto_approved" + // The request was denied without an interactive user decision; source records why. + PermissionDecisionOutcomeAutopilotDenied PermissionDecisionOutcome = "autopilot_denied" + // The response came from an interactive user prompt. + PermissionDecisionOutcomePromptedUser PermissionDecisionOutcome = "prompted_user" ) -// SQLite transaction failure classification. -// Experimental: SessionFSSqliteTransactionErrorClass is part of an experimental API and may -// change or be removed. -type SessionFSSqliteTransactionErrorClass string +// Controlled reason or actor responsible for a permission response. +// Experimental: PermissionDecisionSource is part of an experimental API and may change or +// be removed. +type PermissionDecisionSource string const ( - // SQLite reported BUSY or LOCKED before commit; the transaction was rolled back and may be - // retried. - SessionFSSqliteTransactionErrorClassBusyOrLocked SessionFSSqliteTransactionErrorClass = "busyOrLocked" - // The statement, database, or provider failed definitively and must not be retried - // automatically. - SessionFSSqliteTransactionErrorClassFatal SessionFSSqliteTransactionErrorClass = "fatal" - // The transport failed after the provider may have committed; retrying could duplicate - // effects. - SessionFSSqliteTransactionErrorClassPostCommitAmbiguous SessionFSSqliteTransactionErrorClass = "postCommitAmbiguous" + // The response followed the assisted-approval judge recommendation. + PermissionDecisionSourceAssistedApproval PermissionDecisionSource = "assisted_approval" + // A live authorization record from an earlier human decision in this session contained the + // proposal, so it ran without another prompt. This is not a new human decision and never + // mints authority of its own. + PermissionDecisionSourceAuthorizationCarryForward PermissionDecisionSource = "authorization_carry_forward" + // The host applied a standing policy or override rather than a judge recommendation or + // human decision. + PermissionDecisionSourceHostPolicy PermissionDecisionSource = "host_policy" + // A human supplied the response through an interactive prompt. + PermissionDecisionSourceHumanResponse PermissionDecisionSource = "human_response" + // The host denied the request because no interactive user response was available. + PermissionDecisionSourceUnattendedFallback PermissionDecisionSource = "unattended_fallback" ) -// What initiated this compaction request, recorded as the `trigger` on the persisted -// `session.compaction_start` / `session.compaction_complete` events. When absent, the -// compaction is persisted without trigger attribution (initiator unknown). -type SessionHistoryCompactRequestTrigger string +// Client surface that submitted a permission response. +// Experimental: PermissionDecisionSurface is part of an experimental API and may change or +// be removed. +type PermissionDecisionSurface string const ( - // User-requested compaction, e.g. the /compact command or a direct history.compact call. - SessionHistoryCompactRequestTriggerManual SessionHistoryCompactRequestTrigger = "manual" - // Compaction requested while switching to a model with a smaller context window. - SessionHistoryCompactRequestTriggerModelSwitch SessionHistoryCompactRequestTrigger = "model_switch" + // An Agent Client Protocol host. + PermissionDecisionSurfaceAcp PermissionDecisionSurface = "acp" + // The Copilot App client. + PermissionDecisionSurfaceCopilotApp PermissionDecisionSurface = "copilot_app" + // The non-interactive Copilot CLI prompt mode. + PermissionDecisionSurfacePromptMode PermissionDecisionSurface = "prompt_mode" + // A generic Copilot SDK client. + PermissionDecisionSurfaceSDK PermissionDecisionSurface = "sdk" + // The interactive Copilot CLI terminal UI. + PermissionDecisionSurfaceTui PermissionDecisionSurface = "tui" ) -// Constant value. Always "github". -type SessionInstalledPluginSourceGitHubSource string +// Whether the location is a git repo or directory +// Experimental: PermissionLocationType is part of an experimental API and may change or be +// removed. +type PermissionLocationType string const ( - SessionInstalledPluginSourceGitHubSourceGitHub SessionInstalledPluginSourceGitHubSource = "github" + // The permission location is persisted at the working directory. + PermissionLocationTypeDir PermissionLocationType = "dir" + // The permission location is persisted at the git repository root. + PermissionLocationTypeRepo PermissionLocationType = "repo" ) -// Constant value. Always "local". -type SessionInstalledPluginSourceLocalSource string +// Current or requested permission mode. +// Experimental: PermissionMode is part of an experimental API and may change or be removed. +type PermissionMode string const ( - SessionInstalledPluginSourceLocalSourceLocal SessionInstalledPluginSourceLocalSource = "local" + // Tool, path, and URL permission requests are automatically approved. + PermissionModeAllowAll PermissionMode = "allow-all" + // Permission requests include an LLM safety recommendation; clients may automatically + // approve requests judged acceptable. + PermissionModeAssisted PermissionMode = "assisted" + // Permission requests follow the normal approval flow. + PermissionModeManual PermissionMode = "manual" ) -// Constant value. Always "url". -type SessionInstalledPluginSourceURLSource string +// Optional source for permission-mode telemetry. Defaults to `rpc` when omitted for SDK +// callers. +// Experimental: PermissionModeSource is part of an experimental API and may change or be +// removed. +type PermissionModeSource string const ( - SessionInstalledPluginSourceURLSourceURL SessionInstalledPluginSourceURLSource = "url" + // The mode was set by confirming autopilot behavior. + PermissionModeSourceAutopilotConfirmation PermissionModeSource = "autopilot_confirmation" + // The mode was set from a CLI command-line flag. + PermissionModeSourceCLIFlag PermissionModeSource = "cli_flag" + // The mode was set at startup by authenticated organization targeting. + PermissionModeSourceOrganizationTargeting PermissionModeSource = "organization_targeting" + // The mode was set through an RPC caller. + PermissionModeSourceRPC PermissionModeSource = "rpc" + // The mode was set by a slash command. + PermissionModeSourceSlashCommand PermissionModeSource = "slash_command" + // The mode was set at startup by the `defaultPermissionMode` user setting. + PermissionModeSourceUserSetting PermissionModeSource = "user_setting" ) -// Client population used for the prediction baseline. -// Experimental: SessionLimitPredictionClientType is part of an experimental API and may +// Runtime handling applied to a recovery attempt +// Experimental: PermissionRecoveryAttemptDisposition is part of an experimental API and may // change or be removed. -type SessionLimitPredictionClientType string +type PermissionRecoveryAttemptDisposition string const ( - // Interactive CLI sessions where a user can accept, edit, or top up the limit. - SessionLimitPredictionClientTypeCLIInteractive SessionLimitPredictionClientType = "cli-interactive" - // Prompt/non-interactive CLI sessions where the initial limit must cover more of the run. - SessionLimitPredictionClientTypeCLIPrompt SessionLimitPredictionClientType = "cli-prompt" + // The interactive responder approved the request. + PermissionRecoveryAttemptDispositionApproved PermissionRecoveryAttemptDisposition = "approved" + // The request exhausted unattended recovery and produced a blocked outcome. + PermissionRecoveryAttemptDispositionBlocked PermissionRecoveryAttemptDisposition = "blocked" + // The request was denied without prompting so the agent could try an alternative. + PermissionRecoveryAttemptDispositionDeferred PermissionRecoveryAttemptDisposition = "deferred" + // The interactive responder denied the request or became unavailable. + PermissionRecoveryAttemptDispositionDenied PermissionRecoveryAttemptDisposition = "denied" + // The request was surfaced to an interactive responder. + PermissionRecoveryAttemptDispositionPrompted PermissionRecoveryAttemptDisposition = "prompted" + // A tool call succeeded as an equivalent alternative. + PermissionRecoveryAttemptDispositionSucceeded PermissionRecoveryAttemptDisposition = "succeeded" ) -// Kind discriminator for SessionLimitPredictionResult. -type SessionLimitPredictionResultKind string +// Controlled reason for an individual attempt disposition +// Experimental: PermissionRecoveryAttemptReason is part of an experimental API and may +// change or be removed. +type PermissionRecoveryAttemptReason string + +const ( + // The request exceeded the bounded number of distinct attempts. + PermissionRecoveryAttemptReasonAttemptsExhausted PermissionRecoveryAttemptReason = "attempts_exhausted" + // The tool call succeeded without the blocked permission. + PermissionRecoveryAttemptReasonEquivalentAlternativeSucceeded PermissionRecoveryAttemptReason = "equivalent_alternative_succeeded" + // The interactive responder approved the request. + PermissionRecoveryAttemptReasonPermissionApproved PermissionRecoveryAttemptReason = "permission_approved" + // The interactive responder denied the request. + PermissionRecoveryAttemptReasonPermissionDenied PermissionRecoveryAttemptReason = "permission_denied" + // The attempt required permission that Assisted Permissions could not grant. + PermissionRecoveryAttemptReasonPermissionRequired PermissionRecoveryAttemptReason = "permission_required" + // The request repeated an earlier attempt. + PermissionRecoveryAttemptReasonRepeatedAttempt PermissionRecoveryAttemptReason = "repeated_attempt" + // The interactive responder became unavailable. + PermissionRecoveryAttemptReasonResponderUnavailable PermissionRecoveryAttemptReason = "responder_unavailable" +) + +// Relationship of an attempt to earlier permission requests +// Experimental: PermissionRecoveryAttemptRelation is part of an experimental API and may +// change or be removed. +type PermissionRecoveryAttemptRelation string const ( - SessionLimitPredictionResultKindAvailable SessionLimitPredictionResultKind = "available" - SessionLimitPredictionResultKindUnavailable SessionLimitPredictionResultKind = "unavailable" + // A distinct request or a successful alternative tool call. + PermissionRecoveryAttemptRelationAlternative PermissionRecoveryAttemptRelation = "alternative" + // The first denied permission request in the episode. + PermissionRecoveryAttemptRelationInitial PermissionRecoveryAttemptRelation = "initial" + // A request equivalent to an earlier attempt. + PermissionRecoveryAttemptRelationRetry PermissionRecoveryAttemptRelation = "retry" ) -// Baseline fallback level used to create the prediction. -// Experimental: SessionLimitPredictionSource is part of an experimental API and may change +// Action selected when autonomous recovery cannot continue +// Experimental: PermissionRecoveryOnBlocked is part of an experimental API and may change // or be removed. -type SessionLimitPredictionSource string +type PermissionRecoveryOnBlocked string const ( - // The exact model was unavailable, so the prediction used the model family's baseline cell. - SessionLimitPredictionSourceFamily SessionLimitPredictionSource = "family" - // No model or family cell was available, so the prediction used the global client-type - // baseline cell. - SessionLimitPredictionSourceGlobal SessionLimitPredictionSource = "global" - // The prediction used the exact resolved model's baseline cell. - SessionLimitPredictionSourceModel SessionLimitPredictionSource = "model" + // Surface the existing permission prompt to a response-capable client. + PermissionRecoveryOnBlockedAsk PermissionRecoveryOnBlocked = "ask" + // Return a structured unsuccessful blocked outcome because no responder is available. + PermissionRecoveryOnBlockedFail PermissionRecoveryOnBlocked = "fail" ) -// Semantic usage tier used for a recommended cap or additional headroom. -// Experimental: SessionLimitPredictionTier is part of an experimental API and may change or +// Controlled reason for a permission-recovery episode transition +// Experimental: PermissionRecoveryReason is part of an experimental API and may change or // be removed. -type SessionLimitPredictionTier string +type PermissionRecoveryReason string + +const ( + // The bounded number of distinct permission attempts was exhausted. + PermissionRecoveryReasonAttemptsExhausted PermissionRecoveryReason = "attempts_exhausted" + // A later tool call succeeded without requiring the blocked permission. + PermissionRecoveryReasonEquivalentAlternativeSucceeded PermissionRecoveryReason = "equivalent_alternative_succeeded" + // A responder approved the escalated permission request. + PermissionRecoveryReasonPermissionApproved PermissionRecoveryReason = "permission_approved" + // A responder denied the escalated permission request. + PermissionRecoveryReasonPermissionDenied PermissionRecoveryReason = "permission_denied" + // An action required permission that Assisted Permissions could not grant. + PermissionRecoveryReasonPermissionRequired PermissionRecoveryReason = "permission_required" + // The agent repeated an equivalent permission request instead of making progress. + PermissionRecoveryReasonRepeatedAttempt PermissionRecoveryReason = "repeated_attempt" + // The response-capable client became unavailable while escalation was pending. + PermissionRecoveryReasonResponderUnavailable PermissionRecoveryReason = "responder_unavailable" +) + +// Lifecycle state of a permission-recovery episode +// Experimental: PermissionRecoveryStatus is part of an experimental API and may change or +// be removed. +type PermissionRecoveryStatus string const ( - // Additional headroom for longer-running sessions. - SessionLimitPredictionTierAdditionalHeadroom SessionLimitPredictionTier = "additional_headroom" - // Generous headroom for unusually high usage. - SessionLimitPredictionTierGenerousHeadroom SessionLimitPredictionTier = "generous_headroom" - // Maximum available headroom tier. - SessionLimitPredictionTierMaximumHeadroom SessionLimitPredictionTier = "maximum_headroom" - // Recommended starting tier. - SessionLimitPredictionTierRecommended SessionLimitPredictionTier = "recommended" + // An interactive permission response is required. + PermissionRecoveryStatusAwaitingApproval PermissionRecoveryStatus = "awaiting_approval" + // No autonomous path remains and the task requires intervention. + PermissionRecoveryStatusBlocked PermissionRecoveryStatus = "blocked" + // Autopilot may try a bounded equivalent alternative. + PermissionRecoveryStatusRecovering PermissionRecoveryStatus = "recovering" + // The episode ended through approval or a successful equivalent alternative. + PermissionRecoveryStatusResolved PermissionRecoveryStatus = "resolved" ) -// Reason a prediction could not be computed. -// Experimental: SessionLimitPredictionUnavailableReason is part of an experimental API and -// may change or be removed. -type SessionLimitPredictionUnavailableReason string +// Response capability available to the client when it settled a permission request. +// Experimental: PermissionResponseCapability is part of an experimental API and may change +// or be removed. +type PermissionResponseCapability string const ( - // The current model is auto and has not resolved to a concrete model yet. - SessionLimitPredictionUnavailableReasonAutoUnresolved SessionLimitPredictionUnavailableReason = "auto_unresolved" - // No model was provided and the session does not currently have a selected model. - SessionLimitPredictionUnavailableReasonNoModel SessionLimitPredictionUnavailableReason = "no_model" + // The client could return an automated response but could not ask a user. + PermissionResponseCapabilityHeadless PermissionResponseCapability = "headless" + // The client could ask a user for this decision. + PermissionResponseCapabilityInteractive PermissionResponseCapability = "interactive" + // The client had no response path available. + PermissionResponseCapabilityNone PermissionResponseCapability = "none" ) -// Log severity level. Determines how the message is displayed in the timeline. Defaults to -// "info". -// Experimental: SessionLogLevel is part of an experimental API and may change or be removed. -type SessionLogLevel string - -const ( - // Error message describing a failure. - SessionLogLevelError SessionLogLevel = "error" - // Informational message. - SessionLogLevelInfo SessionLogLevel = "info" - // Warning message that may require attention. - SessionLogLevelWarning SessionLogLevel = "warning" -) - -// The session mode the agent is operating in -// Experimental: SessionMode is part of an experimental API and may change or be removed. -type SessionMode string - -const ( - // The agent is working autonomously toward task completion. - SessionModeAutopilot SessionMode = "autopilot" - // The agent is responding interactively to the user. - SessionModeInteractive SessionMode = "interactive" - // The agent is preparing a plan before making changes. - SessionModePlan SessionMode = "plan" -) - -// Allowed values for the `SessionOpenOptionsAdditionalContentExclusionPolicyScope` +// Allowed values for the `PermissionsConfigureAdditionalContentExclusionPolicyScope` // enumeration. -// Experimental: SessionOpenOptionsAdditionalContentExclusionPolicyScope is part of an +// Experimental: PermissionsConfigureAdditionalContentExclusionPolicyScope is part of an // experimental API and may change or be removed. -type SessionOpenOptionsAdditionalContentExclusionPolicyScope string +type PermissionsConfigureAdditionalContentExclusionPolicyScope string const ( // The content exclusion policy applies across all repositories. - SessionOpenOptionsAdditionalContentExclusionPolicyScopeAll SessionOpenOptionsAdditionalContentExclusionPolicyScope = "all" + PermissionsConfigureAdditionalContentExclusionPolicyScopeAll PermissionsConfigureAdditionalContentExclusionPolicyScope = "all" // The content exclusion policy applies to the current repository. - SessionOpenOptionsAdditionalContentExclusionPolicyScopeRepo SessionOpenOptionsAdditionalContentExclusionPolicyScope = "repo" + PermissionsConfigureAdditionalContentExclusionPolicyScopeRepo PermissionsConfigureAdditionalContentExclusionPolicyScope = "repo" ) -// How MCP server environment values are interpreted. -// Experimental: SessionOpenOptionsEnvValueMode is part of an experimental API and may -// change or be removed. -type SessionOpenOptionsEnvValueMode string +// Kind discriminator for PermissionsLocationsAddToolApprovalDetails. +type PermissionsLocationsAddToolApprovalDetailsKind string const ( - // Pass MCP server environment values as literal strings. - SessionOpenOptionsEnvValueModeDirect SessionOpenOptionsEnvValueMode = "direct" - // Resolve MCP server environment values from host-side references. - SessionOpenOptionsEnvValueModeIndirect SessionOpenOptionsEnvValueMode = "indirect" + PermissionsLocationsAddToolApprovalDetailsKindCommands PermissionsLocationsAddToolApprovalDetailsKind = "commands" + PermissionsLocationsAddToolApprovalDetailsKindCustomTool PermissionsLocationsAddToolApprovalDetailsKind = "custom-tool" + PermissionsLocationsAddToolApprovalDetailsKindExtensionEnvAccess PermissionsLocationsAddToolApprovalDetailsKind = "extension-env-access" + PermissionsLocationsAddToolApprovalDetailsKindExtensionManagement PermissionsLocationsAddToolApprovalDetailsKind = "extension-management" + PermissionsLocationsAddToolApprovalDetailsKindExtensionPermissionAccess PermissionsLocationsAddToolApprovalDetailsKind = "extension-permission-access" + PermissionsLocationsAddToolApprovalDetailsKindFactory PermissionsLocationsAddToolApprovalDetailsKind = "factory" + PermissionsLocationsAddToolApprovalDetailsKindMCP PermissionsLocationsAddToolApprovalDetailsKind = "mcp" + PermissionsLocationsAddToolApprovalDetailsKindMCPSampling PermissionsLocationsAddToolApprovalDetailsKind = "mcp-sampling" + PermissionsLocationsAddToolApprovalDetailsKindMemory PermissionsLocationsAddToolApprovalDetailsKind = "memory" + PermissionsLocationsAddToolApprovalDetailsKindRead PermissionsLocationsAddToolApprovalDetailsKind = "read" + PermissionsLocationsAddToolApprovalDetailsKindWrite PermissionsLocationsAddToolApprovalDetailsKind = "write" ) -// Initial reasoning summary mode for supported model clients. -// Experimental: SessionOpenOptionsReasoningSummary is part of an experimental API and may -// change or be removed. -type SessionOpenOptionsReasoningSummary string +// Whether the change applies to ephemeral session-scoped rules (cleared at session end) or +// to location-scoped rules persisted via the location-permissions config file. +// Experimental: PermissionsModifyRulesScope is part of an experimental API and may change +// or be removed. +type PermissionsModifyRulesScope string const ( - // Request a concise summary of model reasoning. - SessionOpenOptionsReasoningSummaryConcise SessionOpenOptionsReasoningSummary = "concise" - // Request a detailed summary of model reasoning. - SessionOpenOptionsReasoningSummaryDetailed SessionOpenOptionsReasoningSummary = "detailed" - // Do not request reasoning summaries from the model. - SessionOpenOptionsReasoningSummaryNone SessionOpenOptionsReasoningSummary = "none" + // Persist the rule change for this project location. + PermissionsModifyRulesScopeLocation PermissionsModifyRulesScope = "location" + // Apply the rule change only to this session. + PermissionsModifyRulesScopeSession PermissionsModifyRulesScope = "session" ) -// Kind discriminator for SessionOpenParams. -type SessionOpenParamsKind string +// Optional source for allow-all telemetry. Defaults to `rpc` when omitted for SDK callers. +// Experimental: PermissionsSetApproveAllSource is part of an experimental API and may +// change or be removed. +type PermissionsSetApproveAllSource string const ( - SessionOpenParamsKindAttach SessionOpenParamsKind = "attach" - SessionOpenParamsKindCloud SessionOpenParamsKind = "cloud" - SessionOpenParamsKindCreate SessionOpenParamsKind = "create" - SessionOpenParamsKindHandoff SessionOpenParamsKind = "handoff" - SessionOpenParamsKindRemote SessionOpenParamsKind = "remote" - SessionOpenParamsKindResume SessionOpenParamsKind = "resume" - SessionOpenParamsKindResumeLast SessionOpenParamsKind = "resumeLast" + // Allow-all was enabled by confirming autopilot behavior. + PermissionsSetApproveAllSourceAutopilotConfirmation PermissionsSetApproveAllSource = "autopilot_confirmation" + // Allow-all was enabled from a CLI command-line flag. + PermissionsSetApproveAllSourceCLIFlag PermissionsSetApproveAllSource = "cli_flag" + // Allow-all was enabled through an RPC caller. + PermissionsSetApproveAllSourceRPC PermissionsSetApproveAllSource = "rpc" + // Allow-all was enabled by a slash command. + PermissionsSetApproveAllSourceSlashCommand PermissionsSetApproveAllSource = "slash_command" + // Allow-all was enabled at startup by the `defaultPermissionMode` user setting. + PermissionsSetApproveAllSourceUserSetting PermissionsSetApproveAllSource = "user_setting" ) -// Status discriminator for SessionsClientMetadataEntry. -type SessionsClientMetadataEntryStatus string +// Where completed plugin content was staged before atomic promotion. +// Experimental: PluginInstallStagingMode is part of an experimental API and may change or +// be removed. +type PluginInstallStagingMode string const ( - SessionsClientMetadataEntryStatusCorrupt SessionsClientMetadataEntryStatus = "corrupt" - SessionsClientMetadataEntryStatusNotFound SessionsClientMetadataEntryStatus = "notFound" - SessionsClientMetadataEntryStatusOk SessionsClientMetadataEntryStatus = "ok" - SessionsClientMetadataEntryStatusUnavailable SessionsClientMetadataEntryStatus = "unavailable" - SessionsClientMetadataEntryStatusUnsupportedVersion SessionsClientMetadataEntryStatus = "unsupportedVersion" + // A sibling of the destination plugin directory, used when external staging is unavailable. + PluginInstallStagingModeDestinationSibling PluginInstallStagingMode = "destination_sibling" + // A sibling of the installed-plugins root, outside the recursively watched tree. + PluginInstallStagingModeExternal PluginInstallStagingMode = "external" ) -// Rust-owned settings predicates exposed across the SDK boundary. Raw feature-flag names -// are intentionally not part of the contract. -// Experimental: SessionSettingsPredicateName is part of an experimental API and may change -// or be removed. -type SessionSettingsPredicateName string +// Experimental: ProtocolAppendMode is part of an experimental API and may change or be +// removed. +type ProtocolAppendMode string const ( - // Whether Claude Opus token-limit caps should be applied. - SessionSettingsPredicateNameCapClaudeOpusTokenLimitsEnabled SessionSettingsPredicateName = "capClaudeOpusTokenLimitsEnabled" - // Whether CCA should use the TypeScript autofind behavior. - SessionSettingsPredicateNameCcaUseTsAutofindEnabled SessionSettingsPredicateName = "ccaUseTsAutofindEnabled" - // Whether Chronicle integration is enabled. - SessionSettingsPredicateNameChronicleEnabled SessionSettingsPredicateName = "chronicleEnabled" - // Whether the co-author hook is enabled. - SessionSettingsPredicateNameCoAuthorHookEnabled SessionSettingsPredicateName = "coAuthorHookEnabled" - // Whether the CodeQL checker is enabled. - SessionSettingsPredicateNameCodeqlCheckerEnabled SessionSettingsPredicateName = "codeqlCheckerEnabled" - // Whether code-review behavior is enabled. - SessionSettingsPredicateNameCodeReviewFeatureEnabled SessionSettingsPredicateName = "codeReviewFeatureEnabled" - // Whether content-exclusion policy may self-fetch data. - SessionSettingsPredicateNameContentExclusionSelfFetchEnabled SessionSettingsPredicateName = "contentExclusionSelfFetchEnabled" - // Whether the Dependabot checker is enabled. - SessionSettingsPredicateNameDependabotCheckerEnabled SessionSettingsPredicateName = "dependabotCheckerEnabled" - // Whether the dependency checker is enabled. - SessionSettingsPredicateNameDependencyCheckerEnabled SessionSettingsPredicateName = "dependencyCheckerEnabled" - // Whether validation may run in parallel. - SessionSettingsPredicateNameParallelValidationEnabled SessionSettingsPredicateName = "parallelValidationEnabled" - // Whether runtime timing telemetry is enabled. - SessionSettingsPredicateNameRuntimeTimingTelemetryEnabled SessionSettingsPredicateName = "runtimeTimingTelemetryEnabled" - // Whether the security-tools feature flag enables security tool wiring. - SessionSettingsPredicateNameSecurityToolsEnabled SessionSettingsPredicateName = "securityToolsEnabled" - // Whether third-party security tools should receive the security prompt. - SessionSettingsPredicateNameThirdPartySecurityPromptEnabled SessionSettingsPredicateName = "thirdPartySecurityPromptEnabled" - // Whether trivial-change handling is enabled. - SessionSettingsPredicateNameTrivialChangeEnabled SessionSettingsPredicateName = "trivialChangeEnabled" - // Whether trivial-change handling is enabled for code review. - SessionSettingsPredicateNameTrivialChangeEnabledForCodeReview SessionSettingsPredicateName = "trivialChangeEnabledForCodeReview" - // Whether trivial-change handling is enabled for a specific tool. - SessionSettingsPredicateNameTrivialChangeEnabledForTool SessionSettingsPredicateName = "trivialChangeEnabledForTool" - // Whether trivial-change skip behavior is enabled. - SessionSettingsPredicateNameTrivialChangeSkipEnabled SessionSettingsPredicateName = "trivialChangeSkipEnabled" - // Whether trivial-change skip behavior is enabled for code review. - SessionSettingsPredicateNameTrivialChangeSkipEnabledForCodeReview SessionSettingsPredicateName = "trivialChangeSkipEnabledForCodeReview" - // Whether trivial-change skip behavior is enabled for a specific tool. - SessionSettingsPredicateNameTrivialChangeSkipEnabledForTool SessionSettingsPredicateName = "trivialChangeSkipEnabledForTool" + ProtocolAppendModeAppend ProtocolAppendMode = "append" ) -// Task type determines the handoff strategy (CCA fetches events; CLI prepares a transient -// session). -// Experimental: SessionsOpenHandoffTaskType is part of an experimental API and may change -// or be removed. -type SessionsOpenHandoffTaskType string +// Experimental: ProtocolCustomizeMode is part of an experimental API and may change or be +// removed. +type ProtocolCustomizeMode string const ( - // GitHub Copilot coding agent task. - SessionsOpenHandoffTaskTypeCca SessionsOpenHandoffTaskType = "cca" - // CLI remote task. - SessionsOpenHandoffTaskTypeCLI SessionsOpenHandoffTaskType = "cli" + ProtocolCustomizeModeCustomize ProtocolCustomizeMode = "customize" ) -// Step status. -// Experimental: SessionsOpenProgressStatus is part of an experimental API and may change or +// Controls whether the runtime may defer loading an external tool definition. +// Experimental: ProtocolExternalToolDefer is part of an experimental API and may change or // be removed. -type SessionsOpenProgressStatus string +type ProtocolExternalToolDefer string const ( - // The step has completed successfully. - SessionsOpenProgressStatusComplete SessionsOpenProgressStatus = "complete" - // The step has started and has not yet finished. - SessionsOpenProgressStatusInProgress SessionsOpenProgressStatus = "in-progress" + // The runtime may defer the tool according to its tool-loading policy. + ProtocolExternalToolDeferAuto ProtocolExternalToolDefer = "auto" + // The runtime must include the tool without deferring it. + ProtocolExternalToolDeferNever ProtocolExternalToolDefer = "never" ) -// Handoff step. -// Experimental: SessionsOpenProgressStep is part of an experimental API and may change or -// be removed. -type SessionsOpenProgressStep string +// Action discriminator for ProtocolMarkerSectionOverride. +type ProtocolMarkerSectionOverrideAction string const ( - // Checking the local working tree for uncommitted changes that would block the handoff. - SessionsOpenProgressStepCheckChanges SessionsOpenProgressStep = "check-changes" - // Checking out the branch associated with the remote session in the local working tree. - SessionsOpenProgressStepCheckoutBranch SessionsOpenProgressStep = "checkout-branch" - // Creating the new local session and seeding it with the source session's events. - SessionsOpenProgressStepCreateSession SessionsOpenProgressStep = "create-session" - // Loading the source session's events from the remote service. - SessionsOpenProgressStepLoadSession SessionsOpenProgressStep = "load-session" - // Persisting the newly-created local session to disk. - SessionsOpenProgressStepSaveSession SessionsOpenProgressStep = "save-session" - // Validating that the local repository matches the remote session's repository. - SessionsOpenProgressStepValidateRepo SessionsOpenProgressStep = "validate-repo" + ProtocolMarkerSectionOverrideActionPreserve ProtocolMarkerSectionOverrideAction = "preserve" + ProtocolMarkerSectionOverrideActionTransform ProtocolMarkerSectionOverrideAction = "transform" ) -// Outcome of the open request. -// Experimental: SessionsOpenStatus is part of an experimental API and may change or be +// Experimental: ProtocolReplaceMode is part of an experimental API and may change or be // removed. -type SessionsOpenStatus string +type ProtocolReplaceMode string const ( - // Connected to an existing remote session. - SessionsOpenStatusConnected SessionsOpenStatus = "connected" - // A new session was created. - SessionsOpenStatusCreated SessionsOpenStatus = "created" - // Remote session was handed off to a new local session. - SessionsOpenStatusHandedOff SessionsOpenStatus = "handed_off" - // No matching persisted session was found. - SessionsOpenStatusNotFound SessionsOpenStatus = "not_found" - // An existing session was loaded or reattached. - SessionsOpenStatusResumed SessionsOpenStatus = "resumed" + ProtocolReplaceModeReplace ProtocolReplaceMode = "replace" ) -// Which session sources to include. Defaults to `local` for backward compatibility. -// Experimental: SessionSource is part of an experimental API and may change or be removed. -type SessionSource string +// Experimental: ProtocolStaticSectionAction is part of an experimental API and may change +// or be removed. +type ProtocolStaticSectionAction string const ( - // Return both local and remote sessions. - SessionSourceAll SessionSource = "all" - // Return only local sessions. - SessionSourceLocal SessionSource = "local" - // Return only remote sessions. - SessionSourceRemote SessionSource = "remote" + // Append content to the section. + ProtocolStaticSectionActionAppend ProtocolStaticSectionAction = "append" + // Prepend content to the section. + ProtocolStaticSectionActionPrepend ProtocolStaticSectionAction = "prepend" + // Remove the section content. + ProtocolStaticSectionActionRemove ProtocolStaticSectionAction = "remove" + // Replace the section content. + ProtocolStaticSectionActionReplace ProtocolStaticSectionAction = "replace" ) -// Sharing status for a synced session. "repo" makes the session visible to anyone with read -// access to the repository; "unshared" restricts it to the creator and collaborators. -// Experimental: SessionVisibilityStatus is part of an experimental API and may change or be -// removed. -type SessionVisibilityStatus string +type ProtocolSystemMessageConfigMode string const ( - // The session is visible to repository readers. - SessionVisibilityStatusRepo SessionVisibilityStatus = "repo" - // The session is restricted to its creator and collaborators. - SessionVisibilityStatusUnshared SessionVisibilityStatus = "unshared" -) - -// Hosting platform type of the repository -// Experimental: SessionWorkingDirectoryContextHostType is part of an experimental API and -// may change or be removed. -type SessionWorkingDirectoryContextHostType string - -const ( - // The working directory repository is hosted on Azure DevOps. - SessionWorkingDirectoryContextHostTypeADO SessionWorkingDirectoryContextHostType = "ado" - // The working directory repository is hosted on GitHub. - SessionWorkingDirectoryContextHostTypeGitHub SessionWorkingDirectoryContextHostType = "github" + ProtocolSystemMessageConfigModeAppend ProtocolSystemMessageConfigMode = "append" + ProtocolSystemMessageConfigModeCustomize ProtocolSystemMessageConfigMode = "customize" + ProtocolSystemMessageConfigModeReplace ProtocolSystemMessageConfigMode = "replace" ) -// Type discriminator for SettableAuthInfo. -type SettableAuthInfoType string +// Provider transport. Defaults to "http". +// Experimental: ProviderConfigTransport is part of an experimental API and may change or be +// removed. +type ProviderConfigTransport string const ( - SettableAuthInfoTypeAPIKey SettableAuthInfoType = "api-key" - SettableAuthInfoTypeCopilotAPIToken SettableAuthInfoType = "copilot-api-token" - SettableAuthInfoTypeEnv SettableAuthInfoType = "env" - SettableAuthInfoTypeGhCLI SettableAuthInfoType = "gh-cli" - SettableAuthInfoTypeHMAC SettableAuthInfoType = "hmac" - SettableAuthInfoTypeToken SettableAuthInfoType = "token" - SettableAuthInfoTypeUser SettableAuthInfoType = "user" + // HTTP request/streaming transport. + ProviderConfigTransportHTTP ProviderConfigTransport = "http" + // WebSocket transport. + ProviderConfigTransportWebsockets ProviderConfigTransport = "websockets" ) -// Controls automatic non-interactive profile loading where supported. Explicit initScripts -// are unaffected. -// Experimental: ShellInitProfile is part of an experimental API and may change or be +// Provider type. Defaults to "openai" for generic OpenAI-compatible APIs. +// Experimental: ProviderConfigType is part of an experimental API and may change or be // removed. -type ShellInitProfile string +type ProviderConfigType string const ( - // Disable automatic non-interactive profile loading. Explicit initScripts still run. - ShellInitProfileNone ShellInitProfile = "none" - // Allow automatic non-interactive profile loading when supported. Explicit initScripts - // still run. - ShellInitProfileNonInteractive ShellInitProfile = "non-interactive" + // Anthropic API endpoint. + ProviderConfigTypeAnthropic ProviderConfigType = "anthropic" + // Azure OpenAI Service endpoint. + ProviderConfigTypeAzure ProviderConfigType = "azure" + // Generic OpenAI-compatible API. + ProviderConfigTypeOpenai ProviderConfigType = "openai" ) -// Supported built-in shells for initialization scripts. -// Experimental: ShellInitScriptShell is part of an experimental API and may change or be +// Wire API format (openai/azure only). Defaults to "completions". +// Experimental: ProviderConfigWireAPI is part of an experimental API and may change or be // removed. -type ShellInitScriptShell string +type ProviderConfigWireAPI string const ( - // Source the script in the built-in Bash shell on macOS and Linux. - ShellInitScriptShellBash ShellInitScriptShell = "bash" - // Source the script in the built-in PowerShell shell on Windows. - ShellInitScriptShellPowershell ShellInitScriptShell = "powershell" + // OpenAI Chat Completions wire format. + ProviderConfigWireAPICompletions ProviderConfigWireAPI = "completions" + // OpenAI Responses API wire format. + ProviderConfigWireAPIResponses ProviderConfigWireAPI = "responses" ) -// Signal to send (default: SIGTERM) -// Experimental: ShellKillSignal is part of an experimental API and may change or be removed. -type ShellKillSignal string +// Transport to be used for provider requests. +// Experimental: ProviderEndpointTransport is part of an experimental API and may change or +// be removed. +type ProviderEndpointTransport string const ( - // Send an interrupt signal to the process. - ShellKillSignalSIGINT ShellKillSignal = "SIGINT" - // Forcefully terminate the process. - ShellKillSignalSIGKILL ShellKillSignal = "SIGKILL" - // Request graceful process termination. - ShellKillSignalSIGTERM ShellKillSignal = "SIGTERM" + // HTTP request/streaming transport. + ProviderEndpointTransportHTTP ProviderEndpointTransport = "http" + // WebSocket transport. + ProviderEndpointTransportWebsockets ProviderEndpointTransport = "websockets" ) -// Why the session is being shut down. Defaults to "routine" when omitted. -// Experimental: ShutdownType is part of an experimental API and may change or be removed. -type ShutdownType string +// Provider family. Matches the `type` field of a BYOK provider config. +// Experimental: ProviderEndpointType is part of an experimental API and may change or be +// removed. +type ProviderEndpointType string const ( - // The session is shutting down because of an error. - ShutdownTypeError ShutdownType = "error" - // The session is shutting down normally. - ShutdownTypeRoutine ShutdownType = "routine" + // Anthropic endpoint (use the Anthropic client library). + ProviderEndpointTypeAnthropic ProviderEndpointType = "anthropic" + // Azure OpenAI endpoint (use the OpenAI client library with the Azure base URL). + ProviderEndpointTypeAzure ProviderEndpointType = "azure" + // OpenAI-compatible endpoint (use the OpenAI client library). + ProviderEndpointTypeOpenai ProviderEndpointType = "openai" ) -// Which tier this directory belongs to -// Experimental: SkillDiscoveryScope is part of an experimental API and may change or be +// Wire API to be used, when required for the provider type. +// Experimental: ProviderEndpointWireAPI is part of an experimental API and may change or be // removed. -type SkillDiscoveryScope string +type ProviderEndpointWireAPI string const ( - // A configured custom skill directory. - SkillDiscoveryScopeCustom SkillDiscoveryScope = "custom" - // The user's personal agents skill directory. - SkillDiscoveryScopePersonalAgents SkillDiscoveryScope = "personal-agents" - // The user's personal Copilot skill directory. - SkillDiscoveryScopePersonalCopilot SkillDiscoveryScope = "personal-copilot" - // A project's repository skill directory. - SkillDiscoveryScopeProject SkillDiscoveryScope = "project" + // Classic chat-completions request shape. + ProviderEndpointWireAPICompletions ProviderEndpointWireAPI = "completions" + // Newer responses request shape. + ProviderEndpointWireAPIResponses ProviderEndpointWireAPI = "responses" ) -// Source location type (e.g., project, personal-copilot, plugin, builtin, sdk) -// Experimental: SkillSource is part of an experimental API and may change or be removed. -type SkillSource string +// Type of GitHub reference +// Experimental: PushAttachmentGitHubReferenceType is part of an experimental API and may +// change or be removed. +type PushAttachmentGitHubReferenceType string const ( - // Skill bundled with the runtime. - SkillSourceBuiltin SkillSource = "builtin" - // Skill loaded from a configured custom skill directory. - SkillSourceCustom SkillSource = "custom" - // Skill discovered from a parent directory in the current workspace tree. - SkillSourceInherited SkillSource = "inherited" - // Skill defined in the user's personal agents skill directory. - SkillSourcePersonalAgents SkillSource = "personal-agents" - // Skill defined in the user's Copilot skill directory. - SkillSourcePersonalCopilot SkillSource = "personal-copilot" - // Skill provided by an installed plugin. - SkillSourcePlugin SkillSource = "plugin" - // Skill defined in the current project's skill directories. - SkillSourceProject SkillSource = "project" - // Pathless skill supplied lazily by an SDK skill provider. - SkillSourceSDK SkillSource = "sdk" + // GitHub discussion reference. + PushAttachmentGitHubReferenceTypeDiscussion PushAttachmentGitHubReferenceType = "discussion" + // GitHub issue reference. + PushAttachmentGitHubReferenceTypeIssue PushAttachmentGitHubReferenceType = "issue" + // GitHub pull request reference. + PushAttachmentGitHubReferenceTypePr PushAttachmentGitHubReferenceType = "pr" ) -// Optional completion hint for the input (e.g. 'directory' for filesystem path completion) -// Experimental: SlashCommandInputCompletion is part of an experimental API and may change -// or be removed. -type SlashCommandInputCompletion string +// Type discriminator for PushAttachment. +type PushAttachmentType string const ( - // Input should complete filesystem directories. - SlashCommandInputCompletionDirectory SlashCommandInputCompletion = "directory" + PushAttachmentTypeBlob PushAttachmentType = "blob" + PushAttachmentTypeDirectory PushAttachmentType = "directory" + PushAttachmentTypeExtensionContext PushAttachmentType = "extension_context" + PushAttachmentTypeFile PushAttachmentType = "file" + PushAttachmentTypeGitHubActionsJob PushAttachmentType = "github_actions_job" + PushAttachmentTypeGitHubCommit PushAttachmentType = "github_commit" + PushAttachmentTypeGitHubFile PushAttachmentType = "github_file" + PushAttachmentTypeGitHubFileDiff PushAttachmentType = "github_file_diff" + PushAttachmentTypeGitHubReference PushAttachmentType = "github_reference" + PushAttachmentTypeGitHubRelease PushAttachmentType = "github_release" + PushAttachmentTypeGitHubRepository PushAttachmentType = "github_repository" + PushAttachmentTypeGitHubSnippet PushAttachmentType = "github_snippet" + PushAttachmentTypeGitHubTreeComparison PushAttachmentType = "github_tree_comparison" + PushAttachmentTypeGitHubURL PushAttachmentType = "github_url" + PushAttachmentTypeSelection PushAttachmentType = "selection" ) -// Kind discriminator for SlashCommandInvocationResult. -type SlashCommandInvocationResultKind string +// Whether this item is a queued user message or a queued slash command / model change +// Experimental: QueuePendingItemsKind is part of an experimental API and may change or be +// removed. +type QueuePendingItemsKind string const ( - SlashCommandInvocationResultKindAddTimelineEntry SlashCommandInvocationResultKind = "add-timeline-entry" - SlashCommandInvocationResultKindAgentPrompt SlashCommandInvocationResultKind = "agent-prompt" - SlashCommandInvocationResultKindCompleted SlashCommandInvocationResultKind = "completed" - SlashCommandInvocationResultKindSelectSubcommand SlashCommandInvocationResultKind = "select-subcommand" - SlashCommandInvocationResultKindSetModel SlashCommandInvocationResultKind = "set-model" - SlashCommandInvocationResultKindSetPlanModel SlashCommandInvocationResultKind = "set-plan-model" - SlashCommandInvocationResultKindShowDialog SlashCommandInvocationResultKind = "show-dialog" - SlashCommandInvocationResultKindText SlashCommandInvocationResultKind = "text" + // A queued slash command or model-change command. + QueuePendingItemsKindCommand QueuePendingItemsKind = "command" + // A queued user message. + QueuePendingItemsKindMessage QueuePendingItemsKind = "message" ) -// Coarse command category for grouping and behavior: runtime built-in, skill-backed -// command, or SDK/client-owned command -// Experimental: SlashCommandKind is part of an experimental API and may change or be +// Reasoning summary mode to request for supported model clients +// Experimental: ReasoningSummary is part of an experimental API and may change or be // removed. -type SlashCommandKind string +type ReasoningSummary string const ( - // Command implemented by the runtime. - SlashCommandKindBuiltin SlashCommandKind = "builtin" - // Command registered by an SDK client or extension. - SlashCommandKindClient SlashCommandKind = "client" - // Command backed by a skill. - SlashCommandKindSkill SlashCommandKind = "skill" + // Request a concise summary of the model's reasoning. + ReasoningSummaryConcise ReasoningSummary = "concise" + // Request a detailed summary of the model's reasoning. + ReasoningSummaryDetailed ReasoningSummary = "detailed" + // Do not request reasoning summaries from the model. + ReasoningSummaryNone ReasoningSummary = "none" ) -// Discriminator for a model-picker dialog. -type SlashCommandModelPickerDialogKind string +// What the user must do to recover from a failure, named as an action rather than as one +// client's affordance. The runtime cannot know which affordance a client offers — a slash +// command, a settings pane, a link — so the accompanying message stays host-agnostic and +// each client renders its own copy from this value. Absent when the runtime knows of no +// action the user can take. +// Experimental: RemediationAction is part of an experimental API and may change or be +// removed. +type RemediationAction string const ( - SlashCommandModelPickerDialogKindModelPicker SlashCommandModelPickerDialogKind = "model-picker" + // Permit outbound network access in the sandbox policy. + RemediationActionAllowSandboxOutbound RemediationAction = "allow_sandbox_outbound" + // Review or widen the sandbox policy. The blocked path or host is named by the accompanying + // message or by the tool result the action arrived with. + RemediationActionReviewSandboxPolicy RemediationAction = "review_sandbox_policy" + // Inspect which account is currently authenticated before deciding what to change. + RemediationActionShowAccount RemediationAction = "show_account" + // Authenticate again with the Copilot backend. The current credential is absent, expired, + // or rejected. + RemediationActionSignIn RemediationAction = "sign_in" + // Authenticate as a different account. The current account exists but lacks access to the + // requested resource. + RemediationActionSwitchAccount RemediationAction = "switch_account" ) -// Context tier override for matching subagents -// Experimental: SubagentSettingsEntryContextTier is part of an experimental API and may -// change or be removed. -type SubagentSettingsEntryContextTier string +// State discriminator for RemoteControlStatus. +type RemoteControlStatusState string const ( - // Use the model's default context window. - SubagentSettingsEntryContextTierDefault SubagentSettingsEntryContextTier = "default" - // Inherit the parent session's effective context tier at dispatch time. - SubagentSettingsEntryContextTierInherit SubagentSettingsEntryContextTier = "inherit" - // Pin the subagent to the long-context tier when supported. - SubagentSettingsEntryContextTierLongContext SubagentSettingsEntryContextTier = "long_context" + RemoteControlStatusStateActive RemoteControlStatusState = "active" + RemoteControlStatusStateConnecting RemoteControlStatusState = "connecting" + RemoteControlStatusStateError RemoteControlStatusState = "error" + RemoteControlStatusStateOff RemoteControlStatusState = "off" ) -// Active status a client owner may publish with a progress update. -// Experimental: TaskClientActiveStatus is part of an experimental API and may change or be +// What a remote host says one of its sessions is doing right now. Deliberately coarse: this +// is what a host can report for EVERY session in a catalogue listing, without a client +// subscribing to each one. AHP's `SessionSummary.status` is the source today; +// `input-needed` covers both a permission prompt and an `ask_user` question, since the +// summary does not say which. +// Experimental: RemoteSessionHostStatus is part of an experimental API and may change or be // removed. -type TaskClientActiveStatus string +type RemoteSessionHostStatus string const ( - // The external owner is connected but waiting. - TaskClientActiveStatusIdle TaskClientActiveStatus = "idle" - // The external owner is actively working. - TaskClientActiveStatusRunning TaskClientActiveStatus = "running" + // The session ended its last turn in an error. + RemoteSessionHostStatusError RemoteSessionHostStatus = "error" + // No turn is running. + RemoteSessionHostStatusIdle RemoteSessionHostStatus = "idle" + // The session is blocked on the user: a permission prompt or an `ask_user` question. + RemoteSessionHostStatusInputNeeded RemoteSessionHostStatus = "input-needed" + // A turn is running. + RemoteSessionHostStatusWorking RemoteSessionHostStatus = "working" ) -// Client-owned tasks always execute outside the runtime in background mode. -// Experimental: TaskClientExecutionMode is part of an experimental API and may change or be -// removed. -type TaskClientExecutionMode string +// Whether the remote task originated from CCA or CLI `--remote`. +// Experimental: RemoteSessionMetadataTaskType is part of an experimental API and may change +// or be removed. +type RemoteSessionMetadataTaskType string const ( - TaskClientExecutionModeBackground TaskClientExecutionMode = "background" + // GitHub Copilot coding agent task. + RemoteSessionMetadataTaskTypeCca RemoteSessionMetadataTaskType = "cca" + // CLI remote task. + RemoteSessionMetadataTaskTypeCLI RemoteSessionMetadataTaskType = "cli" ) -// Connection class owning a client task. -// Experimental: TaskClientOwnerKind is part of an experimental API and may change or be +// Per-session remote mode. "off" disables remote, "export" exports session events to GitHub +// without enabling remote steering, "on" enables both export and remote steering. +// Experimental: RemoteSessionMode is part of an experimental API and may change or be // removed. -type TaskClientOwnerKind string +type RemoteSessionMode string const ( - // A discovered extension connection owns the task. - TaskClientOwnerKindExtension TaskClientOwnerKind = "extension" - // A generic SDK connection owns the task. - TaskClientOwnerKindSDK TaskClientOwnerKind = "sdk" + // Export session events to GitHub without enabling remote steering. + RemoteSessionModeExport RemoteSessionMode = "export" + // Disable remote session export and steering. + RemoteSessionModeOff RemoteSessionMode = "off" + // Enable both remote session export and remote steering. + RemoteSessionModeOn RemoteSessionMode = "on" ) -// Presence of the task's bound join. -// Experimental: TaskClientOwnerPresence is part of an experimental API and may change or be -// removed. -type TaskClientOwnerPresence string +// Output format discriminator. Currently only json_schema is supported. +type ResponseFormatType string const ( - // The bound session join is connected. - TaskClientOwnerPresenceConnected TaskClientOwnerPresence = "connected" - // The bound session join is disconnected. - TaskClientOwnerPresenceDisconnected TaskClientOwnerPresence = "disconnected" + ResponseFormatTypeJSONSchema ResponseFormatType = "json_schema" ) -// Lifecycle status of a client-owned task. -// Experimental: TaskClientStatus is part of an experimental API and may change or be +// Origin of the sandbox choice supplied by an internal client. +// Experimental: SandboxConfigSource is part of an experimental API and may change or be // removed. -type TaskClientStatus string +type SandboxConfigSource string const ( - // The owner reported or confirmed cancellation. - TaskClientStatusCancelled TaskClientStatus = "cancelled" - // The owner reported successful completion. - TaskClientStatusCompleted TaskClientStatus = "completed" - // The owner reported failure. - TaskClientStatusFailed TaskClientStatus = "failed" - // The external owner is connected but waiting. - TaskClientStatusIdle TaskClientStatus = "idle" - // The bound owner join disappeared; external executor state is unknown. - TaskClientStatusOrphaned TaskClientStatus = "orphaned" - // The external owner is actively working. - TaskClientStatusRunning TaskClientStatus = "running" + // The client applied the default because no sandbox preference was configured. + SandboxConfigSourceNeverConfigured SandboxConfigSource = "never_configured" + // A repository policy selected the sandbox state. + SandboxConfigSourceRepositoryPolicy SandboxConfigSource = "repository_policy" + // The user disabled the sandbox for the current session. + SandboxConfigSourceSessionDisabled SandboxConfigSource = "session_disabled" + // A command-line flag selected the sandbox state for this session. + SandboxConfigSourceSessionFlag SandboxConfigSource = "session_flag" + // The client disabled the sandbox because the host cannot enforce it. + SandboxConfigSourceUnsupportedHost SandboxConfigSource = "unsupported_host" + // The user's persisted settings disabled the sandbox. + SandboxConfigSourceUserDisabled SandboxConfigSource = "user_disabled" + // The user's persisted settings enabled the sandbox. + SandboxConfigSourceUserEnabled SandboxConfigSource = "user_enabled" ) -// Discriminator for a client-owned task. -// Experimental: TaskClientType is part of an experimental API and may change or be removed. -type TaskClientType string +// A session-scoped sandbox transition applied while handling a slash command +// Experimental: SandboxSessionChange is part of an experimental API and may change or be +// removed. +type SandboxSessionChange string const ( - TaskClientTypeClient TaskClientType = "client" + // The sandbox is off for the rest of this session; nothing was persisted and a new session + // starts from managed policy. + SandboxSessionChangeDisabled SandboxSessionChange = "disabled" + // A previous session-scoped opt-out was cleared and the sandbox is enforced again. + SandboxSessionChangeRestored SandboxSessionChange = "restored" ) -// Kind discriminator for TaskClientUpdate. -type TaskClientUpdateKind string +// The UI mode the agent was in when this message was sent. Defaults to the session's +// current mode. +// Experimental: SendAgentMode is part of an experimental API and may change or be removed. +type SendAgentMode string const ( - TaskClientUpdateKindCancelled TaskClientUpdateKind = "cancelled" - TaskClientUpdateKindCompleted TaskClientUpdateKind = "completed" - TaskClientUpdateKindFailed TaskClientUpdateKind = "failed" - TaskClientUpdateKindProgress TaskClientUpdateKind = "progress" + // The agent is working autonomously toward task completion. + SendAgentModeAutopilot SendAgentMode = "autopilot" + // The agent is responding interactively to the user. + SendAgentModeInteractive SendAgentMode = "interactive" + // The agent is preparing a plan before making changes. + SendAgentModePlan SendAgentMode = "plan" + // The agent is in shell-focused UI mode. + SendAgentModeShell SendAgentMode = "shell" ) -// Semantic result of evaluating a task completion request -// Experimental: TaskCompletionOutcome is part of an experimental API and may change or be -// removed. -type TaskCompletionOutcome string +// How to deliver the message. `enqueue` (default) appends to the message queue. `immediate` +// interjects during an in-progress turn. +// Experimental: SendMode is part of an experimental API and may change or be removed. +type SendMode string const ( - // Completion cannot proceed without intervention; the active objective is paused when one - // is identified. - TaskCompletionOutcomeBlocked TaskCompletionOutcome = "blocked" - // The completion request was accepted and the objective is complete. - TaskCompletionOutcomeCompleted TaskCompletionOutcome = "completed" - // The completion request was rejected because more work or validation remains. - TaskCompletionOutcomeContinue TaskCompletionOutcome = "continue" + // Append the message to the normal session queue. + SendModeEnqueue SendMode = "enqueue" + // Interject the message during the in-progress turn. + SendModeImmediate SendMode = "immediate" ) -// Whether task execution is synchronously awaited or managed in the background -// Experimental: TaskExecutionMode is part of an experimental API and may change or be +// Session capability enabled for this session +// Experimental: SessionCapability is part of an experimental API and may change or be // removed. -type TaskExecutionMode string +type SessionCapability string const ( - // The task is managed in the background. - TaskExecutionModeBackground TaskExecutionMode = "background" - // The task was started with synchronous waiting. - TaskExecutionModeSync TaskExecutionMode = "sync" + // Interactive ask_user tool support. + SessionCapabilityAskUser SessionCapability = "ask-user" + // Host-provided canvas rendering support. + SessionCapabilityCanvasRenderer SessionCapability = "canvas-renderer" + // Copilot CLI documentation tool and prompt section. + SessionCapabilityCLIDocumentation SessionCapability = "cli-documentation" + // SDK elicitation support. + SessionCapabilityElicitation SessionCapability = "elicitation" + // Interactive CLI identity and behavior. + SessionCapabilityInteractiveMode SessionCapability = "interactive-mode" + // MCP Apps UI passthrough. + SessionCapabilityMCPApps SessionCapability = "mcp-apps" + // Memory tool and memories prompt section. + SessionCapabilityMemory SessionCapability = "memory" + // Plan-mode handling and instructions. + SessionCapabilityPlanMode SessionCapability = "plan-mode" + // Cross-session history tools and session-store SQL prompt/tool metadata. + SessionCapabilitySessionStore SessionCapability = "session-store" + // Automatic hidden system notifications. + SessionCapabilitySystemNotifications SessionCapability = "system-notifications" + // TUI-specific prompt hints such as keyboard shortcuts. + SessionCapabilityTuiHints SessionCapability = "tui-hints" ) -// Type discriminator for TaskInfo. -type TaskInfoType string +// Repository host type +// Experimental: SessionContextHostType is part of an experimental API and may change or be +// removed. +type SessionContextHostType string const ( - TaskInfoTypeAgent TaskInfoType = "agent" - TaskInfoTypeClient TaskInfoType = "client" - TaskInfoTypeShell TaskInfoType = "shell" + // Session repository is hosted on Azure DevOps. + SessionContextHostTypeADO SessionContextHostType = "ado" + // Session repository is hosted on GitHub. + SessionContextHostTypeGitHub SessionContextHostType = "github" ) -// Closed set of public task kinds a connection can negotiate. -// Experimental: TaskKind is part of an experimental API and may change or be removed. -type TaskKind string +// Error classification +// Experimental: SessionFSErrorCode is part of an experimental API and may change or be +// removed. +type SessionFSErrorCode string const ( - // Runtime-owned background agent task. - TaskKindAgent TaskKind = "agent" - // Client-owned externally executed task. - TaskKindClient TaskKind = "client" - // Runtime-owned shell task. - TaskKindShell TaskKind = "shell" + // The requested path does not exist. + SessionFSErrorCodeENOENT SessionFSErrorCode = "ENOENT" + // The filesystem operation failed for an unspecified reason. + SessionFSErrorCodeUNKNOWN SessionFSErrorCode = "UNKNOWN" ) -// Type discriminator for TaskProgress. -type TaskProgressType string +// Entry type +// Experimental: SessionFSReaddirWithTypesEntryType is part of an experimental API and may +// change or be removed. +type SessionFSReaddirWithTypesEntryType string const ( - TaskProgressTypeAgent TaskProgressType = "agent" - TaskProgressTypeClient TaskProgressType = "client" - TaskProgressTypeShell TaskProgressType = "shell" + // The entry is a directory. + SessionFSReaddirWithTypesEntryTypeDirectory SessionFSReaddirWithTypesEntryType = "directory" + // The entry is a file. + SessionFSReaddirWithTypesEntryTypeFile SessionFSReaddirWithTypesEntryType = "file" ) -// Whether the shell runs inside a managed PTY session or as an independent background -// process -// Experimental: TaskShellInfoAttachmentMode is part of an experimental API and may change -// or be removed. -type TaskShellInfoAttachmentMode string +// Path conventions used by this filesystem +// Experimental: SessionFSSetProviderConventions is part of an experimental API and may +// change or be removed. +type SessionFSSetProviderConventions string const ( - // The shell runs in a managed PTY session. - TaskShellInfoAttachmentModeAttached TaskShellInfoAttachmentMode = "attached" - // The shell runs as an independent background process. - TaskShellInfoAttachmentModeDetached TaskShellInfoAttachmentMode = "detached" + // Paths use POSIX path conventions. + SessionFSSetProviderConventionsPosix SessionFSSetProviderConventions = "posix" + // Paths use Windows path conventions. + SessionFSSetProviderConventionsWindows SessionFSSetProviderConventions = "windows" ) -// Current lifecycle status of the task -// Experimental: TaskStatus is part of an experimental API and may change or be removed. -type TaskStatus string +// How to execute the query: 'exec' for DDL/multi-statement (no results), 'query' for SELECT +// (returns rows), 'run' for INSERT/UPDATE/DELETE (returns rowsAffected) +// Experimental: SessionFSSqliteQueryType is part of an experimental API and may change or +// be removed. +type SessionFSSqliteQueryType string const ( - // The task was cancelled before completion. - TaskStatusCancelled TaskStatus = "cancelled" - // The task finished successfully. - TaskStatusCompleted TaskStatus = "completed" - // The task finished with an error. - TaskStatusFailed TaskStatus = "failed" - // The task is waiting for additional input. - TaskStatusIdle TaskStatus = "idle" - // The task is actively executing. - TaskStatusRunning TaskStatus = "running" + // Execute DDL or multi-statement SQL without returning rows. + SessionFSSqliteQueryTypeExec SessionFSSqliteQueryType = "exec" + // Execute a SELECT-style query and return rows. + SessionFSSqliteQueryTypeQuery SessionFSSqliteQueryType = "query" + // Execute INSERT, UPDATE, or DELETE SQL and return affected-row metadata. + SessionFSSqliteQueryTypeRun SessionFSSqliteQueryType = "run" ) -// Execution outcome classification. -// Experimental: ToolResultType is part of an experimental API and may change or be removed. -type ToolResultType string +// SQLite transaction failure classification. +// Experimental: SessionFSSqliteTransactionErrorClass is part of an experimental API and may +// change or be removed. +type SessionFSSqliteTransactionErrorClass string const ( - // Permission policy denied the tool request. - ToolResultTypeDenied ToolResultType = "denied" - // The tool failed. - ToolResultTypeFailure ToolResultType = "failure" - // The tool request was rejected before execution. - ToolResultTypeRejected ToolResultType = "rejected" - // The tool completed successfully. - ToolResultTypeSuccess ToolResultType = "success" - // The tool exceeded its execution timeout. - ToolResultTypeTimeout ToolResultType = "timeout" + // SQLite reported BUSY or LOCKED before commit; the transaction was rolled back and may be + // retried. + SessionFSSqliteTransactionErrorClassBusyOrLocked SessionFSSqliteTransactionErrorClass = "busyOrLocked" + // The statement, database, or provider failed definitively and must not be retried + // automatically. + SessionFSSqliteTransactionErrorClassFatal SessionFSSqliteTransactionErrorClass = "fatal" + // The transport failed after the provider may have committed; retrying could duplicate + // effects. + SessionFSSqliteTransactionErrorClassPostCommitAmbiguous SessionFSSqliteTransactionErrorClass = "postCommitAmbiguous" ) -// User's choice for auto-mode switching: yes (allow this turn), yes_always (allow + persist -// as setting), or no (decline). -// Experimental: UIAutoModeSwitchResponse is part of an experimental API and may change or -// be removed. -type UIAutoModeSwitchResponse string +// What initiated this compaction request, recorded as the `trigger` on the persisted +// `session.compaction_start` / `session.compaction_complete` events. When absent, the +// compaction is persisted without trigger attribution (initiator unknown). +type SessionHistoryCompactRequestTrigger string const ( - // Decline the automatic mode switch. - UIAutoModeSwitchResponseNo UIAutoModeSwitchResponse = "no" - // Allow the automatic mode switch for this turn. - UIAutoModeSwitchResponseYes UIAutoModeSwitchResponse = "yes" - // Allow this mode switch and persist the preference. - UIAutoModeSwitchResponseYesAlways UIAutoModeSwitchResponse = "yes_always" + // User-requested compaction, e.g. the /compact command or a direct history.compact call. + SessionHistoryCompactRequestTriggerManual SessionHistoryCompactRequestTrigger = "manual" + // Compaction requested while switching to a model with a smaller context window. + SessionHistoryCompactRequestTriggerModelSwitch SessionHistoryCompactRequestTrigger = "model_switch" ) -// Type discriminator. Always "string". -type UIElicitationArrayEnumFieldItemsType string +// Constant value. Always "github". +type SessionInstalledPluginSourceGitHubSource string const ( - UIElicitationArrayEnumFieldItemsTypeString UIElicitationArrayEnumFieldItemsType = "string" + SessionInstalledPluginSourceGitHubSourceGitHub SessionInstalledPluginSourceGitHubSource = "github" ) -// The user's response: accept (submitted), decline (rejected), or cancel (dismissed) -// Experimental: UIElicitationResponseAction is part of an experimental API and may change -// or be removed. -type UIElicitationResponseAction string +// Constant value. Always "local". +type SessionInstalledPluginSourceLocalSource string const ( - // The user submitted the requested form values. - UIElicitationResponseActionAccept UIElicitationResponseAction = "accept" - // The user dismissed the elicitation request. - UIElicitationResponseActionCancel UIElicitationResponseAction = "cancel" - // The user explicitly declined to provide the requested input. - UIElicitationResponseActionDecline UIElicitationResponseAction = "decline" + SessionInstalledPluginSourceLocalSourceLocal SessionInstalledPluginSourceLocalSource = "local" ) -// Numeric type accepted by the field. -// Experimental: UIElicitationSchemaPropertyNumberType is part of an experimental API and -// may change or be removed. -type UIElicitationSchemaPropertyNumberType string +// Constant value. Always "url". +type SessionInstalledPluginSourceURLSource string const ( - // Integer JSON number. - UIElicitationSchemaPropertyNumberTypeInteger UIElicitationSchemaPropertyNumberType = "integer" - // Any JSON number. - UIElicitationSchemaPropertyNumberTypeNumber UIElicitationSchemaPropertyNumberType = "number" + SessionInstalledPluginSourceURLSourceURL SessionInstalledPluginSourceURLSource = "url" ) -// Optional format hint that constrains the accepted input. -// Experimental: UIElicitationSchemaPropertyStringFormat is part of an experimental API and -// may change or be removed. -type UIElicitationSchemaPropertyStringFormat string +// Client population used for the prediction baseline. +// Experimental: SessionLimitPredictionClientType is part of an experimental API and may +// change or be removed. +type SessionLimitPredictionClientType string const ( - // Calendar date string format. - UIElicitationSchemaPropertyStringFormatDate UIElicitationSchemaPropertyStringFormat = "date" - // Date-time string format. - UIElicitationSchemaPropertyStringFormatDateTime UIElicitationSchemaPropertyStringFormat = "date-time" - // Email address string format. - UIElicitationSchemaPropertyStringFormatEmail UIElicitationSchemaPropertyStringFormat = "email" - // URI string format. - UIElicitationSchemaPropertyStringFormatURI UIElicitationSchemaPropertyStringFormat = "uri" + // Interactive CLI sessions where a user can accept, edit, or top up the limit. + SessionLimitPredictionClientTypeCLIInteractive SessionLimitPredictionClientType = "cli-interactive" + // Prompt/non-interactive CLI sessions where the initial limit must cover more of the run. + SessionLimitPredictionClientTypeCLIPrompt SessionLimitPredictionClientType = "cli-prompt" ) -// Type discriminator for UIElicitationSchemaProperty. -type UIElicitationSchemaPropertyType string +// Kind discriminator for SessionLimitPredictionResult. +type SessionLimitPredictionResultKind string const ( - UIElicitationSchemaPropertyTypeArray UIElicitationSchemaPropertyType = "array" - UIElicitationSchemaPropertyTypeBoolean UIElicitationSchemaPropertyType = "boolean" - UIElicitationSchemaPropertyTypeInteger UIElicitationSchemaPropertyType = "integer" - UIElicitationSchemaPropertyTypeNumber UIElicitationSchemaPropertyType = "number" - UIElicitationSchemaPropertyTypeString UIElicitationSchemaPropertyType = "string" + SessionLimitPredictionResultKindAvailable SessionLimitPredictionResultKind = "available" + SessionLimitPredictionResultKindUnavailable SessionLimitPredictionResultKind = "unavailable" ) -// Schema type indicator (always 'object') -type UIElicitationSchemaType string +// Baseline fallback level used to create the prediction. +// Experimental: SessionLimitPredictionSource is part of an experimental API and may change +// or be removed. +type SessionLimitPredictionSource string const ( - UIElicitationSchemaTypeObject UIElicitationSchemaType = "object" + // The exact model was unavailable, so the prediction used the model family's baseline cell. + SessionLimitPredictionSourceFamily SessionLimitPredictionSource = "family" + // No model or family cell was available, so the prediction used the global client-type + // baseline cell. + SessionLimitPredictionSourceGlobal SessionLimitPredictionSource = "global" + // The prediction used the exact resolved model's baseline cell. + SessionLimitPredictionSourceModel SessionLimitPredictionSource = "model" ) -// The action the user selected. Defaults to 'autopilot' when autoApproveEdits is true, -// otherwise 'interactive'. -// Experimental: UIExitPlanModeAction is part of an experimental API and may change or be -// removed. -type UIExitPlanModeAction string +// Semantic usage tier used for a recommended cap or additional headroom. +// Experimental: SessionLimitPredictionTier is part of an experimental API and may change or +// be removed. +type SessionLimitPredictionTier string const ( - // Exit plan mode and continue in autopilot mode. - UIExitPlanModeActionAutopilot UIExitPlanModeAction = "autopilot" - // Exit plan mode and continue in autopilot mode with parallel subagent execution. - UIExitPlanModeActionAutopilotFleet UIExitPlanModeAction = "autopilot_fleet" - // Exit plan mode without starting implementation. - UIExitPlanModeActionExitOnly UIExitPlanModeAction = "exit_only" - // Exit plan mode and continue interactively. - UIExitPlanModeActionInteractive UIExitPlanModeAction = "interactive" + // Additional headroom for longer-running sessions. + SessionLimitPredictionTierAdditionalHeadroom SessionLimitPredictionTier = "additional_headroom" + // Generous headroom for unusually high usage. + SessionLimitPredictionTierGenerousHeadroom SessionLimitPredictionTier = "generous_headroom" + // Maximum available headroom tier. + SessionLimitPredictionTierMaximumHeadroom SessionLimitPredictionTier = "maximum_headroom" + // Recommended starting tier. + SessionLimitPredictionTierRecommended SessionLimitPredictionTier = "recommended" ) -// User action selected for an exhausted session limit. -// Experimental: UISessionLimitsExhaustedResponseAction is part of an experimental API and +// Reason a prediction could not be computed. +// Experimental: SessionLimitPredictionUnavailableReason is part of an experimental API and // may change or be removed. -type UISessionLimitsExhaustedResponseAction string +type SessionLimitPredictionUnavailableReason string const ( - // Increase the current max by an exact AI Credits amount. - UISessionLimitsExhaustedResponseActionAdd UISessionLimitsExhaustedResponseAction = "add" - // Leave the limit unchanged and cancel the blocked model request. - UISessionLimitsExhaustedResponseActionCancel UISessionLimitsExhaustedResponseAction = "cancel" - // Set a new absolute max AI Credits value. - UISessionLimitsExhaustedResponseActionSet UISessionLimitsExhaustedResponseAction = "set" - // Remove the current session limit. - UISessionLimitsExhaustedResponseActionUnset UISessionLimitsExhaustedResponseAction = "unset" + // The current model is auto and has not resolved to a concrete model yet. + SessionLimitPredictionUnavailableReasonAutoUnresolved SessionLimitPredictionUnavailableReason = "auto_unresolved" + // No model was provided and the session does not currently have a selected model. + SessionLimitPredictionUnavailableReasonNoModel SessionLimitPredictionUnavailableReason = "no_model" ) -// Kind discriminator for UserToolSessionApproval. -type UserToolSessionApprovalKind string +// Log severity level. Determines how the message is displayed in the timeline. Defaults to +// "info". +// Experimental: SessionLogLevel is part of an experimental API and may change or be removed. +type SessionLogLevel string const ( - UserToolSessionApprovalKindCommands UserToolSessionApprovalKind = "commands" - UserToolSessionApprovalKindCustomTool UserToolSessionApprovalKind = "custom-tool" - UserToolSessionApprovalKindExtensionEnvAccess UserToolSessionApprovalKind = "extension-env-access" - UserToolSessionApprovalKindExtensionManagement UserToolSessionApprovalKind = "extension-management" - UserToolSessionApprovalKindExtensionPermissionAccess UserToolSessionApprovalKind = "extension-permission-access" - UserToolSessionApprovalKindFactory UserToolSessionApprovalKind = "factory" - UserToolSessionApprovalKindMCP UserToolSessionApprovalKind = "mcp" - UserToolSessionApprovalKindMemory UserToolSessionApprovalKind = "memory" - UserToolSessionApprovalKindRead UserToolSessionApprovalKind = "read" - UserToolSessionApprovalKindWrite UserToolSessionApprovalKind = "write" + // Error message describing a failure. + SessionLogLevelError SessionLogLevel = "error" + // Informational message. + SessionLogLevelInfo SessionLogLevel = "info" + // Warning message that may require attention. + SessionLogLevelWarning SessionLogLevel = "warning" ) -// Output verbosity level for supported models -// Experimental: Verbosity is part of an experimental API and may change or be removed. -type Verbosity string +// The session mode the agent is operating in +// Experimental: SessionMode is part of an experimental API and may change or be removed. +type SessionMode string const ( - // Request a more detailed response. - VerbosityHigh Verbosity = "high" - // Request a terse response. - VerbosityLow Verbosity = "low" - // Request a medium amount of response detail. - VerbosityMedium Verbosity = "medium" + // The agent is working autonomously toward task completion. + SessionModeAutopilot SessionMode = "autopilot" + // The agent is responding interactively to the user. + SessionModeInteractive SessionMode = "interactive" + // The agent is preparing a plan before making changes. + SessionModePlan SessionMode = "plan" ) -// Type of change represented by this file diff. -// Experimental: WorkspaceDiffFileChangeType is part of an experimental API and may change -// or be removed. -type WorkspaceDiffFileChangeType string +// Allowed values for the `SessionOpenOptionsAdditionalContentExclusionPolicyScope` +// enumeration. +// Experimental: SessionOpenOptionsAdditionalContentExclusionPolicyScope is part of an +// experimental API and may change or be removed. +type SessionOpenOptionsAdditionalContentExclusionPolicyScope string const ( - // The file was added. - WorkspaceDiffFileChangeTypeAdded WorkspaceDiffFileChangeType = "added" - // The file was deleted. - WorkspaceDiffFileChangeTypeDeleted WorkspaceDiffFileChangeType = "deleted" - // The file was modified. - WorkspaceDiffFileChangeTypeModified WorkspaceDiffFileChangeType = "modified" - // The file was renamed. - WorkspaceDiffFileChangeTypeRenamed WorkspaceDiffFileChangeType = "renamed" + // The content exclusion policy applies across all repositories. + SessionOpenOptionsAdditionalContentExclusionPolicyScopeAll SessionOpenOptionsAdditionalContentExclusionPolicyScope = "all" + // The content exclusion policy applies to the current repository. + SessionOpenOptionsAdditionalContentExclusionPolicyScopeRepo SessionOpenOptionsAdditionalContentExclusionPolicyScope = "repo" ) -// Diff mode requested by the client. -// Experimental: WorkspaceDiffMode is part of an experimental API and may change or be +// How MCP server environment values are interpreted. +// Experimental: SessionOpenOptionsEnvValueMode is part of an experimental API and may +// change or be removed. +type SessionOpenOptionsEnvValueMode string + +const ( + // Pass MCP server environment values as literal strings. + SessionOpenOptionsEnvValueModeDirect SessionOpenOptionsEnvValueMode = "direct" + // Resolve MCP server environment values from host-side references. + SessionOpenOptionsEnvValueModeIndirect SessionOpenOptionsEnvValueMode = "indirect" +) + +// Initial reasoning summary mode for supported model clients. +// Experimental: SessionOpenOptionsReasoningSummary is part of an experimental API and may +// change or be removed. +type SessionOpenOptionsReasoningSummary string + +const ( + // Request a concise summary of model reasoning. + SessionOpenOptionsReasoningSummaryConcise SessionOpenOptionsReasoningSummary = "concise" + // Request a detailed summary of model reasoning. + SessionOpenOptionsReasoningSummaryDetailed SessionOpenOptionsReasoningSummary = "detailed" + // Do not request reasoning summaries from the model. + SessionOpenOptionsReasoningSummaryNone SessionOpenOptionsReasoningSummary = "none" +) + +// Kind discriminator for SessionOpenParams. +type SessionOpenParamsKind string + +const ( + SessionOpenParamsKindAttach SessionOpenParamsKind = "attach" + SessionOpenParamsKindCloud SessionOpenParamsKind = "cloud" + SessionOpenParamsKindCreate SessionOpenParamsKind = "create" + SessionOpenParamsKindHandoff SessionOpenParamsKind = "handoff" + SessionOpenParamsKindRemote SessionOpenParamsKind = "remote" + SessionOpenParamsKindResume SessionOpenParamsKind = "resume" + SessionOpenParamsKindResumeLast SessionOpenParamsKind = "resumeLast" +) + +// Status discriminator for SessionsClientMetadataEntry. +type SessionsClientMetadataEntryStatus string + +const ( + SessionsClientMetadataEntryStatusCorrupt SessionsClientMetadataEntryStatus = "corrupt" + SessionsClientMetadataEntryStatusNotFound SessionsClientMetadataEntryStatus = "notFound" + SessionsClientMetadataEntryStatusOk SessionsClientMetadataEntryStatus = "ok" + SessionsClientMetadataEntryStatusUnavailable SessionsClientMetadataEntryStatus = "unavailable" + SessionsClientMetadataEntryStatusUnsupportedVersion SessionsClientMetadataEntryStatus = "unsupportedVersion" +) + +// Rust-owned settings predicates exposed across the SDK boundary. Raw feature-flag names +// are intentionally not part of the contract. +// Experimental: SessionSettingsPredicateName is part of an experimental API and may change +// or be removed. +type SessionSettingsPredicateName string + +const ( + // Whether Claude Opus token-limit caps should be applied. + SessionSettingsPredicateNameCapClaudeOpusTokenLimitsEnabled SessionSettingsPredicateName = "capClaudeOpusTokenLimitsEnabled" + // Whether CCA should use the TypeScript autofind behavior. + SessionSettingsPredicateNameCcaUseTsAutofindEnabled SessionSettingsPredicateName = "ccaUseTsAutofindEnabled" + // Whether Chronicle integration is enabled. + SessionSettingsPredicateNameChronicleEnabled SessionSettingsPredicateName = "chronicleEnabled" + // Whether the co-author hook is enabled. + SessionSettingsPredicateNameCoAuthorHookEnabled SessionSettingsPredicateName = "coAuthorHookEnabled" + // Whether the CodeQL checker is enabled. + SessionSettingsPredicateNameCodeqlCheckerEnabled SessionSettingsPredicateName = "codeqlCheckerEnabled" + // Whether code-review behavior is enabled. + SessionSettingsPredicateNameCodeReviewFeatureEnabled SessionSettingsPredicateName = "codeReviewFeatureEnabled" + // Whether content-exclusion policy may self-fetch data. + SessionSettingsPredicateNameContentExclusionSelfFetchEnabled SessionSettingsPredicateName = "contentExclusionSelfFetchEnabled" + // Whether the Dependabot checker is enabled. + SessionSettingsPredicateNameDependabotCheckerEnabled SessionSettingsPredicateName = "dependabotCheckerEnabled" + // Whether the dependency checker is enabled. + SessionSettingsPredicateNameDependencyCheckerEnabled SessionSettingsPredicateName = "dependencyCheckerEnabled" + // Whether validation may run in parallel. + SessionSettingsPredicateNameParallelValidationEnabled SessionSettingsPredicateName = "parallelValidationEnabled" + // Whether runtime timing telemetry is enabled. + SessionSettingsPredicateNameRuntimeTimingTelemetryEnabled SessionSettingsPredicateName = "runtimeTimingTelemetryEnabled" + // Whether the security-tools feature flag enables security tool wiring. + SessionSettingsPredicateNameSecurityToolsEnabled SessionSettingsPredicateName = "securityToolsEnabled" + // Whether third-party security tools should receive the security prompt. + SessionSettingsPredicateNameThirdPartySecurityPromptEnabled SessionSettingsPredicateName = "thirdPartySecurityPromptEnabled" + // Whether trivial-change handling is enabled. + SessionSettingsPredicateNameTrivialChangeEnabled SessionSettingsPredicateName = "trivialChangeEnabled" + // Whether trivial-change handling is enabled for code review. + SessionSettingsPredicateNameTrivialChangeEnabledForCodeReview SessionSettingsPredicateName = "trivialChangeEnabledForCodeReview" + // Whether trivial-change handling is enabled for a specific tool. + SessionSettingsPredicateNameTrivialChangeEnabledForTool SessionSettingsPredicateName = "trivialChangeEnabledForTool" + // Whether trivial-change skip behavior is enabled. + SessionSettingsPredicateNameTrivialChangeSkipEnabled SessionSettingsPredicateName = "trivialChangeSkipEnabled" + // Whether trivial-change skip behavior is enabled for code review. + SessionSettingsPredicateNameTrivialChangeSkipEnabledForCodeReview SessionSettingsPredicateName = "trivialChangeSkipEnabledForCodeReview" + // Whether trivial-change skip behavior is enabled for a specific tool. + SessionSettingsPredicateNameTrivialChangeSkipEnabledForTool SessionSettingsPredicateName = "trivialChangeSkipEnabledForTool" +) + +// Task type determines the handoff strategy (CCA fetches events; CLI prepares a transient +// session). +// Experimental: SessionsOpenHandoffTaskType is part of an experimental API and may change +// or be removed. +type SessionsOpenHandoffTaskType string + +const ( + // GitHub Copilot coding agent task. + SessionsOpenHandoffTaskTypeCca SessionsOpenHandoffTaskType = "cca" + // CLI remote task. + SessionsOpenHandoffTaskTypeCLI SessionsOpenHandoffTaskType = "cli" +) + +// Step status. +// Experimental: SessionsOpenProgressStatus is part of an experimental API and may change or +// be removed. +type SessionsOpenProgressStatus string + +const ( + // The step has completed successfully. + SessionsOpenProgressStatusComplete SessionsOpenProgressStatus = "complete" + // The step has started and has not yet finished. + SessionsOpenProgressStatusInProgress SessionsOpenProgressStatus = "in-progress" +) + +// Handoff step. +// Experimental: SessionsOpenProgressStep is part of an experimental API and may change or +// be removed. +type SessionsOpenProgressStep string + +const ( + // Checking the local working tree for uncommitted changes that would block the handoff. + SessionsOpenProgressStepCheckChanges SessionsOpenProgressStep = "check-changes" + // Checking out the branch associated with the remote session in the local working tree. + SessionsOpenProgressStepCheckoutBranch SessionsOpenProgressStep = "checkout-branch" + // Creating the new local session and seeding it with the source session's events. + SessionsOpenProgressStepCreateSession SessionsOpenProgressStep = "create-session" + // Loading the source session's events from the remote service. + SessionsOpenProgressStepLoadSession SessionsOpenProgressStep = "load-session" + // Persisting the newly-created local session to disk. + SessionsOpenProgressStepSaveSession SessionsOpenProgressStep = "save-session" + // Validating that the local repository matches the remote session's repository. + SessionsOpenProgressStepValidateRepo SessionsOpenProgressStep = "validate-repo" +) + +// Outcome of the open request. +// Experimental: SessionsOpenStatus is part of an experimental API and may change or be +// removed. +type SessionsOpenStatus string + +const ( + // Connected to an existing remote session. + SessionsOpenStatusConnected SessionsOpenStatus = "connected" + // A new session was created. + SessionsOpenStatusCreated SessionsOpenStatus = "created" + // Remote session was handed off to a new local session. + SessionsOpenStatusHandedOff SessionsOpenStatus = "handed_off" + // No matching persisted session was found. + SessionsOpenStatusNotFound SessionsOpenStatus = "not_found" + // An existing session was loaded or reattached. + SessionsOpenStatusResumed SessionsOpenStatus = "resumed" +) + +// Which session sources to include. Defaults to `local` for backward compatibility. +// Experimental: SessionSource is part of an experimental API and may change or be removed. +type SessionSource string + +const ( + // Return both local and remote sessions. + SessionSourceAll SessionSource = "all" + // Return only local sessions. + SessionSourceLocal SessionSource = "local" + // Return only remote sessions. + SessionSourceRemote SessionSource = "remote" +) + +// Sharing status for a synced session. "repo" makes the session visible to anyone with read +// access to the repository; "unshared" restricts it to the creator and collaborators. +// Experimental: SessionVisibilityStatus is part of an experimental API and may change or be +// removed. +type SessionVisibilityStatus string + +const ( + // The session is visible to repository readers. + SessionVisibilityStatusRepo SessionVisibilityStatus = "repo" + // The session is restricted to its creator and collaborators. + SessionVisibilityStatusUnshared SessionVisibilityStatus = "unshared" +) + +// Hosting platform type of the repository +// Experimental: SessionWorkingDirectoryContextHostType is part of an experimental API and +// may change or be removed. +type SessionWorkingDirectoryContextHostType string + +const ( + // The working directory repository is hosted on Azure DevOps. + SessionWorkingDirectoryContextHostTypeADO SessionWorkingDirectoryContextHostType = "ado" + // The working directory repository is hosted on GitHub. + SessionWorkingDirectoryContextHostTypeGitHub SessionWorkingDirectoryContextHostType = "github" +) + +// Type discriminator for SettableAuthInfo. +type SettableAuthInfoType string + +const ( + SettableAuthInfoTypeAPIKey SettableAuthInfoType = "api-key" + SettableAuthInfoTypeCopilotAPIToken SettableAuthInfoType = "copilot-api-token" + SettableAuthInfoTypeEnv SettableAuthInfoType = "env" + SettableAuthInfoTypeGhCLI SettableAuthInfoType = "gh-cli" + SettableAuthInfoTypeHMAC SettableAuthInfoType = "hmac" + SettableAuthInfoTypeToken SettableAuthInfoType = "token" + SettableAuthInfoTypeUser SettableAuthInfoType = "user" +) + +// Controls automatic non-interactive profile loading where supported. Explicit initScripts +// are unaffected. +// Experimental: ShellInitProfile is part of an experimental API and may change or be +// removed. +type ShellInitProfile string + +const ( + // Disable automatic non-interactive profile loading. Explicit initScripts still run. + ShellInitProfileNone ShellInitProfile = "none" + // Allow automatic non-interactive profile loading when supported. Explicit initScripts + // still run. + ShellInitProfileNonInteractive ShellInitProfile = "non-interactive" +) + +// Supported built-in shells for initialization scripts. +// Experimental: ShellInitScriptShell is part of an experimental API and may change or be +// removed. +type ShellInitScriptShell string + +const ( + // Source the script in the built-in Bash shell on macOS and Linux. + ShellInitScriptShellBash ShellInitScriptShell = "bash" + // Source the script in the built-in PowerShell shell on Windows. + ShellInitScriptShellPowershell ShellInitScriptShell = "powershell" +) + +// Signal to send (default: SIGTERM) +// Experimental: ShellKillSignal is part of an experimental API and may change or be removed. +type ShellKillSignal string + +const ( + // Send an interrupt signal to the process. + ShellKillSignalSIGINT ShellKillSignal = "SIGINT" + // Forcefully terminate the process. + ShellKillSignalSIGKILL ShellKillSignal = "SIGKILL" + // Request graceful process termination. + ShellKillSignalSIGTERM ShellKillSignal = "SIGTERM" +) + +// Why the session is being shut down. Defaults to "routine" when omitted. +// Experimental: ShutdownType is part of an experimental API and may change or be removed. +type ShutdownType string + +const ( + // The session is shutting down because of an error. + ShutdownTypeError ShutdownType = "error" + // The session is shutting down normally. + ShutdownTypeRoutine ShutdownType = "routine" +) + +// Which tier this directory belongs to +// Experimental: SkillDiscoveryScope is part of an experimental API and may change or be +// removed. +type SkillDiscoveryScope string + +const ( + // A configured custom skill directory. + SkillDiscoveryScopeCustom SkillDiscoveryScope = "custom" + // The user's personal agents skill directory. + SkillDiscoveryScopePersonalAgents SkillDiscoveryScope = "personal-agents" + // The user's personal Copilot skill directory. + SkillDiscoveryScopePersonalCopilot SkillDiscoveryScope = "personal-copilot" + // A project's repository skill directory. + SkillDiscoveryScopeProject SkillDiscoveryScope = "project" +) + +// Source location type (e.g., project, personal-copilot, plugin, builtin, sdk) +// Experimental: SkillSource is part of an experimental API and may change or be removed. +type SkillSource string + +const ( + // Skill bundled with the runtime. + SkillSourceBuiltin SkillSource = "builtin" + // Skill loaded from a configured custom skill directory. + SkillSourceCustom SkillSource = "custom" + // Skill discovered from a parent directory in the current workspace tree. + SkillSourceInherited SkillSource = "inherited" + // Skill defined in the user's personal agents skill directory. + SkillSourcePersonalAgents SkillSource = "personal-agents" + // Skill defined in the user's Copilot skill directory. + SkillSourcePersonalCopilot SkillSource = "personal-copilot" + // Skill provided by an installed plugin. + SkillSourcePlugin SkillSource = "plugin" + // Skill defined in the current project's skill directories. + SkillSourceProject SkillSource = "project" + // Pathless skill supplied lazily by an SDK skill provider. + SkillSourceSDK SkillSource = "sdk" +) + +// Optional completion hint for the input (e.g. 'directory' for filesystem path completion) +// Experimental: SlashCommandInputCompletion is part of an experimental API and may change +// or be removed. +type SlashCommandInputCompletion string + +const ( + // Input should complete filesystem directories. + SlashCommandInputCompletionDirectory SlashCommandInputCompletion = "directory" +) + +// Kind discriminator for SlashCommandInvocationResult. +type SlashCommandInvocationResultKind string + +const ( + SlashCommandInvocationResultKindAddTimelineEntry SlashCommandInvocationResultKind = "add-timeline-entry" + SlashCommandInvocationResultKindAgentPrompt SlashCommandInvocationResultKind = "agent-prompt" + SlashCommandInvocationResultKindCompleted SlashCommandInvocationResultKind = "completed" + SlashCommandInvocationResultKindSelectSubcommand SlashCommandInvocationResultKind = "select-subcommand" + SlashCommandInvocationResultKindSetModel SlashCommandInvocationResultKind = "set-model" + SlashCommandInvocationResultKindSetPlanModel SlashCommandInvocationResultKind = "set-plan-model" + SlashCommandInvocationResultKindShowDialog SlashCommandInvocationResultKind = "show-dialog" + SlashCommandInvocationResultKindText SlashCommandInvocationResultKind = "text" +) + +// Coarse command category for grouping and behavior: runtime built-in, skill-backed +// command, or SDK/client-owned command +// Experimental: SlashCommandKind is part of an experimental API and may change or be +// removed. +type SlashCommandKind string + +const ( + // Command implemented by the runtime. + SlashCommandKindBuiltin SlashCommandKind = "builtin" + // Command registered by an SDK client or extension. + SlashCommandKindClient SlashCommandKind = "client" + // Command backed by a skill. + SlashCommandKindSkill SlashCommandKind = "skill" +) + +// Discriminator for a model-picker dialog. +type SlashCommandModelPickerDialogKind string + +const ( + SlashCommandModelPickerDialogKindModelPicker SlashCommandModelPickerDialogKind = "model-picker" +) + +// Context tier override for matching subagents +// Experimental: SubagentSettingsEntryContextTier is part of an experimental API and may +// change or be removed. +type SubagentSettingsEntryContextTier string + +const ( + // Use the model's default context window. + SubagentSettingsEntryContextTierDefault SubagentSettingsEntryContextTier = "default" + // Inherit the parent session's effective context tier at dispatch time. + SubagentSettingsEntryContextTierInherit SubagentSettingsEntryContextTier = "inherit" + // Pin the subagent to the long-context tier when supported. + SubagentSettingsEntryContextTierLongContext SubagentSettingsEntryContextTier = "long_context" +) + +// Category of structured task blocker +// Experimental: TaskBlockerKind is part of an experimental API and may change or be removed. +type TaskBlockerKind string + +const ( + // Autopilot permission recovery requires intervention or has no safe autonomous path. + TaskBlockerKindPermissionRecovery TaskBlockerKind = "permission_recovery" +) + +// Active status a client owner may publish with a progress update. +// Experimental: TaskClientActiveStatus is part of an experimental API and may change or be +// removed. +type TaskClientActiveStatus string + +const ( + // The external owner is connected but waiting. + TaskClientActiveStatusIdle TaskClientActiveStatus = "idle" + // The external owner is actively working. + TaskClientActiveStatusRunning TaskClientActiveStatus = "running" +) + +// Client-owned tasks always execute outside the runtime in background mode. +// Experimental: TaskClientExecutionMode is part of an experimental API and may change or be +// removed. +type TaskClientExecutionMode string + +const ( + TaskClientExecutionModeBackground TaskClientExecutionMode = "background" +) + +// Connection class owning a client task. +// Experimental: TaskClientOwnerKind is part of an experimental API and may change or be +// removed. +type TaskClientOwnerKind string + +const ( + // A discovered extension connection owns the task. + TaskClientOwnerKindExtension TaskClientOwnerKind = "extension" + // A generic SDK connection owns the task. + TaskClientOwnerKindSDK TaskClientOwnerKind = "sdk" +) + +// Presence of the task's bound join. +// Experimental: TaskClientOwnerPresence is part of an experimental API and may change or be +// removed. +type TaskClientOwnerPresence string + +const ( + // The bound session join is connected. + TaskClientOwnerPresenceConnected TaskClientOwnerPresence = "connected" + // The bound session join is disconnected. + TaskClientOwnerPresenceDisconnected TaskClientOwnerPresence = "disconnected" +) + +// Lifecycle status of a client-owned task. +// Experimental: TaskClientStatus is part of an experimental API and may change or be +// removed. +type TaskClientStatus string + +const ( + // The owner reported or confirmed cancellation. + TaskClientStatusCancelled TaskClientStatus = "cancelled" + // The owner reported successful completion. + TaskClientStatusCompleted TaskClientStatus = "completed" + // The owner reported failure. + TaskClientStatusFailed TaskClientStatus = "failed" + // The external owner is connected but waiting. + TaskClientStatusIdle TaskClientStatus = "idle" + // The bound owner join disappeared; external executor state is unknown. + TaskClientStatusOrphaned TaskClientStatus = "orphaned" + // The external owner is actively working. + TaskClientStatusRunning TaskClientStatus = "running" +) + +// Discriminator for a client-owned task. +// Experimental: TaskClientType is part of an experimental API and may change or be removed. +type TaskClientType string + +const ( + TaskClientTypeClient TaskClientType = "client" +) + +// Kind discriminator for TaskClientUpdate. +type TaskClientUpdateKind string + +const ( + TaskClientUpdateKindCancelled TaskClientUpdateKind = "cancelled" + TaskClientUpdateKindCompleted TaskClientUpdateKind = "completed" + TaskClientUpdateKindFailed TaskClientUpdateKind = "failed" + TaskClientUpdateKindProgress TaskClientUpdateKind = "progress" +) + +// Semantic result of evaluating a task completion request +// Experimental: TaskCompletionOutcome is part of an experimental API and may change or be +// removed. +type TaskCompletionOutcome string + +const ( + // Completion cannot proceed without intervention; the active objective is paused when one + // is identified. + TaskCompletionOutcomeBlocked TaskCompletionOutcome = "blocked" + // The completion request was accepted and the objective is complete. + TaskCompletionOutcomeCompleted TaskCompletionOutcome = "completed" + // The completion request was rejected because more work or validation remains. + TaskCompletionOutcomeContinue TaskCompletionOutcome = "continue" +) + +// Whether task execution is synchronously awaited or managed in the background +// Experimental: TaskExecutionMode is part of an experimental API and may change or be +// removed. +type TaskExecutionMode string + +const ( + // The task is managed in the background. + TaskExecutionModeBackground TaskExecutionMode = "background" + // The task was started with synchronous waiting. + TaskExecutionModeSync TaskExecutionMode = "sync" +) + +// Type discriminator for TaskInfo. +type TaskInfoType string + +const ( + TaskInfoTypeAgent TaskInfoType = "agent" + TaskInfoTypeClient TaskInfoType = "client" + TaskInfoTypeShell TaskInfoType = "shell" +) + +// Closed set of public task kinds a connection can negotiate. +// Experimental: TaskKind is part of an experimental API and may change or be removed. +type TaskKind string + +const ( + // Runtime-owned background agent task. + TaskKindAgent TaskKind = "agent" + // Client-owned externally executed task. + TaskKindClient TaskKind = "client" + // Runtime-owned shell task. + TaskKindShell TaskKind = "shell" +) + +// Type discriminator for TaskProgress. +type TaskProgressType string + +const ( + TaskProgressTypeAgent TaskProgressType = "agent" + TaskProgressTypeClient TaskProgressType = "client" + TaskProgressTypeShell TaskProgressType = "shell" +) + +// Whether the shell runs inside a managed PTY session or as an independent background +// process +// Experimental: TaskShellInfoAttachmentMode is part of an experimental API and may change +// or be removed. +type TaskShellInfoAttachmentMode string + +const ( + // The shell runs in a managed PTY session. + TaskShellInfoAttachmentModeAttached TaskShellInfoAttachmentMode = "attached" + // The shell runs as an independent background process. + TaskShellInfoAttachmentModeDetached TaskShellInfoAttachmentMode = "detached" +) + +// Current lifecycle status of the task +// Experimental: TaskStatus is part of an experimental API and may change or be removed. +type TaskStatus string + +const ( + // The task was cancelled before completion. + TaskStatusCancelled TaskStatus = "cancelled" + // The task finished successfully. + TaskStatusCompleted TaskStatus = "completed" + // The task finished with an error. + TaskStatusFailed TaskStatus = "failed" + // The task is waiting for additional input. + TaskStatusIdle TaskStatus = "idle" + // The task is actively executing. + TaskStatusRunning TaskStatus = "running" +) + +// Execution outcome classification. +// Experimental: ToolResultType is part of an experimental API and may change or be removed. +type ToolResultType string + +const ( + // Permission policy denied the tool request. + ToolResultTypeDenied ToolResultType = "denied" + // The tool failed. + ToolResultTypeFailure ToolResultType = "failure" + // The tool request was rejected before execution. + ToolResultTypeRejected ToolResultType = "rejected" + // The tool completed successfully. + ToolResultTypeSuccess ToolResultType = "success" + // The tool exceeded its execution timeout. + ToolResultTypeTimeout ToolResultType = "timeout" +) + +// User's choice for auto-mode switching: yes (allow this turn), yes_always (allow + persist +// as setting), or no (decline). +// Experimental: UIAutoModeSwitchResponse is part of an experimental API and may change or +// be removed. +type UIAutoModeSwitchResponse string + +const ( + // Decline the automatic mode switch. + UIAutoModeSwitchResponseNo UIAutoModeSwitchResponse = "no" + // Allow the automatic mode switch for this turn. + UIAutoModeSwitchResponseYes UIAutoModeSwitchResponse = "yes" + // Allow this mode switch and persist the preference. + UIAutoModeSwitchResponseYesAlways UIAutoModeSwitchResponse = "yes_always" +) + +// Type discriminator. Always "string". +type UIElicitationArrayEnumFieldItemsType string + +const ( + UIElicitationArrayEnumFieldItemsTypeString UIElicitationArrayEnumFieldItemsType = "string" +) + +// The user's response: accept (submitted), decline (rejected), or cancel (dismissed) +// Experimental: UIElicitationResponseAction is part of an experimental API and may change +// or be removed. +type UIElicitationResponseAction string + +const ( + // The user submitted the requested form values. + UIElicitationResponseActionAccept UIElicitationResponseAction = "accept" + // The user dismissed the elicitation request. + UIElicitationResponseActionCancel UIElicitationResponseAction = "cancel" + // The user explicitly declined to provide the requested input. + UIElicitationResponseActionDecline UIElicitationResponseAction = "decline" +) + +// Numeric type accepted by the field. +// Experimental: UIElicitationSchemaPropertyNumberType is part of an experimental API and +// may change or be removed. +type UIElicitationSchemaPropertyNumberType string + +const ( + // Integer JSON number. + UIElicitationSchemaPropertyNumberTypeInteger UIElicitationSchemaPropertyNumberType = "integer" + // Any JSON number. + UIElicitationSchemaPropertyNumberTypeNumber UIElicitationSchemaPropertyNumberType = "number" +) + +// Optional format hint that constrains the accepted input. +// Experimental: UIElicitationSchemaPropertyStringFormat is part of an experimental API and +// may change or be removed. +type UIElicitationSchemaPropertyStringFormat string + +const ( + // Calendar date string format. + UIElicitationSchemaPropertyStringFormatDate UIElicitationSchemaPropertyStringFormat = "date" + // Date-time string format. + UIElicitationSchemaPropertyStringFormatDateTime UIElicitationSchemaPropertyStringFormat = "date-time" + // Email address string format. + UIElicitationSchemaPropertyStringFormatEmail UIElicitationSchemaPropertyStringFormat = "email" + // URI string format. + UIElicitationSchemaPropertyStringFormatURI UIElicitationSchemaPropertyStringFormat = "uri" +) + +// Type discriminator for UIElicitationSchemaProperty. +type UIElicitationSchemaPropertyType string + +const ( + UIElicitationSchemaPropertyTypeArray UIElicitationSchemaPropertyType = "array" + UIElicitationSchemaPropertyTypeBoolean UIElicitationSchemaPropertyType = "boolean" + UIElicitationSchemaPropertyTypeInteger UIElicitationSchemaPropertyType = "integer" + UIElicitationSchemaPropertyTypeNumber UIElicitationSchemaPropertyType = "number" + UIElicitationSchemaPropertyTypeString UIElicitationSchemaPropertyType = "string" +) + +// Schema type indicator (always 'object') +type UIElicitationSchemaType string + +const ( + UIElicitationSchemaTypeObject UIElicitationSchemaType = "object" +) + +// The action the user selected. Defaults to 'autopilot' when autoApproveEdits is true, +// otherwise 'interactive'. +// Experimental: UIExitPlanModeAction is part of an experimental API and may change or be +// removed. +type UIExitPlanModeAction string + +const ( + // Exit plan mode and continue in autopilot mode. + UIExitPlanModeActionAutopilot UIExitPlanModeAction = "autopilot" + // Exit plan mode and continue in autopilot mode with parallel subagent execution. + UIExitPlanModeActionAutopilotFleet UIExitPlanModeAction = "autopilot_fleet" + // Exit plan mode without starting implementation. + UIExitPlanModeActionExitOnly UIExitPlanModeAction = "exit_only" + // Exit plan mode and continue interactively. + UIExitPlanModeActionInteractive UIExitPlanModeAction = "interactive" +) + +// User action selected for an exhausted session limit. +// Experimental: UISessionLimitsExhaustedResponseAction is part of an experimental API and +// may change or be removed. +type UISessionLimitsExhaustedResponseAction string + +const ( + // Increase the current max by an exact AI Credits amount. + UISessionLimitsExhaustedResponseActionAdd UISessionLimitsExhaustedResponseAction = "add" + // Leave the limit unchanged and cancel the blocked model request. + UISessionLimitsExhaustedResponseActionCancel UISessionLimitsExhaustedResponseAction = "cancel" + // Set a new absolute max AI Credits value. + UISessionLimitsExhaustedResponseActionSet UISessionLimitsExhaustedResponseAction = "set" + // Remove the current session limit. + UISessionLimitsExhaustedResponseActionUnset UISessionLimitsExhaustedResponseAction = "unset" +) + +// Kind discriminator for UserToolSessionApproval. +type UserToolSessionApprovalKind string + +const ( + UserToolSessionApprovalKindCommands UserToolSessionApprovalKind = "commands" + UserToolSessionApprovalKindCustomTool UserToolSessionApprovalKind = "custom-tool" + UserToolSessionApprovalKindExtensionEnvAccess UserToolSessionApprovalKind = "extension-env-access" + UserToolSessionApprovalKindExtensionManagement UserToolSessionApprovalKind = "extension-management" + UserToolSessionApprovalKindExtensionPermissionAccess UserToolSessionApprovalKind = "extension-permission-access" + UserToolSessionApprovalKindFactory UserToolSessionApprovalKind = "factory" + UserToolSessionApprovalKindMCP UserToolSessionApprovalKind = "mcp" + UserToolSessionApprovalKindMemory UserToolSessionApprovalKind = "memory" + UserToolSessionApprovalKindRead UserToolSessionApprovalKind = "read" + UserToolSessionApprovalKindWrite UserToolSessionApprovalKind = "write" +) + +// Output verbosity level for supported models +// Experimental: Verbosity is part of an experimental API and may change or be removed. +type Verbosity string + +const ( + // Request a more detailed response. + VerbosityHigh Verbosity = "high" + // Request a terse response. + VerbosityLow Verbosity = "low" + // Request a medium amount of response detail. + VerbosityMedium Verbosity = "medium" +) + +// Execution-critical workflow storage operation. +// Experimental: WorkflowDurableOperation is part of an experimental API and may change or +// be removed. +type WorkflowDurableOperation string + +const ( + // Persisting active execution time. + WorkflowDurableOperationAddElapsed WorkflowDurableOperation = "addElapsed" + // Persisting an idempotent model-usage charge. + WorkflowDurableOperationChargeCredit WorkflowDurableOperation = "chargeCredit" + // Creating the durable run and declared phases. + WorkflowDurableOperationCreateRun WorkflowDurableOperation = "createRun" + // Persisting the terminal run envelope. + WorkflowDurableOperationFinishRun WorkflowDurableOperation = "finishRun" + // Reading a journal entry without treating storage failure as a cache miss. + WorkflowDurableOperationJournalGet WorkflowDurableOperation = "journalGet" + // Persisting a journal entry before reporting success. + WorkflowDurableOperationJournalPut WorkflowDurableOperation = "journalPut" + // Persisting the transition to running. + WorkflowDurableOperationMarkRunStarted WorkflowDurableOperation = "markRunStarted" + // Reading the authoritative AI-credit total. + WorkflowDurableOperationReconcileCreditTotal WorkflowDurableOperation = "reconcileCreditTotal" + // Renewing the durable owner lease that proves this process still owns the run. + WorkflowDurableOperationRefreshLease WorkflowDurableOperation = "refreshLease" + // Rolling back an uncommitted subagent admission. + WorkflowDurableOperationReleaseAgent WorkflowDurableOperation = "releaseAgent" + // Persisting subagent admission accounting. + WorkflowDurableOperationReserveAgent WorkflowDurableOperation = "reserveAgent" +) + +// Kind of workflow progress line. +// Experimental: WorkflowLogLineKind is part of an experimental API and may change or be +// removed. +type WorkflowLogLineKind string + +const ( + // A narrator log line. + WorkflowLogLineKindLog WorkflowLogLineKind = "log" + // A named workflow phase marker. + WorkflowLogLineKindPhase WorkflowLogLineKind = "phase" +) + +// Action the runtime selected for a durable workflow pause checkpoint. +// Experimental: WorkflowPauseCheckpointAction is part of an experimental API and may change +// or be removed. +type WorkflowPauseCheckpointAction string + +const ( + // The checkpoint was committed by a prior paused attempt, so execution may continue. + WorkflowPauseCheckpointActionContinue WorkflowPauseCheckpointAction = "continue" + // This attempt claimed the checkpoint and must cooperatively stop. + WorkflowPauseCheckpointActionPause WorkflowPauseCheckpointAction = "pause" +) + +// Type discriminator for WorkflowPauseInfo. +type WorkflowPauseInfoType string + +const ( + WorkflowPauseInfoTypeCheckpoint WorkflowPauseInfoType = "checkpoint" + WorkflowPauseInfoTypeUser WorkflowPauseInfoType = "user" +) + +// Derived lifecycle state of a workflow phase. +// Experimental: WorkflowPhaseStatus is part of an experimental API and may change or be +// removed. +type WorkflowPhaseStatus string + +const ( + // The phase is currently entered and accumulating active time. + WorkflowPhaseStatusActive WorkflowPhaseStatus = "active" + // The phase was entered and has since been closed. + WorkflowPhaseStatusCompleted WorkflowPhaseStatus = "completed" + // The phase has not been entered yet. + WorkflowPhaseStatusPending WorkflowPhaseStatus = "pending" + // The phase was never entered because a later phase was entered or the run reached a + // terminal state. + WorkflowPhaseStatusSkipped WorkflowPhaseStatus = "skipped" +) + +// Cumulative resource ceiling that stopped a workflow run. +// Experimental: WorkflowRunFailureKind is part of an experimental API and may change or be +// removed. +type WorkflowRunFailureKind string + +const ( + // The run's settled subagent model usage exceeded the approved AI-credit ceiling, or no + // headroom remained for another subagent. + WorkflowRunFailureKindMaxAiCredits WorkflowRunFailureKind = "maxAiCredits" + // The run admitted the approved maximum total number of subagents. + WorkflowRunFailureKindMaxTotalSubagents WorkflowRunFailureKind = "maxTotalSubagents" + // The run reached the approved accumulated active-execution time in seconds. + WorkflowRunFailureKindTimeoutSeconds WorkflowRunFailureKind = "timeoutSeconds" +) + +// Type discriminator for WorkflowRunFailure. +type WorkflowRunFailureType string + +const ( + WorkflowRunFailureTypeWorkflowAccountingIncomplete WorkflowRunFailureType = "workflow_accounting_incomplete" + WorkflowRunFailureTypeWorkflowDurableFailure WorkflowRunFailureType = "workflow_durable_failure" + WorkflowRunFailureTypeWorkflowLimitReached WorkflowRunFailureType = "workflow_limit_reached" + WorkflowRunFailureTypeWorkflowProviderDisconnected WorkflowRunFailureType = "workflow_provider_disconnected" + WorkflowRunFailureTypeWorkflowResumeDeclined WorkflowRunFailureType = "workflow_resume_declined" +) + +// Current or terminal state of a workflow run. +// Experimental: WorkflowRunStatus is part of an experimental API and may change or be +// removed. +type WorkflowRunStatus string + +const ( + // The run was cancelled before completion. + WorkflowRunStatusCancelled WorkflowRunStatus = "cancelled" + // The run completed successfully. + WorkflowRunStatusCompleted WorkflowRunStatus = "completed" + // The workflow body failed or reached a cumulative resource ceiling. + WorkflowRunStatusError WorkflowRunStatus = "error" + // The run was interrupted while resource budget remained. + WorkflowRunStatusHalted WorkflowRunStatus = "halted" + // The current attempt stopped intentionally and the run may be resumed. + WorkflowRunStatusPaused WorkflowRunStatus = "paused" + // The run was minted and is awaiting approval. + WorkflowRunStatusPending WorkflowRunStatus = "pending" + // The run is executing. + WorkflowRunStatusRunning WorkflowRunStatus = "running" +) + +// Type of change represented by this file diff. +// Experimental: WorkspaceDiffFileChangeType is part of an experimental API and may change +// or be removed. +type WorkspaceDiffFileChangeType string + +const ( + // The file was added. + WorkspaceDiffFileChangeTypeAdded WorkspaceDiffFileChangeType = "added" + // The file was deleted. + WorkspaceDiffFileChangeTypeDeleted WorkspaceDiffFileChangeType = "deleted" + // The file was modified. + WorkspaceDiffFileChangeTypeModified WorkspaceDiffFileChangeType = "modified" + // The file was renamed. + WorkspaceDiffFileChangeTypeRenamed WorkspaceDiffFileChangeType = "renamed" +) + +// Diff mode requested by the client. +// Experimental: WorkspaceDiffMode is part of an experimental API and may change or be +// removed. +type WorkspaceDiffMode string + +const ( + // Return changes compared with the default branch. + WorkspaceDiffModeBranch WorkspaceDiffMode = "branch" + // Return the cumulative diff of files Copilot changed this session (used in non-git + // workspaces). + WorkspaceDiffModeSession WorkspaceDiffMode = "session" + // Return staged, unstaged, and untracked working tree changes. + WorkspaceDiffModeUnstaged WorkspaceDiffMode = "unstaged" +) + +// Repository host type, if known +// Experimental: WorkspaceSummaryHostType is part of an experimental API and may change or +// be removed. +type WorkspaceSummaryHostType string + +const ( + // Workspace summary repository is hosted on Azure DevOps. + WorkspaceSummaryHostTypeADO WorkspaceSummaryHostType = "ado" + // Workspace summary repository is hosted on GitHub. + WorkspaceSummaryHostTypeGitHub WorkspaceSummaryHostType = "github" +) + +// Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration. +// Experimental: WorkspacesWorkspaceDetailsHostType is part of an experimental API and may +// change or be removed. +type WorkspacesWorkspaceDetailsHostType string + +const ( + // Workspace repository is hosted on Azure DevOps. + WorkspacesWorkspaceDetailsHostTypeADO WorkspacesWorkspaceDetailsHostType = "ado" + // Workspace repository is hosted on GitHub. + WorkspacesWorkspaceDetailsHostTypeGitHub WorkspacesWorkspaceDetailsHostType = "github" +) + +type serverAPI struct { + client *jsonrpc2.Client +} + +// Experimental: ServerAccountAPI contains experimental APIs that may change or be removed. +type ServerAccountAPI serverAPI + +// GetAllUsers gets all authenticated users available for account switching. +// +// RPC method: account.getAllUsers. +// +// Returns: List of all authenticated users +func (a *ServerAccountAPI) GetAllUsers(ctx context.Context) (*AccountGetAllUsersResult, error) { + raw, err := a.client.Request(ctx, "account.getAllUsers", nil) + if err != nil { + return nil, err + } + var result AccountGetAllUsersResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// GetCurrentAuth gets the currently active authentication credentials from the global auth +// manager. +// +// RPC method: account.getCurrentAuth. +// +// Returns: Current authentication state +func (a *ServerAccountAPI) GetCurrentAuth(ctx context.Context) (*AccountGetCurrentAuthResult, error) { + raw, err := a.client.Request(ctx, "account.getCurrentAuth", nil) + if err != nil { + return nil, err + } + var result AccountGetCurrentAuthResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// GetQuota gets Copilot quota usage for the current or opaquely selected authenticated user. +// +// RPC method: account.getQuota. +// +// Parameters: Optional opaque account selection or compatibility GitHub token used to look +// up quota. +// +// Returns: Quota usage snapshots for the resolved user, keyed by quota type. +func (a *ServerAccountAPI) GetQuota(ctx context.Context, params *AccountGetQuotaRequest) (*AccountGetQuotaResult, error) { + raw, err := a.client.Request(ctx, "account.getQuota", params) + if err != nil { + return nil, err + } + var result AccountGetQuotaResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Login validates and stores authentication credentials. When login is omitted, resolves +// the authenticated user from the token before persistence. +// +// RPC method: account.login. +// +// Parameters: Credentials to validate and store. Omit login to resolve the authenticated +// user from the token. +// +// Returns: Result of a successful login; throws on failure +func (a *ServerAccountAPI) Login(ctx context.Context, params *AccountLoginRequest) (*AccountLoginResult, error) { + raw, err := a.client.Request(ctx, "account.login", params) + if err != nil { + return nil, err + } + var result AccountLoginResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Logout removes user authentication from keychain and persisted state. +// +// RPC method: account.logout. +// +// Parameters: User to log out +// +// Returns: Logout result indicating if more users remain +func (a *ServerAccountAPI) Logout(ctx context.Context, params *AccountLogoutRequest) (*AccountLogoutResult, error) { + raw, err := a.client.Request(ctx, "account.logout", params) + if err != nil { + return nil, err + } + var result AccountLogoutResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Experimental: ServerAgentRegistryAPI contains experimental APIs that may change or be +// removed. +type ServerAgentRegistryAPI serverAPI + +// Spawns a managed-server child with the supplied configuration and returns a +// discriminated-union result. The caller (typically the CLI controller) is responsible for +// attaching to the spawned child and sending any follow-up prompt. When the +// controller-local spawn gate is closed the server returns JSON-RPC MethodNotFound. +// +// RPC method: agentRegistry.spawn. +// +// Parameters: Inputs to spawn a managed-server child via the controller's spawn delegate. +// +// Returns: Outcome of an agentRegistry.spawn call. +func (a *ServerAgentRegistryAPI) Spawn(ctx context.Context, params *AgentRegistrySpawnRequest) (AgentRegistrySpawnResult, error) { + raw, err := a.client.Request(ctx, "agentRegistry.spawn", params) + if err != nil { + return nil, err + } + result, err := unmarshalAgentRegistrySpawnResult(raw) + if err != nil { + return nil, err + } + return result, nil +} + +// Experimental: ServerAgentsAPI contains experimental APIs that may change or be removed. +type ServerAgentsAPI serverAPI + +// Discovers custom agents across user, project, plugin, and remote sources. +// +// RPC method: agents.discover. +// +// Parameters: Optional project paths to include in agent discovery. +// +// Returns: Agents discovered across user, project, plugin, and remote sources. +func (a *ServerAgentsAPI) Discover(ctx context.Context, params *AgentsDiscoverRequest) (*ServerAgentList, error) { + raw, err := a.client.Request(ctx, "agents.discover", params) + if err != nil { + return nil, err + } + var result ServerAgentList + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// GetDiscoveryPaths returns the canonical directories where a client may create custom +// agents that the runtime will recognize, including ones that do not exist yet. Project +// directories become active once created. +// +// RPC method: agents.getDiscoveryPaths. +// +// Parameters: Optional project paths to include when enumerating agent discovery +// directories. +// +// Returns: Canonical locations where custom agents can be created so the runtime will +// recognize them. +func (a *ServerAgentsAPI) GetDiscoveryPaths(ctx context.Context, params *AgentsGetDiscoveryPathsRequest) (*AgentDiscoveryPathList, error) { + raw, err := a.client.Request(ctx, "agents.getDiscoveryPaths", params) + if err != nil { + return nil, err + } + var result AgentDiscoveryPathList + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Experimental: ServerCatalogAPI contains experimental APIs that may change or be removed. +type ServerCatalogAPI serverAPI + +// Search requests a bounded catalog search. This host-implemented server method is +// available through SDK/TUI hosts; standalone and C-ABI runtimes whose host does not +// implement server-method dispatch return JSON-RPC MethodNotFound. A runtime with search +// available returns inert candidate summaries, each with an opaque single-use handle scoped +// to this runtime instance; a runtime without it returns the typed search-unavailable +// result. Public authorities may be searched anonymously, while an authority that requires +// credentials yields the typed authentication-required result. All returned text, URLs, and +// package metadata are untrusted external data and can never trigger instructions, tools, +// or installation. Read-only: nothing is installed, configured, or persisted. +// +// RPC method: catalog.search. +// +// Parameters: A bounded catalog search. Both the query length and the result count are +// capped by the schema so a caller cannot request an unbounded scan. +// +// Returns: Outcome of a catalog.search call: either bounded inert candidates, or one typed +// refusal. Never a partial success. +func (a *ServerCatalogAPI) Search(ctx context.Context, params *CatalogSearchRequest) (CatalogSearchResult, error) { + raw, err := a.client.Request(ctx, "catalog.search", params) + if err != nil { + return nil, err + } + result, err := unmarshalCatalogSearchResult(raw) + if err != nil { + return nil, err + } + return result, nil +} + +// Select terminates one retained catalog selection group. A selected outcome returns the +// native host a fresh single-use candidate handle plus the original searchId for a later +// explicit mcp.planInstall call; non-selected outcomes release the group without producing +// a planning input. Candidate state, cards, URLs, credentials and private identifiers +// remain inside the runtime. The model-facing catalog_select tool projects the result +// separately and never exposes the candidate handle or searchId. +// +// RPC method: catalog.select. +// +// Parameters: Terminates one retained catalog selection group through an opaque reference +// previously returned by the model-safe search projection. +// +// Returns: Typed outcome of catalog.select. Only the selected host result carries a fresh +// candidate handle; the model-facing projection removes both that handle and searchId. +func (a *ServerCatalogAPI) Select(ctx context.Context, params *CatalogSelectionRequest) (CatalogSelectionResult, error) { + raw, err := a.client.Request(ctx, "catalog.select", params) + if err != nil { + return nil, err + } + result, err := unmarshalCatalogSelectionResult(raw) + if err != nil { + return nil, err + } + return result, nil +} + +// Experimental: ServerCommandsAPI contains experimental APIs that may change or be removed. +type ServerCommandsAPI serverAPI + +// 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. +// +// RPC method: commands.list. +// +// Returns: Slash commands available in the session, after applying any include/exclude +// filters. +func (a *ServerCommandsAPI) List(ctx context.Context) (*CommandList, error) { + raw, err := a.client.Request(ctx, "commands.list", nil) + if err != nil { + return nil, err + } + var result CommandList + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Experimental: ServerExtensionsAPI contains experimental APIs that may change or be +// removed. +type ServerExtensionsAPI serverAPI + +// Disable persistently disables extension IDs for future sessions. Active sessions are +// unchanged; use session.extensions.disable to update them. +// +// RPC method: extensions.disable. +// +// Parameters: Source-qualified extension identifiers to persistently disable for future +// sessions. +func (a *ServerExtensionsAPI) Disable(ctx context.Context, params *DiscoveredExtensionsDisableRequest) (*ExtensionsDisableResult, error) { + raw, err := a.client.Request(ctx, "extensions.disable", params) + if err != nil { + return nil, err + } + var result ExtensionsDisableResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Discovers user and enabled installed-plugin extensions from persisted Copilot home state, +// including enablement preferences. Launch-scoped additional plugins are not included. +// +// RPC method: extensions.discover. +// +// Returns: Extensions discovered from persisted Copilot home state and their effective +// loading mode. Launch-scoped additional plugins are not included. +func (a *ServerExtensionsAPI) Discover(ctx context.Context) (*DiscoveredExtensions, error) { + raw, err := a.client.Request(ctx, "extensions.discover", nil) + if err != nil { + return nil, err + } + var result DiscoveredExtensions + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Enable persistently enables extension IDs for future sessions. Active sessions are +// unchanged; use session.extensions.enable to update them. +// +// RPC method: extensions.enable. +// +// Parameters: Source-qualified extension identifiers to persistently enable for future +// sessions. +func (a *ServerExtensionsAPI) Enable(ctx context.Context, params *DiscoveredExtensionsEnableRequest) (*ExtensionsEnableResult, error) { + raw, err := a.client.Request(ctx, "extensions.enable", params) + if err != nil { + return nil, err + } + var result ExtensionsEnableResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Experimental: ServerHooksAPI contains experimental APIs that may change or be removed. +type ServerHooksAPI serverAPI + +// Discovers hook actions enabled under server-side discovery settings from user, +// repository, plugin, and managed-policy sources. +// +// RPC method: hooks.discover. +// +// Parameters: Optional project paths and host-exclusion behavior for server-scoped hook +// discovery. +// +// Returns: Server-discovered hook actions and partial-load diagnostics from user, +// repository, plugin, and managed-policy sources. Concrete sessions may include additional +// session-specific hook sources. +func (a *ServerHooksAPI) Discover(ctx context.Context, params *HooksDiscoverRequest) (*HooksDiscoverResult, error) { + raw, err := a.client.Request(ctx, "hooks.discover", params) + if err != nil { + return nil, err + } + var result HooksDiscoverResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Experimental: ServerInstructionsAPI contains experimental APIs that may change or be // removed. -type WorkspaceDiffMode string +type ServerInstructionsAPI serverAPI -const ( - // Return changes compared with the default branch. - WorkspaceDiffModeBranch WorkspaceDiffMode = "branch" - // Return the cumulative diff of files Copilot changed this session (used in non-git - // workspaces). - WorkspaceDiffModeSession WorkspaceDiffMode = "session" - // Return staged, unstaged, and untracked working tree changes. - WorkspaceDiffModeUnstaged WorkspaceDiffMode = "unstaged" -) +// Discovers instruction sources across user, repository, and plugin sources. +// +// RPC method: instructions.discover. +// +// Parameters: Optional project paths to include in instruction discovery. +// +// Returns: Instruction sources discovered across user, repository, and plugin sources. +func (a *ServerInstructionsAPI) Discover(ctx context.Context, params *InstructionsDiscoverRequest) (*ServerInstructionSourceList, error) { + raw, err := a.client.Request(ctx, "instructions.discover", params) + if err != nil { + return nil, err + } + var result ServerInstructionSourceList + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} -// Repository host type, if known -// Experimental: WorkspaceSummaryHostType is part of an experimental API and may change or -// be removed. -type WorkspaceSummaryHostType string +// GetDiscoveryPaths 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. +// +// RPC method: instructions.getDiscoveryPaths. +// +// Parameters: 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. +func (a *ServerInstructionsAPI) GetDiscoveryPaths(ctx context.Context, params *InstructionsGetDiscoveryPathsRequest) (*InstructionDiscoveryPathList, error) { + raw, err := a.client.Request(ctx, "instructions.getDiscoveryPaths", params) + if err != nil { + return nil, err + } + var result InstructionDiscoveryPathList + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} -const ( - // Workspace summary repository is hosted on Azure DevOps. - WorkspaceSummaryHostTypeADO WorkspaceSummaryHostType = "ado" - // Workspace summary repository is hosted on GitHub. - WorkspaceSummaryHostTypeGitHub WorkspaceSummaryHostType = "github" -) +// Experimental: ServerLlmInferenceAPI contains experimental APIs that may change or be +// removed. +type ServerLlmInferenceAPI serverAPI -// Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration. -// Experimental: WorkspacesWorkspaceDetailsHostType is part of an experimental API and may -// change or be removed. -type WorkspacesWorkspaceDetailsHostType string +// HttpResponseChunk delivers a body byte range (or a terminal transport error) for an +// in-flight response, correlated by requestId. Set `end` true on the last chunk. When +// `error` is set the response terminates with a transport-level failure and the runtime +// raises an APIConnectionError. +// +// RPC method: llmInference.httpResponseChunk. +// +// Parameters: A response body chunk or terminal error. +// +// Returns: Whether the chunk was accepted. +func (a *ServerLlmInferenceAPI) HttpResponseChunk(ctx context.Context, params *LlmInferenceHTTPResponseChunkRequest) (*LlmInferenceHTTPResponseChunkResult, error) { + raw, err := a.client.Request(ctx, "llmInference.httpResponseChunk", params) + if err != nil { + return nil, err + } + var result LlmInferenceHTTPResponseChunkResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} -const ( - // Workspace repository is hosted on Azure DevOps. - WorkspacesWorkspaceDetailsHostTypeADO WorkspacesWorkspaceDetailsHostType = "ado" - // Workspace repository is hosted on GitHub. - WorkspacesWorkspaceDetailsHostTypeGitHub WorkspacesWorkspaceDetailsHostType = "github" -) +// HttpResponseStart delivers the response head (status + headers) for an in-flight request, +// correlated by the requestId the runtime supplied in httpRequestStart. Must be called +// exactly once per request before any httpResponseChunk frames. +// +// RPC method: llmInference.httpResponseStart. +// +// Parameters: Response head. +// +// Returns: Whether the start frame was accepted. +func (a *ServerLlmInferenceAPI) HttpResponseStart(ctx context.Context, params *LlmInferenceHTTPResponseStartRequest) (*LlmInferenceHTTPResponseStartResult, error) { + raw, err := a.client.Request(ctx, "llmInference.httpResponseStart", params) + if err != nil { + return nil, err + } + var result LlmInferenceHTTPResponseStartResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} -type serverAPI struct { - client *jsonrpc2.Client +// SetProvider registers an SDK client as the LLM inference callback provider. +// +// RPC method: llmInference.setProvider. +// +// Returns: Indicates whether the calling client was registered as the LLM inference +// provider. +func (a *ServerLlmInferenceAPI) SetProvider(ctx context.Context) (*LlmInferenceSetProviderResult, error) { + raw, err := a.client.Request(ctx, "llmInference.setProvider", nil) + if err != nil { + return nil, err + } + var result LlmInferenceSetProviderResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil } -// Experimental: ServerAccountAPI contains experimental APIs that may change or be removed. -type ServerAccountAPI serverAPI +// Experimental: ServerManagedSettingsAPI contains experimental APIs that may change or be +// removed. +type ServerManagedSettingsAPI serverAPI -// GetAllUsers gets all authenticated users available for account switching. -// -// RPC method: account.getAllUsers. +// ClearCache force-refreshes enterprise managed settings for every account: wipes the +// persistent server-policy cache (the whole `/managed-settings` directory) and +// drops this runtime process's in-memory retained server policy. It does not itself fetch +// policy — the effect is that the next time a session resolves managed settings for an +// account, that resolution re-fetches the account's org policy from the network instead of +// serving a cached response. Note that `managedSettings.read` returns only device/MDM +// settings and never triggers the account server-policy fetch, so a host implementing "sync +// account policy" should start a fresh session resolution rather than treat a subsequent +// `managedSettings.read` as the refreshed org policy. Mirrors the invalidation a sign-out +// performs, broadened from the one signing-out account to all of them; device/MDM layers +// describe the machine, not the account, and are left untouched. Rejects if the on-disk +// cache cannot be removed. // -// Returns: List of all authenticated users -func (a *ServerAccountAPI) GetAllUsers(ctx context.Context) (*AccountGetAllUsersResult, error) { - raw, err := a.client.Request(ctx, "account.getAllUsers", nil) +// RPC method: managedSettings.clearCache. +func (a *ServerManagedSettingsAPI) ClearCache(ctx context.Context) (*ManagedSettingsClearCacheResult, error) { + raw, err := a.client.Request(ctx, "managedSettings.clearCache", nil) if err != nil { return nil, err } - var result AccountGetAllUsersResult + var result ManagedSettingsClearCacheResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetCurrentAuth gets the currently active authentication credentials from the global auth -// manager. +// Read discovers device-managed settings from production MDM and managed-file sources, +// validates them against the runtime-owned managed-settings schema, and returns the +// canonical JSON without requiring a session. // -// RPC method: account.getCurrentAuth. +// RPC method: managedSettings.read. // -// Returns: Current authentication state -func (a *ServerAccountAPI) GetCurrentAuth(ctx context.Context) (*AccountGetCurrentAuthResult, error) { - raw, err := a.client.Request(ctx, "account.getCurrentAuth", nil) +// Returns: Validated device-managed settings discovered before a session exists. +func (a *ServerManagedSettingsAPI) Read(ctx context.Context) (*ManagedSettingsReadResult, error) { + raw, err := a.client.Request(ctx, "managedSettings.read", nil) if err != nil { return nil, err } - var result AccountGetCurrentAuthResult + var result ManagedSettingsReadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetQuota gets Copilot quota usage for the current or opaquely selected authenticated user. +// Experimental: ServerMCPAPI contains experimental APIs that may change or be removed. +type ServerMCPAPI serverAPI + +// Discovers MCP servers from user, workspace, plugin, and builtin sources. // -// RPC method: account.getQuota. +// RPC method: mcp.discover. // -// Parameters: Optional opaque account selection or compatibility GitHub token used to look -// up quota. +// Parameters: Optional working directory used as context for MCP server discovery. // -// Returns: Quota usage snapshots for the resolved user, keyed by quota type. -func (a *ServerAccountAPI) GetQuota(ctx context.Context, params *AccountGetQuotaRequest) (*AccountGetQuotaResult, error) { - raw, err := a.client.Request(ctx, "account.getQuota", params) +// Returns: MCP servers discovered from user, workspace, plugin, and built-in sources. +func (a *ServerMCPAPI) Discover(ctx context.Context, params *MCPDiscoverRequest) (*MCPDiscoverResult, error) { + raw, err := a.client.Request(ctx, "mcp.discover", params) if err != nil { return nil, err } - var result AccountGetQuotaResult + var result MCPDiscoverResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Login validates and stores authentication credentials. When login is omitted, resolves -// the authenticated user from the token before persistence. +// PlanInstall requests a side-effect-free MCP install plan from a catalog candidate handle +// or a caller-supplied card. This host-implemented server method is available through +// SDK/TUI hosts; standalone and C-ABI runtimes whose host does not implement server-method +// dispatch return JSON-RPC MethodNotFound. A runtime with planning available returns a +// normalised plan and opaque single-use plan handle; a runtime without it returns the typed +// planning-unavailable result. A completed plan reports resource identity, provenance, +// eligible transport choices, the user-scope target, required typed values and secret +// placeholders, the policy result, the configuration changes installing would make, and +// whether a reload would be needed. Planning never writes configuration, stores a secret, +// or reloads MCP servers, so abandoning a plan needs no call and leaves nothing behind. // -// RPC method: account.login. +// RPC method: mcp.planInstall. // -// Parameters: Credentials to validate and store. Omit login to resolve the authenticated -// user from the token. +// Parameters: A side-effect-free request for an MCP install plan. Computing a plan never +// writes configuration, stores a secret, or reloads MCP servers. // -// Returns: Result of a successful login; throws on failure -func (a *ServerAccountAPI) Login(ctx context.Context, params *AccountLoginRequest) (*AccountLoginResult, error) { - raw, err := a.client.Request(ctx, "account.login", params) +// Returns: Outcome of an mcp.planInstall call: either a normalised plan, or one typed +// refusal. Nothing is written in either case. +func (a *ServerMCPAPI) PlanInstall(ctx context.Context, params *MCPPlanInstallRequest) (MCPPlanInstallResult, error) { + raw, err := a.client.Request(ctx, "mcp.planInstall", params) if err != nil { return nil, err } - var result AccountLoginResult + result, err := unmarshalMCPPlanInstallResult(raw) + if err != nil { + return nil, err + } + return result, nil +} + +// Experimental: ServerMCPConfigAPI contains experimental APIs that may change or be removed. +type ServerMCPConfigAPI serverAPI + +// Adds an MCP server to user configuration. +// +// RPC method: mcp.config.add. +// +// Parameters: MCP server name and configuration to add to user configuration. +func (a *ServerMCPConfigAPI) Add(ctx context.Context, params *MCPConfigAddRequest) (*MCPConfigAddResult, error) { + raw, err := a.client.Request(ctx, "mcp.config.add", params) + if err != nil { + return nil, err + } + var result MCPConfigAddResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Logout removes user authentication from keychain and persisted state. -// -// RPC method: account.logout. +// Disables MCP servers in user configuration for new sessions. // -// Parameters: User to log out +// RPC method: mcp.config.disable. // -// Returns: Logout result indicating if more users remain -func (a *ServerAccountAPI) Logout(ctx context.Context, params *AccountLogoutRequest) (*AccountLogoutResult, error) { - raw, err := a.client.Request(ctx, "account.logout", params) +// Parameters: MCP server names to disable for new sessions. +func (a *ServerMCPConfigAPI) Disable(ctx context.Context, params *MCPConfigDisableRequest) (*MCPConfigDisableResult, error) { + raw, err := a.client.Request(ctx, "mcp.config.disable", params) if err != nil { return nil, err } - var result AccountLogoutResult + var result MCPConfigDisableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerAgentRegistryAPI contains experimental APIs that may change or be -// removed. -type ServerAgentRegistryAPI serverAPI - -// Spawns a managed-server child with the supplied configuration and returns a -// discriminated-union result. The caller (typically the CLI controller) is responsible for -// attaching to the spawned child and sending any follow-up prompt. When the -// controller-local spawn gate is closed the server returns JSON-RPC MethodNotFound. -// -// RPC method: agentRegistry.spawn. +// Enables MCP servers in user configuration for new sessions. // -// Parameters: Inputs to spawn a managed-server child via the controller's spawn delegate. +// RPC method: mcp.config.enable. // -// Returns: Outcome of an agentRegistry.spawn call. -func (a *ServerAgentRegistryAPI) Spawn(ctx context.Context, params *AgentRegistrySpawnRequest) (AgentRegistrySpawnResult, error) { - raw, err := a.client.Request(ctx, "agentRegistry.spawn", params) +// Parameters: MCP server names to enable for new sessions. +func (a *ServerMCPConfigAPI) Enable(ctx context.Context, params *MCPConfigEnableRequest) (*MCPConfigEnableResult, error) { + raw, err := a.client.Request(ctx, "mcp.config.enable", params) if err != nil { return nil, err } - result, err := unmarshalAgentRegistrySpawnResult(raw) - if err != nil { + var result MCPConfigEnableResult + if err := json.Unmarshal(raw, &result); err != nil { return nil, err } - return result, nil + return &result, nil } -// Experimental: ServerAgentsAPI contains experimental APIs that may change or be removed. -type ServerAgentsAPI serverAPI - -// Discovers custom agents across user, project, plugin, and remote sources. -// -// RPC method: agents.discover. +// Lists MCP servers from user configuration. // -// Parameters: Optional project paths to include in agent discovery. +// RPC method: mcp.config.list. // -// Returns: Agents discovered across user, project, plugin, and remote sources. -func (a *ServerAgentsAPI) Discover(ctx context.Context, params *AgentsDiscoverRequest) (*ServerAgentList, error) { - raw, err := a.client.Request(ctx, "agents.discover", params) +// Returns: User-configured MCP servers, keyed by server name. +func (a *ServerMCPConfigAPI) List(ctx context.Context) (*MCPConfigList, error) { + raw, err := a.client.Request(ctx, "mcp.config.list", nil) if err != nil { return nil, err } - var result ServerAgentList + var result MCPConfigList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetDiscoveryPaths returns the canonical directories where a client may create custom -// agents that the runtime will recognize, including ones that do not exist yet. Project -// directories become active once created. -// -// RPC method: agents.getDiscoveryPaths. -// -// Parameters: Optional project paths to include when enumerating agent discovery -// directories. +// Reload drops this runtime process's in-memory MCP server-definition cache so the next MCP +// config read observes disk. // -// Returns: Canonical locations where custom agents can be created so the runtime will -// recognize them. -func (a *ServerAgentsAPI) GetDiscoveryPaths(ctx context.Context, params *AgentsGetDiscoveryPathsRequest) (*AgentDiscoveryPathList, error) { - raw, err := a.client.Request(ctx, "agents.getDiscoveryPaths", params) +// RPC method: mcp.config.reload. +func (a *ServerMCPConfigAPI) Reload(ctx context.Context) (*MCPConfigReloadResult, error) { + raw, err := a.client.Request(ctx, "mcp.config.reload", nil) if err != nil { return nil, err } - var result AgentDiscoveryPathList + var result MCPConfigReloadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerCatalogAPI contains experimental APIs that may change or be removed. -type ServerCatalogAPI serverAPI - -// Search requests a bounded catalog search. This host-implemented server method is -// available through SDK/TUI hosts; standalone and C-ABI runtimes whose host does not -// implement server-method dispatch return JSON-RPC MethodNotFound. A runtime with search -// available returns inert candidate summaries, each with an opaque single-use handle scoped -// to this runtime instance; a runtime without it returns the typed search-unavailable -// result. Public authorities may be searched anonymously, while an authority that requires -// credentials yields the typed authentication-required result. All returned text, URLs, and -// package metadata are untrusted external data and can never trigger instructions, tools, -// or installation. Read-only: nothing is installed, configured, or persisted. -// -// RPC method: catalog.search. +// Removes an MCP server from user configuration. // -// Parameters: A bounded catalog search. Both the query length and the result count are -// capped by the schema so a caller cannot request an unbounded scan. +// RPC method: mcp.config.remove. // -// Returns: Outcome of a catalog.search call: either bounded inert candidates, or one typed -// refusal. Never a partial success. -func (a *ServerCatalogAPI) Search(ctx context.Context, params *CatalogSearchRequest) (CatalogSearchResult, error) { - raw, err := a.client.Request(ctx, "catalog.search", params) +// Parameters: MCP server name to remove from user configuration. +func (a *ServerMCPConfigAPI) Remove(ctx context.Context, params *MCPConfigRemoveRequest) (*MCPConfigRemoveResult, error) { + raw, err := a.client.Request(ctx, "mcp.config.remove", params) if err != nil { return nil, err } - result, err := unmarshalCatalogSearchResult(raw) - if err != nil { + var result MCPConfigRemoveResult + if err := json.Unmarshal(raw, &result); err != nil { return nil, err } - return result, nil + return &result, nil } -// Experimental: ServerCommandsAPI contains experimental APIs that may change or be removed. -type ServerCommandsAPI serverAPI - -// 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. +// Updates an MCP server in user configuration. // -// RPC method: commands.list. +// RPC method: mcp.config.update. // -// Returns: Slash commands available in the session, after applying any include/exclude -// filters. -func (a *ServerCommandsAPI) List(ctx context.Context) (*CommandList, error) { - raw, err := a.client.Request(ctx, "commands.list", nil) +// Parameters: MCP server name and replacement configuration to write to user configuration. +func (a *ServerMCPConfigAPI) Update(ctx context.Context, params *MCPConfigUpdateRequest) (*MCPConfigUpdateResult, error) { + raw, err := a.client.Request(ctx, "mcp.config.update", params) if err != nil { return nil, err } - var result CommandList + var result MCPConfigUpdateResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerExtensionsAPI contains experimental APIs that may change or be -// removed. -type ServerExtensionsAPI serverAPI +// Experimental: Config returns experimental APIs that may change or be removed. +func (s *ServerMCPAPI) Config() *ServerMCPConfigAPI { + return (*ServerMCPConfigAPI)(s) +} -// Disable persistently disables extension IDs for future sessions. Active sessions are -// unchanged; use session.extensions.disable to update them. +// Experimental: ServerModelsAPI contains experimental APIs that may change or be removed. +type ServerModelsAPI serverAPI + +// GetBuiltInCatalog returns the running runtime's complete catalog of well-known built-in +// model IDs without authentication or network access. // -// RPC method: extensions.disable. +// RPC method: models.getBuiltInCatalog. // -// Parameters: Source-qualified extension identifiers to persistently disable for future -// sessions. -func (a *ServerExtensionsAPI) Disable(ctx context.Context, params *DiscoveredExtensionsDisableRequest) (*ExtensionsDisableResult, error) { - raw, err := a.client.Request(ctx, "extensions.disable", params) +// Returns: The running runtime's complete catalog of well-known built-in model IDs, +// including supported models and additional IDs with built-in metadata. +func (a *ServerModelsAPI) GetBuiltInCatalog(ctx context.Context) (*BuiltInModelCatalog, error) { + raw, err := a.client.Request(ctx, "models.getBuiltInCatalog", nil) if err != nil { return nil, err } - var result ExtensionsDisableResult + var result BuiltInModelCatalog if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Discovers user and enabled installed-plugin extensions from persisted Copilot home state, -// including enablement preferences. Launch-scoped additional plugins are not included. +// Lists Copilot models available to the authenticated user. // -// RPC method: extensions.discover. +// RPC method: models.list. // -// Returns: Extensions discovered from persisted Copilot home state and their effective -// loading mode. Launch-scoped additional plugins are not included. -func (a *ServerExtensionsAPI) Discover(ctx context.Context) (*DiscoveredExtensions, error) { - raw, err := a.client.Request(ctx, "extensions.discover", nil) +// Parameters: Optional opaque account selection or compatibility GitHub token used to list +// models. +// +// Returns: List of Copilot models available to the resolved user, including capabilities +// and billing metadata. +func (a *ServerModelsAPI) List(ctx context.Context, params *ModelsListRequest) (*ModelList, error) { + raw, err := a.client.Request(ctx, "models.list", params) if err != nil { return nil, err } - var result DiscoveredExtensions + var result ModelList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Enable persistently enables extension IDs for future sessions. Active sessions are -// unchanged; use session.extensions.enable to update them. +// Experimental: ServerPluginsAPI contains experimental APIs that may change or be removed. +type ServerPluginsAPI serverAPI + +// Disables installed plugins for new sessions. // -// RPC method: extensions.enable. +// RPC method: plugins.disable. // -// Parameters: Source-qualified extension identifiers to persistently enable for future -// sessions. -func (a *ServerExtensionsAPI) Enable(ctx context.Context, params *DiscoveredExtensionsEnableRequest) (*ExtensionsEnableResult, error) { - raw, err := a.client.Request(ctx, "extensions.enable", params) +// Parameters: Plugin names (or specs) to disable, plus the optional working directory the +// repository-controlled guard is evaluated against. +func (a *ServerPluginsAPI) Disable(ctx context.Context, params *PluginsDisableRequest) (*PluginsDisableResult, error) { + raw, err := a.client.Request(ctx, "plugins.disable", params) if err != nil { return nil, err } - var result ExtensionsEnableResult + var result PluginsDisableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerHooksAPI contains experimental APIs that may change or be removed. -type ServerHooksAPI serverAPI - -// Discovers hook actions enabled under server-side discovery settings from user, -// repository, plugin, and managed-policy sources. -// -// RPC method: hooks.discover. +// Enables installed plugins for new sessions. // -// Parameters: Optional project paths and host-exclusion behavior for server-scoped hook -// discovery. +// RPC method: plugins.enable. // -// Returns: Server-discovered hook actions and partial-load diagnostics from user, -// repository, plugin, and managed-policy sources. Concrete sessions may include additional -// session-specific hook sources. -func (a *ServerHooksAPI) Discover(ctx context.Context, params *HooksDiscoverRequest) (*HooksDiscoverResult, error) { - raw, err := a.client.Request(ctx, "hooks.discover", params) +// Parameters: Plugin names (or specs) to enable, plus the optional working directory the +// repository-controlled guard is evaluated against. +func (a *ServerPluginsAPI) Enable(ctx context.Context, params *PluginsEnableRequest) (*PluginsEnableResult, error) { + raw, err := a.client.Request(ctx, "plugins.enable", params) if err != nil { return nil, err } - var result HooksDiscoverResult + var result PluginsEnableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerInstructionsAPI contains experimental APIs that may change or be -// removed. -type ServerInstructionsAPI serverAPI - -// Discovers instruction sources across user, repository, and plugin sources. +// Installs a plugin from a marketplace, GitHub repo, URL, or local path. // -// RPC method: instructions.discover. +// RPC method: plugins.install. // -// Parameters: Optional project paths to include in instruction discovery. +// Parameters: Plugin source and optional working directory for relative-path resolution. // -// Returns: Instruction sources discovered across user, repository, and plugin sources. -func (a *ServerInstructionsAPI) Discover(ctx context.Context, params *InstructionsDiscoverRequest) (*ServerInstructionSourceList, error) { - raw, err := a.client.Request(ctx, "instructions.discover", params) +// Returns: Result of installing a plugin. +func (a *ServerPluginsAPI) Install(ctx context.Context, params *PluginsInstallRequest) (*PluginInstallResult, error) { + raw, err := a.client.Request(ctx, "plugins.install", params) if err != nil { return nil, err } - var result ServerInstructionSourceList + var result PluginInstallResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetDiscoveryPaths 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. -// -// RPC method: instructions.getDiscoveryPaths. +// Lists plugins installed in user/global state. // -// Parameters: Optional project paths to include when enumerating instruction discovery -// targets. +// RPC method: plugins.list. // -// Returns: Canonical files and directories where custom instructions can be created so the -// runtime will recognize them. -func (a *ServerInstructionsAPI) GetDiscoveryPaths(ctx context.Context, params *InstructionsGetDiscoveryPathsRequest) (*InstructionDiscoveryPathList, error) { - raw, err := a.client.Request(ctx, "instructions.getDiscoveryPaths", params) +// Returns: Plugins installed in user/global state. +func (a *ServerPluginsAPI) List(ctx context.Context) (*PluginListResult, error) { + raw, err := a.client.Request(ctx, "plugins.list", nil) if err != nil { return nil, err } - var result InstructionDiscoveryPathList + var result PluginListResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerLlmInferenceAPI contains experimental APIs that may change or be -// removed. -type ServerLlmInferenceAPI serverAPI - -// HttpResponseChunk delivers a body byte range (or a terminal transport error) for an -// in-flight response, correlated by requestId. Set `end` true on the last chunk. When -// `error` is set the response terminates with a transport-level failure and the runtime -// raises an APIConnectionError. -// -// RPC method: llmInference.httpResponseChunk. +// Uninstalls an installed plugin. // -// Parameters: A response body chunk or terminal error. +// RPC method: plugins.uninstall. // -// Returns: Whether the chunk was accepted. -func (a *ServerLlmInferenceAPI) HttpResponseChunk(ctx context.Context, params *LlmInferenceHTTPResponseChunkRequest) (*LlmInferenceHTTPResponseChunkResult, error) { - raw, err := a.client.Request(ctx, "llmInference.httpResponseChunk", params) +// Parameters: Name (or spec) of the plugin to uninstall. +func (a *ServerPluginsAPI) Uninstall(ctx context.Context, params *PluginsUninstallRequest) (*PluginsUninstallResult, error) { + raw, err := a.client.Request(ctx, "plugins.uninstall", params) if err != nil { return nil, err } - var result LlmInferenceHTTPResponseChunkResult + var result PluginsUninstallResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } - -// HttpResponseStart delivers the response head (status + headers) for an in-flight request, -// correlated by the requestId the runtime supplied in httpRequestStart. Must be called -// exactly once per request before any httpResponseChunk frames. + +// Updates an installed plugin to its latest published version. // -// RPC method: llmInference.httpResponseStart. +// RPC method: plugins.update. // -// Parameters: Response head. +// Parameters: Name (or spec) of the plugin to update. // -// Returns: Whether the start frame was accepted. -func (a *ServerLlmInferenceAPI) HttpResponseStart(ctx context.Context, params *LlmInferenceHTTPResponseStartRequest) (*LlmInferenceHTTPResponseStartResult, error) { - raw, err := a.client.Request(ctx, "llmInference.httpResponseStart", params) +// Returns: Result of updating a single plugin. +func (a *ServerPluginsAPI) Update(ctx context.Context, params *PluginsUpdateRequest) (*PluginUpdateResult, error) { + raw, err := a.client.Request(ctx, "plugins.update", params) if err != nil { return nil, err } - var result LlmInferenceHTTPResponseStartResult + var result PluginUpdateResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetProvider registers an SDK client as the LLM inference callback provider. +// UpdateAll updates every installed plugin to its latest published version. // -// RPC method: llmInference.setProvider. +// RPC method: plugins.updateAll. // -// Returns: Indicates whether the calling client was registered as the LLM inference -// provider. -func (a *ServerLlmInferenceAPI) SetProvider(ctx context.Context) (*LlmInferenceSetProviderResult, error) { - raw, err := a.client.Request(ctx, "llmInference.setProvider", nil) +// Returns: Result of updating all installed plugins. +func (a *ServerPluginsAPI) UpdateAll(ctx context.Context) (*PluginUpdateAllResult, error) { + raw, err := a.client.Request(ctx, "plugins.updateAll", nil) if err != nil { return nil, err } - var result LlmInferenceSetProviderResult + var result PluginUpdateAllResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerManagedSettingsAPI contains experimental APIs that may change or be +// Experimental: ServerPluginsBuiltinAPI contains experimental APIs that may change or be // removed. -type ServerManagedSettingsAPI serverAPI +type ServerPluginsBuiltinAPI serverAPI -// ClearCache force-refreshes enterprise managed settings for every account: wipes the -// persistent server-policy cache (the whole `/managed-settings` directory) and -// drops this runtime process's in-memory retained server policy. It does not itself fetch -// policy — the effect is that the next time a session resolves managed settings for an -// account, that resolution re-fetches the account's org policy from the network instead of -// serving a cached response. Note that `managedSettings.read` returns only device/MDM -// settings and never triggers the account server-policy fetch, so a host implementing "sync -// account policy" should start a fresh session resolution rather than treat a subsequent -// `managedSettings.read` as the refreshed org policy. Mirrors the invalidation a sign-out -// performs, broadened from the one signing-out account to all of them; device/MDM layers -// describe the machine, not the account, and are left untouched. Rejects if the on-disk -// cache cannot be removed. +// Set replaces this server's trusted built-in plugin directories while no sessions are +// active. // -// RPC method: managedSettings.clearCache. -func (a *ServerManagedSettingsAPI) ClearCache(ctx context.Context) (*ManagedSettingsClearCacheResult, error) { - raw, err := a.client.Request(ctx, "managedSettings.clearCache", nil) +// RPC method: plugins.builtin.set. +// +// Parameters: Trusted built-in plugin directories to use for this runtime process. +func (a *ServerPluginsBuiltinAPI) Set(ctx context.Context, params *PluginsBuiltinSetRequest) (*PluginsBuiltinSetResult, error) { + raw, err := a.client.Request(ctx, "plugins.builtin.set", params) if err != nil { return nil, err } - var result ManagedSettingsClearCacheResult + var result PluginsBuiltinSetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Read discovers device-managed settings from production MDM and managed-file sources, -// validates them against the runtime-owned managed-settings schema, and returns the -// canonical JSON without requiring a session. +// Experimental: Builtin returns experimental APIs that may change or be removed. +func (s *ServerPluginsAPI) Builtin() *ServerPluginsBuiltinAPI { + return (*ServerPluginsBuiltinAPI)(s) +} + +// Experimental: ServerPluginsMarketplacesAPI contains experimental APIs that may change or +// be removed. +type ServerPluginsMarketplacesAPI serverAPI + +// Add registers a new marketplace from a source (owner/repo, URL, or local path). // -// RPC method: managedSettings.read. +// RPC method: plugins.marketplaces.add. // -// Returns: Validated device-managed settings discovered before a session exists. -func (a *ServerManagedSettingsAPI) Read(ctx context.Context) (*ManagedSettingsReadResult, error) { - raw, err := a.client.Request(ctx, "managedSettings.read", nil) +// Parameters: Marketplace source and optional working directory for relative-path +// resolution. +// +// Returns: Result of registering a new marketplace. +func (a *ServerPluginsMarketplacesAPI) Add(ctx context.Context, params *PluginsMarketplacesAddRequest) (*MarketplaceAddResult, error) { + raw, err := a.client.Request(ctx, "plugins.marketplaces.add", params) if err != nil { return nil, err } - var result ManagedSettingsReadResult + var result MarketplaceAddResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerMCPAPI contains experimental APIs that may change or be removed. -type ServerMCPAPI serverAPI - -// Discovers MCP servers from user, workspace, plugin, and builtin sources. +// Browse lists plugins advertised by a registered marketplace. // -// RPC method: mcp.discover. +// RPC method: plugins.marketplaces.browse. // -// Parameters: Optional working directory used as context for MCP server discovery. +// Parameters: Name of the marketplace whose plugin catalog to fetch. // -// Returns: MCP servers discovered from user, workspace, plugin, and built-in sources. -func (a *ServerMCPAPI) Discover(ctx context.Context, params *MCPDiscoverRequest) (*MCPDiscoverResult, error) { - raw, err := a.client.Request(ctx, "mcp.discover", params) +// Returns: Plugins advertised by the marketplace. +func (a *ServerPluginsMarketplacesAPI) Browse(ctx context.Context, params *PluginsMarketplacesBrowseRequest) (*MarketplaceBrowseResult, error) { + raw, err := a.client.Request(ctx, "plugins.marketplaces.browse", params) if err != nil { return nil, err } - var result MCPDiscoverResult + var result MarketplaceBrowseResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// PlanInstall requests a side-effect-free MCP install plan from a catalog candidate handle -// or a caller-supplied card. This host-implemented server method is available through -// SDK/TUI hosts; standalone and C-ABI runtimes whose host does not implement server-method -// dispatch return JSON-RPC MethodNotFound. A runtime with planning available returns a -// normalised plan and opaque single-use plan handle; a runtime without it returns the typed -// planning-unavailable result. A completed plan reports resource identity, provenance, -// eligible transport choices, the user-scope target, required typed values and secret -// placeholders, the policy result, the configuration changes installing would make, and -// whether a reload would be needed. Planning never writes configuration, stores a secret, -// or reloads MCP servers, so abandoning a plan needs no call and leaves nothing behind. -// -// RPC method: mcp.planInstall. +// Lists all registered marketplaces (defaults + user-added). // -// Parameters: A side-effect-free request for an MCP install plan. Computing a plan never -// writes configuration, stores a secret, or reloads MCP servers. +// RPC method: plugins.marketplaces.list. // -// Returns: Outcome of an mcp.planInstall call: either a normalised plan, or one typed -// refusal. Nothing is written in either case. -func (a *ServerMCPAPI) PlanInstall(ctx context.Context, params *MCPPlanInstallRequest) (MCPPlanInstallResult, error) { - raw, err := a.client.Request(ctx, "mcp.planInstall", params) +// Returns: All registered marketplaces, including built-in defaults. +func (a *ServerPluginsMarketplacesAPI) List(ctx context.Context) (*MarketplaceListResult, error) { + raw, err := a.client.Request(ctx, "plugins.marketplaces.list", nil) if err != nil { return nil, err } - result, err := unmarshalMCPPlanInstallResult(raw) - if err != nil { + var result MarketplaceListResult + if err := json.Unmarshal(raw, &result); err != nil { return nil, err } - return result, nil + return &result, nil } -// Experimental: ServerMCPConfigAPI contains experimental APIs that may change or be removed. -type ServerMCPConfigAPI serverAPI - -// Adds an MCP server to user configuration. +// Refresh re-fetches one or all registered marketplace catalogs. // -// RPC method: mcp.config.add. +// RPC method: plugins.marketplaces.refresh. // -// Parameters: MCP server name and configuration to add to user configuration. -func (a *ServerMCPConfigAPI) Add(ctx context.Context, params *MCPConfigAddRequest) (*MCPConfigAddResult, error) { - raw, err := a.client.Request(ctx, "mcp.config.add", params) +// Parameters: Optional marketplace name; omit to refresh all. +// +// Returns: Result of refreshing one or more marketplace catalogs. +func (a *ServerPluginsMarketplacesAPI) Refresh(ctx context.Context, params *PluginsMarketplacesRefreshRequest) (*MarketplaceRefreshResult, error) { + raw, err := a.client.Request(ctx, "plugins.marketplaces.refresh", params) if err != nil { return nil, err } - var result MCPConfigAddResult + var result MarketplaceRefreshResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Disables MCP servers in user configuration for new sessions. +// Removes a previously-registered marketplace. When the marketplace has dependent plugins +// and `force` is not set, the marketplace is left intact and the result lists the +// dependents so the caller can decide whether to retry with `force=true`. // -// RPC method: mcp.config.disable. +// RPC method: plugins.marketplaces.remove. // -// Parameters: MCP server names to disable for new sessions. -func (a *ServerMCPConfigAPI) Disable(ctx context.Context, params *MCPConfigDisableRequest) (*MCPConfigDisableResult, error) { - raw, err := a.client.Request(ctx, "mcp.config.disable", params) +// Parameters: Name of the marketplace to remove and an optional force flag. +// +// Returns: Outcome of the remove attempt, including dependent-plugin info when applicable. +func (a *ServerPluginsMarketplacesAPI) Remove(ctx context.Context, params *PluginsMarketplacesRemoveRequest) (*MarketplaceRemoveResult, error) { + raw, err := a.client.Request(ctx, "plugins.marketplaces.remove", params) if err != nil { return nil, err } - var result MCPConfigDisableResult + var result MarketplaceRemoveResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Enables MCP servers in user configuration for new sessions. -// -// RPC method: mcp.config.enable. +// Experimental: Marketplaces returns experimental APIs that may change or be removed. +func (s *ServerPluginsAPI) Marketplaces() *ServerPluginsMarketplacesAPI { + return (*ServerPluginsMarketplacesAPI)(s) +} + +// Experimental: ServerRuntimeAPI contains experimental APIs that may change or be removed. +type ServerRuntimeAPI serverAPI + +// Shutdown gracefully shuts down an SDK-owned runtime. The response is sent only after +// cleanup completes; callers may then terminate the owned runtime process. // -// Parameters: MCP server names to enable for new sessions. -func (a *ServerMCPConfigAPI) Enable(ctx context.Context, params *MCPConfigEnableRequest) (*MCPConfigEnableResult, error) { - raw, err := a.client.Request(ctx, "mcp.config.enable", params) +// RPC method: runtime.shutdown. +func (a *ServerRuntimeAPI) Shutdown(ctx context.Context) (*RuntimeShutdownResult, error) { + raw, err := a.client.Request(ctx, "runtime.shutdown", nil) if err != nil { return nil, err } - var result MCPConfigEnableResult + var result RuntimeShutdownResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists MCP servers from user configuration. +// Experimental: ServerSecretsAPI contains experimental APIs that may change or be removed. +type ServerSecretsAPI serverAPI + +// AddFilterValues registers secret values for redaction in session logs and exports. The +// SDK calls this to inject dynamically generated secret values (e.g., OIDC tokens). // -// RPC method: mcp.config.list. +// RPC method: secrets.addFilterValues. // -// Returns: User-configured MCP servers, keyed by server name. -func (a *ServerMCPConfigAPI) List(ctx context.Context) (*MCPConfigList, error) { - raw, err := a.client.Request(ctx, "mcp.config.list", nil) +// Parameters: Secret values to add to the redaction filter. +// +// Returns: Confirmation that the secret values were registered. +func (a *ServerSecretsAPI) AddFilterValues(ctx context.Context, params *SecretsAddFilterValuesRequest) (*SecretsAddFilterValuesResult, error) { + raw, err := a.client.Request(ctx, "secrets.addFilterValues", params) if err != nil { return nil, err } - var result MCPConfigList + var result SecretsAddFilterValuesResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Reload drops this runtime process's in-memory MCP server-definition cache so the next MCP -// config read observes disk. +// Experimental: ServerSessionFSAPI contains experimental APIs that may change or be removed. +type ServerSessionFSAPI serverAPI + +// SetProvider registers an SDK client as the session filesystem provider. // -// RPC method: mcp.config.reload. -func (a *ServerMCPConfigAPI) Reload(ctx context.Context) (*MCPConfigReloadResult, error) { - raw, err := a.client.Request(ctx, "mcp.config.reload", nil) +// RPC method: sessionFs.setProvider. +// +// Parameters: Initial working directory, session-state path layout, and path conventions +// used to register the calling SDK client as the session filesystem provider. A registered +// provider is authoritative for path interpretation and filesystem facts used by workspace +// permission validation. Paths are interpreted lexically; home-relative paths (`~` and +// `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until +// provider-side canonicalization is supported, providers must not expose symlinks inside +// allowed roots that escape those roots. +// +// Returns: Indicates whether the calling client was registered as the session filesystem +// provider. +func (a *ServerSessionFSAPI) SetProvider(ctx context.Context, params *SessionFSSetProviderRequest) (*SessionFSSetProviderResult, error) { + raw, err := a.client.Request(ctx, "sessionFs.setProvider", params) if err != nil { return nil, err } - var result MCPConfigReloadResult + var result SessionFSSetProviderResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Removes an MCP server from user configuration. +// Experimental: ServerSessionsAPI contains experimental APIs that may change or be removed. +type ServerSessionsAPI serverAPI + +// BulkDelete closes, deactivates, and deletes a set of sessions, returning the bytes freed +// per session. // -// RPC method: mcp.config.remove. +// RPC method: sessions.bulkDelete. // -// Parameters: MCP server name to remove from user configuration. -func (a *ServerMCPConfigAPI) Remove(ctx context.Context, params *MCPConfigRemoveRequest) (*MCPConfigRemoveResult, error) { - raw, err := a.client.Request(ctx, "mcp.config.remove", params) +// Parameters: Session IDs to close, deactivate, and delete from disk. +// +// Returns: Map of sessionId -> bytes freed by removing the session's workspace directory. +func (a *ServerSessionsAPI) BulkDelete(ctx context.Context, params *SessionsBulkDeleteRequest) (*SessionBulkDeleteResult, error) { + raw, err := a.client.Request(ctx, "sessions.bulkDelete", params) if err != nil { return nil, err } - var result MCPConfigRemoveResult + var result SessionBulkDeleteResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Updates an MCP server in user configuration. +// CheckInUse returns the subset of the supplied session IDs that are currently held by +// another running process. // -// RPC method: mcp.config.update. +// RPC method: sessions.checkInUse. // -// Parameters: MCP server name and replacement configuration to write to user configuration. -func (a *ServerMCPConfigAPI) Update(ctx context.Context, params *MCPConfigUpdateRequest) (*MCPConfigUpdateResult, error) { - raw, err := a.client.Request(ctx, "mcp.config.update", params) +// Parameters: Session IDs to test for live in-use locks. +// +// Returns: Session IDs from the input set that are currently in use by another process. +func (a *ServerSessionsAPI) CheckInUse(ctx context.Context, params *SessionsCheckInUseRequest) (*SessionsCheckInUseResult, error) { + raw, err := a.client.Request(ctx, "sessions.checkInUse", params) if err != nil { return nil, err } - var result MCPConfigUpdateResult + var result SessionsCheckInUseResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Config returns experimental APIs that may change or be removed. -func (s *ServerMCPAPI) Config() *ServerMCPConfigAPI { - return (*ServerMCPConfigAPI)(s) -} - -// Experimental: ServerModelsAPI contains experimental APIs that may change or be removed. -type ServerModelsAPI serverAPI - -// GetBuiltInCatalog returns the running runtime's complete catalog of well-known built-in -// model IDs without authentication or network access. +// Closes a session: emits shutdown, flushes pending events, releases the in-use lock, and +// disposes the active session. // -// RPC method: models.getBuiltInCatalog. +// RPC method: sessions.close. // -// Returns: The running runtime's complete catalog of well-known built-in model IDs, -// including supported models and additional IDs with built-in metadata. -func (a *ServerModelsAPI) GetBuiltInCatalog(ctx context.Context) (*BuiltInModelCatalog, error) { - raw, err := a.client.Request(ctx, "models.getBuiltInCatalog", nil) +// Parameters: Session ID to close. +// +// Returns: Closes a session: emits shutdown, flushes pending events to disk, releases the +// in-use lock, disposes the active session. Idempotent: succeeds even if the session is not +// currently active. +func (a *ServerSessionsAPI) Close(ctx context.Context, params *SessionsCloseRequest) (*SessionsCloseResult, error) { + raw, err := a.client.Request(ctx, "sessions.close", params) if err != nil { return nil, err } - var result BuiltInModelCatalog + var result SessionsCloseResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists Copilot models available to the authenticated user. +// Connects to an existing remote session and exposes it as an SDK session. // -// RPC method: models.list. +// RPC method: sessions.connect. // -// Parameters: Optional opaque account selection or compatibility GitHub token used to list -// models. +// Parameters: Remote session connection parameters. // -// Returns: List of Copilot models available to the resolved user, including capabilities -// and billing metadata. -func (a *ServerModelsAPI) List(ctx context.Context, params *ModelsListRequest) (*ModelList, error) { - raw, err := a.client.Request(ctx, "models.list", params) +// Returns: Remote session connection result. +func (a *ServerSessionsAPI) Connect(ctx context.Context, params *ConnectRemoteSessionParams) (*RemoteSessionConnectionResult, error) { + raw, err := a.client.Request(ctx, "sessions.connect", params) if err != nil { return nil, err } - var result ModelList + var result RemoteSessionConnectionResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerPluginsAPI contains experimental APIs that may change or be removed. -type ServerPluginsAPI serverAPI - -// Disables installed plugins for new sessions. +// EnrichMetadata backfills missing summary and context fields on the supplied session +// metadata records. // -// RPC method: plugins.disable. +// RPC method: sessions.enrichMetadata. // -// Parameters: Plugin names (or specs) to disable, plus the optional working directory the -// repository-controlled guard is evaluated against. -func (a *ServerPluginsAPI) Disable(ctx context.Context, params *PluginsDisableRequest) (*PluginsDisableResult, error) { - raw, err := a.client.Request(ctx, "plugins.disable", params) +// Parameters: Session metadata records to enrich with summary and context information. +// +// Returns: The enriched metadata records, with summary and context fields backfilled where +// available. Sessions confirmed empty and unnamed are omitted. +func (a *ServerSessionsAPI) EnrichMetadata(ctx context.Context, params *SessionsEnrichMetadataRequest) (*SessionEnrichMetadataResult, error) { + raw, err := a.client.Request(ctx, "sessions.enrichMetadata", params) if err != nil { return nil, err } - var result PluginsDisableResult + var result SessionEnrichMetadataResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Enables installed plugins for new sessions. +// FindByPrefix resolves a UUID prefix to a unique session ID, if exactly one session +// matches. // -// RPC method: plugins.enable. +// RPC method: sessions.findByPrefix. // -// Parameters: Plugin names (or specs) to enable, plus the optional working directory the -// repository-controlled guard is evaluated against. -func (a *ServerPluginsAPI) Enable(ctx context.Context, params *PluginsEnableRequest) (*PluginsEnableResult, error) { - raw, err := a.client.Request(ctx, "plugins.enable", params) +// Parameters: UUID prefix to resolve to a unique session ID. +// +// Returns: Session ID matching the prefix, omitted when no unique match exists. +func (a *ServerSessionsAPI) FindByPrefix(ctx context.Context, params *SessionsFindByPrefixRequest) (*SessionsFindByPrefixResult, error) { + raw, err := a.client.Request(ctx, "sessions.findByPrefix", params) if err != nil { return nil, err } - var result PluginsEnableResult + var result SessionsFindByPrefixResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Installs a plugin from a marketplace, GitHub repo, URL, or local path. +// FindByTaskId finds the local session bound to a GitHub task ID, if any. // -// RPC method: plugins.install. +// RPC method: sessions.findByTaskId. // -// Parameters: Plugin source and optional working directory for relative-path resolution. +// Parameters: GitHub task ID to look up. // -// Returns: Result of installing a plugin. -func (a *ServerPluginsAPI) Install(ctx context.Context, params *PluginsInstallRequest) (*PluginInstallResult, error) { - raw, err := a.client.Request(ctx, "plugins.install", params) +// Returns: ID of the local session bound to the given GitHub task, or omitted when none. +func (a *ServerSessionsAPI) FindByTaskId(ctx context.Context, params *SessionsFindByTaskIDRequest) (*SessionsFindByTaskIDResult, error) { + raw, err := a.client.Request(ctx, "sessions.findByTaskId", params) if err != nil { return nil, err } - var result PluginInstallResult + var result SessionsFindByTaskIDResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists plugins installed in user/global state. +// Fork creates a new session by forking persisted history from an existing session. // -// RPC method: plugins.list. +// RPC method: sessions.fork. // -// Returns: Plugins installed in user/global state. -func (a *ServerPluginsAPI) List(ctx context.Context) (*PluginListResult, error) { - raw, err := a.client.Request(ctx, "plugins.list", nil) +// Parameters: Source session identifier to fork from, optional event-ID boundary, and +// optional friendly name for the new session. +// +// Returns: Identifier and optional friendly name assigned to the newly forked session. +func (a *ServerSessionsAPI) Fork(ctx context.Context, params *SessionsForkRequest) (*SessionsForkResult, error) { + raw, err := a.client.Request(ctx, "sessions.fork", params) if err != nil { return nil, err } - var result PluginListResult + var result SessionsForkResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Uninstalls an installed plugin. +// GetClientMetadata reads client-owned metadata for multiple persisted local sessions +// without opening them. Results preserve request order and report missing, corrupt, +// unsupported, or temporarily unavailable sessions independently. // -// RPC method: plugins.uninstall. +// RPC method: sessions.getClientMetadata. // -// Parameters: Name (or spec) of the plugin to uninstall. -func (a *ServerPluginsAPI) Uninstall(ctx context.Context, params *PluginsUninstallRequest) (*PluginsUninstallResult, error) { - raw, err := a.client.Request(ctx, "plugins.uninstall", params) +// Parameters: Bounded batch request for client-owned metadata from persisted local sessions. +// +// Returns: Ordered client metadata outcomes for the requested local sessions. +func (a *ServerSessionsAPI) GetClientMetadata(ctx context.Context, params *SessionsGetClientMetadataRequest) (*SessionsGetClientMetadataResult, error) { + raw, err := a.client.Request(ctx, "sessions.getClientMetadata", params) if err != nil { return nil, err } - var result PluginsUninstallResult + var result SessionsGetClientMetadataResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Updates an installed plugin to its latest published version. +// GetLastForContext returns the most-relevant prior session for a given working-directory +// context. // -// RPC method: plugins.update. +// RPC method: sessions.getLastForContext. // -// Parameters: Name (or spec) of the plugin to update. +// Parameters: Optional working-directory context used to score session relevance. // -// Returns: Result of updating a single plugin. -func (a *ServerPluginsAPI) Update(ctx context.Context, params *PluginsUpdateRequest) (*PluginUpdateResult, error) { - raw, err := a.client.Request(ctx, "plugins.update", params) +// Returns: Most-relevant session ID for the supplied context, or omitted when no sessions +// exist. +func (a *ServerSessionsAPI) GetLastForContext(ctx context.Context, params *SessionsGetLastForContextRequest) (*SessionsGetLastForContextResult, error) { + raw, err := a.client.Request(ctx, "sessions.getLastForContext", params) if err != nil { return nil, err } - var result PluginUpdateResult + var result SessionsGetLastForContextResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// UpdateAll updates every installed plugin to its latest published version. +// GetRemoteControlStatus returns the current state of the remote-control singleton, +// including the attached session id and frontend URL when active. // -// RPC method: plugins.updateAll. +// RPC method: sessions.getRemoteControlStatus. // -// Returns: Result of updating all installed plugins. -func (a *ServerPluginsAPI) UpdateAll(ctx context.Context) (*PluginUpdateAllResult, error) { - raw, err := a.client.Request(ctx, "plugins.updateAll", nil) +// Returns: Wrapper for the singleton's current status. +func (a *ServerSessionsAPI) GetRemoteControlStatus(ctx context.Context) (*RemoteControlStatusResult, error) { + raw, err := a.client.Request(ctx, "sessions.getRemoteControlStatus", nil) if err != nil { return nil, err } - var result PluginUpdateAllResult + var result RemoteControlStatusResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerPluginsBuiltinAPI contains experimental APIs that may change or be -// removed. -type ServerPluginsBuiltinAPI serverAPI - -// Set replaces this server's trusted built-in plugin directories while no sessions are -// active. +// GetSizes returns the on-disk byte size of each session's workspace directory. // -// RPC method: plugins.builtin.set. +// RPC method: sessions.getSizes. // -// Parameters: Trusted built-in plugin directories to use for this runtime process. -func (a *ServerPluginsBuiltinAPI) Set(ctx context.Context, params *PluginsBuiltinSetRequest) (*PluginsBuiltinSetResult, error) { - raw, err := a.client.Request(ctx, "plugins.builtin.set", params) +// Returns: Map of sessionId -> on-disk size in bytes for each session's workspace directory. +func (a *ServerSessionsAPI) GetSizes(ctx context.Context) (*SessionSizes, error) { + raw, err := a.client.Request(ctx, "sessions.getSizes", nil) if err != nil { return nil, err } - var result PluginsBuiltinSetResult + var result SessionSizes if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Builtin returns experimental APIs that may change or be removed. -func (s *ServerPluginsAPI) Builtin() *ServerPluginsBuiltinAPI { - return (*ServerPluginsBuiltinAPI)(s) -} - -// Experimental: ServerPluginsMarketplacesAPI contains experimental APIs that may change or -// be removed. -type ServerPluginsMarketplacesAPI serverAPI - -// Add registers a new marketplace from a source (owner/repo, URL, or local path). +// Lists sessions, optionally filtered by source and working-directory context. Returned +// entries are discriminated by `isRemote`: local entries carry only the lightweight +// `LocalSessionMetadataValue` shape; remote entries carry the full +// `RemoteSessionMetadataValue` shape (repository, PR number, taskType, etc.). // -// RPC method: plugins.marketplaces.add. +// RPC method: sessions.list. // -// Parameters: Marketplace source and optional working directory for relative-path -// resolution. +// Parameters: Optional source filter, metadata-load limit, and context filter applied to +// the returned sessions. // -// Returns: Result of registering a new marketplace. -func (a *ServerPluginsMarketplacesAPI) Add(ctx context.Context, params *PluginsMarketplacesAddRequest) (*MarketplaceAddResult, error) { - raw, err := a.client.Request(ctx, "plugins.marketplaces.add", params) +// Returns: Sessions matching the filter, ordered most-recently-modified first. +func (a *ServerSessionsAPI) List(ctx context.Context, params *SessionsListRequest) (*SessionList, error) { + raw, err := a.client.Request(ctx, "sessions.list", params) if err != nil { return nil, err } - var result MarketplaceAddResult + var result SessionList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Browse lists plugins advertised by a registered marketplace. +// LoadDeferredRepoHooks loads previously-deferred repo-level hooks on the active session, +// returning queued startup prompts. // -// RPC method: plugins.marketplaces.browse. +// RPC method: sessions.loadDeferredRepoHooks. // -// Parameters: Name of the marketplace whose plugin catalog to fetch. +// Parameters: Active session ID whose deferred repo-level hooks should be loaded. // -// Returns: Plugins advertised by the marketplace. -func (a *ServerPluginsMarketplacesAPI) Browse(ctx context.Context, params *PluginsMarketplacesBrowseRequest) (*MarketplaceBrowseResult, error) { - raw, err := a.client.Request(ctx, "plugins.marketplaces.browse", params) +// Returns: Queued repo-level startup prompts and the total hook command count after loading. +func (a *ServerSessionsAPI) LoadDeferredRepoHooks(ctx context.Context, params *SessionsLoadDeferredRepoHooksRequest) (*SessionLoadDeferredRepoHooksResult, error) { + raw, err := a.client.Request(ctx, "sessions.loadDeferredRepoHooks", params) if err != nil { return nil, err } - var result MarketplaceBrowseResult + var result SessionLoadDeferredRepoHooksResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists all registered marketplaces (defaults + user-added). +// Open creates or resumes a local session and returns the opened session ID. // -// RPC method: plugins.marketplaces.list. +// RPC method: sessions.open. // -// Returns: All registered marketplaces, including built-in defaults. -func (a *ServerPluginsMarketplacesAPI) List(ctx context.Context) (*MarketplaceListResult, error) { - raw, err := a.client.Request(ctx, "plugins.marketplaces.list", nil) +// Parameters: Open a session by creating, resuming, attaching, connecting to a remote, or +// handing off. +// +// Returns: Result of opening a session. +func (a *ServerSessionsAPI) Open(ctx context.Context, params *SessionOpenParams) (*SessionOpenResult, error) { + raw, err := a.client.Request(ctx, "sessions.open", params) if err != nil { return nil, err } - var result MarketplaceListResult + var result SessionOpenResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Refresh re-fetches one or all registered marketplace catalogs. +// PruneOld deletes sessions older than the given threshold, with optional dry-run and +// exclusion list. // -// RPC method: plugins.marketplaces.refresh. +// RPC method: sessions.pruneOld. // -// Parameters: Optional marketplace name; omit to refresh all. +// Parameters: Age threshold and optional flags controlling which old sessions are pruned +// (or simulated when dryRun is true). // -// Returns: Result of refreshing one or more marketplace catalogs. -func (a *ServerPluginsMarketplacesAPI) Refresh(ctx context.Context, params *PluginsMarketplacesRefreshRequest) (*MarketplaceRefreshResult, error) { - raw, err := a.client.Request(ctx, "plugins.marketplaces.refresh", params) +// Returns: Outcome of the prune operation: deleted IDs, dry-run candidates, skipped IDs, +// total bytes freed, and the dry-run flag. +func (a *ServerSessionsAPI) PruneOld(ctx context.Context, params *SessionsPruneOldRequest) (*SessionPruneResult, error) { + raw, err := a.client.Request(ctx, "sessions.pruneOld", params) if err != nil { return nil, err } - var result MarketplaceRefreshResult + var result SessionPruneResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Removes a previously-registered marketplace. When the marketplace has dependent plugins -// and `force` is not set, the marketplace is left intact and the result lists the -// dependents so the caller can decide whether to retry with `force=true`. +// ReadPersistedEvents reads a page of durable events directly from a local session's +// persisted journal without creating, resuming, or activating the session. The first read +// pins the currently opened journal generation and its byte-length boundary; opaque cursor +// continuations remain on that generation across runtime-owned compaction, truncation, and +// rewrite operations, which replace the live path atomically, and events appended after the +// boundary are excluded. For cold hydration, await the first successful page before +// activation and establish lossless live-event buffering before resume; merge subsequent +// live events by ID, preserving persisted order and letting live payloads win. +// Continuations are process-local, single-use capabilities bound to the originating session +// and storage context and must be paged sequentially; concurrent or repeated use of the +// same cursor expires that duplicate read rather than reading the generation twice. A +// complete snapshot has cursorStatus 'ok' and hasMore false. Snapshots expire after five +// idle minutes, with at most eight retained per process and idle-only eviction under +// pressure; completion and cancelled-worker exit release their handles. No transcript copy +// is created, but retained handles may keep replaced files' disk blocks alive until +// release. Pages have a soft 1 MiB serialized event-array budget including resolved binary +// assets; one oversized event is returned alone to guarantee progress. Working memory also +// includes a record/lookahead and asset resolution; resolving the first binary reference +// may scan the full pinned generation to build a bounded offset index. If the snapshot +// expires, is evicted, is cancelled before a continuation is established, or becomes +// unreadable after an observable unsupported in-place shortening, the continuation returns +// cursorStatus 'expired' with an empty terminal page and never falls back to a different +// generation. A missing or initially unreadable journal is an RPC error. Persisted history +// excludes ephemeral events and may omit payloads that are reconstructed only for an active +// session; use the active session event stream for post-resume live events. // -// RPC method: plugins.marketplaces.remove. +// RPC method: sessions.readPersistedEvents. // -// Parameters: Name of the marketplace to remove and an optional force flag. +// Parameters: Pagination options for reading an inactive or active local session's +// persisted event journal. // -// Returns: Outcome of the remove attempt, including dependent-plugin info when applicable. -func (a *ServerPluginsMarketplacesAPI) Remove(ctx context.Context, params *PluginsMarketplacesRemoveRequest) (*MarketplaceRemoveResult, error) { - raw, err := a.client.Request(ctx, "plugins.marketplaces.remove", params) +// Returns: Batch of session events returned by a read, with cursor and continuation +// metadata. +func (a *ServerSessionsAPI) ReadPersistedEvents(ctx context.Context, params *SessionsReadPersistedEventsRequest) (*EventsReadResult, error) { + raw, err := a.client.Request(ctx, "sessions.readPersistedEvents", params) if err != nil { return nil, err } - var result MarketplaceRemoveResult + var result EventsReadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Marketplaces returns experimental APIs that may change or be removed. -func (s *ServerPluginsAPI) Marketplaces() *ServerPluginsMarketplacesAPI { - return (*ServerPluginsMarketplacesAPI)(s) -} - -// Experimental: ServerRuntimeAPI contains experimental APIs that may change or be removed. -type ServerRuntimeAPI serverAPI - -// Shutdown gracefully shuts down an SDK-owned runtime. The response is sent only after -// cleanup completes; callers may then terminate the owned runtime process. +// ReleaseLock releases the in-use lock held by this process for a session. // -// RPC method: runtime.shutdown. -func (a *ServerRuntimeAPI) Shutdown(ctx context.Context) (*RuntimeShutdownResult, error) { - raw, err := a.client.Request(ctx, "runtime.shutdown", nil) +// RPC method: sessions.releaseLock. +// +// Parameters: Session ID whose in-use lock should be released. +// +// Returns: Release the in-use lock held by this process for the given session. No-op when +// this process does not currently hold a lock for the session. +func (a *ServerSessionsAPI) ReleaseLock(ctx context.Context, params *SessionsReleaseLockRequest) (*SessionsReleaseLockResult, error) { + raw, err := a.client.Request(ctx, "sessions.releaseLock", params) if err != nil { return nil, err } - var result RuntimeShutdownResult + var result SessionsReleaseLockResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerSecretsAPI contains experimental APIs that may change or be removed. -type ServerSecretsAPI serverAPI - -// AddFilterValues registers secret values for redaction in session logs and exports. The -// SDK calls this to inject dynamically generated secret values (e.g., OIDC tokens). +// ReloadPluginHooks reloads user, plugin, and (optionally) repo hooks on the active session. // -// RPC method: secrets.addFilterValues. +// RPC method: sessions.reloadPluginHooks. // -// Parameters: Secret values to add to the redaction filter. +// Parameters: Active session ID and an optional flag for deferring repo-level hooks until +// folder trust. // -// Returns: Confirmation that the secret values were registered. -func (a *ServerSecretsAPI) AddFilterValues(ctx context.Context, params *SecretsAddFilterValuesRequest) (*SecretsAddFilterValuesResult, error) { - raw, err := a.client.Request(ctx, "secrets.addFilterValues", params) +// Returns: Reload all hooks (user, plugin, optionally repo) and apply them to the active +// session. Call after installing or removing plugins so their hooks take effect +// immediately. No-op when no active session matches the given sessionId. +func (a *ServerSessionsAPI) ReloadPluginHooks(ctx context.Context, params *SessionsReloadPluginHooksRequest) (*SessionsReloadPluginHooksResult, error) { + raw, err := a.client.Request(ctx, "sessions.reloadPluginHooks", params) if err != nil { return nil, err } - var result SecretsAddFilterValuesResult + var result SessionsReloadPluginHooksResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerSessionFSAPI contains experimental APIs that may change or be removed. -type ServerSessionFSAPI serverAPI - -// SetProvider registers an SDK client as the session filesystem provider. +// Save flushes a session's pending events to disk. // -// RPC method: sessionFs.setProvider. +// RPC method: sessions.save. // -// Parameters: Initial working directory, session-state path layout, and path conventions -// used to register the calling SDK client as the session filesystem provider. +// Parameters: Session ID whose pending events should be flushed to disk. // -// Returns: Indicates whether the calling client was registered as the session filesystem -// provider. -func (a *ServerSessionFSAPI) SetProvider(ctx context.Context, params *SessionFSSetProviderRequest) (*SessionFSSetProviderResult, error) { - raw, err := a.client.Request(ctx, "sessionFs.setProvider", params) +// Returns: Flush a session's pending events to disk. No-op when no writer exists for the +// session (e.g., already closed). +func (a *ServerSessionsAPI) Save(ctx context.Context, params *SessionsSaveRequest) (*SessionsSaveResult, error) { + raw, err := a.client.Request(ctx, "sessions.save", params) if err != nil { return nil, err } - var result SessionFSSetProviderResult + var result SessionsSaveResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerSessionsAPI contains experimental APIs that may change or be removed. -type ServerSessionsAPI serverAPI - -// BulkDelete closes, deactivates, and deletes a set of sessions, returning the bytes freed -// per session. +// SetAdditionalPlugins replaces the manager-wide additional plugins registered with the +// session manager. // -// RPC method: sessions.bulkDelete. +// RPC method: sessions.setAdditionalPlugins. // -// Parameters: Session IDs to close, deactivate, and delete from disk. +// Parameters: Manager-wide additional plugins to register; replaces any +// previously-configured set. // -// Returns: Map of sessionId -> bytes freed by removing the session's workspace directory. -func (a *ServerSessionsAPI) BulkDelete(ctx context.Context, params *SessionsBulkDeleteRequest) (*SessionBulkDeleteResult, error) { - raw, err := a.client.Request(ctx, "sessions.bulkDelete", params) +// Returns: Replace the manager-wide additional plugins. New session creations and +// subsequent hook reloads see the new set; already-running sessions keep their existing +// hook installation until the next reload. +func (a *ServerSessionsAPI) SetAdditionalPlugins(ctx context.Context, params *SessionsSetAdditionalPluginsRequest) (*SessionsSetAdditionalPluginsResult, error) { + raw, err := a.client.Request(ctx, "sessions.setAdditionalPlugins", params) if err != nil { return nil, err } - var result SessionBulkDeleteResult + var result SessionsSetAdditionalPluginsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// CheckInUse returns the subset of the supplied session IDs that are currently held by -// another running process. +// SetRemoteControlSteering patches the steering state of the active remote-control +// singleton. When remote control is off, this is a no-op and the off status is returned. +// Today only `enabled: true` is actionable on the underlying exporter; passing `false` is +// reserved for future use. // -// RPC method: sessions.checkInUse. +// RPC method: sessions.setRemoteControlSteering. // -// Parameters: Session IDs to test for live in-use locks. +// Parameters: Patch for the singleton's steering state. // -// Returns: Session IDs from the input set that are currently in use by another process. -func (a *ServerSessionsAPI) CheckInUse(ctx context.Context, params *SessionsCheckInUseRequest) (*SessionsCheckInUseResult, error) { - raw, err := a.client.Request(ctx, "sessions.checkInUse", params) +// Returns: Wrapper for the singleton's current status. +func (a *ServerSessionsAPI) SetRemoteControlSteering(ctx context.Context, params *SessionsSetRemoteControlSteeringRequest) (*RemoteControlStatusResult, error) { + raw, err := a.client.Request(ctx, "sessions.setRemoteControlSteering", params) if err != nil { return nil, err } - var result SessionsCheckInUseResult + var result RemoteControlStatusResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Closes a session: emits shutdown, flushes pending events, releases the in-use lock, and -// disposes the active session. +// StartRemoteControl attaches the runtime-managed remote-control singleton to a session, +// awaiting initial setup. If remote control is already attached to a different session, the +// singleton is transferred (preserving the underlying Mission Control connection). Returns +// the final status. // -// RPC method: sessions.close. +// RPC method: sessions.startRemoteControl. // -// Parameters: Session ID to close. +// Parameters: Parameters for attaching the remote-control singleton to a session. // -// Returns: Closes a session: emits shutdown, flushes pending events to disk, releases the -// in-use lock, disposes the active session. Idempotent: succeeds even if the session is not -// currently active. -func (a *ServerSessionsAPI) Close(ctx context.Context, params *SessionsCloseRequest) (*SessionsCloseResult, error) { - raw, err := a.client.Request(ctx, "sessions.close", params) +// Returns: Wrapper for the singleton's current status. +func (a *ServerSessionsAPI) StartRemoteControl(ctx context.Context, params *SessionsStartRemoteControlRequest) (*RemoteControlStatusResult, error) { + raw, err := a.client.Request(ctx, "sessions.startRemoteControl", params) if err != nil { return nil, err } - var result SessionsCloseResult + var result RemoteControlStatusResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Connects to an existing remote session and exposes it as an SDK session. +// StopRemoteControl stops the remote-control singleton. When `expectedSessionId` is +// provided and does not match the singleton's current `attachedSessionId`, the stop is +// rejected with `stopped: false` and the current status is returned unchanged (unless +// `force` is set, in which case the singleton is unconditionally torn down). // -// RPC method: sessions.connect. +// RPC method: sessions.stopRemoteControl. // -// Parameters: Remote session connection parameters. +// Parameters: Parameters for stopping the remote-control singleton. // -// Returns: Remote session connection result. -func (a *ServerSessionsAPI) Connect(ctx context.Context, params *ConnectRemoteSessionParams) (*RemoteSessionConnectionResult, error) { - raw, err := a.client.Request(ctx, "sessions.connect", params) +// Returns: Outcome of a stopRemoteControl call. +func (a *ServerSessionsAPI) StopRemoteControl(ctx context.Context, params *SessionsStopRemoteControlRequest) (*RemoteControlStopResult, error) { + raw, err := a.client.Request(ctx, "sessions.stopRemoteControl", params) if err != nil { return nil, err } - var result RemoteSessionConnectionResult + var result RemoteControlStopResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// EnrichMetadata backfills missing summary and context fields on the supplied session -// metadata records. +// TransferRemoteControl atomically rebinds the remote-control singleton to a different +// session, preserving the underlying Mission Control connection. When +// `expectedFromSessionId` is provided and does not match the singleton's current +// `attachedSessionId`, the transfer is rejected with `transferred: false` and the current +// status is returned unchanged. // -// RPC method: sessions.enrichMetadata. +// RPC method: sessions.transferRemoteControl. // -// Parameters: Session metadata records to enrich with summary and context information. +// Parameters: Parameters for atomically rebinding the remote-control singleton. // -// Returns: The enriched metadata records, with summary and context fields backfilled where -// available. Sessions confirmed empty and unnamed are omitted. -func (a *ServerSessionsAPI) EnrichMetadata(ctx context.Context, params *SessionsEnrichMetadataRequest) (*SessionEnrichMetadataResult, error) { - raw, err := a.client.Request(ctx, "sessions.enrichMetadata", params) +// Returns: Outcome of a transferRemoteControl call. +func (a *ServerSessionsAPI) TransferRemoteControl(ctx context.Context, params *SessionsTransferRemoteControlRequest) (*RemoteControlTransferResult, error) { + raw, err := a.client.Request(ctx, "sessions.transferRemoteControl", params) if err != nil { return nil, err } - var result SessionEnrichMetadataResult + var result RemoteControlTransferResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// FindByPrefix resolves a UUID prefix to a unique session ID, if exactly one session -// matches. +// Experimental: ServerSkillsAPI contains experimental APIs that may change or be removed. +type ServerSkillsAPI serverAPI + +// Discovers skills across global and project sources. // -// RPC method: sessions.findByPrefix. +// RPC method: skills.discover. // -// Parameters: UUID prefix to resolve to a unique session ID. +// Parameters: Optional project paths and additional skill directories to include in +// discovery. // -// Returns: Session ID matching the prefix, omitted when no unique match exists. -func (a *ServerSessionsAPI) FindByPrefix(ctx context.Context, params *SessionsFindByPrefixRequest) (*SessionsFindByPrefixResult, error) { - raw, err := a.client.Request(ctx, "sessions.findByPrefix", params) +// Returns: Skills discovered across global and project sources. +func (a *ServerSkillsAPI) Discover(ctx context.Context, params *SkillsDiscoverRequest) (*ServerSkillList, error) { + raw, err := a.client.Request(ctx, "skills.discover", params) if err != nil { return nil, err } - var result SessionsFindByPrefixResult + var result ServerSkillList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// FindByTaskId finds the local session bound to a GitHub task ID, if any. +// GetDiscoveryPaths returns the canonical directories where a client may create skills that +// the runtime will recognize, including ones that do not exist yet. Project directories +// become active once created. // -// RPC method: sessions.findByTaskId. +// RPC method: skills.getDiscoveryPaths. // -// Parameters: GitHub task ID to look up. +// Parameters: Optional project paths to enumerate. // -// Returns: ID of the local session bound to the given GitHub task, or omitted when none. -func (a *ServerSessionsAPI) FindByTaskId(ctx context.Context, params *SessionsFindByTaskIDRequest) (*SessionsFindByTaskIDResult, error) { - raw, err := a.client.Request(ctx, "sessions.findByTaskId", params) +// Returns: Canonical locations where skills can be created so the runtime will recognize +// them. +func (a *ServerSkillsAPI) GetDiscoveryPaths(ctx context.Context, params *SkillsGetDiscoveryPathsRequest) (*SkillDiscoveryPathList, error) { + raw, err := a.client.Request(ctx, "skills.getDiscoveryPaths", params) if err != nil { return nil, err } - var result SessionsFindByTaskIDResult + var result SkillDiscoveryPathList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Fork creates a new session by forking persisted history from an existing session. -// -// RPC method: sessions.fork. +// Experimental: ServerSkillsConfigAPI contains experimental APIs that may change or be +// removed. +type ServerSkillsConfigAPI serverAPI + +// SetDisabledSkills replaces the global list of disabled skills. // -// Parameters: Source session identifier to fork from, optional event-ID boundary, and -// optional friendly name for the new session. +// RPC method: skills.config.setDisabledSkills. // -// Returns: Identifier and optional friendly name assigned to the newly forked session. -func (a *ServerSessionsAPI) Fork(ctx context.Context, params *SessionsForkRequest) (*SessionsForkResult, error) { - raw, err := a.client.Request(ctx, "sessions.fork", params) +// Parameters: Skill names to mark as disabled in global configuration, replacing any +// previous list. +func (a *ServerSkillsConfigAPI) SetDisabledSkills(ctx context.Context, params *SkillsConfigSetDisabledSkillsRequest) (*SkillsConfigSetDisabledSkillsResult, error) { + raw, err := a.client.Request(ctx, "skills.config.setDisabledSkills", params) if err != nil { return nil, err } - var result SessionsForkResult + var result SkillsConfigSetDisabledSkillsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetClientMetadata reads client-owned metadata for multiple persisted local sessions -// without opening them. Results preserve request order and report missing, corrupt, -// unsupported, or temporarily unavailable sessions independently. -// -// RPC method: sessions.getClientMetadata. +// SetSkillDisabled atomically adds or removes one skill from the disabled list. // -// Parameters: Bounded batch request for client-owned metadata from persisted local sessions. +// RPC method: skills.config.setSkillDisabled. // -// Returns: Ordered client metadata outcomes for the requested local sessions. -func (a *ServerSessionsAPI) GetClientMetadata(ctx context.Context, params *SessionsGetClientMetadataRequest) (*SessionsGetClientMetadataResult, error) { - raw, err := a.client.Request(ctx, "sessions.getClientMetadata", params) +// Parameters: Adds or removes a single skill from the global disabled list, leaving every +// other entry untouched. +func (a *ServerSkillsConfigAPI) SetSkillDisabled(ctx context.Context, params *SkillsConfigSetSkillDisabledRequest) (*SkillsConfigSetSkillDisabledResult, error) { + raw, err := a.client.Request(ctx, "skills.config.setSkillDisabled", params) if err != nil { return nil, err } - var result SessionsGetClientMetadataResult + var result SkillsConfigSetSkillDisabledResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetLastForContext returns the most-relevant prior session for a given working-directory -// context. +// Experimental: Config returns experimental APIs that may change or be removed. +func (s *ServerSkillsAPI) Config() *ServerSkillsConfigAPI { + return (*ServerSkillsConfigAPI)(s) +} + +// Experimental: ServerToolsAPI contains experimental APIs that may change or be removed. +type ServerToolsAPI serverAPI + +// Lists built-in tools available for a model. // -// RPC method: sessions.getLastForContext. +// RPC method: tools.list. // -// Parameters: Optional working-directory context used to score session relevance. +// Parameters: Optional model identifier whose tool overrides should be applied to the +// listing. // -// Returns: Most-relevant session ID for the supplied context, or omitted when no sessions -// exist. -func (a *ServerSessionsAPI) GetLastForContext(ctx context.Context, params *SessionsGetLastForContextRequest) (*SessionsGetLastForContextResult, error) { - raw, err := a.client.Request(ctx, "sessions.getLastForContext", params) +// Returns: Built-in tools available for the requested model, with their parameters and +// instructions. +func (a *ServerToolsAPI) List(ctx context.Context, params *ToolsListRequest) (*ToolList, error) { + raw, err := a.client.Request(ctx, "tools.list", params) if err != nil { return nil, err } - var result SessionsGetLastForContextResult + var result ToolList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetRemoteControlStatus returns the current state of the remote-control singleton, -// including the attached session id and frontend URL when active. +// Experimental: ServerUserAPI contains experimental APIs that may change or be removed. +type ServerUserAPI serverAPI + +// Experimental: ServerUserSettingsAPI contains experimental APIs that may change or be +// removed. +type ServerUserSettingsAPI serverAPI + +// Get lists every known user setting (settings.json overlaid with the legacy config.json, +// config.json wins), each with its effective value, its default, and whether it is at the +// default — so settings the user has never set still appear with their default value. Does +// not include repository- or enterprise-managed overrides that the runtime layers on top at +// session time. // -// RPC method: sessions.getRemoteControlStatus. +// RPC method: user.settings.get. // -// Returns: Wrapper for the singleton's current status. -func (a *ServerSessionsAPI) GetRemoteControlStatus(ctx context.Context) (*RemoteControlStatusResult, error) { - raw, err := a.client.Request(ctx, "sessions.getRemoteControlStatus", nil) +// Returns: Per-key metadata for every known user setting (settings.json overlaid with the +// legacy config.json, config.json wins), including settings left at their default. Excludes +// repository- and enterprise-managed overrides. +func (a *ServerUserSettingsAPI) Get(ctx context.Context) (*UserSettingsGetResult, error) { + raw, err := a.client.Request(ctx, "user.settings.get", nil) if err != nil { return nil, err } - var result RemoteControlStatusResult + var result UserSettingsGetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetSizes returns the on-disk byte size of each session's workspace directory. -// -// RPC method: sessions.getSizes. +// Reload drops this runtime process's in-memory user settings cache so the next settings +// read observes disk. // -// Returns: Map of sessionId -> on-disk size in bytes for each session's workspace directory. -func (a *ServerSessionsAPI) GetSizes(ctx context.Context) (*SessionSizes, error) { - raw, err := a.client.Request(ctx, "sessions.getSizes", nil) +// RPC method: user.settings.reload. +func (a *ServerUserSettingsAPI) Reload(ctx context.Context) (*UserSettingsReloadResult, error) { + raw, err := a.client.Request(ctx, "user.settings.reload", nil) if err != nil { return nil, err } - var result SessionSizes + var result UserSettingsReloadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists sessions, optionally filtered by source and working-directory context. Returned -// entries are discriminated by `isRemote`: local entries carry only the lightweight -// `LocalSessionMetadataValue` shape; remote entries carry the full -// `RemoteSessionMetadataValue` shape (repository, PR number, taskType, etc.). +// Set writes one or more user settings to settings.json, replacing each provided top-level +// key. A key whose value is null is removed. Returns the keys whose new value is shadowed +// by a legacy config.json entry (config.json wins on read), which the runtime leaves in +// place — such writes do not take effect until the legacy value is removed. // -// RPC method: sessions.list. +// RPC method: user.settings.set. // -// Parameters: Optional source filter, metadata-load limit, and context filter applied to -// the returned sessions. +// Parameters: 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. // -// Returns: Sessions matching the filter, ordered most-recently-modified first. -func (a *ServerSessionsAPI) List(ctx context.Context, params *SessionsListRequest) (*SessionList, error) { - raw, err := a.client.Request(ctx, "sessions.list", params) +// Returns: Outcome of writing user settings. +func (a *ServerUserSettingsAPI) Set(ctx context.Context, params *UserSettingsSetRequest) (*UserSettingsSetResult, error) { + raw, err := a.client.Request(ctx, "user.settings.set", params) if err != nil { return nil, err } - var result SessionList + var result UserSettingsSetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// LoadDeferredRepoHooks loads previously-deferred repo-level hooks on the active session, -// returning queued startup prompts. +// Experimental: Settings returns experimental APIs that may change or be removed. +func (s *ServerUserAPI) Settings() *ServerUserSettingsAPI { + return (*ServerUserSettingsAPI)(s) +} + +// ServerRPC provides typed server-scoped RPC methods. +type ServerRPC struct { + // Reuse a single struct instead of allocating one for each service on the heap. + common serverAPI + + Account *ServerAccountAPI + AgentRegistry *ServerAgentRegistryAPI + Agents *ServerAgentsAPI + Catalog *ServerCatalogAPI + Commands *ServerCommandsAPI + Extensions *ServerExtensionsAPI + Hooks *ServerHooksAPI + Instructions *ServerInstructionsAPI + LlmInference *ServerLlmInferenceAPI + ManagedSettings *ServerManagedSettingsAPI + MCP *ServerMCPAPI + Models *ServerModelsAPI + Plugins *ServerPluginsAPI + Runtime *ServerRuntimeAPI + Secrets *ServerSecretsAPI + SessionFS *ServerSessionFSAPI + Sessions *ServerSessionsAPI + Skills *ServerSkillsAPI + Tools *ServerToolsAPI + User *ServerUserAPI +} + +// Ping checks server responsiveness and returns protocol information. // -// RPC method: sessions.loadDeferredRepoHooks. +// RPC method: ping. // -// Parameters: Active session ID whose deferred repo-level hooks should be loaded. +// Parameters: Optional message to echo back to the caller. // -// Returns: Queued repo-level startup prompts and the total hook command count after loading. -func (a *ServerSessionsAPI) LoadDeferredRepoHooks(ctx context.Context, params *SessionsLoadDeferredRepoHooksRequest) (*SessionLoadDeferredRepoHooksResult, error) { - raw, err := a.client.Request(ctx, "sessions.loadDeferredRepoHooks", params) +// Returns: Server liveness response, including the echoed message, current server +// timestamp, and protocol version. +// Experimental: Ping is an experimental API and may change or be removed in future versions. +func (a *ServerRPC) Ping(ctx context.Context, params *PingRequest) (*PingResult, error) { + raw, err := a.common.client.Request(ctx, "ping", params) if err != nil { return nil, err } - var result SessionLoadDeferredRepoHooksResult + var result PingResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Open creates or resumes a local session and returns the opened session ID. -// -// RPC method: sessions.open. -// -// Parameters: Open a session by creating, resuming, attaching, connecting to a remote, or -// handing off. +// RegisterExtensionLaunchProvider registers the calling SDK client as the per-entrypoint +// extension launch provider. Call before creating any sessions. When omitted, the runtime +// uses its built-in extension launcher. // -// Returns: Result of opening a session. -func (a *ServerSessionsAPI) Open(ctx context.Context, params *SessionOpenParams) (*SessionOpenResult, error) { - raw, err := a.client.Request(ctx, "sessions.open", params) +// RPC method: registerExtensionLaunchProvider. +// Experimental: RegisterExtensionLaunchProvider is an experimental API and may change or be +// removed in future versions. +func (a *ServerRPC) RegisterExtensionLaunchProvider(ctx context.Context) (*RegisterExtensionLaunchProviderResult, error) { + raw, err := a.common.client.Request(ctx, "registerExtensionLaunchProvider", nil) if err != nil { return nil, err } - var result SessionOpenResult + var result RegisterExtensionLaunchProviderResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// PruneOld deletes sessions older than the given threshold, with optional dry-run and -// exclusion list. -// -// RPC method: sessions.pruneOld. +func NewServerRPC(client *jsonrpc2.Client) *ServerRPC { + r := &ServerRPC{} + r.common = serverAPI{client: client} + r.Account = (*ServerAccountAPI)(&r.common) + r.AgentRegistry = (*ServerAgentRegistryAPI)(&r.common) + r.Agents = (*ServerAgentsAPI)(&r.common) + r.Catalog = (*ServerCatalogAPI)(&r.common) + r.Commands = (*ServerCommandsAPI)(&r.common) + r.Extensions = (*ServerExtensionsAPI)(&r.common) + r.Hooks = (*ServerHooksAPI)(&r.common) + r.Instructions = (*ServerInstructionsAPI)(&r.common) + r.LlmInference = (*ServerLlmInferenceAPI)(&r.common) + r.ManagedSettings = (*ServerManagedSettingsAPI)(&r.common) + r.MCP = (*ServerMCPAPI)(&r.common) + r.Models = (*ServerModelsAPI)(&r.common) + r.Plugins = (*ServerPluginsAPI)(&r.common) + r.Runtime = (*ServerRuntimeAPI)(&r.common) + r.Secrets = (*ServerSecretsAPI)(&r.common) + r.SessionFS = (*ServerSessionFSAPI)(&r.common) + r.Sessions = (*ServerSessionsAPI)(&r.common) + r.Skills = (*ServerSkillsAPI)(&r.common) + r.Tools = (*ServerToolsAPI)(&r.common) + r.User = (*ServerUserAPI)(&r.common) + return r +} + +type internalServerAPI struct { + client *jsonrpc2.Client +} + +// Experimental: InternalServerSessionsAPI contains experimental APIs that may change or be +// removed. +type InternalServerSessionsAPI internalServerAPI + +// ConfigureSessionExtensions attaches (or detaches) an in-process ExtensionController +// delegate for the given session in a local host adapter. Pass `controller: undefined` to +// detach. Internal because the controller cannot cross the JSON-RPC boundary; the runtime +// manages its own session extension service. // -// Parameters: Age threshold and optional flags controlling which old sessions are pruned -// (or simulated when dryRun is true). +// RPC method: sessions.configureSessionExtensions. // -// Returns: Outcome of the prune operation: deleted IDs, dry-run candidates, skipped IDs, -// total bytes freed, and the dry-run flag. -func (a *ServerSessionsAPI) PruneOld(ctx context.Context, params *SessionsPruneOldRequest) (*SessionPruneResult, error) { - raw, err := a.client.Request(ctx, "sessions.pruneOld", params) +// Parameters: Params to attach or detach an in-process ExtensionController delegate. +// Internal: ConfigureSessionExtensions is part of the SDK's internal handshake/plumbing; +// external callers should not use it. +func (a *InternalServerSessionsAPI) ConfigureSessionExtensions(ctx context.Context, params *ConfigureSessionExtensionsParams) (*SessionsConfigureSessionExtensionsResult, error) { + raw, err := a.client.Request(ctx, "sessions.configureSessionExtensions", params) if err != nil { return nil, err } - var result SessionPruneResult + var result SessionsConfigureSessionExtensionsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ReadPersistedEvents reads a page of durable events directly from a local session's -// persisted journal without creating, resuming, or activating the session. The first read -// pins the currently opened journal generation and its byte-length boundary; opaque cursor -// continuations remain on that generation across runtime-owned compaction, truncation, and -// rewrite operations, which replace the live path atomically, and events appended after the -// boundary are excluded. For cold hydration, await the first successful page before -// activation and establish lossless live-event buffering before resume; merge subsequent -// live events by ID, preserving persisted order and letting live payloads win. -// Continuations are process-local, single-use capabilities bound to the originating session -// and storage context and must be paged sequentially; concurrent or repeated use of the -// same cursor expires that duplicate read rather than reading the generation twice. A -// complete snapshot has cursorStatus 'ok' and hasMore false. Snapshots expire after five -// idle minutes, with at most eight retained per process and idle-only eviction under -// pressure; completion and cancelled-worker exit release their handles. No transcript copy -// is created, but retained handles may keep replaced files' disk blocks alive until -// release. Pages have a soft 1 MiB serialized event-array budget including resolved binary -// assets; one oversized event is returned alone to guarantee progress. Working memory also -// includes a record/lookahead and asset resolution; resolving the first binary reference -// may scan the full pinned generation to build a bounded offset index. If the snapshot -// expires, is evicted, is cancelled before a continuation is established, or becomes -// unreadable after an observable unsupported in-place shortening, the continuation returns -// cursorStatus 'expired' with an empty terminal page and never falls back to a different -// generation. A missing or initially unreadable journal is an RPC error. Persisted history -// excludes ephemeral events and may omit payloads that are reconstructed only for an active -// session; use the active session event stream for post-resume live events. -// -// RPC method: sessions.readPersistedEvents. +// Deletes one local session from disk after running the same lifecycle hooks as the session +// manager. // -// Parameters: Pagination options for reading an inactive or active local session's -// persisted event journal. +// RPC method: sessions.delete. // -// Returns: Batch of session events returned by a read, with cursor and continuation -// metadata. -func (a *ServerSessionsAPI) ReadPersistedEvents(ctx context.Context, params *SessionsReadPersistedEventsRequest) (*EventsReadResult, error) { - raw, err := a.client.Request(ctx, "sessions.readPersistedEvents", params) +// Parameters: Session ID to delete from disk. +// Internal: Delete is part of the SDK's internal handshake/plumbing; external callers +// should not use it. +func (a *InternalServerSessionsAPI) Delete(ctx context.Context, params *SessionsDeleteRequest) (*SessionsDeleteResult, error) { + raw, err := a.client.Request(ctx, "sessions.delete", params) if err != nil { return nil, err } - var result EventsReadResult + var result SessionsDeleteResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ReleaseLock releases the in-use lock held by this process for a session. +// GetBoardEntryCount gets the dynamic-context board entry count associated with a session, +// when available. Internal: this exists solely so CLI telemetry events (`rem_spawn_gate`, +// `rem_consolidation_complete`) can pair START / END board counts around the detached +// rem-agent spawn. "Dynamic context board" is a runtime-internal concept that is not part +// of the public SDK contract; the long-term plan is to relocate the telemetry emission into +// the runtime so this method can be deleted entirely. // -// RPC method: sessions.releaseLock. +// RPC method: sessions.getBoardEntryCount. // -// Parameters: Session ID whose in-use lock should be released. +// Parameters: Session ID whose board entry count should be returned. // -// Returns: Release the in-use lock held by this process for the given session. No-op when -// this process does not currently hold a lock for the session. -func (a *ServerSessionsAPI) ReleaseLock(ctx context.Context, params *SessionsReleaseLockRequest) (*SessionsReleaseLockResult, error) { - raw, err := a.client.Request(ctx, "sessions.releaseLock", params) +// Returns: Dynamic-context board entry count, when available. +// Internal: GetBoardEntryCount is part of the SDK's internal handshake/plumbing; external +// callers should not use it. +func (a *InternalServerSessionsAPI) GetBoardEntryCount(ctx context.Context, params *SessionsGetBoardEntryCountRequest) (*SessionsGetBoardEntryCountResult, error) { + raw, err := a.client.Request(ctx, "sessions.getBoardEntryCount", params) if err != nil { return nil, err } - var result SessionsReleaseLockResult + var result SessionsGetBoardEntryCountResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ReloadPluginHooks reloads user, plugin, and (optionally) repo hooks on the active session. +// GetEventFilePath computes the absolute path to a session's persisted events.jsonl file. +// Internal: filesystem paths are only meaningful in-process (CLI and runtime share a +// filesystem). Currently used by the CLI's contribution-graph feature to read historical +// events directly. Remote SDK consumers must not depend on this; a proper event-query API +// would replace it if the contribution graph ever needed to work over the wire. // -// RPC method: sessions.reloadPluginHooks. +// RPC method: sessions.getEventFilePath. // -// Parameters: Active session ID and an optional flag for deferring repo-level hooks until -// folder trust. +// Parameters: Session ID whose event-log file path to compute. // -// Returns: Reload all hooks (user, plugin, optionally repo) and apply them to the active -// session. Call after installing or removing plugins so their hooks take effect -// immediately. No-op when no active session matches the given sessionId. -func (a *ServerSessionsAPI) ReloadPluginHooks(ctx context.Context, params *SessionsReloadPluginHooksRequest) (*SessionsReloadPluginHooksResult, error) { - raw, err := a.client.Request(ctx, "sessions.reloadPluginHooks", params) +// Returns: Absolute path to the session's events.jsonl file on disk. +// Internal: GetEventFilePath is part of the SDK's internal handshake/plumbing; external +// callers should not use it. +func (a *InternalServerSessionsAPI) GetEventFilePath(ctx context.Context, params *SessionsGetEventFilePathRequest) (*SessionsGetEventFilePathResult, error) { + raw, err := a.client.Request(ctx, "sessions.getEventFilePath", params) if err != nil { return nil, err } - var result SessionsReloadPluginHooksResult + var result SessionsGetEventFilePathResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Save flushes a session's pending events to disk. +// GetMetadata reads lightweight persisted metadata for one local session without opening it. // -// RPC method: sessions.save. +// RPC method: sessions.getMetadata. // -// Parameters: Session ID whose pending events should be flushed to disk. +// Parameters: Session ID whose persisted metadata should be read. // -// Returns: Flush a session's pending events to disk. No-op when no writer exists for the -// session (e.g., already closed). -func (a *ServerSessionsAPI) Save(ctx context.Context, params *SessionsSaveRequest) (*SessionsSaveResult, error) { - raw, err := a.client.Request(ctx, "sessions.save", params) +// Returns: Persisted local session metadata when the session exists. +// Internal: GetMetadata is part of the SDK's internal handshake/plumbing; external callers +// should not use it. +func (a *InternalServerSessionsAPI) GetMetadata(ctx context.Context, params *SessionsGetMetadataRequest) (*SessionsGetMetadataResult, error) { + raw, err := a.client.Request(ctx, "sessions.getMetadata", params) if err != nil { return nil, err } - var result SessionsSaveResult + var result SessionsGetMetadataResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetAdditionalPlugins replaces the manager-wide additional plugins registered with the -// session manager. +// GetPersistedRemoteSteerable returns a session's persisted remote-steerable flag, if any +// has been recorded. Internal: this is CLI-specific book-keeping used by `--continue` / +// `--resume` to inherit the prior session's remote-steerable preference. SDK consumers that +// want similar behavior should manage their own persistence around start/stop calls rather +// than relying on this runtime-side flag. // -// RPC method: sessions.setAdditionalPlugins. +// RPC method: sessions.getPersistedRemoteSteerable. // -// Parameters: Manager-wide additional plugins to register; replaces any -// previously-configured set. +// Parameters: Session ID to look up the persisted remote-steerable flag for. // -// Returns: Replace the manager-wide additional plugins. New session creations and -// subsequent hook reloads see the new set; already-running sessions keep their existing -// hook installation until the next reload. -func (a *ServerSessionsAPI) SetAdditionalPlugins(ctx context.Context, params *SessionsSetAdditionalPluginsRequest) (*SessionsSetAdditionalPluginsResult, error) { - raw, err := a.client.Request(ctx, "sessions.setAdditionalPlugins", params) +// Returns: The session's persisted remote-steerable flag, or omitted when no value has been +// persisted. +// Internal: GetPersistedRemoteSteerable is part of the SDK's internal handshake/plumbing; +// external callers should not use it. +func (a *InternalServerSessionsAPI) GetPersistedRemoteSteerable(ctx context.Context, params *SessionsGetPersistedRemoteSteerableRequest) (*SessionsGetPersistedRemoteSteerableResult, error) { + raw, err := a.client.Request(ctx, "sessions.getPersistedRemoteSteerable", params) if err != nil { return nil, err } - var result SessionsSetAdditionalPluginsResult + var result SessionsGetPersistedRemoteSteerableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetRemoteControlSteering patches the steering state of the active remote-control -// singleton. When remote control is off, this is a no-op and the off status is returned. -// Today only `enabled: true` is actionable on the underlying exporter; passing `false` is -// reserved for future use. +// ListNonEmptySessionIds lists recent local session IDs that contain user-visible history, +// omitting housekeeping-only sessions. // -// RPC method: sessions.setRemoteControlSteering. +// RPC method: sessions.listNonEmptySessionIds. // -// Parameters: Patch for the singleton's steering state. +// Parameters: Limit for non-empty local session IDs. // -// Returns: Wrapper for the singleton's current status. -func (a *ServerSessionsAPI) SetRemoteControlSteering(ctx context.Context, params *SessionsSetRemoteControlSteeringRequest) (*RemoteControlStatusResult, error) { - raw, err := a.client.Request(ctx, "sessions.setRemoteControlSteering", params) +// Returns: Recent local session IDs that contain user-visible history. +// Internal: ListNonEmptySessionIds is part of the SDK's internal handshake/plumbing; +// external callers should not use it. +func (a *InternalServerSessionsAPI) ListNonEmptySessionIds(ctx context.Context, params *SessionsListNonEmptySessionIDsRequest) (*SessionsListNonEmptySessionIDsResult, error) { + raw, err := a.client.Request(ctx, "sessions.listNonEmptySessionIds", params) if err != nil { return nil, err } - var result RemoteControlStatusResult + var result SessionsListNonEmptySessionIDsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// StartRemoteControl attaches the runtime-managed remote-control singleton to a session, -// awaiting initial setup. If remote control is already attached to a different session, the -// singleton is transferred (preserving the underlying Mission Control connection). Returns -// the final status. +// InternalServerRPC provides internal SDK server-scoped RPC methods (handshake helpers +// etc.). Not part of the public API. +type InternalServerRPC struct { + // Reuse a single struct instead of allocating one for each service on the heap. + common internalServerAPI + + Sessions *InternalServerSessionsAPI +} + +// Connect performs the SDK server connection handshake and validates the optional +// connection token. Marked internal because this is JSON-RPC transport plumbing invoked +// automatically by an SDK client's own `connect()` wrapper, not a user-facing method. Stays +// internal as long as the SDK client owns the handshake; would only become public if the +// SDK ever exposed the raw schema surface to consumers without a connection wrapper. // -// RPC method: sessions.startRemoteControl. +// RPC method: connect. // -// Parameters: Parameters for attaching the remote-control singleton to a session. +// Parameters: Connection-level opt-ins for the `server.connect` handshake. Transport +// authentication is consumed by the native protocol boundary before dispatch. // -// Returns: Wrapper for the singleton's current status. -func (a *ServerSessionsAPI) StartRemoteControl(ctx context.Context, params *SessionsStartRemoteControlRequest) (*RemoteControlStatusResult, error) { - raw, err := a.client.Request(ctx, "sessions.startRemoteControl", params) +// Returns: Handshake result reporting the server's protocol version and package version on +// success. +// Experimental: Connect is an experimental API and may change or be removed in future +// versions. +// Internal: Connect is part of the SDK's internal handshake/plumbing; external callers +// should not use it. +func (a *InternalServerRPC) Connect(ctx context.Context, params *ConnectRequest) (*ConnectResult, error) { + raw, err := a.common.client.Request(ctx, "connect", params) if err != nil { return nil, err } - var result RemoteControlStatusResult + var result ConnectResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// StopRemoteControl stops the remote-control singleton. When `expectedSessionId` is -// provided and does not match the singleton's current `attachedSessionId`, the stop is -// rejected with `stopped: false` and the current status is returned unchanged (unless -// `force` is set, in which case the singleton is unconditionally torn down). -// -// RPC method: sessions.stopRemoteControl. -// -// Parameters: Parameters for stopping the remote-control singleton. +func NewInternalServerRPC(client *jsonrpc2.Client) *InternalServerRPC { + r := &InternalServerRPC{} + r.common = internalServerAPI{client: client} + r.Sessions = (*InternalServerSessionsAPI)(&r.common) + return r +} + +type sessionAPI struct { + client *jsonrpc2.Client + sessionID string +} + +// Experimental: AgentAPI contains experimental APIs that may change or be removed. +type AgentAPI sessionAPI + +// Deselect clears the selected custom agent and returns the session to the default agent. // -// Returns: Outcome of a stopRemoteControl call. -func (a *ServerSessionsAPI) StopRemoteControl(ctx context.Context, params *SessionsStopRemoteControlRequest) (*RemoteControlStopResult, error) { - raw, err := a.client.Request(ctx, "sessions.stopRemoteControl", params) +// RPC method: session.agent.deselect. +func (a *AgentAPI) Deselect(ctx context.Context) (*SessionAgentDeselectResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.agent.deselect", req) if err != nil { return nil, err } - var result RemoteControlStopResult + var result SessionAgentDeselectResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// TransferRemoteControl atomically rebinds the remote-control singleton to a different -// session, preserving the underlying Mission Control connection. When -// `expectedFromSessionId` is provided and does not match the singleton's current -// `attachedSessionId`, the transfer is rejected with `transferred: false` and the current -// status is returned unchanged. -// -// RPC method: sessions.transferRemoteControl. +// GetCurrent gets the currently selected custom agent for the session. // -// Parameters: Parameters for atomically rebinding the remote-control singleton. +// RPC method: session.agent.getCurrent. // -// Returns: Outcome of a transferRemoteControl call. -func (a *ServerSessionsAPI) TransferRemoteControl(ctx context.Context, params *SessionsTransferRemoteControlRequest) (*RemoteControlTransferResult, error) { - raw, err := a.client.Request(ctx, "sessions.transferRemoteControl", params) +// Returns: The currently selected custom agent, or null when using the default agent. +func (a *AgentAPI) GetCurrent(ctx context.Context) (*AgentGetCurrentResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.agent.getCurrent", req) if err != nil { return nil, err } - var result RemoteControlTransferResult + var result AgentGetCurrentResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerSkillsAPI contains experimental APIs that may change or be removed. -type ServerSkillsAPI serverAPI - -// Discovers skills across global and project sources. +// Lists agents available to the session. Defaults to custom agents only; pass +// includeBuiltInAgents to include the effective built-in agents. // -// RPC method: skills.discover. +// RPC method: session.agent.list. // -// Parameters: Optional project paths and additional skill directories to include in -// discovery. +// Parameters: Controls whether built-in agents and authored prompt text are included. // -// Returns: Skills discovered across global and project sources. -func (a *ServerSkillsAPI) Discover(ctx context.Context, params *SkillsDiscoverRequest) (*ServerSkillList, error) { - raw, err := a.client.Request(ctx, "skills.discover", params) +// Returns: Agents available to the session. +func (a *AgentAPI) List(ctx context.Context, params ...*SessionAgentListRequest) (*AgentList, error) { + var requestParams *SessionAgentListRequest + if len(params) > 0 { + requestParams = params[0] + } + req := map[string]any{"sessionId": a.sessionID} + if requestParams != nil { + if requestParams.IncludeBuiltInAgents != nil { + req["includeBuiltInAgents"] = *requestParams.IncludeBuiltInAgents + } + if requestParams.IncludePrompt != nil { + req["includePrompt"] = *requestParams.IncludePrompt + } + } + raw, err := a.client.Request(ctx, "session.agent.list", req) if err != nil { return nil, err } - var result ServerSkillList + var result AgentList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetDiscoveryPaths returns the canonical directories where a client may create skills that -// the runtime will recognize, including ones that do not exist yet. Project directories -// become active once created. -// -// RPC method: skills.getDiscoveryPaths. +// Reloads custom agent definitions and returns the refreshed list. // -// Parameters: Optional project paths to enumerate. +// RPC method: session.agent.reload. // -// Returns: Canonical locations where skills can be created so the runtime will recognize -// them. -func (a *ServerSkillsAPI) GetDiscoveryPaths(ctx context.Context, params *SkillsGetDiscoveryPathsRequest) (*SkillDiscoveryPathList, error) { - raw, err := a.client.Request(ctx, "skills.getDiscoveryPaths", params) +// Returns: Custom agents available to the session after reloading definitions from disk. +func (a *AgentAPI) Reload(ctx context.Context) (*AgentReloadResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.agent.reload", req) if err != nil { return nil, err } - var result SkillDiscoveryPathList + var result AgentReloadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerSkillsConfigAPI contains experimental APIs that may change or be -// removed. -type ServerSkillsConfigAPI serverAPI - -// SetDisabledSkills replaces the global list of disabled skills. +// Selects a custom agent for subsequent turns in the session. // -// RPC method: skills.config.setDisabledSkills. +// RPC method: session.agent.select. +// +// Parameters: Name of the custom agent to select for subsequent turns. // -// Parameters: Skill names to mark as disabled in global configuration, replacing any -// previous list. -func (a *ServerSkillsConfigAPI) SetDisabledSkills(ctx context.Context, params *SkillsConfigSetDisabledSkillsRequest) (*SkillsConfigSetDisabledSkillsResult, error) { - raw, err := a.client.Request(ctx, "skills.config.setDisabledSkills", params) +// Returns: The newly selected custom agent. +func (a *AgentAPI) Select(ctx context.Context, params *AgentSelectRequest) (*AgentSelectResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["name"] = params.Name + } + raw, err := a.client.Request(ctx, "session.agent.select", req) if err != nil { return nil, err } - var result SkillsConfigSetDisabledSkillsResult + var result AgentSelectResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetSkillDisabled atomically adds or removes one skill from the disabled list. +// SetPrompt sets an in-memory authored prompt override for an available agent. For built-in +// agents, this replaces only the static base prompt while preserving runtime-owned dynamic +// prompt composition and behavior. The special `general-purpose` agent is not overrideable. +// Overrides are not persisted; resumed and forked sessions start without them, so the host +// must re-apply them. // -// RPC method: skills.config.setSkillDisabled. +// RPC method: session.agent.setPrompt. // -// Parameters: Adds or removes a single skill from the global disabled list, leaving every -// other entry untouched. -func (a *ServerSkillsConfigAPI) SetSkillDisabled(ctx context.Context, params *SkillsConfigSetSkillDisabledRequest) (*SkillsConfigSetSkillDisabledResult, error) { - raw, err := a.client.Request(ctx, "skills.config.setSkillDisabled", params) +// Parameters: An in-memory authored prompt override for an available agent. +func (a *AgentAPI) SetPrompt(ctx context.Context, params *AgentSetPromptRequest) (*SessionAgentSetPromptResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["id"] = params.ID + req["prompt"] = params.Prompt + } + raw, err := a.client.Request(ctx, "session.agent.setPrompt", req) if err != nil { return nil, err } - var result SkillsConfigSetSkillDisabledResult + var result SessionAgentSetPromptResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Config returns experimental APIs that may change or be removed. -func (s *ServerSkillsAPI) Config() *ServerSkillsConfigAPI { - return (*ServerSkillsConfigAPI)(s) -} - -// Experimental: ServerToolsAPI contains experimental APIs that may change or be removed. -type ServerToolsAPI serverAPI +// Experimental: AutopilotObjectiveAPI contains experimental APIs that may change or be +// removed. +type AutopilotObjectiveAPI sessionAPI -// Lists built-in tools available for a model. -// -// RPC method: tools.list. +// GetState reads the current canonical autopilot objective state for this session. // -// Parameters: Optional model identifier whose tool overrides should be applied to the -// listing. +// RPC method: session.autopilotObjective.getState. // -// Returns: Built-in tools available for the requested model, with their parameters and -// instructions. -func (a *ServerToolsAPI) List(ctx context.Context, params *ToolsListRequest) (*ToolList, error) { - raw, err := a.client.Request(ctx, "tools.list", params) +// Returns: Canonical runtime state for the session's current autopilot objective. +func (a *AutopilotObjectiveAPI) GetState(ctx context.Context) (*AutopilotObjectiveGetStateResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.autopilotObjective.getState", req) if err != nil { return nil, err } - var result ToolList + var result AutopilotObjectiveGetStateResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ServerUserAPI contains experimental APIs that may change or be removed. -type ServerUserAPI serverAPI - -// Experimental: ServerUserSettingsAPI contains experimental APIs that may change or be -// removed. -type ServerUserSettingsAPI serverAPI +// Experimental: CanvasAPI contains experimental APIs that may change or be removed. +type CanvasAPI sessionAPI -// Get lists every known user setting (settings.json overlaid with the legacy config.json, -// config.json wins), each with its effective value, its default, and whether it is at the -// default — so settings the user has never set still appear with their default value. Does -// not include repository- or enterprise-managed overrides that the runtime layers on top at -// session time. +// Closes an open canvas instance. // -// RPC method: user.settings.get. +// RPC method: session.canvas.close. // -// Returns: Per-key metadata for every known user setting (settings.json overlaid with the -// legacy config.json, config.json wins), including settings left at their default. Excludes -// repository- and enterprise-managed overrides. -func (a *ServerUserSettingsAPI) Get(ctx context.Context) (*UserSettingsGetResult, error) { - raw, err := a.client.Request(ctx, "user.settings.get", nil) +// Parameters: Canvas close parameters. +func (a *CanvasAPI) Close(ctx context.Context, params *CanvasCloseRequest) (*SessionCanvasCloseResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["instanceId"] = params.InstanceID + } + raw, err := a.client.Request(ctx, "session.canvas.close", req) if err != nil { return nil, err } - var result UserSettingsGetResult + var result SessionCanvasCloseResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Reload drops this runtime process's in-memory user settings cache so the next settings -// read observes disk. +// Lists canvases declared for the session. // -// RPC method: user.settings.reload. -func (a *ServerUserSettingsAPI) Reload(ctx context.Context) (*UserSettingsReloadResult, error) { - raw, err := a.client.Request(ctx, "user.settings.reload", nil) +// RPC method: session.canvas.list. +// +// Returns: Declared canvases available in this session. +func (a *CanvasAPI) List(ctx context.Context) (*CanvasList, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.canvas.list", req) if err != nil { return nil, err } - var result UserSettingsReloadResult + var result CanvasList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Set writes one or more user settings to settings.json, replacing each provided top-level -// key. A key whose value is null is removed. Returns the keys whose new value is shadowed -// by a legacy config.json entry (config.json wins on read), which the runtime leaves in -// place — such writes do not take effect until the legacy value is removed. -// -// RPC method: user.settings.set. +// ListOpen lists currently open canvas instances for the live session. // -// Parameters: 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. +// RPC method: session.canvas.listOpen. // -// Returns: Outcome of writing user settings. -func (a *ServerUserSettingsAPI) Set(ctx context.Context, params *UserSettingsSetRequest) (*UserSettingsSetResult, error) { - raw, err := a.client.Request(ctx, "user.settings.set", params) +// Returns: Live open-canvas snapshot. +func (a *CanvasAPI) ListOpen(ctx context.Context) (*CanvasListOpenResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.canvas.listOpen", req) if err != nil { return nil, err } - var result UserSettingsSetResult + var result CanvasListOpenResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Settings returns experimental APIs that may change or be removed. -func (s *ServerUserAPI) Settings() *ServerUserSettingsAPI { - return (*ServerUserSettingsAPI)(s) -} - -// ServerRPC provides typed server-scoped RPC methods. -type ServerRPC struct { - // Reuse a single struct instead of allocating one for each service on the heap. - common serverAPI - - Account *ServerAccountAPI - AgentRegistry *ServerAgentRegistryAPI - Agents *ServerAgentsAPI - Catalog *ServerCatalogAPI - Commands *ServerCommandsAPI - Extensions *ServerExtensionsAPI - Hooks *ServerHooksAPI - Instructions *ServerInstructionsAPI - LlmInference *ServerLlmInferenceAPI - ManagedSettings *ServerManagedSettingsAPI - MCP *ServerMCPAPI - Models *ServerModelsAPI - Plugins *ServerPluginsAPI - Runtime *ServerRuntimeAPI - Secrets *ServerSecretsAPI - SessionFS *ServerSessionFSAPI - Sessions *ServerSessionsAPI - Skills *ServerSkillsAPI - Tools *ServerToolsAPI - User *ServerUserAPI -} - -// Ping checks server responsiveness and returns protocol information. +// Opens or focuses a canvas instance. // -// RPC method: ping. +// RPC method: session.canvas.open. // -// Parameters: Optional message to echo back to the caller. +// Parameters: Canvas open parameters. // -// Returns: Server liveness response, including the echoed message, current server -// timestamp, and protocol version. -// Experimental: Ping is an experimental API and may change or be removed in future versions. -func (a *ServerRPC) Ping(ctx context.Context, params *PingRequest) (*PingResult, error) { - raw, err := a.common.client.Request(ctx, "ping", params) +// Returns: Open canvas instance snapshot. +func (a *CanvasAPI) Open(ctx context.Context, params *CanvasOpenRequest) (*OpenCanvasInstance, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["canvasId"] = params.CanvasID + if params.ExtensionID != nil { + req["extensionId"] = *params.ExtensionID + } + if params.Input != nil { + req["input"] = params.Input + } + req["instanceId"] = params.InstanceID + } + raw, err := a.client.Request(ctx, "session.canvas.open", req) if err != nil { return nil, err } - var result PingResult + var result OpenCanvasInstance if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RegisterExtensionLaunchProvider registers the calling SDK client as the per-entrypoint -// extension launch provider. Call before creating any sessions. When omitted, the runtime -// uses its built-in extension launcher. +// Experimental: CanvasActionAPI contains experimental APIs that may change or be removed. +type CanvasActionAPI sessionAPI + +// Invokes an action on an open canvas instance. // -// RPC method: registerExtensionLaunchProvider. -// Experimental: RegisterExtensionLaunchProvider is an experimental API and may change or be -// removed in future versions. -func (a *ServerRPC) RegisterExtensionLaunchProvider(ctx context.Context) (*RegisterExtensionLaunchProviderResult, error) { - raw, err := a.common.client.Request(ctx, "registerExtensionLaunchProvider", nil) +// RPC method: session.canvas.action.invoke. +// +// Parameters: Canvas action invocation parameters. +// +// Returns: Canvas action invocation result. +func (a *CanvasActionAPI) Invoke(ctx context.Context, params *CanvasActionInvokeRequest) (*CanvasActionInvokeResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["actionName"] = params.ActionName + if params.Input != nil { + req["input"] = params.Input + } + req["instanceId"] = params.InstanceID + } + raw, err := a.client.Request(ctx, "session.canvas.action.invoke", req) if err != nil { return nil, err } - var result RegisterExtensionLaunchProviderResult + var result CanvasActionInvokeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -func NewServerRPC(client *jsonrpc2.Client) *ServerRPC { - r := &ServerRPC{} - r.common = serverAPI{client: client} - r.Account = (*ServerAccountAPI)(&r.common) - r.AgentRegistry = (*ServerAgentRegistryAPI)(&r.common) - r.Agents = (*ServerAgentsAPI)(&r.common) - r.Catalog = (*ServerCatalogAPI)(&r.common) - r.Commands = (*ServerCommandsAPI)(&r.common) - r.Extensions = (*ServerExtensionsAPI)(&r.common) - r.Hooks = (*ServerHooksAPI)(&r.common) - r.Instructions = (*ServerInstructionsAPI)(&r.common) - r.LlmInference = (*ServerLlmInferenceAPI)(&r.common) - r.ManagedSettings = (*ServerManagedSettingsAPI)(&r.common) - r.MCP = (*ServerMCPAPI)(&r.common) - r.Models = (*ServerModelsAPI)(&r.common) - r.Plugins = (*ServerPluginsAPI)(&r.common) - r.Runtime = (*ServerRuntimeAPI)(&r.common) - r.Secrets = (*ServerSecretsAPI)(&r.common) - r.SessionFS = (*ServerSessionFSAPI)(&r.common) - r.Sessions = (*ServerSessionsAPI)(&r.common) - r.Skills = (*ServerSkillsAPI)(&r.common) - r.Tools = (*ServerToolsAPI)(&r.common) - r.User = (*ServerUserAPI)(&r.common) - return r -} - -type internalServerAPI struct { - client *jsonrpc2.Client +// Experimental: Action returns experimental APIs that may change or be removed. +func (s *CanvasAPI) Action() *CanvasActionAPI { + return (*CanvasActionAPI)(s) } -// Experimental: InternalServerSessionsAPI contains experimental APIs that may change or be -// removed. -type InternalServerSessionsAPI internalServerAPI +// Experimental: CommandsAPI contains experimental APIs that may change or be removed. +type CommandsAPI sessionAPI -// ConfigureSessionExtensions attaches (or detaches) an in-process ExtensionController -// delegate for the given session in a local host adapter. Pass `controller: undefined` to -// detach. Internal because the controller cannot cross the JSON-RPC boundary; the runtime -// manages its own session extension service. +// Enqueues a slash command for FIFO processing on the local session. +// +// RPC method: session.commands.enqueue. // -// RPC method: sessions.configureSessionExtensions. +// Parameters: Slash-prefixed command string to enqueue for FIFO processing. // -// Parameters: Params to attach or detach an in-process ExtensionController delegate. -// Internal: ConfigureSessionExtensions is part of the SDK's internal handshake/plumbing; -// external callers should not use it. -func (a *InternalServerSessionsAPI) ConfigureSessionExtensions(ctx context.Context, params *ConfigureSessionExtensionsParams) (*SessionsConfigureSessionExtensionsResult, error) { - raw, err := a.client.Request(ctx, "sessions.configureSessionExtensions", params) +// Returns: Indicates whether the command was accepted into the local execution queue. +func (a *CommandsAPI) Enqueue(ctx context.Context, params *EnqueueCommandParams) (*EnqueueCommandResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["command"] = params.Command + if params.DisplayText != nil { + req["displayText"] = *params.DisplayText + } + } + raw, err := a.client.Request(ctx, "session.commands.enqueue", req) if err != nil { return nil, err } - var result SessionsConfigureSessionExtensionsResult + var result EnqueueCommandResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Deletes one local session from disk after running the same lifecycle hooks as the session -// manager. +// Executes a slash command synchronously and returns any error. // -// RPC method: sessions.delete. +// RPC method: session.commands.execute. // -// Parameters: Session ID to delete from disk. -// Internal: Delete is part of the SDK's internal handshake/plumbing; external callers -// should not use it. -func (a *InternalServerSessionsAPI) Delete(ctx context.Context, params *SessionsDeleteRequest) (*SessionsDeleteResult, error) { - raw, err := a.client.Request(ctx, "sessions.delete", params) +// Parameters: Slash command name and argument string to execute synchronously. +// +// Returns: Error message produced while executing the command, if any. +func (a *CommandsAPI) Execute(ctx context.Context, params *ExecuteCommandParams) (*ExecuteCommandResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["args"] = params.Args + req["commandName"] = params.CommandName + } + raw, err := a.client.Request(ctx, "session.commands.execute", req) if err != nil { return nil, err } - var result SessionsDeleteResult + var result ExecuteCommandResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetBoardEntryCount gets the dynamic-context board entry count associated with a session, -// when available. Internal: this exists solely so CLI telemetry events (`rem_spawn_gate`, -// `rem_consolidation_complete`) can pair START / END board counts around the detached -// rem-agent spawn. "Dynamic context board" is a runtime-internal concept that is not part -// of the public SDK contract; the long-term plan is to relocate the telemetry emission into -// the runtime so this method can be deleted entirely. +// HandlePendingCommand reports completion of a pending client-handled slash command. // -// RPC method: sessions.getBoardEntryCount. +// RPC method: session.commands.handlePendingCommand. // -// Parameters: Session ID whose board entry count should be returned. +// Parameters: Pending command request ID and an optional error if the client handler failed. // -// Returns: Dynamic-context board entry count, when available. -// Internal: GetBoardEntryCount is part of the SDK's internal handshake/plumbing; external -// callers should not use it. -func (a *InternalServerSessionsAPI) GetBoardEntryCount(ctx context.Context, params *SessionsGetBoardEntryCountRequest) (*SessionsGetBoardEntryCountResult, error) { - raw, err := a.client.Request(ctx, "sessions.getBoardEntryCount", params) +// Returns: Indicates whether the pending client-handled command was completed successfully. +func (a *CommandsAPI) HandlePendingCommand(ctx context.Context, params *CommandsHandlePendingCommandRequest) (*CommandsHandlePendingCommandResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + if params.Error != nil { + req["error"] = *params.Error + } + req["requestId"] = params.RequestID + } + raw, err := a.client.Request(ctx, "session.commands.handlePendingCommand", req) if err != nil { return nil, err } - var result SessionsGetBoardEntryCountResult + var result CommandsHandlePendingCommandResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetEventFilePath computes the absolute path to a session's persisted events.jsonl file. -// Internal: filesystem paths are only meaningful in-process (CLI and runtime share a -// filesystem). Currently used by the CLI's contribution-graph feature to read historical -// events directly. Remote SDK consumers must not depend on this; a proper event-query API -// would replace it if the contribution graph ever needed to work over the wire. +// Invokes a slash command in the session. // -// RPC method: sessions.getEventFilePath. +// RPC method: session.commands.invoke. // -// Parameters: Session ID whose event-log file path to compute. +// Parameters: Slash command name and optional raw input string to invoke. // -// Returns: Absolute path to the session's events.jsonl file on disk. -// Internal: GetEventFilePath is part of the SDK's internal handshake/plumbing; external -// callers should not use it. -func (a *InternalServerSessionsAPI) GetEventFilePath(ctx context.Context, params *SessionsGetEventFilePathRequest) (*SessionsGetEventFilePathResult, error) { - raw, err := a.client.Request(ctx, "sessions.getEventFilePath", params) +// Returns: Result of invoking the slash command (text output, prompt to send to the agent, +// completion, or subcommand selection). +func (a *CommandsAPI) Invoke(ctx context.Context, params *CommandsInvokeRequest) (SlashCommandInvocationResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + if params.Input != nil { + req["input"] = *params.Input + } + req["name"] = params.Name + if params.Origin != nil { + req["origin"] = *params.Origin + } + } + raw, err := a.client.Request(ctx, "session.commands.invoke", req) if err != nil { return nil, err } - var result SessionsGetEventFilePathResult - if err := json.Unmarshal(raw, &result); err != nil { + result, err := unmarshalSlashCommandInvocationResult(raw) + if err != nil { return nil, err } - return &result, nil + return result, nil } -// GetMetadata reads lightweight persisted metadata for one local session without opening it. +// Lists slash commands available in the session. // -// RPC method: sessions.getMetadata. +// RPC method: session.commands.list. // -// Parameters: Session ID whose persisted metadata should be read. +// Parameters: Optional filters controlling which command sources to include in the listing. // -// Returns: Persisted local session metadata when the session exists. -// Internal: GetMetadata is part of the SDK's internal handshake/plumbing; external callers -// should not use it. -func (a *InternalServerSessionsAPI) GetMetadata(ctx context.Context, params *SessionsGetMetadataRequest) (*SessionsGetMetadataResult, error) { - raw, err := a.client.Request(ctx, "sessions.getMetadata", params) +// Returns: Slash commands available in the session, after applying any include/exclude +// filters. +func (a *CommandsAPI) List(ctx context.Context, params ...*SessionCommandsListRequest) (*CommandList, error) { + var requestParams *SessionCommandsListRequest + if len(params) > 0 { + requestParams = params[0] + } + req := map[string]any{"sessionId": a.sessionID} + if requestParams != nil { + if requestParams.IncludeBuiltins != nil { + req["includeBuiltins"] = *requestParams.IncludeBuiltins + } + if requestParams.IncludeClientCommands != nil { + req["includeClientCommands"] = *requestParams.IncludeClientCommands + } + if requestParams.IncludeSkills != nil { + req["includeSkills"] = *requestParams.IncludeSkills + } + } + raw, err := a.client.Request(ctx, "session.commands.list", req) if err != nil { return nil, err } - var result SessionsGetMetadataResult + var result CommandList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetPersistedRemoteSteerable returns a session's persisted remote-steerable flag, if any -// has been recorded. Internal: this is CLI-specific book-keeping used by `--continue` / -// `--resume` to inherit the prior session's remote-steerable preference. SDK consumers that -// want similar behavior should manage their own persistence around start/stop calls rather -// than relying on this runtime-side flag. +// RespondToQueuedCommand reports whether the host actually executed a queued command and +// whether to continue processing. // -// RPC method: sessions.getPersistedRemoteSteerable. +// RPC method: session.commands.respondToQueuedCommand. // -// Parameters: Session ID to look up the persisted remote-steerable flag for. +// Parameters: Queued-command request ID and the result indicating whether the host executed +// it (and whether to stop processing further queued commands). // -// Returns: The session's persisted remote-steerable flag, or omitted when no value has been -// persisted. -// Internal: GetPersistedRemoteSteerable is part of the SDK's internal handshake/plumbing; -// external callers should not use it. -func (a *InternalServerSessionsAPI) GetPersistedRemoteSteerable(ctx context.Context, params *SessionsGetPersistedRemoteSteerableRequest) (*SessionsGetPersistedRemoteSteerableResult, error) { - raw, err := a.client.Request(ctx, "sessions.getPersistedRemoteSteerable", params) +// Returns: Indicates whether the queued-command response was matched to a pending request. +func (a *CommandsAPI) RespondToQueuedCommand(ctx context.Context, params *CommandsRespondToQueuedCommandRequest) (*CommandsRespondToQueuedCommandResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["requestId"] = params.RequestID + req["result"] = params.Result + } + raw, err := a.client.Request(ctx, "session.commands.respondToQueuedCommand", req) if err != nil { return nil, err } - var result SessionsGetPersistedRemoteSteerableResult + var result CommandsRespondToQueuedCommandResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ListNonEmptySessionIds lists recent local session IDs that contain user-visible history, -// omitting housekeeping-only sessions. -// -// RPC method: sessions.listNonEmptySessionIds. +// Experimental: CompletionsAPI contains experimental APIs that may change or be removed. +type CompletionsAPI sessionAPI + +// GetTriggerCharacters gets the characters that should trigger host-driven completions for +// the session. Empty disables host-driven completions (e.g. local sessions, or a relay host +// that does not advertise them). // -// Parameters: Limit for non-empty local session IDs. +// RPC method: session.completions.getTriggerCharacters. // -// Returns: Recent local session IDs that contain user-visible history. -// Internal: ListNonEmptySessionIds is part of the SDK's internal handshake/plumbing; -// external callers should not use it. -func (a *InternalServerSessionsAPI) ListNonEmptySessionIds(ctx context.Context, params *SessionsListNonEmptySessionIDsRequest) (*SessionsListNonEmptySessionIDsResult, error) { - raw, err := a.client.Request(ctx, "sessions.listNonEmptySessionIds", params) +// Returns: Characters that, when typed in the composer, should trigger a +// `completions.request`. Empty when the session has no host-driven completions (e.g. local +// sessions, or a relay host that does not advertise `completionTriggerCharacters`). +func (a *CompletionsAPI) GetTriggerCharacters(ctx context.Context) (*CompletionsGetTriggerCharactersResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.completions.getTriggerCharacters", req) if err != nil { return nil, err } - var result SessionsListNonEmptySessionIDsResult + var result CompletionsGetTriggerCharactersResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// InternalServerRPC provides internal SDK server-scoped RPC methods (handshake helpers -// etc.). Not part of the public API. -type InternalServerRPC struct { - // Reuse a single struct instead of allocating one for each service on the heap. - common internalServerAPI - - Sessions *InternalServerSessionsAPI -} - -// Connect performs the SDK server connection handshake and validates the optional -// connection token. Marked internal because this is JSON-RPC transport plumbing invoked -// automatically by an SDK client's own `connect()` wrapper, not a user-facing method. Stays -// internal as long as the SDK client owns the handshake; would only become public if the -// SDK ever exposed the raw schema surface to consumers without a connection wrapper. +// Requests host-driven completion items for the current composer input. Returns an empty +// list when the host has no items or does not support completions. // -// RPC method: connect. +// RPC method: session.completions.request. // -// Parameters: Connection-level opt-ins for the `server.connect` handshake. Transport -// authentication is consumed by the native protocol boundary before dispatch. +// Parameters: Request host-driven completions for the current composer input. // -// Returns: Handshake result reporting the server's protocol version and package version on -// success. -// Experimental: Connect is an experimental API and may change or be removed in future -// versions. -// Internal: Connect is part of the SDK's internal handshake/plumbing; external callers -// should not use it. -func (a *InternalServerRPC) Connect(ctx context.Context, params *ConnectRequest) (*ConnectResult, error) { - raw, err := a.common.client.Request(ctx, "connect", params) +// Returns: Host-driven completion items for the current composer input. Empty when the host +// returns no items or does not support completions. +func (a *CompletionsAPI) Request(ctx context.Context, params *CompletionsRequestRequest) (*CompletionsRequestResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["offset"] = params.Offset + req["text"] = params.Text + } + raw, err := a.client.Request(ctx, "session.completions.request", req) if err != nil { return nil, err } - var result ConnectResult + var result CompletionsRequestResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -func NewInternalServerRPC(client *jsonrpc2.Client) *InternalServerRPC { - r := &InternalServerRPC{} - r.common = internalServerAPI{client: client} - r.Sessions = (*InternalServerSessionsAPI)(&r.common) - return r -} - -type sessionAPI struct { - client *jsonrpc2.Client - sessionID string -} - -// Experimental: AgentAPI contains experimental APIs that may change or be removed. -type AgentAPI sessionAPI +// Experimental: ContentExclusionAPI contains experimental APIs that may change or be +// removed. +type ContentExclusionAPI sessionAPI -// Deselect clears the selected custom agent and returns the session to the default agent. +// CheckPaths checks local file system absolute paths within the session working directory +// against its content-exclusion policy. Results preserve input order. Unsupported +// paths/filesystems and unavailable policy evaluation return available false, and callers +// must treat every requested path as excluded. +// +// RPC method: session.contentExclusion.checkPaths. +// +// Parameters: Local file system absolute paths within the session working directory to +// check against its content-exclusion policy. // -// RPC method: session.agent.deselect. -func (a *AgentAPI) Deselect(ctx context.Context) (*SessionAgentDeselectResult, error) { +// Returns: Batch content-exclusion result. Callers must fail closed when policy evaluation +// is unavailable. +func (a *ContentExclusionAPI) CheckPaths(ctx context.Context, params *ContentExclusionCheckPathsRequest) (*ContentExclusionCheckPathsResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.agent.deselect", req) + if params != nil { + req["paths"] = params.Paths + } + raw, err := a.client.Request(ctx, "session.contentExclusion.checkPaths", req) if err != nil { return nil, err } - var result SessionAgentDeselectResult + var result ContentExclusionCheckPathsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetCurrent gets the currently selected custom agent for the session. +// Experimental: DebugAPI contains experimental APIs that may change or be removed. +type DebugAPI sessionAPI + +// CollectLogs collects a session debug log bundle into a local archive or staging +// directory. Logs are redacted by default; redaction can be configured per caller-provided +// diagnostic entry. The runtime includes session-owned logs by default and accepts +// caller-provided diagnostic entries so host applications can add their own files without +// changing this API shape. // -// RPC method: session.agent.getCurrent. +// RPC method: session.debug.collectLogs. // -// Returns: The currently selected custom agent, or null when using the default agent. -func (a *AgentAPI) GetCurrent(ctx context.Context) (*AgentGetCurrentResult, error) { +// Parameters: Options for collecting a session debug bundle with configurable redaction. +// +// Returns: Result of collecting a session debug bundle. +func (a *DebugAPI) CollectLogs(ctx context.Context, params *DebugCollectLogsRequest) (*DebugCollectLogsResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.agent.getCurrent", req) + if params != nil { + if params.AdditionalEntries != nil { + req["additionalEntries"] = params.AdditionalEntries + } + req["destination"] = params.Destination + if params.Include != nil { + req["include"] = *params.Include + } + } + raw, err := a.client.Request(ctx, "session.debug.collectLogs", req) if err != nil { return nil, err } - var result AgentGetCurrentResult + var result DebugCollectLogsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists agents available to the session. Defaults to custom agents only; pass -// includeBuiltInAgents to include the effective built-in agents. +// Experimental: EventLogAPI contains experimental APIs that may change or be removed. +type EventLogAPI sessionAPI + +// Reads a batch of session events from a cursor, optionally waiting for new events. +// Supports tail-first reads via `direction: backward`. // -// RPC method: session.agent.list. +// RPC method: session.eventLog.read. // -// Parameters: Controls whether built-in agents and authored prompt text are included. +// Parameters: Cursor, batch size, and optional long-poll/filter parameters for reading +// session events. // -// Returns: Agents available to the session. -func (a *AgentAPI) List(ctx context.Context, params ...*SessionAgentListRequest) (*AgentList, error) { - var requestParams *SessionAgentListRequest - if len(params) > 0 { - requestParams = params[0] - } +// Returns: Batch of session events returned by a read, with cursor and continuation +// metadata. +func (a *EventLogAPI) Read(ctx context.Context, params *EventLogReadRequest) (*EventsReadResult, error) { req := map[string]any{"sessionId": a.sessionID} - if requestParams != nil { - if requestParams.IncludeBuiltInAgents != nil { - req["includeBuiltInAgents"] = *requestParams.IncludeBuiltInAgents + if params != nil { + if params.AgentIDs != nil { + req["agentIds"] = params.AgentIDs } - if requestParams.IncludePrompt != nil { - req["includePrompt"] = *requestParams.IncludePrompt + if params.AgentScope != nil { + req["agentScope"] = *params.AgentScope + } + if params.Cursor != nil { + req["cursor"] = *params.Cursor + } + if params.Direction != nil { + req["direction"] = *params.Direction + } + if params.IncludeEphemeral != nil { + req["includeEphemeral"] = *params.IncludeEphemeral + } + if params.Max != nil { + req["max"] = *params.Max + } + if params.Types != nil { + req["types"] = *params.Types + } + if params.WaitMs != nil { + req["waitMs"] = *params.WaitMs } } - raw, err := a.client.Request(ctx, "session.agent.list", req) + raw, err := a.client.Request(ctx, "session.eventLog.read", req) if err != nil { return nil, err } - var result AgentList + var result EventsReadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Reloads custom agent definitions and returns the refreshed list. +// RegisterInterest registers consumer interest in an event type for runtime gating purposes. // -// RPC method: session.agent.reload. +// RPC method: session.eventLog.registerInterest. // -// Returns: Custom agents available to the session after reloading definitions from disk. -func (a *AgentAPI) Reload(ctx context.Context) (*AgentReloadResult, error) { +// Parameters: Event type to register consumer interest for, used by runtime gating logic. +// +// Returns: Opaque handle representing an event-type interest registration. +func (a *EventLogAPI) RegisterInterest(ctx context.Context, params *RegisterEventInterestParams) (*RegisterEventInterestResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.agent.reload", req) + if params != nil { + req["eventType"] = params.EventType + } + raw, err := a.client.Request(ctx, "session.eventLog.registerInterest", req) if err != nil { return nil, err } - var result AgentReloadResult + var result RegisterEventInterestResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Selects a custom agent for subsequent turns in the session. +// ReleaseInterest releases a consumer's previously-registered interest in an event type. // -// RPC method: session.agent.select. +// RPC method: session.eventLog.releaseInterest. // -// Parameters: Name of the custom agent to select for subsequent turns. +// Parameters: Opaque handle previously returned by `registerInterest` to release. // -// Returns: The newly selected custom agent. -func (a *AgentAPI) Select(ctx context.Context, params *AgentSelectRequest) (*AgentSelectResult, error) { +// Returns: Indicates whether the operation succeeded. +func (a *EventLogAPI) ReleaseInterest(ctx context.Context, params *ReleaseEventInterestParams) (*EventLogReleaseInterestResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["name"] = params.Name + req["handle"] = params.Handle } - raw, err := a.client.Request(ctx, "session.agent.select", req) + raw, err := a.client.Request(ctx, "session.eventLog.releaseInterest", req) if err != nil { return nil, err } - var result AgentSelectResult + var result EventLogReleaseInterestResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetPrompt sets an in-memory authored prompt override for an available agent. For built-in -// agents, this replaces only the static base prompt while preserving runtime-owned dynamic -// prompt composition and behavior. The special `general-purpose` agent is not overrideable. -// Overrides are not persisted; resumed and forked sessions start without them, so the host -// must re-apply them. +// Tail returns a snapshot of the current tail cursor without consuming events. // -// RPC method: session.agent.setPrompt. +// RPC method: session.eventLog.tail. // -// Parameters: An in-memory authored prompt override for an available agent. -func (a *AgentAPI) SetPrompt(ctx context.Context, params *AgentSetPromptRequest) (*SessionAgentSetPromptResult, error) { +// Returns: Snapshot of the current tail cursor without returning any events. Use this when +// a consumer wants to subscribe to live events going forward without first paginating +// through the entire persisted history (which would happen if `read` were called without a +// cursor on a long-lived session). +func (a *EventLogAPI) Tail(ctx context.Context) (*EventLogTailResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["id"] = params.ID - req["prompt"] = params.Prompt - } - raw, err := a.client.Request(ctx, "session.agent.setPrompt", req) + raw, err := a.client.Request(ctx, "session.eventLog.tail", req) if err != nil { return nil, err } - var result SessionAgentSetPromptResult + var result EventLogTailResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: AutopilotObjectiveAPI contains experimental APIs that may change or be -// removed. -type AutopilotObjectiveAPI sessionAPI +// Experimental: ExtensionsAPI contains experimental APIs that may change or be removed. +type ExtensionsAPI sessionAPI -// GetState reads the current canonical autopilot objective state for this session. +// Disables an extension for the session. // -// RPC method: session.autopilotObjective.getState. +// RPC method: session.extensions.disable. // -// Returns: Canonical runtime state for the session's current autopilot objective. -func (a *AutopilotObjectiveAPI) GetState(ctx context.Context) (*AutopilotObjectiveGetStateResult, error) { +// Parameters: Source-qualified extension identifier to disable for the session. +func (a *ExtensionsAPI) Disable(ctx context.Context, params *ExtensionsDisableRequest) (*SessionExtensionsDisableResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.autopilotObjective.getState", req) + if params != nil { + req["id"] = params.ID + } + raw, err := a.client.Request(ctx, "session.extensions.disable", req) if err != nil { return nil, err } - var result AutopilotObjectiveGetStateResult + var result SessionExtensionsDisableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: CanvasAPI contains experimental APIs that may change or be removed. -type CanvasAPI sessionAPI - -// Closes an open canvas instance. +// Enables an extension for the session. // -// RPC method: session.canvas.close. +// RPC method: session.extensions.enable. // -// Parameters: Canvas close parameters. -func (a *CanvasAPI) Close(ctx context.Context, params *CanvasCloseRequest) (*SessionCanvasCloseResult, error) { +// Parameters: Source-qualified extension identifier to enable for the session. +func (a *ExtensionsAPI) Enable(ctx context.Context, params *ExtensionsEnableRequest) (*SessionExtensionsEnableResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["instanceId"] = params.InstanceID + req["id"] = params.ID } - raw, err := a.client.Request(ctx, "session.canvas.close", req) + raw, err := a.client.Request(ctx, "session.extensions.enable", req) if err != nil { return nil, err } - var result SessionCanvasCloseResult + var result SessionExtensionsEnableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists canvases declared for the session. +// Lists extensions discovered for the session and their current status. // -// RPC method: session.canvas.list. +// RPC method: session.extensions.list. // -// Returns: Declared canvases available in this session. -func (a *CanvasAPI) List(ctx context.Context) (*CanvasList, error) { +// Returns: Extensions discovered for the session, with their current status. +func (a *ExtensionsAPI) List(ctx context.Context) (*ExtensionList, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.canvas.list", req) + raw, err := a.client.Request(ctx, "session.extensions.list", req) if err != nil { return nil, err } - var result CanvasList + var result ExtensionList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ListOpen lists currently open canvas instances for the live session. -// -// RPC method: session.canvas.listOpen. +// Reloads extension definitions and processes for the session. // -// Returns: Live open-canvas snapshot. -func (a *CanvasAPI) ListOpen(ctx context.Context) (*CanvasListOpenResult, error) { +// RPC method: session.extensions.reload. +func (a *ExtensionsAPI) Reload(ctx context.Context) (*SessionExtensionsReloadResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.canvas.listOpen", req) + raw, err := a.client.Request(ctx, "session.extensions.reload", req) if err != nil { return nil, err } - var result CanvasListOpenResult + var result SessionExtensionsReloadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Opens or focuses a canvas instance. -// -// RPC method: session.canvas.open. +// SendAttachmentsToMessage push attachments into the next user-message turn from an +// extension. The host should surface them as composer pills and forward them via the next +// session.send call. Callable only by extension-owned connections. // -// Parameters: Canvas open parameters. +// RPC method: session.extensions.sendAttachmentsToMessage. // -// Returns: Open canvas instance snapshot. -func (a *CanvasAPI) Open(ctx context.Context, params *CanvasOpenRequest) (*OpenCanvasInstance, error) { +// Parameters: Parameters for session.extensions.sendAttachmentsToMessage. +func (a *ExtensionsAPI) SendAttachmentsToMessage(ctx context.Context, params *SendAttachmentsToMessageParams) (*SessionExtensionsSendAttachmentsToMessageResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["canvasId"] = params.CanvasID - if params.ExtensionID != nil { - req["extensionId"] = *params.ExtensionID - } - if params.Input != nil { - req["input"] = params.Input + req["attachments"] = params.Attachments + if params.InstanceID != nil { + req["instanceId"] = *params.InstanceID } - req["instanceId"] = params.InstanceID } - raw, err := a.client.Request(ctx, "session.canvas.open", req) + raw, err := a.client.Request(ctx, "session.extensions.sendAttachmentsToMessage", req) + if err != nil { + return nil, err + } + var result SessionExtensionsSendAttachmentsToMessageResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Experimental: FactoryAPI contains experimental APIs that may change or be removed. +type FactoryAPI sessionAPI + +// Agent runs one factory-scoped subagent and returns its result. +// +// RPC method: session.factory.agent. +// +// Parameters: Parameters for one factory-scoped subagent call. +// +// Returns: Result of one factory-scoped subagent call. +func (a *FactoryAPI) Agent(ctx context.Context, params *FactoryAgentRequest) (*FactoryAgentResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["executionToken"] = params.ExecutionToken + req["factoryRunId"] = params.FactoryRunID + req["opts"] = params.Opts + req["prompt"] = params.Prompt + } + raw, err := a.client.Request(ctx, "session.factory.agent", req) if err != nil { return nil, err } - var result OpenCanvasInstance + var result FactoryAgentResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: CanvasActionAPI contains experimental APIs that may change or be removed. -type CanvasActionAPI sessionAPI - -// Invokes an action on an open canvas instance. +// Cancel requests cancellation of a factory run and returns its run envelope. // -// RPC method: session.canvas.action.invoke. +// RPC method: session.factory.cancel. // -// Parameters: Canvas action invocation parameters. +// Parameters: Parameters for cancelling a factory run. // -// Returns: Canvas action invocation result. -func (a *CanvasActionAPI) Invoke(ctx context.Context, params *CanvasActionInvokeRequest) (*CanvasActionInvokeResult, error) { +// Returns: Complete current or terminal factory run envelope. +func (a *FactoryAPI) Cancel(ctx context.Context, params *FactoryCancelRequest) (*FactoryRunResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["actionName"] = params.ActionName - if params.Input != nil { - req["input"] = params.Input - } - req["instanceId"] = params.InstanceID + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.canvas.action.invoke", req) + raw, err := a.client.Request(ctx, "session.factory.cancel", req) if err != nil { return nil, err } - var result CanvasActionInvokeResult + var result FactoryRunResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Action returns experimental APIs that may change or be removed. -func (s *CanvasAPI) Action() *CanvasActionAPI { - return (*CanvasActionAPI)(s) -} - -// Experimental: CommandsAPI contains experimental APIs that may change or be removed. -type CommandsAPI sessionAPI - -// Enqueues a slash command for FIFO processing on the local session. +// GetRun gets the current or settled envelope for a factory run. // -// RPC method: session.commands.enqueue. +// RPC method: session.factory.getRun. // -// Parameters: Slash-prefixed command string to enqueue for FIFO processing. +// Parameters: Parameters for retrieving a factory run. // -// Returns: Indicates whether the command was accepted into the local execution queue. -func (a *CommandsAPI) Enqueue(ctx context.Context, params *EnqueueCommandParams) (*EnqueueCommandResult, error) { +// Returns: Complete current or terminal factory run envelope. +func (a *FactoryAPI) GetRun(ctx context.Context, params *FactoryGetRunRequest) (*FactoryRunResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["command"] = params.Command - if params.DisplayText != nil { - req["displayText"] = *params.DisplayText - } + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.commands.enqueue", req) + raw, err := a.client.Request(ctx, "session.factory.getRun", req) if err != nil { return nil, err } - var result EnqueueCommandResult + var result FactoryRunResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Executes a slash command synchronously and returns any error. +// GetRunDetail gets durable and live observability detail for one factory run. // -// RPC method: session.commands.execute. +// RPC method: session.factory.getRunDetail. // -// Parameters: Slash command name and argument string to execute synchronously. +// Parameters: Parameters for retrieving a factory run. // -// Returns: Error message produced while executing the command, if any. -func (a *CommandsAPI) Execute(ctx context.Context, params *ExecuteCommandParams) (*ExecuteCommandResult, error) { +// Returns: Full factory run observability detail. +func (a *FactoryAPI) GetRunDetail(ctx context.Context, params *FactoryGetRunRequest) (*FactoryRunDetail, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["args"] = params.Args - req["commandName"] = params.CommandName + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.commands.execute", req) + raw, err := a.client.Request(ctx, "session.factory.getRunDetail", req) if err != nil { return nil, err } - var result ExecuteCommandResult + var result FactoryRunDetail if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingCommand reports completion of a pending client-handled slash command. +// GetRunProgress pages durable progress for one factory run. // -// RPC method: session.commands.handlePendingCommand. +// RPC method: session.factory.getRunProgress. // -// Parameters: Pending command request ID and an optional error if the client handler failed. +// Parameters: Parameters for paging factory progress. // -// Returns: Indicates whether the pending client-handled command was completed successfully. -func (a *CommandsAPI) HandlePendingCommand(ctx context.Context, params *CommandsHandlePendingCommandRequest) (*CommandsHandlePendingCommandResult, error) { +// Returns: A bidirectional page of factory progress. +func (a *FactoryAPI) GetRunProgress(ctx context.Context, params *FactoryGetRunProgressRequest) (*FactoryProgressPage, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Error != nil { - req["error"] = *params.Error + if params.AfterSeq != nil { + req["afterSeq"] = *params.AfterSeq } - req["requestId"] = params.RequestID + if params.BeforeSeq != nil { + req["beforeSeq"] = *params.BeforeSeq + } + if params.Limit != nil { + req["limit"] = *params.Limit + } + if params.PhaseID != nil { + req["phaseId"] = *params.PhaseID + } + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.commands.handlePendingCommand", req) + raw, err := a.client.Request(ctx, "session.factory.getRunProgress", req) if err != nil { return nil, err } - var result CommandsHandlePendingCommandResult + var result FactoryProgressPage if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Invokes a slash command in the session. +// ListRuns lists durable factory runs for this session in creation order. // -// RPC method: session.commands.invoke. +// RPC method: session.factory.listRuns. // -// Parameters: Slash command name and optional raw input string to invoke. +// Parameters: Parameters for paging factory runs. // -// Returns: Result of invoking the slash command (text output, prompt to send to the agent, -// completion, or subcommand selection). -func (a *CommandsAPI) Invoke(ctx context.Context, params *CommandsInvokeRequest) (SlashCommandInvocationResult, error) { +// Returns: A page of factory runs in durable creation order. +func (a *FactoryAPI) ListRuns(ctx context.Context, params *FactoryListRunsRequest) (*FactoryListRunsResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Input != nil { - req["input"] = *params.Input + if params.AfterSeq != nil { + req["afterSeq"] = *params.AfterSeq } - req["name"] = params.Name - if params.Origin != nil { - req["origin"] = *params.Origin + if params.BeforeSeq != nil { + req["beforeSeq"] = *params.BeforeSeq + } + if params.Limit != nil { + req["limit"] = *params.Limit } } - raw, err := a.client.Request(ctx, "session.commands.invoke", req) + raw, err := a.client.Request(ctx, "session.factory.listRuns", req) if err != nil { return nil, err } - result, err := unmarshalSlashCommandInvocationResult(raw) - if err != nil { + var result FactoryListRunsResult + if err := json.Unmarshal(raw, &result); err != nil { return nil, err } - return result, nil + return &result, nil } -// Lists slash commands available in the session. +// Log records a batch of ordered factory progress lines. // -// RPC method: session.commands.list. +// RPC method: session.factory.log. // -// Parameters: Optional filters controlling which command sources to include in the listing. +// Parameters: Parameters for recording factory progress. // -// Returns: Slash commands available in the session, after applying any include/exclude -// filters. -func (a *CommandsAPI) List(ctx context.Context, params ...*SessionCommandsListRequest) (*CommandList, error) { - var requestParams *SessionCommandsListRequest - if len(params) > 0 { - requestParams = params[0] - } +// Returns: Acknowledgement that a factory request was accepted. +func (a *FactoryAPI) Log(ctx context.Context, params *FactoryLogRequest) (*FactoryAckResult, error) { req := map[string]any{"sessionId": a.sessionID} - if requestParams != nil { - if requestParams.IncludeBuiltins != nil { - req["includeBuiltins"] = *requestParams.IncludeBuiltins - } - if requestParams.IncludeClientCommands != nil { - req["includeClientCommands"] = *requestParams.IncludeClientCommands - } - if requestParams.IncludeSkills != nil { - req["includeSkills"] = *requestParams.IncludeSkills - } + if params != nil { + req["executionToken"] = params.ExecutionToken + req["lines"] = params.Lines + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.commands.list", req) + raw, err := a.client.Request(ctx, "session.factory.log", req) if err != nil { return nil, err } - var result CommandList + var result FactoryAckResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RespondToQueuedCommand reports whether the host actually executed a queued command and -// whether to continue processing. +// Pauses a running factory and returns its settled run envelope. // -// RPC method: session.commands.respondToQueuedCommand. +// RPC method: session.factory.pause. // -// Parameters: Queued-command request ID and the result indicating whether the host executed -// it (and whether to stop processing further queued commands). +// Parameters: Parameters for pausing a running factory. // -// Returns: Indicates whether the queued-command response was matched to a pending request. -func (a *CommandsAPI) RespondToQueuedCommand(ctx context.Context, params *CommandsRespondToQueuedCommandRequest) (*CommandsRespondToQueuedCommandResult, error) { +// Returns: Complete current or terminal factory run envelope. +func (a *FactoryAPI) Pause(ctx context.Context, params *FactoryPauseRequest) (*FactoryRunResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["requestId"] = params.RequestID - req["result"] = params.Result + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.commands.respondToQueuedCommand", req) + raw, err := a.client.Request(ctx, "session.factory.pause", req) if err != nil { return nil, err } - var result CommandsRespondToQueuedCommandResult + var result FactoryRunResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: CompletionsAPI contains experimental APIs that may change or be removed. -type CompletionsAPI sessionAPI - -// GetTriggerCharacters gets the characters that should trigger host-driven completions for -// the session. Empty disables host-driven completions (e.g. local sessions, or a relay host -// that does not advertise them). +// Resumes a factory run using its persisted name, arguments, journal, and accounting. // -// RPC method: session.completions.getTriggerCharacters. +// RPC method: session.factory.resume. // -// Returns: Characters that, when typed in the composer, should trigger a -// `completions.request`. Empty when the session has no host-driven completions (e.g. local -// sessions, or a relay host that does not advertise `completionTriggerCharacters`). -func (a *CompletionsAPI) GetTriggerCharacters(ctx context.Context) (*CompletionsGetTriggerCharactersResult, error) { +// Parameters: Parameters for resuming a factory run from its persisted identity. +// +// Returns: Resolved persisted factory identity and resumed run envelope. +func (a *FactoryAPI) Resume(ctx context.Context, params *FactoryResumeRequest) (*FactoryResumeResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.completions.getTriggerCharacters", req) + if params != nil { + if params.Limits != nil { + req["limits"] = *params.Limits + } + if params.LogPhaseNames != nil { + req["logPhaseNames"] = *params.LogPhaseNames + } + if params.NotifyOnComplete != nil { + req["notifyOnComplete"] = *params.NotifyOnComplete + } + req["runId"] = params.RunID + } + raw, err := a.client.Request(ctx, "session.factory.resume", req) if err != nil { return nil, err } - var result CompletionsGetTriggerCharactersResult + var result FactoryResumeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Requests host-driven completion items for the current composer input. Returns an empty -// list when the host has no items or does not support completions. +// Runs a registered factory by name at the top level. // -// RPC method: session.completions.request. +// RPC method: session.factory.run. // -// Parameters: Request host-driven completions for the current composer input. +// Parameters: Parameters for invoking a registered factory. // -// Returns: Host-driven completion items for the current composer input. Empty when the host -// returns no items or does not support completions. -func (a *CompletionsAPI) Request(ctx context.Context, params *CompletionsRequestRequest) (*CompletionsRequestResult, error) { +// Returns: Complete current or terminal factory run envelope. +func (a *FactoryAPI) Run(ctx context.Context, params *FactoryRunRequest) (*FactoryRunResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["offset"] = params.Offset - req["text"] = params.Text + req["args"] = params.Args + req["name"] = params.Name + if params.Options != nil { + req["options"] = *params.Options + } } - raw, err := a.client.Request(ctx, "session.completions.request", req) + raw, err := a.client.Request(ctx, "session.factory.run", req) if err != nil { return nil, err } - var result CompletionsRequestResult + var result FactoryRunResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ContentExclusionAPI contains experimental APIs that may change or be -// removed. -type ContentExclusionAPI sessionAPI - -// CheckPaths checks local file system absolute paths within the session working directory -// against its content-exclusion policy. Results preserve input order. Unsupported -// paths/filesystems and unavailable policy evaluation return available false, and callers -// must treat every requested path as excluded. +// Experimental: FactoryJournalAPI contains experimental APIs that may change or be removed. +type FactoryJournalAPI sessionAPI + +// Get reads a memoized factory journal entry. // -// RPC method: session.contentExclusion.checkPaths. +// RPC method: session.factory.journal.get. // -// Parameters: Local file system absolute paths within the session working directory to -// check against its content-exclusion policy. +// Parameters: Parameters for reading a factory journal entry. // -// Returns: Batch content-exclusion result. Callers must fail closed when policy evaluation -// is unavailable. -func (a *ContentExclusionAPI) CheckPaths(ctx context.Context, params *ContentExclusionCheckPathsRequest) (*ContentExclusionCheckPathsResult, error) { +// Returns: Result of reading a factory journal entry. +func (a *FactoryJournalAPI) Get(ctx context.Context, params *FactoryJournalGetRequest) (*FactoryJournalGetResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["paths"] = params.Paths + req["executionToken"] = params.ExecutionToken + req["key"] = params.Key + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.contentExclusion.checkPaths", req) + raw, err := a.client.Request(ctx, "session.factory.journal.get", req) if err != nil { return nil, err } - var result ContentExclusionCheckPathsResult + var result FactoryJournalGetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: DebugAPI contains experimental APIs that may change or be removed. -type DebugAPI sessionAPI - -// CollectLogs collects a session debug log bundle into a local archive or staging -// directory. Logs are redacted by default; redaction can be configured per caller-provided -// diagnostic entry. The runtime includes session-owned logs by default and accepts -// caller-provided diagnostic entries so host applications can add their own files without -// changing this API shape. +// Put stores a memoized factory journal entry. // -// RPC method: session.debug.collectLogs. +// RPC method: session.factory.journal.put. // -// Parameters: Options for collecting a session debug bundle with configurable redaction. +// Parameters: Parameters for storing a factory journal entry. // -// Returns: Result of collecting a session debug bundle. -func (a *DebugAPI) CollectLogs(ctx context.Context, params *DebugCollectLogsRequest) (*DebugCollectLogsResult, error) { +// Returns: Acknowledgement that a factory request was accepted. +func (a *FactoryJournalAPI) Put(ctx context.Context, params *FactoryJournalPutRequest) (*FactoryAckResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.AdditionalEntries != nil { - req["additionalEntries"] = params.AdditionalEntries - } - req["destination"] = params.Destination - if params.Include != nil { - req["include"] = *params.Include - } + req["executionToken"] = params.ExecutionToken + req["key"] = params.Key + req["resultJson"] = params.ResultJSON + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.debug.collectLogs", req) + raw, err := a.client.Request(ctx, "session.factory.journal.put", req) if err != nil { return nil, err } - var result DebugCollectLogsResult + var result FactoryAckResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: EventLogAPI contains experimental APIs that may change or be removed. -type EventLogAPI sessionAPI +// Experimental: Journal returns experimental APIs that may change or be removed. +func (s *FactoryAPI) Journal() *FactoryJournalAPI { + return (*FactoryJournalAPI)(s) +} -// Reads a batch of session events from a cursor, optionally waiting for new events. -// Supports tail-first reads via `direction: backward`. +// Experimental: FleetAPI contains experimental APIs that may change or be removed. +type FleetAPI sessionAPI + +// Starts fleet mode by submitting the fleet orchestration prompt to the session. // -// RPC method: session.eventLog.read. +// RPC method: session.fleet.start. // -// Parameters: Cursor, batch size, and optional long-poll/filter parameters for reading -// session events. +// Parameters: Parameters for starting fleet orchestration: an optional user prompt combined +// with the fleet instructions, plus the send options forwarded to the resulting turn. // -// Returns: Batch of session events returned by a read, with cursor and continuation -// metadata. -func (a *EventLogAPI) Read(ctx context.Context, params *EventLogReadRequest) (*EventsReadResult, error) { +// Returns: Indicates whether fleet mode was successfully activated. +func (a *FleetAPI) Start(ctx context.Context, params *FleetStartRequest) (*FleetStartResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.AgentIDs != nil { - req["agentIds"] = params.AgentIDs - } - if params.AgentScope != nil { - req["agentScope"] = *params.AgentScope - } - if params.Cursor != nil { - req["cursor"] = *params.Cursor - } - if params.Direction != nil { - req["direction"] = *params.Direction - } - if params.IncludeEphemeral != nil { - req["includeEphemeral"] = *params.IncludeEphemeral + if params.Attachments != nil { + req["attachments"] = params.Attachments } - if params.Max != nil { - req["max"] = *params.Max + if params.Billable != nil { + req["billable"] = *params.Billable } - if params.Types != nil { - req["types"] = *params.Types + if params.Prompt != nil { + req["prompt"] = *params.Prompt } - if params.WaitMs != nil { - req["waitMs"] = *params.WaitMs + if params.Wait != nil { + req["wait"] = *params.Wait } } - raw, err := a.client.Request(ctx, "session.eventLog.read", req) + raw, err := a.client.Request(ctx, "session.fleet.start", req) if err != nil { return nil, err } - var result EventsReadResult + var result FleetStartResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RegisterInterest registers consumer interest in an event type for runtime gating purposes. -// -// RPC method: session.eventLog.registerInterest. +// Experimental: GitHubAuthAPI contains experimental APIs that may change or be removed. +type GitHubAuthAPI sessionAPI + +// GetStatus gets authentication status and account metadata for the session. // -// Parameters: Event type to register consumer interest for, used by runtime gating logic. +// RPC method: session.gitHubAuth.getStatus. // -// Returns: Opaque handle representing an event-type interest registration. -func (a *EventLogAPI) RegisterInterest(ctx context.Context, params *RegisterEventInterestParams) (*RegisterEventInterestResult, error) { +// Returns: Authentication status and account metadata for the session. +func (a *GitHubAuthAPI) GetStatus(ctx context.Context) (*SessionAuthStatus, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["eventType"] = params.EventType - } - raw, err := a.client.Request(ctx, "session.eventLog.registerInterest", req) + raw, err := a.client.Request(ctx, "session.gitHubAuth.getStatus", req) if err != nil { return nil, err } - var result RegisterEventInterestResult + var result SessionAuthStatus if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ReleaseInterest releases a consumer's previously-registered interest in an event type. +// SetCredentials updates the session's auth credentials used for outbound model and API +// requests. // -// RPC method: session.eventLog.releaseInterest. +// RPC method: session.gitHubAuth.setCredentials. // -// Parameters: Opaque handle previously returned by `registerInterest` to release. +// Parameters: New auth credentials to install on the session. Omit to leave credentials +// unchanged. // -// Returns: Indicates whether the operation succeeded. -func (a *EventLogAPI) ReleaseInterest(ctx context.Context, params *ReleaseEventInterestParams) (*EventLogReleaseInterestResult, error) { +// Returns: Indicates whether the credential update succeeded. +func (a *GitHubAuthAPI) SetCredentials(ctx context.Context, params *SessionSetCredentialsParams) (*SessionSetCredentialsResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["handle"] = params.Handle + if params.Credentials != nil { + req["credentials"] = params.Credentials + } } - raw, err := a.client.Request(ctx, "session.eventLog.releaseInterest", req) + raw, err := a.client.Request(ctx, "session.gitHubAuth.setCredentials", req) if err != nil { return nil, err } - var result EventLogReleaseInterestResult + var result SessionSetCredentialsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Tail returns a snapshot of the current tail cursor without consuming events. +// Experimental: HistoryAPI contains experimental APIs that may change or be removed. +type HistoryAPI sessionAPI + +// AbortManualCompaction aborts any in-progress manual compaction on a local session. // -// RPC method: session.eventLog.tail. +// RPC method: session.history.abortManualCompaction. // -// Returns: Snapshot of the current tail cursor without returning any events. Use this when -// a consumer wants to subscribe to live events going forward without first paginating -// through the entire persisted history (which would happen if `read` were called without a -// cursor on a long-lived session). -func (a *EventLogAPI) Tail(ctx context.Context) (*EventLogTailResult, error) { +// Returns: Indicates whether an in-progress manual compaction was aborted. +func (a *HistoryAPI) AbortManualCompaction(ctx context.Context) (*HistoryAbortManualCompactionResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.eventLog.tail", req) + raw, err := a.client.Request(ctx, "session.history.abortManualCompaction", req) if err != nil { return nil, err } - var result EventLogTailResult + var result HistoryAbortManualCompactionResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ExtensionsAPI contains experimental APIs that may change or be removed. -type ExtensionsAPI sessionAPI - -// Disables an extension for the session. +// CancelBackgroundCompaction cancels any in-progress background compaction on a local +// session. // -// RPC method: session.extensions.disable. +// RPC method: session.history.cancelBackgroundCompaction. // -// Parameters: Source-qualified extension identifier to disable for the session. -func (a *ExtensionsAPI) Disable(ctx context.Context, params *ExtensionsDisableRequest) (*SessionExtensionsDisableResult, error) { +// Returns: Indicates whether an in-progress background compaction was cancelled. +func (a *HistoryAPI) CancelBackgroundCompaction(ctx context.Context) (*HistoryCancelBackgroundCompactionResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["id"] = params.ID - } - raw, err := a.client.Request(ctx, "session.extensions.disable", req) + raw, err := a.client.Request(ctx, "session.history.cancelBackgroundCompaction", req) if err != nil { return nil, err } - var result SessionExtensionsDisableResult + var result HistoryCancelBackgroundCompactionResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Enables an extension for the session. +// ClearContext clears the session's conversation history, keeping only system and developer +// messages, and seeds the fresh context window with a first user message. Must be called +// from inside a tool handler: the clear has to drop the results of the tool calls its wipe +// orphans, and it rejects when no tool call is in flight. // -// RPC method: session.extensions.enable. +// RPC method: session.history.clearContext. // -// Parameters: Source-qualified extension identifier to enable for the session. -func (a *ExtensionsAPI) Enable(ctx context.Context, params *ExtensionsEnableRequest) (*SessionExtensionsEnableResult, error) { +// Parameters: Parameters for clearing the conversation and seeding the window that replaces +// it. +// +// Returns: What a successful clear removed. A clear that could not be applied rejects +// instead of reporting a count. +func (a *HistoryAPI) ClearContext(ctx context.Context, params *HistoryClearContextRequest) (*HistoryClearContextResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["id"] = params.ID + req["prompt"] = params.Prompt } - raw, err := a.client.Request(ctx, "session.extensions.enable", req) + raw, err := a.client.Request(ctx, "session.history.clearContext", req) if err != nil { return nil, err } - var result SessionExtensionsEnableResult + var result HistoryClearContextResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists extensions discovered for the session and their current status. +// Compacts the session history to reduce context usage. // -// RPC method: session.extensions.list. +// RPC method: session.history.compact. // -// Returns: Extensions discovered for the session, with their current status. -func (a *ExtensionsAPI) List(ctx context.Context) (*ExtensionList, error) { +// Parameters: Optional compaction parameters. +// +// Returns: Compaction outcome with the number of tokens and messages removed, summary text, +// and the resulting context window breakdown. +func (a *HistoryAPI) Compact(ctx context.Context, params ...*SessionHistoryCompactRequest) (*HistoryCompactResult, error) { + var requestParams *SessionHistoryCompactRequest + if len(params) > 0 { + requestParams = params[0] + } req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.extensions.list", req) + if requestParams != nil { + if requestParams.CustomInstructions != nil { + req["customInstructions"] = *requestParams.CustomInstructions + } + if requestParams.TokenLimit != nil { + req["tokenLimit"] = *requestParams.TokenLimit + } + if requestParams.Trigger != nil { + req["trigger"] = *requestParams.Trigger + } + } + raw, err := a.client.Request(ctx, "session.history.compact", req) if err != nil { return nil, err } - var result ExtensionList + var result HistoryCompactResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Reloads extension definitions and processes for the session. +// ListRewindPoints lists the user turns that the session can rewind to. Never rejects for a +// busy session: rewind reads need the session's file-change captures to be settled, so a +// session that still holds active work answers with `unavailableReason: "session-busy"` and +// no points, which the caller can retry. // -// RPC method: session.extensions.reload. -func (a *ExtensionsAPI) Reload(ctx context.Context) (*SessionExtensionsReloadResult, error) { +// RPC method: session.history.listRewindPoints. +// +// Returns: Rewind points and file-change-tracking availability for the session. +func (a *HistoryAPI) ListRewindPoints(ctx context.Context) (*HistoryListRewindPointsResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.extensions.reload", req) + raw, err := a.client.Request(ctx, "session.history.listRewindPoints", req) if err != nil { return nil, err } - var result SessionExtensionsReloadResult + var result HistoryListRewindPointsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } - -// SendAttachmentsToMessage push attachments into the next user-message turn from an -// extension. The host should surface them as composer pills and forward them via the next -// session.send call. Callable only by extension-owned connections. + +// PreviewRewind previews the files that a conversation-and-files rewind would restore. // -// RPC method: session.extensions.sendAttachmentsToMessage. +// RPC method: session.history.previewRewind. // -// Parameters: Parameters for session.extensions.sendAttachmentsToMessage. -func (a *ExtensionsAPI) SendAttachmentsToMessage(ctx context.Context, params *SendAttachmentsToMessageParams) (*SessionExtensionsSendAttachmentsToMessageResult, error) { +// Parameters: Event boundary to preview for conversation-and-files rewind. +// +// Returns: Files and aggregate changes for a prospective rewind. +func (a *HistoryAPI) PreviewRewind(ctx context.Context, params *HistoryPreviewRewindRequest) (*HistoryPreviewRewindResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["attachments"] = params.Attachments - if params.InstanceID != nil { - req["instanceId"] = *params.InstanceID - } + req["eventId"] = params.EventID } - raw, err := a.client.Request(ctx, "session.extensions.sendAttachmentsToMessage", req) + raw, err := a.client.Request(ctx, "session.history.previewRewind", req) if err != nil { return nil, err } - var result SessionExtensionsSendAttachmentsToMessageResult + var result HistoryPreviewRewindResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: FactoryAPI contains experimental APIs that may change or be removed. -type FactoryAPI sessionAPI - -// Agent runs one factory-scoped subagent and returns its result. +// Rewinds the session conversation, optionally restoring files changed by the discarded +// turns. Not crash-atomic: file restore and conversation truncation are separate stores, +// applied in that order, so a process crash between them can leave the workspace rewound +// while the conversation still contains the discarded turns. There is no recovery journal; +// re-running the same rewind is the recovery path for a crash before truncation lands, +// since file restore is idempotent (already-restored files are reported as skipped) and +// truncation is re-derived from the still-retained boundary event. After truncation lands +// that boundary no longer exists, so the same request is rejected; the only stage that can +// still be outstanding is snapshot pruning, whose failure leaves orphan snapshots the +// capture store tolerates. The reverse inconsistency cannot occur, because truncation is +// never applied before file restore succeeds. // -// RPC method: session.factory.agent. +// RPC method: session.history.rewind. // -// Parameters: Parameters for one factory-scoped subagent call. +// Parameters: Boundary and mode for rewinding session history. // -// Returns: Result of one factory-scoped subagent call. -func (a *FactoryAPI) Agent(ctx context.Context, params *FactoryAgentRequest) (*FactoryAgentResult, error) { +// Returns: Structured outcome of a rewind request. +func (a *HistoryAPI) Rewind(ctx context.Context, params *HistoryRewindRequest) (*HistoryRewindResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["executionToken"] = params.ExecutionToken - req["factoryRunId"] = params.FactoryRunID - req["opts"] = params.Opts - req["prompt"] = params.Prompt + req["eventId"] = params.EventID + req["mode"] = params.Mode } - raw, err := a.client.Request(ctx, "session.factory.agent", req) + raw, err := a.client.Request(ctx, "session.history.rewind", req) if err != nil { return nil, err } - var result FactoryAgentResult + var result HistoryRewindResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Cancel requests cancellation of a factory run and returns its run envelope. -// -// RPC method: session.factory.cancel. +// SummarizeForHandoff produces a markdown summary of the session's conversation context for +// hand-off scenarios. // -// Parameters: Parameters for cancelling a factory run. +// RPC method: session.history.summarizeForHandoff. // -// Returns: Complete current or terminal factory run envelope. -func (a *FactoryAPI) Cancel(ctx context.Context, params *FactoryCancelRequest) (*FactoryRunResult, error) { +// Returns: Markdown summary of the conversation context (empty when not available). +func (a *HistoryAPI) SummarizeForHandoff(ctx context.Context) (*HistorySummarizeForHandoffResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["runId"] = params.RunID - } - raw, err := a.client.Request(ctx, "session.factory.cancel", req) + raw, err := a.client.Request(ctx, "session.history.summarizeForHandoff", req) if err != nil { return nil, err } - var result FactoryRunResult + var result HistorySummarizeForHandoffResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetRun gets the current or settled envelope for a factory run. +// Truncates persisted session history to a specific event. // -// RPC method: session.factory.getRun. +// RPC method: session.history.truncate. // -// Parameters: Parameters for retrieving a factory run. +// Parameters: Identifier of the event to truncate to; this event and all later events are +// removed. // -// Returns: Complete current or terminal factory run envelope. -func (a *FactoryAPI) GetRun(ctx context.Context, params *FactoryGetRunRequest) (*FactoryRunResult, error) { +// Returns: Number of events that were removed by the truncation. +func (a *HistoryAPI) Truncate(ctx context.Context, params *HistoryTruncateRequest) (*HistoryTruncateResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["runId"] = params.RunID + req["eventId"] = params.EventID } - raw, err := a.client.Request(ctx, "session.factory.getRun", req) + raw, err := a.client.Request(ctx, "session.history.truncate", req) if err != nil { return nil, err } - var result FactoryRunResult + var result HistoryTruncateResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetRunDetail gets durable and live observability detail for one factory run. -// -// RPC method: session.factory.getRunDetail. +// Experimental: InstructionsAPI contains experimental APIs that may change or be removed. +type InstructionsAPI sessionAPI + +// GetSources gets instruction sources loaded for the session. // -// Parameters: Parameters for retrieving a factory run. +// RPC method: session.instructions.getSources. // -// Returns: Full factory run observability detail. -func (a *FactoryAPI) GetRunDetail(ctx context.Context, params *FactoryGetRunRequest) (*FactoryRunDetail, error) { +// Returns: Instruction sources loaded for the session, in merge order. +func (a *InstructionsAPI) GetSources(ctx context.Context) (*InstructionsGetSourcesResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["runId"] = params.RunID - } - raw, err := a.client.Request(ctx, "session.factory.getRunDetail", req) + raw, err := a.client.Request(ctx, "session.instructions.getSources", req) if err != nil { return nil, err } - var result FactoryRunDetail + var result InstructionsGetSourcesResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetRunProgress pages durable progress for one factory run. +// Experimental: LimitPredictionAPI contains experimental APIs that may change or be removed. +type LimitPredictionAPI sessionAPI + +// Predicts an AI-credit session limit for the session's resolved model. Returns an +// unavailable result instead of falling back when the current model is unresolved auto. // -// RPC method: session.factory.getRunProgress. +// RPC method: session.limitPrediction.predict. // -// Parameters: Parameters for paging factory progress. +// Parameters: Parameters for predicting an AI-credit session limit. Omitting `modelId` uses +// the session's currently selected model. // -// Returns: A bidirectional page of factory progress. -func (a *FactoryAPI) GetRunProgress(ctx context.Context, params *FactoryGetRunProgressRequest) (*FactoryProgressPage, error) { +// Returns: Prediction result. Available results include prediction details; unavailable +// results include an explicit reason. +func (a *LimitPredictionAPI) Predict(ctx context.Context, params ...*SessionLimitPredictionPredictRequest) (SessionLimitPredictionResult, error) { + var requestParams *SessionLimitPredictionPredictRequest + if len(params) > 0 { + requestParams = params[0] + } req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.AfterSeq != nil { - req["afterSeq"] = *params.AfterSeq - } - if params.BeforeSeq != nil { - req["beforeSeq"] = *params.BeforeSeq - } - if params.Limit != nil { - req["limit"] = *params.Limit + if requestParams != nil { + if requestParams.ClientType != nil { + req["clientType"] = *requestParams.ClientType } - if params.PhaseID != nil { - req["phaseId"] = *params.PhaseID + if requestParams.ModelID != nil { + req["modelId"] = *requestParams.ModelID } - req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.factory.getRunProgress", req) + raw, err := a.client.Request(ctx, "session.limitPrediction.predict", req) if err != nil { return nil, err } - var result FactoryProgressPage - if err := json.Unmarshal(raw, &result); err != nil { + result, err := unmarshalSessionLimitPredictionResult(raw) + if err != nil { return nil, err } - return &result, nil + return result, nil } -// ListRuns lists durable factory runs for this session in creation order. -// -// RPC method: session.factory.listRuns. +// Experimental: LspAPI contains experimental APIs that may change or be removed. +type LspAPI sessionAPI + +// Initialize loads the merged LSP configuration set for the session's working directory. // -// Parameters: Parameters for paging factory runs. +// RPC method: session.lsp.initialize. // -// Returns: A page of factory runs in durable creation order. -func (a *FactoryAPI) ListRuns(ctx context.Context, params *FactoryListRunsRequest) (*FactoryListRunsResult, error) { +// Parameters: Parameters for (re)loading the merged LSP configuration set. +func (a *LspAPI) Initialize(ctx context.Context, params *LspInitializeRequest) (*SessionLspInitializeResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.AfterSeq != nil { - req["afterSeq"] = *params.AfterSeq + if params.Force != nil { + req["force"] = *params.Force } - if params.BeforeSeq != nil { - req["beforeSeq"] = *params.BeforeSeq + if params.GitRoot != nil { + req["gitRoot"] = *params.GitRoot } - if params.Limit != nil { - req["limit"] = *params.Limit + if params.WorkingDirectory != nil { + req["workingDirectory"] = *params.WorkingDirectory } } - raw, err := a.client.Request(ctx, "session.factory.listRuns", req) + raw, err := a.client.Request(ctx, "session.lsp.initialize", req) if err != nil { return nil, err } - var result FactoryListRunsResult + var result SessionLspInitializeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Log records a batch of ordered factory progress lines. -// -// RPC method: session.factory.log. +// Experimental: ManagedSettingsAPI contains experimental APIs that may change or be removed. +type ManagedSettingsAPI sessionAPI + +// Get waits for the live session's in-flight managed-settings application, then returns the +// retained effective snapshot used by runtime enforcement and by +// `session.managed_settings_resolved`. It does not perform another account, device, or +// server resolution, and rejects when resolution has not produced a snapshot. // -// Parameters: Parameters for recording factory progress. +// RPC method: session.managedSettings.get. // -// Returns: Acknowledgement that a factory request was accepted. -func (a *FactoryAPI) Log(ctx context.Context, params *FactoryLogRequest) (*FactoryAckResult, error) { +// Returns: Enterprise managed-settings resolution: the effective managed settings the +// session applied and which channels contributed, so SDK clients can show users what is +// enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on +// resume, and on account switch. This is an ephemeral live snapshot (delivered to +// subscribers but not persisted to the session event log), because at session start it +// resolves before `session.start` is emitted. Device values take precedence over server +// values, then the policy helper, per ordinary key, while permissions compose restrictively +// across device, server, policy-helper, and SDK-client layers. The account-scoped +// `getManagedSettings()` API does not include session-local client injection. Marked +// experimental while the managed-settings surface stabilizes. +func (a *ManagedSettingsAPI) Get(ctx context.Context) (*ManagedSettingsResolvedData, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["executionToken"] = params.ExecutionToken - req["lines"] = params.Lines - req["runId"] = params.RunID - } - raw, err := a.client.Request(ctx, "session.factory.log", req) + raw, err := a.client.Request(ctx, "session.managedSettings.get", req) if err != nil { return nil, err } - var result FactoryAckResult + var result ManagedSettingsResolvedData if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Pauses a running factory and returns its settled run envelope. +// Experimental: MCPAPI contains experimental APIs that may change or be removed. +type MCPAPI sessionAPI + +// CancelSamplingExecution cancels an in-flight MCP sampling execution by request ID. // -// RPC method: session.factory.pause. +// RPC method: session.mcp.cancelSamplingExecution. // -// Parameters: Parameters for pausing a running factory. +// Parameters: The requestId previously passed to executeSampling that should be cancelled. // -// Returns: Complete current or terminal factory run envelope. -func (a *FactoryAPI) Pause(ctx context.Context, params *FactoryPauseRequest) (*FactoryRunResult, error) { +// Returns: Indicates whether an in-flight sampling execution with the given requestId was +// found and cancelled. +func (a *MCPAPI) CancelSamplingExecution(ctx context.Context, params *MCPCancelSamplingExecutionParams) (*MCPCancelSamplingExecutionResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["runId"] = params.RunID + req["requestId"] = params.RequestID } - raw, err := a.client.Request(ctx, "session.factory.pause", req) + raw, err := a.client.Request(ctx, "session.mcp.cancelSamplingExecution", req) if err != nil { return nil, err } - var result FactoryRunResult + var result MCPCancelSamplingExecutionResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Resumes a factory run using its persisted name, arguments, journal, and accounting. -// -// RPC method: session.factory.resume. +// Disables an MCP server for the session. // -// Parameters: Parameters for resuming a factory run from its persisted identity. +// RPC method: session.mcp.disable. // -// Returns: Resolved persisted factory identity and resumed run envelope. -func (a *FactoryAPI) Resume(ctx context.Context, params *FactoryResumeRequest) (*FactoryResumeResult, error) { +// Parameters: Name of the MCP server to disable for the session. +func (a *MCPAPI) Disable(ctx context.Context, params *MCPDisableRequest) (*SessionMCPDisableResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Limits != nil { - req["limits"] = *params.Limits - } - if params.LogPhaseNames != nil { - req["logPhaseNames"] = *params.LogPhaseNames - } - if params.NotifyOnComplete != nil { - req["notifyOnComplete"] = *params.NotifyOnComplete - } - req["runId"] = params.RunID + req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.factory.resume", req) + raw, err := a.client.Request(ctx, "session.mcp.disable", req) if err != nil { return nil, err } - var result FactoryResumeResult + var result SessionMCPDisableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Runs a registered factory by name at the top level. -// -// RPC method: session.factory.run. +// Enables an MCP server for the session. // -// Parameters: Parameters for invoking a registered factory. +// RPC method: session.mcp.enable. // -// Returns: Complete current or terminal factory run envelope. -func (a *FactoryAPI) Run(ctx context.Context, params *FactoryRunRequest) (*FactoryRunResult, error) { - req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["args"] = params.Args - req["name"] = params.Name - if params.Options != nil { - req["options"] = *params.Options - } +// Parameters: Name of the MCP server to enable for the session. +func (a *MCPAPI) Enable(ctx context.Context, params *MCPEnableRequest) (*SessionMCPEnableResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.factory.run", req) + raw, err := a.client.Request(ctx, "session.mcp.enable", req) if err != nil { return nil, err } - var result FactoryRunResult + var result SessionMCPEnableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: FactoryJournalAPI contains experimental APIs that may change or be removed. -type FactoryJournalAPI sessionAPI - -// Get reads a memoized factory journal entry. +// ExecuteSampling runs an MCP sampling inference on behalf of an MCP server. // -// RPC method: session.factory.journal.get. +// RPC method: session.mcp.executeSampling. // -// Parameters: Parameters for reading a factory journal entry. +// Parameters: Identifiers and raw MCP CreateMessageRequest params used to run a sampling +// inference. // -// Returns: Result of reading a factory journal entry. -func (a *FactoryJournalAPI) Get(ctx context.Context, params *FactoryJournalGetRequest) (*FactoryJournalGetResult, error) { +// Returns: Outcome of an MCP sampling execution: success result, failure error, or +// cancellation. +func (a *MCPAPI) ExecuteSampling(ctx context.Context, params *MCPExecuteSamplingParams) (*MCPSamplingExecutionResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["executionToken"] = params.ExecutionToken - req["key"] = params.Key - req["runId"] = params.RunID + req["mcpRequestId"] = params.MCPRequestID + req["request"] = params.Request + req["requestId"] = params.RequestID + req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.factory.journal.get", req) + raw, err := a.client.Request(ctx, "session.mcp.executeSampling", req) if err != nil { return nil, err } - var result FactoryJournalGetResult + var result MCPSamplingExecutionResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Put stores a memoized factory journal entry. +// IsServerRunning checks whether a named MCP server is currently running on the session's +// host. // -// RPC method: session.factory.journal.put. +// RPC method: session.mcp.isServerRunning. // -// Parameters: Parameters for storing a factory journal entry. +// Parameters: Server name to check running status for. // -// Returns: Acknowledgement that a factory request was accepted. -func (a *FactoryJournalAPI) Put(ctx context.Context, params *FactoryJournalPutRequest) (*FactoryAckResult, error) { +// Returns: Whether the named MCP server is running. +func (a *MCPAPI) IsServerRunning(ctx context.Context, params *MCPIsServerRunningRequest) (*MCPIsServerRunningResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["executionToken"] = params.ExecutionToken - req["key"] = params.Key - req["resultJson"] = params.ResultJSON - req["runId"] = params.RunID + req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.factory.journal.put", req) + raw, err := a.client.Request(ctx, "session.mcp.isServerRunning", req) if err != nil { return nil, err } - var result FactoryAckResult + var result MCPIsServerRunningResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Journal returns experimental APIs that may change or be removed. -func (s *FactoryAPI) Journal() *FactoryJournalAPI { - return (*FactoryJournalAPI)(s) -} - -// Experimental: FleetAPI contains experimental APIs that may change or be removed. -type FleetAPI sessionAPI - -// Starts fleet mode by submitting the fleet orchestration prompt to the session. -// -// RPC method: session.fleet.start. +// 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. // -// Parameters: Parameters for starting fleet orchestration: an optional user prompt combined -// with the fleet instructions, plus the send options forwarded to the resulting turn. +// RPC method: session.mcp.list. // -// Returns: Indicates whether fleet mode was successfully activated. -func (a *FleetAPI) Start(ctx context.Context, params *FleetStartRequest) (*FleetStartResult, error) { +// Returns: MCP servers configured for the session, with their connection status and +// host-level state. +func (a *MCPAPI) List(ctx context.Context) (*MCPServerList, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.Attachments != nil { - req["attachments"] = params.Attachments - } - if params.Billable != nil { - req["billable"] = *params.Billable - } - if params.Prompt != nil { - req["prompt"] = *params.Prompt - } - if params.Wait != nil { - req["wait"] = *params.Wait - } - } - raw, err := a.client.Request(ctx, "session.fleet.start", req) + raw, err := a.client.Request(ctx, "session.mcp.list", req) if err != nil { return nil, err } - var result FleetStartResult + var result MCPServerList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: GitHubAuthAPI contains experimental APIs that may change or be removed. -type GitHubAuthAPI sessionAPI - -// GetStatus gets authentication status and account metadata for the session. +// ListTools 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. // -// RPC method: session.gitHubAuth.getStatus. +// RPC method: session.mcp.listTools. // -// Returns: Authentication status and account metadata for the session. -func (a *GitHubAuthAPI) GetStatus(ctx context.Context) (*SessionAuthStatus, error) { +// Parameters: Server name whose tool list should be returned. +// +// Returns: Tools exposed by the connected MCP server. Throws when the server is not +// connected. +func (a *MCPAPI) ListTools(ctx context.Context, params *MCPListToolsRequest) (*MCPListToolsResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.gitHubAuth.getStatus", req) + if params != nil { + req["serverName"] = params.ServerName + } + raw, err := a.client.Request(ctx, "session.mcp.listTools", req) if err != nil { return nil, err } - var result SessionAuthStatus + var result MCPListToolsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetCredentials updates the session's auth credentials used for outbound model and API -// requests. -// -// RPC method: session.gitHubAuth.setCredentials. +// MoveLoadingToBackground releases any turns waiting on an in-flight MCP load without +// cancelling the load, letting the agent proceed while MCP servers finish connecting in the +// background. No-op when no MCP load is in flight or waiting turns were already released. // -// Parameters: New auth credentials to install on the session. Omit to leave credentials -// unchanged. +// RPC method: session.mcp.moveLoadingToBackground. // -// Returns: Indicates whether the credential update succeeded. -func (a *GitHubAuthAPI) SetCredentials(ctx context.Context, params *SessionSetCredentialsParams) (*SessionSetCredentialsResult, error) { +// Returns: Result of moving in-flight MCP loading to the background. +func (a *MCPAPI) MoveLoadingToBackground(ctx context.Context) (*MoveMCPLoadingToBackgroundResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.Credentials != nil { - req["credentials"] = params.Credentials - } - } - raw, err := a.client.Request(ctx, "session.gitHubAuth.setCredentials", req) + raw, err := a.client.Request(ctx, "session.mcp.moveLoadingToBackground", req) if err != nil { return nil, err } - var result SessionSetCredentialsResult + var result MoveMCPLoadingToBackgroundResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: HistoryAPI contains experimental APIs that may change or be removed. -type HistoryAPI sessionAPI - -// AbortManualCompaction aborts any in-progress manual compaction on a local session. -// -// RPC method: session.history.abortManualCompaction. +// Reloads MCP server connections for the session. // -// Returns: Indicates whether an in-progress manual compaction was aborted. -func (a *HistoryAPI) AbortManualCompaction(ctx context.Context) (*HistoryAbortManualCompactionResult, error) { +// RPC method: session.mcp.reload. +func (a *MCPAPI) Reload(ctx context.Context) (*SessionMCPReloadResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.history.abortManualCompaction", req) + raw, err := a.client.Request(ctx, "session.mcp.reload", req) if err != nil { return nil, err } - var result HistoryAbortManualCompactionResult + var result SessionMCPReloadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// CancelBackgroundCompaction cancels any in-progress background compaction on a local -// session. +// RemoveGitHub removes the auto-managed `github` MCP server when present. // -// RPC method: session.history.cancelBackgroundCompaction. +// RPC method: session.mcp.removeGitHub. // -// Returns: Indicates whether an in-progress background compaction was cancelled. -func (a *HistoryAPI) CancelBackgroundCompaction(ctx context.Context) (*HistoryCancelBackgroundCompactionResult, error) { +// Returns: Indicates whether the auto-managed `github` MCP server was removed (false when +// nothing to remove). +func (a *MCPAPI) RemoveGitHub(ctx context.Context) (*MCPRemoveGitHubResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.history.cancelBackgroundCompaction", req) + raw, err := a.client.Request(ctx, "session.mcp.removeGitHub", req) if err != nil { return nil, err } - var result HistoryCancelBackgroundCompactionResult + var result MCPRemoveGitHubResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ClearContext clears the session's conversation history, keeping only system and developer -// messages, and seeds the fresh context window with a first user message. Must be called -// from inside a tool handler: the clear has to drop the results of the tool calls its wipe -// orphans, and it rejects when no tool call is in flight. -// -// RPC method: session.history.clearContext. +// RestartServer restarts an individual MCP server on the live session (stops then starts). +// Omit `config` for a config-free restart-by-name of an already-configured server; supply +// `config` to restart with a replacement configuration. Session-scoped and ephemeral: does +// NOT modify persistent user configuration (`mcp.config.*`). // -// Parameters: Parameters for clearing the conversation and seeding the window that replaces -// it. +// RPC method: session.mcp.restartServer. // -// Returns: What a successful clear removed. A clear that could not be applied rejects -// instead of reporting a count. -func (a *HistoryAPI) ClearContext(ctx context.Context, params *HistoryClearContextRequest) (*HistoryClearContextResult, error) { +// Parameters: Server name and optional replacement configuration for an individual MCP +// server restart. Omit `config` for a config-free restart-by-name of an already-configured +// server. +func (a *MCPAPI) RestartServer(ctx context.Context, params *MCPRestartServerRequest) (*SessionMCPRestartServerResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["prompt"] = params.Prompt + if params.Config != nil { + req["config"] = params.Config + } + req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.history.clearContext", req) + raw, err := a.client.Request(ctx, "session.mcp.restartServer", req) if err != nil { return nil, err } - var result HistoryClearContextResult + var result SessionMCPRestartServerResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Compacts the session history to reduce context usage. +// SetEnvValueMode sets how environment-variable values supplied to MCP servers are resolved +// (direct or indirect). // -// RPC method: session.history.compact. +// RPC method: session.mcp.setEnvValueMode. // -// Parameters: Optional compaction parameters. +// Parameters: Mode controlling how MCP server env values are resolved (`direct` or +// `indirect`). // -// Returns: Compaction outcome with the number of tokens and messages removed, summary text, -// and the resulting context window breakdown. -func (a *HistoryAPI) Compact(ctx context.Context, params ...*SessionHistoryCompactRequest) (*HistoryCompactResult, error) { - var requestParams *SessionHistoryCompactRequest - if len(params) > 0 { - requestParams = params[0] - } +// Returns: Env-value mode recorded on the session after the update. +func (a *MCPAPI) SetEnvValueMode(ctx context.Context, params *MCPSetEnvValueModeParams) (*MCPSetEnvValueModeResult, error) { req := map[string]any{"sessionId": a.sessionID} - if requestParams != nil { - if requestParams.CustomInstructions != nil { - req["customInstructions"] = *requestParams.CustomInstructions - } - if requestParams.TokenLimit != nil { - req["tokenLimit"] = *requestParams.TokenLimit - } - if requestParams.Trigger != nil { - req["trigger"] = *requestParams.Trigger - } + if params != nil { + req["mode"] = params.Mode } - raw, err := a.client.Request(ctx, "session.history.compact", req) + raw, err := a.client.Request(ctx, "session.mcp.setEnvValueMode", req) if err != nil { return nil, err } - var result HistoryCompactResult + var result MCPSetEnvValueModeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ListRewindPoints lists the user turns that the session can rewind to. Never rejects for a -// busy session: rewind reads need the session's file-change captures to be settled, so a -// session that still holds active work answers with `unavailableReason: "session-busy"` and -// no points, which the caller can retry. +// StartServer starts an individual MCP server on the live session. Omit `config` for a +// config-free start-by-name of an already-configured server (reuses the server's +// already-registered configuration); supply `config` to start from a caller-supplied +// configuration. Session-scoped and ephemeral: the server is added to this session's +// running set only and is reaped when the session ends. Does NOT modify persistent user +// configuration (`mcp.config.*`), so it does not affect future sessions. The server +// surfaces through `session.mcp.list` and the `session.mcp_servers_loaded` / +// `session.mcp_server_status_changed` events like any other server. // -// RPC method: session.history.listRewindPoints. +// RPC method: session.mcp.startServer. // -// Returns: Rewind points and file-change-tracking availability for the session. -func (a *HistoryAPI) ListRewindPoints(ctx context.Context) (*HistoryListRewindPointsResult, error) { +// Parameters: Server name and optional configuration for an individual MCP server start. +// Omit `config` for a config-free start-by-name of an already-configured server. +func (a *MCPAPI) StartServer(ctx context.Context, params *MCPStartServerRequest) (*SessionMCPStartServerResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.history.listRewindPoints", req) + if params != nil { + if params.Config != nil { + req["config"] = params.Config + } + req["serverName"] = params.ServerName + } + raw, err := a.client.Request(ctx, "session.mcp.startServer", req) if err != nil { return nil, err } - var result HistoryListRewindPointsResult + var result SessionMCPStartServerResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// PreviewRewind previews the files that a conversation-and-files rewind would restore. -// -// RPC method: session.history.previewRewind. +// StopServer stops an individual MCP server on the session's host. // -// Parameters: Event boundary to preview for conversation-and-files rewind. +// RPC method: session.mcp.stopServer. // -// Returns: Files and aggregate changes for a prospective rewind. -func (a *HistoryAPI) PreviewRewind(ctx context.Context, params *HistoryPreviewRewindRequest) (*HistoryPreviewRewindResult, error) { +// Parameters: Server name for an individual MCP server stop. +func (a *MCPAPI) StopServer(ctx context.Context, params *MCPStopServerRequest) (*SessionMCPStopServerResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["eventId"] = params.EventID + req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.history.previewRewind", req) + raw, err := a.client.Request(ctx, "session.mcp.stopServer", req) if err != nil { return nil, err } - var result HistoryPreviewRewindResult + var result SessionMCPStopServerResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Rewinds the session conversation, optionally restoring files changed by the discarded -// turns. Not crash-atomic: file restore and conversation truncation are separate stores, -// applied in that order, so a process crash between them can leave the workspace rewound -// while the conversation still contains the discarded turns. There is no recovery journal; -// re-running the same rewind is the recovery path for a crash before truncation lands, -// since file restore is idempotent (already-restored files are reported as skipped) and -// truncation is re-derived from the still-retained boundary event. After truncation lands -// that boundary no longer exists, so the same request is rejected; the only stage that can -// still be outstanding is snapshot pruning, whose failure leaves orphan snapshots the -// capture store tolerates. The reverse inconsistency cannot occur, because truncation is -// never applied before file restore succeeds. +// Experimental: MCPAppsAPI contains experimental APIs that may change or be removed. +type MCPAppsAPI sessionAPI + +// CallTool call an MCP tool from an MCP App view (SEP-1865). Enforces the visibility check +// that prevents an app iframe from invoking model-only tools. Returns the standard MCP +// `CallToolResult`. // -// RPC method: session.history.rewind. +// RPC method: session.mcp.apps.callTool. // -// Parameters: Boundary and mode for rewinding session history. +// Parameters: MCP server, tool name, and arguments to invoke from an MCP App view. // -// Returns: Structured outcome of a rewind request. -func (a *HistoryAPI) Rewind(ctx context.Context, params *HistoryRewindRequest) (*HistoryRewindResult, error) { +// Returns: Standard MCP CallToolResult +func (a *MCPAppsAPI) CallTool(ctx context.Context, params *MCPAppsCallToolRequest) (*SessionMCPAppsCallToolResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["eventId"] = params.EventID - req["mode"] = params.Mode + if params.Arguments != nil { + req["arguments"] = params.Arguments + } + req["originServerName"] = params.OriginServerName + req["serverName"] = params.ServerName + req["toolName"] = params.ToolName } - raw, err := a.client.Request(ctx, "session.history.rewind", req) + raw, err := a.client.Request(ctx, "session.mcp.apps.callTool", req) if err != nil { return nil, err } - var result HistoryRewindResult + var result SessionMCPAppsCallToolResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SummarizeForHandoff produces a markdown summary of the session's conversation context for -// hand-off scenarios. +// Diagnose MCP Apps wiring for a specific MCP server. Reports the session capability, +// feature-flag state, advertised extension, and how many tools have `_meta.ui` populated. // -// RPC method: session.history.summarizeForHandoff. +// RPC method: session.mcp.apps.diagnose. // -// Returns: Markdown summary of the conversation context (empty when not available). -func (a *HistoryAPI) SummarizeForHandoff(ctx context.Context) (*HistorySummarizeForHandoffResult, error) { +// Parameters: MCP server to diagnose MCP Apps wiring for. +// +// Returns: Diagnostic snapshot of MCP Apps wiring for the named server. +func (a *MCPAppsAPI) Diagnose(ctx context.Context, params *MCPAppsDiagnoseRequest) (*MCPAppsDiagnoseResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.history.summarizeForHandoff", req) + if params != nil { + req["serverName"] = params.ServerName + } + raw, err := a.client.Request(ctx, "session.mcp.apps.diagnose", req) if err != nil { return nil, err } - var result HistorySummarizeForHandoffResult + var result MCPAppsDiagnoseResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Truncates persisted session history to a specific event. -// -// RPC method: session.history.truncate. +// GetHostContext read the current host context advertised to MCP App guests. // -// Parameters: Identifier of the event to truncate to; this event and all later events are -// removed. +// RPC method: session.mcp.apps.getHostContext. // -// Returns: Number of events that were removed by the truncation. -func (a *HistoryAPI) Truncate(ctx context.Context, params *HistoryTruncateRequest) (*HistoryTruncateResult, error) { +// Returns: Current host context advertised to MCP App guests. +func (a *MCPAppsAPI) GetHostContext(ctx context.Context) (*MCPAppsHostContext, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["eventId"] = params.EventID - } - raw, err := a.client.Request(ctx, "session.history.truncate", req) + raw, err := a.client.Request(ctx, "session.mcp.apps.getHostContext", req) if err != nil { return nil, err } - var result HistoryTruncateResult + var result MCPAppsHostContext if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: InstructionsAPI contains experimental APIs that may change or be removed. -type InstructionsAPI sessionAPI - -// GetSources gets instruction sources loaded for the session. +// ListTools list tools that an MCP App view is allowed to call (SEP-1865 visibility +// filter). Returns tools whose `_meta.ui.visibility` is unset (default `["model","app"]`) +// or includes `"app"`. // -// RPC method: session.instructions.getSources. +// RPC method: session.mcp.apps.listTools. // -// Returns: Instruction sources loaded for the session, in merge order. -func (a *InstructionsAPI) GetSources(ctx context.Context) (*InstructionsGetSourcesResult, error) { +// Parameters: MCP server to list app-callable tools for. +// +// Returns: App-callable tools from the named MCP server. +func (a *MCPAppsAPI) ListTools(ctx context.Context, params *MCPAppsListToolsRequest) (*MCPAppsListToolsResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.instructions.getSources", req) + if params != nil { + req["originServerName"] = params.OriginServerName + req["serverName"] = params.ServerName + } + raw, err := a.client.Request(ctx, "session.mcp.apps.listTools", req) if err != nil { return nil, err } - var result InstructionsGetSourcesResult + var result MCPAppsListToolsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: LimitPredictionAPI contains experimental APIs that may change or be removed. -type LimitPredictionAPI sessionAPI - -// Predicts an AI-credit session limit for the session's resolved model. Returns an -// unavailable result instead of falling back when the current model is unresolved auto. +// ReadResource fetch an MCP resource (typically a `ui://` MCP App bundle, per SEP-1865) +// from a connected server. Requires the `mcp-apps` session capability. // -// RPC method: session.limitPrediction.predict. +// RPC method: session.mcp.apps.readResource. // -// Parameters: Parameters for predicting an AI-credit session limit. Omitting `modelId` uses -// the session's currently selected model. +// Parameters: MCP server and resource URI to fetch. // -// Returns: Prediction result. Available results include prediction details; unavailable -// results include an explicit reason. -func (a *LimitPredictionAPI) Predict(ctx context.Context, params ...*SessionLimitPredictionPredictRequest) (SessionLimitPredictionResult, error) { - var requestParams *SessionLimitPredictionPredictRequest - if len(params) > 0 { - requestParams = params[0] - } +// Returns: Resource contents returned by the MCP server. +func (a *MCPAppsAPI) ReadResource(ctx context.Context, params *MCPAppsReadResourceRequest) (*MCPAppsReadResourceResult, error) { req := map[string]any{"sessionId": a.sessionID} - if requestParams != nil { - if requestParams.ClientType != nil { - req["clientType"] = *requestParams.ClientType - } - if requestParams.ModelID != nil { - req["modelId"] = *requestParams.ModelID - } + if params != nil { + req["serverName"] = params.ServerName + req["uri"] = params.URI } - raw, err := a.client.Request(ctx, "session.limitPrediction.predict", req) + raw, err := a.client.Request(ctx, "session.mcp.apps.readResource", req) if err != nil { return nil, err } - result, err := unmarshalSessionLimitPredictionResult(raw) - if err != nil { + var result MCPAppsReadResourceResult + if err := json.Unmarshal(raw, &result); err != nil { return nil, err } - return result, nil + return &result, nil } -// Experimental: LspAPI contains experimental APIs that may change or be removed. -type LspAPI sessionAPI - -// Initialize loads the merged LSP configuration set for the session's working directory. +// SetHostContext replace the host context returned to MCP App guests on `ui/initialize`. +// Hosts use this to advertise theme, locale, or other metadata to the guest UI. // -// RPC method: session.lsp.initialize. +// RPC method: session.mcp.apps.setHostContext. // -// Parameters: Parameters for (re)loading the merged LSP configuration set. -func (a *LspAPI) Initialize(ctx context.Context, params *LspInitializeRequest) (*SessionLspInitializeResult, error) { +// Parameters: Host context to advertise to MCP App guests. +func (a *MCPAppsAPI) SetHostContext(ctx context.Context, params *MCPAppsSetHostContextRequest) (*SessionMCPAppsSetHostContextResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Force != nil { - req["force"] = *params.Force - } - if params.GitRoot != nil { - req["gitRoot"] = *params.GitRoot - } - if params.WorkingDirectory != nil { - req["workingDirectory"] = *params.WorkingDirectory - } + req["context"] = params.Context } - raw, err := a.client.Request(ctx, "session.lsp.initialize", req) + raw, err := a.client.Request(ctx, "session.mcp.apps.setHostContext", req) if err != nil { return nil, err } - var result SessionLspInitializeResult + var result SessionMCPAppsSetHostContextResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: MCPAPI contains experimental APIs that may change or be removed. -type MCPAPI sessionAPI +// Experimental: Apps returns experimental APIs that may change or be removed. +func (s *MCPAPI) Apps() *MCPAppsAPI { + return (*MCPAppsAPI)(s) +} -// CancelSamplingExecution cancels an in-flight MCP sampling execution by request ID. +// Experimental: MCPHeadersAPI contains experimental APIs that may change or be removed. +type MCPHeadersAPI sessionAPI + +// HandlePendingHeadersRefreshRequest responds to a pending MCP dynamic headers refresh +// request. Hosts that subscribe to `mcp.headers_refresh_required` use this to provide +// short-lived per-server headers or to indicate that no dynamic headers are available for +// this refresh. // -// RPC method: session.mcp.cancelSamplingExecution. +// RPC method: session.mcp.headers.handlePendingHeadersRefreshRequest. // -// Parameters: The requestId previously passed to executeSampling that should be cancelled. +// Parameters: MCP headers refresh request id and the host response. // -// Returns: Indicates whether an in-flight sampling execution with the given requestId was -// found and cancelled. -func (a *MCPAPI) CancelSamplingExecution(ctx context.Context, params *MCPCancelSamplingExecutionParams) (*MCPCancelSamplingExecutionResult, error) { +// Returns: Indicates whether the pending MCP headers refresh response was accepted. +func (a *MCPHeadersAPI) HandlePendingHeadersRefreshRequest(ctx context.Context, params *MCPHeadersHandlePendingHeadersRefreshRequestRequest) (*MCPHeadersHandlePendingHeadersRefreshRequestResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { req["requestId"] = params.RequestID + req["result"] = params.Result } - raw, err := a.client.Request(ctx, "session.mcp.cancelSamplingExecution", req) + raw, err := a.client.Request(ctx, "session.mcp.headers.handlePendingHeadersRefreshRequest", req) if err != nil { return nil, err } - var result MCPCancelSamplingExecutionResult + var result MCPHeadersHandlePendingHeadersRefreshRequestResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Disables an MCP server for the session. +// Experimental: Headers returns experimental APIs that may change or be removed. +func (s *MCPAPI) Headers() *MCPHeadersAPI { + return (*MCPHeadersAPI)(s) +} + +// Experimental: MCPOauthAPI contains experimental APIs that may change or be removed. +type MCPOauthAPI sessionAPI + +// AuthenticationStateChanged notifies the session that MCP OAuth authentication succeeded +// and updated credentials were persisted, so cached tool definitions can be refreshed. // -// RPC method: session.mcp.disable. +// RPC method: session.mcp.oauth.authenticationStateChanged. // -// Parameters: Name of the MCP server to disable for the session. -func (a *MCPAPI) Disable(ctx context.Context, params *MCPDisableRequest) (*SessionMCPDisableResult, error) { +// Parameters: Identifies the MCP server whose persisted OAuth credentials were updated. +func (a *MCPOauthAPI) AuthenticationStateChanged(ctx context.Context, params *MCPOauthAuthenticationStateChangedRequest) (*SessionMCPOauthAuthenticationStateChangedResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["serverName"] = params.ServerName + if params.RefreshSessionToken != nil { + req["refreshSessionToken"] = *params.RefreshSessionToken + } + if params.ServerName != nil { + req["serverName"] = *params.ServerName + } } - raw, err := a.client.Request(ctx, "session.mcp.disable", req) + raw, err := a.client.Request(ctx, "session.mcp.oauth.authenticationStateChanged", req) if err != nil { return nil, err } - var result SessionMCPDisableResult + var result SessionMCPOauthAuthenticationStateChangedResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Enables an MCP server for the session. +// HandlePendingRequest resolves a pending MCP OAuth request with a host-provided token or +// cancellation. The pending request is emitted as mcp.oauth_required with the data +// necessary to authorize the request. // -// RPC method: session.mcp.enable. +// RPC method: session.mcp.oauth.handlePendingRequest. // -// Parameters: Name of the MCP server to enable for the session. -func (a *MCPAPI) Enable(ctx context.Context, params *MCPEnableRequest) (*SessionMCPEnableResult, error) { +// Parameters: Pending MCP OAuth request ID and host-provided token or cancellation response. +// +// Returns: Indicates whether the pending MCP OAuth response was accepted. +func (a *MCPOauthAPI) HandlePendingRequest(ctx context.Context, params *MCPOauthHandlePendingRequest) (*MCPOauthHandlePendingResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["serverName"] = params.ServerName + req["requestId"] = params.RequestID + req["result"] = params.Result } - raw, err := a.client.Request(ctx, "session.mcp.enable", req) + raw, err := a.client.Request(ctx, "session.mcp.oauth.handlePendingRequest", req) if err != nil { return nil, err } - var result SessionMCPEnableResult + var result MCPOauthHandlePendingResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ExecuteSampling runs an MCP sampling inference on behalf of an MCP server. +// Login starts OAuth authentication for a remote MCP server. // -// RPC method: session.mcp.executeSampling. +// RPC method: session.mcp.oauth.login. // -// Parameters: Identifiers and raw MCP CreateMessageRequest params used to run a sampling -// inference. +// Parameters: Remote MCP server name and optional overrides controlling reauthentication, +// OAuth client display name, callback success-page copy, and static OAuth client selection. // -// Returns: Outcome of an MCP sampling execution: success result, failure error, or -// cancellation. -func (a *MCPAPI) ExecuteSampling(ctx context.Context, params *MCPExecuteSamplingParams) (*MCPSamplingExecutionResult, error) { +// Returns: OAuth authorization URL the caller should open, or empty when cached tokens +// already authenticated the server. +func (a *MCPOauthAPI) Login(ctx context.Context, params *MCPOauthLoginRequest) (*MCPOauthLoginResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["mcpRequestId"] = params.MCPRequestID - req["request"] = params.Request - req["requestId"] = params.RequestID + if params.CallbackSuccessMessage != nil { + req["callbackSuccessMessage"] = *params.CallbackSuccessMessage + } + if params.ClientID != nil { + req["clientId"] = *params.ClientID + } + if params.ClientName != nil { + req["clientName"] = *params.ClientName + } + if params.ClientSecret != nil { + req["clientSecret"] = *params.ClientSecret + } + if params.ForceReauth != nil { + req["forceReauth"] = *params.ForceReauth + } + if params.GrantType != nil { + req["grantType"] = *params.GrantType + } + if params.PublicClient != nil { + req["publicClient"] = *params.PublicClient + } req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.mcp.executeSampling", req) + raw, err := a.client.Request(ctx, "session.mcp.oauth.login", req) if err != nil { return nil, err } - var result MCPSamplingExecutionResult + var result MCPOauthLoginResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// IsServerRunning checks whether a named MCP server is currently running on the session's -// host. +// Probe passively probes a configured remote MCP server to classify whether OAuth is +// required or a cached/override token is accepted. Does not start OAuth, emit pending OAuth +// requests, or mutate MCP connection state. // -// RPC method: session.mcp.isServerRunning. +// RPC method: session.mcp.oauth.probe. // -// Parameters: Server name to check running status for. +// Parameters: Remote MCP server name for a passive OAuth status probe. // -// Returns: Whether the named MCP server is running. -func (a *MCPAPI) IsServerRunning(ctx context.Context, params *MCPIsServerRunningRequest) (*MCPIsServerRunningResult, error) { +// Returns: Passive MCP OAuth probe result. `authenticated` means the server accepted the +// probe request while an OAuth-origin access token was attached; it does not prove the +// server required or independently validated that token. The probe does not make a second +// unauthenticated request. Failed is an expected probe-domain outcome; JSON-RPC errors are +// reserved for API-call failures. +func (a *MCPOauthAPI) Probe(ctx context.Context, params *MCPOauthProbeRequest) (MCPOauthProbeResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.mcp.isServerRunning", req) + raw, err := a.client.Request(ctx, "session.mcp.oauth.probe", req) if err != nil { return nil, err } - var result MCPIsServerRunningResult - if err := json.Unmarshal(raw, &result); err != nil { + result, err := unmarshalMCPOauthProbeResult(raw) + if err != nil { return nil, err } - return &result, nil + return result, nil } -// 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. +// Responds to a pending MCP OAuth authorization request by its request id. // -// RPC method: session.mcp.list. +// RPC method: session.mcp.oauth.respond. // -// Returns: MCP servers configured for the session, with their connection status and -// host-level state. -func (a *MCPAPI) List(ctx context.Context) (*MCPServerList, error) { +// Parameters: Pending MCP OAuth request id to respond to. +// +// Returns: Indicates whether the pending MCP OAuth response was accepted. +func (a *MCPOauthAPI) Respond(ctx context.Context, params *MCPOauthRespondRequest) (*MCPOauthRespondResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.mcp.list", req) + if params != nil { + req["requestId"] = params.RequestID + } + raw, err := a.client.Request(ctx, "session.mcp.oauth.respond", req) if err != nil { return nil, err } - var result MCPServerList + var result MCPOauthRespondResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ListTools 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. +// Experimental: Oauth returns experimental APIs that may change or be removed. +func (s *MCPAPI) Oauth() *MCPOauthAPI { + return (*MCPOauthAPI)(s) +} + +// Experimental: MCPResourcesAPI contains experimental APIs that may change or be removed. +type MCPResourcesAPI sessionAPI + +// List enumerate one page of resources a connected MCP server exposes (proxies MCP +// `resources/list`). Pass `cursor` to continue from a prior result's `nextCursor`. // -// RPC method: session.mcp.listTools. +// RPC method: session.mcp.resources.list. // -// Parameters: Server name whose tool list should be returned. +// Parameters: MCP server whose resources to enumerate. // -// Returns: Tools exposed by the connected MCP server. Throws when the server is not -// connected. -func (a *MCPAPI) ListTools(ctx context.Context, params *MCPListToolsRequest) (*MCPListToolsResult, error) { +// Returns: One page of resources advertised by the named MCP server. +func (a *MCPResourcesAPI) List(ctx context.Context, params *MCPResourcesListRequest) (*MCPResourcesListResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { + if params.Cursor != nil { + req["cursor"] = *params.Cursor + } req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.mcp.listTools", req) + raw, err := a.client.Request(ctx, "session.mcp.resources.list", req) if err != nil { return nil, err } - var result MCPListToolsResult + var result MCPResourcesListResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// MoveLoadingToBackground releases any turns waiting on an in-flight MCP load without -// cancelling the load, letting the agent proceed while MCP servers finish connecting in the -// background. No-op when no MCP load is in flight or waiting turns were already released. +// ListTemplates enumerate one page of resource templates a connected MCP server exposes +// (proxies MCP `resources/templates/list`). Pass `cursor` to continue from a prior result's +// `nextCursor`. // -// RPC method: session.mcp.moveLoadingToBackground. +// RPC method: session.mcp.resources.listTemplates. // -// Returns: Result of moving in-flight MCP loading to the background. -func (a *MCPAPI) MoveLoadingToBackground(ctx context.Context) (*MoveMCPLoadingToBackgroundResult, error) { +// Parameters: MCP server whose resource templates to enumerate. +// +// Returns: One page of resource templates advertised by the named MCP server. +func (a *MCPResourcesAPI) ListTemplates(ctx context.Context, params *MCPResourcesListTemplatesRequest) (*MCPResourcesListTemplatesResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.mcp.moveLoadingToBackground", req) + if params != nil { + if params.Cursor != nil { + req["cursor"] = *params.Cursor + } + req["serverName"] = params.ServerName + } + raw, err := a.client.Request(ctx, "session.mcp.resources.listTemplates", req) if err != nil { return nil, err } - var result MoveMCPLoadingToBackgroundResult + var result MCPResourcesListTemplatesResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Reloads MCP server connections for the session. +// Read fetch an MCP resource from a connected server by URI (proxies MCP `resources/read`). // -// RPC method: session.mcp.reload. -func (a *MCPAPI) Reload(ctx context.Context) (*SessionMCPReloadResult, error) { +// RPC method: session.mcp.resources.read. +// +// Parameters: MCP server and resource URI to fetch. +// +// Returns: Resource contents returned by the MCP server. +func (a *MCPResourcesAPI) Read(ctx context.Context, params *MCPResourcesReadRequest) (*MCPResourcesReadResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.mcp.reload", req) + if params != nil { + req["serverName"] = params.ServerName + req["uri"] = params.URI + } + raw, err := a.client.Request(ctx, "session.mcp.resources.read", req) if err != nil { return nil, err } - var result SessionMCPReloadResult + var result MCPResourcesReadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RemoveGitHub removes the auto-managed `github` MCP server when present. +// Experimental: Resources returns experimental APIs that may change or be removed. +func (s *MCPAPI) Resources() *MCPResourcesAPI { + return (*MCPResourcesAPI)(s) +} + +// Experimental: MetadataAPI contains experimental APIs that may change or be removed. +type MetadataAPI sessionAPI + +// Activity returns a snapshot of activity flags for the session. // -// RPC method: session.mcp.removeGitHub. +// RPC method: session.metadata.activity. // -// Returns: Indicates whether the auto-managed `github` MCP server was removed (false when -// nothing to remove). -func (a *MCPAPI) RemoveGitHub(ctx context.Context) (*MCPRemoveGitHubResult, error) { +// Returns: Current activity flags for the session. +func (a *MetadataAPI) Activity(ctx context.Context) (*SessionActivity, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.mcp.removeGitHub", req) + raw, err := a.client.Request(ctx, "session.metadata.activity", req) if err != nil { return nil, err } - var result MCPRemoveGitHubResult + var result SessionActivity if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RestartServer restarts an individual MCP server on the live session (stops then starts). -// Omit `config` for a config-free restart-by-name of an already-configured server; supply -// `config` to restart with a replacement configuration. Session-scoped and ephemeral: does -// NOT modify persistent user configuration (`mcp.config.*`). +// ContextInfo returns the token breakdown for the session's current context window for a +// given model. // -// RPC method: session.mcp.restartServer. +// RPC method: session.metadata.contextInfo. // -// Parameters: Server name and optional replacement configuration for an individual MCP -// server restart. Omit `config` for a config-free restart-by-name of an already-configured -// server. -func (a *MCPAPI) RestartServer(ctx context.Context, params *MCPRestartServerRequest) (*SessionMCPRestartServerResult, error) { +// Parameters: Model identifier and token limits used to compute the context-info breakdown. +// +// Returns: Token breakdown for the session's current context window, or null if +// uninitialized. +func (a *MetadataAPI) ContextInfo(ctx context.Context, params *MetadataContextInfoRequest) (*MetadataContextInfoResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Config != nil { - req["config"] = params.Config + req["outputTokenLimit"] = params.OutputTokenLimit + req["promptTokenLimit"] = params.PromptTokenLimit + if params.SelectedModel != nil { + req["selectedModel"] = *params.SelectedModel } - req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.mcp.restartServer", req) + raw, err := a.client.Request(ctx, "session.metadata.contextInfo", req) if err != nil { return nil, err } - var result SessionMCPRestartServerResult + var result MetadataContextInfoResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetEnvValueMode sets how environment-variable values supplied to MCP servers are resolved -// (direct or indirect). -// -// RPC method: session.mcp.setEnvValueMode. +// GetClientMetadata returns the client-owned string metadata persisted with this local +// session. The metadata is not included in model context, events, telemetry, snapshots, or +// remote exports. // -// Parameters: Mode controlling how MCP server env values are resolved (`direct` or -// `indirect`). +// RPC method: session.metadata.getClientMetadata. // -// Returns: Env-value mode recorded on the session after the update. -func (a *MCPAPI) SetEnvValueMode(ctx context.Context, params *MCPSetEnvValueModeParams) (*MCPSetEnvValueModeResult, error) { +// Returns: Client-owned, case-sensitive string metadata persisted with a local session. +// Clients should namespace keys by owner. Keys must be non-empty and at most 256 UTF-8 +// bytes; keys under `copilot/` and `github/` are reserved. Values may contain at most 16 +// KiB of UTF-8 data. A bag may contain at most 128 entries and its serialized sidecar may +// contain at most 64 KiB. The runtime stores but never interprets these values. +func (a *MetadataAPI) GetClientMetadata(ctx context.Context) (*ClientMetadata, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["mode"] = params.Mode - } - raw, err := a.client.Request(ctx, "session.mcp.setEnvValueMode", req) + raw, err := a.client.Request(ctx, "session.metadata.getClientMetadata", req) if err != nil { return nil, err } - var result MCPSetEnvValueModeResult + var result ClientMetadata if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// StartServer starts an individual MCP server on the live session. Omit `config` for a -// config-free start-by-name of an already-configured server (reuses the server's -// already-registered configuration); supply `config` to start from a caller-supplied -// configuration. Session-scoped and ephemeral: the server is added to this session's -// running set only and is reaped when the session ends. Does NOT modify persistent user -// configuration (`mcp.config.*`), so it does not affect future sessions. The server -// surfaces through `session.mcp.list` and the `session.mcp_servers_loaded` / -// `session.mcp_server_status_changed` events like any other server. +// GetContextAttribution returns the experimental per-source attribution breakdown of the +// session's current context window as a flat list of entries (skills, subagents, MCP +// servers, built-in tools, plugin rollups, system/tool-definition costs, with nesting via +// parentId), plus the successful compaction count. The heaviest individual messages are +// available separately via `metadata.getContextHeaviestMessages`. Returns null until the +// session has initialized its system prompt and tool metadata. // -// RPC method: session.mcp.startServer. +// RPC method: session.metadata.getContextAttribution. // -// Parameters: Server name and optional configuration for an individual MCP server start. -// Omit `config` for a config-free start-by-name of an already-configured server. -func (a *MCPAPI) StartServer(ctx context.Context, params *MCPStartServerRequest) (*SessionMCPStartServerResult, error) { +// Returns: Per-source attribution breakdown for the session's current context window, or +// null if uninitialized. +func (a *MetadataAPI) GetContextAttribution(ctx context.Context) (*MetadataContextAttributionResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.Config != nil { - req["config"] = params.Config - } - req["serverName"] = params.ServerName - } - raw, err := a.client.Request(ctx, "session.mcp.startServer", req) + raw, err := a.client.Request(ctx, "session.metadata.getContextAttribution", req) if err != nil { return nil, err } - var result SessionMCPStartServerResult + var result MetadataContextAttributionResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// StopServer stops an individual MCP server on the session's host. +// GetContextHeaviestMessages returns the largest individual messages currently in the +// session's context window, most-expensive first. Companion to +// `metadata.getContextAttribution`. Returns an empty list until the session has initialized. // -// RPC method: session.mcp.stopServer. +// RPC method: session.metadata.getContextHeaviestMessages. // -// Parameters: Server name for an individual MCP server stop. -func (a *MCPAPI) StopServer(ctx context.Context, params *MCPStopServerRequest) (*SessionMCPStopServerResult, error) { +// Parameters: Parameters for the heaviest-messages query. +// +// Returns: The heaviest individual messages in the session's context window, most-expensive +// first. +func (a *MetadataAPI) GetContextHeaviestMessages(ctx context.Context, params *MetadataContextHeaviestMessagesRequest) (*MetadataContextHeaviestMessagesResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["serverName"] = params.ServerName + if params.Limit != nil { + req["limit"] = *params.Limit + } } - raw, err := a.client.Request(ctx, "session.mcp.stopServer", req) + raw, err := a.client.Request(ctx, "session.metadata.getContextHeaviestMessages", req) if err != nil { return nil, err } - var result SessionMCPStopServerResult + var result MetadataContextHeaviestMessagesResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: MCPAppsAPI contains experimental APIs that may change or be removed. -type MCPAppsAPI sessionAPI - -// CallTool call an MCP tool from an MCP App view (SEP-1865). Enforces the visibility check -// that prevents an app iframe from invoking model-only tools. Returns the standard MCP -// `CallToolResult`. -// -// RPC method: session.mcp.apps.callTool. +// IsProcessing reports whether the local session is currently processing user/agent +// messages. // -// Parameters: MCP server, tool name, and arguments to invoke from an MCP App view. +// RPC method: session.metadata.isProcessing. // -// Returns: Standard MCP CallToolResult -func (a *MCPAppsAPI) CallTool(ctx context.Context, params *MCPAppsCallToolRequest) (*SessionMCPAppsCallToolResult, error) { +// Returns: Indicates whether the local session is currently processing a turn or background +// continuation. +func (a *MetadataAPI) IsProcessing(ctx context.Context) (*MetadataIsProcessingResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.Arguments != nil { - req["arguments"] = params.Arguments - } - req["originServerName"] = params.OriginServerName - req["serverName"] = params.ServerName - req["toolName"] = params.ToolName - } - raw, err := a.client.Request(ctx, "session.mcp.apps.callTool", req) + raw, err := a.client.Request(ctx, "session.metadata.isProcessing", req) if err != nil { return nil, err } - var result SessionMCPAppsCallToolResult + var result MetadataIsProcessingResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Diagnose MCP Apps wiring for a specific MCP server. Reports the session capability, -// feature-flag state, advertised extension, and how many tools have `_meta.ui` populated. +// RecomputeContextTokens re-tokenizes the session's existing messages against a model and +// returns aggregate token totals. // -// RPC method: session.mcp.apps.diagnose. +// RPC method: session.metadata.recomputeContextTokens. // -// Parameters: MCP server to diagnose MCP Apps wiring for. +// Parameters: Model identifier to use when re-tokenizing the session's existing messages. // -// Returns: Diagnostic snapshot of MCP Apps wiring for the named server. -func (a *MCPAppsAPI) Diagnose(ctx context.Context, params *MCPAppsDiagnoseRequest) (*MCPAppsDiagnoseResult, error) { +// Returns: Re-tokenize the session's existing messages against `modelId` and return the +// token totals. Useful for hosts that want an initial estimate of context usage on session +// resume, before the next agent turn fires `session.context_info_changed` events. Returns +// zeros for an empty session. +func (a *MetadataAPI) RecomputeContextTokens(ctx context.Context, params *MetadataRecomputeContextTokensRequest) (*MetadataRecomputeContextTokensResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["serverName"] = params.ServerName + req["modelId"] = params.ModelID } - raw, err := a.client.Request(ctx, "session.mcp.apps.diagnose", req) + raw, err := a.client.Request(ctx, "session.metadata.recomputeContextTokens", req) if err != nil { return nil, err } - var result MCPAppsDiagnoseResult + var result MetadataRecomputeContextTokensResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetHostContext read the current host context advertised to MCP App guests. +// RecordContextChange records a working-directory/git context change and emits a +// `session.context_changed` event. For a local session, a report whose `cwd` diverges from +// the session's current working directory is ignored (the call still succeeds but records +// nothing and emits no event): a local session's working directory is authoritative and is +// moved via `metadata.setWorkingDirectory` (or an SDK `session.resume` that supplies a +// `workingDirectory`), not by this method. // -// RPC method: session.mcp.apps.getHostContext. +// RPC method: session.metadata.recordContextChange. // -// Returns: Current host context advertised to MCP App guests. -func (a *MCPAppsAPI) GetHostContext(ctx context.Context) (*MCPAppsHostContext, error) { +// Parameters: Updated working-directory/git context to record on the session. +// +// Returns: Notify the session that its working directory context has changed. Emits a +// `session.context_changed` event so consumers (telemetry, OTel tracker, ACP, the timeline +// UI) can react. Use this when the host has detected a cwd/branch/repo change outside the +// session's normal lifecycle (e.g., after a shell command in interactive mode). For a local +// session, a report whose `cwd` diverges from the session's current working directory is +// ignored (the call still succeeds but records nothing and emits no event); move a local +// session's working directory via `metadata.setWorkingDirectory` instead. +func (a *MetadataAPI) RecordContextChange(ctx context.Context, params *MetadataRecordContextChangeRequest) (*MetadataRecordContextChangeResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.mcp.apps.getHostContext", req) + if params != nil { + req["context"] = params.Context + } + raw, err := a.client.Request(ctx, "session.metadata.recordContextChange", req) if err != nil { return nil, err } - var result MCPAppsHostContext + var result MetadataRecordContextChangeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ListTools list tools that an MCP App view is allowed to call (SEP-1865 visibility -// filter). Returns tools whose `_meta.ui.visibility` is unset (default `["model","app"]`) -// or includes `"app"`. +// SetWorkingDirectory updates the session's working directory. For local sessions the +// target is validated first (an absolute path that exists on disk) and the permission +// primary directory is re-based; a rejected validation fails the call before any session +// state changes. // -// RPC method: session.mcp.apps.listTools. +// RPC method: session.metadata.setWorkingDirectory. // -// Parameters: MCP server to list app-callable tools for. +// Parameters: Absolute path to set as the session's new working directory. For local +// sessions the path must be absolute and exist on disk: it is validated before any session +// state changes, and a failing validation rejects the call with nothing mutated, persisted, +// or emitted. Remote sessions record the path as-is. // -// Returns: App-callable tools from the named MCP server. -func (a *MCPAppsAPI) ListTools(ctx context.Context, params *MCPAppsListToolsRequest) (*MCPAppsListToolsResult, error) { +// Returns: Update the session's working directory. Used by the host when the user +// explicitly changes cwd (e.g., the `/cd` slash command). The host is responsible for any +// related side-effects (file index, etc.); it does NOT change the process working directory +// (a session's cwd is per-session, not process-global). For local sessions the runtime +// validates the target first (an absolute path that exists on disk) and re-bases the +// permission primary directory; a rejected validation fails the call before anything is +// mutated, persisted, or emitted. Location-scoped permission rules are then re-keyed to the +// new directory (best-effort). Remote sessions only record the path. +func (a *MetadataAPI) SetWorkingDirectory(ctx context.Context, params *MetadataSetWorkingDirectoryRequest) (*MetadataSetWorkingDirectoryResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["originServerName"] = params.OriginServerName - req["serverName"] = params.ServerName + req["workingDirectory"] = params.WorkingDirectory } - raw, err := a.client.Request(ctx, "session.mcp.apps.listTools", req) + raw, err := a.client.Request(ctx, "session.metadata.setWorkingDirectory", req) if err != nil { return nil, err } - var result MCPAppsListToolsResult + var result MetadataSetWorkingDirectoryResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ReadResource fetch an MCP resource (typically a `ui://` MCP App bundle, per SEP-1865) -// from a connected server. Requires the `mcp-apps` session capability. -// -// RPC method: session.mcp.apps.readResource. +// Snapshot returns a snapshot of the session's identifying metadata, mode, agent, and +// remote info. // -// Parameters: MCP server and resource URI to fetch. +// RPC method: session.metadata.snapshot. // -// Returns: Resource contents returned by the MCP server. -func (a *MCPAppsAPI) ReadResource(ctx context.Context, params *MCPAppsReadResourceRequest) (*MCPAppsReadResourceResult, error) { +// Returns: Point-in-time snapshot of slow-changing session identifier and state fields +func (a *MetadataAPI) Snapshot(ctx context.Context) (*SessionMetadataSnapshot, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["serverName"] = params.ServerName - req["uri"] = params.URI - } - raw, err := a.client.Request(ctx, "session.mcp.apps.readResource", req) + raw, err := a.client.Request(ctx, "session.metadata.snapshot", req) if err != nil { return nil, err } - var result MCPAppsReadResourceResult + var result SessionMetadataSnapshot if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetHostContext replace the host context returned to MCP App guests on `ui/initialize`. -// Hosts use this to advertise theme, locale, or other metadata to the guest UI. +// UpdateClientMetadata atomically patches the client-owned string metadata persisted with +// this local session and returns the committed bag. // -// RPC method: session.mcp.apps.setHostContext. +// RPC method: session.metadata.updateClientMetadata. // -// Parameters: Host context to advertise to MCP App guests. -func (a *MCPAppsAPI) SetHostContext(ctx context.Context, params *MCPAppsSetHostContextRequest) (*SessionMCPAppsSetHostContextResult, error) { +// Parameters: Atomic patch for client-owned session metadata. Operations apply in clear, +// remove, then set order. The resulting bag must satisfy the ClientMetadata entry and +// serialized-size limits. Local storage coordinates concurrent runtime processes; custom +// SessionFs providers must serialize writers that access the same session from multiple +// processes. +// +// Returns: Client-owned, case-sensitive string metadata persisted with a local session. +// Clients should namespace keys by owner. Keys must be non-empty and at most 256 UTF-8 +// bytes; keys under `copilot/` and `github/` are reserved. Values may contain at most 16 +// KiB of UTF-8 data. A bag may contain at most 128 entries and its serialized sidecar may +// contain at most 64 KiB. The runtime stores but never interprets these values. +func (a *MetadataAPI) UpdateClientMetadata(ctx context.Context, params *MetadataUpdateClientMetadataRequest) (*ClientMetadata, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["context"] = params.Context + if params.Clear != nil { + req["clear"] = *params.Clear + } + if params.Remove != nil { + req["remove"] = params.Remove + } + if params.Set != nil { + req["set"] = params.Set + } } - raw, err := a.client.Request(ctx, "session.mcp.apps.setHostContext", req) + raw, err := a.client.Request(ctx, "session.metadata.updateClientMetadata", req) if err != nil { return nil, err } - var result SessionMCPAppsSetHostContextResult + var result ClientMetadata if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Apps returns experimental APIs that may change or be removed. -func (s *MCPAPI) Apps() *MCPAppsAPI { - return (*MCPAppsAPI)(s) -} - -// Experimental: MCPHeadersAPI contains experimental APIs that may change or be removed. -type MCPHeadersAPI sessionAPI +// Experimental: ModeAPI contains experimental APIs that may change or be removed. +type ModeAPI sessionAPI -// HandlePendingHeadersRefreshRequest responds to a pending MCP dynamic headers refresh -// request. Hosts that subscribe to `mcp.headers_refresh_required` use this to provide -// short-lived per-server headers or to indicate that no dynamic headers are available for -// this refresh. -// -// RPC method: session.mcp.headers.handlePendingHeadersRefreshRequest. +// Gets the current agent interaction mode. // -// Parameters: MCP headers refresh request id and the host response. +// RPC method: session.mode.get. // -// Returns: Indicates whether the pending MCP headers refresh response was accepted. -func (a *MCPHeadersAPI) HandlePendingHeadersRefreshRequest(ctx context.Context, params *MCPHeadersHandlePendingHeadersRefreshRequestRequest) (*MCPHeadersHandlePendingHeadersRefreshRequestResult, error) { +// Returns: The session mode the agent is operating in +func (a *ModeAPI) Get(ctx context.Context) (*SessionMode, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["requestId"] = params.RequestID - req["result"] = params.Result - } - raw, err := a.client.Request(ctx, "session.mcp.headers.handlePendingHeadersRefreshRequest", req) + raw, err := a.client.Request(ctx, "session.mode.get", req) if err != nil { return nil, err } - var result MCPHeadersHandlePendingHeadersRefreshRequestResult + var result SessionMode if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Headers returns experimental APIs that may change or be removed. -func (s *MCPAPI) Headers() *MCPHeadersAPI { - return (*MCPHeadersAPI)(s) -} - -// Experimental: MCPOauthAPI contains experimental APIs that may change or be removed. -type MCPOauthAPI sessionAPI - -// AuthenticationStateChanged notifies the session that MCP OAuth authentication succeeded -// and updated credentials were persisted, so cached tool definitions can be refreshed. +// Sets the current agent interaction mode. // -// RPC method: session.mcp.oauth.authenticationStateChanged. +// RPC method: session.mode.set. // -// Parameters: Identifies the MCP server whose persisted OAuth credentials were updated. -func (a *MCPOauthAPI) AuthenticationStateChanged(ctx context.Context, params *MCPOauthAuthenticationStateChangedRequest) (*SessionMCPOauthAuthenticationStateChangedResult, error) { +// Parameters: Agent interaction mode to apply to the session. +// +// Returns: Outcome of a session mode change, including any model switch it triggered and +// follow-up the host must perform. +func (a *ModeAPI) Set(ctx context.Context, params *ModeSetRequest) (*ModeSetResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.RefreshSessionToken != nil { - req["refreshSessionToken"] = *params.RefreshSessionToken + if params.CompactionDecision != nil { + req["compactionDecision"] = *params.CompactionDecision + } + if params.ExpectedMode != nil { + req["expectedMode"] = *params.ExpectedMode + } + if params.InheritPlanBaseFromSessionID != nil { + req["inheritPlanBaseFromSessionId"] = *params.InheritPlanBaseFromSessionID } - if params.ServerName != nil { - req["serverName"] = *params.ServerName + req["mode"] = params.Mode + if params.PersistPlanSelection != nil { + req["persistPlanSelection"] = *params.PersistPlanSelection + } + if params.PickerSettingsContext != nil { + req["pickerSettingsContext"] = *params.PickerSettingsContext + } + if params.PlanContextTier != nil { + req["planContextTier"] = *params.PlanContextTier + } + if params.PlanExitAction != nil { + req["planExitAction"] = *params.PlanExitAction + } + if params.PlanModel != nil { + req["planModel"] = *params.PlanModel + } + if params.PlanModelConfigured != nil { + req["planModelConfigured"] = *params.PlanModelConfigured + } + if params.PlanReasoningEffort != nil { + req["planReasoningEffort"] = *params.PlanReasoningEffort + } + if params.RestorePlanModel != nil { + req["restorePlanModel"] = *params.RestorePlanModel } } - raw, err := a.client.Request(ctx, "session.mcp.oauth.authenticationStateChanged", req) + raw, err := a.client.Request(ctx, "session.mode.set", req) if err != nil { return nil, err } - var result SessionMCPOauthAuthenticationStateChangedResult + var result ModeSetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingRequest resolves a pending MCP OAuth request with a host-provided token or -// cancellation. The pending request is emitted as mcp.oauth_required with the data -// necessary to authorize the request. -// -// RPC method: session.mcp.oauth.handlePendingRequest. +// Experimental: ModelAPI contains experimental APIs that may change or be removed. +type ModelAPI sessionAPI + +// GetCurrent gets the session's authoritative model snapshot, including the committed Auto +// preference and any newer unclaimed Auto preference waiting for a future user turn. // -// Parameters: Pending MCP OAuth request ID and host-provided token or cancellation response. +// RPC method: session.model.getCurrent. // -// Returns: Indicates whether the pending MCP OAuth response was accepted. -func (a *MCPOauthAPI) HandlePendingRequest(ctx context.Context, params *MCPOauthHandlePendingRequest) (*MCPOauthHandlePendingResult, error) { +// 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. +func (a *ModelAPI) GetCurrent(ctx context.Context) (*CurrentModel, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["requestId"] = params.RequestID - req["result"] = params.Result - } - raw, err := a.client.Request(ctx, "session.mcp.oauth.handlePendingRequest", req) + raw, err := a.client.Request(ctx, "session.model.getCurrent", req) if err != nil { return nil, err } - var result MCPOauthHandlePendingResult + var result CurrentModel if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Login starts OAuth authentication for a remote MCP server. +// 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. // -// RPC method: session.mcp.oauth.login. +// RPC method: session.model.list. // -// Parameters: Remote MCP server name and optional overrides controlling reauthentication, -// OAuth client display name, callback success-page copy, and static OAuth client selection. +// Parameters: Optional listing options. // -// Returns: OAuth authorization URL the caller should open, or empty when cached tokens -// already authenticated the server. -func (a *MCPOauthAPI) Login(ctx context.Context, params *MCPOauthLoginRequest) (*MCPOauthLoginResult, error) { +// Returns: The list of models available to this session. +func (a *ModelAPI) List(ctx context.Context, params ...*SessionModelListRequest) (*SessionModelList, error) { + var requestParams *SessionModelListRequest + if len(params) > 0 { + requestParams = params[0] + } req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.CallbackSuccessMessage != nil { - req["callbackSuccessMessage"] = *params.CallbackSuccessMessage - } - if params.ClientID != nil { - req["clientId"] = *params.ClientID - } - if params.ClientName != nil { - req["clientName"] = *params.ClientName - } - if params.ClientSecret != nil { - req["clientSecret"] = *params.ClientSecret - } - if params.ForceReauth != nil { - req["forceReauth"] = *params.ForceReauth - } - if params.GrantType != nil { - req["grantType"] = *params.GrantType - } - if params.PublicClient != nil { - req["publicClient"] = *params.PublicClient + if requestParams != nil { + if requestParams.SkipCache != nil { + req["skipCache"] = *requestParams.SkipCache } - req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.mcp.oauth.login", req) + raw, err := a.client.Request(ctx, "session.model.list", req) if err != nil { return nil, err } - var result MCPOauthLoginResult + var result SessionModelList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Probe passively probes a configured remote MCP server to classify whether OAuth is -// required or a cached/override token is accepted. Does not start OAuth, emit pending OAuth -// requests, or mutate MCP connection state. +// SetAllowedModels replaces or clears the host-supplied model allowlist for a running +// session. // -// RPC method: session.mcp.oauth.probe. +// RPC method: session.model.setAllowedModels. // -// Parameters: Remote MCP server name for a passive OAuth status probe. +// Parameters: Host-supplied exact model selection IDs to allow for this running session. +// CAPI IDs are intersected with repository `.github/allowed_models.txt` policy; +// provider-qualified IDs remain exempt from repository-only policy but are restricted by +// this host list. Omit or pass null to clear the host restriction; an explicit empty or +// disjoint list is rejected. Validation and pre-selection fallback failures preserve the +// previous restriction. Failures after a fallback selection commits retain the new +// restriction and selected model; callers should inspect current session state after such +// an error. // -// Returns: Passive MCP OAuth probe result. `authenticated` means the server accepted the -// probe request while an OAuth-origin access token was attached; it does not prove the -// server required or independently validated that token. The probe does not make a second -// unauthenticated request. Failed is an expected probe-domain outcome; JSON-RPC errors are -// reserved for API-call failures. -func (a *MCPOauthAPI) Probe(ctx context.Context, params *MCPOauthProbeRequest) (MCPOauthProbeResult, error) { +// Returns: The applied host allowlist and effective session model policy after intersection. +func (a *ModelAPI) SetAllowedModels(ctx context.Context, params *ModelSetAllowedModelsRequest) (*ModelSetAllowedModelsResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["serverName"] = params.ServerName + if params.AllowedModels != nil { + req["allowedModels"] = params.AllowedModels + } } - raw, err := a.client.Request(ctx, "session.mcp.oauth.probe", req) + raw, err := a.client.Request(ctx, "session.model.setAllowedModels", req) if err != nil { return nil, err } - result, err := unmarshalMCPOauthProbeResult(raw) - if err != nil { + var result ModelSetAllowedModelsResult + if err := json.Unmarshal(raw, &result); err != nil { return nil, err } - return result, nil + return &result, nil } -// Responds to a pending MCP OAuth authorization request by its request id. +// SetReasoningEffort updates the session's reasoning effort without changing the selected +// model. // -// RPC method: session.mcp.oauth.respond. +// RPC method: session.model.setReasoningEffort. // -// Parameters: Pending MCP OAuth request id to respond to. +// Parameters: Reasoning effort level to apply to the currently selected model. // -// Returns: Indicates whether the pending MCP OAuth response was accepted. -func (a *MCPOauthAPI) Respond(ctx context.Context, params *MCPOauthRespondRequest) (*MCPOauthRespondResult, error) { +// 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. +func (a *ModelAPI) SetReasoningEffort(ctx context.Context, params *ModelSetReasoningEffortRequest) (*ModelSetReasoningEffortResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["requestId"] = params.RequestID + req["reasoningEffort"] = params.ReasoningEffort } - raw, err := a.client.Request(ctx, "session.mcp.oauth.respond", req) + raw, err := a.client.Request(ctx, "session.model.setReasoningEffort", req) if err != nil { return nil, err } - var result MCPOauthRespondResult + var result ModelSetReasoningEffortResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Oauth returns experimental APIs that may change or be removed. -func (s *MCPAPI) Oauth() *MCPOauthAPI { - return (*MCPOauthAPI)(s) -} - -// Experimental: MCPResourcesAPI contains experimental APIs that may change or be removed. -type MCPResourcesAPI sessionAPI - -// List enumerate one page of resources a connected MCP server exposes (proxies MCP -// `resources/list`). Pass `cursor` to continue from a prior result's `nextCursor`. +// SwitchAutoTier requests an Auto preference change without changing the session's selected +// model. The latest unclaimed request wins; the runtime commits it only after a later +// prompt using the `auto` model mints a usable model and token pair. A `pending` response +// confirms that the request was accepted, not that it committed. Observe eventual success +// through `session.model_change`, failure through the ephemeral +// `session.auto_tier_switch_failed` event, or current unclaimed state through +// `session.model.getCurrent`. // -// RPC method: session.mcp.resources.list. +// RPC method: session.model.switchAutoTier. // -// Parameters: MCP server whose resources to enumerate. +// Parameters: An Auto preference request for the session. This updates Auto configuration +// only; it does not change the selected model to `auto`. // -// Returns: One page of resources advertised by the named MCP server. -func (a *MCPResourcesAPI) List(ctx context.Context, params *MCPResourcesListRequest) (*MCPResourcesListResult, error) { +// Returns: Immediate acknowledgement and Auto preference snapshot after a switch request. +// This result never implies that a pending preference committed. +func (a *ModelAPI) SwitchAutoTier(ctx context.Context, params *ModelSwitchAutoTierRequest) (*ModelSwitchAutoTierResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Cursor != nil { - req["cursor"] = *params.Cursor + req["autoTier"] = params.AutoTier + if params.Source != nil { + req["source"] = *params.Source } - req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.mcp.resources.list", req) + raw, err := a.client.Request(ctx, "session.model.switchAutoTier", req) if err != nil { return nil, err } - var result MCPResourcesListResult + var result ModelSwitchAutoTierResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ListTemplates enumerate one page of resource templates a connected MCP server exposes -// (proxies MCP `resources/templates/list`). Pass `cursor` to continue from a prior result's -// `nextCursor`. +// SwitchTo switches the session to a model and optional reasoning configuration. // -// RPC method: session.mcp.resources.listTemplates. +// RPC method: session.model.switchTo. // -// Parameters: MCP server whose resource templates to enumerate. +// Parameters: Target model identifier and optional reasoning effort, summary, capability +// overrides, and context tier. // -// Returns: One page of resource templates advertised by the named MCP server. -func (a *MCPResourcesAPI) ListTemplates(ctx context.Context, params *MCPResourcesListTemplatesRequest) (*MCPResourcesListTemplatesResult, error) { +// Returns: The model identifier active on the session after the switch. +func (a *ModelAPI) SwitchTo(ctx context.Context, params *ModelSwitchToRequest) (*ModelSwitchToResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Cursor != nil { - req["cursor"] = *params.Cursor + if params.AutoTier != nil { + req["autoTier"] = *params.AutoTier + } + if params.CompactionDecision != nil { + req["compactionDecision"] = *params.CompactionDecision + } + if params.ContextTier != nil { + req["contextTier"] = *params.ContextTier + } + if params.DeferIfModelChangeQueued != nil { + req["deferIfModelChangeQueued"] = *params.DeferIfModelChangeQueued + } + if params.ModelCapabilities != nil { + req["modelCapabilities"] = *params.ModelCapabilities + } + if params.ModelChangeScope != nil { + req["modelChangeScope"] = *params.ModelChangeScope + } + req["modelId"] = params.ModelID + if params.PickerPersistence != nil { + req["pickerPersistence"] = *params.PickerPersistence + } + if params.ReasoningEffort != nil { + req["reasoningEffort"] = *params.ReasoningEffort + } + if params.ReasoningSummary != nil { + req["reasoningSummary"] = *params.ReasoningSummary + } + if params.RepoScope != nil { + req["repoScope"] = *params.RepoScope + } + if params.RequireAvailable != nil { + req["requireAvailable"] = *params.RequireAvailable + } + if params.RunCompactionPreflight != nil { + req["runCompactionPreflight"] = *params.RunCompactionPreflight + } + if params.Source != nil { + req["source"] = *params.Source + } + if params.Verbosity != nil { + req["verbosity"] = *params.Verbosity } - req["serverName"] = params.ServerName } - raw, err := a.client.Request(ctx, "session.mcp.resources.listTemplates", req) + raw, err := a.client.Request(ctx, "session.model.switchTo", req) if err != nil { return nil, err } - var result MCPResourcesListTemplatesResult + var result ModelSwitchToResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Read fetch an MCP resource from a connected server by URI (proxies MCP `resources/read`). -// -// RPC method: session.mcp.resources.read. +// Experimental: NameAPI contains experimental APIs that may change or be removed. +type NameAPI sessionAPI + +// Gets the session's friendly name. // -// Parameters: MCP server and resource URI to fetch. +// RPC method: session.name.get. // -// Returns: Resource contents returned by the MCP server. -func (a *MCPResourcesAPI) Read(ctx context.Context, params *MCPResourcesReadRequest) (*MCPResourcesReadResult, error) { +// Returns: The session's friendly name, or null when not yet set. +func (a *NameAPI) Get(ctx context.Context) (*NameGetResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["serverName"] = params.ServerName - req["uri"] = params.URI - } - raw, err := a.client.Request(ctx, "session.mcp.resources.read", req) + raw, err := a.client.Request(ctx, "session.name.get", req) if err != nil { return nil, err } - var result MCPResourcesReadResult + var result NameGetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Resources returns experimental APIs that may change or be removed. -func (s *MCPAPI) Resources() *MCPResourcesAPI { - return (*MCPResourcesAPI)(s) -} - -// Experimental: MetadataAPI contains experimental APIs that may change or be removed. -type MetadataAPI sessionAPI - -// Activity returns a snapshot of activity flags for the session. +// Sets the session's friendly name. // -// RPC method: session.metadata.activity. +// RPC method: session.name.set. // -// Returns: Current activity flags for the session. -func (a *MetadataAPI) Activity(ctx context.Context) (*SessionActivity, error) { +// Parameters: New friendly name to apply to the session. +func (a *NameAPI) Set(ctx context.Context, params *NameSetRequest) (*SessionNameSetResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.metadata.activity", req) + if params != nil { + req["name"] = params.Name + } + raw, err := a.client.Request(ctx, "session.name.set", req) if err != nil { return nil, err } - var result SessionActivity + var result SessionNameSetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ContextInfo returns the token breakdown for the session's current context window for a -// given model. +// SetAuto persists an auto-generated session summary as the session's name when no user-set +// name exists. // -// RPC method: session.metadata.contextInfo. +// RPC method: session.name.setAuto. // -// Parameters: Model identifier and token limits used to compute the context-info breakdown. +// Parameters: Auto-generated session summary to apply as the session's name when no +// user-set name exists. // -// Returns: Token breakdown for the session's current context window, or null if -// uninitialized. -func (a *MetadataAPI) ContextInfo(ctx context.Context, params *MetadataContextInfoRequest) (*MetadataContextInfoResult, error) { +// Returns: Indicates whether the auto-generated summary was applied as the session's name. +func (a *NameAPI) SetAuto(ctx context.Context, params *NameSetAutoRequest) (*NameSetAutoResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["outputTokenLimit"] = params.OutputTokenLimit - req["promptTokenLimit"] = params.PromptTokenLimit - if params.SelectedModel != nil { - req["selectedModel"] = *params.SelectedModel - } + req["summary"] = params.Summary } - raw, err := a.client.Request(ctx, "session.metadata.contextInfo", req) + raw, err := a.client.Request(ctx, "session.name.setAuto", req) if err != nil { return nil, err } - var result MetadataContextInfoResult + var result NameSetAutoResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetClientMetadata returns the client-owned string metadata persisted with this local -// session. The metadata is not included in model context, events, telemetry, snapshots, or -// remote exports. +// Experimental: OptionsAPI contains experimental APIs that may change or be removed. +type OptionsAPI sessionAPI + +// Update patches the genuinely-mutable subset of session options. // -// RPC method: session.metadata.getClientMetadata. +// RPC method: session.options.update. // -// Returns: Client-owned, case-sensitive string metadata persisted with a local session. -// Clients should namespace keys by owner. Keys must be non-empty and at most 256 UTF-8 -// bytes; keys under `copilot/` and `github/` are reserved. Values may contain at most 16 -// KiB of UTF-8 data. A bag may contain at most 128 entries and its serialized sidecar may -// contain at most 64 KiB. The runtime stores but never interprets these values. -func (a *MetadataAPI) GetClientMetadata(ctx context.Context) (*ClientMetadata, error) { +// Parameters: Patch of mutable session options to apply to the running session. +// +// Returns: Indicates whether the session options patch was applied successfully. +func (a *OptionsAPI) Update(ctx context.Context, params *SessionUpdateOptionsParams) (*SessionUpdateOptionsResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.metadata.getClientMetadata", req) - if err != nil { - return nil, err - } - var result ClientMetadata - if err := json.Unmarshal(raw, &result); err != nil { - return nil, err + if params != nil { + if params.AdditionalContentExclusionPolicies != nil { + req["additionalContentExclusionPolicies"] = params.AdditionalContentExclusionPolicies + } + if params.AgentContext != nil { + req["agentContext"] = *params.AgentContext + } + if params.AllowAllMCPServerInstructions != nil { + req["allowAllMcpServerInstructions"] = *params.AllowAllMCPServerInstructions + } + if params.AskUserDisabled != nil { + req["askUserDisabled"] = *params.AskUserDisabled + } + if params.AvailableTools != nil { + req["availableTools"] = params.AvailableTools + } + if params.Capi != nil { + req["capi"] = *params.Capi + } + if params.ClientName != nil { + req["clientName"] = *params.ClientName + } + if params.CoauthorEnabled != nil { + req["coauthorEnabled"] = *params.CoauthorEnabled + } + if params.ContextTier != nil { + req["contextTier"] = *params.ContextTier + } + if params.ContinueOnAutoMode != nil { + req["continueOnAutoMode"] = *params.ContinueOnAutoMode + } + if params.CopilotURL != nil { + req["copilotUrl"] = *params.CopilotURL + } + if params.CustomAgentsLocalOnly != nil { + req["customAgentsLocalOnly"] = *params.CustomAgentsLocalOnly + } + if params.DisabledInstructionSources != nil { + req["disabledInstructionSources"] = params.DisabledInstructionSources + } + if params.DisabledSkills != nil { + req["disabledSkills"] = params.DisabledSkills + } + if params.EnableFileHooks != nil { + req["enableFileHooks"] = *params.EnableFileHooks + } + if params.EnableHostGitOperations != nil { + req["enableHostGitOperations"] = *params.EnableHostGitOperations + } + if params.EnableOnDemandInstructionDiscovery != nil { + req["enableOnDemandInstructionDiscovery"] = *params.EnableOnDemandInstructionDiscovery + } + if params.EnableReasoningSummaries != nil { + req["enableReasoningSummaries"] = *params.EnableReasoningSummaries + } + if params.EnableScriptSafety != nil { + req["enableScriptSafety"] = *params.EnableScriptSafety + } + if params.EnableSessionStore != nil { + req["enableSessionStore"] = *params.EnableSessionStore + } + if params.EnableSkills != nil { + req["enableSkills"] = *params.EnableSkills + } + if params.EnableStreaming != nil { + req["enableStreaming"] = *params.EnableStreaming + } + if params.EnvValueMode != nil { + req["envValueMode"] = *params.EnvValueMode + } + if params.EventsLogDirectory != nil { + req["eventsLogDirectory"] = *params.EventsLogDirectory + } + if params.EventsLogIncludesSubagents != nil { + req["eventsLogIncludesSubagents"] = *params.EventsLogIncludesSubagents + } + if params.ExcludedBuiltinAgents != nil { + req["excludedBuiltinAgents"] = params.ExcludedBuiltinAgents + } + if params.ExcludedTools != nil { + req["excludedTools"] = params.ExcludedTools + } + if params.FeatureFlags != nil { + req["featureFlags"] = params.FeatureFlags + } + if params.IncludedBuiltinAgents != nil { + req["includedBuiltinAgents"] = params.IncludedBuiltinAgents + } + if params.IncludedBuiltinSkills != nil { + req["includedBuiltinSkills"] = params.IncludedBuiltinSkills + } + if params.InstalledPlugins != nil { + req["installedPlugins"] = params.InstalledPlugins + } + if params.IntegrationID != nil { + req["integrationId"] = *params.IntegrationID + } + if params.IsExperimentalMode != nil { + req["isExperimentalMode"] = *params.IsExperimentalMode + } + if params.LogInteractiveShells != nil { + req["logInteractiveShells"] = *params.LogInteractiveShells + } + if params.LspClientName != nil { + req["lspClientName"] = *params.LspClientName + } + if params.ManageScheduleEnabled != nil { + req["manageScheduleEnabled"] = *params.ManageScheduleEnabled + } + if params.MaxInlineBinaryBytes != nil { + req["maxInlineBinaryBytes"] = *params.MaxInlineBinaryBytes + } + if params.Model != nil { + req["model"] = *params.Model + } + if params.ModelCapabilitiesOverrides != nil { + req["modelCapabilitiesOverrides"] = *params.ModelCapabilitiesOverrides + } + if params.OrganizationCustomInstructions != nil { + req["organizationCustomInstructions"] = *params.OrganizationCustomInstructions + } + if params.Provider != nil { + req["provider"] = *params.Provider + } + if params.ReasoningEffort != nil { + req["reasoningEffort"] = *params.ReasoningEffort + } + if params.ReasoningSummary != nil { + req["reasoningSummary"] = *params.ReasoningSummary + } + if params.RunningInInteractiveMode != nil { + req["runningInInteractiveMode"] = *params.RunningInInteractiveMode + } + if params.SandboxConfig != nil { + req["sandboxConfig"] = *params.SandboxConfig + } + if params.SandboxConfigSource != nil { + req["sandboxConfigSource"] = *params.SandboxConfigSource + } + if params.SessionCapabilities != nil { + req["sessionCapabilities"] = params.SessionCapabilities + } + if params.SessionLimits != nil { + req["sessionLimits"] = *params.SessionLimits + } + if params.Shell != nil { + req["shell"] = *params.Shell + } + if params.ShellInitProfile != nil { + req["shellInitProfile"] = *params.ShellInitProfile + } + if params.ShellProcessFlags != nil { + req["shellProcessFlags"] = params.ShellProcessFlags + } + if params.SkillDirectories != nil { + req["skillDirectories"] = params.SkillDirectories + } + if params.SkipCustomInstructions != nil { + req["skipCustomInstructions"] = *params.SkipCustomInstructions + } + if params.SkipEmbeddingRetrieval != nil { + req["skipEmbeddingRetrieval"] = *params.SkipEmbeddingRetrieval + } + if params.SuppressCustomAgentPrompt != nil { + req["suppressCustomAgentPrompt"] = *params.SuppressCustomAgentPrompt + } + if params.ToolFilterPrecedence != nil { + req["toolFilterPrecedence"] = *params.ToolFilterPrecedence + } + if params.TrajectoryFile != nil { + req["trajectoryFile"] = *params.TrajectoryFile + } + if params.Verbosity != nil { + req["verbosity"] = *params.Verbosity + } + if params.WorkingDirectory != nil { + req["workingDirectory"] = *params.WorkingDirectory + } } - return &result, nil -} - -// GetContextAttribution returns the experimental per-source attribution breakdown of the -// session's current context window as a flat list of entries (skills, subagents, MCP -// servers, built-in tools, plugin rollups, system/tool-definition costs, with nesting via -// parentId), plus the successful compaction count. The heaviest individual messages are -// available separately via `metadata.getContextHeaviestMessages`. Returns null until the -// session has initialized its system prompt and tool metadata. -// -// RPC method: session.metadata.getContextAttribution. -// -// Returns: Per-source attribution breakdown for the session's current context window, or -// null if uninitialized. -func (a *MetadataAPI) GetContextAttribution(ctx context.Context) (*MetadataContextAttributionResult, error) { - req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.metadata.getContextAttribution", req) + raw, err := a.client.Request(ctx, "session.options.update", req) if err != nil { return nil, err } - var result MetadataContextAttributionResult + var result SessionUpdateOptionsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetContextHeaviestMessages returns the largest individual messages currently in the -// session's context window, most-expensive first. Companion to -// `metadata.getContextAttribution`. Returns an empty list until the session has initialized. +// Experimental: PermissionsAPI contains experimental APIs that may change or be removed. +type PermissionsAPI sessionAPI + +// Configure replaces selected permission policy fields (rules, paths, URLs, exclusions, +// allow-all flags) on the session. // -// RPC method: session.metadata.getContextHeaviestMessages. +// RPC method: session.permissions.configure. // -// Parameters: Parameters for the heaviest-messages query. +// Parameters: Patch of permission policy fields to apply (omit a field to leave it +// unchanged). // -// Returns: The heaviest individual messages in the session's context window, most-expensive -// first. -func (a *MetadataAPI) GetContextHeaviestMessages(ctx context.Context, params *MetadataContextHeaviestMessagesRequest) (*MetadataContextHeaviestMessagesResult, error) { +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsAPI) Configure(ctx context.Context, params *PermissionsConfigureParams) (*PermissionsConfigureResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Limit != nil { - req["limit"] = *params.Limit + if params.AdditionalContentExclusionPolicies != nil { + req["additionalContentExclusionPolicies"] = params.AdditionalContentExclusionPolicies + } + if params.ApproveAllReadPermissionRequests != nil { + req["approveAllReadPermissionRequests"] = *params.ApproveAllReadPermissionRequests + } + if params.ApproveAllToolPermissionRequests != nil { + req["approveAllToolPermissionRequests"] = *params.ApproveAllToolPermissionRequests + } + if params.Paths != nil { + req["paths"] = *params.Paths + } + if params.Rules != nil { + req["rules"] = *params.Rules + } + if params.URLs != nil { + req["urls"] = *params.URLs } } - raw, err := a.client.Request(ctx, "session.metadata.getContextHeaviestMessages", req) + raw, err := a.client.Request(ctx, "session.permissions.configure", req) if err != nil { return nil, err } - var result MetadataContextHeaviestMessagesResult + var result PermissionsConfigureResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// IsProcessing reports whether the local session is currently processing user/agent -// messages. +// GetMode returns the current permission mode for the session. // -// RPC method: session.metadata.isProcessing. +// RPC method: session.permissions.getMode. // -// Returns: Indicates whether the local session is currently processing a turn or background -// continuation. -func (a *MetadataAPI) IsProcessing(ctx context.Context) (*MetadataIsProcessingResult, error) { +// Returns: Current permission mode. +func (a *PermissionsAPI) GetMode(ctx context.Context) (*PermissionsGetModeResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.metadata.isProcessing", req) + raw, err := a.client.Request(ctx, "session.permissions.getMode", req) if err != nil { return nil, err } - var result MetadataIsProcessingResult + var result PermissionsGetModeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RecomputeContextTokens re-tokenizes the session's existing messages against a model and -// returns aggregate token totals. +// HandlePendingPermissionRequest provides a decision for a pending tool permission request. // -// RPC method: session.metadata.recomputeContextTokens. +// RPC method: session.permissions.handlePendingPermissionRequest. // -// Parameters: Model identifier to use when re-tokenizing the session's existing messages. +// Parameters: Pending permission request ID and the decision to apply (approve/reject and +// scope). // -// Returns: Re-tokenize the session's existing messages against `modelId` and return the -// token totals. Useful for hosts that want an initial estimate of context usage on session -// resume, before the next agent turn fires `session.context_info_changed` events. Returns -// zeros for an empty session. -func (a *MetadataAPI) RecomputeContextTokens(ctx context.Context, params *MetadataRecomputeContextTokensRequest) (*MetadataRecomputeContextTokensResult, error) { +// Returns: Indicates whether the permission decision was applied; false when the request +// was already resolved. +func (a *PermissionsAPI) HandlePendingPermissionRequest(ctx context.Context, params *PermissionDecisionRequest) (*PermissionRequestResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["modelId"] = params.ModelID + if params.DecisionContext != nil { + req["decisionContext"] = *params.DecisionContext + } + req["requestId"] = params.RequestID + req["result"] = params.Result } - raw, err := a.client.Request(ctx, "session.metadata.recomputeContextTokens", req) + raw, err := a.client.Request(ctx, "session.permissions.handlePendingPermissionRequest", req) if err != nil { return nil, err } - var result MetadataRecomputeContextTokensResult + var result PermissionRequestResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RecordContextChange records a working-directory/git context change and emits a -// `session.context_changed` event. For a local session, a report whose `cwd` diverges from -// the session's current working directory is ignored (the call still succeeds but records -// nothing and emits no event): a local session's working directory is authoritative and is -// moved via `metadata.setWorkingDirectory` (or an SDK `session.resume` that supplies a -// `workingDirectory`), not by this method. +// ModifyRules adds or removes session-scoped or location-scoped permission rules. // -// RPC method: session.metadata.recordContextChange. +// RPC method: session.permissions.modifyRules. // -// Parameters: Updated working-directory/git context to record on the session. +// Parameters: Scope and add/remove instructions for modifying session- or location-scoped +// permission rules. // -// Returns: Notify the session that its working directory context has changed. Emits a -// `session.context_changed` event so consumers (telemetry, OTel tracker, ACP, the timeline -// UI) can react. Use this when the host has detected a cwd/branch/repo change outside the -// session's normal lifecycle (e.g., after a shell command in interactive mode). For a local -// session, a report whose `cwd` diverges from the session's current working directory is -// ignored (the call still succeeds but records nothing and emits no event); move a local -// session's working directory via `metadata.setWorkingDirectory` instead. -func (a *MetadataAPI) RecordContextChange(ctx context.Context, params *MetadataRecordContextChangeRequest) (*MetadataRecordContextChangeResult, error) { +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsAPI) ModifyRules(ctx context.Context, params *PermissionsModifyRulesParams) (*PermissionsModifyRulesResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["context"] = params.Context + if params.Add != nil { + req["add"] = params.Add + } + if params.Remove != nil { + req["remove"] = params.Remove + } + if params.RemoveAll != nil { + req["removeAll"] = *params.RemoveAll + } + req["scope"] = params.Scope } - raw, err := a.client.Request(ctx, "session.metadata.recordContextChange", req) + raw, err := a.client.Request(ctx, "session.permissions.modifyRules", req) if err != nil { return nil, err } - var result MetadataRecordContextChangeResult + var result PermissionsModifyRulesResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetWorkingDirectory updates the session's working directory. For local sessions the -// target is validated first (an absolute path that exists on disk) and the permission -// primary directory is re-based; a rejected validation fails the call before any session -// state changes. +// NotifyPromptShown notifies the runtime that a permission prompt UI has been shown to the +// user. // -// RPC method: session.metadata.setWorkingDirectory. +// RPC method: session.permissions.notifyPromptShown. // -// Parameters: Absolute path to set as the session's new working directory. For local -// sessions the path must be absolute and exist on disk: it is validated before any session -// state changes, and a failing validation rejects the call with nothing mutated, persisted, -// or emitted. Remote sessions record the path as-is. +// Parameters: Notification payload describing the permission prompt that the client just +// rendered. // -// Returns: Update the session's working directory. Used by the host when the user -// explicitly changes cwd (e.g., the `/cd` slash command). The host is responsible for any -// related side-effects (file index, etc.); it does NOT change the process working directory -// (a session's cwd is per-session, not process-global). For local sessions the runtime -// validates the target first (an absolute path that exists on disk) and re-bases the -// permission primary directory; a rejected validation fails the call before anything is -// mutated, persisted, or emitted. Location-scoped permission rules are then re-keyed to the -// new directory (best-effort). Remote sessions only record the path. -func (a *MetadataAPI) SetWorkingDirectory(ctx context.Context, params *MetadataSetWorkingDirectoryRequest) (*MetadataSetWorkingDirectoryResult, error) { +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsAPI) NotifyPromptShown(ctx context.Context, params *PermissionPromptShownNotification) (*PermissionsNotifyPromptShownResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["workingDirectory"] = params.WorkingDirectory + req["message"] = params.Message } - raw, err := a.client.Request(ctx, "session.metadata.setWorkingDirectory", req) + raw, err := a.client.Request(ctx, "session.permissions.notifyPromptShown", req) if err != nil { return nil, err } - var result MetadataSetWorkingDirectoryResult + var result PermissionsNotifyPromptShownResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Snapshot returns a snapshot of the session's identifying metadata, mode, agent, and -// remote info. +// PendingRequests reconstructs the set of pending tool permission requests from the +// session's event history. // -// RPC method: session.metadata.snapshot. +// RPC method: session.permissions.pendingRequests. // -// Returns: Point-in-time snapshot of slow-changing session identifier and state fields -func (a *MetadataAPI) Snapshot(ctx context.Context) (*SessionMetadataSnapshot, error) { +// Returns: List of pending permission requests reconstructed from event history. +func (a *PermissionsAPI) PendingRequests(ctx context.Context) (*PendingPermissionRequestList, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.metadata.snapshot", req) + raw, err := a.client.Request(ctx, "session.permissions.pendingRequests", req) if err != nil { return nil, err } - var result SessionMetadataSnapshot + var result PendingPermissionRequestList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// UpdateClientMetadata atomically patches the client-owned string metadata persisted with -// this local session and returns the committed bag. +// ResetSessionApprovals clears session-scoped tool permission approvals. // -// RPC method: session.metadata.updateClientMetadata. +// RPC method: session.permissions.resetSessionApprovals. // -// Parameters: Atomic patch for client-owned session metadata. Operations apply in clear, -// remove, then set order. The resulting bag must satisfy the ClientMetadata entry and -// serialized-size limits. Local storage coordinates concurrent runtime processes; custom -// SessionFs providers must serialize writers that access the same session from multiple -// processes. +// Parameters: Clears session-scoped tool permission approvals, and optionally the +// location-scoped ones. // -// Returns: Client-owned, case-sensitive string metadata persisted with a local session. -// Clients should namespace keys by owner. Keys must be non-empty and at most 256 UTF-8 -// bytes; keys under `copilot/` and `github/` are reserved. Values may contain at most 16 -// KiB of UTF-8 data. A bag may contain at most 128 entries and its serialized sidecar may -// contain at most 64 KiB. The runtime stores but never interprets these values. -func (a *MetadataAPI) UpdateClientMetadata(ctx context.Context, params *MetadataUpdateClientMetadataRequest) (*ClientMetadata, error) { +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsAPI) ResetSessionApprovals(ctx context.Context, params *PermissionsResetSessionApprovalsRequest) (*PermissionsResetSessionApprovalsResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Clear != nil { - req["clear"] = *params.Clear - } - if params.Remove != nil { - req["remove"] = params.Remove - } - if params.Set != nil { - req["set"] = params.Set + if params.IncludeLocation != nil { + req["includeLocation"] = *params.IncludeLocation } } - raw, err := a.client.Request(ctx, "session.metadata.updateClientMetadata", req) + raw, err := a.client.Request(ctx, "session.permissions.resetSessionApprovals", req) if err != nil { return nil, err } - var result ClientMetadata + var result PermissionsResetSessionApprovalsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ModeAPI contains experimental APIs that may change or be removed. -type ModeAPI sessionAPI - -// Gets the current agent interaction mode. +// SetApproveAll enables or disables automatic approval of tool permission requests for the +// session. // -// RPC method: session.mode.get. +// RPC method: session.permissions.setApproveAll. // -// Returns: The session mode the agent is operating in -func (a *ModeAPI) Get(ctx context.Context) (*SessionMode, error) { +// Parameters: Allow-all toggle for tool permission requests, with an optional telemetry +// source. +// +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsAPI) SetApproveAll(ctx context.Context, params *PermissionsSetApproveAllRequest) (*PermissionsSetApproveAllResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.mode.get", req) + if params != nil { + req["enabled"] = params.Enabled + if params.Source != nil { + req["source"] = *params.Source + } + } + raw, err := a.client.Request(ctx, "session.permissions.setApproveAll", req) if err != nil { return nil, err } - var result SessionMode + var result PermissionsSetApproveAllResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Sets the current agent interaction mode. +// SetMode sets the permission mode for the session. `manual` follows the normal approval +// flow, `assisted` attaches LLM safety recommendations, and `allow-all` automatically +// approves permission requests. The result returns the authoritative post-mutation mode so +// callers can update local state without racing the `session.permissions_changed` +// notification. // -// RPC method: session.mode.set. +// RPC method: session.permissions.setMode. // -// Parameters: Agent interaction mode to apply to the session. +// Parameters: Permission mode to apply for the session. // -// Returns: Outcome of a session mode change, including any model switch it triggered and -// follow-up the host must perform. -func (a *ModeAPI) Set(ctx context.Context, params *ModeSetRequest) (*ModeSetResult, error) { +// Returns: Indicates whether the requested permission mode was applied and reports the +// authoritative post-mutation mode. +func (a *PermissionsAPI) SetMode(ctx context.Context, params *PermissionsSetModeRequest) (*PermissionsSetModeResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.CompactionDecision != nil { - req["compactionDecision"] = *params.CompactionDecision - } - if params.ExpectedMode != nil { - req["expectedMode"] = *params.ExpectedMode - } - if params.InheritPlanBaseFromSessionID != nil { - req["inheritPlanBaseFromSessionId"] = *params.InheritPlanBaseFromSessionID + if params.AssistedApprovalModel != nil { + req["assistedApprovalModel"] = *params.AssistedApprovalModel } req["mode"] = params.Mode - if params.PersistPlanSelection != nil { - req["persistPlanSelection"] = *params.PersistPlanSelection - } - if params.PickerSettingsContext != nil { - req["pickerSettingsContext"] = *params.PickerSettingsContext - } - if params.PlanContextTier != nil { - req["planContextTier"] = *params.PlanContextTier - } - if params.PlanExitAction != nil { - req["planExitAction"] = *params.PlanExitAction - } - if params.PlanModel != nil { - req["planModel"] = *params.PlanModel - } - if params.PlanModelConfigured != nil { - req["planModelConfigured"] = *params.PlanModelConfigured - } - if params.PlanReasoningEffort != nil { - req["planReasoningEffort"] = *params.PlanReasoningEffort - } - if params.RestorePlanModel != nil { - req["restorePlanModel"] = *params.RestorePlanModel + if params.Source != nil { + req["source"] = *params.Source } } - raw, err := a.client.Request(ctx, "session.mode.set", req) + raw, err := a.client.Request(ctx, "session.permissions.setMode", req) if err != nil { return nil, err } - var result ModeSetResult + var result PermissionsSetModeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ModelAPI contains experimental APIs that may change or be removed. -type ModelAPI sessionAPI - -// GetCurrent gets the session's authoritative model snapshot, including the committed Auto -// preference and any newer unclaimed Auto preference waiting for a future user turn. +// SetRequired sets whether the client wants permission prompts bridged into session events. // -// RPC method: session.model.getCurrent. +// RPC method: session.permissions.setRequired. // -// 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. -func (a *ModelAPI) GetCurrent(ctx context.Context) (*CurrentModel, error) { +// Parameters: Toggles whether permission prompts should be bridged into session events for +// this client. +// +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsAPI) SetRequired(ctx context.Context, params *PermissionsSetRequiredRequest) (*PermissionsSetRequiredResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.model.getCurrent", req) + if params != nil { + req["required"] = params.Required + } + raw, err := a.client.Request(ctx, "session.permissions.setRequired", req) if err != nil { return nil, err } - var result CurrentModel + var result PermissionsSetRequiredResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// 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. +// Experimental: PermissionsFolderTrustAPI contains experimental APIs that may change or be +// removed. +type PermissionsFolderTrustAPI sessionAPI + +// AddTrusted adds a folder to the user's trusted folders list. // -// RPC method: session.model.list. +// RPC method: session.permissions.folderTrust.addTrusted. // -// Parameters: Optional listing options. +// Parameters: Folder path to add to trusted folders. // -// Returns: The list of models available to this session. -func (a *ModelAPI) List(ctx context.Context, params ...*SessionModelListRequest) (*SessionModelList, error) { - var requestParams *SessionModelListRequest - if len(params) > 0 { - requestParams = params[0] - } +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsFolderTrustAPI) AddTrusted(ctx context.Context, params *FolderTrustAddParams) (*PermissionsFolderTrustAddTrustedResult, error) { req := map[string]any{"sessionId": a.sessionID} - if requestParams != nil { - if requestParams.SkipCache != nil { - req["skipCache"] = *requestParams.SkipCache - } + if params != nil { + req["path"] = params.Path } - raw, err := a.client.Request(ctx, "session.model.list", req) + raw, err := a.client.Request(ctx, "session.permissions.folderTrust.addTrusted", req) if err != nil { return nil, err } - var result SessionModelList + var result PermissionsFolderTrustAddTrustedResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetAllowedModels replaces or clears the host-supplied model allowlist for a running -// session. +// IsTrusted reports whether a folder is trusted according to the user's folder trust state. // -// RPC method: session.model.setAllowedModels. +// RPC method: session.permissions.folderTrust.isTrusted. // -// Parameters: Host-supplied exact model selection IDs to allow for this running session. -// CAPI IDs are intersected with repository `.github/allowed_models.txt` policy; -// provider-qualified IDs remain exempt from repository-only policy but are restricted by -// this host list. Omit or pass null to clear the host restriction; an explicit empty or -// disjoint list is rejected. Validation and pre-selection fallback failures preserve the -// previous restriction. Failures after a fallback selection commits retain the new -// restriction and selected model; callers should inspect current session state after such -// an error. +// Parameters: Folder path to check for trust. // -// Returns: The applied host allowlist and effective session model policy after intersection. -func (a *ModelAPI) SetAllowedModels(ctx context.Context, params *ModelSetAllowedModelsRequest) (*ModelSetAllowedModelsResult, error) { +// Returns: Folder trust check result. +func (a *PermissionsFolderTrustAPI) IsTrusted(ctx context.Context, params *FolderTrustCheckParams) (*FolderTrustCheckResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.AllowedModels != nil { - req["allowedModels"] = params.AllowedModels - } + req["path"] = params.Path } - raw, err := a.client.Request(ctx, "session.model.setAllowedModels", req) + raw, err := a.client.Request(ctx, "session.permissions.folderTrust.isTrusted", req) if err != nil { return nil, err } - var result ModelSetAllowedModelsResult + var result FolderTrustCheckResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetReasoningEffort updates the session's reasoning effort without changing the selected -// model. +// Experimental: FolderTrust returns experimental APIs that may change or be removed. +func (s *PermissionsAPI) FolderTrust() *PermissionsFolderTrustAPI { + return (*PermissionsFolderTrustAPI)(s) +} + +// Experimental: PermissionsLocationsAPI contains experimental APIs that may change or be +// removed. +type PermissionsLocationsAPI sessionAPI + +// AddToolApproval persists a tool approval for a permission location and applies its rules +// to this session's live permission service. // -// RPC method: session.model.setReasoningEffort. +// RPC method: session.permissions.locations.addToolApproval. // -// Parameters: Reasoning effort level to apply to the currently selected model. +// Parameters: Location-scoped tool approval to persist. // -// 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. -func (a *ModelAPI) SetReasoningEffort(ctx context.Context, params *ModelSetReasoningEffortRequest) (*ModelSetReasoningEffortResult, error) { +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsLocationsAPI) AddToolApproval(ctx context.Context, params *PermissionLocationAddToolApprovalParams) (*PermissionsLocationsAddToolApprovalResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["reasoningEffort"] = params.ReasoningEffort + req["approval"] = params.Approval + req["locationKey"] = params.LocationKey } - raw, err := a.client.Request(ctx, "session.model.setReasoningEffort", req) + raw, err := a.client.Request(ctx, "session.permissions.locations.addToolApproval", req) if err != nil { return nil, err } - var result ModelSetReasoningEffortResult + var result PermissionsLocationsAddToolApprovalResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SwitchAutoTier requests an Auto preference change without changing the session's selected -// model. The latest unclaimed request wins; the runtime commits it only after a later -// prompt using the `auto` model mints a usable model and token pair. A `pending` response -// confirms that the request was accepted, not that it committed. Observe eventual success -// through `session.model_change`, failure through the ephemeral -// `session.auto_tier_switch_failed` event, or current unclaimed state through -// `session.model.getCurrent`. +// Apply applies persisted location-scoped tool approvals and allowed directories for a +// working directory to this session's permission service. // -// RPC method: session.model.switchAutoTier. +// RPC method: session.permissions.locations.apply. // -// Parameters: An Auto preference request for the session. This updates Auto configuration -// only; it does not change the selected model to `auto`. +// Parameters: Working directory to load persisted location permissions for. // -// Returns: Immediate acknowledgement and Auto preference snapshot after a switch request. -// This result never implies that a pending preference committed. -func (a *ModelAPI) SwitchAutoTier(ctx context.Context, params *ModelSwitchAutoTierRequest) (*ModelSwitchAutoTierResult, error) { +// Returns: Summary of persisted location permissions applied to the session. +func (a *PermissionsLocationsAPI) Apply(ctx context.Context, params *PermissionLocationApplyParams) (*PermissionLocationApplyResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["autoTier"] = params.AutoTier - if params.Source != nil { - req["source"] = *params.Source - } + req["workingDirectory"] = params.WorkingDirectory } - raw, err := a.client.Request(ctx, "session.model.switchAutoTier", req) + raw, err := a.client.Request(ctx, "session.permissions.locations.apply", req) if err != nil { return nil, err } - var result ModelSwitchAutoTierResult + var result PermissionLocationApplyResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SwitchTo switches the session to a model and optional reasoning configuration. +// Resolves the permission location key and type for a working directory. // -// RPC method: session.model.switchTo. +// RPC method: session.permissions.locations.resolve. // -// Parameters: Target model identifier and optional reasoning effort, summary, capability -// overrides, and context tier. +// Parameters: Working directory to resolve into a location-permissions key. // -// Returns: The model identifier active on the session after the switch. -func (a *ModelAPI) SwitchTo(ctx context.Context, params *ModelSwitchToRequest) (*ModelSwitchToResult, error) { +// Returns: Resolved location-permissions key and type. +func (a *PermissionsLocationsAPI) Resolve(ctx context.Context, params *PermissionLocationResolveParams) (*PermissionLocationResolveResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.AutoTier != nil { - req["autoTier"] = *params.AutoTier - } - if params.CompactionDecision != nil { - req["compactionDecision"] = *params.CompactionDecision - } - if params.ContextTier != nil { - req["contextTier"] = *params.ContextTier - } - if params.DeferIfModelChangeQueued != nil { - req["deferIfModelChangeQueued"] = *params.DeferIfModelChangeQueued - } - if params.ModelCapabilities != nil { - req["modelCapabilities"] = *params.ModelCapabilities - } - if params.ModelChangeScope != nil { - req["modelChangeScope"] = *params.ModelChangeScope - } - req["modelId"] = params.ModelID - if params.PickerPersistence != nil { - req["pickerPersistence"] = *params.PickerPersistence - } - if params.ReasoningEffort != nil { - req["reasoningEffort"] = *params.ReasoningEffort - } - if params.ReasoningSummary != nil { - req["reasoningSummary"] = *params.ReasoningSummary - } - if params.RepoScope != nil { - req["repoScope"] = *params.RepoScope - } - if params.RequireAvailable != nil { - req["requireAvailable"] = *params.RequireAvailable - } - if params.RunCompactionPreflight != nil { - req["runCompactionPreflight"] = *params.RunCompactionPreflight - } - if params.Source != nil { - req["source"] = *params.Source - } - if params.Verbosity != nil { - req["verbosity"] = *params.Verbosity - } + req["workingDirectory"] = params.WorkingDirectory } - raw, err := a.client.Request(ctx, "session.model.switchTo", req) + raw, err := a.client.Request(ctx, "session.permissions.locations.resolve", req) if err != nil { return nil, err } - var result ModelSwitchToResult + var result PermissionLocationResolveResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: NameAPI contains experimental APIs that may change or be removed. -type NameAPI sessionAPI +// Experimental: Locations returns experimental APIs that may change or be removed. +func (s *PermissionsAPI) Locations() *PermissionsLocationsAPI { + return (*PermissionsLocationsAPI)(s) +} -// Gets the session's friendly name. +// Experimental: PermissionsPathsAPI contains experimental APIs that may change or be +// removed. +type PermissionsPathsAPI sessionAPI + +// Adds a directory to the session's allow-list and activates conventional skill and agent +// definitions under it. // -// RPC method: session.name.get. +// RPC method: session.permissions.paths.add. // -// Returns: The session's friendly name, or null when not yet set. -func (a *NameAPI) Get(ctx context.Context) (*NameGetResult, error) { +// Parameters: Directory path to add to the session's allowed directories. +// +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsPathsAPI) Add(ctx context.Context, params *PermissionPathsAddParams) (*PermissionsPathsAddResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.name.get", req) + if params != nil { + req["path"] = params.Path + } + raw, err := a.client.Request(ctx, "session.permissions.paths.add", req) if err != nil { return nil, err } - var result NameGetResult + var result PermissionsPathsAddResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Sets the session's friendly name. +// IsPathWithinAllowedDirectories reports whether a path falls within any of the session's +// allowed directories. // -// RPC method: session.name.set. +// RPC method: session.permissions.paths.isPathWithinAllowedDirectories. // -// Parameters: New friendly name to apply to the session. -func (a *NameAPI) Set(ctx context.Context, params *NameSetRequest) (*SessionNameSetResult, error) { +// Parameters: Path to evaluate against the session's allowed directories. +// +// Returns: Indicates whether the supplied path is within the session's allowed directories. +func (a *PermissionsPathsAPI) IsPathWithinAllowedDirectories(ctx context.Context, params *PermissionPathsAllowedCheckParams) (*PermissionPathsAllowedCheckResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["name"] = params.Name + req["path"] = params.Path } - raw, err := a.client.Request(ctx, "session.name.set", req) + raw, err := a.client.Request(ctx, "session.permissions.paths.isPathWithinAllowedDirectories", req) if err != nil { return nil, err } - var result SessionNameSetResult + var result PermissionPathsAllowedCheckResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetAuto persists an auto-generated session summary as the session's name when no user-set -// name exists. +// IsPathWithinWorkspace reports whether a path falls within the session's workspace +// (primary) directory. // -// RPC method: session.name.setAuto. +// RPC method: session.permissions.paths.isPathWithinWorkspace. // -// Parameters: Auto-generated session summary to apply as the session's name when no -// user-set name exists. +// Parameters: Path to evaluate against the session's workspace (primary) directory. // -// Returns: Indicates whether the auto-generated summary was applied as the session's name. -func (a *NameAPI) SetAuto(ctx context.Context, params *NameSetAutoRequest) (*NameSetAutoResult, error) { +// Returns: Indicates whether the supplied path is within the session's workspace directory. +func (a *PermissionsPathsAPI) IsPathWithinWorkspace(ctx context.Context, params *PermissionPathsWorkspaceCheckParams) (*PermissionPathsWorkspaceCheckResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["summary"] = params.Summary + req["path"] = params.Path } - raw, err := a.client.Request(ctx, "session.name.setAuto", req) + raw, err := a.client.Request(ctx, "session.permissions.paths.isPathWithinWorkspace", req) if err != nil { return nil, err } - var result NameSetAutoResult + var result PermissionPathsWorkspaceCheckResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } - -// Experimental: OptionsAPI contains experimental APIs that may change or be removed. -type OptionsAPI sessionAPI - -// Update patches the genuinely-mutable subset of session options. -// -// RPC method: session.options.update. -// -// Parameters: Patch of mutable session options to apply to the running session. -// -// Returns: Indicates whether the session options patch was applied successfully. -func (a *OptionsAPI) Update(ctx context.Context, params *SessionUpdateOptionsParams) (*SessionUpdateOptionsResult, error) { - req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.AdditionalContentExclusionPolicies != nil { - req["additionalContentExclusionPolicies"] = params.AdditionalContentExclusionPolicies - } - if params.AgentContext != nil { - req["agentContext"] = *params.AgentContext - } - if params.AllowAllMCPServerInstructions != nil { - req["allowAllMcpServerInstructions"] = *params.AllowAllMCPServerInstructions - } - if params.AskUserDisabled != nil { - req["askUserDisabled"] = *params.AskUserDisabled - } - if params.AvailableTools != nil { - req["availableTools"] = params.AvailableTools - } - if params.Capi != nil { - req["capi"] = *params.Capi - } - if params.ClientName != nil { - req["clientName"] = *params.ClientName - } - if params.CoauthorEnabled != nil { - req["coauthorEnabled"] = *params.CoauthorEnabled - } - if params.ContextTier != nil { - req["contextTier"] = *params.ContextTier - } - if params.ContinueOnAutoMode != nil { - req["continueOnAutoMode"] = *params.ContinueOnAutoMode - } - if params.CopilotURL != nil { - req["copilotUrl"] = *params.CopilotURL - } - if params.CustomAgentsLocalOnly != nil { - req["customAgentsLocalOnly"] = *params.CustomAgentsLocalOnly - } - if params.DisabledInstructionSources != nil { - req["disabledInstructionSources"] = params.DisabledInstructionSources - } - if params.DisabledSkills != nil { - req["disabledSkills"] = params.DisabledSkills - } - if params.EnableFileHooks != nil { - req["enableFileHooks"] = *params.EnableFileHooks - } - if params.EnableHostGitOperations != nil { - req["enableHostGitOperations"] = *params.EnableHostGitOperations - } - if params.EnableOnDemandInstructionDiscovery != nil { - req["enableOnDemandInstructionDiscovery"] = *params.EnableOnDemandInstructionDiscovery - } - if params.EnableReasoningSummaries != nil { - req["enableReasoningSummaries"] = *params.EnableReasoningSummaries - } - if params.EnableScriptSafety != nil { - req["enableScriptSafety"] = *params.EnableScriptSafety - } - if params.EnableSessionStore != nil { - req["enableSessionStore"] = *params.EnableSessionStore - } - if params.EnableSkills != nil { - req["enableSkills"] = *params.EnableSkills - } - if params.EnableStreaming != nil { - req["enableStreaming"] = *params.EnableStreaming - } - if params.EnvValueMode != nil { - req["envValueMode"] = *params.EnvValueMode - } - if params.EventsLogDirectory != nil { - req["eventsLogDirectory"] = *params.EventsLogDirectory - } - if params.EventsLogIncludesSubagents != nil { - req["eventsLogIncludesSubagents"] = *params.EventsLogIncludesSubagents - } - if params.ExcludedBuiltinAgents != nil { - req["excludedBuiltinAgents"] = params.ExcludedBuiltinAgents - } - if params.ExcludedTools != nil { - req["excludedTools"] = params.ExcludedTools - } - if params.FeatureFlags != nil { - req["featureFlags"] = params.FeatureFlags - } - if params.IncludedBuiltinAgents != nil { - req["includedBuiltinAgents"] = params.IncludedBuiltinAgents - } - if params.IncludedBuiltinSkills != nil { - req["includedBuiltinSkills"] = params.IncludedBuiltinSkills - } - if params.InstalledPlugins != nil { - req["installedPlugins"] = params.InstalledPlugins - } - if params.IntegrationID != nil { - req["integrationId"] = *params.IntegrationID - } - if params.IsExperimentalMode != nil { - req["isExperimentalMode"] = *params.IsExperimentalMode - } - if params.LogInteractiveShells != nil { - req["logInteractiveShells"] = *params.LogInteractiveShells - } - if params.LspClientName != nil { - req["lspClientName"] = *params.LspClientName - } - if params.ManageScheduleEnabled != nil { - req["manageScheduleEnabled"] = *params.ManageScheduleEnabled - } - if params.MaxInlineBinaryBytes != nil { - req["maxInlineBinaryBytes"] = *params.MaxInlineBinaryBytes - } - if params.Model != nil { - req["model"] = *params.Model - } - if params.ModelCapabilitiesOverrides != nil { - req["modelCapabilitiesOverrides"] = *params.ModelCapabilitiesOverrides - } - if params.OrganizationCustomInstructions != nil { - req["organizationCustomInstructions"] = *params.OrganizationCustomInstructions - } - if params.Provider != nil { - req["provider"] = *params.Provider - } - if params.ReasoningEffort != nil { - req["reasoningEffort"] = *params.ReasoningEffort - } - if params.ReasoningSummary != nil { - req["reasoningSummary"] = *params.ReasoningSummary - } - if params.RunningInInteractiveMode != nil { - req["runningInInteractiveMode"] = *params.RunningInInteractiveMode - } - if params.SandboxConfig != nil { - req["sandboxConfig"] = *params.SandboxConfig - } - if params.SandboxConfigSource != nil { - req["sandboxConfigSource"] = *params.SandboxConfigSource - } - if params.SessionCapabilities != nil { - req["sessionCapabilities"] = params.SessionCapabilities - } - if params.SessionLimits != nil { - req["sessionLimits"] = *params.SessionLimits - } - if params.Shell != nil { - req["shell"] = *params.Shell - } - if params.ShellInitProfile != nil { - req["shellInitProfile"] = *params.ShellInitProfile - } - if params.ShellProcessFlags != nil { - req["shellProcessFlags"] = params.ShellProcessFlags - } - if params.SkillDirectories != nil { - req["skillDirectories"] = params.SkillDirectories - } - if params.SkipCustomInstructions != nil { - req["skipCustomInstructions"] = *params.SkipCustomInstructions - } - if params.SkipEmbeddingRetrieval != nil { - req["skipEmbeddingRetrieval"] = *params.SkipEmbeddingRetrieval - } - if params.SuppressCustomAgentPrompt != nil { - req["suppressCustomAgentPrompt"] = *params.SuppressCustomAgentPrompt - } - if params.ToolFilterPrecedence != nil { - req["toolFilterPrecedence"] = *params.ToolFilterPrecedence - } - if params.TrajectoryFile != nil { - req["trajectoryFile"] = *params.TrajectoryFile - } - if params.Verbosity != nil { - req["verbosity"] = *params.Verbosity - } - if params.WorkingDirectory != nil { - req["workingDirectory"] = *params.WorkingDirectory - } + +// List returns the session's allowed directories and primary working directory. +// +// RPC method: session.permissions.paths.list. +// +// Returns: Snapshot of the session's allow-listed directories and primary working directory. +func (a *PermissionsPathsAPI) List(ctx context.Context) (*PermissionPathsList, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.permissions.paths.list", req) + if err != nil { + return nil, err } - raw, err := a.client.Request(ctx, "session.options.update", req) + var result PermissionPathsList + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// UpdatePrimary updates the session's primary working directory used by the permission +// policy. +// +// RPC method: session.permissions.paths.updatePrimary. +// +// Parameters: Directory path to set as the session's new primary working directory. +// +// Returns: Indicates whether the operation succeeded. +func (a *PermissionsPathsAPI) UpdatePrimary(ctx context.Context, params *PermissionPathsUpdatePrimaryParams) (*PermissionsPathsUpdatePrimaryResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["path"] = params.Path + } + raw, err := a.client.Request(ctx, "session.permissions.paths.updatePrimary", req) if err != nil { return nil, err } - var result SessionUpdateOptionsResult + var result PermissionsPathsUpdatePrimaryResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: PermissionsAPI contains experimental APIs that may change or be removed. -type PermissionsAPI sessionAPI +// Experimental: Paths returns experimental APIs that may change or be removed. +func (s *PermissionsAPI) Paths() *PermissionsPathsAPI { + return (*PermissionsPathsAPI)(s) +} -// Configure replaces selected permission policy fields (rules, paths, URLs, exclusions, -// allow-all flags) on the session. +// Experimental: PermissionsURLsAPI contains experimental APIs that may change or be removed. +type PermissionsURLsAPI sessionAPI + +// SetUnrestrictedMode toggles the runtime's URL-permission policy between unrestricted and +// restricted modes. // -// RPC method: session.permissions.configure. +// RPC method: session.permissions.urls.setUnrestrictedMode. // -// Parameters: Patch of permission policy fields to apply (omit a field to leave it -// unchanged). +// Parameters: Whether the URL-permission policy should run in unrestricted mode. // // Returns: Indicates whether the operation succeeded. -func (a *PermissionsAPI) Configure(ctx context.Context, params *PermissionsConfigureParams) (*PermissionsConfigureResult, error) { +func (a *PermissionsURLsAPI) SetUnrestrictedMode(ctx context.Context, params *PermissionURLsSetUnrestrictedModeParams) (*PermissionsURLsSetUnrestrictedModeResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.AdditionalContentExclusionPolicies != nil { - req["additionalContentExclusionPolicies"] = params.AdditionalContentExclusionPolicies - } - if params.ApproveAllReadPermissionRequests != nil { - req["approveAllReadPermissionRequests"] = *params.ApproveAllReadPermissionRequests - } - if params.ApproveAllToolPermissionRequests != nil { - req["approveAllToolPermissionRequests"] = *params.ApproveAllToolPermissionRequests - } - if params.Paths != nil { - req["paths"] = *params.Paths - } - if params.Rules != nil { - req["rules"] = *params.Rules - } - if params.URLs != nil { - req["urls"] = *params.URLs - } + req["enabled"] = params.Enabled } - raw, err := a.client.Request(ctx, "session.permissions.configure", req) + raw, err := a.client.Request(ctx, "session.permissions.urls.setUnrestrictedMode", req) if err != nil { return nil, err } - var result PermissionsConfigureResult + var result PermissionsURLsSetUnrestrictedModeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetMode returns the current permission mode for the session. +// Experimental: URLs returns experimental APIs that may change or be removed. +func (s *PermissionsAPI) URLs() *PermissionsURLsAPI { + return (*PermissionsURLsAPI)(s) +} + +// Experimental: PlanAPI contains experimental APIs that may change or be removed. +type PlanAPI sessionAPI + +// Deletes the session plan file from the workspace. // -// RPC method: session.permissions.getMode. +// RPC method: session.plan.delete. +func (a *PlanAPI) Delete(ctx context.Context) (*SessionPlanDeleteResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.plan.delete", req) + if err != nil { + return nil, err + } + var result SessionPlanDeleteResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Reads the session plan file from the workspace. // -// Returns: Current permission mode. -func (a *PermissionsAPI) GetMode(ctx context.Context) (*PermissionsGetModeResult, error) { +// RPC method: session.plan.read. +// +// Returns: Existence, contents, and resolved path of the session plan file. +func (a *PlanAPI) Read(ctx context.Context) (*PlanReadResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.permissions.getMode", req) + raw, err := a.client.Request(ctx, "session.plan.read", req) if err != nil { return nil, err } - var result PermissionsGetModeResult + var result PlanReadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingPermissionRequest provides a decision for a pending tool permission request. +// ReadSqlTodos reads todo rows from the session SQL database for plan rendering. // -// RPC method: session.permissions.handlePendingPermissionRequest. +// RPC method: session.plan.readSqlTodos. // -// Parameters: Pending permission request ID and the decision to apply (approve/reject and -// scope). +// Returns: Todo rows read from the session SQL database. Empty when no session database is +// available. +func (a *PlanAPI) ReadSqlTodos(ctx context.Context) (*PlanReadSQLTodosResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.plan.readSqlTodos", req) + if err != nil { + return nil, err + } + var result PlanReadSQLTodosResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// ReadSqlTodosWithDependencies reads todo rows AND dependency edges from the session SQL +// database for structured progress UI. Same defensive behavior as readSqlTodos — returns +// empty arrays when the database, tables, or columns aren't available. Clients should call +// this on session start and after every `session.todos_changed` event to refresh +// structured-UI rendering. // -// Returns: Indicates whether the permission decision was applied; false when the request -// was already resolved. -func (a *PermissionsAPI) HandlePendingPermissionRequest(ctx context.Context, params *PermissionDecisionRequest) (*PermissionRequestResult, error) { +// RPC method: session.plan.readSqlTodosWithDependencies. +// +// Returns: Todo rows + dependency edges read from the session SQL database. +func (a *PlanAPI) ReadSqlTodosWithDependencies(ctx context.Context) (*PlanReadSQLTodosWithDependenciesResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.plan.readSqlTodosWithDependencies", req) + if err != nil { + return nil, err + } + var result PlanReadSQLTodosWithDependenciesResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Update writes new content to the session plan file. +// +// RPC method: session.plan.update. +// +// Parameters: Replacement contents to write to the session plan file. +func (a *PlanAPI) Update(ctx context.Context, params *PlanUpdateRequest) (*SessionPlanUpdateResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.DecisionContext != nil { - req["decisionContext"] = *params.DecisionContext - } - req["requestId"] = params.RequestID - req["result"] = params.Result + req["content"] = params.Content } - raw, err := a.client.Request(ctx, "session.permissions.handlePendingPermissionRequest", req) + raw, err := a.client.Request(ctx, "session.plan.update", req) if err != nil { return nil, err } - var result PermissionRequestResult + var result SessionPlanUpdateResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ModifyRules adds or removes session-scoped or location-scoped permission rules. +// Experimental: PluginsAPI contains experimental APIs that may change or be removed. +type PluginsAPI sessionAPI + +// Disables installed plugins when permitted by the live session's retained managed policy. // -// RPC method: session.permissions.modifyRules. +// RPC method: session.plugins.disable. // -// Parameters: Scope and add/remove instructions for modifying session- or location-scoped -// permission rules. +// Parameters: Plugin names (or specs) to disable in the session's authoritative working +// directory. +func (a *PluginsAPI) Disable(ctx context.Context, params *SessionPluginsDisableRequest) (*SessionPluginsDisableResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["names"] = params.Names + } + raw, err := a.client.Request(ctx, "session.plugins.disable", req) + if err != nil { + return nil, err + } + var result SessionPluginsDisableResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Enables installed plugins when permitted by the live session's retained managed policy. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsAPI) ModifyRules(ctx context.Context, params *PermissionsModifyRulesParams) (*PermissionsModifyRulesResult, error) { +// RPC method: session.plugins.enable. +// +// Parameters: Plugin names (or specs) to enable in the session's authoritative working +// directory. +func (a *PluginsAPI) Enable(ctx context.Context, params *SessionPluginsEnableRequest) (*SessionPluginsEnableResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Add != nil { - req["add"] = params.Add - } - if params.Remove != nil { - req["remove"] = params.Remove - } - if params.RemoveAll != nil { - req["removeAll"] = *params.RemoveAll - } - req["scope"] = params.Scope + req["names"] = params.Names } - raw, err := a.client.Request(ctx, "session.permissions.modifyRules", req) + raw, err := a.client.Request(ctx, "session.plugins.enable", req) if err != nil { return nil, err } - var result PermissionsModifyRulesResult + var result SessionPluginsEnableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// NotifyPromptShown notifies the runtime that a permission prompt UI has been shown to the -// user. +// Installs a plugin using the live session's authoritative account, working directory, and +// retained managed policy. // -// RPC method: session.permissions.notifyPromptShown. +// RPC method: session.plugins.install. // -// Parameters: Notification payload describing the permission prompt that the client just -// rendered. +// Parameters: Plugin source resolved relative to the session's authoritative working +// directory. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsAPI) NotifyPromptShown(ctx context.Context, params *PermissionPromptShownNotification) (*PermissionsNotifyPromptShownResult, error) { +// Returns: Result of installing a plugin. +func (a *PluginsAPI) Install(ctx context.Context, params *SessionPluginsInstallRequest) (*PluginInstallResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["message"] = params.Message + req["source"] = params.Source } - raw, err := a.client.Request(ctx, "session.permissions.notifyPromptShown", req) + raw, err := a.client.Request(ctx, "session.plugins.install", req) if err != nil { return nil, err } - var result PermissionsNotifyPromptShownResult + var result PluginInstallResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// PendingRequests reconstructs the set of pending tool permission requests from the -// session's event history. +// Lists globally installed, live, built-in, and enterprise-managed desired plugins using +// the live session's authoritative account, working directory, and retained managed policy. // -// RPC method: session.permissions.pendingRequests. +// RPC method: session.plugins.list. // -// Returns: List of pending permission requests reconstructed from event history. -func (a *PermissionsAPI) PendingRequests(ctx context.Context) (*PendingPermissionRequestList, error) { +// Returns: Plugins installed for the session, with their enabled state and version metadata. +func (a *PluginsAPI) List(ctx context.Context) (*PluginList, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.permissions.pendingRequests", req) + raw, err := a.client.Request(ctx, "session.plugins.list", req) if err != nil { return nil, err } - var result PendingPermissionRequestList + var result PluginList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ResetSessionApprovals clears session-scoped tool permission approvals. -// -// RPC method: session.permissions.resetSessionApprovals. +// 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. // -// Parameters: Clears session-scoped tool permission approvals, and optionally the -// location-scoped ones. +// RPC method: session.plugins.reload. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsAPI) ResetSessionApprovals(ctx context.Context, params *PermissionsResetSessionApprovalsRequest) (*PermissionsResetSessionApprovalsResult, error) { - req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.IncludeLocation != nil { - req["includeLocation"] = *params.IncludeLocation +// Parameters: Optional flags controlling which side effects the reload performs. +func (a *PluginsAPI) Reload(ctx context.Context, params ...*SessionPluginsReloadRequest) (*SessionPluginsReloadResult, error) { + var requestParams *SessionPluginsReloadRequest + if len(params) > 0 { + requestParams = params[0] + } + req := map[string]any{"sessionId": a.sessionID} + if requestParams != nil { + if requestParams.DeferRepoHooks != nil { + req["deferRepoHooks"] = *requestParams.DeferRepoHooks + } + if requestParams.ReloadCustomAgents != nil { + req["reloadCustomAgents"] = *requestParams.ReloadCustomAgents + } + if requestParams.ReloadExtensions != nil { + req["reloadExtensions"] = *requestParams.ReloadExtensions + } + if requestParams.ReloadHooks != nil { + req["reloadHooks"] = *requestParams.ReloadHooks + } + if requestParams.ReloadMCP != nil { + req["reloadMcp"] = *requestParams.ReloadMCP } } - raw, err := a.client.Request(ctx, "session.permissions.resetSessionApprovals", req) + raw, err := a.client.Request(ctx, "session.plugins.reload", req) if err != nil { return nil, err } - var result PermissionsResetSessionApprovalsResult + var result SessionPluginsReloadResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetApproveAll enables or disables automatic approval of tool permission requests for the -// session. -// -// RPC method: session.permissions.setApproveAll. +// Uninstalls a plugin when permitted by the live session's retained managed policy. // -// Parameters: Allow-all toggle for tool permission requests, with an optional telemetry -// source. +// RPC method: session.plugins.uninstall. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsAPI) SetApproveAll(ctx context.Context, params *PermissionsSetApproveAllRequest) (*PermissionsSetApproveAllResult, error) { +// Parameters: Name (or spec) of the plugin to uninstall. +func (a *PluginsAPI) Uninstall(ctx context.Context, params *PluginsUninstallRequest) (*SessionPluginsUninstallResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["enabled"] = params.Enabled - if params.Source != nil { - req["source"] = *params.Source + if params.DirectSourceID != nil { + req["directSourceId"] = *params.DirectSourceID } + req["name"] = params.Name } - raw, err := a.client.Request(ctx, "session.permissions.setApproveAll", req) + raw, err := a.client.Request(ctx, "session.plugins.uninstall", req) if err != nil { return nil, err } - var result PermissionsSetApproveAllResult + var result SessionPluginsUninstallResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetMode sets the permission mode for the session. `manual` follows the normal approval -// flow, `assisted` attaches LLM safety recommendations, and `allow-all` automatically -// approves permission requests. The result returns the authoritative post-mutation mode so -// callers can update local state without racing the `session.permissions_changed` -// notification. +// Updates an installed plugin using the live session's authoritative account, working +// directory, and retained managed policy. // -// RPC method: session.permissions.setMode. +// RPC method: session.plugins.update. // -// Parameters: Permission mode to apply for the session. +// Parameters: Name (or spec) of the plugin to update. // -// Returns: Indicates whether the requested permission mode was applied and reports the -// authoritative post-mutation mode. -func (a *PermissionsAPI) SetMode(ctx context.Context, params *PermissionsSetModeRequest) (*PermissionsSetModeResult, error) { +// Returns: Result of updating a single plugin. +func (a *PluginsAPI) Update(ctx context.Context, params *PluginsUpdateRequest) (*PluginUpdateResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.AssistedApprovalModel != nil { - req["assistedApprovalModel"] = *params.AssistedApprovalModel - } - req["mode"] = params.Mode - if params.Source != nil { - req["source"] = *params.Source - } + req["name"] = params.Name } - raw, err := a.client.Request(ctx, "session.permissions.setMode", req) + raw, err := a.client.Request(ctx, "session.plugins.update", req) if err != nil { return nil, err } - var result PermissionsSetModeResult + var result PluginUpdateResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetRequired sets whether the client wants permission prompts bridged into session events. +// Experimental: PluginsMarketplacesAPI contains experimental APIs that may change or be +// removed. +type PluginsMarketplacesAPI sessionAPI + +// Adds a marketplace when permitted by the live session's retained managed policy. // -// RPC method: session.permissions.setRequired. +// RPC method: session.plugins.marketplaces.add. // -// Parameters: Toggles whether permission prompts should be bridged into session events for -// this client. +// Parameters: Marketplace source and optional working directory for relative-path +// resolution. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsAPI) SetRequired(ctx context.Context, params *PermissionsSetRequiredRequest) (*PermissionsSetRequiredResult, error) { +// Returns: Result of registering a new marketplace. +func (a *PluginsMarketplacesAPI) Add(ctx context.Context, params *PluginsMarketplacesAddRequest) (*MarketplaceAddResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["required"] = params.Required + req["source"] = params.Source + if params.WorkingDirectory != nil { + req["workingDirectory"] = *params.WorkingDirectory + } } - raw, err := a.client.Request(ctx, "session.permissions.setRequired", req) + raw, err := a.client.Request(ctx, "session.plugins.marketplaces.add", req) if err != nil { return nil, err } - var result PermissionsSetRequiredResult + var result MarketplaceAddResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: PermissionsFolderTrustAPI contains experimental APIs that may change or be -// removed. -type PermissionsFolderTrustAPI sessionAPI - -// AddTrusted adds a folder to the user's trusted folders list. +// Browses a marketplace resolved through the live session's working directory and retained +// managed policy. // -// RPC method: session.permissions.folderTrust.addTrusted. +// RPC method: session.plugins.marketplaces.browse. // -// Parameters: Folder path to add to trusted folders. +// Parameters: Name of the marketplace whose plugin catalog to fetch. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsFolderTrustAPI) AddTrusted(ctx context.Context, params *FolderTrustAddParams) (*PermissionsFolderTrustAddTrustedResult, error) { +// Returns: Plugins advertised by the marketplace. +func (a *PluginsMarketplacesAPI) Browse(ctx context.Context, params *PluginsMarketplacesBrowseRequest) (*MarketplaceBrowseResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["path"] = params.Path + req["name"] = params.Name } - raw, err := a.client.Request(ctx, "session.permissions.folderTrust.addTrusted", req) + raw, err := a.client.Request(ctx, "session.plugins.marketplaces.browse", req) if err != nil { return nil, err } - var result PermissionsFolderTrustAddTrustedResult + var result MarketplaceBrowseResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// IsTrusted reports whether a folder is trusted according to the user's folder trust state. -// -// RPC method: session.permissions.folderTrust.isTrusted. +// Lists registered and enterprise-managed desired marketplaces using the live session's +// retained policy. // -// Parameters: Folder path to check for trust. +// RPC method: session.plugins.marketplaces.list. // -// Returns: Folder trust check result. -func (a *PermissionsFolderTrustAPI) IsTrusted(ctx context.Context, params *FolderTrustCheckParams) (*FolderTrustCheckResult, error) { +// Returns: All registered marketplaces, including built-in defaults. +func (a *PluginsMarketplacesAPI) List(ctx context.Context) (*MarketplaceListResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["path"] = params.Path - } - raw, err := a.client.Request(ctx, "session.permissions.folderTrust.isTrusted", req) + raw, err := a.client.Request(ctx, "session.plugins.marketplaces.list", req) if err != nil { return nil, err } - var result FolderTrustCheckResult + var result MarketplaceListResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: FolderTrust returns experimental APIs that may change or be removed. -func (s *PermissionsAPI) FolderTrust() *PermissionsFolderTrustAPI { - return (*PermissionsFolderTrustAPI)(s) -} - -// Experimental: PermissionsLocationsAPI contains experimental APIs that may change or be -// removed. -type PermissionsLocationsAPI sessionAPI - -// AddToolApproval persists a tool approval for a permission location and applies its rules -// to this session's live permission service. +// Refreshes marketplaces resolved through the live session's working directory and retained +// managed policy. // -// RPC method: session.permissions.locations.addToolApproval. +// RPC method: session.plugins.marketplaces.refresh. // -// Parameters: Location-scoped tool approval to persist. +// Parameters: Optional marketplace name; omit to refresh all. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsLocationsAPI) AddToolApproval(ctx context.Context, params *PermissionLocationAddToolApprovalParams) (*PermissionsLocationsAddToolApprovalResult, error) { +// Returns: Result of refreshing one or more marketplace catalogs. +func (a *PluginsMarketplacesAPI) Refresh(ctx context.Context, params ...*SessionPluginsMarketplacesRefreshRequest) (*MarketplaceRefreshResult, error) { + var requestParams *SessionPluginsMarketplacesRefreshRequest + if len(params) > 0 { + requestParams = params[0] + } req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["approval"] = params.Approval - req["locationKey"] = params.LocationKey + if requestParams != nil { + if requestParams.Name != nil { + req["name"] = *requestParams.Name + } } - raw, err := a.client.Request(ctx, "session.permissions.locations.addToolApproval", req) + raw, err := a.client.Request(ctx, "session.plugins.marketplaces.refresh", req) if err != nil { return nil, err } - var result PermissionsLocationsAddToolApprovalResult + var result MarketplaceRefreshResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Apply applies persisted location-scoped tool approvals and allowed directories for a -// working directory to this session's permission service. +// Removes a marketplace when permitted by the live session's retained managed policy. // -// RPC method: session.permissions.locations.apply. +// RPC method: session.plugins.marketplaces.remove. // -// Parameters: Working directory to load persisted location permissions for. +// Parameters: Name of the marketplace to remove and an optional force flag. // -// Returns: Summary of persisted location permissions applied to the session. -func (a *PermissionsLocationsAPI) Apply(ctx context.Context, params *PermissionLocationApplyParams) (*PermissionLocationApplyResult, error) { +// Returns: Outcome of the remove attempt, including dependent-plugin info when applicable. +func (a *PluginsMarketplacesAPI) Remove(ctx context.Context, params *PluginsMarketplacesRemoveRequest) (*MarketplaceRemoveResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["workingDirectory"] = params.WorkingDirectory + if params.Force != nil { + req["force"] = *params.Force + } + req["name"] = params.Name } - raw, err := a.client.Request(ctx, "session.permissions.locations.apply", req) + raw, err := a.client.Request(ctx, "session.plugins.marketplaces.remove", req) if err != nil { return nil, err } - var result PermissionLocationApplyResult + var result MarketplaceRemoveResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Resolves the permission location key and type for a working directory. +// Experimental: Marketplaces returns experimental APIs that may change or be removed. +func (s *PluginsAPI) Marketplaces() *PluginsMarketplacesAPI { + return (*PluginsMarketplacesAPI)(s) +} + +// Experimental: ProviderAPI contains experimental APIs that may change or be removed. +type ProviderAPI sessionAPI + +// Adds BYOK providers and/or models to the session's registry at runtime, extending the +// additive registry built from the session's `providers`/`models` options. Both fields are +// optional, so a call may add providers only, models only, or both. Within a single call +// providers are registered before models, so a model may reference a provider added in the +// same call; across calls a model may reference any provider already registered (from +// session creation or a prior add). A model whose referenced provider is not registered by +// the end of the call is rejected. Newly added models become selectable via `model.list` / +// `model.switchTo` and are inherited by sub-agents spawned afterwards. // -// RPC method: session.permissions.locations.resolve. +// RPC method: session.provider.add. // -// Parameters: Working directory to resolve into a location-permissions key. +// Parameters: BYOK providers and/or models to add to the session's registry at runtime. +// Both fields are optional; provide providers, models, or both. // -// Returns: Resolved location-permissions key and type. -func (a *PermissionsLocationsAPI) Resolve(ctx context.Context, params *PermissionLocationResolveParams) (*PermissionLocationResolveResult, error) { +// Returns: The selectable model entries synthesized for the models added by this call. +func (a *ProviderAPI) Add(ctx context.Context, params *ProviderAddRequest) (*ProviderAddResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["workingDirectory"] = params.WorkingDirectory + if params.Models != nil { + req["models"] = params.Models + } + if params.Providers != nil { + req["providers"] = params.Providers + } } - raw, err := a.client.Request(ctx, "session.permissions.locations.resolve", req) + raw, err := a.client.Request(ctx, "session.provider.add", req) if err != nil { return nil, err } - var result PermissionLocationResolveResult + var result ProviderAddResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Locations returns experimental APIs that may change or be removed. -func (s *PermissionsAPI) Locations() *PermissionsLocationsAPI { - return (*PermissionsLocationsAPI)(s) -} - -// Experimental: PermissionsPathsAPI contains experimental APIs that may change or be -// removed. -type PermissionsPathsAPI sessionAPI - -// Adds a directory to the session's allow-list and activates conventional skill and agent -// definitions under it. +// GetEndpoint returns the provider endpoint and credentials the session is currently +// configured to talk to, so the caller can make inference calls directly against the same +// backend the session uses. // -// RPC method: session.permissions.paths.add. +// RPC method: session.provider.getEndpoint. // -// Parameters: Directory path to add to the session's allowed directories. +// Parameters: Optional model identifier to scope the endpoint snapshot to. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsPathsAPI) Add(ctx context.Context, params *PermissionPathsAddParams) (*PermissionsPathsAddResult, error) { +// Returns: A snapshot of the provider endpoint the session is currently configured to talk +// to. +func (a *ProviderAPI) GetEndpoint(ctx context.Context, params ...*SessionProviderGetEndpointRequest) (*ProviderEndpoint, error) { + var requestParams *SessionProviderGetEndpointRequest + if len(params) > 0 { + requestParams = params[0] + } req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["path"] = params.Path + if requestParams != nil { + if requestParams.ModelID != nil { + req["modelId"] = *requestParams.ModelID + } } - raw, err := a.client.Request(ctx, "session.permissions.paths.add", req) + raw, err := a.client.Request(ctx, "session.provider.getEndpoint", req) if err != nil { return nil, err } - var result PermissionsPathsAddResult + var result ProviderEndpoint if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// IsPathWithinAllowedDirectories reports whether a path falls within any of the session's -// allowed directories. +// Experimental: QueueAPI contains experimental APIs that may change or be removed. +type QueueAPI sessionAPI + +// AppendSteering atomically appends text and attachments to an unchanged, unconsumed local +// steering message. Returns updated=false if delivery or withdrawal already claimed the +// message. // -// RPC method: session.permissions.paths.isPathWithinAllowedDirectories. +// RPC method: session.queue.appendSteering. // -// Parameters: Path to evaluate against the session's allowed directories. +// Parameters: Append to one pending steering message without changing its identity or +// delivery position. // -// Returns: Indicates whether the supplied path is within the session's allowed directories. -func (a *PermissionsPathsAPI) IsPathWithinAllowedDirectories(ctx context.Context, params *PermissionPathsAllowedCheckParams) (*PermissionPathsAllowedCheckResult, error) { +// Returns: Result of editing a queued message. +func (a *QueueAPI) AppendSteering(ctx context.Context, params *QueueAppendSteeringRequest) (*QueueUpdateTextResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["path"] = params.Path + req["agentMode"] = params.AgentMode + req["attachments"] = params.Attachments + req["displayPrompt"] = params.DisplayPrompt + req["expectedPrompt"] = params.ExpectedPrompt + req["messageId"] = params.MessageID + req["prompt"] = params.Prompt } - raw, err := a.client.Request(ctx, "session.permissions.paths.isPathWithinAllowedDirectories", req) + raw, err := a.client.Request(ctx, "session.queue.appendSteering", req) if err != nil { return nil, err } - var result PermissionPathsAllowedCheckResult + var result QueueUpdateTextResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// IsPathWithinWorkspace reports whether a path falls within the session's workspace -// (primary) directory. -// -// RPC method: session.permissions.paths.isPathWithinWorkspace. -// -// Parameters: Path to evaluate against the session's workspace (primary) directory. +// Clears all pending queued items on the local session. // -// Returns: Indicates whether the supplied path is within the session's workspace directory. -func (a *PermissionsPathsAPI) IsPathWithinWorkspace(ctx context.Context, params *PermissionPathsWorkspaceCheckParams) (*PermissionPathsWorkspaceCheckResult, error) { - req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["path"] = params.Path - } - raw, err := a.client.Request(ctx, "session.permissions.paths.isPathWithinWorkspace", req) +// RPC method: session.queue.clear. +func (a *QueueAPI) Clear(ctx context.Context) (*SessionQueueClearResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.queue.clear", req) if err != nil { return nil, err } - var result PermissionPathsWorkspaceCheckResult + var result SessionQueueClearResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// List returns the session's allowed directories and primary working directory. +// DuplicateAt duplicates an addressable queued item immediately after its source. // -// RPC method: session.permissions.paths.list. +// RPC method: session.queue.duplicateAt. // -// Returns: Snapshot of the session's allow-listed directories and primary working directory. -func (a *PermissionsPathsAPI) List(ctx context.Context) (*PermissionPathsList, error) { +// Parameters: Parameters for duplicating a queued item. +// +// Returns: Result of duplicating a queued item. +func (a *QueueAPI) DuplicateAt(ctx context.Context, params *QueueDuplicateAtRequest) (*QueueDuplicateAtResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.permissions.paths.list", req) + if params != nil { + req["id"] = params.ID + } + raw, err := a.client.Request(ctx, "session.queue.duplicateAt", req) if err != nil { return nil, err } - var result PermissionPathsList + var result QueueDuplicateAtResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// UpdatePrimary updates the session's primary working directory used by the permission -// policy. +// InsertAt inserts a new queued message at a public visible position. // -// RPC method: session.permissions.paths.updatePrimary. +// RPC method: session.queue.insertAt. // -// Parameters: Directory path to set as the session's new primary working directory. +// Parameters: Parameters for inserting a queued message at a public visible position. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsPathsAPI) UpdatePrimary(ctx context.Context, params *PermissionPathsUpdatePrimaryParams) (*PermissionsPathsUpdatePrimaryResult, error) { +// Returns: Result of inserting a queued message. +func (a *QueueAPI) InsertAt(ctx context.Context, params *QueueInsertAtRequest) (*QueueInsertAtResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["path"] = params.Path + req["message"] = params.Message + req["position"] = params.Position } - raw, err := a.client.Request(ctx, "session.permissions.paths.updatePrimary", req) + raw, err := a.client.Request(ctx, "session.queue.insertAt", req) if err != nil { return nil, err } - var result PermissionsPathsUpdatePrimaryResult + var result QueueInsertAtResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: Paths returns experimental APIs that may change or be removed. -func (s *PermissionsAPI) Paths() *PermissionsPathsAPI { - return (*PermissionsPathsAPI)(s) -} - -// Experimental: PermissionsURLsAPI contains experimental APIs that may change or be removed. -type PermissionsURLsAPI sessionAPI - -// SetUnrestrictedMode toggles the runtime's URL-permission policy between unrestricted and -// restricted modes. +// MoveItem moves an addressable queued item to a public visible position. // -// RPC method: session.permissions.urls.setUnrestrictedMode. +// RPC method: session.queue.moveItem. // -// Parameters: Whether the URL-permission policy should run in unrestricted mode. +// Parameters: Parameters for moving a queued item by stable id. // -// Returns: Indicates whether the operation succeeded. -func (a *PermissionsURLsAPI) SetUnrestrictedMode(ctx context.Context, params *PermissionURLsSetUnrestrictedModeParams) (*PermissionsURLsSetUnrestrictedModeResult, error) { +// Returns: Result of moving a queued item. +func (a *QueueAPI) MoveItem(ctx context.Context, params *QueueMoveItemRequest) (*QueueMoveItemResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["enabled"] = params.Enabled + req["id"] = params.ID + req["toPosition"] = params.ToPosition } - raw, err := a.client.Request(ctx, "session.permissions.urls.setUnrestrictedMode", req) + raw, err := a.client.Request(ctx, "session.queue.moveItem", req) if err != nil { return nil, err } - var result PermissionsURLsSetUnrestrictedModeResult + var result QueueMoveItemResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: URLs returns experimental APIs that may change or be removed. -func (s *PermissionsAPI) URLs() *PermissionsURLsAPI { - return (*PermissionsURLsAPI)(s) -} - -// Experimental: PlanAPI contains experimental APIs that may change or be removed. -type PlanAPI sessionAPI - -// Deletes the session plan file from the workspace. +// PendingItems returns the local session's pending user-facing queued items and steering +// messages. // -// RPC method: session.plan.delete. -func (a *PlanAPI) Delete(ctx context.Context) (*SessionPlanDeleteResult, error) { +// RPC method: session.queue.pendingItems. +// +// Returns: Snapshot of the session's pending queued items and immediate-steering messages. +func (a *QueueAPI) PendingItems(ctx context.Context) (*QueuePendingItemsResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.plan.delete", req) + raw, err := a.client.Request(ctx, "session.queue.pendingItems", req) if err != nil { return nil, err } - var result SessionPlanDeleteResult + var result QueuePendingItemsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Reads the session plan file from the workspace. +// RemoveAt removes an addressable queued item by its stable id. // -// RPC method: session.plan.read. +// RPC method: session.queue.removeAt. // -// Returns: Existence, contents, and resolved path of the session plan file. -func (a *PlanAPI) Read(ctx context.Context) (*PlanReadResult, error) { +// Parameters: Parameters for removing a queued item by stable id. +// +// Returns: Result of removing a queued item. +func (a *QueueAPI) RemoveAt(ctx context.Context, params *QueueRemoveAtRequest) (*QueueRemoveAtResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.plan.read", req) + if params != nil { + req["id"] = params.ID + } + raw, err := a.client.Request(ctx, "session.queue.removeAt", req) if err != nil { return nil, err } - var result PlanReadResult + var result QueueRemoveAtResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ReadSqlTodos reads todo rows from the session SQL database for plan rendering. +// RemoveMostRecent removes the most recently queued user-facing item (LIFO). // -// RPC method: session.plan.readSqlTodos. +// RPC method: session.queue.removeMostRecent. // -// Returns: Todo rows read from the session SQL database. Empty when no session database is -// available. -func (a *PlanAPI) ReadSqlTodos(ctx context.Context) (*PlanReadSQLTodosResult, error) { +// Returns: Indicates whether a user-facing pending item was removed. +func (a *QueueAPI) RemoveMostRecent(ctx context.Context) (*QueueRemoveMostRecentResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.plan.readSqlTodos", req) + raw, err := a.client.Request(ctx, "session.queue.removeMostRecent", req) if err != nil { return nil, err } - var result PlanReadSQLTodosResult + var result QueueRemoveMostRecentResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ReadSqlTodosWithDependencies reads todo rows AND dependency edges from the session SQL -// database for structured progress UI. Same defensive behavior as readSqlTodos — returns -// empty arrays when the database, tables, or columns aren't available. Clients should call -// this on session start and after every `session.todos_changed` event to refresh -// structured-UI rendering. +// SendNow moves an addressable queued message into the live turn's steering lane. // -// RPC method: session.plan.readSqlTodosWithDependencies. +// RPC method: session.queue.sendNow. // -// Returns: Todo rows + dependency edges read from the session SQL database. -func (a *PlanAPI) ReadSqlTodosWithDependencies(ctx context.Context) (*PlanReadSQLTodosWithDependenciesResult, error) { +// Parameters: Parameters for steering a queued message into a live turn. +// +// Returns: Result of trying to steer a queued message into a live turn. +func (a *QueueAPI) SendNow(ctx context.Context, params *QueueSendNowRequest) (*QueueSendNowResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.plan.readSqlTodosWithDependencies", req) + if params != nil { + req["id"] = params.ID + } + raw, err := a.client.Request(ctx, "session.queue.sendNow", req) if err != nil { return nil, err } - var result PlanReadSQLTodosWithDependenciesResult + var result QueueSendNowResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Update writes new content to the session plan file. +// SetDrainPaused acquires or releases the queued-lane drain pause. // -// RPC method: session.plan.update. +// RPC method: session.queue.setDrainPaused. // -// Parameters: Replacement contents to write to the session plan file. -func (a *PlanAPI) Update(ctx context.Context, params *PlanUpdateRequest) (*SessionPlanUpdateResult, error) { +// Parameters: Parameters for acquiring or releasing the queued-lane drain pause. +// Acquisition is exclusive and non-idempotent: `paused: true` against an already-paused +// session fails with `queue_already_paused`. The pause is never released automatically — it +// is not tied to the caller's lifetime, so a client that exits without sending `paused: +// false` leaves the lane frozen. Release is unowned: `paused: false` clears the pause for +// any caller, including one that never acquired it. +func (a *QueueAPI) SetDrainPaused(ctx context.Context, params *QueueSetDrainPausedRequest) (*SessionQueueSetDrainPausedResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["content"] = params.Content + req["paused"] = params.Paused } - raw, err := a.client.Request(ctx, "session.plan.update", req) + raw, err := a.client.Request(ctx, "session.queue.setDrainPaused", req) if err != nil { return nil, err } - var result SessionPlanUpdateResult + var result SessionQueueSetDrainPausedResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: PluginsAPI contains experimental APIs that may change or be removed. -type PluginsAPI sessionAPI - -// Lists plugins installed for the session. +// UpdateText updates the text of an addressable single-message queue item. // -// RPC method: session.plugins.list. +// RPC method: session.queue.updateText. // -// Returns: Plugins installed for the session, with their enabled state and version metadata. -func (a *PluginsAPI) List(ctx context.Context) (*PluginList, error) { +// Parameters: Parameters for editing a single queued message. +// +// Returns: Result of editing a queued message. +func (a *QueueAPI) UpdateText(ctx context.Context, params *QueueUpdateTextRequest) (*QueueUpdateTextResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.plugins.list", req) + if params != nil { + if params.DisplayPrompt != nil { + req["displayPrompt"] = *params.DisplayPrompt + } + req["id"] = params.ID + req["prompt"] = params.Prompt + } + raw, err := a.client.Request(ctx, "session.queue.updateText", req) if err != nil { return nil, err } - var result PluginList + var result QueueUpdateTextResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// 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. +// WithdrawMessage atomically withdraws an unchanged, unconsumed user message from the local +// queued or steering lane. A client retaining the original draft may restore it only when +// removed is true. Does not interrupt the running turn. // -// RPC method: session.plugins.reload. +// RPC method: session.queue.withdrawMessage. // -// Parameters: Optional flags controlling which side effects the reload performs. -func (a *PluginsAPI) Reload(ctx context.Context, params ...*SessionPluginsReloadRequest) (*SessionPluginsReloadResult, error) { - var requestParams *SessionPluginsReloadRequest - if len(params) > 0 { - requestParams = params[0] - } +// Parameters: Conditional withdrawal of a single user message, before the runtime claims it +// for delivery. +// +// Returns: Result of removing a queued item. +func (a *QueueAPI) WithdrawMessage(ctx context.Context, params *QueueWithdrawMessageRequest) (*QueueRemoveAtResult, error) { req := map[string]any{"sessionId": a.sessionID} - if requestParams != nil { - if requestParams.DeferRepoHooks != nil { - req["deferRepoHooks"] = *requestParams.DeferRepoHooks - } - if requestParams.ReloadCustomAgents != nil { - req["reloadCustomAgents"] = *requestParams.ReloadCustomAgents - } - if requestParams.ReloadExtensions != nil { - req["reloadExtensions"] = *requestParams.ReloadExtensions - } - if requestParams.ReloadHooks != nil { - req["reloadHooks"] = *requestParams.ReloadHooks - } - if requestParams.ReloadMCP != nil { - req["reloadMcp"] = *requestParams.ReloadMCP - } + if params != nil { + req["expectedPrompt"] = params.ExpectedPrompt + req["messageId"] = params.MessageID } - raw, err := a.client.Request(ctx, "session.plugins.reload", req) + raw, err := a.client.Request(ctx, "session.queue.withdrawMessage", req) if err != nil { return nil, err } - var result SessionPluginsReloadResult + var result QueueRemoveAtResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ProviderAPI contains experimental APIs that may change or be removed. -type ProviderAPI sessionAPI +// Experimental: RemoteAPI contains experimental APIs that may change or be removed. +type RemoteAPI sessionAPI -// Adds BYOK providers and/or models to the session's registry at runtime, extending the -// additive registry built from the session's `providers`/`models` options. Both fields are -// optional, so a call may add providers only, models only, or both. Within a single call -// providers are registered before models, so a model may reference a provider added in the -// same call; across calls a model may reference any provider already registered (from -// session creation or a prior add). A model whose referenced provider is not registered by -// the end of the call is rejected. Newly added models become selectable via `model.list` / -// `model.switchTo` and are inherited by sub-agents spawned afterwards. +// Disables remote session export and steering. // -// RPC method: session.provider.add. +// RPC method: session.remote.disable. +func (a *RemoteAPI) Disable(ctx context.Context) (*SessionRemoteDisableResult, error) { + req := map[string]any{"sessionId": a.sessionID} + raw, err := a.client.Request(ctx, "session.remote.disable", req) + if err != nil { + return nil, err + } + var result SessionRemoteDisableResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// Enables remote session export or steering. // -// Parameters: BYOK providers and/or models to add to the session's registry at runtime. -// Both fields are optional; provide providers, models, or both. +// RPC method: session.remote.enable. // -// Returns: The selectable model entries synthesized for the models added by this call. -func (a *ProviderAPI) Add(ctx context.Context, params *ProviderAddRequest) (*ProviderAddResult, error) { +// Parameters: Optional remote session mode ("off", "export", or "on"); defaults to enabling +// both export and remote steering. +// +// Returns: GitHub URL for the session and a flag indicating whether remote steering is +// enabled. +func (a *RemoteAPI) Enable(ctx context.Context, params *RemoteEnableRequest) (*RemoteEnableResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Models != nil { - req["models"] = params.Models - } - if params.Providers != nil { - req["providers"] = params.Providers + if params.Mode != nil { + req["mode"] = *params.Mode } } - raw, err := a.client.Request(ctx, "session.provider.add", req) + raw, err := a.client.Request(ctx, "session.remote.enable", req) if err != nil { return nil, err } - var result ProviderAddResult + var result RemoteEnableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetEndpoint returns the provider endpoint and credentials the session is currently -// configured to talk to, so the caller can make inference calls directly against the same -// backend the session uses. +// NotifySteerableChanged persists a remote-steerability change emitted by the host as a +// session event. // -// RPC method: session.provider.getEndpoint. +// RPC method: session.remote.notifySteerableChanged. // -// Parameters: Optional model identifier to scope the endpoint snapshot to. +// Parameters: New remote-steerability state to persist as a +// `session.remote_steerable_changed` event. // -// Returns: A snapshot of the provider endpoint the session is currently configured to talk -// to. -func (a *ProviderAPI) GetEndpoint(ctx context.Context, params ...*SessionProviderGetEndpointRequest) (*ProviderEndpoint, error) { - var requestParams *SessionProviderGetEndpointRequest - if len(params) > 0 { - requestParams = params[0] - } +// Returns: Persist a steerability change as a `session.remote_steerable_changed` event. +// Used by the host (CLI / SDK consumer) when it has just finished enabling or disabling +// steering on a remote exporter that the runtime does not directly own. +func (a *RemoteAPI) NotifySteerableChanged(ctx context.Context, params *RemoteNotifySteerableChangedRequest) (*RemoteNotifySteerableChangedResult, error) { req := map[string]any{"sessionId": a.sessionID} - if requestParams != nil { - if requestParams.ModelID != nil { - req["modelId"] = *requestParams.ModelID - } + if params != nil { + req["remoteSteerable"] = params.RemoteSteerable } - raw, err := a.client.Request(ctx, "session.provider.getEndpoint", req) + raw, err := a.client.Request(ctx, "session.remote.notifySteerableChanged", req) if err != nil { return nil, err } - var result ProviderEndpoint + var result RemoteNotifySteerableChangedResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: QueueAPI contains experimental APIs that may change or be removed. -type QueueAPI sessionAPI +// Experimental: SandboxAPI contains experimental APIs that may change or be removed. +type SandboxAPI sessionAPI -// Clears all pending queued items on the local session. +// DisableForSession disables sandboxing for the remainder of the current session and +// approves the referenced pending sandbox-bypass permission request. The request is +// rejected unless the exact request is still pending and the effective sandbox policy +// permits bypass. // -// RPC method: session.queue.clear. -func (a *QueueAPI) Clear(ctx context.Context) (*SessionQueueClearResult, error) { +// RPC method: session.sandbox.disableForSession. +// +// Parameters: Request to disable sandboxing for the current session while resolving an +// active sandbox-bypass permission prompt. +// +// Returns: Result of attempting to disable sandboxing for the current session. +func (a *SandboxAPI) DisableForSession(ctx context.Context, params *SandboxDisableForSessionRequest) (*SandboxDisableForSessionResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.queue.clear", req) + if params != nil { + if params.DecisionContext != nil { + req["decisionContext"] = *params.DecisionContext + } + req["requestId"] = params.RequestID + } + raw, err := a.client.Request(ctx, "session.sandbox.disableForSession", req) if err != nil { return nil, err } - var result SessionQueueClearResult + var result SandboxDisableForSessionResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// DuplicateAt duplicates an addressable queued item immediately after its source. -// -// RPC method: session.queue.duplicateAt. +// GetEnforcementStatus returns whether managed policy requires sandbox enforcement and +// whether an enforcement failure has permanently blocked the session. // -// Parameters: Parameters for duplicating a queued item. +// RPC method: session.sandbox.getEnforcementStatus. // -// Returns: Result of duplicating a queued item. -func (a *QueueAPI) DuplicateAt(ctx context.Context, params *QueueDuplicateAtRequest) (*QueueDuplicateAtResult, error) { +// Returns: Managed sandbox enforcement state for a session. +func (a *SandboxAPI) GetEnforcementStatus(ctx context.Context) (*SandboxEnforcementStatus, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["id"] = params.ID - } - raw, err := a.client.Request(ctx, "session.queue.duplicateAt", req) + raw, err := a.client.Request(ctx, "session.sandbox.getEnforcementStatus", req) if err != nil { return nil, err } - var result QueueDuplicateAtResult + var result SandboxEnforcementStatus if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// InsertAt inserts a new queued message at a public visible position. -// -// RPC method: session.queue.insertAt. +// Experimental: ScheduleAPI contains experimental APIs that may change or be removed. +type ScheduleAPI sessionAPI + +// Lists the session's currently active scheduled prompts. // -// Parameters: Parameters for inserting a queued message at a public visible position. +// RPC method: session.schedule.list. // -// Returns: Result of inserting a queued message. -func (a *QueueAPI) InsertAt(ctx context.Context, params *QueueInsertAtRequest) (*QueueInsertAtResult, error) { +// Returns: Snapshot of the currently active recurring prompts for this session. +func (a *ScheduleAPI) List(ctx context.Context) (*ScheduleList, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["message"] = params.Message - req["position"] = params.Position - } - raw, err := a.client.Request(ctx, "session.queue.insertAt", req) + raw, err := a.client.Request(ctx, "session.schedule.list", req) if err != nil { return nil, err } - var result QueueInsertAtResult + var result ScheduleList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// MoveItem moves an addressable queued item to a public visible position. +// Stop removes a scheduled prompt by id. // -// RPC method: session.queue.moveItem. +// RPC method: session.schedule.stop. // -// Parameters: Parameters for moving a queued item by stable id. +// Parameters: Identifier of the scheduled prompt to remove. // -// Returns: Result of moving a queued item. -func (a *QueueAPI) MoveItem(ctx context.Context, params *QueueMoveItemRequest) (*QueueMoveItemResult, error) { +// Returns: Remove a scheduled prompt by id. The result entry is omitted if the id was +// unknown. +func (a *ScheduleAPI) Stop(ctx context.Context, params *ScheduleStopRequest) (*ScheduleStopResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { req["id"] = params.ID - req["toPosition"] = params.ToPosition } - raw, err := a.client.Request(ctx, "session.queue.moveItem", req) + raw, err := a.client.Request(ctx, "session.schedule.stop", req) if err != nil { return nil, err } - var result QueueMoveItemResult + var result ScheduleStopResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// PendingItems returns the local session's pending user-facing queued items and steering -// messages. +// Experimental: ShellAPI contains experimental APIs that may change or be removed. +type ShellAPI sessionAPI + +// CancelUserRequested cancels a user-requested shell command by request ID. // -// RPC method: session.queue.pendingItems. +// RPC method: session.shell.cancelUserRequested. // -// Returns: Snapshot of the session's pending queued items and immediate-steering messages. -func (a *QueueAPI) PendingItems(ctx context.Context) (*QueuePendingItemsResult, error) { +// Parameters: User-requested shell execution cancellation handle. +// +// Returns: Cancellation result for a user-requested shell command. +func (a *ShellAPI) CancelUserRequested(ctx context.Context, params *ShellCancelUserRequestedRequest) (*CancelUserRequestedShellCommandResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.queue.pendingItems", req) + if params != nil { + req["requestId"] = params.RequestID + } + raw, err := a.client.Request(ctx, "session.shell.cancelUserRequested", req) if err != nil { return nil, err } - var result QueuePendingItemsResult + var result CancelUserRequestedShellCommandResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RemoveAt removes an addressable queued item by its stable id. +// Exec starts a shell command and streams output through session notifications. The command +// runs as the leader of its own process group (POSIX) or in a dedicated job object +// (Windows), so a forced termination — via "shell.kill", the request timeout, or session +// disposal — signals that whole group/job rather than only the direct child. Two gaps are +// worth planning for: a command that exits on its own does not trigger that teardown, and +// on POSIX a descendant that moves itself into a new session or process group (for example +// via "setsid") leaves the signalled group, so either can leave a background process +// running. // -// RPC method: session.queue.removeAt. +// RPC method: session.shell.exec. // -// Parameters: Parameters for removing a queued item by stable id. +// Parameters: Shell command to run, with optional working directory and timeout in +// milliseconds. // -// Returns: Result of removing a queued item. -func (a *QueueAPI) RemoveAt(ctx context.Context, params *QueueRemoveAtRequest) (*QueueRemoveAtResult, error) { +// Returns: Identifier of the spawned process, used to correlate streamed output and exit +// notifications. +func (a *ShellAPI) Exec(ctx context.Context, params *ShellExecRequest) (*ShellExecResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["id"] = params.ID + req["command"] = params.Command + if params.Cwd != nil { + req["cwd"] = *params.Cwd + } + if params.Timeout != nil { + req["timeout"] = *params.Timeout + } } - raw, err := a.client.Request(ctx, "session.queue.removeAt", req) + raw, err := a.client.Request(ctx, "session.shell.exec", req) if err != nil { return nil, err } - var result QueueRemoveAtResult + var result ShellExecResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RemoveMostRecent removes the most recently queued user-facing item (LIFO). +// ExecuteUserRequested executes a user-requested shell command through the session runtime. // -// RPC method: session.queue.removeMostRecent. +// RPC method: session.shell.executeUserRequested. // -// Returns: Indicates whether a user-facing pending item was removed. -func (a *QueueAPI) RemoveMostRecent(ctx context.Context) (*QueueRemoveMostRecentResult, error) { +// Parameters: User-requested shell command and cancellation handle. +// +// Returns: Result of a user-requested shell command. +func (a *ShellAPI) ExecuteUserRequested(ctx context.Context, params *ShellExecuteUserRequestedRequest) (*UserRequestedShellCommandResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.queue.removeMostRecent", req) + if params != nil { + req["command"] = params.Command + req["requestId"] = params.RequestID + } + raw, err := a.client.Request(ctx, "session.shell.executeUserRequested", req) if err != nil { return nil, err } - var result QueueRemoveMostRecentResult + var result UserRequestedShellCommandResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SendNow moves an addressable queued message into the live turn's steering lane. +// Kill sends a signal to a shell process previously started via "shell.exec". The signal +// targets the command's whole process group (POSIX) or job object (Windows), so descendants +// still in that group are signalled too, not just the direct child. On POSIX a descendant +// that moved itself into a new session or process group (for example via "setsid") is no +// longer in the signalled group and survives. // -// RPC method: session.queue.sendNow. +// RPC method: session.shell.kill. // -// Parameters: Parameters for steering a queued message into a live turn. +// Parameters: Identifier of a process previously returned by "shell.exec" and the signal to +// send. // -// Returns: Result of trying to steer a queued message into a live turn. -func (a *QueueAPI) SendNow(ctx context.Context, params *QueueSendNowRequest) (*QueueSendNowResult, error) { +// Returns: Indicates whether the signal was delivered; false if the process was unknown or +// already exited. +func (a *ShellAPI) Kill(ctx context.Context, params *ShellKillRequest) (*ShellKillResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["id"] = params.ID + req["processId"] = params.ProcessID + if params.Signal != nil { + req["signal"] = *params.Signal + } } - raw, err := a.client.Request(ctx, "session.queue.sendNow", req) + raw, err := a.client.Request(ctx, "session.shell.kill", req) if err != nil { return nil, err } - var result QueueSendNowResult + var result ShellKillResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetDrainPaused acquires or releases the queued-lane drain pause. +// Experimental: SkillsAPI contains experimental APIs that may change or be removed. +type SkillsAPI sessionAPI + +// Disables a skill for the session. // -// RPC method: session.queue.setDrainPaused. +// RPC method: session.skills.disable. // -// Parameters: Parameters for acquiring or releasing the queued-lane drain pause. -// Acquisition is exclusive and non-idempotent: `paused: true` against an already-paused -// session fails with `queue_already_paused`. The pause is never released automatically — it -// is not tied to the caller's lifetime, so a client that exits without sending `paused: -// false` leaves the lane frozen. Release is unowned: `paused: false` clears the pause for -// any caller, including one that never acquired it. -func (a *QueueAPI) SetDrainPaused(ctx context.Context, params *QueueSetDrainPausedRequest) (*SessionQueueSetDrainPausedResult, error) { +// Parameters: Name of the skill to disable for the session. +func (a *SkillsAPI) Disable(ctx context.Context, params *SkillsDisableRequest) (*SessionSkillsDisableResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["paused"] = params.Paused + req["name"] = params.Name } - raw, err := a.client.Request(ctx, "session.queue.setDrainPaused", req) + raw, err := a.client.Request(ctx, "session.skills.disable", req) if err != nil { return nil, err } - var result SessionQueueSetDrainPausedResult + var result SessionSkillsDisableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// UpdateText updates the text of an addressable single-message queue item. -// -// RPC method: session.queue.updateText. +// Enables a skill for the session. // -// Parameters: Parameters for editing a single queued message. +// RPC method: session.skills.enable. // -// Returns: Result of editing a queued message. -func (a *QueueAPI) UpdateText(ctx context.Context, params *QueueUpdateTextRequest) (*QueueUpdateTextResult, error) { +// Parameters: Name of the skill to enable for the session. +func (a *SkillsAPI) Enable(ctx context.Context, params *SkillsEnableRequest) (*SessionSkillsEnableResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.DisplayPrompt != nil { - req["displayPrompt"] = *params.DisplayPrompt - } - req["id"] = params.ID - req["prompt"] = params.Prompt + req["name"] = params.Name } - raw, err := a.client.Request(ctx, "session.queue.updateText", req) + raw, err := a.client.Request(ctx, "session.skills.enable", req) if err != nil { return nil, err } - var result QueueUpdateTextResult + var result SessionSkillsEnableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: RemoteAPI contains experimental APIs that may change or be removed. -type RemoteAPI sessionAPI - -// Disables remote session export and steering. +// EnsureLoaded ensures the session's skill definitions have been loaded from disk. // -// RPC method: session.remote.disable. -func (a *RemoteAPI) Disable(ctx context.Context) (*SessionRemoteDisableResult, error) { +// RPC method: session.skills.ensureLoaded. +func (a *SkillsAPI) EnsureLoaded(ctx context.Context) (*SessionSkillsEnsureLoadedResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.remote.disable", req) + raw, err := a.client.Request(ctx, "session.skills.ensureLoaded", req) if err != nil { return nil, err } - var result SessionRemoteDisableResult + var result SessionSkillsEnsureLoadedResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Enables remote session export or steering. -// -// RPC method: session.remote.enable. +// GetInvoked returns the skills that have been invoked during this session. // -// Parameters: Optional remote session mode ("off", "export", or "on"); defaults to enabling -// both export and remote steering. +// RPC method: session.skills.getInvoked. // -// Returns: GitHub URL for the session and a flag indicating whether remote steering is -// enabled. -func (a *RemoteAPI) Enable(ctx context.Context, params *RemoteEnableRequest) (*RemoteEnableResult, error) { +// Returns: Skills invoked during this session, ordered by invocation time (most recent +// last). +func (a *SkillsAPI) GetInvoked(ctx context.Context) (*SkillsGetInvokedResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.Mode != nil { - req["mode"] = *params.Mode - } - } - raw, err := a.client.Request(ctx, "session.remote.enable", req) + raw, err := a.client.Request(ctx, "session.skills.getInvoked", req) if err != nil { return nil, err } - var result RemoteEnableResult + var result SkillsGetInvokedResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// NotifySteerableChanged persists a remote-steerability change emitted by the host as a -// session event. -// -// RPC method: session.remote.notifySteerableChanged. +// Lists skills available to the session. // -// Parameters: New remote-steerability state to persist as a -// `session.remote_steerable_changed` event. +// RPC method: session.skills.list. // -// Returns: Persist a steerability change as a `session.remote_steerable_changed` event. -// Used by the host (CLI / SDK consumer) when it has just finished enabling or disabling -// steering on a remote exporter that the runtime does not directly own. -func (a *RemoteAPI) NotifySteerableChanged(ctx context.Context, params *RemoteNotifySteerableChangedRequest) (*RemoteNotifySteerableChangedResult, error) { +// Returns: Skills available to the session, with their enabled state. +func (a *SkillsAPI) List(ctx context.Context) (*SkillList, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["remoteSteerable"] = params.RemoteSteerable - } - raw, err := a.client.Request(ctx, "session.remote.notifySteerableChanged", req) + raw, err := a.client.Request(ctx, "session.skills.list", req) if err != nil { return nil, err } - var result RemoteNotifySteerableChangedResult + var result SkillList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: SandboxAPI contains experimental APIs that may change or be removed. -type SandboxAPI sessionAPI - -// DisableForSession disables sandboxing for the remainder of the current session and -// approves the referenced pending sandbox-bypass permission request. The request is -// rejected unless the exact request is still pending and the effective sandbox policy -// permits bypass. -// -// RPC method: session.sandbox.disableForSession. +// Reloads skill definitions for the session. // -// Parameters: Request to disable sandboxing for the current session while resolving an -// active sandbox-bypass permission prompt. +// RPC method: session.skills.reload. // -// Returns: Result of attempting to disable sandboxing for the current session. -func (a *SandboxAPI) DisableForSession(ctx context.Context, params *SandboxDisableForSessionRequest) (*SandboxDisableForSessionResult, error) { +// Returns: Diagnostics from reloading skill definitions, with warnings and errors as +// separate lists. +func (a *SkillsAPI) Reload(ctx context.Context) (*SkillsLoadDiagnostics, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.DecisionContext != nil { - req["decisionContext"] = *params.DecisionContext - } - req["requestId"] = params.RequestID - } - raw, err := a.client.Request(ctx, "session.sandbox.disableForSession", req) + raw, err := a.client.Request(ctx, "session.skills.reload", req) if err != nil { return nil, err } - var result SandboxDisableForSessionResult + var result SkillsLoadDiagnostics if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetEnforcementStatus returns whether managed policy requires sandbox enforcement and -// whether an enforcement failure has permanently blocked the session. +// Experimental: TasksAPI contains experimental APIs that may change or be removed. +type TasksAPI sessionAPI + +// Cancels a background task. // -// RPC method: session.sandbox.getEnforcementStatus. +// RPC method: session.tasks.cancel. // -// Returns: Managed sandbox enforcement state for a session. -func (a *SandboxAPI) GetEnforcementStatus(ctx context.Context) (*SandboxEnforcementStatus, error) { +// Parameters: Identifier of the background task to cancel. +// +// Returns: Indicates whether the background task was successfully cancelled. +func (a *TasksAPI) Cancel(ctx context.Context, params *TasksCancelRequest) (*TasksCancelResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.sandbox.getEnforcementStatus", req) + if params != nil { + req["id"] = params.ID + } + raw, err := a.client.Request(ctx, "session.tasks.cancel", req) if err != nil { return nil, err } - var result SandboxEnforcementStatus + var result TasksCancelResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ScheduleAPI contains experimental APIs that may change or be removed. -type ScheduleAPI sessionAPI - -// Lists the session's currently active scheduled prompts. +// GetCurrentPromotable returns the first sync-waiting task that can currently be promoted +// to background mode. // -// RPC method: session.schedule.list. +// RPC method: session.tasks.getCurrentPromotable. // -// Returns: Snapshot of the currently active recurring prompts for this session. -func (a *ScheduleAPI) List(ctx context.Context) (*ScheduleList, error) { +// Returns: The first sync-waiting task that can currently be promoted to background mode. +func (a *TasksAPI) GetCurrentPromotable(ctx context.Context) (*TasksGetCurrentPromotableResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.schedule.list", req) + raw, err := a.client.Request(ctx, "session.tasks.getCurrentPromotable", req) if err != nil { return nil, err } - var result ScheduleList + var result TasksGetCurrentPromotableResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Stop removes a scheduled prompt by id. +// GetProgress returns progress information for a background task by ID. // -// RPC method: session.schedule.stop. +// RPC method: session.tasks.getProgress. // -// Parameters: Identifier of the scheduled prompt to remove. +// Parameters: Identifier of the background task to fetch progress for. // -// Returns: Remove a scheduled prompt by id. The result entry is omitted if the id was -// unknown. -func (a *ScheduleAPI) Stop(ctx context.Context, params *ScheduleStopRequest) (*ScheduleStopResult, error) { +// Returns: Progress information for the task, or null when no task with that ID is tracked. +func (a *TasksAPI) GetProgress(ctx context.Context, params *TasksGetProgressRequest) (*TasksGetProgressResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { req["id"] = params.ID } - raw, err := a.client.Request(ctx, "session.schedule.stop", req) + raw, err := a.client.Request(ctx, "session.tasks.getProgress", req) if err != nil { return nil, err } - var result ScheduleStopResult + var result TasksGetProgressResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ShellAPI contains experimental APIs that may change or be removed. -type ShellAPI sessionAPI - -// CancelUserRequested cancels a user-requested shell command by request ID. -// -// RPC method: session.shell.cancelUserRequested. +// Lists background tasks tracked by the session. // -// Parameters: User-requested shell execution cancellation handle. +// RPC method: session.tasks.list. // -// Returns: Cancellation result for a user-requested shell command. -func (a *ShellAPI) CancelUserRequested(ctx context.Context, params *ShellCancelUserRequestedRequest) (*CancelUserRequestedShellCommandResult, error) { +// Returns: Background tasks currently tracked by the session. +func (a *TasksAPI) List(ctx context.Context) (*TaskList, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["requestId"] = params.RequestID - } - raw, err := a.client.Request(ctx, "session.shell.cancelUserRequested", req) + raw, err := a.client.Request(ctx, "session.tasks.list", req) if err != nil { return nil, err } - var result CancelUserRequestedShellCommandResult + var result TaskList if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Exec starts a shell command and streams output through session notifications. The command -// runs as the leader of its own process group (POSIX) or in a dedicated job object -// (Windows), so a forced termination — via "shell.kill", the request timeout, or session -// disposal — signals that whole group/job rather than only the direct child. Two gaps are -// worth planning for: a command that exits on its own does not trigger that teardown, and -// on POSIX a descendant that moves itself into a new session or process group (for example -// via "setsid") leaves the signalled group, so either can leave a background process -// running. -// -// RPC method: session.shell.exec. +// PromoteCurrentToBackground atomically promotes the first promotable sync-waiting task to +// background mode and returns it. // -// Parameters: Shell command to run, with optional working directory and timeout in -// milliseconds. +// RPC method: session.tasks.promoteCurrentToBackground. // -// Returns: Identifier of the spawned process, used to correlate streamed output and exit -// notifications. -func (a *ShellAPI) Exec(ctx context.Context, params *ShellExecRequest) (*ShellExecResult, error) { +// Returns: The promoted task as it now exists in background mode, omitted if no promotable +// task was waiting. +func (a *TasksAPI) PromoteCurrentToBackground(ctx context.Context) (*TasksPromoteCurrentToBackgroundResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["command"] = params.Command - if params.Cwd != nil { - req["cwd"] = *params.Cwd - } - if params.Timeout != nil { - req["timeout"] = *params.Timeout - } - } - raw, err := a.client.Request(ctx, "session.shell.exec", req) + raw, err := a.client.Request(ctx, "session.tasks.promoteCurrentToBackground", req) if err != nil { return nil, err } - var result ShellExecResult + var result TasksPromoteCurrentToBackgroundResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// ExecuteUserRequested executes a user-requested shell command through the session runtime. +// PromoteToBackground promotes an eligible synchronously-waited task so it continues +// running in the background. // -// RPC method: session.shell.executeUserRequested. +// RPC method: session.tasks.promoteToBackground. // -// Parameters: User-requested shell command and cancellation handle. +// Parameters: Identifier of the task to promote to background mode. // -// Returns: Result of a user-requested shell command. -func (a *ShellAPI) ExecuteUserRequested(ctx context.Context, params *ShellExecuteUserRequestedRequest) (*UserRequestedShellCommandResult, error) { +// Returns: Indicates whether the task was successfully promoted to background mode. +func (a *TasksAPI) PromoteToBackground(ctx context.Context, params *TasksPromoteToBackgroundRequest) (*TasksPromoteToBackgroundResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["command"] = params.Command - req["requestId"] = params.RequestID + req["id"] = params.ID } - raw, err := a.client.Request(ctx, "session.shell.executeUserRequested", req) + raw, err := a.client.Request(ctx, "session.tasks.promoteToBackground", req) if err != nil { return nil, err } - var result UserRequestedShellCommandResult + var result TasksPromoteToBackgroundResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Kill sends a signal to a shell process previously started via "shell.exec". The signal -// targets the command's whole process group (POSIX) or job object (Windows), so descendants -// still in that group are signalled too, not just the direct child. On POSIX a descendant -// that moved itself into a new session or process group (for example via "setsid") is no -// longer in the signalled group and survives. -// -// RPC method: session.shell.kill. +// Refreshes metadata for any detached background shells the runtime knows about. // -// Parameters: Identifier of a process previously returned by "shell.exec" and the signal to -// send. +// RPC method: session.tasks.refresh. // -// Returns: Indicates whether the signal was delivered; false if the process was unknown or -// already exited. -func (a *ShellAPI) Kill(ctx context.Context, params *ShellKillRequest) (*ShellKillResult, error) { +// Returns: Refresh metadata for any detached background shells the runtime knows about. Use +// after a long pause to pick up exit/output state for shells running outside the agent loop. +func (a *TasksAPI) Refresh(ctx context.Context) (*TasksRefreshResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["processId"] = params.ProcessID - if params.Signal != nil { - req["signal"] = *params.Signal - } - } - raw, err := a.client.Request(ctx, "session.shell.kill", req) + raw, err := a.client.Request(ctx, "session.tasks.refresh", req) if err != nil { return nil, err } - var result ShellKillResult + var result TasksRefreshResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: SkillsAPI contains experimental APIs that may change or be removed. -type SkillsAPI sessionAPI - -// Disables a skill for the session. +// Registers a client-owned task, or reclaims an orphaned task belonging to the same +// extension principal. // -// RPC method: session.skills.disable. +// RPC method: session.tasks.register. // -// Parameters: Name of the skill to disable for the session. -func (a *SkillsAPI) Disable(ctx context.Context, params *SkillsDisableRequest) (*SessionSkillsDisableResult, error) { +// Parameters: Registers or reclaims a client-owned task. +// +// Returns: Result of registering or reclaiming a client-owned task. +func (a *TasksAPI) Register(ctx context.Context, params *TasksRegisterRequest) (*TasksRegisterResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["name"] = params.Name + req["cancellable"] = params.Cancellable + req["clientTaskId"] = params.ClientTaskID + req["description"] = params.Description + if params.DisplayName != nil { + req["displayName"] = *params.DisplayName + } + if params.ExpectedSequence != nil { + req["expectedSequence"] = *params.ExpectedSequence + } + req["type"] = params.Type } - raw, err := a.client.Request(ctx, "session.skills.disable", req) + raw, err := a.client.Request(ctx, "session.tasks.register", req) if err != nil { return nil, err } - var result SessionSkillsDisableResult + var result TasksRegisterResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Enables a skill for the session. +// Removes a completed or cancelled background task from tracking. // -// RPC method: session.skills.enable. +// RPC method: session.tasks.remove. // -// Parameters: Name of the skill to enable for the session. -func (a *SkillsAPI) Enable(ctx context.Context, params *SkillsEnableRequest) (*SessionSkillsEnableResult, error) { +// Parameters: Identifier of the completed or cancelled task to remove from tracking. +// +// Returns: Indicates whether the task was removed. False when the task does not exist or is +// still running/idle. +func (a *TasksAPI) Remove(ctx context.Context, params *TasksRemoveRequest) (*TasksRemoveResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["name"] = params.Name + req["id"] = params.ID } - raw, err := a.client.Request(ctx, "session.skills.enable", req) + raw, err := a.client.Request(ctx, "session.tasks.remove", req) if err != nil { return nil, err } - var result SessionSkillsEnableResult + var result TasksRemoveResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// EnsureLoaded ensures the session's skill definitions have been loaded from disk. +// SendMessage sends a message to a background agent task. // -// RPC method: session.skills.ensureLoaded. -func (a *SkillsAPI) EnsureLoaded(ctx context.Context) (*SessionSkillsEnsureLoadedResult, error) { +// RPC method: session.tasks.sendMessage. +// +// Parameters: Identifier of the target agent task, message content, and optional sender +// agent ID. +// +// Returns: Indicates whether the message was delivered, with an error message when delivery +// failed. +func (a *TasksAPI) SendMessage(ctx context.Context, params *TasksSendMessageRequest) (*TasksSendMessageResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.skills.ensureLoaded", req) + if params != nil { + if params.FromAgentID != nil { + req["fromAgentId"] = *params.FromAgentID + } + req["id"] = params.ID + req["message"] = params.Message + } + raw, err := a.client.Request(ctx, "session.tasks.sendMessage", req) if err != nil { return nil, err } - var result SessionSkillsEnsureLoadedResult + var result TasksSendMessageResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetInvoked returns the skills that have been invoked during this session. +// StartAgent starts a background agent task in the session. // -// RPC method: session.skills.getInvoked. +// RPC method: session.tasks.startAgent. // -// Returns: Skills invoked during this session, ordered by invocation time (most recent -// last). -func (a *SkillsAPI) GetInvoked(ctx context.Context) (*SkillsGetInvokedResult, error) { +// Parameters: Agent type, prompt, name, and optional description and model override for the +// new task. +// +// Returns: Identifier assigned to the newly started background agent task. +func (a *TasksAPI) StartAgent(ctx context.Context, params *TasksStartAgentRequest) (*TasksStartAgentResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.skills.getInvoked", req) + if params != nil { + req["agentType"] = params.AgentType + if params.Description != nil { + req["description"] = *params.Description + } + if params.Model != nil { + req["model"] = *params.Model + } + req["name"] = params.Name + req["prompt"] = params.Prompt + } + raw, err := a.client.Request(ctx, "session.tasks.startAgent", req) if err != nil { return nil, err } - var result SkillsGetInvokedResult + var result TasksStartAgentResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Lists skills available to the session. +// Update publishes generic progress or a terminal outcome for a client-owned task. // -// RPC method: session.skills.list. +// RPC method: session.tasks.update. // -// Returns: Skills available to the session, with their enabled state. -func (a *SkillsAPI) List(ctx context.Context) (*SkillList, error) { +// Parameters: Updates a client-owned task. +// +// Returns: Result of publishing a client-owned task update. +func (a *TasksAPI) Update(ctx context.Context, params *TasksUpdateRequest) (*TasksUpdateResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.skills.list", req) + if params != nil { + req["id"] = params.ID + req["sequence"] = params.Sequence + req["update"] = params.Update + } + raw, err := a.client.Request(ctx, "session.tasks.update", req) if err != nil { return nil, err } - var result SkillList + var result TasksUpdateResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Reloads skill definitions for the session. +// WaitForPending waits for all in-flight background tasks and any follow-up turns to settle. // -// RPC method: session.skills.reload. +// RPC method: session.tasks.waitForPending. // -// Returns: Diagnostics from reloading skill definitions, with warnings and errors as -// separate lists. -func (a *SkillsAPI) Reload(ctx context.Context) (*SkillsLoadDiagnostics, error) { +// Returns: Wait until all in-flight background tasks (agents + shells) and any follow-up +// turns scheduled by their completions have settled. Returns when the runtime is fully +// drained or after an internal timeout (default 10 minutes; configurable via +// COPILOT_TASK_WAIT_TIMEOUT_SECONDS). +func (a *TasksAPI) WaitForPending(ctx context.Context) (*TasksWaitForPendingResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.skills.reload", req) + raw, err := a.client.Request(ctx, "session.tasks.waitForPending", req) if err != nil { return nil, err } - var result SkillsLoadDiagnostics + var result TasksWaitForPendingResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: TasksAPI contains experimental APIs that may change or be removed. -type TasksAPI sessionAPI +// Experimental: TelemetryAPI contains experimental APIs that may change or be removed. +type TelemetryAPI sessionAPI -// Cancels a background task. -// -// RPC method: session.tasks.cancel. +// GetEngagementId gets the telemetry engagement ID currently associated with the session, +// when available. // -// Parameters: Identifier of the background task to cancel. +// RPC method: session.telemetry.getEngagementId. // -// Returns: Indicates whether the background task was successfully cancelled. -func (a *TasksAPI) Cancel(ctx context.Context, params *TasksCancelRequest) (*TasksCancelResult, error) { +// Returns: Telemetry engagement ID for the session, when available. +func (a *TelemetryAPI) GetEngagementId(ctx context.Context) (*SessionTelemetryEngagement, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["id"] = params.ID - } - raw, err := a.client.Request(ctx, "session.tasks.cancel", req) + raw, err := a.client.Request(ctx, "session.telemetry.getEngagementId", req) if err != nil { return nil, err } - var result TasksCancelResult + var result SessionTelemetryEngagement if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetCurrentPromotable returns the first sync-waiting task that can currently be promoted -// to background mode. +// SetFeatureOverrides sets feature override key/value pairs to attach to subsequent +// telemetry events for the session. // -// RPC method: session.tasks.getCurrentPromotable. +// RPC method: session.telemetry.setFeatureOverrides. // -// Returns: The first sync-waiting task that can currently be promoted to background mode. -func (a *TasksAPI) GetCurrentPromotable(ctx context.Context) (*TasksGetCurrentPromotableResult, error) { +// Parameters: Feature override key/value pairs to attach to subsequent telemetry events +// from this session. +func (a *TelemetryAPI) SetFeatureOverrides(ctx context.Context, params *TelemetrySetFeatureOverridesRequest) (*SessionTelemetrySetFeatureOverridesResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.tasks.getCurrentPromotable", req) + if params != nil { + req["features"] = params.Features + } + raw, err := a.client.Request(ctx, "session.telemetry.setFeatureOverrides", req) if err != nil { return nil, err } - var result TasksGetCurrentPromotableResult + var result SessionTelemetrySetFeatureOverridesResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetProgress returns progress information for a background task by ID. +// Experimental: ToolsAPI contains experimental APIs that may change or be removed. +type ToolsAPI sessionAPI + +// Executes one tool from the session's currently offered tool set through the native +// invocation pipeline. // -// RPC method: session.tasks.getProgress. +// RPC method: session.tools.execute. // -// Parameters: Identifier of the background task to fetch progress for. +// Parameters: A tool name and arguments to execute through the session's native invocation +// pipeline. // -// Returns: Progress information for the task, or null when no task with that ID is tracked. -func (a *TasksAPI) GetProgress(ctx context.Context, params *TasksGetProgressRequest) (*TasksGetProgressResult, error) { +// Returns: Canonical result returned by a session tool. +func (a *ToolsAPI) Execute(ctx context.Context, params *ToolsExecuteRequest) (ToolResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["id"] = params.ID + req["arguments"] = params.Arguments + req["name"] = params.Name + if params.ToolCallID != nil { + req["toolCallId"] = *params.ToolCallID + } } - raw, err := a.client.Request(ctx, "session.tasks.getProgress", req) + raw, err := a.client.Request(ctx, "session.tools.execute", req) if err != nil { return nil, err } - var result TasksGetProgressResult - if err := json.Unmarshal(raw, &result); err != nil { + result, err := unmarshalToolResult(raw) + if err != nil { return nil, err } - return &result, nil + return result, nil } -// Lists background tasks tracked by the session. +// GetBuiltinDescriptors returns the Rust-owned built-in tool descriptors used to construct +// the session's offered tool set. // -// RPC method: session.tasks.list. +// RPC method: session.tools.getBuiltinDescriptors. // -// Returns: Background tasks currently tracked by the session. -func (a *TasksAPI) List(ctx context.Context) (*TaskList, error) { +// Parameters: Options controlling how Rust-owned built-in tool descriptors are materialized. +// +// Returns: Rust-owned built-in tool descriptors for the session. +func (a *ToolsAPI) GetBuiltinDescriptors(ctx context.Context, params *ToolsGetBuiltinDescriptorsRequest) (*ToolsGetBuiltinDescriptorsResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.tasks.list", req) + if params != nil { + if params.BackgroundTaskNotificationsEnabled != nil { + req["backgroundTaskNotificationsEnabled"] = *params.BackgroundTaskNotificationsEnabled + } + if params.IncludeAuthor != nil { + req["includeAuthor"] = *params.IncludeAuthor + } + if params.ReduceUserIntervention != nil { + req["reduceUserIntervention"] = *params.ReduceUserIntervention + } + if params.ShellConfig != nil { + req["shellConfig"] = *params.ShellConfig + } + if params.ShellSupportsPowerShell7Syntax != nil { + req["shellSupportsPowerShell7Syntax"] = *params.ShellSupportsPowerShell7Syntax + } + if params.ShellTimeoutMs != nil { + req["shellTimeoutMs"] = *params.ShellTimeoutMs + } + if params.SkillEmbeddingEnabled != nil { + req["skillEmbeddingEnabled"] = *params.SkillEmbeddingEnabled + } + } + raw, err := a.client.Request(ctx, "session.tools.getBuiltinDescriptors", req) if err != nil { return nil, err } - var result TaskList + var result ToolsGetBuiltinDescriptorsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// PromoteCurrentToBackground atomically promotes the first promotable sync-waiting task to -// background mode and returns it. +// GetCurrentMetadata returns lightweight metadata for the session's currently initialized +// tools. // -// RPC method: session.tasks.promoteCurrentToBackground. +// RPC method: session.tools.getCurrentMetadata. // -// Returns: The promoted task as it now exists in background mode, omitted if no promotable -// task was waiting. -func (a *TasksAPI) PromoteCurrentToBackground(ctx context.Context) (*TasksPromoteCurrentToBackgroundResult, error) { +// Returns: Current lightweight tool metadata snapshot for the session. +func (a *ToolsAPI) GetCurrentMetadata(ctx context.Context) (*ToolsGetCurrentMetadataResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.tasks.promoteCurrentToBackground", req) + raw, err := a.client.Request(ctx, "session.tools.getCurrentMetadata", req) if err != nil { return nil, err } - var result TasksPromoteCurrentToBackgroundResult + var result ToolsGetCurrentMetadataResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// PromoteToBackground promotes an eligible synchronously-waited task so it continues -// running in the background. +// HandlePendingToolCall provides the result for a pending external tool call. // -// RPC method: session.tasks.promoteToBackground. +// RPC method: session.tools.handlePendingToolCall. // -// Parameters: Identifier of the task to promote to background mode. +// Parameters: Pending external tool call request ID, with the tool result or an error +// describing why it failed. // -// Returns: Indicates whether the task was successfully promoted to background mode. -func (a *TasksAPI) PromoteToBackground(ctx context.Context, params *TasksPromoteToBackgroundRequest) (*TasksPromoteToBackgroundResult, error) { +// Returns: Indicates whether the external tool call result was handled successfully. +func (a *ToolsAPI) HandlePendingToolCall(ctx context.Context, params *HandlePendingToolCallRequest) (*HandlePendingToolCallResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["id"] = params.ID + if params.Error != nil { + req["error"] = *params.Error + } + req["requestId"] = params.RequestID + if params.Result != nil { + req["result"] = params.Result + } } - raw, err := a.client.Request(ctx, "session.tasks.promoteToBackground", req) + raw, err := a.client.Request(ctx, "session.tools.handlePendingToolCall", req) if err != nil { return nil, err } - var result TasksPromoteToBackgroundResult + var result HandlePendingToolCallResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Refreshes metadata for any detached background shells the runtime knows about. +// InitializeAndValidate resolves, builds, and validates the runtime tool list for the +// session. // -// RPC method: session.tasks.refresh. +// RPC method: session.tools.initializeAndValidate. // -// Returns: Refresh metadata for any detached background shells the runtime knows about. Use -// after a long pause to pick up exit/output state for shells running outside the agent loop. -func (a *TasksAPI) Refresh(ctx context.Context) (*TasksRefreshResult, error) { +// Returns: Resolve, build, and validate the runtime tool list for this session. Subagent +// sessions and consumer flows that need an initialized tool set before `send` invoke this. +// Default base-class implementation is a no-op for sessions that don't support tool +// validation. +func (a *ToolsAPI) InitializeAndValidate(ctx context.Context) (*ToolsInitializeAndValidateResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.tasks.refresh", req) + raw, err := a.client.Request(ctx, "session.tools.initializeAndValidate", req) if err != nil { return nil, err } - var result TasksRefreshResult + var result ToolsInitializeAndValidateResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Registers a client-owned task, or reclaims an orphaned task belonging to the same -// extension principal. +// Set atomically replaces the complete externally implemented tool list supplied by the +// calling connection. Built-in, MCP/plugin, extension-discovered, subagent, and tools +// supplied by other connections remain unchanged. // -// RPC method: session.tasks.register. +// RPC method: session.tools.set. // -// Parameters: Registers or reclaims a client-owned task. +// Parameters: Complete externally implemented tool list for the calling connection. An +// empty list removes every tool previously supplied by that connection. // -// Returns: Result of registering or reclaiming a client-owned task. -func (a *TasksAPI) Register(ctx context.Context, params *TasksRegisterRequest) (*TasksRegisterResult, error) { +// Returns: Empty result after replacing the calling connection's externally implemented +// tools. +func (a *ToolsAPI) Set(ctx context.Context, params *ToolsSetRequest) (*ToolsSetResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["cancellable"] = params.Cancellable - req["clientTaskId"] = params.ClientTaskID - req["description"] = params.Description - if params.DisplayName != nil { - req["displayName"] = *params.DisplayName - } - if params.ExpectedSequence != nil { - req["expectedSequence"] = *params.ExpectedSequence - } - req["type"] = params.Type + req["tools"] = params.Tools } - raw, err := a.client.Request(ctx, "session.tasks.register", req) + raw, err := a.client.Request(ctx, "session.tools.set", req) if err != nil { return nil, err } - var result TasksRegisterResult + var result ToolsSetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Removes a completed or cancelled background task from tracking. +// TaskCompleteEventData projects a completed task_complete tool call into its label-safe +// session event payload. // -// RPC method: session.tasks.remove. +// RPC method: session.tools.taskCompleteEventData. // -// Parameters: Identifier of the completed or cancelled task to remove from tracking. +// Parameters: Task-completion tool arguments and final result used to build a label-safe +// session event payload. // -// Returns: Indicates whether the task was removed. False when the task does not exist or is -// still running/idle. -func (a *TasksAPI) Remove(ctx context.Context, params *TasksRemoveRequest) (*TasksRemoveResult, error) { +// Returns: Task completion notification with summary from the agent +func (a *ToolsAPI) TaskCompleteEventData(ctx context.Context, params *ToolsTaskCompleteEventDataRequest) (*TaskCompleteData, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["id"] = params.ID + req["finalResult"] = params.FinalResult + req["toolArgs"] = params.ToolArgs } - raw, err := a.client.Request(ctx, "session.tasks.remove", req) + raw, err := a.client.Request(ctx, "session.tools.taskCompleteEventData", req) if err != nil { return nil, err } - var result TasksRemoveResult + var result TaskCompleteData if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SendMessage sends a message to a background agent task. +// UpdateSubagentSettings sets the current session's live subagent settings override, which +// takes precedence over persisted user settings until cleared. Persisted user settings +// remain the source of truth for future sessions. // -// RPC method: session.tasks.sendMessage. +// RPC method: session.tools.updateSubagentSettings. // -// Parameters: Identifier of the target agent task, message content, and optional sender -// agent ID. +// Parameters: Subagent settings to apply to the current session // -// Returns: Indicates whether the message was delivered, with an error message when delivery -// failed. -func (a *TasksAPI) SendMessage(ctx context.Context, params *TasksSendMessageRequest) (*TasksSendMessageResult, error) { +// Returns: Empty result after applying subagent settings +func (a *ToolsAPI) UpdateSubagentSettings(ctx context.Context, params *UpdateSubagentSettingsRequest) (*ToolsUpdateSubagentSettingsResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.FromAgentID != nil { - req["fromAgentId"] = *params.FromAgentID + if params.Subagents != nil { + req["subagents"] = *params.Subagents } - req["id"] = params.ID - req["message"] = params.Message } - raw, err := a.client.Request(ctx, "session.tasks.sendMessage", req) + raw, err := a.client.Request(ctx, "session.tools.updateSubagentSettings", req) if err != nil { return nil, err } - var result TasksSendMessageResult + var result ToolsUpdateSubagentSettingsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// StartAgent starts a background agent task in the session. +// Experimental: UIAPI contains experimental APIs that may change or be removed. +type UIAPI sessionAPI + +// Elicitation requests structured input from a UI-capable client. // -// RPC method: session.tasks.startAgent. +// RPC method: session.ui.elicitation. // -// Parameters: Agent type, prompt, name, and optional description and model override for the -// new task. +// Parameters: Prompt message and JSON schema describing the form fields to elicit from the +// user. // -// Returns: Identifier assigned to the newly started background agent task. -func (a *TasksAPI) StartAgent(ctx context.Context, params *TasksStartAgentRequest) (*TasksStartAgentResult, error) { +// Returns: The elicitation response (accept with form values, decline, or cancel) +func (a *UIAPI) Elicitation(ctx context.Context, params *UIElicitationRequest) (*UIElicitationResponse, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["agentType"] = params.AgentType - if params.Description != nil { - req["description"] = *params.Description + req["message"] = params.Message + if params.Meta != nil { + req["_meta"] = params.Meta } - if params.Model != nil { - req["model"] = *params.Model + if params.Mode != nil { + req["mode"] = *params.Mode + } + req["requestedSchema"] = params.RequestedSchema + if params.Task != nil { + req["task"] = *params.Task } - req["name"] = params.Name - req["prompt"] = params.Prompt } - raw, err := a.client.Request(ctx, "session.tasks.startAgent", req) + raw, err := a.client.Request(ctx, "session.ui.elicitation", req) if err != nil { return nil, err } - var result TasksStartAgentResult + var result UIElicitationResponse if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Update publishes generic progress or a terminal outcome for a client-owned task. +// EphemeralQuery runs a transient no-tools model query against the current conversation +// context. // -// RPC method: session.tasks.update. +// RPC method: session.ui.ephemeralQuery. // -// Parameters: Updates a client-owned task. +// Parameters: Transient question to answer without adding it to conversation history. // -// Returns: Result of publishing a client-owned task update. -func (a *TasksAPI) Update(ctx context.Context, params *TasksUpdateRequest) (*TasksUpdateResult, error) { +// Returns: Completed transient query. Ordered chunks and the terminal outcome are also +// delivered through `ui.ephemeral_query` session events while it runs. +func (a *UIAPI) EphemeralQuery(ctx context.Context, params *UIEphemeralQueryRequest) (*UIEphemeralQueryResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["id"] = params.ID - req["sequence"] = params.Sequence - req["update"] = params.Update + if params.AbortSignal != nil { + req["abortSignal"] = params.AbortSignal + } + if params.OnChunk != nil { + req["onChunk"] = params.OnChunk + } + req["question"] = params.Question } - raw, err := a.client.Request(ctx, "session.tasks.update", req) + raw, err := a.client.Request(ctx, "session.ui.ephemeralQuery", req) if err != nil { return nil, err } - var result TasksUpdateResult + var result UIEphemeralQueryResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// WaitForPending waits for all in-flight background tasks and any follow-up turns to settle. -// -// RPC method: session.tasks.waitForPending. +// HandlePendingAutoModeSwitch resolves a pending `auto_mode_switch.requested` event with +// the user's accept/decline decision. // -// Returns: Wait until all in-flight background tasks (agents + shells) and any follow-up -// turns scheduled by their completions have settled. Returns when the runtime is fully -// drained or after an internal timeout (default 10 minutes; configurable via -// COPILOT_TASK_WAIT_TIMEOUT_SECONDS). -func (a *TasksAPI) WaitForPending(ctx context.Context) (*TasksWaitForPendingResult, error) { - req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.tasks.waitForPending", req) - if err != nil { - return nil, err - } - var result TasksWaitForPendingResult - if err := json.Unmarshal(raw, &result); err != nil { - return nil, err - } - return &result, nil -} - -// Experimental: TelemetryAPI contains experimental APIs that may change or be removed. -type TelemetryAPI sessionAPI - -// GetEngagementId gets the telemetry engagement ID currently associated with the session, -// when available. +// RPC method: session.ui.handlePendingAutoModeSwitch. // -// RPC method: session.telemetry.getEngagementId. +// Parameters: Request ID of a pending `auto_mode_switch.requested` event and the user's +// response. // -// Returns: Telemetry engagement ID for the session, when available. -func (a *TelemetryAPI) GetEngagementId(ctx context.Context) (*SessionTelemetryEngagement, error) { +// Returns: Indicates whether the pending UI request was resolved by this call. +func (a *UIAPI) HandlePendingAutoModeSwitch(ctx context.Context, params *UIHandlePendingAutoModeSwitchRequest) (*UIHandlePendingResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.telemetry.getEngagementId", req) + if params != nil { + req["requestId"] = params.RequestID + req["response"] = params.Response + } + raw, err := a.client.Request(ctx, "session.ui.handlePendingAutoModeSwitch", req) if err != nil { return nil, err } - var result SessionTelemetryEngagement + var result UIHandlePendingResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// SetFeatureOverrides sets feature override key/value pairs to attach to subsequent -// telemetry events for the session. +// HandlePendingElicitation provides the user response for a pending elicitation request. // -// RPC method: session.telemetry.setFeatureOverrides. +// RPC method: session.ui.handlePendingElicitation. // -// Parameters: Feature override key/value pairs to attach to subsequent telemetry events -// from this session. -func (a *TelemetryAPI) SetFeatureOverrides(ctx context.Context, params *TelemetrySetFeatureOverridesRequest) (*SessionTelemetrySetFeatureOverridesResult, error) { +// Parameters: Pending elicitation request ID and the user's response (accept/decline/cancel +// + form values). +// +// Returns: Indicates whether the elicitation response was accepted; false if it was already +// resolved by another client. +func (a *UIAPI) HandlePendingElicitation(ctx context.Context, params *UIHandlePendingElicitationRequest) (*UIElicitationResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["features"] = params.Features + req["requestId"] = params.RequestID + req["result"] = params.Result } - raw, err := a.client.Request(ctx, "session.telemetry.setFeatureOverrides", req) + raw, err := a.client.Request(ctx, "session.ui.handlePendingElicitation", req) if err != nil { return nil, err } - var result SessionTelemetrySetFeatureOverridesResult + var result UIElicitationResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: ToolsAPI contains experimental APIs that may change or be removed. -type ToolsAPI sessionAPI - -// Executes one tool from the session's currently offered tool set through the native -// invocation pipeline. +// HandlePendingExitPlanMode resolves a pending `exit_plan_mode.requested` event with the +// user's response. // -// RPC method: session.tools.execute. +// RPC method: session.ui.handlePendingExitPlanMode. // -// Parameters: A tool name and arguments to execute through the session's native invocation -// pipeline. +// Parameters: Request ID of a pending `exit_plan_mode.requested` event and the user's +// response. // -// Returns: Canonical result returned by a session tool. -func (a *ToolsAPI) Execute(ctx context.Context, params *ToolsExecuteRequest) (ToolResult, error) { +// Returns: Indicates whether the pending UI request was resolved by this call. +func (a *UIAPI) HandlePendingExitPlanMode(ctx context.Context, params *UIHandlePendingExitPlanModeRequest) (*UIHandlePendingResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["arguments"] = params.Arguments - req["name"] = params.Name - if params.ToolCallID != nil { - req["toolCallId"] = *params.ToolCallID - } + req["requestId"] = params.RequestID + req["response"] = params.Response } - raw, err := a.client.Request(ctx, "session.tools.execute", req) + raw, err := a.client.Request(ctx, "session.ui.handlePendingExitPlanMode", req) if err != nil { return nil, err } - result, err := unmarshalToolResult(raw) - if err != nil { + var result UIHandlePendingResult + if err := json.Unmarshal(raw, &result); err != nil { return nil, err } - return result, nil + return &result, nil } -// GetBuiltinDescriptors returns the Rust-owned built-in tool descriptors used to construct -// the session's offered tool set. +// HandlePendingSampling resolves a pending `sampling.requested` event with a sampling +// result, or rejects it. // -// RPC method: session.tools.getBuiltinDescriptors. +// RPC method: session.ui.handlePendingSampling. // -// Parameters: Options controlling how Rust-owned built-in tool descriptors are materialized. +// Parameters: Request ID of a pending `sampling.requested` event and an optional sampling +// result payload (omit to reject). // -// Returns: Rust-owned built-in tool descriptors for the session. -func (a *ToolsAPI) GetBuiltinDescriptors(ctx context.Context, params *ToolsGetBuiltinDescriptorsRequest) (*ToolsGetBuiltinDescriptorsResult, error) { +// Returns: Indicates whether the pending UI request was resolved by this call. +func (a *UIAPI) HandlePendingSampling(ctx context.Context, params *UIHandlePendingSamplingRequest) (*UIHandlePendingResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.BackgroundTaskNotificationsEnabled != nil { - req["backgroundTaskNotificationsEnabled"] = *params.BackgroundTaskNotificationsEnabled - } - if params.IncludeAuthor != nil { - req["includeAuthor"] = *params.IncludeAuthor - } - if params.ReduceUserIntervention != nil { - req["reduceUserIntervention"] = *params.ReduceUserIntervention - } - if params.ShellConfig != nil { - req["shellConfig"] = *params.ShellConfig - } - if params.ShellSupportsPowerShell7Syntax != nil { - req["shellSupportsPowerShell7Syntax"] = *params.ShellSupportsPowerShell7Syntax - } - if params.ShellTimeoutMs != nil { - req["shellTimeoutMs"] = *params.ShellTimeoutMs - } - if params.SkillEmbeddingEnabled != nil { - req["skillEmbeddingEnabled"] = *params.SkillEmbeddingEnabled + req["requestId"] = params.RequestID + if params.Response != nil { + req["response"] = *params.Response } } - raw, err := a.client.Request(ctx, "session.tools.getBuiltinDescriptors", req) + raw, err := a.client.Request(ctx, "session.ui.handlePendingSampling", req) if err != nil { return nil, err } - var result ToolsGetBuiltinDescriptorsResult + var result UIHandlePendingResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// GetCurrentMetadata returns lightweight metadata for the session's currently initialized -// tools. +// HandlePendingSessionLimitsExhausted resolves a pending +// `session_limits_exhausted.requested` event with the user's selected limit action. // -// RPC method: session.tools.getCurrentMetadata. +// RPC method: session.ui.handlePendingSessionLimitsExhausted. // -// Returns: Current lightweight tool metadata snapshot for the session. -func (a *ToolsAPI) GetCurrentMetadata(ctx context.Context) (*ToolsGetCurrentMetadataResult, error) { +// Parameters: Request ID of a pending `session_limits_exhausted.requested` event and the +// user's selected limit action. +// +// Returns: Indicates whether the pending UI request was resolved by this call. +func (a *UIAPI) HandlePendingSessionLimitsExhausted(ctx context.Context, params *UIHandlePendingSessionLimitsExhaustedRequest) (*UIHandlePendingResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.tools.getCurrentMetadata", req) + if params != nil { + req["requestId"] = params.RequestID + req["response"] = params.Response + } + raw, err := a.client.Request(ctx, "session.ui.handlePendingSessionLimitsExhausted", req) if err != nil { return nil, err } - var result ToolsGetCurrentMetadataResult + var result UIHandlePendingResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingToolCall provides the result for a pending external tool call. +// HandlePendingUserInput resolves a pending `user_input.requested` event with the user's +// response. // -// RPC method: session.tools.handlePendingToolCall. +// RPC method: session.ui.handlePendingUserInput. // -// Parameters: Pending external tool call request ID, with the tool result or an error -// describing why it failed. +// Parameters: Request ID of a pending `user_input.requested` event and the user's response. // -// Returns: Indicates whether the external tool call result was handled successfully. -func (a *ToolsAPI) HandlePendingToolCall(ctx context.Context, params *HandlePendingToolCallRequest) (*HandlePendingToolCallResult, error) { +// Returns: Indicates whether the pending UI request was resolved by this call. +func (a *UIAPI) HandlePendingUserInput(ctx context.Context, params *UIHandlePendingUserInputRequest) (*UIHandlePendingResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.Error != nil { - req["error"] = *params.Error - } req["requestId"] = params.RequestID - if params.Result != nil { - req["result"] = params.Result - } + req["response"] = params.Response } - raw, err := a.client.Request(ctx, "session.tools.handlePendingToolCall", req) + raw, err := a.client.Request(ctx, "session.ui.handlePendingUserInput", req) if err != nil { return nil, err } - var result HandlePendingToolCallResult + var result UIHandlePendingResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// InitializeAndValidate resolves, builds, and validates the runtime tool list for the -// session. +// RegisterDirectAutoModeSwitchHandler registers an in-process handler for auto-mode-switch +// requests so the server bridge skips dispatch. // -// RPC method: session.tools.initializeAndValidate. +// RPC method: session.ui.registerDirectAutoModeSwitchHandler. // -// Returns: Resolve, build, and validate the runtime tool list for this session. Subagent -// sessions and consumer flows that need an initialized tool set before `send` invoke this. -// Default base-class implementation is a no-op for sessions that don't support tool -// validation. -func (a *ToolsAPI) InitializeAndValidate(ctx context.Context) (*ToolsInitializeAndValidateResult, error) { +// Returns: Register an in-process handler for `auto_mode_switch.requested` events. The +// caller still attaches the actual listener via the standard event-subscription mechanism; +// this registration solely tells the server bridge to skip its own dispatch (so a remote +// client doesn't race the in-process handler for the same requestId). +func (a *UIAPI) RegisterDirectAutoModeSwitchHandler(ctx context.Context) (*UIRegisterDirectAutoModeSwitchHandlerResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.tools.initializeAndValidate", req) + raw, err := a.client.Request(ctx, "session.ui.registerDirectAutoModeSwitchHandler", req) if err != nil { return nil, err } - var result ToolsInitializeAndValidateResult + var result UIRegisterDirectAutoModeSwitchHandlerResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Set atomically replaces the complete externally implemented tool list supplied by the -// calling connection. Built-in, MCP/plugin, extension-discovered, subagent, and tools -// supplied by other connections remain unchanged. +// UnregisterDirectAutoModeSwitchHandler unregisters a previously-registered in-process +// auto-mode-switch handler by its opaque handle. // -// RPC method: session.tools.set. +// RPC method: session.ui.unregisterDirectAutoModeSwitchHandler. // -// Parameters: Complete externally implemented tool list for the calling connection. An -// empty list removes every tool previously supplied by that connection. +// Parameters: Opaque handle previously returned by `registerDirectAutoModeSwitchHandler` to +// release. // -// Returns: Empty result after replacing the calling connection's externally implemented -// tools. -func (a *ToolsAPI) Set(ctx context.Context, params *ToolsSetRequest) (*ToolsSetResult, error) { +// Returns: Indicates whether the handle was active and the registration count was +// decremented. +func (a *UIAPI) UnregisterDirectAutoModeSwitchHandler(ctx context.Context, params *UIUnregisterDirectAutoModeSwitchHandlerRequest) (*UIUnregisterDirectAutoModeSwitchHandlerResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["tools"] = params.Tools + req["handle"] = params.Handle } - raw, err := a.client.Request(ctx, "session.tools.set", req) + raw, err := a.client.Request(ctx, "session.ui.unregisterDirectAutoModeSwitchHandler", req) if err != nil { return nil, err } - var result ToolsSetResult + var result UIUnregisterDirectAutoModeSwitchHandlerResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// TaskCompleteEventData projects a completed task_complete tool call into its label-safe -// session event payload. -// -// RPC method: session.tools.taskCompleteEventData. +// Experimental: UsageAPI contains experimental APIs that may change or be removed. +type UsageAPI sessionAPI + +// GetMetrics gets accumulated usage metrics for the session. // -// Parameters: Task-completion tool arguments and final result used to build a label-safe -// session event payload. +// RPC method: session.usage.getMetrics. // -// Returns: Task completion notification with summary from the agent -func (a *ToolsAPI) TaskCompleteEventData(ctx context.Context, params *ToolsTaskCompleteEventDataRequest) (*TaskCompleteData, error) { +// Returns: Accumulated session usage metrics, including premium request cost, token counts, +// model breakdown, and code-change totals. +func (a *UsageAPI) GetMetrics(ctx context.Context) (*UsageGetMetricsResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - req["finalResult"] = params.FinalResult - req["toolArgs"] = params.ToolArgs - } - raw, err := a.client.Request(ctx, "session.tools.taskCompleteEventData", req) + raw, err := a.client.Request(ctx, "session.usage.getMetrics", req) if err != nil { return nil, err } - var result TaskCompleteData + var result UsageGetMetricsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// UpdateSubagentSettings sets the current session's live subagent settings override, which -// takes precedence over persisted user settings until cleared. Persisted user settings -// remain the source of truth for future sessions. -// -// RPC method: session.tools.updateSubagentSettings. +// Experimental: VisibilityAPI contains experimental APIs that may change or be removed. +type VisibilityAPI sessionAPI + +// Get returns the session's current Mission Control sharing status and shareable GitHub +// URL. Reflects whether the synced session is visible to repository readers ("repo") or +// restricted to its creator and collaborators ("unshared"). // -// Parameters: Subagent settings to apply to the current session +// RPC method: session.visibility.get. // -// Returns: Empty result after applying subagent settings -func (a *ToolsAPI) UpdateSubagentSettings(ctx context.Context, params *UpdateSubagentSettingsRequest) (*ToolsUpdateSubagentSettingsResult, error) { +// Returns: Current sharing status and shareable GitHub URL for a session. +func (a *VisibilityAPI) Get(ctx context.Context) (*VisibilityGetResult, error) { req := map[string]any{"sessionId": a.sessionID} - if params != nil { - if params.Subagents != nil { - req["subagents"] = *params.Subagents - } - } - raw, err := a.client.Request(ctx, "session.tools.updateSubagentSettings", req) + raw, err := a.client.Request(ctx, "session.visibility.get", req) if err != nil { return nil, err } - var result ToolsUpdateSubagentSettingsResult + var result VisibilityGetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: UIAPI contains experimental APIs that may change or be removed. -type UIAPI sessionAPI - -// Elicitation requests structured input from a UI-capable client. +// Sets the session's Mission Control sharing status, controlling whether the synced session +// is visible to repository readers. Returns the effective status and shareable GitHub URL +// after the change. // -// RPC method: session.ui.elicitation. +// RPC method: session.visibility.set. // -// Parameters: Prompt message and JSON schema describing the form fields to elicit from the -// user. +// Parameters: Desired sharing status for the session. // -// Returns: The elicitation response (accept with form values, decline, or cancel) -func (a *UIAPI) Elicitation(ctx context.Context, params *UIElicitationRequest) (*UIElicitationResponse, error) { +// Returns: Effective sharing status and shareable GitHub URL after updating session +// visibility. +func (a *VisibilityAPI) Set(ctx context.Context, params *VisibilitySetRequest) (*VisibilitySetResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["message"] = params.Message - if params.Meta != nil { - req["_meta"] = params.Meta - } - if params.Mode != nil { - req["mode"] = *params.Mode - } - req["requestedSchema"] = params.RequestedSchema - if params.Task != nil { - req["task"] = *params.Task - } + req["status"] = params.Status } - raw, err := a.client.Request(ctx, "session.ui.elicitation", req) + raw, err := a.client.Request(ctx, "session.visibility.set", req) if err != nil { return nil, err } - var result UIElicitationResponse + var result VisibilitySetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// EphemeralQuery runs a transient no-tools model query against the current conversation -// context. +// Experimental: WorkflowAPI contains experimental APIs that may change or be removed. +type WorkflowAPI sessionAPI + +// Agent runs one dynamic-workflow-scoped subagent and returns its result. // -// RPC method: session.ui.ephemeralQuery. +// RPC method: session.workflow.agent. // -// Parameters: Transient question to answer without adding it to conversation history. +// Parameters: Parameters for one workflow-scoped subagent call. // -// Returns: Completed transient query. Ordered chunks and the terminal outcome are also -// delivered through `ui.ephemeral_query` session events while it runs. -func (a *UIAPI) EphemeralQuery(ctx context.Context, params *UIEphemeralQueryRequest) (*UIEphemeralQueryResult, error) { +// Returns: Result of one workflow-scoped subagent call. +func (a *WorkflowAPI) Agent(ctx context.Context, params *WorkflowAgentRequest) (*WorkflowAgentResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - if params.AbortSignal != nil { - req["abortSignal"] = params.AbortSignal - } - if params.OnChunk != nil { - req["onChunk"] = params.OnChunk - } - req["question"] = params.Question + req["executionToken"] = params.ExecutionToken + req["opts"] = params.Opts + req["prompt"] = params.Prompt + req["workflowRunId"] = params.WorkflowRunID } - raw, err := a.client.Request(ctx, "session.ui.ephemeralQuery", req) + raw, err := a.client.Request(ctx, "session.workflow.agent", req) if err != nil { return nil, err } - var result UIEphemeralQueryResult + var result WorkflowAgentResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingAutoModeSwitch resolves a pending `auto_mode_switch.requested` event with -// the user's accept/decline decision. +// Cancel requests cancellation of a dynamic workflow run and returns its run envelope. // -// RPC method: session.ui.handlePendingAutoModeSwitch. +// RPC method: session.workflow.cancel. // -// Parameters: Request ID of a pending `auto_mode_switch.requested` event and the user's -// response. +// Parameters: Parameters for cancelling a workflow run. // -// Returns: Indicates whether the pending UI request was resolved by this call. -func (a *UIAPI) HandlePendingAutoModeSwitch(ctx context.Context, params *UIHandlePendingAutoModeSwitchRequest) (*UIHandlePendingResult, error) { +// Returns: Complete current or terminal workflow run envelope. +func (a *WorkflowAPI) Cancel(ctx context.Context, params *WorkflowCancelRequest) (*WorkflowRunResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["requestId"] = params.RequestID - req["response"] = params.Response + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.ui.handlePendingAutoModeSwitch", req) + raw, err := a.client.Request(ctx, "session.workflow.cancel", req) if err != nil { return nil, err } - var result UIHandlePendingResult + var result WorkflowRunResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingElicitation provides the user response for a pending elicitation request. +// GetRun gets the current or settled envelope for a dynamic workflow run. // -// RPC method: session.ui.handlePendingElicitation. +// RPC method: session.workflow.getRun. // -// Parameters: Pending elicitation request ID and the user's response (accept/decline/cancel -// + form values). +// Parameters: Parameters for retrieving a workflow run. // -// Returns: Indicates whether the elicitation response was accepted; false if it was already -// resolved by another client. -func (a *UIAPI) HandlePendingElicitation(ctx context.Context, params *UIHandlePendingElicitationRequest) (*UIElicitationResult, error) { +// Returns: Complete current or terminal workflow run envelope. +func (a *WorkflowAPI) GetRun(ctx context.Context, params *WorkflowGetRunRequest) (*WorkflowRunResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["requestId"] = params.RequestID - req["result"] = params.Result + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.ui.handlePendingElicitation", req) + raw, err := a.client.Request(ctx, "session.workflow.getRun", req) if err != nil { return nil, err } - var result UIElicitationResult + var result WorkflowRunResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingExitPlanMode resolves a pending `exit_plan_mode.requested` event with the -// user's response. +// GetRunDetail gets durable and live observability detail for one dynamic workflow run. // -// RPC method: session.ui.handlePendingExitPlanMode. +// RPC method: session.workflow.getRunDetail. // -// Parameters: Request ID of a pending `exit_plan_mode.requested` event and the user's -// response. +// Parameters: Parameters for retrieving a workflow run. // -// Returns: Indicates whether the pending UI request was resolved by this call. -func (a *UIAPI) HandlePendingExitPlanMode(ctx context.Context, params *UIHandlePendingExitPlanModeRequest) (*UIHandlePendingResult, error) { +// Returns: Full workflow run observability detail. +func (a *WorkflowAPI) GetRunDetail(ctx context.Context, params *WorkflowGetRunRequest) (*WorkflowRunDetail, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["requestId"] = params.RequestID - req["response"] = params.Response + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.ui.handlePendingExitPlanMode", req) + raw, err := a.client.Request(ctx, "session.workflow.getRunDetail", req) if err != nil { return nil, err } - var result UIHandlePendingResult + var result WorkflowRunDetail if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingSampling resolves a pending `sampling.requested` event with a sampling -// result, or rejects it. +// GetRunProgress pages durable progress for one dynamic workflow run. // -// RPC method: session.ui.handlePendingSampling. +// RPC method: session.workflow.getRunProgress. // -// Parameters: Request ID of a pending `sampling.requested` event and an optional sampling -// result payload (omit to reject). +// Parameters: Parameters for paging workflow progress. // -// Returns: Indicates whether the pending UI request was resolved by this call. -func (a *UIAPI) HandlePendingSampling(ctx context.Context, params *UIHandlePendingSamplingRequest) (*UIHandlePendingResult, error) { +// Returns: A bidirectional page of workflow progress. +func (a *WorkflowAPI) GetRunProgress(ctx context.Context, params *WorkflowGetRunProgressRequest) (*WorkflowProgressPage, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["requestId"] = params.RequestID - if params.Response != nil { - req["response"] = *params.Response + if params.AfterSeq != nil { + req["afterSeq"] = *params.AfterSeq + } + if params.BeforeSeq != nil { + req["beforeSeq"] = *params.BeforeSeq + } + if params.Limit != nil { + req["limit"] = *params.Limit } + if params.PhaseID != nil { + req["phaseId"] = *params.PhaseID + } + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.ui.handlePendingSampling", req) + raw, err := a.client.Request(ctx, "session.workflow.getRunProgress", req) if err != nil { return nil, err } - var result UIHandlePendingResult + var result WorkflowProgressPage if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingSessionLimitsExhausted resolves a pending -// `session_limits_exhausted.requested` event with the user's selected limit action. +// ListRuns lists durable dynamic workflow runs for this session in creation order. // -// RPC method: session.ui.handlePendingSessionLimitsExhausted. +// RPC method: session.workflow.listRuns. // -// Parameters: Request ID of a pending `session_limits_exhausted.requested` event and the -// user's selected limit action. +// Parameters: Parameters for paging workflow runs. // -// Returns: Indicates whether the pending UI request was resolved by this call. -func (a *UIAPI) HandlePendingSessionLimitsExhausted(ctx context.Context, params *UIHandlePendingSessionLimitsExhaustedRequest) (*UIHandlePendingResult, error) { +// Returns: A page of workflow runs in durable creation order. +func (a *WorkflowAPI) ListRuns(ctx context.Context, params *WorkflowListRunsRequest) (*WorkflowListRunsResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["requestId"] = params.RequestID - req["response"] = params.Response + if params.AfterSeq != nil { + req["afterSeq"] = *params.AfterSeq + } + if params.BeforeSeq != nil { + req["beforeSeq"] = *params.BeforeSeq + } + if params.Limit != nil { + req["limit"] = *params.Limit + } } - raw, err := a.client.Request(ctx, "session.ui.handlePendingSessionLimitsExhausted", req) + raw, err := a.client.Request(ctx, "session.workflow.listRuns", req) if err != nil { return nil, err } - var result UIHandlePendingResult + var result WorkflowListRunsResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// HandlePendingUserInput resolves a pending `user_input.requested` event with the user's -// response. +// Log records a batch of ordered dynamic workflow progress lines. // -// RPC method: session.ui.handlePendingUserInput. +// RPC method: session.workflow.log. // -// Parameters: Request ID of a pending `user_input.requested` event and the user's response. +// Parameters: Parameters for recording workflow progress. // -// Returns: Indicates whether the pending UI request was resolved by this call. -func (a *UIAPI) HandlePendingUserInput(ctx context.Context, params *UIHandlePendingUserInputRequest) (*UIHandlePendingResult, error) { +// Returns: Acknowledgement that a workflow request was accepted. +func (a *WorkflowAPI) Log(ctx context.Context, params *WorkflowLogRequest) (*WorkflowAckResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["requestId"] = params.RequestID - req["response"] = params.Response + req["executionToken"] = params.ExecutionToken + req["lines"] = params.Lines + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.ui.handlePendingUserInput", req) + raw, err := a.client.Request(ctx, "session.workflow.log", req) if err != nil { return nil, err } - var result UIHandlePendingResult + var result WorkflowAckResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// RegisterDirectAutoModeSwitchHandler registers an in-process handler for auto-mode-switch -// requests so the server bridge skips dispatch. +// Pauses a running dynamic workflow and returns its settled run envelope. // -// RPC method: session.ui.registerDirectAutoModeSwitchHandler. +// RPC method: session.workflow.pause. // -// Returns: Register an in-process handler for `auto_mode_switch.requested` events. The -// caller still attaches the actual listener via the standard event-subscription mechanism; -// this registration solely tells the server bridge to skip its own dispatch (so a remote -// client doesn't race the in-process handler for the same requestId). -func (a *UIAPI) RegisterDirectAutoModeSwitchHandler(ctx context.Context) (*UIRegisterDirectAutoModeSwitchHandlerResult, error) { +// Parameters: Parameters for pausing a running workflow. +// +// Returns: Complete current or terminal workflow run envelope. +func (a *WorkflowAPI) Pause(ctx context.Context, params *WorkflowPauseRequest) (*WorkflowRunResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.ui.registerDirectAutoModeSwitchHandler", req) + if params != nil { + req["runId"] = params.RunID + } + raw, err := a.client.Request(ctx, "session.workflow.pause", req) if err != nil { return nil, err } - var result UIRegisterDirectAutoModeSwitchHandlerResult + var result WorkflowRunResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// UnregisterDirectAutoModeSwitchHandler unregisters a previously-registered in-process -// auto-mode-switch handler by its opaque handle. +// Resumes a dynamic workflow run using its persisted name, arguments, journal, and +// accounting. // -// RPC method: session.ui.unregisterDirectAutoModeSwitchHandler. +// RPC method: session.workflow.resume. // -// Parameters: Opaque handle previously returned by `registerDirectAutoModeSwitchHandler` to -// release. +// Parameters: Parameters for resuming a workflow run from its persisted identity. // -// Returns: Indicates whether the handle was active and the registration count was -// decremented. -func (a *UIAPI) UnregisterDirectAutoModeSwitchHandler(ctx context.Context, params *UIUnregisterDirectAutoModeSwitchHandlerRequest) (*UIUnregisterDirectAutoModeSwitchHandlerResult, error) { +// Returns: Resolved persisted workflow identity and resumed run envelope. +func (a *WorkflowAPI) Resume(ctx context.Context, params *WorkflowResumeRequest) (*WorkflowResumeResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["handle"] = params.Handle + if params.Limits != nil { + req["limits"] = *params.Limits + } + if params.LogPhaseNames != nil { + req["logPhaseNames"] = *params.LogPhaseNames + } + if params.NotifyOnComplete != nil { + req["notifyOnComplete"] = *params.NotifyOnComplete + } + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.ui.unregisterDirectAutoModeSwitchHandler", req) + raw, err := a.client.Request(ctx, "session.workflow.resume", req) if err != nil { return nil, err } - var result UIUnregisterDirectAutoModeSwitchHandlerResult + var result WorkflowResumeResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: UsageAPI contains experimental APIs that may change or be removed. -type UsageAPI sessionAPI - -// GetMetrics gets accumulated usage metrics for the session. +// Runs a registered dynamic workflow by name at the top level. // -// RPC method: session.usage.getMetrics. +// RPC method: session.workflow.run. // -// Returns: Accumulated session usage metrics, including premium request cost, token counts, -// model breakdown, and code-change totals. -func (a *UsageAPI) GetMetrics(ctx context.Context) (*UsageGetMetricsResult, error) { +// Parameters: Parameters for invoking a registered workflow. +// +// Returns: Complete current or terminal workflow run envelope. +func (a *WorkflowAPI) Run(ctx context.Context, params *WorkflowRunRequest) (*WorkflowRunResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.usage.getMetrics", req) + if params != nil { + req["args"] = params.Args + req["name"] = params.Name + if params.Options != nil { + req["options"] = *params.Options + } + } + raw, err := a.client.Request(ctx, "session.workflow.run", req) if err != nil { return nil, err } - var result UsageGetMetricsResult + var result WorkflowRunResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Experimental: VisibilityAPI contains experimental APIs that may change or be removed. -type VisibilityAPI sessionAPI +// Experimental: WorkflowJournalAPI contains experimental APIs that may change or be removed. +type WorkflowJournalAPI sessionAPI -// Get returns the session's current Mission Control sharing status and shareable GitHub -// URL. Reflects whether the synced session is visible to repository readers ("repo") or -// restricted to its creator and collaborators ("unshared"). +// Get reads a memoized dynamic workflow journal entry. // -// RPC method: session.visibility.get. +// RPC method: session.workflow.journal.get. // -// Returns: Current sharing status and shareable GitHub URL for a session. -func (a *VisibilityAPI) Get(ctx context.Context) (*VisibilityGetResult, error) { +// Parameters: Parameters for reading a workflow journal entry. +// +// Returns: Result of reading a workflow journal entry. +func (a *WorkflowJournalAPI) Get(ctx context.Context, params *WorkflowJournalGetRequest) (*WorkflowJournalGetResult, error) { req := map[string]any{"sessionId": a.sessionID} - raw, err := a.client.Request(ctx, "session.visibility.get", req) + if params != nil { + req["executionToken"] = params.ExecutionToken + req["key"] = params.Key + req["runId"] = params.RunID + } + raw, err := a.client.Request(ctx, "session.workflow.journal.get", req) if err != nil { return nil, err } - var result VisibilityGetResult + var result WorkflowJournalGetResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } -// Sets the session's Mission Control sharing status, controlling whether the synced session -// is visible to repository readers. Returns the effective status and shareable GitHub URL -// after the change. +// Put stores a memoized dynamic workflow journal entry. // -// RPC method: session.visibility.set. +// RPC method: session.workflow.journal.put. // -// Parameters: Desired sharing status for the session. +// Parameters: Parameters for storing a workflow journal entry. // -// Returns: Effective sharing status and shareable GitHub URL after updating session -// visibility. -func (a *VisibilityAPI) Set(ctx context.Context, params *VisibilitySetRequest) (*VisibilitySetResult, error) { +// Returns: Acknowledgement that a workflow request was accepted. +func (a *WorkflowJournalAPI) Put(ctx context.Context, params *WorkflowJournalPutRequest) (*WorkflowAckResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { - req["status"] = params.Status + req["executionToken"] = params.ExecutionToken + req["key"] = params.Key + req["resultJson"] = params.ResultJSON + req["runId"] = params.RunID } - raw, err := a.client.Request(ctx, "session.visibility.set", req) + raw, err := a.client.Request(ctx, "session.workflow.journal.put", req) if err != nil { return nil, err } - var result VisibilitySetResult + var result WorkflowAckResult if err := json.Unmarshal(raw, &result); err != nil { return nil, err } return &result, nil } +// Experimental: Journal returns experimental APIs that may change or be removed. +func (s *WorkflowAPI) Journal() *WorkflowJournalAPI { + return (*WorkflowJournalAPI)(s) +} + // Experimental: WorkspacesAPI contains experimental APIs that may change or be removed. type WorkspacesAPI sessionAPI @@ -28950,6 +31402,7 @@ type SessionRPC struct { Instructions *InstructionsAPI LimitPrediction *LimitPredictionAPI Lsp *LspAPI + ManagedSettings *ManagedSettingsAPI MCP *MCPAPI Metadata *MetadataAPI Mode *ModeAPI @@ -28972,6 +31425,7 @@ type SessionRPC struct { UI *UIAPI Usage *UsageAPI Visibility *VisibilityAPI + Workflow *WorkflowAPI Workspaces *WorkspacesAPI } @@ -29282,6 +31736,7 @@ func NewSessionRPC(client *jsonrpc2.Client, sessionID string) *SessionRPC { r.Instructions = (*InstructionsAPI)(&r.common) r.LimitPrediction = (*LimitPredictionAPI)(&r.common) r.Lsp = (*LspAPI)(&r.common) + r.ManagedSettings = (*ManagedSettingsAPI)(&r.common) r.MCP = (*MCPAPI)(&r.common) r.Metadata = (*MetadataAPI)(&r.common) r.Mode = (*ModeAPI)(&r.common) @@ -29304,6 +31759,7 @@ func NewSessionRPC(client *jsonrpc2.Client, sessionID string) *SessionRPC { r.UI = (*UIAPI)(&r.common) r.Usage = (*UsageAPI)(&r.common) r.Visibility = (*VisibilityAPI)(&r.common) + r.Workflow = (*WorkflowAPI)(&r.common) r.Workspaces = (*WorkspacesAPI)(&r.common) return r } @@ -29815,6 +32271,9 @@ type InternalModelAPI internalSessionAPI func (a *InternalModelAPI) ApplyStartupOverlay(ctx context.Context, params *ModelApplyStartupOverlayRequest) (*ModelSwitchToResult, error) { req := map[string]any{"sessionId": a.sessionID} if params != nil { + if params.AutoTier != nil { + req["autoTier"] = *params.AutoTier + } if params.CLIModel != nil { req["cliModel"] = *params.CLIModel } @@ -30293,6 +32752,99 @@ func (a *InternalSettingsAPI) Snapshot(ctx context.Context) (*SessionSettingsSna return &result, nil } +// Experimental: InternalWorkflowAPI contains experimental APIs that may change or be +// removed. +type InternalWorkflowAPI internalSessionAPI + +// PauseAtCheckpoint atomically pauses an owned dynamic workflow attempt at a durable +// checkpoint. +// +// RPC method: session.workflow.pauseAtCheckpoint. +// +// Parameters: Parameters for an owned durable pause checkpoint. +// Internal: PauseAtCheckpoint is part of the SDK's internal handshake/plumbing; external +// callers should not use it. +func (a *InternalWorkflowAPI) PauseAtCheckpoint(ctx context.Context, params *WorkflowPauseCheckpointRequest) (*SessionWorkflowPauseAtCheckpointResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["executionToken"] = params.ExecutionToken + req["key"] = params.Key + req["runId"] = params.RunID + } + raw, err := a.client.Request(ctx, "session.workflow.pauseAtCheckpoint", req) + if err != nil { + return nil, err + } + var result SessionWorkflowPauseAtCheckpointResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// ResumeFromTool internal tool-originated dynamic workflow resume. +// +// RPC method: session.workflow.resumeFromTool. +// +// Parameters: Internal parameters for resuming a workflow run from a tool. +// +// Returns: Resolved persisted workflow identity and resumed run envelope. +// Internal: ResumeFromTool is part of the SDK's internal handshake/plumbing; external +// callers should not use it. +func (a *InternalWorkflowAPI) ResumeFromTool(ctx context.Context, params *WorkflowToolResumeRequest) (*WorkflowResumeResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + if params.Limits != nil { + req["limits"] = *params.Limits + } + req["runId"] = params.RunID + if params.ToolCallID != nil { + req["toolCallId"] = *params.ToolCallID + } + } + raw, err := a.client.Request(ctx, "session.workflow.resumeFromTool", req) + if err != nil { + return nil, err + } + var result WorkflowResumeResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + +// RunFromTool internal tool-originated dynamic workflow invocation. +// +// RPC method: session.workflow.runFromTool. +// +// Parameters: Internal parameters for invoking a registered workflow from a tool. +// +// Returns: Complete current or terminal workflow run envelope. +// Internal: RunFromTool is part of the SDK's internal handshake/plumbing; external callers +// should not use it. +func (a *InternalWorkflowAPI) RunFromTool(ctx context.Context, params *WorkflowToolRunRequest) (*WorkflowRunResult, error) { + req := map[string]any{"sessionId": a.sessionID} + if params != nil { + req["args"] = params.Args + req["name"] = params.Name + if params.Options != nil { + req["options"] = *params.Options + } + if params.ToolCallID != nil { + req["toolCallId"] = *params.ToolCallID + } + } + raw, err := a.client.Request(ctx, "session.workflow.runFromTool", req) + if err != nil { + return nil, err + } + var result WorkflowRunResult + if err := json.Unmarshal(raw, &result); err != nil { + return nil, err + } + return &result, nil +} + // InternalSessionRPC provides internal SDK session-scoped RPC methods (handshake helpers // etc.). Not part of the public API. type InternalSessionRPC struct { @@ -30308,6 +32860,7 @@ type InternalSessionRPC struct { Queue *InternalQueueAPI Schedule *InternalScheduleAPI Settings *InternalSettingsAPI + Workflow *InternalWorkflowAPI } // SendSystemNotification queues or sends an internal system notification to the session @@ -30354,6 +32907,7 @@ func NewInternalSessionRPC(client *jsonrpc2.Client, sessionID string) *InternalS r.Queue = (*InternalQueueAPI)(&r.common) r.Schedule = (*InternalScheduleAPI)(&r.common) r.Settings = (*InternalSettingsAPI)(&r.common) + r.Workflow = (*InternalWorkflowAPI)(&r.common) return r } @@ -30568,6 +33122,27 @@ type TasksHandler interface { Cancel(request *ClientTaskCancelRequest) (*ClientTaskCancelResult, error) } +// Experimental: WorkflowHandler contains experimental APIs that may change or be removed. +type WorkflowHandler interface { + // Abort asks the owning extension connection to abort a running dynamic workflow + // cooperatively. + // + // RPC method: workflow.abort. + // + // Parameters: Parameters for cooperatively aborting a workflow body. + // + // Returns: Acknowledgement that a workflow request was accepted. + Abort(request *WorkflowAbortRequest) (*WorkflowAckResult, error) + // Execute asks the owning extension connection to execute a registered dynamic workflow. + // + // RPC method: workflow.execute. + // + // Parameters: Parameters sent to the owning extension to execute a workflow closure. + // + // Returns: Result returned by an extension workflow closure. + Execute(request *WorkflowExecuteRequest) (*WorkflowExecuteResult, error) +} + // ClientSessionAPIHandlers provides all client session API handler groups for a session. type ClientSessionAPIHandlers struct { Canvas CanvasHandler @@ -30575,6 +33150,7 @@ type ClientSessionAPIHandlers struct { ProviderToken ProviderTokenHandler SessionFS SessionFSHandler Tasks TasksHandler + Workflow WorkflowHandler } func clientSessionHandlerError(err error) *jsonrpc2.Error { @@ -30971,6 +33547,44 @@ func RegisterClientSessionAPIHandlers(client *jsonrpc2.Client, getHandlers func( } return raw, nil }) + client.SetRequestHandler("workflow.abort", func(params json.RawMessage) (json.RawMessage, *jsonrpc2.Error) { + var request WorkflowAbortRequest + if err := json.Unmarshal(params, &request); err != nil { + return nil, &jsonrpc2.Error{Code: -32602, Message: fmt.Sprintf("Invalid params: %v", err)} + } + handlers := getHandlers(request.SessionID) + if handlers == nil || handlers.Workflow == nil { + return nil, &jsonrpc2.Error{Code: -32603, Message: fmt.Sprintf("No workflow handler registered for session: %s", request.SessionID)} + } + result, err := handlers.Workflow.Abort(&request) + if err != nil { + return nil, clientSessionHandlerError(err) + } + raw, err := json.Marshal(result) + if err != nil { + return nil, &jsonrpc2.Error{Code: -32603, Message: fmt.Sprintf("Failed to marshal response: %v", err)} + } + return raw, nil + }) + client.SetRequestHandler("workflow.execute", func(params json.RawMessage) (json.RawMessage, *jsonrpc2.Error) { + var request WorkflowExecuteRequest + if err := json.Unmarshal(params, &request); err != nil { + return nil, &jsonrpc2.Error{Code: -32602, Message: fmt.Sprintf("Invalid params: %v", err)} + } + handlers := getHandlers(request.SessionID) + if handlers == nil || handlers.Workflow == nil { + return nil, &jsonrpc2.Error{Code: -32603, Message: fmt.Sprintf("No workflow handler registered for session: %s", request.SessionID)} + } + result, err := handlers.Workflow.Execute(&request) + if err != nil { + return nil, clientSessionHandlerError(err) + } + raw, err := json.Marshal(result) + if err != nil { + return nil, &jsonrpc2.Error{Code: -32603, Message: fmt.Sprintf("Failed to marshal response: %v", err)} + } + return raw, nil + }) } // Experimental: ExtensionLaunchProviderHandler contains experimental APIs that may change diff --git a/go/rpc/zrpc_encoding.go b/go/rpc/zrpc_encoding.go index d18b2c09e7..0fdf8519fe 100644 --- a/go/rpc/zrpc_encoding.go +++ b/go/rpc/zrpc_encoding.go @@ -696,85 +696,28 @@ func unmarshalCatalogCandidate(data []byte) (CatalogCandidate, error) { return nil, err } return &d, nil - default: - return &RawCatalogCandidateData{Discriminator: raw.Kind, Raw: data}, nil - } -} - -func (r RawCatalogCandidateData) MarshalJSON() ([]byte, error) { - if r.Raw != nil { - return r.Raw, nil - } - return json.Marshal(struct { - Kind CatalogCandidateKind `json:"kind"` - }{ - Kind: r.Discriminator, - }) -} - -func unmarshalCatalogCandidateSource(data []byte) (CatalogCandidateSource, error) { - if string(data) == "null" { - return nil, nil - } - type rawUnion struct { - Kind CatalogCandidateSourceKind `json:"kind"` - } - var raw rawUnion - if err := json.Unmarshal(data, &raw); err != nil { - return nil, err - } - - switch raw.Kind { - case CatalogCandidateSourceKindEmbedded: - var d CatalogCandidateSourceEmbedded - if err := json.Unmarshal(data, &d); err != nil { - return nil, err - } - return &d, nil - case CatalogCandidateSourceKindURL: - var d CatalogCandidateSourceURL + case CatalogCandidateKindPlugin: + var d CatalogAgentPluginCandidate if err := json.Unmarshal(data, &d); err != nil { return nil, err } return &d, nil default: - return &RawCatalogCandidateSourceData{Discriminator: raw.Kind, Raw: data}, nil + return &RawCatalogCandidateData{Discriminator: raw.Kind, Raw: data}, nil } } -func (r RawCatalogCandidateSourceData) MarshalJSON() ([]byte, error) { +func (r RawCatalogCandidateData) MarshalJSON() ([]byte, error) { if r.Raw != nil { return r.Raw, nil } return json.Marshal(struct { - Kind CatalogCandidateSourceKind `json:"kind"` + Kind CatalogCandidateKind `json:"kind"` }{ Kind: r.Discriminator, }) } -func (r CatalogCandidateSourceEmbedded) MarshalJSON() ([]byte, error) { - type alias CatalogCandidateSourceEmbedded - return json.Marshal(struct { - Kind CatalogCandidateSourceKind `json:"kind"` - alias - }{ - Kind: r.Kind(), - alias: alias(r), - }) -} - -func (r CatalogCandidateSourceURL) MarshalJSON() ([]byte, error) { - type alias CatalogCandidateSourceURL - return json.Marshal(struct { - Kind CatalogCandidateSourceKind `json:"kind"` - alias - }{ - Kind: r.Kind(), - alias: alias(r), - }) -} - func matchesCatalogTrustSnapshotAbsent(data []byte) bool { var rawGroup0 struct { Status json.RawMessage `json:"status"` @@ -1105,18 +1048,128 @@ func (r CatalogTrustSnapshotUnsupported) MarshalJSON() ([]byte, error) { }) } +func (r *CatalogAgentPluginCandidate) UnmarshalJSON(data []byte) error { + type rawCatalogAgentPluginCandidate struct { + CompatibilityTags []CatalogAgentPluginCompatibilityTag `json:"compatibilityTags"` + Description *string `json:"description,omitempty"` + DisplayName string `json:"displayName"` + Identity string `json:"identity"` + MediaType CatalogAgentPluginMediaType `json:"mediaType"` + Provenance CatalogAgentPluginCandidateProvenance `json:"provenance"` + Publisher *string `json:"publisher,omitempty"` + Source CatalogPluginRepositorySource `json:"source"` + Trust json.RawMessage `json:"trust,omitempty"` + Version *string `json:"version,omitempty"` + } + var raw rawCatalogAgentPluginCandidate + if err := json.Unmarshal(data, &raw); err != nil { + return err + } + r.CompatibilityTags = raw.CompatibilityTags + r.Description = raw.Description + r.DisplayName = raw.DisplayName + r.Identity = raw.Identity + r.MediaType = raw.MediaType + r.Provenance = raw.Provenance + r.Publisher = raw.Publisher + r.Source = raw.Source + if raw.Trust != nil { + value, err := unmarshalCatalogTrustSnapshot(raw.Trust) + if err != nil { + return err + } + r.Trust = value + } + r.Version = raw.Version + return nil +} + +func (r CatalogAgentPluginCandidate) MarshalJSON() ([]byte, error) { + type alias CatalogAgentPluginCandidate + return json.Marshal(struct { + Kind CatalogCandidateKind `json:"kind"` + alias + }{ + Kind: r.Kind(), + alias: alias(r), + }) +} + +func unmarshalCatalogCandidateSource(data []byte) (CatalogCandidateSource, error) { + if string(data) == "null" { + return nil, nil + } + type rawUnion struct { + Kind CatalogCandidateSourceKind `json:"kind"` + } + var raw rawUnion + if err := json.Unmarshal(data, &raw); err != nil { + return nil, err + } + + switch raw.Kind { + case CatalogCandidateSourceKindEmbedded: + var d CatalogCandidateSourceEmbedded + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogCandidateSourceKindURL: + var d CatalogCandidateSourceURL + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + default: + return &RawCatalogCandidateSourceData{Discriminator: raw.Kind, Raw: data}, nil + } +} + +func (r RawCatalogCandidateSourceData) MarshalJSON() ([]byte, error) { + if r.Raw != nil { + return r.Raw, nil + } + return json.Marshal(struct { + Kind CatalogCandidateSourceKind `json:"kind"` + }{ + Kind: r.Discriminator, + }) +} + +func (r CatalogCandidateSourceEmbedded) MarshalJSON() ([]byte, error) { + type alias CatalogCandidateSourceEmbedded + return json.Marshal(struct { + Kind CatalogCandidateSourceKind `json:"kind"` + alias + }{ + Kind: r.Kind(), + alias: alias(r), + }) +} + +func (r CatalogCandidateSourceURL) MarshalJSON() ([]byte, error) { + type alias CatalogCandidateSourceURL + return json.Marshal(struct { + Kind CatalogCandidateSourceKind `json:"kind"` + alias + }{ + Kind: r.Kind(), + alias: alias(r), + }) +} + func (r *CatalogAiSkillCandidate) UnmarshalJSON(data []byte) error { type rawCatalogAiSkillCandidate struct { - Description *string `json:"description,omitempty"` - DisplayName string `json:"displayName"` - Handle string `json:"handle"` - HandleExpiresAt string `json:"handleExpiresAt"` - Installability CatalogAiSkillCandidateInstallability `json:"installability"` - MediaType CatalogAiSkillCandidateMediaType `json:"mediaType"` - Provenance CatalogAiSkillCandidateProvenance `json:"provenance"` - Publisher *string `json:"publisher,omitempty"` - Source json.RawMessage `json:"source"` - Trust json.RawMessage `json:"trust,omitempty"` + Description *string `json:"description,omitempty"` + DisplayName string `json:"displayName"` + Handle string `json:"handle"` + HandleExpiresAt string `json:"handleExpiresAt"` + Installability CatalogAiSkillInstallability `json:"installability"` + MediaType CatalogAiSkillMediaType `json:"mediaType"` + Provenance CatalogAiSkillCandidateProvenance `json:"provenance"` + Publisher *string `json:"publisher,omitempty"` + Source json.RawMessage `json:"source"` + Trust json.RawMessage `json:"trust,omitempty"` } var raw rawCatalogAiSkillCandidate if err := json.Unmarshal(data, &raw); err != nil { @@ -1387,6 +1440,7 @@ func (r *CatalogSearchSucceeded) UnmarshalJSON(data []byte) error { type rawCatalogSearchSucceeded struct { Candidates []json.RawMessage `json:"candidates"` Negotiated CatalogNegotiatedContract `json:"negotiated"` + Pagination *CatalogSearchPagination `json:"pagination,omitempty"` SearchID string `json:"searchId"` Truncated bool `json:"truncated"` } @@ -1405,6 +1459,7 @@ func (r *CatalogSearchSucceeded) UnmarshalJSON(data []byte) error { } } r.Negotiated = raw.Negotiated + r.Pagination = raw.Pagination r.SearchID = raw.SearchID r.Truncated = raw.Truncated return nil @@ -1454,6 +1509,206 @@ func (r CatalogUnsupportedKindError) MarshalJSON() ([]byte, error) { }) } +func unmarshalCatalogSelectionResult(data []byte) (CatalogSelectionResult, error) { + if string(data) == "null" { + return nil, nil + } + type rawUnion struct { + Kind CatalogSelectionResultKind `json:"kind"` + } + var raw rawUnion + if err := json.Unmarshal(data, &raw); err != nil { + return nil, err + } + + switch raw.Kind { + case CatalogSelectionResultKindCancelled: + var d CatalogSelectionCancelled + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindDeclined: + var d CatalogSelectionDeclined + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindForeign: + var d CatalogSelectionForeign + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindInvalid: + var d CatalogSelectionInvalid + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindInvalidRequest: + var d CatalogInvalidRequestError + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindNegotiationRefused: + var d CatalogNegotiationRefusedError + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindReplayed: + var d CatalogSelectionReplayed + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindSelected: + var d CatalogSelectionSelected + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindStale: + var d CatalogSelectionStale + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindTimedOut: + var d CatalogSelectionTimedOut + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindUnavailable: + var d CatalogUnavailableError + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case CatalogSelectionResultKindWrongKind: + var d CatalogSelectionWrongKind + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + default: + return &RawCatalogSelectionResultData{Discriminator: raw.Kind, Raw: data}, nil + } +} + +func (r RawCatalogSelectionResultData) MarshalJSON() ([]byte, error) { + if r.Raw != nil { + return r.Raw, nil + } + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + }{ + Kind: r.Discriminator, + }) +} + +func (r CatalogSelectionCancelled) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionCancelled + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + +func (r CatalogSelectionDeclined) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionDeclined + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + +func (r CatalogSelectionForeign) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionForeign + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + +func (r CatalogSelectionInvalid) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionInvalid + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + +func (r CatalogSelectionReplayed) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionReplayed + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + +func (r CatalogSelectionSelected) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionSelected + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + +func (r CatalogSelectionStale) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionStale + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + +func (r CatalogSelectionTimedOut) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionTimedOut + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + +func (r CatalogSelectionWrongKind) MarshalJSON() ([]byte, error) { + type alias CatalogSelectionWrongKind + return json.Marshal(struct { + Kind CatalogSelectionResultKind `json:"kind"` + alias + }{ + Kind: r.catalogSelectionResultKind(), + alias: alias(r), + }) +} + func unmarshalQueuedCommandResult(data []byte) (QueuedCommandResult, error) { if string(data) == "null" { return nil, nil @@ -2449,33 +2704,34 @@ func unmarshalMCPSafeForTelemetry(data []byte) (MCPSafeForTelemetry, error) { func (r *MCPServerConfigHTTP) UnmarshalJSON(data []byte) error { type rawMCPServerConfigHTTP struct { - Auth json.RawMessage `json:"auth,omitempty"` - ConfigWarnings []string `json:"configWarnings,omitzero"` - DeferTools *MCPServerConfigDeferTools `json:"deferTools,omitempty"` - DisableSecretMasking *bool `json:"disableSecretMasking,omitempty"` - DisableToolCache *bool `json:"disableToolCache,omitempty"` - DisplayName *string `json:"displayName,omitempty"` - Events []string `json:"events,omitzero"` - ExcludeTools []string `json:"excludeTools,omitzero"` - FilterMapping json.RawMessage `json:"filterMapping,omitempty"` - Headers map[string]string `json:"headers,omitzero"` - HeadersRefreshTtlMs *int64 `json:"headersRefreshTtlMs,omitempty"` - IsDefaultServer *bool `json:"isDefaultServer,omitempty"` - Notifications []string `json:"notifications,omitzero"` - OauthClientID *string `json:"oauthClientId,omitempty"` - OauthGrantType *MCPServerConfigHTTPOauthGrantType `json:"oauthGrantType,omitempty"` - OauthPublicClient *bool `json:"oauthPublicClient,omitempty"` - Oidc json.RawMessage `json:"oidc,omitempty"` - SafeForTelemetry json.RawMessage `json:"safeForTelemetry,omitempty"` - Source *MCPServerSource `json:"source,omitempty"` - SourcePath *string `json:"sourcePath,omitempty"` - SourcePlugin *string `json:"sourcePlugin,omitempty"` - SourcePluginSpec *bool `json:"sourcePluginSpec,omitempty"` - SourcePluginVersion *string `json:"sourcePluginVersion,omitempty"` - Timeout *int64 `json:"timeout,omitempty"` - Tools []string `json:"tools,omitzero"` - Type *MCPServerConfigHTTPType `json:"type,omitempty"` - URL string `json:"url"` + Auth json.RawMessage `json:"auth,omitempty"` + ConfigWarnings []string `json:"configWarnings,omitzero"` + DeferTools *MCPServerConfigDeferTools `json:"deferTools,omitempty"` + DisableSecretMasking *bool `json:"disableSecretMasking,omitempty"` + DisableToolCache *bool `json:"disableToolCache,omitempty"` + DisplayName *string `json:"displayName,omitempty"` + Events []string `json:"events,omitzero"` + ExcludeTools []string `json:"excludeTools,omitzero"` + FilterMapping json.RawMessage `json:"filterMapping,omitempty"` + Headers map[string]string `json:"headers,omitzero"` + HeadersRefreshTtlMs *int64 `json:"headersRefreshTtlMs,omitempty"` + IsDefaultServer *bool `json:"isDefaultServer,omitempty"` + Notifications []string `json:"notifications,omitzero"` + OauthClientID *string `json:"oauthClientId,omitempty"` + OauthGrantType *MCPServerConfigHTTPOauthGrantType `json:"oauthGrantType,omitempty"` + OauthPublicClient *bool `json:"oauthPublicClient,omitempty"` + Oidc json.RawMessage `json:"oidc,omitempty"` + SafeForTelemetry json.RawMessage `json:"safeForTelemetry,omitempty"` + SlowConnectionThresholdMs *int64 `json:"slowConnectionThresholdMs,omitempty"` + Source *MCPServerSource `json:"source,omitempty"` + SourcePath *string `json:"sourcePath,omitempty"` + SourcePlugin *string `json:"sourcePlugin,omitempty"` + SourcePluginSpec *bool `json:"sourcePluginSpec,omitempty"` + SourcePluginVersion *string `json:"sourcePluginVersion,omitempty"` + Timeout *int64 `json:"timeout,omitempty"` + Tools []string `json:"tools,omitzero"` + Type *MCPServerConfigHTTPType `json:"type,omitempty"` + URL string `json:"url"` } var raw rawMCPServerConfigHTTP if err := json.Unmarshal(data, &raw); err != nil { @@ -2523,6 +2779,7 @@ func (r *MCPServerConfigHTTP) UnmarshalJSON(data []byte) error { } r.SafeForTelemetry = value } + r.SlowConnectionThresholdMs = raw.SlowConnectionThresholdMs r.Source = raw.Source r.SourcePath = raw.SourcePath r.SourcePlugin = raw.SourcePlugin @@ -2537,31 +2794,32 @@ func (r *MCPServerConfigHTTP) UnmarshalJSON(data []byte) error { func (r *MCPServerConfigStdio) UnmarshalJSON(data []byte) error { type rawMCPServerConfigStdio struct { - Args []string `json:"args,omitzero"` - Auth json.RawMessage `json:"auth,omitempty"` - Command string `json:"command"` - ConfigWarnings []string `json:"configWarnings,omitzero"` - Cwd *string `json:"cwd,omitempty"` - DeferTools *MCPServerConfigDeferTools `json:"deferTools,omitempty"` - DisableSecretMasking *bool `json:"disableSecretMasking,omitempty"` - DisableToolCache *bool `json:"disableToolCache,omitempty"` - DisplayName *string `json:"displayName,omitempty"` - Env map[string]string `json:"env,omitzero"` - Events []string `json:"events,omitzero"` - ExcludeTools []string `json:"excludeTools,omitzero"` - FilterMapping json.RawMessage `json:"filterMapping,omitempty"` - IsDefaultServer *bool `json:"isDefaultServer,omitempty"` - Notifications []string `json:"notifications,omitzero"` - Oidc json.RawMessage `json:"oidc,omitempty"` - SafeForTelemetry json.RawMessage `json:"safeForTelemetry,omitempty"` - Source *MCPServerSource `json:"source,omitempty"` - SourcePath *string `json:"sourcePath,omitempty"` - SourcePlugin *string `json:"sourcePlugin,omitempty"` - SourcePluginSpec *bool `json:"sourcePluginSpec,omitempty"` - SourcePluginVersion *string `json:"sourcePluginVersion,omitempty"` - Timeout *int64 `json:"timeout,omitempty"` - Tools []string `json:"tools,omitzero"` - Type *MCPServerConfigStdioType `json:"type,omitempty"` + Args []string `json:"args,omitzero"` + Auth json.RawMessage `json:"auth,omitempty"` + Command string `json:"command"` + ConfigWarnings []string `json:"configWarnings,omitzero"` + Cwd *string `json:"cwd,omitempty"` + DeferTools *MCPServerConfigDeferTools `json:"deferTools,omitempty"` + DisableSecretMasking *bool `json:"disableSecretMasking,omitempty"` + DisableToolCache *bool `json:"disableToolCache,omitempty"` + DisplayName *string `json:"displayName,omitempty"` + Env map[string]string `json:"env,omitzero"` + Events []string `json:"events,omitzero"` + ExcludeTools []string `json:"excludeTools,omitzero"` + FilterMapping json.RawMessage `json:"filterMapping,omitempty"` + IsDefaultServer *bool `json:"isDefaultServer,omitempty"` + Notifications []string `json:"notifications,omitzero"` + Oidc json.RawMessage `json:"oidc,omitempty"` + SafeForTelemetry json.RawMessage `json:"safeForTelemetry,omitempty"` + SlowConnectionThresholdMs *int64 `json:"slowConnectionThresholdMs,omitempty"` + Source *MCPServerSource `json:"source,omitempty"` + SourcePath *string `json:"sourcePath,omitempty"` + SourcePlugin *string `json:"sourcePlugin,omitempty"` + SourcePluginSpec *bool `json:"sourcePluginSpec,omitempty"` + SourcePluginVersion *string `json:"sourcePluginVersion,omitempty"` + Timeout *int64 `json:"timeout,omitempty"` + Tools []string `json:"tools,omitzero"` + Type *MCPServerConfigStdioType `json:"type,omitempty"` } var raw rawMCPServerConfigStdio if err := json.Unmarshal(data, &raw); err != nil { @@ -2608,6 +2866,7 @@ func (r *MCPServerConfigStdio) UnmarshalJSON(data []byte) error { } r.SafeForTelemetry = value } + r.SlowConnectionThresholdMs = raw.SlowConnectionThresholdMs r.Source = raw.Source r.SourcePath = raw.SourcePath r.SourcePlugin = raw.SourcePlugin @@ -3630,27 +3889,28 @@ func (r RawMCPServerConfigData) MarshalJSON() ([]byte, error) { func (r *MCPServerConfigMemory) UnmarshalJSON(data []byte) error { type rawMCPServerConfigMemory struct { - ConfigWarnings []string `json:"configWarnings,omitzero"` - DeferTools *MCPServerConfigDeferTools `json:"deferTools,omitempty"` - DisableSecretMasking *bool `json:"disableSecretMasking,omitempty"` - DisableToolCache *bool `json:"disableToolCache,omitempty"` - DisplayName *string `json:"displayName,omitempty"` - Events []string `json:"events,omitzero"` - ExcludeTools []string `json:"excludeTools,omitzero"` - FilterMapping json.RawMessage `json:"filterMapping,omitempty"` - IsDefaultServer *bool `json:"isDefaultServer,omitempty"` - Notifications []string `json:"notifications,omitzero"` - Oidc json.RawMessage `json:"oidc,omitempty"` - SafeForTelemetry json.RawMessage `json:"safeForTelemetry,omitempty"` - ServerInstance any `json:"serverInstance"` - Source *MCPServerSource `json:"source,omitempty"` - SourcePath *string `json:"sourcePath,omitempty"` - SourcePlugin *string `json:"sourcePlugin,omitempty"` - SourcePluginSpec *bool `json:"sourcePluginSpec,omitempty"` - SourcePluginVersion *string `json:"sourcePluginVersion,omitempty"` - Timeout *int64 `json:"timeout,omitempty"` - Tools []string `json:"tools,omitzero"` - Type MCPServerConfigMemoryType `json:"type"` + ConfigWarnings []string `json:"configWarnings,omitzero"` + DeferTools *MCPServerConfigDeferTools `json:"deferTools,omitempty"` + DisableSecretMasking *bool `json:"disableSecretMasking,omitempty"` + DisableToolCache *bool `json:"disableToolCache,omitempty"` + DisplayName *string `json:"displayName,omitempty"` + Events []string `json:"events,omitzero"` + ExcludeTools []string `json:"excludeTools,omitzero"` + FilterMapping json.RawMessage `json:"filterMapping,omitempty"` + IsDefaultServer *bool `json:"isDefaultServer,omitempty"` + Notifications []string `json:"notifications,omitzero"` + Oidc json.RawMessage `json:"oidc,omitempty"` + SafeForTelemetry json.RawMessage `json:"safeForTelemetry,omitempty"` + ServerInstance any `json:"serverInstance"` + SlowConnectionThresholdMs *int64 `json:"slowConnectionThresholdMs,omitempty"` + Source *MCPServerSource `json:"source,omitempty"` + SourcePath *string `json:"sourcePath,omitempty"` + SourcePlugin *string `json:"sourcePlugin,omitempty"` + SourcePluginSpec *bool `json:"sourcePluginSpec,omitempty"` + SourcePluginVersion *string `json:"sourcePluginVersion,omitempty"` + Timeout *int64 `json:"timeout,omitempty"` + Tools []string `json:"tools,omitzero"` + Type MCPServerConfigMemoryType `json:"type"` } var raw rawMCPServerConfigMemory if err := json.Unmarshal(data, &raw); err != nil { @@ -3687,6 +3947,7 @@ func (r *MCPServerConfigMemory) UnmarshalJSON(data []byte) error { r.SafeForTelemetry = value } r.ServerInstance = raw.ServerInstance + r.SlowConnectionThresholdMs = raw.SlowConnectionThresholdMs r.Source = raw.Source r.SourcePath = raw.SourcePath r.SourcePlugin = raw.SourcePlugin @@ -5413,6 +5674,37 @@ func (r PushAttachmentSelection) MarshalJSON() ([]byte, error) { }) } +func (r *QueueAppendSteeringRequest) UnmarshalJSON(data []byte) error { + type rawQueueAppendSteeringRequest struct { + AgentMode SendAgentMode `json:"agentMode"` + Attachments []json.RawMessage `json:"attachments"` + DisplayPrompt string `json:"displayPrompt"` + ExpectedPrompt string `json:"expectedPrompt"` + MessageID string `json:"messageId"` + Prompt string `json:"prompt"` + } + var raw rawQueueAppendSteeringRequest + if err := json.Unmarshal(data, &raw); err != nil { + return err + } + r.AgentMode = raw.AgentMode + if raw.Attachments != nil { + r.Attachments = make([]Attachment, 0, len(raw.Attachments)) + for _, rawItem := range raw.Attachments { + value, err := unmarshalAttachment(rawItem) + if err != nil { + return err + } + r.Attachments = append(r.Attachments, value) + } + } + r.DisplayPrompt = raw.DisplayPrompt + r.ExpectedPrompt = raw.ExpectedPrompt + r.MessageID = raw.MessageID + r.Prompt = raw.Prompt + return nil +} + func (r *QueueInsertMessage) UnmarshalJSON(data []byte) error { type rawQueueInsertMessage struct { AgentMode *SendAgentMode `json:"agentMode,omitempty"` @@ -7405,3 +7697,252 @@ func (r *UIElicitationResponse) UnmarshalJSON(data []byte) error { r.Meta = raw.Meta return nil } + +func unmarshalWorkflowRunFailure(data []byte) (WorkflowRunFailure, error) { + if string(data) == "null" { + return nil, nil + } + type rawUnion struct { + Type WorkflowRunFailureType `json:"type"` + } + var raw rawUnion + if err := json.Unmarshal(data, &raw); err != nil { + return nil, err + } + + switch raw.Type { + case WorkflowRunFailureTypeWorkflowAccountingIncomplete: + var d WorkflowRunFailureWorkflowAccountingIncomplete + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case WorkflowRunFailureTypeWorkflowDurableFailure: + var d WorkflowRunFailureWorkflowDurableFailure + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case WorkflowRunFailureTypeWorkflowLimitReached: + var d WorkflowRunFailureWorkflowLimitReached + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case WorkflowRunFailureTypeWorkflowProviderDisconnected: + var d WorkflowRunFailureWorkflowProviderDisconnected + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case WorkflowRunFailureTypeWorkflowResumeDeclined: + var d WorkflowRunFailureWorkflowResumeDeclined + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + default: + return &RawWorkflowRunFailureData{Discriminator: raw.Type, Raw: data}, nil + } +} + +func (r RawWorkflowRunFailureData) MarshalJSON() ([]byte, error) { + if r.Raw != nil { + return r.Raw, nil + } + return json.Marshal(struct { + Type WorkflowRunFailureType `json:"type"` + }{ + Type: r.Discriminator, + }) +} + +func (r WorkflowRunFailureWorkflowAccountingIncomplete) MarshalJSON() ([]byte, error) { + type alias WorkflowRunFailureWorkflowAccountingIncomplete + return json.Marshal(struct { + Type WorkflowRunFailureType `json:"type"` + alias + }{ + Type: r.Type(), + alias: alias(r), + }) +} + +func (r WorkflowRunFailureWorkflowDurableFailure) MarshalJSON() ([]byte, error) { + type alias WorkflowRunFailureWorkflowDurableFailure + return json.Marshal(struct { + Type WorkflowRunFailureType `json:"type"` + alias + }{ + Type: r.Type(), + alias: alias(r), + }) +} + +func (r WorkflowRunFailureWorkflowLimitReached) MarshalJSON() ([]byte, error) { + type alias WorkflowRunFailureWorkflowLimitReached + return json.Marshal(struct { + Type WorkflowRunFailureType `json:"type"` + alias + }{ + Type: r.Type(), + alias: alias(r), + }) +} + +func (r WorkflowRunFailureWorkflowProviderDisconnected) MarshalJSON() ([]byte, error) { + type alias WorkflowRunFailureWorkflowProviderDisconnected + return json.Marshal(struct { + Type WorkflowRunFailureType `json:"type"` + alias + }{ + Type: r.Type(), + alias: alias(r), + }) +} + +func (r WorkflowRunFailureWorkflowResumeDeclined) MarshalJSON() ([]byte, error) { + type alias WorkflowRunFailureWorkflowResumeDeclined + return json.Marshal(struct { + Type WorkflowRunFailureType `json:"type"` + alias + }{ + Type: r.Type(), + alias: alias(r), + }) +} + +func unmarshalWorkflowPauseInfo(data []byte) (WorkflowPauseInfo, error) { + if string(data) == "null" { + return nil, nil + } + type rawUnion struct { + Type WorkflowPauseInfoType `json:"type"` + } + var raw rawUnion + if err := json.Unmarshal(data, &raw); err != nil { + return nil, err + } + + switch raw.Type { + case WorkflowPauseInfoTypeCheckpoint: + var d WorkflowPauseInfoCheckpoint + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + case WorkflowPauseInfoTypeUser: + var d WorkflowPauseInfoUser + if err := json.Unmarshal(data, &d); err != nil { + return nil, err + } + return &d, nil + default: + return &RawWorkflowPauseInfoData{Discriminator: raw.Type, Raw: data}, nil + } +} + +func (r RawWorkflowPauseInfoData) MarshalJSON() ([]byte, error) { + if r.Raw != nil { + return r.Raw, nil + } + return json.Marshal(struct { + Type WorkflowPauseInfoType `json:"type"` + }{ + Type: r.Discriminator, + }) +} + +func (r WorkflowPauseInfoCheckpoint) MarshalJSON() ([]byte, error) { + type alias WorkflowPauseInfoCheckpoint + return json.Marshal(struct { + Type WorkflowPauseInfoType `json:"type"` + alias + }{ + Type: r.Type(), + alias: alias(r), + }) +} + +func (r WorkflowPauseInfoUser) MarshalJSON() ([]byte, error) { + type alias WorkflowPauseInfoUser + return json.Marshal(struct { + Type WorkflowPauseInfoType `json:"type"` + alias + }{ + Type: r.Type(), + alias: alias(r), + }) +} + +func (r *WorkflowRunTerminal) UnmarshalJSON(data []byte) error { + type rawWorkflowRunTerminal struct { + Error *string `json:"error,omitempty"` + Failure json.RawMessage `json:"failure,omitempty"` + PauseInfo json.RawMessage `json:"pauseInfo"` + Reason *string `json:"reason,omitempty"` + ResultPreview *string `json:"resultPreview,omitempty"` + } + var raw rawWorkflowRunTerminal + if err := json.Unmarshal(data, &raw); err != nil { + return err + } + r.Error = raw.Error + if raw.Failure != nil { + value, err := unmarshalWorkflowRunFailure(raw.Failure) + if err != nil { + return err + } + r.Failure = value + } + if raw.PauseInfo != nil { + value, err := unmarshalWorkflowPauseInfo(raw.PauseInfo) + if err != nil { + return err + } + r.PauseInfo = value + } + r.Reason = raw.Reason + r.ResultPreview = raw.ResultPreview + return nil +} + +func (r *WorkflowRunResult) UnmarshalJSON(data []byte) error { + type rawWorkflowRunResult struct { + Attempt *int64 `json:"attempt,omitempty"` + Error *string `json:"error,omitempty"` + Failure json.RawMessage `json:"failure,omitempty"` + PauseInfo json.RawMessage `json:"pauseInfo,omitempty"` + Reason *string `json:"reason,omitempty"` + Result any `json:"result,omitempty"` + RunID string `json:"runId"` + Snapshot any `json:"snapshot,omitempty"` + Status WorkflowRunStatus `json:"status"` + } + var raw rawWorkflowRunResult + if err := json.Unmarshal(data, &raw); err != nil { + return err + } + r.Attempt = raw.Attempt + r.Error = raw.Error + if raw.Failure != nil { + value, err := unmarshalWorkflowRunFailure(raw.Failure) + if err != nil { + return err + } + r.Failure = value + } + if raw.PauseInfo != nil { + value, err := unmarshalWorkflowPauseInfo(raw.PauseInfo) + if err != nil { + return err + } + r.PauseInfo = value + } + r.Reason = raw.Reason + r.Result = raw.Result + r.RunID = raw.RunID + r.Snapshot = raw.Snapshot + r.Status = raw.Status + return nil +} diff --git a/go/rpc/zsession_encoding.go b/go/rpc/zsession_encoding.go index 847ed8869d..69f204d577 100644 --- a/go/rpc/zsession_encoding.go +++ b/go/rpc/zsession_encoding.go @@ -581,6 +581,12 @@ func (e *SessionEvent) UnmarshalJSON(data []byte) error { return err } e.Data = &d + case SessionEventTypeSessionIndexedSearch: + var d SessionIndexedSearchData + if err := json.Unmarshal(raw.Data, &d); err != nil { + return err + } + e.Data = &d case SessionEventTypeSessionInfo: var d SessionInfoData if err := json.Unmarshal(raw.Data, &d); err != nil { @@ -653,6 +659,12 @@ func (e *SessionEvent) UnmarshalJSON(data []byte) error { return err } e.Data = &d + case SessionEventTypeSessionPermissionRecovery: + var d SessionPermissionRecoveryData + if err := json.Unmarshal(raw.Data, &d); err != nil { + return err + } + e.Data = &d case SessionEventTypeSessionPermissionsChanged: var d SessionPermissionsChangedData if err := json.Unmarshal(raw.Data, &d); err != nil { @@ -946,6 +958,14 @@ func (r RawSessionEventData) MarshalJSON() ([]byte, error) { return r.Raw, nil } +func (r SessionIndexedSearchData) MarshalJSON() ([]byte, error) { + return json.Marshal(r.Raw) +} + +func (r *SessionIndexedSearchData) UnmarshalJSON(data []byte) error { + return json.Unmarshal(data, &r.Raw) +} + func (r *UserMessageData) UnmarshalJSON(data []byte) error { type rawUserMessageData struct { AgentMode *UserMessageAgentMode `json:"agentMode,omitempty"` @@ -957,6 +977,7 @@ func (r *UserMessageData) UnmarshalJSON(data []byte) error { MessageID *string `json:"messageId,omitempty"` NativeDocumentPathFallbackPaths []string `json:"nativeDocumentPathFallbackPaths,omitzero"` ParentAgentTaskID *string `json:"parentAgentTaskId,omitempty"` + ResponsesReasoning *ResponsesReasoning `json:"responsesReasoning,omitempty"` Source *string `json:"source,omitempty"` SupportedNativeDocumentMIMETypes []string `json:"supportedNativeDocumentMimeTypes,omitzero"` TransformedContent *string `json:"transformedContent,omitempty"` @@ -984,6 +1005,7 @@ func (r *UserMessageData) UnmarshalJSON(data []byte) error { r.MessageID = raw.MessageID r.NativeDocumentPathFallbackPaths = raw.NativeDocumentPathFallbackPaths r.ParentAgentTaskID = raw.ParentAgentTaskID + r.ResponsesReasoning = raw.ResponsesReasoning r.Source = raw.Source r.SupportedNativeDocumentMIMETypes = raw.SupportedNativeDocumentMIMETypes r.TransformedContent = raw.TransformedContent @@ -1523,6 +1545,14 @@ func (r *ToolExecutionCompleteResult) UnmarshalJSON(data []byte) error { return nil } +func (r SandboxDecisionData) MarshalJSON() ([]byte, error) { + return json.Marshal(r.Raw) +} + +func (r *SandboxDecisionData) UnmarshalJSON(data []byte) error { + return json.Unmarshal(data, &r.Raw) +} + func unmarshalSystemNotification(data []byte) (SystemNotification, error) { if string(data) == "null" { return nil, nil @@ -1791,8 +1821,9 @@ func (r SystemNotificationUnclassified) MarshalJSON() ([]byte, error) { func (r *SystemNotificationData) UnmarshalJSON(data []byte) error { type rawSystemNotificationData struct { - Content string `json:"content"` - Kind json.RawMessage `json:"kind"` + Content string `json:"content"` + Kind json.RawMessage `json:"kind"` + ResponsesReasoning *ResponsesReasoning `json:"responsesReasoning,omitempty"` } var raw rawSystemNotificationData if err := json.Unmarshal(data, &raw); err != nil { @@ -1806,6 +1837,7 @@ func (r *SystemNotificationData) UnmarshalJSON(data []byte) error { } r.Kind = value } + r.ResponsesReasoning = raw.ResponsesReasoning return nil } @@ -2295,8 +2327,10 @@ func (r PermissionPromptRequestWrite) MarshalJSON() ([]byte, error) { func (r *PermissionRequestedData) UnmarshalJSON(data []byte) error { type rawPermissionRequestedData struct { AgentMode *SessionMode `json:"agentMode,omitempty"` + PermissionMode *PermissionMode `json:"permissionMode,omitempty"` PermissionRequest json.RawMessage `json:"permissionRequest"` PromptRequest json.RawMessage `json:"promptRequest,omitempty"` + RecoveryEpisodeID *string `json:"recoveryEpisodeId,omitempty"` RequestID string `json:"requestId"` ResolvedByHook *bool `json:"resolvedByHook,omitempty"` RiskAssessment any `json:"riskAssessment,omitempty"` @@ -2306,6 +2340,7 @@ func (r *PermissionRequestedData) UnmarshalJSON(data []byte) error { return err } r.AgentMode = raw.AgentMode + r.PermissionMode = raw.PermissionMode if raw.PermissionRequest != nil { value, err := unmarshalPermissionRequest(raw.PermissionRequest) if err != nil { @@ -2320,6 +2355,7 @@ func (r *PermissionRequestedData) UnmarshalJSON(data []byte) error { } r.PromptRequest = value } + r.RecoveryEpisodeID = raw.RecoveryEpisodeID r.RequestID = raw.RequestID r.ResolvedByHook = raw.ResolvedByHook r.RiskAssessment = raw.RiskAssessment @@ -2552,16 +2588,20 @@ func (r PermissionDeniedNoApprovalRuleAndCouldNotRequestFromUser) MarshalJSON() func (r *PermissionCompletedData) UnmarshalJSON(data []byte) error { type rawPermissionCompletedData struct { - DecisionSource *PermissionDecisionSource `json:"decisionSource,omitempty"` - RequestID string `json:"requestId"` - Result json.RawMessage `json:"result"` - ToolCallID *string `json:"toolCallId,omitempty"` + Blocker *TaskBlocker `json:"blocker,omitempty"` + DecisionSource *PermissionDecisionSource `json:"decisionSource,omitempty"` + RecoveryEpisodeID *string `json:"recoveryEpisodeId,omitempty"` + RequestID string `json:"requestId"` + Result json.RawMessage `json:"result"` + ToolCallID *string `json:"toolCallId,omitempty"` } var raw rawPermissionCompletedData if err := json.Unmarshal(data, &raw); err != nil { return err } + r.Blocker = raw.Blocker r.DecisionSource = raw.DecisionSource + r.RecoveryEpisodeID = raw.RecoveryEpisodeID r.RequestID = raw.RequestID if raw.Result != nil { value, err := unmarshalPermissionResult(raw.Result) diff --git a/go/rpc/zsession_events.go b/go/rpc/zsession_events.go index 534eca386e..cd731b26af 100644 --- a/go/rpc/zsession_events.go +++ b/go/rpc/zsession_events.go @@ -198,6 +198,7 @@ const ( SessionEventTypeSessionFusionRouteStarted SessionEventType = "session.fusion_route_started" SessionEventTypeSessionHandoff SessionEventType = "session.handoff" SessionEventTypeSessionIdle SessionEventType = "session.idle" + SessionEventTypeSessionIndexedSearch SessionEventType = "session.indexed_search" SessionEventTypeSessionInfo SessionEventType = "session.info" SessionEventTypeSessionLimitsExhaustedCompleted SessionEventType = "session_limits_exhausted.completed" SessionEventTypeSessionLimitsExhaustedRequested SessionEventType = "session_limits_exhausted.requested" @@ -214,6 +215,7 @@ const ( SessionEventTypeSessionModeChanged SessionEventType = "session.mode_changed" SessionEventTypeSessionModelChange SessionEventType = "session.model_change" SessionEventTypeSessionModeNoticeDelivered SessionEventType = "session.mode_notice_delivered" + SessionEventTypeSessionPermissionRecovery SessionEventType = "session.permission_recovery" // Experimental: SessionEventTypeSessionPermissionsChanged identifies an experimental event // that may change or be removed. SessionEventTypeSessionPermissionsChanged SessionEventType = "session.permissions_changed" @@ -447,6 +449,27 @@ type AssistantMessageData struct { func (*AssistantMessageData) sessionEventData() {} func (*AssistantMessageData) Type() SessionEventType { return SessionEventTypeAssistantMessage } +// Authoritative snapshot of an Autopilot permission-recovery episode +type SessionPermissionRecoveryData struct { + // Ordered privacy-safe record of permission attempts and the successful alternative, when any + Attempts []PermissionRecoveryAttempt `json:"attempts"` + // Stable identifier shared by every transition in this recovery episode + EpisodeID string `json:"episodeId"` + // Maximum number of distinct autonomous permission attempts allowed before escalation + MaxAttempts int64 `json:"maxAttempts"` + // Policy selected from the current client's response capability; mode or client changes may update it during recovery + OnBlocked PermissionRecoveryOnBlocked `json:"onBlocked"` + // Controlled reason for the latest episode transition + Reason PermissionRecoveryReason `json:"reason"` + // Current lifecycle state of the recovery episode + Status PermissionRecoveryStatus `json:"status"` +} + +func (*SessionPermissionRecoveryData) sessionEventData() {} +func (*SessionPermissionRecoveryData) Type() SessionEventType { + return SessionEventTypeSessionPermissionRecovery +} + // Auto Intent resolution: the concrete model the session settled on for the first prompt of an auto-mode session, and why. Lets SDK clients render the chosen model and the full reason it was picked. The core selection fields (chosenModel/reasoningBucket/categoryScores) are stable; the routing-analytics fields (predictedLabel/confidence/candidateModels) mirror the upstream intent service and may evolve, hence the event's experimental stability. // Experimental: SessionAutoModeResolvedData is part of an experimental API and may change or be removed. type SessionAutoModeResolvedData struct { @@ -642,6 +665,8 @@ type SessionCompactionCompleteData struct { PreCompactionTokens *int64 `json:"preCompactionTokens,omitempty"` // GitHub request tracing ID (x-github-request-id header) for the compaction LLM call RequestID *string `json:"requestId,omitempty"` + // Reasoning baseline on the replacement summary, preserved when replay skips the compacted history + ResponsesReasoning *ResponsesReasoning `json:"responsesReasoning,omitempty"` // Copilot service request ID (x-copilot-service-request-id header) for the compaction LLM call ServiceRequestID *string `json:"serviceRequestId,omitempty"` // For failed compaction only: the HTTP status code of the compaction LLM call failure, when it carried one. Absent for successful compaction and for failures without an HTTP status (e.g. an empty model response or a transport error). @@ -1514,6 +1539,8 @@ type SkillInvokedRefData struct { Description *string `json:"description,omitempty"` // Whether model invocation is disabled for this skill DisableModelInvocation *bool `json:"disableModelInvocation,omitempty"` + // Projected chat-message count when the skill was invoked. Preserved from the inline event data when the authored body is deduplicated. + InvokedAtTurn *int64 `json:"invokedAtTurn,omitempty"` // Model identifier active when the skill was invoked, when known Model *string `json:"model,omitempty"` // Name of the invoked skill @@ -1618,6 +1645,12 @@ type AssistantUsageData struct { Rte *bool `json:"rte,omitempty"` // Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation ServiceRequestID *string `json:"serviceRequestId,omitempty"` + // Number of prior thinking blocks the provider dropped while transforming the request + // Internal: ThinkingDroppedBlocks is part of the SDK's internal API surface and is not intended for external use. + ThinkingDroppedBlocks *int64 `json:"thinkingDroppedBlocks,omitempty"` + // Recognized provider-reported reasons for dropped thinking blocks, in response order + // Internal: ThinkingDroppedReasons is part of the SDK's internal API surface and is not intended for external use. + ThinkingDroppedReasons []string `json:"thinkingDroppedReasons,omitzero"` // Time to first token in milliseconds. Only available for streaming requests TimeToFirstTokenMs *float64 `json:"timeToFirstTokenMs,omitempty"` // Tool-call counts keyed by tool name @@ -1929,6 +1962,8 @@ func (*SessionIdleData) Type() SessionEventType { return SessionEventTypeSession // Payload of `sandbox.decision`, a bounded governance record of what the process sandbox was configured to do and whether it took effect. Discriminated by `kind`. type SandboxDecisionData struct { + // Raw preserves the complete union payload, including unrecognized variants. + Raw json.RawMessage `json:"-"` } func (*SandboxDecisionData) sessionEventData() {} @@ -2109,6 +2144,8 @@ type UserMessageData struct { NativeDocumentPathFallbackPaths []string `json:"nativeDocumentPathFallbackPaths,omitzero"` // Parent agent task ID for background telemetry correlated to this user turn ParentAgentTaskID *string `json:"parentAgentTaskId,omitempty"` + // Responses reasoning settings anchored before this model-facing message, for cache-stable history replay + ResponsesReasoning *ResponsesReasoning `json:"responsesReasoning,omitempty"` // Origin of this message, used for timeline filtering and attribution (e.g., `skill-pdf` for hidden skill injection or `agent-` for an inter-agent prompt) Source *string `json:"source,omitempty"` // Normalized document MIME types that were sent natively instead of through tagged_files XML @@ -2124,9 +2161,13 @@ func (*UserMessageData) Type() SessionEventType { return SessionEventTypeUserMes // Permission request completion notification signaling UI dismissal type PermissionCompletedData struct { + // Atomic structured blocked outcome when this permission response ended an Autopilot recovery episode unsuccessfully + Blocker *TaskBlocker `json:"blocker,omitempty"` // Who decided this permission request. Absent on completions recorded before this field existed, which consumers must treat as "not a human decision" rather than assuming one. Authorization records are minted only for `human_response`; an assisted-approval verdict, a host policy, an unattended fallback, and a hook resolution all produce the same `result` a person does, so this is the only field that distinguishes them. // Experimental: DecisionSource is part of an experimental API and may change or be removed. DecisionSource *PermissionDecisionSource `json:"decisionSource,omitempty"` + // Permission-recovery episode settled by this response, when the request was escalated by Autopilot + RecoveryEpisodeID *string `json:"recoveryEpisodeId,omitempty"` // Request ID of the resolved permission request; clients should dismiss any UI for this request RequestID string `json:"requestId"` // The result of the permission request @@ -2142,10 +2183,14 @@ func (*PermissionCompletedData) Type() SessionEventType { return SessionEventTyp type PermissionRequestedData struct { // Agent mode captured from the owning turn when permission evaluation began. AgentMode *SessionMode `json:"agentMode,omitempty"` + // Permission mode captured when evaluation began. Absent on historical events. + PermissionMode *PermissionMode `json:"permissionMode,omitempty"` // Details of the permission being requested PermissionRequest PermissionRequest `json:"permissionRequest"` // Derived user-facing permission prompt details for UI consumers PromptRequest PermissionPromptRequest `json:"promptRequest,omitempty"` + // Permission-recovery episode that authorized this request to surface for interactive attention + RecoveryEpisodeID *string `json:"recoveryEpisodeId,omitempty"` // Unique identifier for this permission request; used to respond via session.respondToPermission() RequestID string `json:"requestId"` // When true, this permission was already resolved by a permissionRequest hook and requires no client action @@ -2697,6 +2742,8 @@ type SkillInvokedData struct { Description *string `json:"description,omitempty"` // Whether model invocation is disabled for this skill DisableModelInvocation *bool `json:"disableModelInvocation,omitempty"` + // Projected chat-message count when the skill was invoked. New writers persist this so replay does not need to reconstruct superseded history; readers derive it for legacy events when absent. + InvokedAtTurn *int64 `json:"invokedAtTurn,omitempty"` // Model identifier active when the skill was invoked, when known Model *string `json:"model,omitempty"` // Name of the invoked skill @@ -2910,6 +2957,8 @@ type SystemNotificationData struct { Content string `json:"content"` // Structured metadata identifying what triggered this notification Kind SystemNotification `json:"kind"` + // Responses reasoning settings anchored before this model-facing message, for cache-stable history replay + ResponsesReasoning *ResponsesReasoning `json:"responsesReasoning,omitempty"` } func (*SystemNotificationData) sessionEventData() {} @@ -2934,6 +2983,18 @@ func (*SystemMessageData) Type() SessionEventType { return SessionEventTypeSyste // Task completion notification with summary from the agent type SessionTaskCompleteData struct { + // Structured blocker details when outcome is blocked + Blocker *TaskBlocker `json:"blocker,omitempty"` + // Active autopilot objective ID evaluated by the completion reviewer + ObjectiveID *int64 `json:"objectiveId,omitempty"` + // Semantic completion decision. Absent on legacy events and invalid tool calls + Outcome *TaskCompletionOutcome `json:"outcome,omitempty"` + // Label-safe runtime rationale for the completion decision (e.g. a cancellation or pause/resume downgrade), when one applies. Reviewer-authored rationale is intentionally omitted here because this event has no IFC label channel; the reviewer's findings remain available through its own labeled sub-agent events + Reason *string `json:"reason,omitempty"` + // Whether the task was accepted as complete. False when validation failed or completion was rejected or blocked by the reviewer + Success *bool `json:"success,omitempty"` + // Summary of the completed task, provided by the agent + Summary *string `json:"summary,omitempty"` } func (*SessionTaskCompleteData) sessionEventData() {} @@ -3038,6 +3099,15 @@ type ToolExecutionStartData struct { func (*ToolExecutionStartData) sessionEventData() {} func (*ToolExecutionStartData) Type() SessionEventType { return SessionEventTypeToolExecutionStart } +// Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. +type SessionIndexedSearchData struct { + // Raw preserves the complete union payload, including unrecognized variants. + Raw json.RawMessage `json:"-"` +} + +func (*SessionIndexedSearchData) sessionEventData() {} +func (*SessionIndexedSearchData) Type() SessionEventType { return SessionEventTypeSessionIndexedSearch } + // Transient signal that an open canvas instance's provider has dropped (for example the extension is reloading mid-session). The host should keep the panel mounted and surface a reconnecting affordance rather than tearing it down; a subsequent `session.canvas.opened` for the same instanceId clears the affordance once the provider reconnects with a fresh url. Ephemeral and never persisted, so it is never replayed on cold resume. // Experimental: SessionCanvasUnavailableData is part of an experimental API and may change or be removed. type SessionCanvasUnavailableData struct { @@ -3815,9 +3885,23 @@ type ModelCallFailureRequestFingerprint struct { ToolResultMessageCount int64 `json:"toolResultMessageCount"` } +// Bounded runtime attribution, independent of free-text rationale. Telemetry revalidates this vocabulary before standard collection. +type PermissionApprovalEvaluation struct { + // Stage that produced this attribution. + EvaluationStage PermissionApprovalEvaluationEvaluationStage `json:"evaluationStage"` + // Whether the request invoked the judge interface. A cached recommendation retains the original attempt fact. Omitted means unknown, including inherited outcomes. + JudgeAttempted *bool `json:"judgeAttempted,omitempty"` + // Status of the local judge interface, not proof of a model network call. + JudgeStatus PermissionApprovalEvaluationJudgeStatus `json:"judgeStatus"` + // Machine-readable runtime gate reason, never a command, path or human rationale. + ReasonCode PermissionApprovalEvaluationReasonCode `json:"reasonCode"` +} + // Assisted-approval judge information attached to a permission request. Present only in assisted mode; its absence means the judge did not evaluate the request. The `recommendation` conveys the judge's disposition for this request. // Experimental: PermissionAssistedApproval is part of an experimental API and may change or be removed. type PermissionAssistedApproval struct { + // Runtime reason and judge-call metadata. Absent on older events; missing metadata means unknown, not that the judge was skipped. + Evaluation *PermissionApprovalEvaluation `json:"evaluation,omitempty"` // Classified cause of an `error` recommendation. Absent for every other recommendation. FailureReason *AssistedApprovalJudgeFailureReason `json:"failureReason,omitempty"` // Model id that produced the recommendation, when the judge was consulted and reported one. Absent for `excluded` (the judge was not consulted) and for failures that occurred before a model was selected. @@ -4721,6 +4805,16 @@ func (r PersistedBinaryImage) Type() PersistedBinaryResultType { return PersistedBinaryResultType(r.Discriminator) } +// Original request-level and effective conversation reasoning effort for a Responses history boundary +type ResponsesReasoning struct { + // Effective effort selected before this message, independent of the response-level reasoning field + Effort string `json:"effort"` + // Original request-level effort, retained while replaying this conversation prefix + InitialEffort string `json:"initialEffort"` + // Provider model whose reasoning settings this boundary records + Model string `json:"model"` +} + // The user's selected action for an exhausted session limit. type SessionLimitsExhaustedResponse struct { // Action selected by the user. @@ -5857,24 +5951,6 @@ const ( ManagedSettingsEnforcedEscalationUnrestrictedURLs ManagedSettingsEnforcedEscalation = "unrestricted_urls" ) -// Summary of which managed-settings channels contributed to the effective session policy. Use the per-channel booleans for exact provenance. -type ManagedSettingsResolvedSource string - -const ( - // Only session-local SDK-host injection contributed. - ManagedSettingsResolvedSourceClient ManagedSettingsResolvedSource = "client" - // Only the device MDM/plist/registry/file channel contributed. - ManagedSettingsResolvedSourceDevice ManagedSettingsResolvedSource = "device" - // More than one channel contributed. Ordinary keys resolve device over server over policy helper per key, while permissions compose restrictively across all present layers. - ManagedSettingsResolvedSourceMixed ManagedSettingsResolvedSource = "mixed" - // No managed policy is in force (no channel contributed). - ManagedSettingsResolvedSourceNone ManagedSettingsResolvedSource = "none" - // A policy helper registered by device or server policy contributed. Device registration takes priority when present. - ManagedSettingsResolvedSourcePolicyHelper ManagedSettingsResolvedSource = "policyHelper" - // Only the server/account channel contributed. - ManagedSettingsResolvedSourceServer ManagedSettingsResolvedSource = "server" -) - // How the pending MCP headers refresh request resolved. type MCPHeadersRefreshCompletedOutcome string @@ -6012,6 +6088,98 @@ const ( OmittedBinaryTypeResource OmittedBinaryType = "resource" ) +// Stage that produced this attribution. +type PermissionApprovalEvaluationEvaluationStage string + +const ( + // The judge interface produced the evaluation. + PermissionApprovalEvaluationEvaluationStageJudge PermissionApprovalEvaluationEvaluationStage = "judge" + // The request resolved before assisted-approval evaluation. + PermissionApprovalEvaluationEvaluationStageNotReached PermissionApprovalEvaluationEvaluationStage = "not_reached" + // A runtime gate skipped the judge. + PermissionApprovalEvaluationEvaluationStagePreJudge PermissionApprovalEvaluationEvaluationStage = "pre_judge" + // A cached recommendation or another request's outcome was reused. + PermissionApprovalEvaluationEvaluationStageReuse PermissionApprovalEvaluationEvaluationStage = "reuse" + // The attribution stage is unknown. + PermissionApprovalEvaluationEvaluationStageUnknown PermissionApprovalEvaluationEvaluationStage = "unknown" +) + +// Status of the local judge interface, not proof of a model network call. +type PermissionApprovalEvaluationJudgeStatus string + +const ( + // This evaluation reused a cached recommendation. + PermissionApprovalEvaluationJudgeStatusCached PermissionApprovalEvaluationJudgeStatus = "cached" + // The judge interface returned a usable verdict. + PermissionApprovalEvaluationJudgeStatusCompleted PermissionApprovalEvaluationJudgeStatus = "completed" + // The judge interface returned an error. + PermissionApprovalEvaluationJudgeStatusFailed PermissionApprovalEvaluationJudgeStatus = "failed" + // This request inherited another decision without local judge attribution. + PermissionApprovalEvaluationJudgeStatusInherited PermissionApprovalEvaluationJudgeStatus = "inherited" + // This evaluation did not invoke the judge interface. + PermissionApprovalEvaluationJudgeStatusNotCalled PermissionApprovalEvaluationJudgeStatus = "not_called" + // No authoritative attribution is available. + PermissionApprovalEvaluationJudgeStatusUnknown PermissionApprovalEvaluationJudgeStatus = "unknown" +) + +// Machine-readable runtime gate reason, never a command, path or human rationale. +type PermissionApprovalEvaluationReasonCode string + +const ( + // An action field exceeded the judge input limit. + PermissionApprovalEvaluationReasonCodeActionTooLong PermissionApprovalEvaluationReasonCode = "action-too-long" + // The script argument binding could not be reviewed. + PermissionApprovalEvaluationReasonCodeArgumentBindingUnreviewable PermissionApprovalEvaluationReasonCode = "argument-binding-unreviewable" + // The judge was skipped because authorization extraction could not safely establish a complete recent history. + PermissionApprovalEvaluationReasonCodeAuthorizationHistoryIncomplete PermissionApprovalEvaluationReasonCode = "authorization-history-incomplete" + // Assisted approval was inactive for this request. + PermissionApprovalEvaluationReasonCodeInactive PermissionApprovalEvaluationReasonCode = "inactive" + // The request inherited an outcome from another decision. + PermissionApprovalEvaluationReasonCodeInherited PermissionApprovalEvaluationReasonCode = "inherited" + // The interpreter snapshot exceeded the size limit. + PermissionApprovalEvaluationReasonCodeInterpreterTooLarge PermissionApprovalEvaluationReasonCode = "interpreter-too-large" + // The script interpreter could not be inspected. + PermissionApprovalEvaluationReasonCodeInterpreterUnavailable PermissionApprovalEvaluationReasonCode = "interpreter-unavailable" + // An interpreter wrapped a script that could not be reviewed. + PermissionApprovalEvaluationReasonCodeInterpreterWrappedScript PermissionApprovalEvaluationReasonCode = "interpreter-wrapped-script" + // The script working directory was invalid. + PermissionApprovalEvaluationReasonCodeInvalidWorkingDirectory PermissionApprovalEvaluationReasonCode = "invalid-working-directory" + // The judge interface returned an error. + PermissionApprovalEvaluationReasonCodeJudgeError PermissionApprovalEvaluationReasonCode = "judge-error" + // The judge interface returned a usable verdict. + PermissionApprovalEvaluationReasonCodeJudgeVerdict PermissionApprovalEvaluationReasonCode = "judge-verdict" + // The script snapshot manifest was malformed. + PermissionApprovalEvaluationReasonCodeMalformedScriptActionManifest PermissionApprovalEvaluationReasonCode = "malformed-script-action-manifest" + // The script review metadata was malformed. + PermissionApprovalEvaluationReasonCodeMalformedScriptActionReview PermissionApprovalEvaluationReasonCode = "malformed-script-action-review" + // Managed policy required a human decision. + PermissionApprovalEvaluationReasonCodeManagedApprovalRequired PermissionApprovalEvaluationReasonCode = "managed-approval-required" + // The script snapshot was not UTF-8. + PermissionApprovalEvaluationReasonCodeNonUtf8 PermissionApprovalEvaluationReasonCode = "non-utf8" + // The request resolved before assisted-approval evaluation. + PermissionApprovalEvaluationReasonCodeNotReached PermissionApprovalEvaluationReasonCode = "not-reached" + // The script path was not a regular file. + PermissionApprovalEvaluationReasonCodeNotRegularFile PermissionApprovalEvaluationReasonCode = "not-regular-file" + // The script path was not authorized for inspection. + PermissionApprovalEvaluationReasonCodePathNotAuthorized PermissionApprovalEvaluationReasonCode = "path-not-authorized" + // The request asked to bypass sandbox restrictions. + PermissionApprovalEvaluationReasonCodeSandboxBypass PermissionApprovalEvaluationReasonCode = "sandbox-bypass" + // The shell environment could not be reviewed. + PermissionApprovalEvaluationReasonCodeShellEnvironmentUnreviewable PermissionApprovalEvaluationReasonCode = "shell-environment-unreviewable" + // The script snapshot exceeded the size limit. + PermissionApprovalEvaluationReasonCodeTooLarge PermissionApprovalEvaluationReasonCode = "too-large" + // Script review was unavailable. + PermissionApprovalEvaluationReasonCodeUnavailable PermissionApprovalEvaluationReasonCode = "unavailable" + // Attribution is missing or outside the supported vocabulary. + PermissionApprovalEvaluationReasonCodeUnknown PermissionApprovalEvaluationReasonCode = "unknown" + // The script snapshot could not be read. + PermissionApprovalEvaluationReasonCodeUnreadable PermissionApprovalEvaluationReasonCode = "unreadable" + // A script path could not be represented for review. + PermissionApprovalEvaluationReasonCodeUnrepresentablePath PermissionApprovalEvaluationReasonCode = "unrepresentable-path" + // The script invocation could not be reviewed. + PermissionApprovalEvaluationReasonCodeUnreviewableScriptInvocation PermissionApprovalEvaluationReasonCode = "unreviewable-script-invocation" +) + // Which direction a message-backed authorization claim moves authority in. // Experimental: PermissionMessageAuthorizationPolarity is part of an experimental API and may change or be removed. type PermissionMessageAuthorizationPolarity string diff --git a/go/session_event_serialization_test.go b/go/session_event_serialization_test.go index 4941abc811..cfb9561fd6 100644 --- a/go/session_event_serialization_test.go +++ b/go/session_event_serialization_test.go @@ -2,6 +2,7 @@ package copilot import ( "encoding/json" + "reflect" "testing" "github.com/github/copilot-sdk/go/rpc" @@ -300,6 +301,156 @@ func TestManagedSettingsResolvedProvenanceRoundTrips(t *testing.T) { } } +func TestSessionRootUnionEventRoundTrips(t *testing.T) { + cases := []struct { + eventType SessionEventType + payloads []string + }{ + { + eventType: SessionEventTypeSessionIndexedSearch, + payloads: []string{ + `{"kind":"status","state":"ready"}`, + `{"kind":"startup","outcome":"failed","fileCount":0,"startupDurationMs":12.5, + "forcedByEnv":false,"warmStart":true,"disabledReason":"organization", + "errorMessage":"test startup diagnostic","eligible":false}`, + `{"kind":"server_error","errorType":"unexpected_exit","exitCode":0, + "errorMessage":"test server diagnostic"}`, + `{"kind":"incremental","phase":"updated","changedFileCount":0,"addedFileCount":2, + "deletedFileCount":1,"totalChangeCount":3,"walkDurationMs":0, + "updateDurationMs":1.25,"totalDurationMs":1.25}`, + `{"kind":"future_variant","details":{"enabled":false,"count":0,"ratio":0.5}}`, + }, + }, + { + eventType: SessionEventTypeSandboxDecision, + payloads: []string{ + `{"kind":"policy_resolved","control":"process","outcome":"resolved","platform":"linux", + "backend":"bubblewrap","policySource":"default_policy","enforcementPoint":"shell", + "readwritePathsCount":0,"readonlyPathsCount":1,"deniedPathsCount":0, + "addCurrentWorkingDirectory":true,"allowOutbound":false,"allowLocalNetwork":false, + "proxyMode":"none","allowBypass":false,"gitAuth":false,"ghAuth":false,"keychainAccess":false}`, + `{"kind":"spawn_completed","control":"process","outcome":"succeeded","platform":"linux", + "backend":"bubblewrap","enforcementPoint":"shell","durationMs":1.5}`, + `{"kind":"enforcement_state","control":"process","outcome":"engaged","platform":"linux", + "backend":"bubblewrap","enforcementPoint":"shell","command":null}`, + `{"kind":"access_denied","control":"filesystem","outcome":"denied","platform":"linux", + "enforcementPoint":"builtin_filesystem","denialClass":"filesystem_read", + "attestation":"builtin_policy_checked","deniedResource":"/restricted/example"}`, + `{"kind":"bypass_decided","control":"bypass","outcome":"declined","platform":"linux", + "enforcementPoint":"shell","source":"user_prompted","toolCallId":"tool-1"}`, + `{"kind":"permissive_retry_decided","control":"process","outcome":"approved","platform":"linux", + "enforcementPoint":"shell","source":"model_requested"}`, + `{"kind":"permissive_retry_completed","control":"process","outcome":"succeeded", + "platform":"linux","enforcementPoint":"shell"}`, + }, + }, + } + for _, test := range cases { + for _, payload := range test.payloads { + var expectedPayload map[string]any + if err := json.Unmarshal([]byte(payload), &expectedPayload); err != nil { + t.Fatal(err) + } + t.Run(string(test.eventType)+"/"+expectedPayload["kind"].(string), func(t *testing.T) { + expected := map[string]any{ + "id": "00000000-0000-0000-0000-000000000005", + "timestamp": "2026-01-01T00:00:00Z", + "parentId": "00000000-0000-0000-0000-000000000004", + "agentId": "agent-1", + "ephemeral": true, + "type": string(test.eventType), + "data": expectedPayload, + } + wire, err := json.Marshal(expected) + if err != nil { + t.Fatal(err) + } + var event SessionEvent + if err := json.Unmarshal(wire, &event); err != nil { + t.Fatal(err) + } + if event.Type() != test.eventType { + t.Fatalf("expected event type %q, got %q", test.eventType, event.Type()) + } + switch test.eventType { + case SessionEventTypeSessionIndexedSearch: + if _, ok := event.Data.(*SessionIndexedSearchData); !ok { + t.Fatalf("expected indexed search data, got %T", event.Data) + } + case SessionEventTypeSandboxDecision: + if _, ok := event.Data.(*SandboxDecisionData); !ok { + t.Fatalf("expected sandbox decision data, got %T", event.Data) + } + } + roundTripped, err := event.Marshal() + if err != nil { + t.Fatal(err) + } + var actual map[string]any + if err := json.Unmarshal(roundTripped, &actual); err != nil { + t.Fatal(err) + } + if !reflect.DeepEqual(actual, expected) { + t.Fatalf("expected entire union event to round-trip:\nwant %v\ngot %v", expected, actual) + } + }) + } + } +} + +func TestSessionManagedSettingsResolvedEventRoundTrips(t *testing.T) { + wire := []byte(`{ + "id": "00000000-0000-0000-0000-000000000004", + "timestamp": "2026-01-01T00:00:00Z", + "parentId": null, + "ephemeral": true, + "type": "session.managed_settings_resolved", + "data": { + "source": "client", + "clientManaged": true, + "serverManaged": false, + "deviceManaged": false, + "failClosed": true, + "bypassPermissionsDisabled": true, + "managedKeys": ["permissions"], + "settings": {"permissions": {"deny": ["shell"]}} + } + }`) + var event SessionEvent + if err := json.Unmarshal(wire, &event); err != nil { + t.Fatalf("failed to unmarshal managed settings event: %v", err) + } + resolved, ok := event.Data.(*SessionManagedSettingsResolvedData) + if !ok { + t.Fatalf("expected managed settings event payload, got %T", event.Data) + } + if resolved.Source != ManagedSettingsResolvedSourceClient || + resolved.ClientManaged == nil || !*resolved.ClientManaged || !resolved.FailClosed { + t.Fatalf("expected managed settings provenance and fail-closed state, got %#v", resolved) + } + expectedSettings := map[string]any{ + "permissions": map[string]any{"deny": []any{"shell"}}, + } + if !reflect.DeepEqual(resolved.Settings, expectedSettings) { + t.Fatalf("expected effective settings %v, got %v", expectedSettings, resolved.Settings) + } + + data, err := event.Marshal() + if err != nil { + t.Fatalf("failed to marshal managed settings event: %v", err) + } + var expected, actual map[string]any + if err := json.Unmarshal(wire, &expected); err != nil { + t.Fatal(err) + } + if err := json.Unmarshal(data, &actual); err != nil { + t.Fatal(err) + } + if !reflect.DeepEqual(actual, expected) { + t.Fatalf("expected entire event to round-trip:\nwant %v\ngot %v", expected, actual) + } +} + // The failure event is ephemeral: the runtime emits it when an Auto preference // switch cannot mint a usable model, and never persists or replays it. func TestSessionAutoTierSwitchFailedEvent(t *testing.T) { diff --git a/go/zsession_events.go b/go/zsession_events.go index c668f90601..b63695e49a 100644 --- a/go/zsession_events.go +++ b/go/zsession_events.go @@ -148,8 +148,10 @@ type ( HookEndError = rpc.HookEndError HookProgressData = rpc.HookProgressData HookStartData = rpc.HookStartData + IndexedSearchState = rpc.IndexedSearchState ManagedSettingsEnforcedAction = rpc.ManagedSettingsEnforcedAction ManagedSettingsEnforcedEscalation = rpc.ManagedSettingsEnforcedEscalation + ManagedSettingsResolvedData = rpc.ManagedSettingsResolvedData ManagedSettingsResolvedSource = rpc.ManagedSettingsResolvedSource MCPAppToolCallCompleteData = rpc.MCPAppToolCallCompleteData MCPAppToolCallCompleteError = rpc.MCPAppToolCallCompleteError @@ -189,6 +191,10 @@ type ( OmittedBinaryResult = rpc.OmittedBinaryResult OmittedBinaryType = rpc.OmittedBinaryType PendingMessagesModifiedData = rpc.PendingMessagesModifiedData + PermissionApprovalEvaluation = rpc.PermissionApprovalEvaluation + PermissionApprovalEvaluationEvaluationStage = rpc.PermissionApprovalEvaluationEvaluationStage + PermissionApprovalEvaluationJudgeStatus = rpc.PermissionApprovalEvaluationJudgeStatus + PermissionApprovalEvaluationReasonCode = rpc.PermissionApprovalEvaluationReasonCode PermissionApproved = rpc.PermissionApproved PermissionApprovedForLocation = rpc.PermissionApprovedForLocation PermissionApprovedForSession = rpc.PermissionApprovedForSession @@ -225,6 +231,14 @@ type ( PermissionPromptRequestURL = rpc.PermissionPromptRequestURL PermissionPromptRequestWrite = rpc.PermissionPromptRequestWrite PermissionRecommendation = rpc.PermissionRecommendation + PermissionRecoveryAttempt = rpc.PermissionRecoveryAttempt + PermissionRecoveryAttemptDisposition = rpc.PermissionRecoveryAttemptDisposition + PermissionRecoveryAttemptReason = rpc.PermissionRecoveryAttemptReason + PermissionRecoveryAttemptRelation = rpc.PermissionRecoveryAttemptRelation + PermissionRecoveryData = rpc.PermissionRecoveryData + PermissionRecoveryOnBlocked = rpc.PermissionRecoveryOnBlocked + PermissionRecoveryReason = rpc.PermissionRecoveryReason + PermissionRecoveryStatus = rpc.PermissionRecoveryStatus PermissionRequest = rpc.PermissionRequest PermissionRequestCommand = rpc.PermissionRequestCommand PermissionRequestCustomTool = rpc.PermissionRequestCustomTool @@ -269,6 +283,7 @@ type ( ReasoningSummary = rpc.ReasoningSummary RecommendedAutoTier = rpc.RecommendedAutoTier RemediationAction = rpc.RemediationAction + ResponsesReasoning = rpc.ResponsesReasoning SamplingCompletedData = rpc.SamplingCompletedData SamplingRequestedData = rpc.SamplingRequestedData SandboxDecisionData = rpc.SandboxDecisionData @@ -304,6 +319,7 @@ type ( SessionFusionRouteStartedData = rpc.SessionFusionRouteStartedData SessionHandoffData = rpc.SessionHandoffData SessionIdleData = rpc.SessionIdleData + SessionIndexedSearchData = rpc.SessionIndexedSearchData SessionInfoData = rpc.SessionInfoData SessionLimitsConfig = rpc.SessionLimitsConfig SessionLimitsExhaustedCompletedData = rpc.SessionLimitsExhaustedCompletedData @@ -320,6 +336,7 @@ type ( SessionModeChangedData = rpc.SessionModeChangedData SessionModelChangeData = rpc.SessionModelChangeData SessionModeNoticeDeliveredData = rpc.SessionModeNoticeDeliveredData + SessionPermissionRecoveryData = rpc.SessionPermissionRecoveryData SessionPermissionsChangedData = rpc.SessionPermissionsChangedData SessionPlanChangedData = rpc.SessionPlanChangedData SessionRemoteSteerableChangedData = rpc.SessionRemoteSteerableChangedData @@ -384,6 +401,8 @@ type ( SystemNotificationShellDetachedCompleted = rpc.SystemNotificationShellDetachedCompleted SystemNotificationType = rpc.SystemNotificationType SystemNotificationUnclassified = rpc.SystemNotificationUnclassified + TaskBlocker = rpc.TaskBlocker + TaskBlockerKind = rpc.TaskBlockerKind TaskCompleteData = rpc.TaskCompleteData TaskCompletionOutcome = rpc.TaskCompletionOutcome ToolExecutionCompleteContent = rpc.ToolExecutionCompleteContent @@ -452,529 +471,604 @@ type ( // Session-event constants are generated in the rpc package and re-exported here for source compatibility. const ( - AbortReasonAutopilotCreditLimit = rpc.AbortReasonAutopilotCreditLimit - AbortReasonRemoteCommand = rpc.AbortReasonRemoteCommand - AbortReasonUserAbort = rpc.AbortReasonUserAbort - AbortReasonUserInitiated = rpc.AbortReasonUserInitiated - AgentInterruptedActivityBackgroundAgent = rpc.AgentInterruptedActivityBackgroundAgent - AgentInterruptedActivityModelCall = rpc.AgentInterruptedActivityModelCall - AgentInterruptedActivityRetryBackoff = rpc.AgentInterruptedActivityRetryBackoff - AgentInterruptedActivityToolCall = rpc.AgentInterruptedActivityToolCall - AgentInterruptedCancelPhaseMidStream = rpc.AgentInterruptedCancelPhaseMidStream - AgentInterruptedCancelPhasePreFirstToken = rpc.AgentInterruptedCancelPhasePreFirstToken - AgentModelPolicyPreferred = rpc.AgentModelPolicyPreferred - AgentModelPolicyRequired = rpc.AgentModelPolicyRequired - AssistantMessageToolRequestCallerTypeProgram = rpc.AssistantMessageToolRequestCallerTypeProgram - AssistantMessageToolRequestTypeCustom = rpc.AssistantMessageToolRequestTypeCustom - AssistantMessageToolRequestTypeFunction = rpc.AssistantMessageToolRequestTypeFunction - AssistantUsageAPIEndpointChatCompletions = rpc.AssistantUsageAPIEndpointChatCompletions - AssistantUsageAPIEndpointResponses = rpc.AssistantUsageAPIEndpointResponses - AssistantUsageAPIEndpointV1Messages = rpc.AssistantUsageAPIEndpointV1Messages - AssistantUsageAPIEndpointWsResponses = rpc.AssistantUsageAPIEndpointWsResponses - AssistantUsageTransportHTTP = rpc.AssistantUsageTransportHTTP - AssistantUsageTransportWebsocket = rpc.AssistantUsageTransportWebsocket - AssistedApprovalJudgeFailureReasonAbort = rpc.AssistedApprovalJudgeFailureReasonAbort - AssistedApprovalJudgeFailureReasonEmptyResponse = rpc.AssistedApprovalJudgeFailureReasonEmptyResponse - AssistedApprovalJudgeFailureReasonModelError = rpc.AssistedApprovalJudgeFailureReasonModelError - AssistedApprovalJudgeFailureReasonParseError = rpc.AssistedApprovalJudgeFailureReasonParseError - AssistedApprovalJudgeFailureReasonTimeout = rpc.AssistedApprovalJudgeFailureReasonTimeout - AssistedApprovalRecommendationApprove = rpc.AssistedApprovalRecommendationApprove - AssistedApprovalRecommendationError = rpc.AssistedApprovalRecommendationError - AssistedApprovalRecommendationExcluded = rpc.AssistedApprovalRecommendationExcluded - AssistedApprovalRecommendationRequireApproval = rpc.AssistedApprovalRecommendationRequireApproval - AttachmentGitHubReferenceTypeDiscussion = rpc.AttachmentGitHubReferenceTypeDiscussion - AttachmentGitHubReferenceTypeIssue = rpc.AttachmentGitHubReferenceTypeIssue - AttachmentGitHubReferenceTypePr = rpc.AttachmentGitHubReferenceTypePr - AttachmentTypeBlob = rpc.AttachmentTypeBlob - AttachmentTypeDirectory = rpc.AttachmentTypeDirectory - AttachmentTypeExtensionContext = rpc.AttachmentTypeExtensionContext - AttachmentTypeFile = rpc.AttachmentTypeFile - AttachmentTypeGitHubActionsJob = rpc.AttachmentTypeGitHubActionsJob - AttachmentTypeGitHubCommit = rpc.AttachmentTypeGitHubCommit - AttachmentTypeGitHubFile = rpc.AttachmentTypeGitHubFile - AttachmentTypeGitHubFileDiff = rpc.AttachmentTypeGitHubFileDiff - AttachmentTypeGitHubReference = rpc.AttachmentTypeGitHubReference - AttachmentTypeGitHubRelease = rpc.AttachmentTypeGitHubRelease - AttachmentTypeGitHubRepository = rpc.AttachmentTypeGitHubRepository - AttachmentTypeGitHubSnippet = rpc.AttachmentTypeGitHubSnippet - AttachmentTypeGitHubTreeComparison = rpc.AttachmentTypeGitHubTreeComparison - AttachmentTypeGitHubURL = rpc.AttachmentTypeGitHubURL - AttachmentTypeSelection = rpc.AttachmentTypeSelection - AutoModeResolvedReasoningBucketHigh = rpc.AutoModeResolvedReasoningBucketHigh - AutoModeResolvedReasoningBucketLow = rpc.AutoModeResolvedReasoningBucketLow - AutoModeResolvedReasoningBucketMedium = rpc.AutoModeResolvedReasoningBucketMedium - AutoModeSwitchResponseNo = rpc.AutoModeSwitchResponseNo - AutoModeSwitchResponseYes = rpc.AutoModeSwitchResponseYes - AutoModeSwitchResponseYesAlways = rpc.AutoModeSwitchResponseYesAlways - AutopilotObjectiveChangedOperationCreate = rpc.AutopilotObjectiveChangedOperationCreate - AutopilotObjectiveChangedOperationDelete = rpc.AutopilotObjectiveChangedOperationDelete - AutopilotObjectiveChangedOperationUpdate = rpc.AutopilotObjectiveChangedOperationUpdate - AutopilotObjectiveChangedStatusActive = rpc.AutopilotObjectiveChangedStatusActive - AutopilotObjectiveChangedStatusCapReached = rpc.AutopilotObjectiveChangedStatusCapReached - AutopilotObjectiveChangedStatusCompleted = rpc.AutopilotObjectiveChangedStatusCompleted - AutopilotObjectiveChangedStatusPaused = rpc.AutopilotObjectiveChangedStatusPaused - AutoTierFast = rpc.AutoTierFast - AutoTierSwitchFailureReasonPolicyRejected = rpc.AutoTierSwitchFailureReasonPolicyRejected - AutoTierSwitchFailureReasonRequestFailed = rpc.AutoTierSwitchFailureReasonRequestFailed - AutoTierSwitchFailureReasonSetupFailed = rpc.AutoTierSwitchFailureReasonSetupFailed - AutoTierSwitchFailureReasonUnsupported = rpc.AutoTierSwitchFailureReasonUnsupported - BinaryAssetReferenceTypeImage = rpc.BinaryAssetReferenceTypeImage - BinaryAssetReferenceTypeResource = rpc.BinaryAssetReferenceTypeResource - BinaryAssetTypeImage = rpc.BinaryAssetTypeImage - BinaryAssetTypeResource = rpc.BinaryAssetTypeResource - CitationLocationTypeBlock = rpc.CitationLocationTypeBlock - CitationLocationTypeChar = rpc.CitationLocationTypeChar - CitationLocationTypePage = rpc.CitationLocationTypePage - CitationProviderAnthropic = rpc.CitationProviderAnthropic - CitationProviderClient = rpc.CitationProviderClient - CitationProviderOpenai = rpc.CitationProviderOpenai - CompactionTriggerContextLimitRetry = rpc.CompactionTriggerContextLimitRetry - CompactionTriggerManual = rpc.CompactionTriggerManual - CompactionTriggerMemoryPressure = rpc.CompactionTriggerMemoryPressure - CompactionTriggerModelSwitch = rpc.CompactionTriggerModelSwitch - CompactionTriggerThreshold = rpc.CompactionTriggerThreshold - CompletionReceiptStopReasonAgentStopBlockLimit = rpc.CompletionReceiptStopReasonAgentStopBlockLimit - CompletionReceiptStopReasonNatural = rpc.CompletionReceiptStopReasonNatural - CompletionReceiptStopReasonTerminalTool = rpc.CompletionReceiptStopReasonTerminalTool - CompletionReceiptToolStatusDenied = rpc.CompletionReceiptToolStatusDenied - CompletionReceiptToolStatusFailure = rpc.CompletionReceiptToolStatusFailure - CompletionReceiptToolStatusRejected = rpc.CompletionReceiptToolStatusRejected - CompletionReceiptToolStatusSuccess = rpc.CompletionReceiptToolStatusSuccess - CompletionReceiptToolStatusTimeout = rpc.CompletionReceiptToolStatusTimeout - ContextTierDefault = rpc.ContextTierDefault - ContextTierLongContext = rpc.ContextTierLongContext - ElicitationCompletedActionAccept = rpc.ElicitationCompletedActionAccept - ElicitationCompletedActionCancel = rpc.ElicitationCompletedActionCancel - ElicitationCompletedActionDecline = rpc.ElicitationCompletedActionDecline - ElicitationRequestedModeForm = rpc.ElicitationRequestedModeForm - ElicitationRequestedModeURL = rpc.ElicitationRequestedModeURL - ElicitationRequestedSchemaTypeObject = rpc.ElicitationRequestedSchemaTypeObject - ExitPlanModeActionAutopilot = rpc.ExitPlanModeActionAutopilot - ExitPlanModeActionAutopilotFleet = rpc.ExitPlanModeActionAutopilotFleet - ExitPlanModeActionExitOnly = rpc.ExitPlanModeActionExitOnly - ExitPlanModeActionInteractive = rpc.ExitPlanModeActionInteractive - ExtensionsLoadedExtensionSourcePlugin = rpc.ExtensionsLoadedExtensionSourcePlugin - ExtensionsLoadedExtensionSourceProject = rpc.ExtensionsLoadedExtensionSourceProject - ExtensionsLoadedExtensionSourceSession = rpc.ExtensionsLoadedExtensionSourceSession - ExtensionsLoadedExtensionSourceUser = rpc.ExtensionsLoadedExtensionSourceUser - ExtensionsLoadedExtensionStatusDisabled = rpc.ExtensionsLoadedExtensionStatusDisabled - ExtensionsLoadedExtensionStatusFailed = rpc.ExtensionsLoadedExtensionStatusFailed - ExtensionsLoadedExtensionStatusRunning = rpc.ExtensionsLoadedExtensionStatusRunning - ExtensionsLoadedExtensionStatusStarting = rpc.ExtensionsLoadedExtensionStatusStarting - FactoryPermissionOperationAuthor = rpc.FactoryPermissionOperationAuthor - FactoryPermissionOperationRun = rpc.FactoryPermissionOperationRun - FactoryRunSettledStatusCancelled = rpc.FactoryRunSettledStatusCancelled - FactoryRunSettledStatusCompleted = rpc.FactoryRunSettledStatusCompleted - FactoryRunSettledStatusError = rpc.FactoryRunSettledStatusError - FactoryRunSettledStatusHalted = rpc.FactoryRunSettledStatusHalted - FactoryRunSettledStatusPaused = rpc.FactoryRunSettledStatusPaused - FusionConversationScopeReview = rpc.FusionConversationScopeReview - FusionConversationScopeRoot = rpc.FusionConversationScopeRoot - FusionFollowUpActionReroute = rpc.FusionFollowUpActionReroute - FusionFollowUpActionReusePrimary = rpc.FusionFollowUpActionReusePrimary - FusionPatternCascade = rpc.FusionPatternCascade - FusionPatternCritique = rpc.FusionPatternCritique - FusionPatternSingle = rpc.FusionPatternSingle - FusionPhaseActivityKindModelOutput = rpc.FusionPhaseActivityKindModelOutput - FusionPhaseActivityKindToolCompleted = rpc.FusionPhaseActivityKindToolCompleted - FusionPhaseActivityKindToolStarted = rpc.FusionPhaseActivityKindToolStarted - FusionPhaseKindCritic = rpc.FusionPhaseKindCritic - FusionPhaseKindDraft = rpc.FusionPhaseKindDraft - FusionPhaseKindFollowUp = rpc.FusionPhaseKindFollowUp - FusionPhaseKindJudge = rpc.FusionPhaseKindJudge - FusionPhaseKindPrimary = rpc.FusionPhaseKindPrimary - FusionPhaseKindRepair = rpc.FusionPhaseKindRepair - FusionPhaseKindRevision = rpc.FusionPhaseKindRevision - FusionPhaseStatusCancelled = rpc.FusionPhaseStatusCancelled - FusionPhaseStatusFailed = rpc.FusionPhaseStatusFailed - FusionPhaseStatusSucceeded = rpc.FusionPhaseStatusSucceeded - FusionProjectionModeAppend = rpc.FusionProjectionModeAppend - FusionProjectionModeNone = rpc.FusionProjectionModeNone - FusionProjectionModeStaged = rpc.FusionProjectionModeStaged - FusionTurnKindCompaction = rpc.FusionTurnKindCompaction - FusionTurnKindUser = rpc.FusionTurnKindUser - HandoffSourceTypeLocal = rpc.HandoffSourceTypeLocal - HandoffSourceTypeRemote = rpc.HandoffSourceTypeRemote - ManagedSettingsEnforcedActionBypassPermissionsBlocked = rpc.ManagedSettingsEnforcedActionBypassPermissionsBlocked - ManagedSettingsEnforcedEscalationAllowAll = rpc.ManagedSettingsEnforcedEscalationAllowAll - ManagedSettingsEnforcedEscalationApproveAll = rpc.ManagedSettingsEnforcedEscalationApproveAll - ManagedSettingsEnforcedEscalationAssistedApproval = rpc.ManagedSettingsEnforcedEscalationAssistedApproval - ManagedSettingsEnforcedEscalationServerWideMCPApproval = rpc.ManagedSettingsEnforcedEscalationServerWideMCPApproval - ManagedSettingsEnforcedEscalationUnrestrictedPaths = rpc.ManagedSettingsEnforcedEscalationUnrestrictedPaths - ManagedSettingsEnforcedEscalationUnrestrictedURLs = rpc.ManagedSettingsEnforcedEscalationUnrestrictedURLs - ManagedSettingsResolvedSourceClient = rpc.ManagedSettingsResolvedSourceClient - ManagedSettingsResolvedSourceDevice = rpc.ManagedSettingsResolvedSourceDevice - ManagedSettingsResolvedSourceMixed = rpc.ManagedSettingsResolvedSourceMixed - ManagedSettingsResolvedSourceNone = rpc.ManagedSettingsResolvedSourceNone - ManagedSettingsResolvedSourcePolicyHelper = rpc.ManagedSettingsResolvedSourcePolicyHelper - ManagedSettingsResolvedSourceServer = rpc.ManagedSettingsResolvedSourceServer - MCPHeadersRefreshCompletedOutcomeError = rpc.MCPHeadersRefreshCompletedOutcomeError - MCPHeadersRefreshCompletedOutcomeHeaders = rpc.MCPHeadersRefreshCompletedOutcomeHeaders - MCPHeadersRefreshCompletedOutcomeNone = rpc.MCPHeadersRefreshCompletedOutcomeNone - MCPHeadersRefreshCompletedOutcomeTimeout = rpc.MCPHeadersRefreshCompletedOutcomeTimeout - MCPHeadersRefreshRequiredReasonAuthFailed = rpc.MCPHeadersRefreshRequiredReasonAuthFailed - MCPHeadersRefreshRequiredReasonStartup = rpc.MCPHeadersRefreshRequiredReasonStartup - MCPHeadersRefreshRequiredReasonTtlExpired = rpc.MCPHeadersRefreshRequiredReasonTtlExpired - MCPOauthCompletionOutcomeCancelled = rpc.MCPOauthCompletionOutcomeCancelled - MCPOauthCompletionOutcomeToken = rpc.MCPOauthCompletionOutcomeToken - MCPOauthRequestReasonInitial = rpc.MCPOauthRequestReasonInitial - MCPOauthRequestReasonReauth = rpc.MCPOauthRequestReasonReauth - MCPOauthRequestReasonRefresh = rpc.MCPOauthRequestReasonRefresh - MCPOauthRequestReasonUpscope = rpc.MCPOauthRequestReasonUpscope - MCPOauthRequiredStaticClientConfigGrantTypeClientCredentials = rpc.MCPOauthRequiredStaticClientConfigGrantTypeClientCredentials - MCPServerSourceBuiltin = rpc.MCPServerSourceBuiltin - MCPServerSourceManaged = rpc.MCPServerSourceManaged - MCPServerSourcePlugin = rpc.MCPServerSourcePlugin - MCPServerSourceUser = rpc.MCPServerSourceUser - MCPServerSourceWorkspace = rpc.MCPServerSourceWorkspace - MCPServerStatusConnected = rpc.MCPServerStatusConnected - MCPServerStatusDisabled = rpc.MCPServerStatusDisabled - MCPServerStatusFailed = rpc.MCPServerStatusFailed - MCPServerStatusNeedsAuth = rpc.MCPServerStatusNeedsAuth - MCPServerStatusNotConfigured = rpc.MCPServerStatusNotConfigured - MCPServerStatusPending = rpc.MCPServerStatusPending - MCPServerStatusStopped = rpc.MCPServerStatusStopped - MCPServerTransportHTTP = rpc.MCPServerTransportHTTP - MCPServerTransportMemory = rpc.MCPServerTransportMemory - MCPServerTransportSSE = rpc.MCPServerTransportSSE - MCPServerTransportStdio = rpc.MCPServerTransportStdio - ModelCallFailureBadRequestKindBodyless = rpc.ModelCallFailureBadRequestKindBodyless - ModelCallFailureBadRequestKindStructuredError = rpc.ModelCallFailureBadRequestKindStructuredError - ModelCallFailureKindAPI = rpc.ModelCallFailureKindAPI - ModelCallFailureKindTransport = rpc.ModelCallFailureKindTransport - ModelCallFailureSourceMCPSampling = rpc.ModelCallFailureSourceMCPSampling - ModelCallFailureSourceSubagent = rpc.ModelCallFailureSourceSubagent - ModelCallFailureSourceTopLevel = rpc.ModelCallFailureSourceTopLevel - ModelCallFailureTransportHTTP = rpc.ModelCallFailureTransportHTTP - ModelCallFailureTransportWebsocket = rpc.ModelCallFailureTransportWebsocket - ModelCallFinishedOutcomeCancelled = rpc.ModelCallFinishedOutcomeCancelled - ModelCallFinishedOutcomeError = rpc.ModelCallFinishedOutcomeError - ModelCallFinishedOutcomeRejected = rpc.ModelCallFinishedOutcomeRejected - ModelCallFinishedOutcomeSuccess = rpc.ModelCallFinishedOutcomeSuccess - ModelChangeSourceAgent = rpc.ModelChangeSourceAgent - ModelChangeSourceAutomatic = rpc.ModelChangeSourceAutomatic - ModelChangeSourceConfigCommand = rpc.ModelChangeSourceConfigCommand - ModelChangeSourceManagedSettings = rpc.ModelChangeSourceManagedSettings - ModelChangeSourceModelCommand = rpc.ModelChangeSourceModelCommand - ModelChangeSourceModelPicker = rpc.ModelChangeSourceModelPicker - ModelChangeSourcePlanMode = rpc.ModelChangeSourcePlanMode - ModelChangeSourceRepoSettings = rpc.ModelChangeSourceRepoSettings - ModelChangeSourceSDK = rpc.ModelChangeSourceSDK - ModelChangeSourceSettingsCommand = rpc.ModelChangeSourceSettingsCommand - ModelChangeSourceStartup = rpc.ModelChangeSourceStartup - OmittedBinaryOmittedReasonAssetUnavailable = rpc.OmittedBinaryOmittedReasonAssetUnavailable - OmittedBinaryOmittedReasonTooLarge = rpc.OmittedBinaryOmittedReasonTooLarge - OmittedBinaryTypeImage = rpc.OmittedBinaryTypeImage - OmittedBinaryTypeResource = rpc.OmittedBinaryTypeResource - PermissionDecisionSourceAuthorizationCarryForward = rpc.PermissionDecisionSourceAuthorizationCarryForward - PermissionMessageAuthorizationPolarityDenial = rpc.PermissionMessageAuthorizationPolarityDenial - PermissionMessageAuthorizationPolarityGrant = rpc.PermissionMessageAuthorizationPolarityGrant - PermissionModeAllowAll = rpc.PermissionModeAllowAll - PermissionModeAssisted = rpc.PermissionModeAssisted - PermissionModeManual = rpc.PermissionModeManual - PermissionPromptRequestKindCommands = rpc.PermissionPromptRequestKindCommands - PermissionPromptRequestKindCustomTool = rpc.PermissionPromptRequestKindCustomTool - PermissionPromptRequestKindExtensionEnvAccess = rpc.PermissionPromptRequestKindExtensionEnvAccess - PermissionPromptRequestKindExtensionManagement = rpc.PermissionPromptRequestKindExtensionManagement - PermissionPromptRequestKindExtensionPermissionAccess = rpc.PermissionPromptRequestKindExtensionPermissionAccess - PermissionPromptRequestKindFactory = rpc.PermissionPromptRequestKindFactory - PermissionPromptRequestKindHook = rpc.PermissionPromptRequestKindHook - PermissionPromptRequestKindMCP = rpc.PermissionPromptRequestKindMCP - PermissionPromptRequestKindMemory = rpc.PermissionPromptRequestKindMemory - PermissionPromptRequestKindPath = rpc.PermissionPromptRequestKindPath - PermissionPromptRequestKindRead = rpc.PermissionPromptRequestKindRead - PermissionPromptRequestKindURL = rpc.PermissionPromptRequestKindURL - PermissionPromptRequestKindWrite = rpc.PermissionPromptRequestKindWrite - PermissionPromptRequestPathAccessKindRead = rpc.PermissionPromptRequestPathAccessKindRead - PermissionPromptRequestPathAccessKindShell = rpc.PermissionPromptRequestPathAccessKindShell - PermissionPromptRequestPathAccessKindWrite = rpc.PermissionPromptRequestPathAccessKindWrite - PermissionRecommendationApprove = rpc.PermissionRecommendationApprove - PermissionRequestKindCustomTool = rpc.PermissionRequestKindCustomTool - PermissionRequestKindExtensionEnvAccess = rpc.PermissionRequestKindExtensionEnvAccess - PermissionRequestKindExtensionManagement = rpc.PermissionRequestKindExtensionManagement - PermissionRequestKindExtensionPermissionAccess = rpc.PermissionRequestKindExtensionPermissionAccess - PermissionRequestKindFactory = rpc.PermissionRequestKindFactory - PermissionRequestKindHook = rpc.PermissionRequestKindHook - PermissionRequestKindMCP = rpc.PermissionRequestKindMCP - PermissionRequestKindMemory = rpc.PermissionRequestKindMemory - PermissionRequestKindRead = rpc.PermissionRequestKindRead - PermissionRequestKindShell = rpc.PermissionRequestKindShell - PermissionRequestKindURL = rpc.PermissionRequestKindURL - PermissionRequestKindWrite = rpc.PermissionRequestKindWrite - PermissionRequestMemoryActionStore = rpc.PermissionRequestMemoryActionStore - PermissionRequestMemoryActionVote = rpc.PermissionRequestMemoryActionVote - PermissionRequestMemoryDirectionDownvote = rpc.PermissionRequestMemoryDirectionDownvote - PermissionRequestMemoryDirectionUpvote = rpc.PermissionRequestMemoryDirectionUpvote - PermissionRequestMemoryScopeRepository = rpc.PermissionRequestMemoryScopeRepository - PermissionRequestMemoryScopeUser = rpc.PermissionRequestMemoryScopeUser - PermissionResultKindApproved = rpc.PermissionResultKindApproved - PermissionResultKindApprovedForLocation = rpc.PermissionResultKindApprovedForLocation - PermissionResultKindApprovedForSession = rpc.PermissionResultKindApprovedForSession - PermissionResultKindCancelled = rpc.PermissionResultKindCancelled - PermissionResultKindDeniedByContentExclusionPolicy = rpc.PermissionResultKindDeniedByContentExclusionPolicy - PermissionResultKindDeniedByPermissionRequestHook = rpc.PermissionResultKindDeniedByPermissionRequestHook - PermissionResultKindDeniedByRules = rpc.PermissionResultKindDeniedByRules - PermissionResultKindDeniedInteractivelyByUser = rpc.PermissionResultKindDeniedInteractivelyByUser - PermissionResultKindDeniedNoApprovalRuleAndCouldNotRequestFromUser = rpc.PermissionResultKindDeniedNoApprovalRuleAndCouldNotRequestFromUser - PersistedBinaryImageTypeImage = rpc.PersistedBinaryImageTypeImage - PersistedBinaryImageTypeResource = rpc.PersistedBinaryImageTypeResource - PersistedBinaryResultTypeImage = rpc.PersistedBinaryResultTypeImage - PersistedBinaryResultTypeResource = rpc.PersistedBinaryResultTypeResource - PlanChangedOperationCreate = rpc.PlanChangedOperationCreate - PlanChangedOperationDelete = rpc.PlanChangedOperationDelete - PlanChangedOperationUpdate = rpc.PlanChangedOperationUpdate - ReasoningSummaryConcise = rpc.ReasoningSummaryConcise - ReasoningSummaryDetailed = rpc.ReasoningSummaryDetailed - ReasoningSummaryNone = rpc.ReasoningSummaryNone - RecommendedAutoTierBalance = rpc.RecommendedAutoTierBalance - RecommendedAutoTierEfficiency = rpc.RecommendedAutoTierEfficiency - RecommendedAutoTierIntelligence = rpc.RecommendedAutoTierIntelligence - RemediationActionAllowSandboxOutbound = rpc.RemediationActionAllowSandboxOutbound - RemediationActionReviewSandboxPolicy = rpc.RemediationActionReviewSandboxPolicy - RemediationActionShowAccount = rpc.RemediationActionShowAccount - RemediationActionSignIn = rpc.RemediationActionSignIn - RemediationActionSwitchAccount = rpc.RemediationActionSwitchAccount - ScheduleOriginModel = rpc.ScheduleOriginModel - ScheduleOriginUser = rpc.ScheduleOriginUser - SessionEventTypeAbort = rpc.SessionEventTypeAbort - SessionEventTypeAgentInterrupted = rpc.SessionEventTypeAgentInterrupted - SessionEventTypeAssistantFusionPhaseActivity = rpc.SessionEventTypeAssistantFusionPhaseActivity - SessionEventTypeAssistantFusionPhaseCompleted = rpc.SessionEventTypeAssistantFusionPhaseCompleted - SessionEventTypeAssistantFusionPhaseFailed = rpc.SessionEventTypeAssistantFusionPhaseFailed - SessionEventTypeAssistantFusionPhaseStarted = rpc.SessionEventTypeAssistantFusionPhaseStarted - SessionEventTypeAssistantIdle = rpc.SessionEventTypeAssistantIdle - SessionEventTypeAssistantIntent = rpc.SessionEventTypeAssistantIntent - SessionEventTypeAssistantMessage = rpc.SessionEventTypeAssistantMessage - SessionEventTypeAssistantMessageDelta = rpc.SessionEventTypeAssistantMessageDelta - SessionEventTypeAssistantMessageStart = rpc.SessionEventTypeAssistantMessageStart - SessionEventTypeAssistantReasoning = rpc.SessionEventTypeAssistantReasoning - SessionEventTypeAssistantReasoningDelta = rpc.SessionEventTypeAssistantReasoningDelta - SessionEventTypeAssistantServerToolProgress = rpc.SessionEventTypeAssistantServerToolProgress - SessionEventTypeAssistantStreamingDelta = rpc.SessionEventTypeAssistantStreamingDelta - SessionEventTypeAssistantToolCallDelta = rpc.SessionEventTypeAssistantToolCallDelta - SessionEventTypeAssistantTurnEnd = rpc.SessionEventTypeAssistantTurnEnd - SessionEventTypeAssistantTurnRetry = rpc.SessionEventTypeAssistantTurnRetry - SessionEventTypeAssistantTurnStart = rpc.SessionEventTypeAssistantTurnStart - SessionEventTypeAssistantUsage = rpc.SessionEventTypeAssistantUsage - SessionEventTypeAutoModeSwitchCompleted = rpc.SessionEventTypeAutoModeSwitchCompleted - SessionEventTypeAutoModeSwitchRequested = rpc.SessionEventTypeAutoModeSwitchRequested - SessionEventTypeCapabilitiesChanged = rpc.SessionEventTypeCapabilitiesChanged - SessionEventTypeCommandCompleted = rpc.SessionEventTypeCommandCompleted - SessionEventTypeCommandExecute = rpc.SessionEventTypeCommandExecute - SessionEventTypeCommandQueued = rpc.SessionEventTypeCommandQueued - SessionEventTypeCommandsChanged = rpc.SessionEventTypeCommandsChanged - SessionEventTypeElicitationCompleted = rpc.SessionEventTypeElicitationCompleted - SessionEventTypeElicitationRequested = rpc.SessionEventTypeElicitationRequested - SessionEventTypeExitPlanModeCompleted = rpc.SessionEventTypeExitPlanModeCompleted - SessionEventTypeExitPlanModeRequested = rpc.SessionEventTypeExitPlanModeRequested - SessionEventTypeExternalToolCompleted = rpc.SessionEventTypeExternalToolCompleted - SessionEventTypeExternalToolRequested = rpc.SessionEventTypeExternalToolRequested - SessionEventTypeFactoryRunSettled = rpc.SessionEventTypeFactoryRunSettled - SessionEventTypeFactoryRunStarted = rpc.SessionEventTypeFactoryRunStarted - SessionEventTypeFactoryRunUpdated = rpc.SessionEventTypeFactoryRunUpdated - SessionEventTypeHookEnd = rpc.SessionEventTypeHookEnd - SessionEventTypeHookProgress = rpc.SessionEventTypeHookProgress - SessionEventTypeHookStart = rpc.SessionEventTypeHookStart - SessionEventTypeMCPAppToolCallComplete = rpc.SessionEventTypeMCPAppToolCallComplete - SessionEventTypeMCPHeadersRefreshCompleted = rpc.SessionEventTypeMCPHeadersRefreshCompleted - SessionEventTypeMCPHeadersRefreshRequired = rpc.SessionEventTypeMCPHeadersRefreshRequired - SessionEventTypeMCPOauthCompleted = rpc.SessionEventTypeMCPOauthCompleted - SessionEventTypeMCPOauthRequired = rpc.SessionEventTypeMCPOauthRequired - SessionEventTypeMCPPromptsListChanged = rpc.SessionEventTypeMCPPromptsListChanged - SessionEventTypeMCPResourcesListChanged = rpc.SessionEventTypeMCPResourcesListChanged - SessionEventTypeMCPToolsListChanged = rpc.SessionEventTypeMCPToolsListChanged - SessionEventTypeModelCallFailure = rpc.SessionEventTypeModelCallFailure - SessionEventTypeModelCallFinished = rpc.SessionEventTypeModelCallFinished - SessionEventTypeModelCallStart = rpc.SessionEventTypeModelCallStart - SessionEventTypePendingMessagesModified = rpc.SessionEventTypePendingMessagesModified - SessionEventTypePermissionAssentDetected = rpc.SessionEventTypePermissionAssentDetected - SessionEventTypePermissionCarriedForward = rpc.SessionEventTypePermissionCarriedForward - SessionEventTypePermissionCompleted = rpc.SessionEventTypePermissionCompleted - SessionEventTypePermissionContextualAuthorization = rpc.SessionEventTypePermissionContextualAuthorization - SessionEventTypePermissionMessageAuthorization = rpc.SessionEventTypePermissionMessageAuthorization - SessionEventTypePermissionMessageAuthorizationDegraded = rpc.SessionEventTypePermissionMessageAuthorizationDegraded - SessionEventTypePermissionMessageAuthorizationRead = rpc.SessionEventTypePermissionMessageAuthorizationRead - SessionEventTypePermissionRequested = rpc.SessionEventTypePermissionRequested - SessionEventTypePromptCacheBreak = rpc.SessionEventTypePromptCacheBreak - SessionEventTypeSamplingCompleted = rpc.SessionEventTypeSamplingCompleted - SessionEventTypeSamplingRequested = rpc.SessionEventTypeSamplingRequested - SessionEventTypeSandboxDecision = rpc.SessionEventTypeSandboxDecision - SessionEventTypeSessionAutoModeResolved = rpc.SessionEventTypeSessionAutoModeResolved - SessionEventTypeSessionAutopilotObjectiveChanged = rpc.SessionEventTypeSessionAutopilotObjectiveChanged - SessionEventTypeSessionAutoTierRecommendation = rpc.SessionEventTypeSessionAutoTierRecommendation - SessionEventTypeSessionAutoTierSwitchFailed = rpc.SessionEventTypeSessionAutoTierSwitchFailed - SessionEventTypeSessionBackgroundTasksChanged = rpc.SessionEventTypeSessionBackgroundTasksChanged - SessionEventTypeSessionBinaryAsset = rpc.SessionEventTypeSessionBinaryAsset - SessionEventTypeSessionCanvasClosed = rpc.SessionEventTypeSessionCanvasClosed - SessionEventTypeSessionCanvasOpened = rpc.SessionEventTypeSessionCanvasOpened - SessionEventTypeSessionCanvasRecorded = rpc.SessionEventTypeSessionCanvasRecorded - SessionEventTypeSessionCanvasRegistryChanged = rpc.SessionEventTypeSessionCanvasRegistryChanged - SessionEventTypeSessionCanvasRemoved = rpc.SessionEventTypeSessionCanvasRemoved - SessionEventTypeSessionCanvasUnavailable = rpc.SessionEventTypeSessionCanvasUnavailable - SessionEventTypeSessionCompactionComplete = rpc.SessionEventTypeSessionCompactionComplete - SessionEventTypeSessionCompactionStart = rpc.SessionEventTypeSessionCompactionStart - SessionEventTypeSessionCompletionReceipt = rpc.SessionEventTypeSessionCompletionReceipt - SessionEventTypeSessionContextChanged = rpc.SessionEventTypeSessionContextChanged - SessionEventTypeSessionContextCleared = rpc.SessionEventTypeSessionContextCleared - SessionEventTypeSessionCustomAgentsUpdated = rpc.SessionEventTypeSessionCustomAgentsUpdated - SessionEventTypeSessionCustomNotification = rpc.SessionEventTypeSessionCustomNotification - SessionEventTypeSessionError = rpc.SessionEventTypeSessionError - SessionEventTypeSessionExtensionsAttachmentsPushed = rpc.SessionEventTypeSessionExtensionsAttachmentsPushed - SessionEventTypeSessionExtensionsLoaded = rpc.SessionEventTypeSessionExtensionsLoaded - SessionEventTypeSessionFusionCompleted = rpc.SessionEventTypeSessionFusionCompleted - SessionEventTypeSessionFusionResolved = rpc.SessionEventTypeSessionFusionResolved - SessionEventTypeSessionFusionRouteFailed = rpc.SessionEventTypeSessionFusionRouteFailed - SessionEventTypeSessionFusionRouteStarted = rpc.SessionEventTypeSessionFusionRouteStarted - SessionEventTypeSessionHandoff = rpc.SessionEventTypeSessionHandoff - SessionEventTypeSessionIdle = rpc.SessionEventTypeSessionIdle - SessionEventTypeSessionInfo = rpc.SessionEventTypeSessionInfo - SessionEventTypeSessionLimitsExhaustedCompleted = rpc.SessionEventTypeSessionLimitsExhaustedCompleted - SessionEventTypeSessionLimitsExhaustedRequested = rpc.SessionEventTypeSessionLimitsExhaustedRequested - SessionEventTypeSessionManagedSettingsEnforced = rpc.SessionEventTypeSessionManagedSettingsEnforced - SessionEventTypeSessionManagedSettingsResolved = rpc.SessionEventTypeSessionManagedSettingsResolved - SessionEventTypeSessionMCPServerNeedsReconnect = rpc.SessionEventTypeSessionMCPServerNeedsReconnect - SessionEventTypeSessionMCPServerRemoved = rpc.SessionEventTypeSessionMCPServerRemoved - SessionEventTypeSessionMCPServersLoaded = rpc.SessionEventTypeSessionMCPServersLoaded - SessionEventTypeSessionMCPServerStatusChanged = rpc.SessionEventTypeSessionMCPServerStatusChanged - SessionEventTypeSessionModeChanged = rpc.SessionEventTypeSessionModeChanged - SessionEventTypeSessionModelChange = rpc.SessionEventTypeSessionModelChange - SessionEventTypeSessionModeNoticeDelivered = rpc.SessionEventTypeSessionModeNoticeDelivered - SessionEventTypeSessionPermissionsChanged = rpc.SessionEventTypeSessionPermissionsChanged - SessionEventTypeSessionPlanChanged = rpc.SessionEventTypeSessionPlanChanged - SessionEventTypeSessionRemoteSteerableChanged = rpc.SessionEventTypeSessionRemoteSteerableChanged - SessionEventTypeSessionResume = rpc.SessionEventTypeSessionResume - SessionEventTypeSessionScheduleCancelled = rpc.SessionEventTypeSessionScheduleCancelled - SessionEventTypeSessionScheduleCreated = rpc.SessionEventTypeSessionScheduleCreated - SessionEventTypeSessionScheduleRearmed = rpc.SessionEventTypeSessionScheduleRearmed - SessionEventTypeSessionSessionLimitsChanged = rpc.SessionEventTypeSessionSessionLimitsChanged - SessionEventTypeSessionShutdown = rpc.SessionEventTypeSessionShutdown - SessionEventTypeSessionSkillsLoaded = rpc.SessionEventTypeSessionSkillsLoaded - SessionEventTypeSessionSnapshotRewind = rpc.SessionEventTypeSessionSnapshotRewind - SessionEventTypeSessionStart = rpc.SessionEventTypeSessionStart - SessionEventTypeSessionTaskComplete = rpc.SessionEventTypeSessionTaskComplete - SessionEventTypeSessionTitleChanged = rpc.SessionEventTypeSessionTitleChanged - SessionEventTypeSessionTodosChanged = rpc.SessionEventTypeSessionTodosChanged - SessionEventTypeSessionToolsUpdated = rpc.SessionEventTypeSessionToolsUpdated - SessionEventTypeSessionTruncation = rpc.SessionEventTypeSessionTruncation - SessionEventTypeSessionUsageCheckpoint = rpc.SessionEventTypeSessionUsageCheckpoint - SessionEventTypeSessionUsageInfo = rpc.SessionEventTypeSessionUsageInfo - SessionEventTypeSessionWarning = rpc.SessionEventTypeSessionWarning - SessionEventTypeSessionWorkspaceFileChanged = rpc.SessionEventTypeSessionWorkspaceFileChanged - SessionEventTypeSkillContextDelivered = rpc.SessionEventTypeSkillContextDelivered - SessionEventTypeSkillContextDeliveredRef = rpc.SessionEventTypeSkillContextDeliveredRef - SessionEventTypeSkillInvoked = rpc.SessionEventTypeSkillInvoked - SessionEventTypeSkillInvokedRef = rpc.SessionEventTypeSkillInvokedRef - SessionEventTypeSubagentCompleted = rpc.SessionEventTypeSubagentCompleted - SessionEventTypeSubagentConfigured = rpc.SessionEventTypeSubagentConfigured - SessionEventTypeSubagentDeselected = rpc.SessionEventTypeSubagentDeselected - SessionEventTypeSubagentFailed = rpc.SessionEventTypeSubagentFailed - SessionEventTypeSubagentSelected = rpc.SessionEventTypeSubagentSelected - SessionEventTypeSubagentStarted = rpc.SessionEventTypeSubagentStarted - SessionEventTypeSystemMessage = rpc.SessionEventTypeSystemMessage - SessionEventTypeSystemNotification = rpc.SessionEventTypeSystemNotification - SessionEventTypeToolExecutionComplete = rpc.SessionEventTypeToolExecutionComplete - SessionEventTypeToolExecutionPartialResult = rpc.SessionEventTypeToolExecutionPartialResult - SessionEventTypeToolExecutionProgress = rpc.SessionEventTypeToolExecutionProgress - SessionEventTypeToolExecutionStart = rpc.SessionEventTypeToolExecutionStart - SessionEventTypeToolSearchActivated = rpc.SessionEventTypeToolSearchActivated - SessionEventTypeToolUserRequested = rpc.SessionEventTypeToolUserRequested - SessionEventTypeUIEphemeralQuery = rpc.SessionEventTypeUIEphemeralQuery - SessionEventTypeUserInputCompleted = rpc.SessionEventTypeUserInputCompleted - SessionEventTypeUserInputRequested = rpc.SessionEventTypeUserInputRequested - SessionEventTypeUserMessage = rpc.SessionEventTypeUserMessage - SessionLimitsExhaustedResponseActionAdd = rpc.SessionLimitsExhaustedResponseActionAdd - SessionLimitsExhaustedResponseActionCancel = rpc.SessionLimitsExhaustedResponseActionCancel - SessionLimitsExhaustedResponseActionSet = rpc.SessionLimitsExhaustedResponseActionSet - SessionLimitsExhaustedResponseActionUnset = rpc.SessionLimitsExhaustedResponseActionUnset - SessionModeAutopilot = rpc.SessionModeAutopilot - SessionModeInteractive = rpc.SessionModeInteractive - SessionModePlan = rpc.SessionModePlan - ShutdownTypeError = rpc.ShutdownTypeError - ShutdownTypeRoutine = rpc.ShutdownTypeRoutine - SkillInvokedTriggerAgentInvoked = rpc.SkillInvokedTriggerAgentInvoked - SkillInvokedTriggerContextLoad = rpc.SkillInvokedTriggerContextLoad - SkillInvokedTriggerUserInvoked = rpc.SkillInvokedTriggerUserInvoked - SkillSourceBuiltin = rpc.SkillSourceBuiltin - SkillSourceCustom = rpc.SkillSourceCustom - SkillSourceInherited = rpc.SkillSourceInherited - SkillSourcePersonalAgents = rpc.SkillSourcePersonalAgents - SkillSourcePersonalCopilot = rpc.SkillSourcePersonalCopilot - SkillSourcePlugin = rpc.SkillSourcePlugin - SkillSourceProject = rpc.SkillSourceProject - SkillSourceSDK = rpc.SkillSourceSDK - SubagentModelSelectionSourceAgentDefinitionDefault = rpc.SubagentModelSelectionSourceAgentDefinitionDefault - SubagentModelSelectionSourceComplementaryDefault = rpc.SubagentModelSelectionSourceComplementaryDefault - SubagentModelSelectionSourceConfiguredPreference = rpc.SubagentModelSelectionSourceConfiguredPreference - SubagentModelSelectionSourceConfiguredRequired = rpc.SubagentModelSelectionSourceConfiguredRequired - SubagentModelSelectionSourceExplicitOverride = rpc.SubagentModelSelectionSourceExplicitOverride - SubagentModelSelectionSourceRuntimePolicy = rpc.SubagentModelSelectionSourceRuntimePolicy - SubagentModelSelectionSourceSessionInheritance = rpc.SubagentModelSelectionSourceSessionInheritance - SubagentTaskModelSourceCustomAgentDefinition = rpc.SubagentTaskModelSourceCustomAgentDefinition - SubagentTaskModelSourceSubagentConfiguration = rpc.SubagentTaskModelSourceSubagentConfiguration - SubagentTaskModelSourceTaskArgument = rpc.SubagentTaskModelSourceTaskArgument - SubagentTaskModelSourceUnset = rpc.SubagentTaskModelSourceUnset - SystemMessageRoleDeveloper = rpc.SystemMessageRoleDeveloper - SystemMessageRoleSystem = rpc.SystemMessageRoleSystem - SystemNotificationAgentCompletedStatusCompleted = rpc.SystemNotificationAgentCompletedStatusCompleted - SystemNotificationAgentCompletedStatusFailed = rpc.SystemNotificationAgentCompletedStatusFailed - SystemNotificationFactoryCompletedStatusCancelled = rpc.SystemNotificationFactoryCompletedStatusCancelled - SystemNotificationFactoryCompletedStatusCompleted = rpc.SystemNotificationFactoryCompletedStatusCompleted - SystemNotificationFactoryCompletedStatusError = rpc.SystemNotificationFactoryCompletedStatusError - SystemNotificationFactoryCompletedStatusHalted = rpc.SystemNotificationFactoryCompletedStatusHalted - SystemNotificationFactoryCompletedStatusPaused = rpc.SystemNotificationFactoryCompletedStatusPaused - SystemNotificationFactoryPauseInfoTypeCheckpoint = rpc.SystemNotificationFactoryPauseInfoTypeCheckpoint - SystemNotificationFactoryPauseInfoTypeUser = rpc.SystemNotificationFactoryPauseInfoTypeUser - SystemNotificationTypeAgentCompleted = rpc.SystemNotificationTypeAgentCompleted - SystemNotificationTypeAgentIdle = rpc.SystemNotificationTypeAgentIdle - SystemNotificationTypeFactoryCompleted = rpc.SystemNotificationTypeFactoryCompleted - SystemNotificationTypeInstructionDiscovered = rpc.SystemNotificationTypeInstructionDiscovered - SystemNotificationTypeNewInboxMessage = rpc.SystemNotificationTypeNewInboxMessage - SystemNotificationTypeShellCompleted = rpc.SystemNotificationTypeShellCompleted - SystemNotificationTypeShellDetachedCompleted = rpc.SystemNotificationTypeShellDetachedCompleted - SystemNotificationTypeUnclassified = rpc.SystemNotificationTypeUnclassified - TaskCompletionOutcomeBlocked = rpc.TaskCompletionOutcomeBlocked - TaskCompletionOutcomeCompleted = rpc.TaskCompletionOutcomeCompleted - TaskCompletionOutcomeContinue = rpc.TaskCompletionOutcomeContinue - ToolExecutionCompleteContentResourceLinkIconThemeDark = rpc.ToolExecutionCompleteContentResourceLinkIconThemeDark - ToolExecutionCompleteContentResourceLinkIconThemeLight = rpc.ToolExecutionCompleteContentResourceLinkIconThemeLight - ToolExecutionCompleteContentTypeAudio = rpc.ToolExecutionCompleteContentTypeAudio - ToolExecutionCompleteContentTypeImage = rpc.ToolExecutionCompleteContentTypeImage - ToolExecutionCompleteContentTypeResource = rpc.ToolExecutionCompleteContentTypeResource - ToolExecutionCompleteContentTypeResourceLink = rpc.ToolExecutionCompleteContentTypeResourceLink - ToolExecutionCompleteContentTypeShellExit = rpc.ToolExecutionCompleteContentTypeShellExit - ToolExecutionCompleteContentTypeTerminal = rpc.ToolExecutionCompleteContentTypeTerminal - ToolExecutionCompleteContentTypeText = rpc.ToolExecutionCompleteContentTypeText - ToolExecutionCompleteToolDescriptionMetaUIVisibilityApp = rpc.ToolExecutionCompleteToolDescriptionMetaUIVisibilityApp - ToolExecutionCompleteToolDescriptionMetaUIVisibilityModel = rpc.ToolExecutionCompleteToolDescriptionMetaUIVisibilityModel - ToolExecutionStartToolDescriptionMetaUIVisibilityApp = rpc.ToolExecutionStartToolDescriptionMetaUIVisibilityApp - ToolExecutionStartToolDescriptionMetaUIVisibilityModel = rpc.ToolExecutionStartToolDescriptionMetaUIVisibilityModel - UIEphemeralQueryPhaseAborted = rpc.UIEphemeralQueryPhaseAborted - UIEphemeralQueryPhaseChunk = rpc.UIEphemeralQueryPhaseChunk - UIEphemeralQueryPhaseCompleted = rpc.UIEphemeralQueryPhaseCompleted - UIEphemeralQueryPhaseFailed = rpc.UIEphemeralQueryPhaseFailed - UIEphemeralQueryPhaseStarted = rpc.UIEphemeralQueryPhaseStarted - UserMessageAgentModeAutopilot = rpc.UserMessageAgentModeAutopilot - UserMessageAgentModeInteractive = rpc.UserMessageAgentModeInteractive - UserMessageAgentModePlan = rpc.UserMessageAgentModePlan - UserMessageAgentModeShell = rpc.UserMessageAgentModeShell - UserMessageDeliveryIdle = rpc.UserMessageDeliveryIdle - UserMessageDeliveryQueued = rpc.UserMessageDeliveryQueued - UserMessageDeliverySteering = rpc.UserMessageDeliverySteering - UserToolSessionApprovalKindCommands = rpc.UserToolSessionApprovalKindCommands - UserToolSessionApprovalKindCustomTool = rpc.UserToolSessionApprovalKindCustomTool - UserToolSessionApprovalKindExtensionEnvAccess = rpc.UserToolSessionApprovalKindExtensionEnvAccess - UserToolSessionApprovalKindExtensionManagement = rpc.UserToolSessionApprovalKindExtensionManagement - UserToolSessionApprovalKindExtensionPermissionAccess = rpc.UserToolSessionApprovalKindExtensionPermissionAccess - UserToolSessionApprovalKindFactory = rpc.UserToolSessionApprovalKindFactory - UserToolSessionApprovalKindMCP = rpc.UserToolSessionApprovalKindMCP - UserToolSessionApprovalKindMemory = rpc.UserToolSessionApprovalKindMemory - UserToolSessionApprovalKindRead = rpc.UserToolSessionApprovalKindRead - UserToolSessionApprovalKindWrite = rpc.UserToolSessionApprovalKindWrite - VerbosityHigh = rpc.VerbosityHigh - VerbosityLow = rpc.VerbosityLow - VerbosityMedium = rpc.VerbosityMedium - WorkingDirectoryContextHostTypeADO = rpc.WorkingDirectoryContextHostTypeADO - WorkingDirectoryContextHostTypeGitHub = rpc.WorkingDirectoryContextHostTypeGitHub - WorkspaceFileChangedOperationCreate = rpc.WorkspaceFileChangedOperationCreate - WorkspaceFileChangedOperationUpdate = rpc.WorkspaceFileChangedOperationUpdate + AbortReasonAutopilotCreditLimit = rpc.AbortReasonAutopilotCreditLimit + AbortReasonRemoteCommand = rpc.AbortReasonRemoteCommand + AbortReasonUserAbort = rpc.AbortReasonUserAbort + AbortReasonUserInitiated = rpc.AbortReasonUserInitiated + AgentInterruptedActivityBackgroundAgent = rpc.AgentInterruptedActivityBackgroundAgent + AgentInterruptedActivityModelCall = rpc.AgentInterruptedActivityModelCall + AgentInterruptedActivityRetryBackoff = rpc.AgentInterruptedActivityRetryBackoff + AgentInterruptedActivityToolCall = rpc.AgentInterruptedActivityToolCall + AgentInterruptedCancelPhaseMidStream = rpc.AgentInterruptedCancelPhaseMidStream + AgentInterruptedCancelPhasePreFirstToken = rpc.AgentInterruptedCancelPhasePreFirstToken + AgentModelPolicyPreferred = rpc.AgentModelPolicyPreferred + AgentModelPolicyRequired = rpc.AgentModelPolicyRequired + AssistantMessageToolRequestCallerTypeProgram = rpc.AssistantMessageToolRequestCallerTypeProgram + AssistantMessageToolRequestTypeCustom = rpc.AssistantMessageToolRequestTypeCustom + AssistantMessageToolRequestTypeFunction = rpc.AssistantMessageToolRequestTypeFunction + AssistantUsageAPIEndpointChatCompletions = rpc.AssistantUsageAPIEndpointChatCompletions + AssistantUsageAPIEndpointResponses = rpc.AssistantUsageAPIEndpointResponses + AssistantUsageAPIEndpointV1Messages = rpc.AssistantUsageAPIEndpointV1Messages + AssistantUsageAPIEndpointWsResponses = rpc.AssistantUsageAPIEndpointWsResponses + AssistantUsageTransportHTTP = rpc.AssistantUsageTransportHTTP + AssistantUsageTransportWebsocket = rpc.AssistantUsageTransportWebsocket + AssistedApprovalJudgeFailureReasonAbort = rpc.AssistedApprovalJudgeFailureReasonAbort + AssistedApprovalJudgeFailureReasonEmptyResponse = rpc.AssistedApprovalJudgeFailureReasonEmptyResponse + AssistedApprovalJudgeFailureReasonModelError = rpc.AssistedApprovalJudgeFailureReasonModelError + AssistedApprovalJudgeFailureReasonParseError = rpc.AssistedApprovalJudgeFailureReasonParseError + AssistedApprovalJudgeFailureReasonTimeout = rpc.AssistedApprovalJudgeFailureReasonTimeout + AssistedApprovalRecommendationApprove = rpc.AssistedApprovalRecommendationApprove + AssistedApprovalRecommendationError = rpc.AssistedApprovalRecommendationError + AssistedApprovalRecommendationExcluded = rpc.AssistedApprovalRecommendationExcluded + AssistedApprovalRecommendationRequireApproval = rpc.AssistedApprovalRecommendationRequireApproval + AttachmentGitHubReferenceTypeDiscussion = rpc.AttachmentGitHubReferenceTypeDiscussion + AttachmentGitHubReferenceTypeIssue = rpc.AttachmentGitHubReferenceTypeIssue + AttachmentGitHubReferenceTypePr = rpc.AttachmentGitHubReferenceTypePr + AttachmentTypeBlob = rpc.AttachmentTypeBlob + AttachmentTypeDirectory = rpc.AttachmentTypeDirectory + AttachmentTypeExtensionContext = rpc.AttachmentTypeExtensionContext + AttachmentTypeFile = rpc.AttachmentTypeFile + AttachmentTypeGitHubActionsJob = rpc.AttachmentTypeGitHubActionsJob + AttachmentTypeGitHubCommit = rpc.AttachmentTypeGitHubCommit + AttachmentTypeGitHubFile = rpc.AttachmentTypeGitHubFile + AttachmentTypeGitHubFileDiff = rpc.AttachmentTypeGitHubFileDiff + AttachmentTypeGitHubReference = rpc.AttachmentTypeGitHubReference + AttachmentTypeGitHubRelease = rpc.AttachmentTypeGitHubRelease + AttachmentTypeGitHubRepository = rpc.AttachmentTypeGitHubRepository + AttachmentTypeGitHubSnippet = rpc.AttachmentTypeGitHubSnippet + AttachmentTypeGitHubTreeComparison = rpc.AttachmentTypeGitHubTreeComparison + AttachmentTypeGitHubURL = rpc.AttachmentTypeGitHubURL + AttachmentTypeSelection = rpc.AttachmentTypeSelection + AutoModeResolvedReasoningBucketHigh = rpc.AutoModeResolvedReasoningBucketHigh + AutoModeResolvedReasoningBucketLow = rpc.AutoModeResolvedReasoningBucketLow + AutoModeResolvedReasoningBucketMedium = rpc.AutoModeResolvedReasoningBucketMedium + AutoModeSwitchResponseNo = rpc.AutoModeSwitchResponseNo + AutoModeSwitchResponseYes = rpc.AutoModeSwitchResponseYes + AutoModeSwitchResponseYesAlways = rpc.AutoModeSwitchResponseYesAlways + AutopilotObjectiveChangedOperationCreate = rpc.AutopilotObjectiveChangedOperationCreate + AutopilotObjectiveChangedOperationDelete = rpc.AutopilotObjectiveChangedOperationDelete + AutopilotObjectiveChangedOperationUpdate = rpc.AutopilotObjectiveChangedOperationUpdate + AutopilotObjectiveChangedStatusActive = rpc.AutopilotObjectiveChangedStatusActive + AutopilotObjectiveChangedStatusCapReached = rpc.AutopilotObjectiveChangedStatusCapReached + AutopilotObjectiveChangedStatusCompleted = rpc.AutopilotObjectiveChangedStatusCompleted + AutopilotObjectiveChangedStatusPaused = rpc.AutopilotObjectiveChangedStatusPaused + AutoTierFast = rpc.AutoTierFast + AutoTierSwitchFailureReasonPolicyRejected = rpc.AutoTierSwitchFailureReasonPolicyRejected + AutoTierSwitchFailureReasonRequestFailed = rpc.AutoTierSwitchFailureReasonRequestFailed + AutoTierSwitchFailureReasonSetupFailed = rpc.AutoTierSwitchFailureReasonSetupFailed + AutoTierSwitchFailureReasonUnsupported = rpc.AutoTierSwitchFailureReasonUnsupported + BinaryAssetReferenceTypeImage = rpc.BinaryAssetReferenceTypeImage + BinaryAssetReferenceTypeResource = rpc.BinaryAssetReferenceTypeResource + BinaryAssetTypeImage = rpc.BinaryAssetTypeImage + BinaryAssetTypeResource = rpc.BinaryAssetTypeResource + CitationLocationTypeBlock = rpc.CitationLocationTypeBlock + CitationLocationTypeChar = rpc.CitationLocationTypeChar + CitationLocationTypePage = rpc.CitationLocationTypePage + CitationProviderAnthropic = rpc.CitationProviderAnthropic + CitationProviderClient = rpc.CitationProviderClient + CitationProviderOpenai = rpc.CitationProviderOpenai + CompactionTriggerContextLimitRetry = rpc.CompactionTriggerContextLimitRetry + CompactionTriggerManual = rpc.CompactionTriggerManual + CompactionTriggerMemoryPressure = rpc.CompactionTriggerMemoryPressure + CompactionTriggerModelSwitch = rpc.CompactionTriggerModelSwitch + CompactionTriggerThreshold = rpc.CompactionTriggerThreshold + CompletionReceiptStopReasonAgentStopBlockLimit = rpc.CompletionReceiptStopReasonAgentStopBlockLimit + CompletionReceiptStopReasonNatural = rpc.CompletionReceiptStopReasonNatural + CompletionReceiptStopReasonTerminalTool = rpc.CompletionReceiptStopReasonTerminalTool + CompletionReceiptToolStatusDenied = rpc.CompletionReceiptToolStatusDenied + CompletionReceiptToolStatusFailure = rpc.CompletionReceiptToolStatusFailure + CompletionReceiptToolStatusRejected = rpc.CompletionReceiptToolStatusRejected + CompletionReceiptToolStatusSuccess = rpc.CompletionReceiptToolStatusSuccess + CompletionReceiptToolStatusTimeout = rpc.CompletionReceiptToolStatusTimeout + ContextTierDefault = rpc.ContextTierDefault + ContextTierLongContext = rpc.ContextTierLongContext + ElicitationCompletedActionAccept = rpc.ElicitationCompletedActionAccept + ElicitationCompletedActionCancel = rpc.ElicitationCompletedActionCancel + ElicitationCompletedActionDecline = rpc.ElicitationCompletedActionDecline + ElicitationRequestedModeForm = rpc.ElicitationRequestedModeForm + ElicitationRequestedModeURL = rpc.ElicitationRequestedModeURL + ElicitationRequestedSchemaTypeObject = rpc.ElicitationRequestedSchemaTypeObject + ExitPlanModeActionAutopilot = rpc.ExitPlanModeActionAutopilot + ExitPlanModeActionAutopilotFleet = rpc.ExitPlanModeActionAutopilotFleet + ExitPlanModeActionExitOnly = rpc.ExitPlanModeActionExitOnly + ExitPlanModeActionInteractive = rpc.ExitPlanModeActionInteractive + ExtensionsLoadedExtensionSourcePlugin = rpc.ExtensionsLoadedExtensionSourcePlugin + ExtensionsLoadedExtensionSourceProject = rpc.ExtensionsLoadedExtensionSourceProject + ExtensionsLoadedExtensionSourceSession = rpc.ExtensionsLoadedExtensionSourceSession + ExtensionsLoadedExtensionSourceUser = rpc.ExtensionsLoadedExtensionSourceUser + ExtensionsLoadedExtensionStatusDisabled = rpc.ExtensionsLoadedExtensionStatusDisabled + ExtensionsLoadedExtensionStatusFailed = rpc.ExtensionsLoadedExtensionStatusFailed + ExtensionsLoadedExtensionStatusRunning = rpc.ExtensionsLoadedExtensionStatusRunning + ExtensionsLoadedExtensionStatusStarting = rpc.ExtensionsLoadedExtensionStatusStarting + FactoryPermissionOperationAuthor = rpc.FactoryPermissionOperationAuthor + FactoryPermissionOperationRun = rpc.FactoryPermissionOperationRun + FactoryRunSettledStatusCancelled = rpc.FactoryRunSettledStatusCancelled + FactoryRunSettledStatusCompleted = rpc.FactoryRunSettledStatusCompleted + FactoryRunSettledStatusError = rpc.FactoryRunSettledStatusError + FactoryRunSettledStatusHalted = rpc.FactoryRunSettledStatusHalted + FactoryRunSettledStatusPaused = rpc.FactoryRunSettledStatusPaused + FusionConversationScopeReview = rpc.FusionConversationScopeReview + FusionConversationScopeRoot = rpc.FusionConversationScopeRoot + FusionFollowUpActionReroute = rpc.FusionFollowUpActionReroute + FusionFollowUpActionReusePrimary = rpc.FusionFollowUpActionReusePrimary + FusionPatternCascade = rpc.FusionPatternCascade + FusionPatternCritique = rpc.FusionPatternCritique + FusionPatternSingle = rpc.FusionPatternSingle + FusionPhaseActivityKindModelOutput = rpc.FusionPhaseActivityKindModelOutput + FusionPhaseActivityKindToolCompleted = rpc.FusionPhaseActivityKindToolCompleted + FusionPhaseActivityKindToolStarted = rpc.FusionPhaseActivityKindToolStarted + FusionPhaseKindCritic = rpc.FusionPhaseKindCritic + FusionPhaseKindDraft = rpc.FusionPhaseKindDraft + FusionPhaseKindFollowUp = rpc.FusionPhaseKindFollowUp + FusionPhaseKindJudge = rpc.FusionPhaseKindJudge + FusionPhaseKindPrimary = rpc.FusionPhaseKindPrimary + FusionPhaseKindRepair = rpc.FusionPhaseKindRepair + FusionPhaseKindRevision = rpc.FusionPhaseKindRevision + FusionPhaseStatusCancelled = rpc.FusionPhaseStatusCancelled + FusionPhaseStatusFailed = rpc.FusionPhaseStatusFailed + FusionPhaseStatusSucceeded = rpc.FusionPhaseStatusSucceeded + FusionProjectionModeAppend = rpc.FusionProjectionModeAppend + FusionProjectionModeNone = rpc.FusionProjectionModeNone + FusionProjectionModeStaged = rpc.FusionProjectionModeStaged + FusionTurnKindCompaction = rpc.FusionTurnKindCompaction + FusionTurnKindUser = rpc.FusionTurnKindUser + HandoffSourceTypeLocal = rpc.HandoffSourceTypeLocal + HandoffSourceTypeRemote = rpc.HandoffSourceTypeRemote + IndexedSearchStateDisabled = rpc.IndexedSearchStateDisabled + IndexedSearchStateEnabled = rpc.IndexedSearchStateEnabled + IndexedSearchStateFailed = rpc.IndexedSearchStateFailed + IndexedSearchStateReady = rpc.IndexedSearchStateReady + IndexedSearchStateStarting = rpc.IndexedSearchStateStarting + ManagedSettingsEnforcedActionBypassPermissionsBlocked = rpc.ManagedSettingsEnforcedActionBypassPermissionsBlocked + ManagedSettingsEnforcedEscalationAllowAll = rpc.ManagedSettingsEnforcedEscalationAllowAll + ManagedSettingsEnforcedEscalationApproveAll = rpc.ManagedSettingsEnforcedEscalationApproveAll + ManagedSettingsEnforcedEscalationAssistedApproval = rpc.ManagedSettingsEnforcedEscalationAssistedApproval + ManagedSettingsEnforcedEscalationServerWideMCPApproval = rpc.ManagedSettingsEnforcedEscalationServerWideMCPApproval + ManagedSettingsEnforcedEscalationUnrestrictedPaths = rpc.ManagedSettingsEnforcedEscalationUnrestrictedPaths + ManagedSettingsEnforcedEscalationUnrestrictedURLs = rpc.ManagedSettingsEnforcedEscalationUnrestrictedURLs + ManagedSettingsResolvedSourceClient = rpc.ManagedSettingsResolvedSourceClient + ManagedSettingsResolvedSourceDevice = rpc.ManagedSettingsResolvedSourceDevice + ManagedSettingsResolvedSourceMixed = rpc.ManagedSettingsResolvedSourceMixed + ManagedSettingsResolvedSourceNone = rpc.ManagedSettingsResolvedSourceNone + ManagedSettingsResolvedSourcePolicyHelper = rpc.ManagedSettingsResolvedSourcePolicyHelper + ManagedSettingsResolvedSourceServer = rpc.ManagedSettingsResolvedSourceServer + MCPHeadersRefreshCompletedOutcomeError = rpc.MCPHeadersRefreshCompletedOutcomeError + MCPHeadersRefreshCompletedOutcomeHeaders = rpc.MCPHeadersRefreshCompletedOutcomeHeaders + MCPHeadersRefreshCompletedOutcomeNone = rpc.MCPHeadersRefreshCompletedOutcomeNone + MCPHeadersRefreshCompletedOutcomeTimeout = rpc.MCPHeadersRefreshCompletedOutcomeTimeout + MCPHeadersRefreshRequiredReasonAuthFailed = rpc.MCPHeadersRefreshRequiredReasonAuthFailed + MCPHeadersRefreshRequiredReasonStartup = rpc.MCPHeadersRefreshRequiredReasonStartup + MCPHeadersRefreshRequiredReasonTtlExpired = rpc.MCPHeadersRefreshRequiredReasonTtlExpired + MCPOauthCompletionOutcomeCancelled = rpc.MCPOauthCompletionOutcomeCancelled + MCPOauthCompletionOutcomeToken = rpc.MCPOauthCompletionOutcomeToken + MCPOauthRequestReasonInitial = rpc.MCPOauthRequestReasonInitial + MCPOauthRequestReasonReauth = rpc.MCPOauthRequestReasonReauth + MCPOauthRequestReasonRefresh = rpc.MCPOauthRequestReasonRefresh + MCPOauthRequestReasonUpscope = rpc.MCPOauthRequestReasonUpscope + MCPOauthRequiredStaticClientConfigGrantTypeClientCredentials = rpc.MCPOauthRequiredStaticClientConfigGrantTypeClientCredentials + MCPServerSourceBuiltin = rpc.MCPServerSourceBuiltin + MCPServerSourceManaged = rpc.MCPServerSourceManaged + MCPServerSourcePlugin = rpc.MCPServerSourcePlugin + MCPServerSourceUser = rpc.MCPServerSourceUser + MCPServerSourceWorkspace = rpc.MCPServerSourceWorkspace + MCPServerStatusConnected = rpc.MCPServerStatusConnected + MCPServerStatusDisabled = rpc.MCPServerStatusDisabled + MCPServerStatusFailed = rpc.MCPServerStatusFailed + MCPServerStatusNeedsAuth = rpc.MCPServerStatusNeedsAuth + MCPServerStatusNotConfigured = rpc.MCPServerStatusNotConfigured + MCPServerStatusPending = rpc.MCPServerStatusPending + MCPServerStatusStopped = rpc.MCPServerStatusStopped + MCPServerTransportHTTP = rpc.MCPServerTransportHTTP + MCPServerTransportMemory = rpc.MCPServerTransportMemory + MCPServerTransportSSE = rpc.MCPServerTransportSSE + MCPServerTransportStdio = rpc.MCPServerTransportStdio + ModelCallFailureBadRequestKindBodyless = rpc.ModelCallFailureBadRequestKindBodyless + ModelCallFailureBadRequestKindStructuredError = rpc.ModelCallFailureBadRequestKindStructuredError + ModelCallFailureKindAPI = rpc.ModelCallFailureKindAPI + ModelCallFailureKindTransport = rpc.ModelCallFailureKindTransport + ModelCallFailureSourceMCPSampling = rpc.ModelCallFailureSourceMCPSampling + ModelCallFailureSourceSubagent = rpc.ModelCallFailureSourceSubagent + ModelCallFailureSourceTopLevel = rpc.ModelCallFailureSourceTopLevel + ModelCallFailureTransportHTTP = rpc.ModelCallFailureTransportHTTP + ModelCallFailureTransportWebsocket = rpc.ModelCallFailureTransportWebsocket + ModelCallFinishedOutcomeCancelled = rpc.ModelCallFinishedOutcomeCancelled + ModelCallFinishedOutcomeError = rpc.ModelCallFinishedOutcomeError + ModelCallFinishedOutcomeRejected = rpc.ModelCallFinishedOutcomeRejected + ModelCallFinishedOutcomeSuccess = rpc.ModelCallFinishedOutcomeSuccess + ModelChangeSourceAgent = rpc.ModelChangeSourceAgent + ModelChangeSourceAutomatic = rpc.ModelChangeSourceAutomatic + ModelChangeSourceChangeboardingShortcut = rpc.ModelChangeSourceChangeboardingShortcut + ModelChangeSourceConfigCommand = rpc.ModelChangeSourceConfigCommand + ModelChangeSourceManagedSettings = rpc.ModelChangeSourceManagedSettings + ModelChangeSourceModelCommand = rpc.ModelChangeSourceModelCommand + ModelChangeSourceModelPicker = rpc.ModelChangeSourceModelPicker + ModelChangeSourcePlanMode = rpc.ModelChangeSourcePlanMode + ModelChangeSourceRepoSettings = rpc.ModelChangeSourceRepoSettings + ModelChangeSourceSDK = rpc.ModelChangeSourceSDK + ModelChangeSourceSettingsCommand = rpc.ModelChangeSourceSettingsCommand + ModelChangeSourceStartup = rpc.ModelChangeSourceStartup + OmittedBinaryOmittedReasonAssetUnavailable = rpc.OmittedBinaryOmittedReasonAssetUnavailable + OmittedBinaryOmittedReasonTooLarge = rpc.OmittedBinaryOmittedReasonTooLarge + OmittedBinaryTypeImage = rpc.OmittedBinaryTypeImage + OmittedBinaryTypeResource = rpc.OmittedBinaryTypeResource + PermissionApprovalEvaluationEvaluationStageJudge = rpc.PermissionApprovalEvaluationEvaluationStageJudge + PermissionApprovalEvaluationEvaluationStageNotReached = rpc.PermissionApprovalEvaluationEvaluationStageNotReached + PermissionApprovalEvaluationEvaluationStagePreJudge = rpc.PermissionApprovalEvaluationEvaluationStagePreJudge + PermissionApprovalEvaluationEvaluationStageReuse = rpc.PermissionApprovalEvaluationEvaluationStageReuse + PermissionApprovalEvaluationEvaluationStageUnknown = rpc.PermissionApprovalEvaluationEvaluationStageUnknown + PermissionApprovalEvaluationJudgeStatusCached = rpc.PermissionApprovalEvaluationJudgeStatusCached + PermissionApprovalEvaluationJudgeStatusCompleted = rpc.PermissionApprovalEvaluationJudgeStatusCompleted + PermissionApprovalEvaluationJudgeStatusFailed = rpc.PermissionApprovalEvaluationJudgeStatusFailed + PermissionApprovalEvaluationJudgeStatusInherited = rpc.PermissionApprovalEvaluationJudgeStatusInherited + PermissionApprovalEvaluationJudgeStatusNotCalled = rpc.PermissionApprovalEvaluationJudgeStatusNotCalled + PermissionApprovalEvaluationJudgeStatusUnknown = rpc.PermissionApprovalEvaluationJudgeStatusUnknown + PermissionApprovalEvaluationReasonCodeActionTooLong = rpc.PermissionApprovalEvaluationReasonCodeActionTooLong + PermissionApprovalEvaluationReasonCodeArgumentBindingUnreviewable = rpc.PermissionApprovalEvaluationReasonCodeArgumentBindingUnreviewable + PermissionApprovalEvaluationReasonCodeAuthorizationHistoryIncomplete = rpc.PermissionApprovalEvaluationReasonCodeAuthorizationHistoryIncomplete + PermissionApprovalEvaluationReasonCodeInactive = rpc.PermissionApprovalEvaluationReasonCodeInactive + PermissionApprovalEvaluationReasonCodeInherited = rpc.PermissionApprovalEvaluationReasonCodeInherited + PermissionApprovalEvaluationReasonCodeInterpreterTooLarge = rpc.PermissionApprovalEvaluationReasonCodeInterpreterTooLarge + PermissionApprovalEvaluationReasonCodeInterpreterUnavailable = rpc.PermissionApprovalEvaluationReasonCodeInterpreterUnavailable + PermissionApprovalEvaluationReasonCodeInterpreterWrappedScript = rpc.PermissionApprovalEvaluationReasonCodeInterpreterWrappedScript + PermissionApprovalEvaluationReasonCodeInvalidWorkingDirectory = rpc.PermissionApprovalEvaluationReasonCodeInvalidWorkingDirectory + PermissionApprovalEvaluationReasonCodeJudgeError = rpc.PermissionApprovalEvaluationReasonCodeJudgeError + PermissionApprovalEvaluationReasonCodeJudgeVerdict = rpc.PermissionApprovalEvaluationReasonCodeJudgeVerdict + PermissionApprovalEvaluationReasonCodeMalformedScriptActionManifest = rpc.PermissionApprovalEvaluationReasonCodeMalformedScriptActionManifest + PermissionApprovalEvaluationReasonCodeMalformedScriptActionReview = rpc.PermissionApprovalEvaluationReasonCodeMalformedScriptActionReview + PermissionApprovalEvaluationReasonCodeManagedApprovalRequired = rpc.PermissionApprovalEvaluationReasonCodeManagedApprovalRequired + PermissionApprovalEvaluationReasonCodeNonUtf8 = rpc.PermissionApprovalEvaluationReasonCodeNonUtf8 + PermissionApprovalEvaluationReasonCodeNotReached = rpc.PermissionApprovalEvaluationReasonCodeNotReached + PermissionApprovalEvaluationReasonCodeNotRegularFile = rpc.PermissionApprovalEvaluationReasonCodeNotRegularFile + PermissionApprovalEvaluationReasonCodePathNotAuthorized = rpc.PermissionApprovalEvaluationReasonCodePathNotAuthorized + PermissionApprovalEvaluationReasonCodeSandboxBypass = rpc.PermissionApprovalEvaluationReasonCodeSandboxBypass + PermissionApprovalEvaluationReasonCodeShellEnvironmentUnreviewable = rpc.PermissionApprovalEvaluationReasonCodeShellEnvironmentUnreviewable + PermissionApprovalEvaluationReasonCodeTooLarge = rpc.PermissionApprovalEvaluationReasonCodeTooLarge + PermissionApprovalEvaluationReasonCodeUnavailable = rpc.PermissionApprovalEvaluationReasonCodeUnavailable + PermissionApprovalEvaluationReasonCodeUnknown = rpc.PermissionApprovalEvaluationReasonCodeUnknown + PermissionApprovalEvaluationReasonCodeUnreadable = rpc.PermissionApprovalEvaluationReasonCodeUnreadable + PermissionApprovalEvaluationReasonCodeUnrepresentablePath = rpc.PermissionApprovalEvaluationReasonCodeUnrepresentablePath + PermissionApprovalEvaluationReasonCodeUnreviewableScriptInvocation = rpc.PermissionApprovalEvaluationReasonCodeUnreviewableScriptInvocation + PermissionDecisionSourceAuthorizationCarryForward = rpc.PermissionDecisionSourceAuthorizationCarryForward + PermissionMessageAuthorizationPolarityDenial = rpc.PermissionMessageAuthorizationPolarityDenial + PermissionMessageAuthorizationPolarityGrant = rpc.PermissionMessageAuthorizationPolarityGrant + PermissionModeAllowAll = rpc.PermissionModeAllowAll + PermissionModeAssisted = rpc.PermissionModeAssisted + PermissionModeManual = rpc.PermissionModeManual + PermissionPromptRequestKindCommands = rpc.PermissionPromptRequestKindCommands + PermissionPromptRequestKindCustomTool = rpc.PermissionPromptRequestKindCustomTool + PermissionPromptRequestKindExtensionEnvAccess = rpc.PermissionPromptRequestKindExtensionEnvAccess + PermissionPromptRequestKindExtensionManagement = rpc.PermissionPromptRequestKindExtensionManagement + PermissionPromptRequestKindExtensionPermissionAccess = rpc.PermissionPromptRequestKindExtensionPermissionAccess + PermissionPromptRequestKindFactory = rpc.PermissionPromptRequestKindFactory + PermissionPromptRequestKindHook = rpc.PermissionPromptRequestKindHook + PermissionPromptRequestKindMCP = rpc.PermissionPromptRequestKindMCP + PermissionPromptRequestKindMemory = rpc.PermissionPromptRequestKindMemory + PermissionPromptRequestKindPath = rpc.PermissionPromptRequestKindPath + PermissionPromptRequestKindRead = rpc.PermissionPromptRequestKindRead + PermissionPromptRequestKindURL = rpc.PermissionPromptRequestKindURL + PermissionPromptRequestKindWrite = rpc.PermissionPromptRequestKindWrite + PermissionPromptRequestPathAccessKindRead = rpc.PermissionPromptRequestPathAccessKindRead + PermissionPromptRequestPathAccessKindShell = rpc.PermissionPromptRequestPathAccessKindShell + PermissionPromptRequestPathAccessKindWrite = rpc.PermissionPromptRequestPathAccessKindWrite + PermissionRecommendationApprove = rpc.PermissionRecommendationApprove + PermissionRecoveryAttemptDispositionApproved = rpc.PermissionRecoveryAttemptDispositionApproved + PermissionRecoveryAttemptDispositionBlocked = rpc.PermissionRecoveryAttemptDispositionBlocked + PermissionRecoveryAttemptDispositionDeferred = rpc.PermissionRecoveryAttemptDispositionDeferred + PermissionRecoveryAttemptDispositionDenied = rpc.PermissionRecoveryAttemptDispositionDenied + PermissionRecoveryAttemptDispositionPrompted = rpc.PermissionRecoveryAttemptDispositionPrompted + PermissionRecoveryAttemptDispositionSucceeded = rpc.PermissionRecoveryAttemptDispositionSucceeded + PermissionRecoveryAttemptReasonAttemptsExhausted = rpc.PermissionRecoveryAttemptReasonAttemptsExhausted + PermissionRecoveryAttemptReasonEquivalentAlternativeSucceeded = rpc.PermissionRecoveryAttemptReasonEquivalentAlternativeSucceeded + PermissionRecoveryAttemptReasonPermissionApproved = rpc.PermissionRecoveryAttemptReasonPermissionApproved + PermissionRecoveryAttemptReasonPermissionDenied = rpc.PermissionRecoveryAttemptReasonPermissionDenied + PermissionRecoveryAttemptReasonPermissionRequired = rpc.PermissionRecoveryAttemptReasonPermissionRequired + PermissionRecoveryAttemptReasonRepeatedAttempt = rpc.PermissionRecoveryAttemptReasonRepeatedAttempt + PermissionRecoveryAttemptReasonResponderUnavailable = rpc.PermissionRecoveryAttemptReasonResponderUnavailable + PermissionRecoveryAttemptRelationAlternative = rpc.PermissionRecoveryAttemptRelationAlternative + PermissionRecoveryAttemptRelationInitial = rpc.PermissionRecoveryAttemptRelationInitial + PermissionRecoveryAttemptRelationRetry = rpc.PermissionRecoveryAttemptRelationRetry + PermissionRecoveryOnBlockedAsk = rpc.PermissionRecoveryOnBlockedAsk + PermissionRecoveryOnBlockedFail = rpc.PermissionRecoveryOnBlockedFail + PermissionRecoveryReasonAttemptsExhausted = rpc.PermissionRecoveryReasonAttemptsExhausted + PermissionRecoveryReasonEquivalentAlternativeSucceeded = rpc.PermissionRecoveryReasonEquivalentAlternativeSucceeded + PermissionRecoveryReasonPermissionApproved = rpc.PermissionRecoveryReasonPermissionApproved + PermissionRecoveryReasonPermissionDenied = rpc.PermissionRecoveryReasonPermissionDenied + PermissionRecoveryReasonPermissionRequired = rpc.PermissionRecoveryReasonPermissionRequired + PermissionRecoveryReasonRepeatedAttempt = rpc.PermissionRecoveryReasonRepeatedAttempt + PermissionRecoveryReasonResponderUnavailable = rpc.PermissionRecoveryReasonResponderUnavailable + PermissionRecoveryStatusAwaitingApproval = rpc.PermissionRecoveryStatusAwaitingApproval + PermissionRecoveryStatusBlocked = rpc.PermissionRecoveryStatusBlocked + PermissionRecoveryStatusRecovering = rpc.PermissionRecoveryStatusRecovering + PermissionRecoveryStatusResolved = rpc.PermissionRecoveryStatusResolved + PermissionRequestKindCustomTool = rpc.PermissionRequestKindCustomTool + PermissionRequestKindExtensionEnvAccess = rpc.PermissionRequestKindExtensionEnvAccess + PermissionRequestKindExtensionManagement = rpc.PermissionRequestKindExtensionManagement + PermissionRequestKindExtensionPermissionAccess = rpc.PermissionRequestKindExtensionPermissionAccess + PermissionRequestKindFactory = rpc.PermissionRequestKindFactory + PermissionRequestKindHook = rpc.PermissionRequestKindHook + PermissionRequestKindMCP = rpc.PermissionRequestKindMCP + PermissionRequestKindMemory = rpc.PermissionRequestKindMemory + PermissionRequestKindRead = rpc.PermissionRequestKindRead + PermissionRequestKindShell = rpc.PermissionRequestKindShell + PermissionRequestKindURL = rpc.PermissionRequestKindURL + PermissionRequestKindWrite = rpc.PermissionRequestKindWrite + PermissionRequestMemoryActionStore = rpc.PermissionRequestMemoryActionStore + PermissionRequestMemoryActionVote = rpc.PermissionRequestMemoryActionVote + PermissionRequestMemoryDirectionDownvote = rpc.PermissionRequestMemoryDirectionDownvote + PermissionRequestMemoryDirectionUpvote = rpc.PermissionRequestMemoryDirectionUpvote + PermissionRequestMemoryScopeRepository = rpc.PermissionRequestMemoryScopeRepository + PermissionRequestMemoryScopeUser = rpc.PermissionRequestMemoryScopeUser + PermissionResultKindApproved = rpc.PermissionResultKindApproved + PermissionResultKindApprovedForLocation = rpc.PermissionResultKindApprovedForLocation + PermissionResultKindApprovedForSession = rpc.PermissionResultKindApprovedForSession + PermissionResultKindCancelled = rpc.PermissionResultKindCancelled + PermissionResultKindDeniedByContentExclusionPolicy = rpc.PermissionResultKindDeniedByContentExclusionPolicy + PermissionResultKindDeniedByPermissionRequestHook = rpc.PermissionResultKindDeniedByPermissionRequestHook + PermissionResultKindDeniedByRules = rpc.PermissionResultKindDeniedByRules + PermissionResultKindDeniedInteractivelyByUser = rpc.PermissionResultKindDeniedInteractivelyByUser + PermissionResultKindDeniedNoApprovalRuleAndCouldNotRequestFromUser = rpc.PermissionResultKindDeniedNoApprovalRuleAndCouldNotRequestFromUser + PersistedBinaryImageTypeImage = rpc.PersistedBinaryImageTypeImage + PersistedBinaryImageTypeResource = rpc.PersistedBinaryImageTypeResource + PersistedBinaryResultTypeImage = rpc.PersistedBinaryResultTypeImage + PersistedBinaryResultTypeResource = rpc.PersistedBinaryResultTypeResource + PlanChangedOperationCreate = rpc.PlanChangedOperationCreate + PlanChangedOperationDelete = rpc.PlanChangedOperationDelete + PlanChangedOperationUpdate = rpc.PlanChangedOperationUpdate + ReasoningSummaryConcise = rpc.ReasoningSummaryConcise + ReasoningSummaryDetailed = rpc.ReasoningSummaryDetailed + ReasoningSummaryNone = rpc.ReasoningSummaryNone + RecommendedAutoTierBalance = rpc.RecommendedAutoTierBalance + RecommendedAutoTierEfficiency = rpc.RecommendedAutoTierEfficiency + RecommendedAutoTierIntelligence = rpc.RecommendedAutoTierIntelligence + RemediationActionAllowSandboxOutbound = rpc.RemediationActionAllowSandboxOutbound + RemediationActionReviewSandboxPolicy = rpc.RemediationActionReviewSandboxPolicy + RemediationActionShowAccount = rpc.RemediationActionShowAccount + RemediationActionSignIn = rpc.RemediationActionSignIn + RemediationActionSwitchAccount = rpc.RemediationActionSwitchAccount + ScheduleOriginModel = rpc.ScheduleOriginModel + ScheduleOriginUser = rpc.ScheduleOriginUser + SessionEventTypeAbort = rpc.SessionEventTypeAbort + SessionEventTypeAgentInterrupted = rpc.SessionEventTypeAgentInterrupted + SessionEventTypeAssistantFusionPhaseActivity = rpc.SessionEventTypeAssistantFusionPhaseActivity + SessionEventTypeAssistantFusionPhaseCompleted = rpc.SessionEventTypeAssistantFusionPhaseCompleted + SessionEventTypeAssistantFusionPhaseFailed = rpc.SessionEventTypeAssistantFusionPhaseFailed + SessionEventTypeAssistantFusionPhaseStarted = rpc.SessionEventTypeAssistantFusionPhaseStarted + SessionEventTypeAssistantIdle = rpc.SessionEventTypeAssistantIdle + SessionEventTypeAssistantIntent = rpc.SessionEventTypeAssistantIntent + SessionEventTypeAssistantMessage = rpc.SessionEventTypeAssistantMessage + SessionEventTypeAssistantMessageDelta = rpc.SessionEventTypeAssistantMessageDelta + SessionEventTypeAssistantMessageStart = rpc.SessionEventTypeAssistantMessageStart + SessionEventTypeAssistantReasoning = rpc.SessionEventTypeAssistantReasoning + SessionEventTypeAssistantReasoningDelta = rpc.SessionEventTypeAssistantReasoningDelta + SessionEventTypeAssistantServerToolProgress = rpc.SessionEventTypeAssistantServerToolProgress + SessionEventTypeAssistantStreamingDelta = rpc.SessionEventTypeAssistantStreamingDelta + SessionEventTypeAssistantToolCallDelta = rpc.SessionEventTypeAssistantToolCallDelta + SessionEventTypeAssistantTurnEnd = rpc.SessionEventTypeAssistantTurnEnd + SessionEventTypeAssistantTurnRetry = rpc.SessionEventTypeAssistantTurnRetry + SessionEventTypeAssistantTurnStart = rpc.SessionEventTypeAssistantTurnStart + SessionEventTypeAssistantUsage = rpc.SessionEventTypeAssistantUsage + SessionEventTypeAutoModeSwitchCompleted = rpc.SessionEventTypeAutoModeSwitchCompleted + SessionEventTypeAutoModeSwitchRequested = rpc.SessionEventTypeAutoModeSwitchRequested + SessionEventTypeCapabilitiesChanged = rpc.SessionEventTypeCapabilitiesChanged + SessionEventTypeCommandCompleted = rpc.SessionEventTypeCommandCompleted + SessionEventTypeCommandExecute = rpc.SessionEventTypeCommandExecute + SessionEventTypeCommandQueued = rpc.SessionEventTypeCommandQueued + SessionEventTypeCommandsChanged = rpc.SessionEventTypeCommandsChanged + SessionEventTypeElicitationCompleted = rpc.SessionEventTypeElicitationCompleted + SessionEventTypeElicitationRequested = rpc.SessionEventTypeElicitationRequested + SessionEventTypeExitPlanModeCompleted = rpc.SessionEventTypeExitPlanModeCompleted + SessionEventTypeExitPlanModeRequested = rpc.SessionEventTypeExitPlanModeRequested + SessionEventTypeExternalToolCompleted = rpc.SessionEventTypeExternalToolCompleted + SessionEventTypeExternalToolRequested = rpc.SessionEventTypeExternalToolRequested + SessionEventTypeFactoryRunSettled = rpc.SessionEventTypeFactoryRunSettled + SessionEventTypeFactoryRunStarted = rpc.SessionEventTypeFactoryRunStarted + SessionEventTypeFactoryRunUpdated = rpc.SessionEventTypeFactoryRunUpdated + SessionEventTypeHookEnd = rpc.SessionEventTypeHookEnd + SessionEventTypeHookProgress = rpc.SessionEventTypeHookProgress + SessionEventTypeHookStart = rpc.SessionEventTypeHookStart + SessionEventTypeMCPAppToolCallComplete = rpc.SessionEventTypeMCPAppToolCallComplete + SessionEventTypeMCPHeadersRefreshCompleted = rpc.SessionEventTypeMCPHeadersRefreshCompleted + SessionEventTypeMCPHeadersRefreshRequired = rpc.SessionEventTypeMCPHeadersRefreshRequired + SessionEventTypeMCPOauthCompleted = rpc.SessionEventTypeMCPOauthCompleted + SessionEventTypeMCPOauthRequired = rpc.SessionEventTypeMCPOauthRequired + SessionEventTypeMCPPromptsListChanged = rpc.SessionEventTypeMCPPromptsListChanged + SessionEventTypeMCPResourcesListChanged = rpc.SessionEventTypeMCPResourcesListChanged + SessionEventTypeMCPToolsListChanged = rpc.SessionEventTypeMCPToolsListChanged + SessionEventTypeModelCallFailure = rpc.SessionEventTypeModelCallFailure + SessionEventTypeModelCallFinished = rpc.SessionEventTypeModelCallFinished + SessionEventTypeModelCallStart = rpc.SessionEventTypeModelCallStart + SessionEventTypePendingMessagesModified = rpc.SessionEventTypePendingMessagesModified + SessionEventTypePermissionAssentDetected = rpc.SessionEventTypePermissionAssentDetected + SessionEventTypePermissionCarriedForward = rpc.SessionEventTypePermissionCarriedForward + SessionEventTypePermissionCompleted = rpc.SessionEventTypePermissionCompleted + SessionEventTypePermissionContextualAuthorization = rpc.SessionEventTypePermissionContextualAuthorization + SessionEventTypePermissionMessageAuthorization = rpc.SessionEventTypePermissionMessageAuthorization + SessionEventTypePermissionMessageAuthorizationDegraded = rpc.SessionEventTypePermissionMessageAuthorizationDegraded + SessionEventTypePermissionMessageAuthorizationRead = rpc.SessionEventTypePermissionMessageAuthorizationRead + SessionEventTypePermissionRequested = rpc.SessionEventTypePermissionRequested + SessionEventTypePromptCacheBreak = rpc.SessionEventTypePromptCacheBreak + SessionEventTypeSamplingCompleted = rpc.SessionEventTypeSamplingCompleted + SessionEventTypeSamplingRequested = rpc.SessionEventTypeSamplingRequested + SessionEventTypeSandboxDecision = rpc.SessionEventTypeSandboxDecision + SessionEventTypeSessionAutoModeResolved = rpc.SessionEventTypeSessionAutoModeResolved + SessionEventTypeSessionAutopilotObjectiveChanged = rpc.SessionEventTypeSessionAutopilotObjectiveChanged + SessionEventTypeSessionAutoTierRecommendation = rpc.SessionEventTypeSessionAutoTierRecommendation + SessionEventTypeSessionAutoTierSwitchFailed = rpc.SessionEventTypeSessionAutoTierSwitchFailed + SessionEventTypeSessionBackgroundTasksChanged = rpc.SessionEventTypeSessionBackgroundTasksChanged + SessionEventTypeSessionBinaryAsset = rpc.SessionEventTypeSessionBinaryAsset + SessionEventTypeSessionCanvasClosed = rpc.SessionEventTypeSessionCanvasClosed + SessionEventTypeSessionCanvasOpened = rpc.SessionEventTypeSessionCanvasOpened + SessionEventTypeSessionCanvasRecorded = rpc.SessionEventTypeSessionCanvasRecorded + SessionEventTypeSessionCanvasRegistryChanged = rpc.SessionEventTypeSessionCanvasRegistryChanged + SessionEventTypeSessionCanvasRemoved = rpc.SessionEventTypeSessionCanvasRemoved + SessionEventTypeSessionCanvasUnavailable = rpc.SessionEventTypeSessionCanvasUnavailable + SessionEventTypeSessionCompactionComplete = rpc.SessionEventTypeSessionCompactionComplete + SessionEventTypeSessionCompactionStart = rpc.SessionEventTypeSessionCompactionStart + SessionEventTypeSessionCompletionReceipt = rpc.SessionEventTypeSessionCompletionReceipt + SessionEventTypeSessionContextChanged = rpc.SessionEventTypeSessionContextChanged + SessionEventTypeSessionContextCleared = rpc.SessionEventTypeSessionContextCleared + SessionEventTypeSessionCustomAgentsUpdated = rpc.SessionEventTypeSessionCustomAgentsUpdated + SessionEventTypeSessionCustomNotification = rpc.SessionEventTypeSessionCustomNotification + SessionEventTypeSessionError = rpc.SessionEventTypeSessionError + SessionEventTypeSessionExtensionsAttachmentsPushed = rpc.SessionEventTypeSessionExtensionsAttachmentsPushed + SessionEventTypeSessionExtensionsLoaded = rpc.SessionEventTypeSessionExtensionsLoaded + SessionEventTypeSessionFusionCompleted = rpc.SessionEventTypeSessionFusionCompleted + SessionEventTypeSessionFusionResolved = rpc.SessionEventTypeSessionFusionResolved + SessionEventTypeSessionFusionRouteFailed = rpc.SessionEventTypeSessionFusionRouteFailed + SessionEventTypeSessionFusionRouteStarted = rpc.SessionEventTypeSessionFusionRouteStarted + SessionEventTypeSessionHandoff = rpc.SessionEventTypeSessionHandoff + SessionEventTypeSessionIdle = rpc.SessionEventTypeSessionIdle + SessionEventTypeSessionIndexedSearch = rpc.SessionEventTypeSessionIndexedSearch + SessionEventTypeSessionInfo = rpc.SessionEventTypeSessionInfo + SessionEventTypeSessionLimitsExhaustedCompleted = rpc.SessionEventTypeSessionLimitsExhaustedCompleted + SessionEventTypeSessionLimitsExhaustedRequested = rpc.SessionEventTypeSessionLimitsExhaustedRequested + SessionEventTypeSessionManagedSettingsEnforced = rpc.SessionEventTypeSessionManagedSettingsEnforced + SessionEventTypeSessionManagedSettingsResolved = rpc.SessionEventTypeSessionManagedSettingsResolved + SessionEventTypeSessionMCPServerNeedsReconnect = rpc.SessionEventTypeSessionMCPServerNeedsReconnect + SessionEventTypeSessionMCPServerRemoved = rpc.SessionEventTypeSessionMCPServerRemoved + SessionEventTypeSessionMCPServersLoaded = rpc.SessionEventTypeSessionMCPServersLoaded + SessionEventTypeSessionMCPServerStatusChanged = rpc.SessionEventTypeSessionMCPServerStatusChanged + SessionEventTypeSessionModeChanged = rpc.SessionEventTypeSessionModeChanged + SessionEventTypeSessionModelChange = rpc.SessionEventTypeSessionModelChange + SessionEventTypeSessionModeNoticeDelivered = rpc.SessionEventTypeSessionModeNoticeDelivered + SessionEventTypeSessionPermissionRecovery = rpc.SessionEventTypeSessionPermissionRecovery + SessionEventTypeSessionPermissionsChanged = rpc.SessionEventTypeSessionPermissionsChanged + SessionEventTypeSessionPlanChanged = rpc.SessionEventTypeSessionPlanChanged + SessionEventTypeSessionRemoteSteerableChanged = rpc.SessionEventTypeSessionRemoteSteerableChanged + SessionEventTypeSessionResume = rpc.SessionEventTypeSessionResume + SessionEventTypeSessionScheduleCancelled = rpc.SessionEventTypeSessionScheduleCancelled + SessionEventTypeSessionScheduleCreated = rpc.SessionEventTypeSessionScheduleCreated + SessionEventTypeSessionScheduleRearmed = rpc.SessionEventTypeSessionScheduleRearmed + SessionEventTypeSessionSessionLimitsChanged = rpc.SessionEventTypeSessionSessionLimitsChanged + SessionEventTypeSessionShutdown = rpc.SessionEventTypeSessionShutdown + SessionEventTypeSessionSkillsLoaded = rpc.SessionEventTypeSessionSkillsLoaded + SessionEventTypeSessionSnapshotRewind = rpc.SessionEventTypeSessionSnapshotRewind + SessionEventTypeSessionStart = rpc.SessionEventTypeSessionStart + SessionEventTypeSessionTaskComplete = rpc.SessionEventTypeSessionTaskComplete + SessionEventTypeSessionTitleChanged = rpc.SessionEventTypeSessionTitleChanged + SessionEventTypeSessionTodosChanged = rpc.SessionEventTypeSessionTodosChanged + SessionEventTypeSessionToolsUpdated = rpc.SessionEventTypeSessionToolsUpdated + SessionEventTypeSessionTruncation = rpc.SessionEventTypeSessionTruncation + SessionEventTypeSessionUsageCheckpoint = rpc.SessionEventTypeSessionUsageCheckpoint + SessionEventTypeSessionUsageInfo = rpc.SessionEventTypeSessionUsageInfo + SessionEventTypeSessionWarning = rpc.SessionEventTypeSessionWarning + SessionEventTypeSessionWorkspaceFileChanged = rpc.SessionEventTypeSessionWorkspaceFileChanged + SessionEventTypeSkillContextDelivered = rpc.SessionEventTypeSkillContextDelivered + SessionEventTypeSkillContextDeliveredRef = rpc.SessionEventTypeSkillContextDeliveredRef + SessionEventTypeSkillInvoked = rpc.SessionEventTypeSkillInvoked + SessionEventTypeSkillInvokedRef = rpc.SessionEventTypeSkillInvokedRef + SessionEventTypeSubagentCompleted = rpc.SessionEventTypeSubagentCompleted + SessionEventTypeSubagentConfigured = rpc.SessionEventTypeSubagentConfigured + SessionEventTypeSubagentDeselected = rpc.SessionEventTypeSubagentDeselected + SessionEventTypeSubagentFailed = rpc.SessionEventTypeSubagentFailed + SessionEventTypeSubagentSelected = rpc.SessionEventTypeSubagentSelected + SessionEventTypeSubagentStarted = rpc.SessionEventTypeSubagentStarted + SessionEventTypeSystemMessage = rpc.SessionEventTypeSystemMessage + SessionEventTypeSystemNotification = rpc.SessionEventTypeSystemNotification + SessionEventTypeToolExecutionComplete = rpc.SessionEventTypeToolExecutionComplete + SessionEventTypeToolExecutionPartialResult = rpc.SessionEventTypeToolExecutionPartialResult + SessionEventTypeToolExecutionProgress = rpc.SessionEventTypeToolExecutionProgress + SessionEventTypeToolExecutionStart = rpc.SessionEventTypeToolExecutionStart + SessionEventTypeToolSearchActivated = rpc.SessionEventTypeToolSearchActivated + SessionEventTypeToolUserRequested = rpc.SessionEventTypeToolUserRequested + SessionEventTypeUIEphemeralQuery = rpc.SessionEventTypeUIEphemeralQuery + SessionEventTypeUserInputCompleted = rpc.SessionEventTypeUserInputCompleted + SessionEventTypeUserInputRequested = rpc.SessionEventTypeUserInputRequested + SessionEventTypeUserMessage = rpc.SessionEventTypeUserMessage + SessionLimitsExhaustedResponseActionAdd = rpc.SessionLimitsExhaustedResponseActionAdd + SessionLimitsExhaustedResponseActionCancel = rpc.SessionLimitsExhaustedResponseActionCancel + SessionLimitsExhaustedResponseActionSet = rpc.SessionLimitsExhaustedResponseActionSet + SessionLimitsExhaustedResponseActionUnset = rpc.SessionLimitsExhaustedResponseActionUnset + SessionModeAutopilot = rpc.SessionModeAutopilot + SessionModeInteractive = rpc.SessionModeInteractive + SessionModePlan = rpc.SessionModePlan + ShutdownTypeError = rpc.ShutdownTypeError + ShutdownTypeRoutine = rpc.ShutdownTypeRoutine + SkillInvokedTriggerAgentInvoked = rpc.SkillInvokedTriggerAgentInvoked + SkillInvokedTriggerContextLoad = rpc.SkillInvokedTriggerContextLoad + SkillInvokedTriggerUserInvoked = rpc.SkillInvokedTriggerUserInvoked + SkillSourceBuiltin = rpc.SkillSourceBuiltin + SkillSourceCustom = rpc.SkillSourceCustom + SkillSourceInherited = rpc.SkillSourceInherited + SkillSourcePersonalAgents = rpc.SkillSourcePersonalAgents + SkillSourcePersonalCopilot = rpc.SkillSourcePersonalCopilot + SkillSourcePlugin = rpc.SkillSourcePlugin + SkillSourceProject = rpc.SkillSourceProject + SkillSourceSDK = rpc.SkillSourceSDK + SubagentModelSelectionSourceAgentDefinitionDefault = rpc.SubagentModelSelectionSourceAgentDefinitionDefault + SubagentModelSelectionSourceComplementaryDefault = rpc.SubagentModelSelectionSourceComplementaryDefault + SubagentModelSelectionSourceConfiguredPreference = rpc.SubagentModelSelectionSourceConfiguredPreference + SubagentModelSelectionSourceConfiguredRequired = rpc.SubagentModelSelectionSourceConfiguredRequired + SubagentModelSelectionSourceExplicitOverride = rpc.SubagentModelSelectionSourceExplicitOverride + SubagentModelSelectionSourceRuntimePolicy = rpc.SubagentModelSelectionSourceRuntimePolicy + SubagentModelSelectionSourceSessionInheritance = rpc.SubagentModelSelectionSourceSessionInheritance + SubagentTaskModelSourceCustomAgentDefinition = rpc.SubagentTaskModelSourceCustomAgentDefinition + SubagentTaskModelSourceSubagentConfiguration = rpc.SubagentTaskModelSourceSubagentConfiguration + SubagentTaskModelSourceTaskArgument = rpc.SubagentTaskModelSourceTaskArgument + SubagentTaskModelSourceUnset = rpc.SubagentTaskModelSourceUnset + SystemMessageRoleDeveloper = rpc.SystemMessageRoleDeveloper + SystemMessageRoleSystem = rpc.SystemMessageRoleSystem + SystemNotificationAgentCompletedStatusCompleted = rpc.SystemNotificationAgentCompletedStatusCompleted + SystemNotificationAgentCompletedStatusFailed = rpc.SystemNotificationAgentCompletedStatusFailed + SystemNotificationFactoryCompletedStatusCancelled = rpc.SystemNotificationFactoryCompletedStatusCancelled + SystemNotificationFactoryCompletedStatusCompleted = rpc.SystemNotificationFactoryCompletedStatusCompleted + SystemNotificationFactoryCompletedStatusError = rpc.SystemNotificationFactoryCompletedStatusError + SystemNotificationFactoryCompletedStatusHalted = rpc.SystemNotificationFactoryCompletedStatusHalted + SystemNotificationFactoryCompletedStatusPaused = rpc.SystemNotificationFactoryCompletedStatusPaused + SystemNotificationFactoryPauseInfoTypeCheckpoint = rpc.SystemNotificationFactoryPauseInfoTypeCheckpoint + SystemNotificationFactoryPauseInfoTypeUser = rpc.SystemNotificationFactoryPauseInfoTypeUser + SystemNotificationTypeAgentCompleted = rpc.SystemNotificationTypeAgentCompleted + SystemNotificationTypeAgentIdle = rpc.SystemNotificationTypeAgentIdle + SystemNotificationTypeFactoryCompleted = rpc.SystemNotificationTypeFactoryCompleted + SystemNotificationTypeInstructionDiscovered = rpc.SystemNotificationTypeInstructionDiscovered + SystemNotificationTypeNewInboxMessage = rpc.SystemNotificationTypeNewInboxMessage + SystemNotificationTypeShellCompleted = rpc.SystemNotificationTypeShellCompleted + SystemNotificationTypeShellDetachedCompleted = rpc.SystemNotificationTypeShellDetachedCompleted + SystemNotificationTypeUnclassified = rpc.SystemNotificationTypeUnclassified + TaskBlockerKindPermissionRecovery = rpc.TaskBlockerKindPermissionRecovery + TaskCompletionOutcomeBlocked = rpc.TaskCompletionOutcomeBlocked + TaskCompletionOutcomeCompleted = rpc.TaskCompletionOutcomeCompleted + TaskCompletionOutcomeContinue = rpc.TaskCompletionOutcomeContinue + ToolExecutionCompleteContentResourceLinkIconThemeDark = rpc.ToolExecutionCompleteContentResourceLinkIconThemeDark + ToolExecutionCompleteContentResourceLinkIconThemeLight = rpc.ToolExecutionCompleteContentResourceLinkIconThemeLight + ToolExecutionCompleteContentTypeAudio = rpc.ToolExecutionCompleteContentTypeAudio + ToolExecutionCompleteContentTypeImage = rpc.ToolExecutionCompleteContentTypeImage + ToolExecutionCompleteContentTypeResource = rpc.ToolExecutionCompleteContentTypeResource + ToolExecutionCompleteContentTypeResourceLink = rpc.ToolExecutionCompleteContentTypeResourceLink + ToolExecutionCompleteContentTypeShellExit = rpc.ToolExecutionCompleteContentTypeShellExit + ToolExecutionCompleteContentTypeTerminal = rpc.ToolExecutionCompleteContentTypeTerminal + ToolExecutionCompleteContentTypeText = rpc.ToolExecutionCompleteContentTypeText + ToolExecutionCompleteToolDescriptionMetaUIVisibilityApp = rpc.ToolExecutionCompleteToolDescriptionMetaUIVisibilityApp + ToolExecutionCompleteToolDescriptionMetaUIVisibilityModel = rpc.ToolExecutionCompleteToolDescriptionMetaUIVisibilityModel + ToolExecutionStartToolDescriptionMetaUIVisibilityApp = rpc.ToolExecutionStartToolDescriptionMetaUIVisibilityApp + ToolExecutionStartToolDescriptionMetaUIVisibilityModel = rpc.ToolExecutionStartToolDescriptionMetaUIVisibilityModel + UIEphemeralQueryPhaseAborted = rpc.UIEphemeralQueryPhaseAborted + UIEphemeralQueryPhaseChunk = rpc.UIEphemeralQueryPhaseChunk + UIEphemeralQueryPhaseCompleted = rpc.UIEphemeralQueryPhaseCompleted + UIEphemeralQueryPhaseFailed = rpc.UIEphemeralQueryPhaseFailed + UIEphemeralQueryPhaseStarted = rpc.UIEphemeralQueryPhaseStarted + UserMessageAgentModeAutopilot = rpc.UserMessageAgentModeAutopilot + UserMessageAgentModeInteractive = rpc.UserMessageAgentModeInteractive + UserMessageAgentModePlan = rpc.UserMessageAgentModePlan + UserMessageAgentModeShell = rpc.UserMessageAgentModeShell + UserMessageDeliveryIdle = rpc.UserMessageDeliveryIdle + UserMessageDeliveryQueued = rpc.UserMessageDeliveryQueued + UserMessageDeliverySteering = rpc.UserMessageDeliverySteering + UserToolSessionApprovalKindCommands = rpc.UserToolSessionApprovalKindCommands + UserToolSessionApprovalKindCustomTool = rpc.UserToolSessionApprovalKindCustomTool + UserToolSessionApprovalKindExtensionEnvAccess = rpc.UserToolSessionApprovalKindExtensionEnvAccess + UserToolSessionApprovalKindExtensionManagement = rpc.UserToolSessionApprovalKindExtensionManagement + UserToolSessionApprovalKindExtensionPermissionAccess = rpc.UserToolSessionApprovalKindExtensionPermissionAccess + UserToolSessionApprovalKindFactory = rpc.UserToolSessionApprovalKindFactory + UserToolSessionApprovalKindMCP = rpc.UserToolSessionApprovalKindMCP + UserToolSessionApprovalKindMemory = rpc.UserToolSessionApprovalKindMemory + UserToolSessionApprovalKindRead = rpc.UserToolSessionApprovalKindRead + UserToolSessionApprovalKindWrite = rpc.UserToolSessionApprovalKindWrite + VerbosityHigh = rpc.VerbosityHigh + VerbosityLow = rpc.VerbosityLow + VerbosityMedium = rpc.VerbosityMedium + WorkingDirectoryContextHostTypeADO = rpc.WorkingDirectoryContextHostTypeADO + WorkingDirectoryContextHostTypeGitHub = rpc.WorkingDirectoryContextHostTypeGitHub + WorkspaceFileChangedOperationCreate = rpc.WorkspaceFileChangedOperationCreate + WorkspaceFileChangedOperationUpdate = rpc.WorkspaceFileChangedOperationUpdate ) diff --git a/java/scripts/codegen/java.test.ts b/java/scripts/codegen/java.test.ts index 8db96ee3d9..2e509dd976 100644 --- a/java/scripts/codegen/java.test.ts +++ b/java/scripts/codegen/java.test.ts @@ -4,8 +4,64 @@ import type { JSONSchema7 } from "json-schema"; import { collectNestedDiscriminatedUnionTypeNames, + renderEventVariantClass, + renderRpcTypes, schemaTypeToJava, } from "./java.js"; +import { RPC_VARIANT_OWNERS } from "./rpc-variant-owners.js"; + +function renderPayload(dataSchema: JSONSchema7): string { + return renderEventVariantClass({ + typeName: "example.notification", + className: "ExampleNotificationEvent", + dataSchema, + }, "com.github.copilot.generated"); +} + +for (const keyword of ["anyOf", "oneOf"] as const) { + test(`root ${keyword} payload preserves raw JSON and existing data descriptors`, () => { + const source = renderPayload({ + [keyword]: [ + { type: "object", properties: { kind: { const: "first" }, count: { type: "number" } } }, + { type: "object", properties: { kind: { const: "second" }, active: { type: "boolean" } } }, + { type: "null" }, + ], + }); + + assert.match(source, /public record ExampleNotificationEventData\(JsonNode raw\)/); + assert.match(source, /@JsonCreator\(mode = JsonCreator\.Mode\.DELEGATING\)\s+public ExampleNotificationEventData\s*\{/); + assert.match(source, /@JsonValue\s+public JsonNode raw\(\) \{ return raw; \}/); + assert.match(source, /public ExampleNotificationEventData\(\) \{\s+this\(JsonNodeFactory\.instance\.objectNode\(\)\);/); + assert.match(source, /public ExampleNotificationEventData getData\(\)/); + assert.match(source, /public void setData\(ExampleNotificationEventData data\)/); + }); + + test(`root ${keyword} with only one non-null alternative is not a raw union`, () => { + const source = renderPayload({ + [keyword]: [ + { type: "object", properties: { message: { type: "string" } } }, + { type: "null" }, + { type: ["null"] }, + { const: null }, + { enum: [null] }, + ], + }); + assert.doesNotMatch(source, /JsonNode|DELEGATING|JsonValue/); + }); +} + +test("ordinary and empty root objects retain their existing records", () => { + const source = renderPayload({ + type: "object", + properties: { message: { type: "string" } }, + }); + assert.match(source, /@JsonProperty\("message"\) String message/); + assert.doesNotMatch(source, /JsonNode|DELEGATING|JsonValue/); + + const empty = renderPayload({ type: "object", properties: {} }); + assert.match(empty, /public record ExampleNotificationEventData\(\)/); + assert.doesNotMatch(empty, /JsonNode|DELEGATING|JsonValue/); +}); test("nested discriminated array items use their named Java type", () => { const definitions: Record = { @@ -116,3 +172,125 @@ test("nested discriminated array items use their named Java type", () => { assert.deepEqual([...standaloneTypes.keys()], ["ActionChoice"]); assert.deepEqual([...promotedUnionTypes], ["ActionChoice", "ActionSource"]); }); + +function sharedUnionFixture(roots: string[]) { + const definitions: Record = { + SharedError: { + title: "SharedError", + type: "object", + additionalProperties: false, + properties: { kind: { const: "error" }, message: { type: "string" } }, + }, + }; + const server: Record = {}; + for (const root of roots) { + definitions[root] = { + anyOf: [ + { $ref: "#/definitions/SharedError" }, + { type: "object", additionalProperties: false, properties: { kind: { const: "ok" } } }, + ], + }; + server[root] = { rpcMethod: root, params: null, result: { $ref: `#/definitions/${root}` } }; + } + return { definitions, server }; +} + +function rpcSource(files: Map, name: string): string { + const source = files.get(`sdk/src/generated/java/com/github/copilot/generated/rpc/${name}.java`); + assert.ok(source, `missing ${name}.java`); + return source; +} + +for (const roots of [ + ["FirstResult", "HistoricalResult"], + ["FirstResult", "HistoricalResult", "LastResult"], +]) { + test(`${roots.length} shared roots preserve historical ownership regardless of discovery order`, async () => { + const owners = { SharedError: "HistoricalResult" }; + const fixture = sharedUnionFixture(roots); + const files = await renderRpcTypes(fixture, owners); + assert.match(rpcSource(files, "SharedError"), /class SharedError extends HistoricalResult/); + for (const root of roots.filter((name) => name !== "HistoricalResult")) { + assert.match(rpcSource(files, `${root}SharedError`), new RegExp(`class ${root}SharedError extends ${root}`)); + assert.match(rpcSource(files, root), new RegExp(`value = ${root}SharedError.class, name = "error"`)); + } + const reversed = sharedUnionFixture([...roots].reverse()); + reversed.definitions = Object.fromEntries(Object.entries(reversed.definitions).reverse()); + assert.deepEqual( + [...(await renderRpcTypes(reversed, owners))].sort(), + [...files].sort() + ); + for (const root of roots) reversed.definitions[root].anyOf?.reverse(); + const reordered = await renderRpcTypes(reversed, owners); + for (const [file, source] of files) { + const updated = reordered.get(file); + assert.ok(updated); + // Membership ordering is not API identity; retain the schema's + // annotation order without changing ownership or output names. + assert.deepEqual(updated.split("\n").map((line) => line.replace(/,$/, "")).sort(), + source.split("\n").map((line) => line.replace(/,$/, "")).sort()); + } + }); +} + +test("RPC planning rejects unregistered shared ownership and missing historical owners", async () => { + const fixture = sharedUnionFixture(["FirstResult", "SecondResult"]); + await assert.rejects(renderRpcTypes(fixture, {}), /Ambiguous Java RPC owner for "SharedError"/); + await assert.rejects(renderRpcTypes(fixture, { SharedError: "MissingResult" }), /Missing historical Java RPC owner/); + await assert.rejects(renderRpcTypes(fixture, { RemovedVariant: "FirstResult" }), /Missing historical Java RPC owner/); + // A failed plan must not poison the next generation. + assert.ok((await renderRpcTypes(fixture, { SharedError: "FirstResult" })).size > 0); +}); + +test("RPC planning rejects incompatible shared schemas and contextual name collisions", async () => { + const incompatible = sharedUnionFixture(["FirstResult", "SecondResult"]); + incompatible.definitions.SecondResult.anyOf = [ + { + ...incompatible.definitions.SharedError, + properties: { kind: { const: "error" }, message: { type: "number" } }, + }, + { type: "object", properties: { kind: { const: "ok" } } }, + ]; + await assert.rejects(renderRpcTypes(incompatible, { SharedError: "FirstResult" }), /Incompatible schemas.*SharedError/); + + const collision = sharedUnionFixture(["FirstResult", "SecondResult"]); + collision.definitions.FirstResult.anyOf?.push({ + title: "SecondResultSharedError", type: "object", properties: { kind: { const: "extra" } }, + }); + await assert.rejects(renderRpcTypes(collision, { SharedError: "FirstResult" }), /Conflicting Java RPC contextual name/); + + const rootCollision = sharedUnionFixture(["SharedError", "SecondResult"]); + // Avoid the fixture's self-reference: a concrete title collides with a root. + rootCollision.definitions.SharedError.anyOf = [ + { title: "SharedError", type: "object", properties: { kind: { const: "error" } } }, + { type: "object", properties: { kind: { const: "ok" } } }, + ]; + delete rootCollision.server.SecondResult; + await assert.rejects(renderRpcTypes(rootCollision, {}), /Conflicting Java RPC variant name "SharedError"/); +}); + +test("nested standalone union memberships participate in the ownership plan", async () => { + const fixture = sharedUnionFixture(["FirstResult", "NestedResult"]); + delete fixture.server.NestedResult; + fixture.definitions.SharedError.properties!.detail = { + type: "array", items: { $ref: "#/definitions/NestedResult" }, + }; + const files = await renderRpcTypes(fixture, { SharedError: "FirstResult" }); + assert.match(rpcSource(files, "NestedResultSharedError"), /extends NestedResult/); + assert.match(rpcSource(files, "SharedError"), /extends FirstResult/); +}); + +test("identical repeated root references emit each variant only once", async () => { + const fixture = sharedUnionFixture(["FirstResult"]); + const original = await renderRpcTypes(fixture, {}); + fixture.server.alias = { rpcMethod: "alias", params: null, result: { $ref: "#/definitions/FirstResult" } }; + assert.deepEqual([...(await renderRpcTypes(fixture, {}))].sort(), [...original].sort()); +}); + +test("historical ABI registry retains the complete pre-intake ownership set", () => { + assert.equal(Object.keys(RPC_VARIANT_OWNERS).length, 61); + assert.equal(new Set(Object.values(RPC_VARIANT_OWNERS)).size, 12); + for (const name of ["CatalogNegotiationRefusedError", "CatalogInvalidRequestError", "CatalogUnavailableError"]) { + assert.equal(RPC_VARIANT_OWNERS[name], "CatalogSearchResult"); + } +}); diff --git a/java/scripts/codegen/java.ts b/java/scripts/codegen/java.ts index 97fdfe3250..db84b7e952 100644 --- a/java/scripts/codegen/java.ts +++ b/java/scripts/codegen/java.ts @@ -11,6 +11,7 @@ import fs from "fs/promises"; import type { JSONSchema7 } from "json-schema"; import path from "path"; import { fileURLToPath } from "url"; +import { RPC_VARIANT_OWNERS } from "./rpc-variant-owners.js"; const __filename = fileURLToPath(import.meta.url); const __dirname = path.dirname(__filename); @@ -195,8 +196,19 @@ async function getApiSchemaPath(): Promise { // ── File writing ───────────────────────────────────────────────────────────── +let pendingOutput: Map | undefined; + async function writeGeneratedFile(relativePath: string, content: string): Promise { const fullPath = path.join(REPO_ROOT, relativePath); + const files = rpcGeneration?.files ?? pendingOutput; + if (files) { + const previous = files.get(relativePath); + if (rpcGeneration?.variantNames && previous !== undefined && previous !== content) { + throw new Error(`Conflicting Java RPC output "${relativePath}".`); + } + files.set(relativePath, content); + return fullPath; + } await fs.mkdir(path.dirname(fullPath), { recursive: true }); await fs.writeFile(fullPath, content, "utf-8"); console.log(` ✓ ${relativePath}`); @@ -426,6 +438,80 @@ export function collectNestedDiscriminatedUnionTypeNames( /** * Generate a polymorphic base class and variant subclasses for a discriminated union result type. */ +interface RpcVariant { + discriminatorValue: string; + variantClassName: string; + schema: JSONSchema7; +} + +interface RpcUnion { + schema: JSONSchema7; + packageName: string; + packageDir: string; + discriminatorProperty: string; + variants: RpcVariant[]; +} + +interface RpcGeneration { + files: Map; + unions: Map; + variantNames?: Map>; +} + +let rpcGeneration: RpcGeneration | undefined; + +function planRpcVariantNames( + generation: RpcGeneration, + historicalOwners: Readonly> +): Map> { + const memberships = new Map>(); + const reserved = new Set([...generation.files.keys()].map((file) => path.basename(file, ".java"))); + for (const [root, union] of generation.unions) { + if (reserved.has(root)) throw new Error(`Conflicting Java RPC union name "${root}".`); + reserved.add(root); + for (const variant of union.variants) { + const owners = memberships.get(variant.variantClassName) ?? new Map(); + for (const [otherRoot, other] of owners) { + if (stableStringify(other.schema) !== stableStringify(variant.schema) || + generation.unions.get(otherRoot)?.discriminatorProperty !== union.discriminatorProperty || + other.discriminatorValue !== variant.discriminatorValue) { + throw new Error(`Incompatible schemas for Java RPC variant "${variant.variantClassName}" in "${otherRoot}" and "${root}".`); + } + } + owners.set(root, variant); + memberships.set(variant.variantClassName, owners); + } + } + for (const [name, owner] of Object.entries(historicalOwners)) { + if (!memberships.get(name)?.has(owner)) { + throw new Error(`Missing historical Java RPC owner "${owner}" for "${name}".`); + } + } + for (const name of memberships.keys()) { + if (reserved.has(name)) throw new Error(`Conflicting Java RPC variant name "${name}".`); + reserved.add(name); + } + const result = new Map>(); + for (const [name, owners] of [...memberships].sort(([a], [b]) => a.localeCompare(b))) { + const roots = [...owners.keys()].sort(); + const canonicalOwner = Object.hasOwn(historicalOwners, name) ? historicalOwners[name] : roots[0]; + if (!Object.hasOwn(historicalOwners, name) && roots.length > 1) { + throw new Error(`Ambiguous Java RPC owner for "${name}": ${roots.join(", ")}. Record its historical owner explicitly.`); + } + for (const root of roots) { + const contextualName = root === canonicalOwner ? name : `${root}${name}`; + if (root !== canonicalOwner) { + if (reserved.has(contextualName)) throw new Error(`Conflicting Java RPC contextual name "${contextualName}".`); + reserved.add(contextualName); + } + const names = result.get(root) ?? new Map(); + names.set(name, contextualName); + result.set(root, names); + } + } + return result; +} + async function generatePolymorphicResultClass( className: string, schema: JSONSchema7, @@ -441,19 +527,35 @@ async function generatePolymorphicResultClass( return; } - // Collect variant info - interface VariantInfo { - discriminatorValue: string; - variantClassName: string; - schema: JSONSchema7; - } - - const variantInfos: VariantInfo[] = []; + const variantInfos: RpcVariant[] = []; for (const [discValue, { schema: variantSchema }] of discriminator.mapping) { const variantClassName = (variantSchema as JSONSchema7 & { title?: string }).title ?? `${className}${toPascalCase(discValue)}`; variantInfos.push({ discriminatorValue: discValue, variantClassName, schema: variantSchema }); } + if (rpcGeneration && !rpcGeneration.variantNames) { + const previous = rpcGeneration.unions.get(className); + if (previous && stableStringify(previous.schema) !== stableStringify(schema)) { + throw new Error(`Conflicting Java RPC union "${className}".`); + } + rpcGeneration.unions.set(className, { + schema, packageName, packageDir, discriminatorProperty: discriminator.property, variants: variantInfos, + }); + // Resolve fields now so nested/standalone unions participate in the same + // ownership plan. Nothing is written until every membership is known. + for (const variant of variantInfos) { + await generatePolymorphicVariantClass(variant.variantClassName, variant.schema, variant.discriminatorValue, discriminator.property, className, packageName, packageDir); + } + return; + } + if (rpcGeneration?.variantNames) { + for (const variant of variantInfos) { + const name = rpcGeneration.variantNames.get(className)?.get(variant.variantClassName); + if (!name) throw new Error(`Unplanned Java RPC variant "${variant.variantClassName}" in "${className}".`); + variant.variantClassName = name; + } + } + // Generate the abstract base class const baseLines: string[] = []; baseLines.push(COPYRIGHT); @@ -624,6 +726,7 @@ async function generatePolymorphicVariantClass( const importLines = sortedImports.map((i) => `import ${i};`).join("\n"); lines[importPlaceholderIdx] = importLines; + if (rpcGeneration && !rpcGeneration.variantNames) return; await writeGeneratedFile(`${packageDir}/${className}.java`, lines.join("\n")); } @@ -1103,6 +1206,10 @@ async function generateEventVariantClass( packageName: string, packageDir: string ): Promise { + await writeGeneratedFile(`${packageDir}/${variant.className}.java`, renderEventVariantClass(variant, packageName)); +} + +export function renderEventVariantClass(variant: EventVariant, packageName: string): string { const lines: string[] = []; const allImports = new Set([ "com.fasterxml.jackson.annotation.JsonIgnoreProperties", @@ -1111,6 +1218,23 @@ async function generateEventVariantClass( "javax.annotation.processing.Generated", ]); const nestedTypes = new Map(); + const hasUnionData = [variant.dataSchema?.anyOf, variant.dataSchema?.oneOf].some( + (alternatives) => alternatives && alternatives.filter((alternative) => { + if (typeof alternative === "boolean") return alternative; + const types = Array.isArray(alternative.type) ? alternative.type : [alternative.type]; + return !( + types.every((type) => type === "null") || + alternative.const === null || + alternative.enum?.every((value) => value === null) + ); + }).length > 1 + ); + if (hasUnionData) { + allImports.add("com.fasterxml.jackson.annotation.JsonCreator"); + allImports.add("com.fasterxml.jackson.annotation.JsonValue"); + allImports.add("com.fasterxml.jackson.databind.JsonNode"); + allImports.add("com.fasterxml.jackson.databind.node.JsonNodeFactory"); + } // Collect data record fields interface FieldInfo { @@ -1122,7 +1246,7 @@ async function generateEventVariantClass( const dataFields: FieldInfo[] = []; - if (variant.dataSchema?.properties) { + if (!hasUnionData && variant.dataSchema?.properties) { for (const [propName, propSchema] of Object.entries(variant.dataSchema.properties)) { if (typeof propSchema !== "object") continue; const prop = propSchema as JSONSchema7; @@ -1192,10 +1316,24 @@ async function generateEventVariantClass( lines.push(` public void setData(${variant.className}Data data) { this.data = data; }`); lines.push(""); // Generate data inner record - lines.push(` /** Data payload for {@link ${variant.className}}. */`); + lines.push(hasUnionData + ? ` /** Raw union payload for {@link ${variant.className}}, preserving every variant's fields. */` + : ` /** Data payload for {@link ${variant.className}}. */`); lines.push(` @JsonIgnoreProperties(ignoreUnknown = true)`); lines.push(` @JsonInclude(JsonInclude.Include.NON_NULL)`); - if (dataFields.length === 0) { + if (hasUnionData) { + // Keep the existing nested record and no-arg constructor binary-compatible. + lines.push(` public record ${variant.className}Data(JsonNode raw) {`); + lines.push(` @JsonCreator(mode = JsonCreator.Mode.DELEGATING)`); + lines.push(` public ${variant.className}Data {}`); + lines.push(""); + lines.push(` public ${variant.className}Data() {`); + lines.push(` this(JsonNodeFactory.instance.objectNode());`); + lines.push(` }`); + lines.push(""); + lines.push(` @JsonValue`); + lines.push(` public JsonNode raw() { return raw; }`); + } else if (dataFields.length === 0) { lines.push(` public record ${variant.className}Data() {`); } else { lines.push(` public record ${variant.className}Data(`); @@ -1225,7 +1363,7 @@ async function generateEventVariantClass( const importLines = sortedImports.map((i) => `import ${i};`).join("\n"); lines[importPlaceholderIdx] = importLines; - await writeGeneratedFile(`${packageDir}/${variant.className}.java`, lines.join("\n")); + return lines.join("\n"); } // ── Standalone $ref type generation ────────────────────────────────────────── @@ -1475,21 +1613,18 @@ function generateRpcClass( return { code: lines.join("\n"), imports }; } +interface RpcSchema { + server?: Record; + session?: Record; + clientSession?: Record; + clientGlobal?: Record; + definitions?: Record; +} + async function generateRpcTypes(schemaPath: string): Promise { console.log("\n🔌 Generating RPC types..."); const schemaContent = await fs.readFile(schemaPath, "utf-8"); - const schema = normalizeSchemaBrandCasing(JSON.parse(schemaContent)) as Record & { - server?: Record; - session?: Record; - clientSession?: Record; - clientGlobal?: Record; - definitions?: Record; - }; - - // Set module-level definitions for $ref resolution - currentDefinitions = (schema.definitions ?? {}) as Record; - pendingStandaloneTypes.clear(); - promotedNestedUnionTypes.clear(); + const schema: RpcSchema = normalizeSchemaBrandCasing(JSON.parse(schemaContent)); crossSchemaDefinitions.clear(); // Load cross-schema definitions (session-events) so that cross-schema $ref values @@ -1504,6 +1639,35 @@ async function generateRpcTypes(schemaPath: string): Promise { console.warn(`[codegen] Could not load session-events schema for cross-ref resolution: ${e}`); } + const files = await renderRpcTypes(schema); + for (const [file, content] of files) await writeGeneratedFile(file, content); + console.log(`✅ Generated ${files.size} RPC type files`); +} + +/** Plan and render all RPC types in memory, rejecting ABI/name conflicts before file writes. */ +export async function renderRpcTypes( + schema: RpcSchema, + historicalOwners: Readonly> = RPC_VARIANT_OWNERS +): Promise> { + if (rpcGeneration) throw new Error("Concurrent Java RPC generation is not supported."); + const generation: RpcGeneration = { files: new Map(), unions: new Map() }; + rpcGeneration = generation; + try { + await collectRpcTypes(schema); + generation.variantNames = planRpcVariantNames(generation, historicalOwners); + for (const [name, union] of generation.unions) { + await generatePolymorphicResultClass(name, union.schema, union.packageName, union.packageDir); + } + return generation.files; + } finally { + rpcGeneration = undefined; + } +} + +async function collectRpcTypes(schema: RpcSchema): Promise { + currentDefinitions = schema.definitions ?? {}; + pendingStandaloneTypes.clear(); + promotedNestedUnionTypes.clear(); const packageName = "com.github.copilot.generated.rpc"; const packageDir = `sdk/src/generated/java/com/github/copilot/generated/rpc`; @@ -1613,7 +1777,6 @@ async function generateRpcTypes(schemaPath: string): Promise { // Generate standalone types discovered via $ref resolution await generatePendingStandaloneTypes(packageName, packageDir, GENERATED_FROM_API); - console.log(`✅ Generated ${allFiles.length} RPC type files`); } async function generateRpcDataClass( @@ -2475,26 +2638,32 @@ async function main(): Promise { console.log("🚀 Java SDK code generator"); console.log("============================"); - // Clean the generated output directory to remove orphaned files from previous runs - const generatedOutputDir = path.join(REPO_ROOT, "sdk/src/generated/java/com/github/copilot/generated"); - console.log(`🧹 Cleaning output directory: ${generatedOutputDir}`); - await fs.rm(generatedOutputDir, { recursive: true, force: true }); - await fs.mkdir(generatedOutputDir, { recursive: true }); - const sessionEventsSchemaPath = await getSessionEventsSchemaPath(); console.log(`📄 Session events schema: ${sessionEventsSchemaPath}`); const apiSchemaPath = await getApiSchemaPath(); console.log(`📄 API schema: ${apiSchemaPath}`); - await generateSessionEvents(sessionEventsSchemaPath); - await generateRpcTypes(apiSchemaPath); - await generateRpcWrappers(apiSchemaPath); + // Preserve the previous output on schema/ABI validation failures. + const files = new Map(); + pendingOutput = files; + try { + await generateSessionEvents(sessionEventsSchemaPath); + await generateRpcTypes(apiSchemaPath); + await generateRpcWrappers(apiSchemaPath); + + const generatedPkgDir = `sdk/src/generated/java/com/github/copilot/generated`; + const rpcPkgDir = `sdk/src/generated/java/com/github/copilot/generated/rpc`; + await generateGeneratedPackageInfo(generatedPkgDir); + await generateRpcPackageInfo(rpcPkgDir); + } finally { + pendingOutput = undefined; + } - // Generate package-info.java for each generated package - const generatedPkgDir = `sdk/src/generated/java/com/github/copilot/generated`; - const rpcPkgDir = `sdk/src/generated/java/com/github/copilot/generated/rpc`; - await generateGeneratedPackageInfo(generatedPkgDir); - await generateRpcPackageInfo(rpcPkgDir); + const generatedOutputDir = path.join(REPO_ROOT, "sdk/src/generated/java/com/github/copilot/generated"); + console.log(`🧹 Cleaning output directory: ${generatedOutputDir}`); + await fs.rm(generatedOutputDir, { recursive: true, force: true }); + await fs.mkdir(generatedOutputDir, { recursive: true }); + for (const [file, content] of files) await writeGeneratedFile(file, content); console.log("\n✅ Java code generation complete!"); } diff --git a/java/scripts/codegen/rpc-variant-owners.ts b/java/scripts/codegen/rpc-variant-owners.ts new file mode 100644 index 0000000000..843738fbad --- /dev/null +++ b/java/scripts/codegen/rpc-variant-owners.ts @@ -0,0 +1,78 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +/** + * Historical Java RPC variant superclasses at copilot-sdk + * ad69ee168680728872434817191ef8cc5e449431 (61 public variants). + * + * This is ABI input, not generated output: a shared schema title cannot express + * which Java superclass previously owned its public class name. Preserve these + * entries when adding union memberships. For a newly shared variant, explicitly + * record its previously published owner here; do not infer it from generation + * order or mutable generated files. Removal/reassignment requires an intentional + * API compatibility decision, not an automatic schema-update rewrite. + */ +export const RPC_VARIANT_OWNERS: Readonly> = { + AgentRegistrySpawnError: "AgentRegistrySpawnResult", + AgentRegistrySpawnRegistryTimeout: "AgentRegistrySpawnResult", + AgentRegistrySpawnSpawned: "AgentRegistrySpawnResult", + AgentRegistrySpawnValidationError: "AgentRegistrySpawnResult", + ApiKeyAuthInfo: "AuthInfo", + CopilotApiTokenAuthInfo: "AuthInfo", + EnvAuthInfo: "AuthInfo", + GhCliAuthInfo: "AuthInfo", + HMACAuthInfo: "AuthInfo", + TokenAuthInfo: "AuthInfo", + TokenProviderAuthInfo: "AuthInfo", + UserAuthInfo: "AuthInfo", + CatalogAiSkillCandidate: "CatalogCandidate", + CatalogMcpServerCandidate: "CatalogCandidate", + CatalogCandidateSourceEmbedded: "CatalogCandidateSource", + CatalogCandidateSourceUrl: "CatalogCandidateSource", + CatalogAuthenticationRequiredError: "CatalogSearchResult", + CatalogContractViolationError: "CatalogSearchResult", + CatalogInvalidRequestError: "CatalogSearchResult", + CatalogMalformedCardError: "CatalogSearchResult", + CatalogNegotiationRefusedError: "CatalogSearchResult", + CatalogNetworkFailureError: "CatalogSearchResult", + CatalogPolicyRejectedError: "CatalogSearchResult", + CatalogSearchSucceeded: "CatalogSearchResult", + CatalogUnavailableError: "CatalogSearchResult", + CatalogUnsafeRetrievalError: "CatalogSearchResult", + CatalogUnsupportedKindError: "CatalogSearchResult", + CatalogTrustSnapshotAbsent: "CatalogTrustSnapshot", + CatalogTrustSnapshotCurrent: "CatalogTrustSnapshot", + CatalogTrustSnapshotDowngraded: "CatalogTrustSnapshot", + CatalogTrustSnapshotMalformed: "CatalogTrustSnapshot", + CatalogTrustSnapshotRevoked: "CatalogTrustSnapshot", + CatalogTrustSnapshotStale: "CatalogTrustSnapshot", + CatalogTrustSnapshotUnsupported: "CatalogTrustSnapshot", + GitHubTokenAcquireResultCancelled: "GitHubTokenAcquireResult", + GitHubTokenAcquireResultToken: "GitHubTokenAcquireResult", + McpOauthProbeResultAuthenticated: "McpOauthProbeResult", + McpOauthProbeResultFailed: "McpOauthProbeResult", + McpOauthProbeResultNeedsAuth: "McpOauthProbeResult", + McpOauthProbeResultNoAuthRequired: "McpOauthProbeResult", + CatalogHandleRejectedError: "McpPlanInstallResult", + CatalogNotInstallableError: "McpPlanInstallResult", + CatalogUnavailableTransportError: "McpPlanInstallResult", + McpPlanInstallPlanned: "McpPlanInstallResult", + SessionLimitPredictionResultAvailable: "SessionLimitPredictionResult", + SessionLimitPredictionResultUnavailable: "SessionLimitPredictionResult", + SessionsOpenAttach: "SessionsOpenParams", + SessionsOpenCloud: "SessionsOpenParams", + SessionsOpenCreate: "SessionsOpenParams", + SessionsOpenHandoff: "SessionsOpenParams", + SessionsOpenRemote: "SessionsOpenParams", + SessionsOpenResume: "SessionsOpenParams", + SessionsOpenResumeLast: "SessionsOpenParams", + SlashCommandAgentPromptResult: "SlashCommandInvocationResult", + SlashCommandCompletedResult: "SlashCommandInvocationResult", + SlashCommandInvocationResultAddTimelineEntry: "SlashCommandInvocationResult", + SlashCommandInvocationResultSetModel: "SlashCommandInvocationResult", + SlashCommandInvocationResultSetPlanModel: "SlashCommandInvocationResult", + SlashCommandInvocationResultShowDialog: "SlashCommandInvocationResult", + SlashCommandSelectSubcommandResult: "SlashCommandInvocationResult", + SlashCommandTextResult: "SlashCommandInvocationResult", +}; diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/AssistantUsageEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/AssistantUsageEvent.java index d0956f5a77..a2e08bfb14 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/AssistantUsageEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/AssistantUsageEvent.java @@ -11,6 +11,7 @@ import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; import java.time.OffsetDateTime; +import java.util.List; import java.util.Map; import javax.annotation.processing.Generated; @@ -50,6 +51,10 @@ public record AssistantUsageEventData( @JsonProperty("cacheExpiresAt") OffsetDateTime cacheExpiresAt, /** Number of output tokens used for reasoning (e.g., chain-of-thought) */ @JsonProperty("reasoningTokens") Long reasoningTokens, + /** Number of prior thinking blocks the provider dropped while transforming the request */ + @JsonProperty("thinkingDroppedBlocks") Long thinkingDroppedBlocks, + /** Recognized provider-reported reasons for dropped thinking blocks, in response order */ + @JsonProperty("thinkingDroppedReasons") List thinkingDroppedReasons, /** Model multiplier cost for billing purposes */ @JsonProperty("cost") Double cost, /** Duration of the API call in milliseconds */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/ModelChangeSource.java b/java/sdk/src/generated/java/com/github/copilot/generated/ModelChangeSource.java index 0d54709de8..6279057df9 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/ModelChangeSource.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/ModelChangeSource.java @@ -36,6 +36,8 @@ public enum ModelChangeSource { PLAN_MODE("plan_mode"), /** The {@code automatic} variant. */ AUTOMATIC("automatic"), + /** The {@code changeboarding_shortcut} variant. */ + CHANGEBOARDING_SHORTCUT("changeboarding_shortcut"), /** The {@code sdk} variant. */ SDK("sdk"); diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionCompletedEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionCompletedEvent.java index 51e19ad373..b6da6bfb05 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionCompletedEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionCompletedEvent.java @@ -38,6 +38,10 @@ public record PermissionCompletedEventData( @JsonProperty("requestId") String requestId, /** Optional tool call ID associated with this permission prompt; clients may use it to correlate UI created from tool-scoped prompts */ @JsonProperty("toolCallId") String toolCallId, + /** Permission-recovery episode settled by this response, when the request was escalated by Autopilot */ + @JsonProperty("recoveryEpisodeId") String recoveryEpisodeId, + /** Atomic structured blocked outcome when this permission response ended an Autopilot recovery episode unsuccessfully */ + @JsonProperty("blocker") TaskBlocker blocker, /** The result of the permission request */ @JsonProperty("result") Object result, /** Who decided this permission request. Absent on completions recorded before this field existed, which consumers must treat as "not a human decision" rather than assuming one. Authorization records are minted only for `human_response`; an assisted-approval verdict, a host policy, an unattended fallback, and a hook resolution all produce the same `result` a person does, so this is the only field that distinguishes them. */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttempt.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttempt.java new file mode 100644 index 0000000000..cb73a35d66 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttempt.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionRecoveryAttempt( + /** Unique identifier for this attempt record */ + @JsonProperty("attemptId") String attemptId, + /** Tool-call identifier associated with this attempt, when available */ + @JsonProperty("toolCallId") String toolCallId, + /** Controlled permission request kind, such as shell, path, URL, or tool */ + @JsonProperty("permissionKind") String permissionKind, + /** SHA-256 fingerprint of normalized request data; raw permission arguments are not included */ + @JsonProperty("requestFingerprint") String requestFingerprint, + /** Relationship between this attempt and earlier attempts in the episode */ + @JsonProperty("relation") PermissionRecoveryAttemptRelation relation, + /** How the runtime handled this attempt */ + @JsonProperty("disposition") PermissionRecoveryAttemptDisposition disposition, + /** Controlled reason for the attempt disposition */ + @JsonProperty("reason") PermissionRecoveryAttemptReason reason, + /** One-based position of this attempt in the episode */ + @JsonProperty("ordinal") Long ordinal +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptDisposition.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptDisposition.java new file mode 100644 index 0000000000..b481e57dfc --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptDisposition.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Runtime handling applied to a recovery attempt + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryAttemptDisposition { + /** The {@code deferred} variant. */ + DEFERRED("deferred"), + /** The {@code prompted} variant. */ + PROMPTED("prompted"), + /** The {@code approved} variant. */ + APPROVED("approved"), + /** The {@code denied} variant. */ + DENIED("denied"), + /** The {@code blocked} variant. */ + BLOCKED("blocked"), + /** The {@code succeeded} variant. */ + SUCCEEDED("succeeded"); + + private final String value; + PermissionRecoveryAttemptDisposition(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryAttemptDisposition fromValue(String value) { + for (PermissionRecoveryAttemptDisposition v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryAttemptDisposition value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptReason.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptReason.java new file mode 100644 index 0000000000..e0aaac9b11 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptReason.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Controlled reason for an individual attempt disposition + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryAttemptReason { + /** The {@code permission_required} variant. */ + PERMISSION_REQUIRED("permission_required"), + /** The {@code repeated_attempt} variant. */ + REPEATED_ATTEMPT("repeated_attempt"), + /** The {@code attempts_exhausted} variant. */ + ATTEMPTS_EXHAUSTED("attempts_exhausted"), + /** The {@code permission_approved} variant. */ + PERMISSION_APPROVED("permission_approved"), + /** The {@code permission_denied} variant. */ + PERMISSION_DENIED("permission_denied"), + /** The {@code responder_unavailable} variant. */ + RESPONDER_UNAVAILABLE("responder_unavailable"), + /** The {@code equivalent_alternative_succeeded} variant. */ + EQUIVALENT_ALTERNATIVE_SUCCEEDED("equivalent_alternative_succeeded"); + + private final String value; + PermissionRecoveryAttemptReason(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryAttemptReason fromValue(String value) { + for (PermissionRecoveryAttemptReason v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryAttemptReason value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptRelation.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptRelation.java new file mode 100644 index 0000000000..0443613710 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryAttemptRelation.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Relationship of an attempt to earlier permission requests + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryAttemptRelation { + /** The {@code initial} variant. */ + INITIAL("initial"), + /** The {@code retry} variant. */ + RETRY("retry"), + /** The {@code alternative} variant. */ + ALTERNATIVE("alternative"); + + private final String value; + PermissionRecoveryAttemptRelation(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryAttemptRelation fromValue(String value) { + for (PermissionRecoveryAttemptRelation v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryAttemptRelation value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryData.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryData.java new file mode 100644 index 0000000000..ed38c3c168 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryData.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Authoritative snapshot of an Autopilot permission-recovery episode + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionRecoveryData( + /** Stable identifier shared by every transition in this recovery episode */ + @JsonProperty("episodeId") String episodeId, + /** Current lifecycle state of the recovery episode */ + @JsonProperty("status") PermissionRecoveryStatus status, + /** Policy selected from the current client's response capability; mode or client changes may update it during recovery */ + @JsonProperty("onBlocked") PermissionRecoveryOnBlocked onBlocked, + /** Controlled reason for the latest episode transition */ + @JsonProperty("reason") PermissionRecoveryReason reason, + /** Maximum number of distinct autonomous permission attempts allowed before escalation */ + @JsonProperty("maxAttempts") Long maxAttempts, + /** Ordered privacy-safe record of permission attempts and the successful alternative, when any */ + @JsonProperty("attempts") List attempts +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryOnBlocked.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryOnBlocked.java new file mode 100644 index 0000000000..5fbc2e4162 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryOnBlocked.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Action selected when autonomous recovery cannot continue + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryOnBlocked { + /** The {@code ask} variant. */ + ASK("ask"), + /** The {@code fail} variant. */ + FAIL("fail"); + + private final String value; + PermissionRecoveryOnBlocked(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryOnBlocked fromValue(String value) { + for (PermissionRecoveryOnBlocked v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryOnBlocked value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryReason.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryReason.java new file mode 100644 index 0000000000..08b473bedb --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryReason.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Controlled reason for a permission-recovery episode transition + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryReason { + /** The {@code permission_required} variant. */ + PERMISSION_REQUIRED("permission_required"), + /** The {@code repeated_attempt} variant. */ + REPEATED_ATTEMPT("repeated_attempt"), + /** The {@code attempts_exhausted} variant. */ + ATTEMPTS_EXHAUSTED("attempts_exhausted"), + /** The {@code permission_approved} variant. */ + PERMISSION_APPROVED("permission_approved"), + /** The {@code permission_denied} variant. */ + PERMISSION_DENIED("permission_denied"), + /** The {@code responder_unavailable} variant. */ + RESPONDER_UNAVAILABLE("responder_unavailable"), + /** The {@code equivalent_alternative_succeeded} variant. */ + EQUIVALENT_ALTERNATIVE_SUCCEEDED("equivalent_alternative_succeeded"); + + private final String value; + PermissionRecoveryReason(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryReason fromValue(String value) { + for (PermissionRecoveryReason v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryReason value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryStatus.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryStatus.java new file mode 100644 index 0000000000..612561740f --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRecoveryStatus.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Lifecycle state of a permission-recovery episode + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryStatus { + /** The {@code recovering} variant. */ + RECOVERING("recovering"), + /** The {@code awaiting_approval} variant. */ + AWAITING_APPROVAL("awaiting_approval"), + /** The {@code resolved} variant. */ + RESOLVED("resolved"), + /** The {@code blocked} variant. */ + BLOCKED("blocked"); + + private final String value; + PermissionRecoveryStatus(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryStatus fromValue(String value) { + for (PermissionRecoveryStatus v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryStatus value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRequestedEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRequestedEvent.java index a854d5ffa4..dd18d2af2e 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRequestedEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/PermissionRequestedEvent.java @@ -40,12 +40,16 @@ public record PermissionRequestedEventData( @JsonProperty("permissionRequest") Object permissionRequest, /** Derived user-facing permission prompt details for UI consumers */ @JsonProperty("promptRequest") Object promptRequest, + /** Permission mode captured when evaluation began. Absent on historical events. */ + @JsonProperty("permissionMode") PermissionMode permissionMode, /** Agent mode captured from the owning turn when permission evaluation began. */ @JsonProperty("agentMode") SessionMode agentMode, /** Neutral risk metadata supplied by the tool host. Consumers may display this value but must not use it to bypass the permission decision. */ @JsonProperty("riskAssessment") Object riskAssessment, /** When true, this permission was already resolved by a permissionRequest hook and requires no client action */ - @JsonProperty("resolvedByHook") Boolean resolvedByHook + @JsonProperty("resolvedByHook") Boolean resolvedByHook, + /** Permission-recovery episode that authorized this request to surface for interactive attention */ + @JsonProperty("recoveryEpisodeId") String recoveryEpisodeId ) { } } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/ResponsesReasoning.java b/java/sdk/src/generated/java/com/github/copilot/generated/ResponsesReasoning.java new file mode 100644 index 0000000000..764284ac2c --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/ResponsesReasoning.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Original request-level and effective conversation reasoning effort for a Responses history boundary + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record ResponsesReasoning( + /** Provider model whose reasoning settings this boundary records */ + @JsonProperty("model") String model, + /** Original request-level effort, retained while replaying this conversation prefix */ + @JsonProperty("initialEffort") String initialEffort, + /** Effective effort selected before this message, independent of the response-level reasoning field */ + @JsonProperty("effort") String effort +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SandboxDecisionEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SandboxDecisionEvent.java index f87be0fe9d..5b1f5c7d2e 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/SandboxDecisionEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SandboxDecisionEvent.java @@ -7,9 +7,13 @@ package com.github.copilot.generated; +import com.fasterxml.jackson.annotation.JsonCreator; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonInclude; import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonValue; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.node.JsonNodeFactory; import javax.annotation.processing.Generated; /** @@ -30,9 +34,18 @@ public final class SandboxDecisionEvent extends SessionEvent { public SandboxDecisionEventData getData() { return data; } public void setData(SandboxDecisionEventData data) { this.data = data; } - /** Data payload for {@link SandboxDecisionEvent}. */ + /** Raw union payload for {@link SandboxDecisionEvent}, preserving every variant's fields. */ @JsonIgnoreProperties(ignoreUnknown = true) @JsonInclude(JsonInclude.Include.NON_NULL) - public record SandboxDecisionEventData() { + public record SandboxDecisionEventData(JsonNode raw) { + @JsonCreator(mode = JsonCreator.Mode.DELEGATING) + public SandboxDecisionEventData {} + + public SandboxDecisionEventData() { + this(JsonNodeFactory.instance.objectNode()); + } + + @JsonValue + public JsonNode raw() { return raw; } } } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SessionCompactionCompleteEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SessionCompactionCompleteEvent.java index 70861fb977..6b21976b0c 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/SessionCompactionCompleteEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SessionCompactionCompleteEvent.java @@ -52,6 +52,8 @@ public record SessionCompactionCompleteEventData( @JsonProperty("customInstructions") String customInstructions, /** LLM-generated summary of the compacted conversation history */ @JsonProperty("summaryContent") String summaryContent, + /** Reasoning baseline on the replacement summary, preserved when replay skips the compacted history */ + @JsonProperty("responsesReasoning") ResponsesReasoning responsesReasoning, /** Authoritative active-factory reminder appended to the compacted context */ @JsonProperty("activeFactorySummary") String activeFactorySummary, /** Canonical model identifier used for model-specific behavior when replaying compaction */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SessionEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SessionEvent.java index 280b640138..1ebc436858 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/SessionEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SessionEvent.java @@ -36,6 +36,7 @@ @JsonSubTypes.Type(value = SessionScheduleRearmedEvent.class, name = "session.schedule_rearmed"), @JsonSubTypes.Type(value = SessionAutopilotObjectiveChangedEvent.class, name = "session.autopilot_objective_changed"), @JsonSubTypes.Type(value = SessionInfoEvent.class, name = "session.info"), + @JsonSubTypes.Type(value = SessionIndexedSearchEvent.class, name = "session.indexed_search"), @JsonSubTypes.Type(value = SessionWarningEvent.class, name = "session.warning"), @JsonSubTypes.Type(value = SessionModelChangeEvent.class, name = "session.model_change"), @JsonSubTypes.Type(value = SessionAutoTierRecommendationEvent.class, name = "session.auto_tier_recommendation"), @@ -63,6 +64,7 @@ @JsonSubTypes.Type(value = SessionFusionRouteFailedEvent.class, name = "session.fusion_route_failed"), @JsonSubTypes.Type(value = SessionFusionResolvedEvent.class, name = "session.fusion_resolved"), @JsonSubTypes.Type(value = SessionFusionCompletedEvent.class, name = "session.fusion_completed"), + @JsonSubTypes.Type(value = SessionPermissionRecoveryEvent.class, name = "session.permission_recovery"), @JsonSubTypes.Type(value = UserMessageEvent.class, name = "user.message"), @JsonSubTypes.Type(value = PendingMessagesModifiedEvent.class, name = "pending_messages.modified"), @JsonSubTypes.Type(value = AssistantTurnStartEvent.class, name = "assistant.turn_start"), @@ -185,6 +187,7 @@ public abstract sealed class SessionEvent permits SessionScheduleRearmedEvent, SessionAutopilotObjectiveChangedEvent, SessionInfoEvent, + SessionIndexedSearchEvent, SessionWarningEvent, SessionModelChangeEvent, SessionAutoTierRecommendationEvent, @@ -212,6 +215,7 @@ public abstract sealed class SessionEvent permits SessionFusionRouteFailedEvent, SessionFusionResolvedEvent, SessionFusionCompletedEvent, + SessionPermissionRecoveryEvent, UserMessageEvent, PendingMessagesModifiedEvent, AssistantTurnStartEvent, diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SessionIndexedSearchEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SessionIndexedSearchEvent.java new file mode 100644 index 0000000000..91d9fc27a0 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SessionIndexedSearchEvent.java @@ -0,0 +1,51 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonCreator; +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.annotation.JsonValue; +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.node.JsonNodeFactory; +import javax.annotation.processing.Generated; + +/** + * Session event "session.indexed_search". Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionIndexedSearchEvent extends SessionEvent { + + @Override + public String getType() { return "session.indexed_search"; } + + @JsonProperty("data") + private SessionIndexedSearchEventData data; + + public SessionIndexedSearchEventData getData() { return data; } + public void setData(SessionIndexedSearchEventData data) { this.data = data; } + + /** Raw union payload for {@link SessionIndexedSearchEvent}, preserving every variant's fields. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionIndexedSearchEventData(JsonNode raw) { + @JsonCreator(mode = JsonCreator.Mode.DELEGATING) + public SessionIndexedSearchEventData {} + + public SessionIndexedSearchEventData() { + this(JsonNodeFactory.instance.objectNode()); + } + + @JsonValue + public JsonNode raw() { return raw; } + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SessionPermissionRecoveryEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SessionPermissionRecoveryEvent.java new file mode 100644 index 0000000000..56d08f53b4 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SessionPermissionRecoveryEvent.java @@ -0,0 +1,52 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Session event "session.permission_recovery". Authoritative snapshot of an Autopilot permission-recovery episode + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionPermissionRecoveryEvent extends SessionEvent { + + @Override + public String getType() { return "session.permission_recovery"; } + + @JsonProperty("data") + private SessionPermissionRecoveryEventData data; + + public SessionPermissionRecoveryEventData getData() { return data; } + public void setData(SessionPermissionRecoveryEventData data) { this.data = data; } + + /** Data payload for {@link SessionPermissionRecoveryEvent}. */ + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record SessionPermissionRecoveryEventData( + /** Stable identifier shared by every transition in this recovery episode */ + @JsonProperty("episodeId") String episodeId, + /** Current lifecycle state of the recovery episode */ + @JsonProperty("status") PermissionRecoveryStatus status, + /** Policy selected from the current client's response capability; mode or client changes may update it during recovery */ + @JsonProperty("onBlocked") PermissionRecoveryOnBlocked onBlocked, + /** Controlled reason for the latest episode transition */ + @JsonProperty("reason") PermissionRecoveryReason reason, + /** Maximum number of distinct autonomous permission attempts allowed before escalation */ + @JsonProperty("maxAttempts") Long maxAttempts, + /** Ordered privacy-safe record of permission attempts and the successful alternative, when any */ + @JsonProperty("attempts") List attempts + ) { + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SessionTaskCompleteEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SessionTaskCompleteEvent.java index c44c682b1c..5f89a10d27 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/SessionTaskCompleteEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SessionTaskCompleteEvent.java @@ -43,7 +43,9 @@ public record SessionTaskCompleteEventData( /** Label-safe runtime rationale for the completion decision (e.g. a cancellation or pause/resume downgrade), when one applies. Reviewer-authored rationale is intentionally omitted here because this event has no IFC label channel; the reviewer's findings remain available through its own labeled sub-agent events */ @JsonProperty("reason") String reason, /** Active autopilot objective ID evaluated by the completion reviewer */ - @JsonProperty("objectiveId") Long objectiveId + @JsonProperty("objectiveId") Long objectiveId, + /** Structured blocker details when outcome is blocked */ + @JsonProperty("blocker") TaskBlocker blocker ) { } } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SkillInvokedEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SkillInvokedEvent.java index e8675a6bbc..ffc45290b9 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/SkillInvokedEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SkillInvokedEvent.java @@ -37,6 +37,8 @@ public final class SkillInvokedEvent extends SessionEvent { public record SkillInvokedEventData( /** Name of the invoked skill */ @JsonProperty("name") String name, + /** Projected chat-message count when the skill was invoked. New writers persist this so replay does not need to reconstruct superseded history; readers derive it for legacy events when absent. */ + @JsonProperty("invokedAtTurn") Long invokedAtTurn, /** Model identifier active when the skill was invoked, when known */ @JsonProperty("model") String model, /** File path to the SKILL.md definition, or an empty string for an SDK-provided skill without a filesystem identity */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SkillInvokedRefEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SkillInvokedRefEvent.java index c3a428ff6b..5dc09939e9 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/SkillInvokedRefEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SkillInvokedRefEvent.java @@ -37,6 +37,8 @@ public final class SkillInvokedRefEvent extends SessionEvent { public record SkillInvokedRefEventData( /** Name of the invoked skill */ @JsonProperty("name") String name, + /** Projected chat-message count when the skill was invoked. Preserved from the inline event data when the authored body is deduplicated. */ + @JsonProperty("invokedAtTurn") Long invokedAtTurn, /** Model identifier active when the skill was invoked, when known */ @JsonProperty("model") String model, /** File path to the SKILL.md definition, or an empty string for an SDK-provided skill without a filesystem identity */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/SystemNotificationEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/SystemNotificationEvent.java index 784a3a8bc1..c2e1e55706 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/SystemNotificationEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/SystemNotificationEvent.java @@ -37,7 +37,9 @@ public record SystemNotificationEventData( /** The notification text, typically wrapped in XML tags */ @JsonProperty("content") String content, /** Structured metadata identifying what triggered this notification */ - @JsonProperty("kind") Object kind + @JsonProperty("kind") Object kind, + /** Responses reasoning settings anchored before this model-facing message, for cache-stable history replay */ + @JsonProperty("responsesReasoning") ResponsesReasoning responsesReasoning ) { } } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/TaskBlocker.java b/java/sdk/src/generated/java/com/github/copilot/generated/TaskBlocker.java new file mode 100644 index 0000000000..54b9495d91 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/TaskBlocker.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Structured reason that the task cannot continue without intervention + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record TaskBlocker( + /** Category of intervention that blocked the task */ + @JsonProperty("kind") TaskBlockerKind kind, + /** Controlled reason for the current blocked state */ + @JsonProperty("reason") PermissionRecoveryReason reason, + /** Whether a later user response or steering message can resume the task */ + @JsonProperty("resumable") Boolean resumable, + /** Permission-recovery episode that produced this blocker */ + @JsonProperty("permissionRecovery") PermissionRecoveryData permissionRecovery +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/TaskBlockerKind.java b/java/sdk/src/generated/java/com/github/copilot/generated/TaskBlockerKind.java new file mode 100644 index 0000000000..2810bcfe10 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/TaskBlockerKind.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: session-events.schema.json + +package com.github.copilot.generated; + +import javax.annotation.processing.Generated; + +/** + * Category of structured task blocker + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum TaskBlockerKind { + /** The {@code permission_recovery} variant. */ + PERMISSION_RECOVERY("permission_recovery"); + + private final String value; + TaskBlockerKind(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static TaskBlockerKind fromValue(String value) { + for (TaskBlockerKind v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown TaskBlockerKind value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/UserMessageEvent.java b/java/sdk/src/generated/java/com/github/copilot/generated/UserMessageEvent.java index 43a886ea01..aca76d26d8 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/UserMessageEvent.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/UserMessageEvent.java @@ -37,6 +37,8 @@ public final class UserMessageEvent extends SessionEvent { public record UserMessageEventData( /** The user's message text as displayed in the timeline */ @JsonProperty("content") String content, + /** Responses reasoning settings anchored before this model-facing message, for cache-stable history replay */ + @JsonProperty("responsesReasoning") ResponsesReasoning responsesReasoning, /** Stable identity of the logical user message, matching the ID returned by send and retained by pending queue snapshots */ @JsonProperty("messageId") String messageId, /** Transformed version of the message sent to the model, with XML wrapping, timestamps, and other augmentations for prompt caching */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCandidate.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCandidate.java new file mode 100644 index 0000000000..929a3924b4 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCandidate.java @@ -0,0 +1,101 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * An inert Agent Plugin catalog result. Its canonical catalog identity, declared version, repository source claim, and explicit compatibility tags are safe to correlate, while its descriptor, URL, raw data, and installed-plugin state remain runtime-private. This contract-only variant does not mint or expose a candidate handle. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogAgentPluginCandidate extends CatalogCandidate { + + @JsonProperty("kind") + private final String kind = "plugin"; + + @Override + public String getKind() { return kind; } + + /** Canonical Agent Plugin media type. */ + @JsonProperty("mediaType") + private CatalogAgentPluginMediaType mediaType; + + /** Validated, normalised catalogue resource URN. This identity comes only from the catalog identifier and is never inferred from display text or installed-plugin state. */ + @JsonProperty("identity") + private String identity; + + /** Optional version declared by the catalog source. Omitted rather than guessed when the source supplies no version. */ + @JsonProperty("version") + private String version; + + /** Display name taken verbatim from the card. Inert untrusted text. */ + @JsonProperty("displayName") + private String displayName; + + /** Description taken verbatim from the card. Inert untrusted text. */ + @JsonProperty("description") + private String description; + + /** Publisher taken verbatim from the card. Inert untrusted text. */ + @JsonProperty("publisher") + private String publisher; + + /** Bounded repository provenance declared through the catalog's sourceSet and repoPath metadata. It contains no descriptor URL. */ + @JsonProperty("source") + private CatalogPluginRepositorySource source; + + /** Explicit validated compatibility tags, in canonical order. An empty list means the source declared no recognised compatibility; clients must not infer compatibility from other fields. `canvas-only` requires both `canvas` and `github-copilot`. */ + @JsonProperty("compatibilityTags") + private List compatibilityTags; + + /** Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw data, or content digest. */ + @JsonProperty("provenance") + private CatalogAgentPluginCandidateProvenance provenance; + + /** Versioned trust metadata observed from the catalog authority. Optional for protocol-3 compatibility and emitted only when the caller also requires the trust-snapshot capability. */ + @JsonProperty("trust") + private CatalogTrustSnapshot trust; + + public CatalogAgentPluginMediaType getMediaType() { return mediaType; } + public void setMediaType(CatalogAgentPluginMediaType mediaType) { this.mediaType = mediaType; } + + public String getIdentity() { return identity; } + public void setIdentity(String identity) { this.identity = identity; } + + public String getVersion() { return version; } + public void setVersion(String version) { this.version = version; } + + public String getDisplayName() { return displayName; } + public void setDisplayName(String displayName) { this.displayName = displayName; } + + public String getDescription() { return description; } + public void setDescription(String description) { this.description = description; } + + public String getPublisher() { return publisher; } + public void setPublisher(String publisher) { this.publisher = publisher; } + + public CatalogPluginRepositorySource getSource() { return source; } + public void setSource(CatalogPluginRepositorySource source) { this.source = source; } + + public List getCompatibilityTags() { return compatibilityTags; } + public void setCompatibilityTags(List compatibilityTags) { this.compatibilityTags = compatibilityTags; } + + public CatalogAgentPluginCandidateProvenance getProvenance() { return provenance; } + public void setProvenance(CatalogAgentPluginCandidateProvenance provenance) { this.provenance = provenance; } + + public CatalogTrustSnapshot getTrust() { return trust; } + public void setTrust(CatalogTrustSnapshot trust) { this.trust = trust; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCandidateProvenance.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCandidateProvenance.java new file mode 100644 index 0000000000..d3e65be949 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCandidateProvenance.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Where and when an Agent Plugin catalog reference was observed. Discovery provenance deliberately carries no descriptor URL, raw data, candidate handle, or content digest. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CatalogAgentPluginCandidateProvenance( + /** Host of the catalog authority that advertised the reference, without path, query, or credentials. Inert untrusted data. */ + @JsonProperty("authority") String authority, + /** ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a retrieval or validation timestamp. */ + @JsonProperty("observedAt") String observedAt, + /** Canonical Agent Plugin media type. */ + @JsonProperty("mediaType") CatalogAgentPluginMediaType mediaType +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCompatibilityTag.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCompatibilityTag.java new file mode 100644 index 0000000000..4f7fec4daf --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginCompatibilityTag.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Explicit Agent Plugin compatibility declared by exact catalog tags. Clients must not infer these values from display text or other metadata. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum CatalogAgentPluginCompatibilityTag { + /** The {@code canvas} variant. */ + CANVAS("canvas"), + /** The {@code canvas-only} variant. */ + CANVAS_ONLY("canvas-only"), + /** The {@code github-copilot} variant. */ + GITHUB_COPILOT("github-copilot"); + + private final String value; + CatalogAgentPluginCompatibilityTag(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static CatalogAgentPluginCompatibilityTag fromValue(String value) { + for (CatalogAgentPluginCompatibilityTag v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown CatalogAgentPluginCompatibilityTag value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginMediaType.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginMediaType.java new file mode 100644 index 0000000000..62a1e5e70f --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAgentPluginMediaType.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Canonical Agent Plugin media type + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum CatalogAgentPluginMediaType { + /** The {@code application/vnd.github.copilot-plugin} variant. */ + APPLICATION_VND_GITHUB_COPILOT_PLUGIN("application/vnd.github.copilot-plugin"); + + private final String value; + CatalogAgentPluginMediaType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static CatalogAgentPluginMediaType fromValue(String value) { + for (CatalogAgentPluginMediaType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown CatalogAgentPluginMediaType value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillCandidate.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillCandidate.java index 5cbcafcc73..1051020dd5 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillCandidate.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillCandidate.java @@ -38,11 +38,11 @@ public final class CatalogAiSkillCandidate extends CatalogCandidate { /** Media type of the underlying AI skill card */ @JsonProperty("mediaType") - private String mediaType; + private CatalogAiSkillMediaType mediaType; /** AI skills are discovery-only and cannot be installed through this surface */ @JsonProperty("installability") - private String installability; + private CatalogAiSkillInstallability installability; /** Display name taken verbatim from the card. Inert untrusted text. */ @JsonProperty("displayName") @@ -74,11 +74,11 @@ public final class CatalogAiSkillCandidate extends CatalogCandidate { public String getHandleExpiresAt() { return handleExpiresAt; } public void setHandleExpiresAt(String handleExpiresAt) { this.handleExpiresAt = handleExpiresAt; } - public String getMediaType() { return mediaType; } - public void setMediaType(String mediaType) { this.mediaType = mediaType; } + public CatalogAiSkillMediaType getMediaType() { return mediaType; } + public void setMediaType(CatalogAiSkillMediaType mediaType) { this.mediaType = mediaType; } - public String getInstallability() { return installability; } - public void setInstallability(String installability) { this.installability = installability; } + public CatalogAiSkillInstallability getInstallability() { return installability; } + public void setInstallability(CatalogAiSkillInstallability installability) { this.installability = installability; } public String getDisplayName() { return displayName; } public void setDisplayName(String displayName) { this.displayName = displayName; } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillCandidateProvenance.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillCandidateProvenance.java index 0a2eff24e8..aef8990c6c 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillCandidateProvenance.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillCandidateProvenance.java @@ -26,6 +26,6 @@ public record CatalogAiSkillCandidateProvenance( /** ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a retrieval or validation timestamp. */ @JsonProperty("observedAt") String observedAt, /** Media type advertised for the referenced AI skill card */ - @JsonProperty("mediaType") String mediaType + @JsonProperty("mediaType") CatalogAiSkillMediaType mediaType ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillInstallability.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillInstallability.java new file mode 100644 index 0000000000..64c8f6e994 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillInstallability.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Typed non-installable state for an AI skill candidate + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum CatalogAiSkillInstallability { + /** The {@code not-installable-kind} variant. */ + NOT_INSTALLABLE_KIND("not-installable-kind"); + + private final String value; + CatalogAiSkillInstallability(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static CatalogAiSkillInstallability fromValue(String value) { + for (CatalogAiSkillInstallability v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown CatalogAiSkillInstallability value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillMediaType.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillMediaType.java new file mode 100644 index 0000000000..5ea0ce2e64 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogAiSkillMediaType.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Canonical AI skill media type + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum CatalogAiSkillMediaType { + /** The {@code application/ai-skill} variant. */ + APPLICATION_AI_SKILL("application/ai-skill"); + + private final String value; + CatalogAiSkillMediaType(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static CatalogAiSkillMediaType fromValue(String value) { + for (CatalogAiSkillMediaType v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown CatalogAiSkillMediaType value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCandidate.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCandidate.java index a712236ddb..2df7a4ecdc 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCandidate.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCandidate.java @@ -13,14 +13,15 @@ import javax.annotation.processing.Generated; /** - * One inert catalog result, represented as an MCP server or discovery-only AI skill variant so kind, media type, provenance, and installability cannot contradict each other. + * One inert catalog result, represented as an MCP server, discovery-only AI skill, or opt-in Agent Plugin variant so kind, media type, provenance, and available operations cannot contradict each other. * * @since 1.0.0 */ @JsonTypeInfo(use = JsonTypeInfo.Id.NAME, include = JsonTypeInfo.As.EXISTING_PROPERTY, property = "kind", visible = true) @JsonSubTypes({ @JsonSubTypes.Type(value = CatalogMcpServerCandidate.class, name = "mcp-server"), - @JsonSubTypes.Type(value = CatalogAiSkillCandidate.class, name = "ai-skill") + @JsonSubTypes.Type(value = CatalogAiSkillCandidate.class, name = "ai-skill"), + @JsonSubTypes.Type(value = CatalogAgentPluginCandidate.class, name = "plugin") }) @JsonIgnoreProperties(ignoreUnknown = true) @javax.annotation.processing.Generated("copilot-sdk-codegen") diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCandidateKind.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCandidateKind.java index e7316cf872..d3be865be6 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCandidateKind.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCandidateKind.java @@ -19,7 +19,9 @@ public enum CatalogCandidateKind { /** The {@code mcp-server} variant. */ MCP_SERVER("mcp-server"), /** The {@code ai-skill} variant. */ - AI_SKILL("ai-skill"); + AI_SKILL("ai-skill"), + /** The {@code plugin} variant. */ + PLUGIN("plugin"); private final String value; CatalogCandidateKind(String value) { this.value = value; } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCapability.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCapability.java index 8a94f40819..f85d0c0cb8 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCapability.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogCapability.java @@ -22,12 +22,18 @@ public enum CatalogCapability { LEGACY_MCP_SERVER_CARD("legacy-mcp-server-card"), /** The {@code ai-skill-discovery} variant. */ AI_SKILL_DISCOVERY("ai-skill-discovery"), + /** The {@code agent-plugin-discovery} variant. */ + AGENT_PLUGIN_DISCOVERY("agent-plugin-discovery"), /** The {@code mcp-install-planning} variant. */ MCP_INSTALL_PLANNING("mcp-install-planning"), /** The {@code multiple-transport-choice} variant. */ MULTIPLE_TRANSPORT_CHOICE("multiple-transport-choice"), + /** The {@code catalog-search-pagination} variant. */ + CATALOG_SEARCH_PAGINATION("catalog-search-pagination"), /** The {@code trust-snapshot} variant. */ - TRUST_SNAPSHOT("trust-snapshot"); + TRUST_SNAPSHOT("trust-snapshot"), + /** The {@code catalog-selection} variant. */ + CATALOG_SELECTION("catalog-selection"); private final String value; CatalogCapability(String value) { this.value = value; } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogHandleRejectionReason.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogHandleRejectionReason.java index 6db6b69365..51e6f1dc71 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogHandleRejectionReason.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogHandleRejectionReason.java @@ -23,7 +23,11 @@ public enum CatalogHandleRejectionReason { /** The {@code replayed} variant. */ REPLAYED("replayed"), /** The {@code foreign} variant. */ - FOREIGN("foreign"); + FOREIGN("foreign"), + /** The {@code wrong-kind} variant. */ + WRONG_KIND("wrong-kind"), + /** The {@code search-mismatch} variant. */ + SEARCH_MISMATCH("search-mismatch"); private final String value; CatalogHandleRejectionReason(String value) { this.value = value; } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogHandleType.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogHandleType.java index a14ceef85b..8af7250900 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogHandleType.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogHandleType.java @@ -19,7 +19,9 @@ public enum CatalogHandleType { /** The {@code candidate} variant. */ CANDIDATE("candidate"), /** The {@code plan} variant. */ - PLAN("plan"); + PLAN("plan"), + /** The {@code selection} variant. */ + SELECTION("selection"); private final String value; CatalogHandleType(String value) { this.value = value; } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogInvalidRequestError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogInvalidRequestError.java index 0f9eb7e769..7aa844b278 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogInvalidRequestError.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogInvalidRequestError.java @@ -13,7 +13,7 @@ import javax.annotation.processing.Generated; /** - * The request was rejected before any work was done, because a bounded field fell outside its permitted range or a required field was unusable. + * The request was rejected because a bounded field fell outside its permitted range or a required field was unusable. Pagination may also be rejected by the authority after a continuation request; repeat the search without page. * * @since 1.0.0 */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogInvalidRequestField.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogInvalidRequestField.java index b930640163..7252d66b28 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogInvalidRequestField.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogInvalidRequestField.java @@ -10,7 +10,7 @@ import javax.annotation.processing.Generated; /** - * Which request field was rejected before any work was done + * Which request field was rejected locally or by the catalog authority * * @since 1.0.0 */ @@ -29,7 +29,15 @@ public enum CatalogInvalidRequestField { /** The {@code card} variant. */ CARD("card"), /** The {@code scope} variant. */ - SCOPE("scope"); + SCOPE("scope"), + /** The {@code page} variant. */ + PAGE("page"), + /** The {@code sessionId} variant. */ + SESSIONID("sessionId"), + /** The {@code selectionRef} variant. */ + SELECTIONREF("selectionRef"), + /** The {@code outcome} variant. */ + OUTCOME("outcome"); private final String value; CatalogInvalidRequestField(String value) { this.value = value; } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogMediaType.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogMediaType.java index 1528b052ee..ddb2841fca 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogMediaType.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogMediaType.java @@ -21,7 +21,9 @@ public enum CatalogMediaType { /** The {@code application/mcp-server+json} variant. */ APPLICATION_MCP_SERVER_JSON("application/mcp-server+json"), /** The {@code application/ai-skill} variant. */ - APPLICATION_AI_SKILL("application/ai-skill"); + APPLICATION_AI_SKILL("application/ai-skill"), + /** The {@code application/vnd.github.copilot-plugin} variant. */ + APPLICATION_VND_GITHUB_COPILOT_PLUGIN("application/vnd.github.copilot-plugin"); private final String value; CatalogMediaType(String value) { this.value = value; } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogNegotiatedContract.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogNegotiatedContract.java index 379525fc28..e6d46dd108 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogNegotiatedContract.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogNegotiatedContract.java @@ -24,7 +24,7 @@ public record CatalogNegotiatedContract( /** Protocol version of the runtime that served the request. */ @JsonProperty("runtimeProtocolVersion") Long runtimeProtocolVersion, - /** Wire features the runtime understood for this operation. Always a superset of the caller's required features, because any shortfall is a refusal instead. Operation availability remains a separate typed result. */ + /** Wire features the runtime understood for this operation. Includes the five original catalog capabilities and only explicitly requested supported additions, in supported order without duplicates. Capabilities that introduce new success-union variants or operations are therefore included only when explicitly required, preserving older protocol-v3 clients. Always a superset of the caller's required features, because any shortfall is a refusal instead. Operation availability remains a separate typed result. */ @JsonProperty("grantedCapabilities") List grantedCapabilities ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogPluginRepositorySource.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogPluginRepositorySource.java new file mode 100644 index 0000000000..1901e05a4b --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogPluginRepositorySource.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Syntactically validated GitHub repository provenance declared by catalog metadata. This is a source claim rather than proof that the descriptor URL resolves to the repository. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CatalogPluginRepositorySource( + /** Canonical lowercase owner/repository name derived from metadata.sourceSet. */ + @JsonProperty("repository") String repository, + /** Case-preserving safe relative POSIX path derived from metadata.repoPath. */ + @JsonProperty("path") String path +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchPage.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchPage.java new file mode 100644 index 0000000000..da5a2f13fa --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchPage.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * An explicit numbered-page request. The SDK treats the token as opaque; only the runtime decodes it and changes its targetPage. Authority validation binds navigation to the original search. No snapshot stability or token TTL is promised. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CatalogSearchPage( + /** Opaque authority-issued pagination token from an earlier response. Never decode, modify or log it in an SDK consumer. */ + @JsonProperty("token") String token, + /** Requested one-based page. Must not exceed either the token's signed pageCount or the navigation window ceil(1000 / pageSize). Repeat the search without page to discover newly available pages beyond that signed pageCount. */ + @JsonProperty("number") Long number +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchPagination.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchPagination.java new file mode 100644 index 0000000000..445ed51373 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchPagination.java @@ -0,0 +1,41 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Authority-reported navigation metadata, returned only to callers requiring catalog-search-pagination and only when a supported token is present. Tokenless first-page and continuation responses omit this object; no counts are inferred from candidates. The opaque token may be retained for previous or numbered navigation even when hasNextPage is false. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CatalogSearchPagination( + /** Opaque authority-issued pagination token. Only the runtime decodes it or changes targetPage; SDK consumers must not decode, modify or log it. It has no runtime-created expiry or cache. */ + @JsonProperty("token") String token, + /** One-based page returned by the authority. */ + @JsonProperty("currentPage") Long currentPage, + /** Page size bound to the search, equal to the effective request limit. */ + @JsonProperty("pageSize") Long pageSize, + /** Backend-reported count for this response, not the number of returned candidates. Its relationship to the full query result set is unknown. */ + @JsonProperty("totalCount") Long totalCount, + /** The relationship of totalCount to the complete query result set is unknown; neither exactness nor a lower-bound guarantee is implied. */ + @JsonProperty("totalCountRelation") CatalogSearchTotalCountRelation totalCountRelation, + /** Backend-reported page count, which may exceed maxPage. Present pagination metadata always describes a multi-page result; zero- and single-page responses omit pagination. Navigation targets must also be within the signed pageCount carried by the supplied token. */ + @JsonProperty("pageCount") Long pageCount, + /** Navigation window ceiling ceil(1000 / pageSize), not the number of existing pages. Legal targets must not exceed this ceiling or the token's signed pageCount. */ + @JsonProperty("maxPage") Long maxPage, + /** Whether the authority token advertises a valid next target within the navigation window. Not inferred from token presence, truncated, or currentPage being less than pageCount. */ + @JsonProperty("hasNextPage") Boolean hasNextPage +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchParams.java index 68b90a19c9..62b221355a 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchParams.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchParams.java @@ -31,7 +31,9 @@ public record CatalogSearchParams( @JsonProperty("query") String query, /** Maximum number of candidates to return. Defaults to 10 when omitted. */ @JsonProperty("limit") Long limit, - /** Restrict results to these candidate kinds. When omitted, every kind the runtime supports is searched. */ - @JsonProperty("kinds") List kinds + /** Restrict results to these candidate kinds. Agent Plugins are opt-in and require the `agent-plugin-discovery` capability so protocol-v3 clients generated before that variant cannot receive an unknown result; when omitted, the backwards-compatible MCP server and AI skill kinds are searched. */ + @JsonProperty("kinds") List kinds, + /** Numbered navigation using metadata from an earlier response. Requires catalog-search-pagination and the same query, kinds and effective limit. Omit for a fresh first-page search. */ + @JsonProperty("page") CatalogSearchPage page ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchSucceeded.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchSucceeded.java index b49f78faff..95cd175795 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchSucceeded.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchSucceeded.java @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * A completed catalog search: inert candidate summaries, each carrying a single-use handle. + * A completed catalog search containing inert candidate summaries. MCP server and AI skill variants carry a single-use handle; the Agent Plugin variant is handleless. * * @since 1.0.0 */ @@ -37,7 +37,7 @@ public final class CatalogSearchSucceeded extends CatalogSearchResult { @JsonProperty("candidates") private List candidates; - /** Whether further matches existed beyond the requested limit. */ + /** Legacy indication that the authority returned a page token. Preserved for compatibility; this is not a has-next-page indicator. Use pagination.hasNextPage when pagination metadata is present. */ @JsonProperty("truncated") private Boolean truncated; @@ -45,6 +45,10 @@ public final class CatalogSearchSucceeded extends CatalogSearchResult { @JsonProperty("negotiated") private CatalogNegotiatedContract negotiated; + /** Navigation metadata for callers explicitly requiring catalog-search-pagination. Omitted when the authority returns no token, including tokenless first-page and continuation responses. Counts are never substituted from candidates.length. */ + @JsonProperty("pagination") + private CatalogSearchPagination pagination; + public String getSearchId() { return searchId; } public void setSearchId(String searchId) { this.searchId = searchId; } @@ -56,4 +60,7 @@ public final class CatalogSearchSucceeded extends CatalogSearchResult { public CatalogNegotiatedContract getNegotiated() { return negotiated; } public void setNegotiated(CatalogNegotiatedContract negotiated) { this.negotiated = negotiated; } + + public CatalogSearchPagination getPagination() { return pagination; } + public void setPagination(CatalogSearchPagination pagination) { this.pagination = pagination; } } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchTotalCountRelation.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchTotalCountRelation.java new file mode 100644 index 0000000000..5f532ca896 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSearchTotalCountRelation.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Relationship of the backend-reported count to the complete query result set. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum CatalogSearchTotalCountRelation { + /** The {@code unknown} variant. */ + UNKNOWN("unknown"); + + private final String value; + CatalogSearchTotalCountRelation(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static CatalogSearchTotalCountRelation fromValue(String value) { + for (CatalogSearchTotalCountRelation v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown CatalogSearchTotalCountRelation value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectParams.java new file mode 100644 index 0000000000..cb53649333 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectParams.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record CatalogSelectParams( + /** Protocol version and capabilities the caller requires. */ + @JsonProperty("contract") CatalogClientContract contract, + /** Locally owned root session whose retained search state is being resolved. */ + @JsonProperty("sessionId") String sessionId, + /** Opaque runtime-instance scoped reference to one visible candidate. For a non-selected outcome, any candidate reference from the same search closes that search's retained group. */ + @JsonProperty("selectionRef") String selectionRef, + /** The terminal outcome declared by the caller. Timed-out means the host's live interaction deadline elapsed; a reference whose runtime TTL elapsed is rejected separately as stale. */ + @JsonProperty("outcome") CatalogSelectionDecision outcome +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionCancelled.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionCancelled.java new file mode 100644 index 0000000000..9c34236839 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionCancelled.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The caller cancelled the selection interaction and the retained search state was released. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionCancelled extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "cancelled"; + + @Override + public String getKind() { return kind; } + + /** The search identifier privately bound to the released selection group. */ + @JsonProperty("searchId") + private String searchId; + + public String getSearchId() { return searchId; } + public void setSearchId(String searchId) { this.searchId = searchId; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionDecision.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionDecision.java new file mode 100644 index 0000000000..83bc7d598f --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionDecision.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Terminal outcome declared for a retained catalog selection group + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum CatalogSelectionDecision { + /** The {@code selected} variant. */ + SELECTED("selected"), + /** The {@code declined} variant. */ + DECLINED("declined"), + /** The {@code cancelled} variant. */ + CANCELLED("cancelled"), + /** The {@code timed-out} variant. */ + TIMED_OUT("timed-out"); + + private final String value; + CatalogSelectionDecision(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static CatalogSelectionDecision fromValue(String value) { + for (CatalogSelectionDecision v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown CatalogSelectionDecision value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionDeclined.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionDeclined.java new file mode 100644 index 0000000000..627565b6a1 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionDeclined.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The caller explicitly declined every candidate and the retained search state was released. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionDeclined extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "declined"; + + @Override + public String getKind() { return kind; } + + /** The search identifier privately bound to the released selection group. */ + @JsonProperty("searchId") + private String searchId; + + public String getSearchId() { return searchId; } + public void setSearchId(String searchId) { this.searchId = searchId; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionForeign.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionForeign.java new file mode 100644 index 0000000000..182f80e939 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionForeign.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The selection reference belongs to another runtime instance or session. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionForeign extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "foreign"; + + @Override + public String getKind() { return kind; } + + /** Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. */ + @JsonProperty("message") + private String message; + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionInvalid.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionInvalid.java new file mode 100644 index 0000000000..19d89df4af --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionInvalid.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The selection reference was malformed or unknown. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionInvalid extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "invalid"; + + @Override + public String getKind() { return kind; } + + /** Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. */ + @JsonProperty("message") + private String message; + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionReplayed.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionReplayed.java new file mode 100644 index 0000000000..fff5a4e04c --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionReplayed.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The selection group was already terminated or its pending host hand-off was already claimed. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionReplayed extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "replayed"; + + @Override + public String getKind() { return kind; } + + /** Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. */ + @JsonProperty("message") + private String message; + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResult.java new file mode 100644 index 0000000000..76c66edbbd --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResult.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonSubTypes; +import com.fasterxml.jackson.annotation.JsonTypeInfo; +import javax.annotation.processing.Generated; + +/** + * Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId. + * + * @since 1.0.0 + */ +@JsonTypeInfo(use = JsonTypeInfo.Id.NAME, property = "kind", visible = true) +@JsonSubTypes({ + @JsonSubTypes.Type(value = CatalogSelectionSelected.class, name = "selected"), + @JsonSubTypes.Type(value = CatalogSelectionDeclined.class, name = "declined"), + @JsonSubTypes.Type(value = CatalogSelectionCancelled.class, name = "cancelled"), + @JsonSubTypes.Type(value = CatalogSelectionTimedOut.class, name = "timed-out"), + @JsonSubTypes.Type(value = CatalogSelectionInvalid.class, name = "invalid"), + @JsonSubTypes.Type(value = CatalogSelectionStale.class, name = "stale"), + @JsonSubTypes.Type(value = CatalogSelectionReplayed.class, name = "replayed"), + @JsonSubTypes.Type(value = CatalogSelectionForeign.class, name = "foreign"), + @JsonSubTypes.Type(value = CatalogSelectionWrongKind.class, name = "wrong-kind"), + @JsonSubTypes.Type(value = CatalogSelectionResultCatalogNegotiationRefusedError.class, name = "negotiation-refused"), + @JsonSubTypes.Type(value = CatalogSelectionResultCatalogInvalidRequestError.class, name = "invalid-request"), + @JsonSubTypes.Type(value = CatalogSelectionResultCatalogUnavailableError.class, name = "unavailable") +}) +@JsonIgnoreProperties(ignoreUnknown = true) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public abstract class CatalogSelectionResult { + + /** + * Returns the discriminator value for this variant. + * + * @return the kind discriminator + */ + public abstract String getKind(); +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogInvalidRequestError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogInvalidRequestError.java new file mode 100644 index 0000000000..8a22302ac0 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogInvalidRequestError.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The request was rejected because a bounded field fell outside its permitted range or a required field was unusable. Pagination may also be rejected by the authority after a continuation request; repeat the search without page. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionResultCatalogInvalidRequestError extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "invalid-request"; + + @Override + public String getKind() { return kind; } + + /** Which request field was rejected. */ + @JsonProperty("field") + private CatalogInvalidRequestField field; + + /** Human-readable explanation, safe to surface. Never echoes the offending value, nor a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogInvalidRequestField getField() { return field; } + public void setField(CatalogInvalidRequestField field) { this.field = field; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogNegotiationRefusedError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogNegotiationRefusedError.java new file mode 100644 index 0000000000..3fbe4302bb --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogNegotiationRefusedError.java @@ -0,0 +1,73 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * The caller's protocol version or required capabilities cannot be honoured. Returned instead of a partial or ambiguous success. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionResultCatalogNegotiationRefusedError extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "negotiation-refused"; + + @Override + public String getKind() { return kind; } + + /** Whether the version or the capability set was the problem. */ + @JsonProperty("reason") + private CatalogNegotiationRefusedReason reason; + + /** Protocol version of the runtime that refused the request. */ + @JsonProperty("runtimeProtocolVersion") + private Long runtimeProtocolVersion; + + /** Lowest caller protocol version this runtime will serve. */ + @JsonProperty("minimumSupportedProtocolVersion") + private Long minimumSupportedProtocolVersion; + + /** Capabilities this runtime can safely advertise to this caller. The complete five-capability protocol-3 legacy set is always present; every capability added after that baseline appears only when the caller required it, so an older closed-enum decoder can still consume a refusal. This list does not imply that every deployment has enabled every operation. */ + @JsonProperty("supportedCapabilities") + private List supportedCapabilities; + + /** The subset of the caller's bounded extensible capability identifiers this runtime cannot honour. */ + @JsonProperty("unsupportedCapabilities") + private List unsupportedCapabilities; + + /** Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogNegotiationRefusedReason getReason() { return reason; } + public void setReason(CatalogNegotiationRefusedReason reason) { this.reason = reason; } + + public Long getRuntimeProtocolVersion() { return runtimeProtocolVersion; } + public void setRuntimeProtocolVersion(Long runtimeProtocolVersion) { this.runtimeProtocolVersion = runtimeProtocolVersion; } + + public Long getMinimumSupportedProtocolVersion() { return minimumSupportedProtocolVersion; } + public void setMinimumSupportedProtocolVersion(Long minimumSupportedProtocolVersion) { this.minimumSupportedProtocolVersion = minimumSupportedProtocolVersion; } + + public List getSupportedCapabilities() { return supportedCapabilities; } + public void setSupportedCapabilities(List supportedCapabilities) { this.supportedCapabilities = supportedCapabilities; } + + public List getUnsupportedCapabilities() { return unsupportedCapabilities; } + public void setUnsupportedCapabilities(List unsupportedCapabilities) { this.unsupportedCapabilities = unsupportedCapabilities; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogUnavailableError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogUnavailableError.java new file mode 100644 index 0000000000..7ef4ff695d --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionResultCatalogUnavailableError.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The operation is not available on this runtime. Distinct from a network failure: nothing was attempted. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionResultCatalogUnavailableError extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "unavailable"; + + @Override + public String getKind() { return kind; } + + /** Why the operation is unavailable. */ + @JsonProperty("reason") + private CatalogUnavailableReason reason; + + /** Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogUnavailableReason getReason() { return reason; } + public void setReason(CatalogUnavailableReason reason) { this.reason = reason; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionSelected.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionSelected.java new file mode 100644 index 0000000000..73d11908a4 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionSelected.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The chosen candidate was transferred into a fresh bounded single-use handle for a later explicit planning request. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionSelected extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "selected"; + + @Override + public String getKind() { return kind; } + + /** Fresh single-use candidate handle accepted by mcp.planInstall. Returned only to the native host and never included in model-tool output. */ + @JsonProperty("candidateHandle") + private String candidateHandle; + + /** The exact search identifier privately bound to the selected candidate. */ + @JsonProperty("searchId") + private String searchId; + + public String getCandidateHandle() { return candidateHandle; } + public void setCandidateHandle(String candidateHandle) { this.candidateHandle = candidateHandle; } + + public String getSearchId() { return searchId; } + public void setSearchId(String searchId) { this.searchId = searchId; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionStale.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionStale.java new file mode 100644 index 0000000000..fc331a22d5 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionStale.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The runtime-enforced selection reference lifetime elapsed before the request arrived. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionStale extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "stale"; + + @Override + public String getKind() { return kind; } + + /** Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. */ + @JsonProperty("message") + private String message; + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionTimedOut.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionTimedOut.java new file mode 100644 index 0000000000..aaca641ad6 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionTimedOut.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The host declared that its live selection interaction timed out, and the retained search state was released. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionTimedOut extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "timed-out"; + + @Override + public String getKind() { return kind; } + + /** The search identifier privately bound to the released selection group. */ + @JsonProperty("searchId") + private String searchId; + + public String getSearchId() { return searchId; } + public void setSearchId(String searchId) { this.searchId = searchId; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionWrongKind.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionWrongKind.java new file mode 100644 index 0000000000..6e2a0466b8 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogSelectionWrongKind.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The presented opaque handle was issued for another catalog operation. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class CatalogSelectionWrongKind extends CatalogSelectionResult { + + @JsonProperty("kind") + private final String kind = "wrong-kind"; + + @Override + public String getKind() { return kind; } + + /** Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. */ + @JsonProperty("message") + private String message; + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogUnavailableReason.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogUnavailableReason.java index c7bf4dcd76..e3bf1f5a6e 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogUnavailableReason.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CatalogUnavailableReason.java @@ -20,6 +20,8 @@ public enum CatalogUnavailableReason { SEARCH_UNAVAILABLE("search-unavailable"), /** The {@code planning-unavailable} variant. */ PLANNING_UNAVAILABLE("planning-unavailable"), + /** The {@code selection-unavailable} variant. */ + SELECTION_UNAVAILABLE("selection-unavailable"), /** The {@code authority-not-configured} variant. */ AUTHORITY_NOT_CONFIGURED("authority-not-configured"), /** The {@code disabled-by-policy} variant. */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CopilotUserResponse.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CopilotUserResponse.java index ad501eac0d..2579364550 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CopilotUserResponse.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/CopilotUserResponse.java @@ -74,6 +74,16 @@ public record CopilotUserResponse( /** Whether cloud session storage is enabled for the user. */ @JsonProperty("cloud_session_storage_enabled") Boolean cloudSessionStorageEnabled, /** Whether CLI remote control is enabled for the user. */ - @JsonProperty("cli_remote_control_enabled") Boolean cliRemoteControlEnabled + @JsonProperty("cli_remote_control_enabled") Boolean cliRemoteControlEnabled, + /** Enterprises that provide the user's Copilot license, each with a stable numeric ID. */ + @JsonProperty("enterprise_list") List enterpriseList ) { + + @JsonIgnoreProperties(ignoreUnknown = true) + @JsonInclude(JsonInclude.Include.NON_NULL) + public record CopilotUserResponseEnterpriseListItem( + /** Numeric database ID of the enterprise. */ + @JsonProperty("id") Long id + ) { + } } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/IndexedSearchState.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/IndexedSearchState.java new file mode 100644 index 0000000000..9d5c3cb976 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/IndexedSearchState.java @@ -0,0 +1,41 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Live indexed-search state for this session activation, never inferred from persisted history. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum IndexedSearchState { + /** The {@code disabled} variant. */ + DISABLED("disabled"), + /** The {@code starting} variant. */ + STARTING("starting"), + /** The {@code enabled} variant. */ + ENABLED("enabled"), + /** The {@code ready} variant. */ + READY("ready"), + /** The {@code failed} variant. */ + FAILED("failed"); + + private final String value; + IndexedSearchState(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static IndexedSearchState fromValue(String value) { + for (IndexedSearchState v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown IndexedSearchState value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/InstalledPluginInfo.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/InstalledPluginInfo.java index 5b42a40450..ea9e1ac450 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/InstalledPluginInfo.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/InstalledPluginInfo.java @@ -34,6 +34,12 @@ public record InstalledPluginInfo( /** Absolute path of the marketplace directory a live plugin was resolved from. Present only on live, never-persisted records — a plugin belonging to a directory/local marketplace, which is loaded from its real directory on every pass instead of a copy under the installed-plugins cache. Its presence is what marks a listed plugin as live: such a plugin is always present on disk, so `enabled` is its only meaningful state and it is never "not installed". */ @JsonProperty("installedFrom") String installedFrom, /** Runtime-reported plugin provenance. Currently set to "builtin" only for plugins registered through the trusted host built-in boundary; absent for installed, marketplace, direct, and live plugins. */ - @JsonProperty("source") String source + @JsonProperty("source") String source, + /** Whether enterprise managed settings control this plugin's enabled state. */ + @JsonProperty("managed") Boolean managed, + /** The enabled state required by enterprise managed settings, when this plugin spec is managed. */ + @JsonProperty("managedDesiredEnabled") Boolean managedDesiredEnabled, + /** Whether the managed desired plugin currently has an installed or live record. Set to false for a managed desired entry retained in the listing after installation or reconciliation failed. */ + @JsonProperty("installed") Boolean installed ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ManagedSettingsResolvedSource.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ManagedSettingsResolvedSource.java new file mode 100644 index 0000000000..64b0925466 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ManagedSettingsResolvedSource.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Summary of which managed-settings channels contributed to the effective session policy. Use the per-channel booleans for exact provenance. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum ManagedSettingsResolvedSource { + /** The {@code server} variant. */ + SERVER("server"), + /** The {@code device} variant. */ + DEVICE("device"), + /** The {@code client} variant. */ + CLIENT("client"), + /** The {@code policyHelper} variant. */ + POLICYHELPER("policyHelper"), + /** The {@code mixed} variant. */ + MIXED("mixed"), + /** The {@code none} variant. */ + NONE("none"); + + private final String value; + ManagedSettingsResolvedSource(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static ManagedSettingsResolvedSource fromValue(String value) { + for (ManagedSettingsResolvedSource v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown ManagedSettingsResolvedSource value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/MarketplaceInfo.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/MarketplaceInfo.java index 5c7b8b8655..dd5d855ec3 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/MarketplaceInfo.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/MarketplaceInfo.java @@ -26,6 +26,10 @@ public record MarketplaceInfo( /** Human-readable description of where the marketplace data is fetched from (e.g. "GitHub: owner/repo"). */ @JsonProperty("source") String source, /** True when this is a default marketplace shipped with the runtime. Defaults are not removable. */ - @JsonProperty("isDefault") Boolean isDefault + @JsonProperty("isDefault") Boolean isDefault, + /** Whether enterprise managed settings provide and control this marketplace entry. */ + @JsonProperty("managed") Boolean managed, + /** Whether the managed marketplace currently resolved into the runtime marketplace registry. Set to false when the desired managed entry is retained for governance visibility after loading or reconciliation failed. */ + @JsonProperty("available") Boolean available ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpInstallPlan.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpInstallPlan.java index 7274ce2b7f..b9e1bf0d42 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpInstallPlan.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpInstallPlan.java @@ -38,11 +38,11 @@ public record McpInstallPlan( @JsonProperty("target") McpPlanTarget target, /** Outcome of evaluating the server against registry and enterprise policy. */ @JsonProperty("policy") McpPlanPolicyResult policy, - /** The configuration changes installing would make, described rather than serialised, so the mutable configuration payload stays behind the runtime boundary. */ + /** Alternative configuration changes, with exactly one entry for each transportChoices entry in the same order. Only the entry for the subsequently selected transport applies; these are not cumulative writes. Payloads remain behind the runtime boundary. */ @JsonProperty("configurationChanges") List configurationChanges, /** Whether applying this plan would require an MCP reload to take effect. Planning itself never reloads. */ @JsonProperty("reloadRequired") Boolean reloadRequired, - /** Whether the plan cannot be applied without further input, because a required value has no default or a secret must be supplied. */ + /** True only when every eligible transport choice needs additional values or secrets. False means at least one choice needs no additional configuration, not that every choice is ready. A later apply operation must validate the selected choice's own inputs, secrets and policy after explicit confirmation. */ @JsonProperty("requiresInteractiveConfiguration") Boolean requiresInteractiveConfiguration ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanConfigurationChange.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanConfigurationChange.java index d419772111..ff40c70eba 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanConfigurationChange.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanConfigurationChange.java @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * One change applying the plan would make, described rather than serialised so the configuration payload stays behind the runtime boundary. + * The configuration-change alternative for the transportChoices entry at the same index. Only the selected alternative is applied; entries are not cumulative. The payload stays behind the runtime boundary. * * @since 1.0.0 */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResult.java index d257703477..0d3cda55a0 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResult.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResult.java @@ -20,18 +20,18 @@ @JsonTypeInfo(use = JsonTypeInfo.Id.NAME, property = "kind", visible = true) @JsonSubTypes({ @JsonSubTypes.Type(value = McpPlanInstallPlanned.class, name = "planned"), - @JsonSubTypes.Type(value = CatalogNegotiationRefusedError.class, name = "negotiation-refused"), + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogNegotiationRefusedError.class, name = "negotiation-refused"), @JsonSubTypes.Type(value = CatalogHandleRejectedError.class, name = "handle-rejected"), - @JsonSubTypes.Type(value = CatalogInvalidRequestError.class, name = "invalid-request"), - @JsonSubTypes.Type(value = CatalogAuthenticationRequiredError.class, name = "authentication-required"), - @JsonSubTypes.Type(value = CatalogPolicyRejectedError.class, name = "policy-rejected"), - @JsonSubTypes.Type(value = CatalogNetworkFailureError.class, name = "network-failure"), - @JsonSubTypes.Type(value = CatalogUnsafeRetrievalError.class, name = "unsafe-retrieval"), - @JsonSubTypes.Type(value = CatalogMalformedCardError.class, name = "malformed-card"), - @JsonSubTypes.Type(value = CatalogContractViolationError.class, name = "contract-violation"), + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogInvalidRequestError.class, name = "invalid-request"), + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogAuthenticationRequiredError.class, name = "authentication-required"), + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogPolicyRejectedError.class, name = "policy-rejected"), + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogNetworkFailureError.class, name = "network-failure"), + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogUnsafeRetrievalError.class, name = "unsafe-retrieval"), + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogMalformedCardError.class, name = "malformed-card"), + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogContractViolationError.class, name = "contract-violation"), @JsonSubTypes.Type(value = CatalogUnavailableTransportError.class, name = "unavailable-transport"), @JsonSubTypes.Type(value = CatalogNotInstallableError.class, name = "not-installable"), - @JsonSubTypes.Type(value = CatalogUnavailableError.class, name = "unavailable") + @JsonSubTypes.Type(value = McpPlanInstallResultCatalogUnavailableError.class, name = "unavailable") }) @JsonIgnoreProperties(ignoreUnknown = true) @javax.annotation.processing.Generated("copilot-sdk-codegen") diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogAuthenticationRequiredError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogAuthenticationRequiredError.java new file mode 100644 index 0000000000..d252d25b99 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogAuthenticationRequiredError.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * An optional catalog authentication exchange did not establish the caller's identity. Anonymous search remains supported; this refusal is reserved for an operation that cannot continue after the attempted exchange. It is distinct from `policy-rejected` and from a network failure, and the reason identifies the recovery action. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogAuthenticationRequiredError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "authentication-required"; + + @Override + public String getKind() { return kind; } + + /** Why authentication failed. Only an expired credential justifies attempting a silent refresh; an absent or rejected credential requires sign-in. */ + @JsonProperty("reason") + private CatalogAuthenticationRequiredReason reason; + + /** Human-readable explanation, safe to surface. Never contains a credential or token, nor a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogAuthenticationRequiredReason getReason() { return reason; } + public void setReason(CatalogAuthenticationRequiredReason reason) { this.reason = reason; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogContractViolationError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogContractViolationError.java new file mode 100644 index 0000000000..a07890d19a --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogContractViolationError.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * An upstream catalog response broke the wire contract. Most importantly, every result must carry exactly one of a URL or embedded data: a result carrying both, or neither, is refused here rather than being guessed at. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogContractViolationError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "contract-violation"; + + @Override + public String getKind() { return kind; } + + /** Which rule the response broke. */ + @JsonProperty("reason") + private CatalogContractViolationReason reason; + + /** Human-readable explanation, safe to surface. Never echoes response content, nor a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogContractViolationReason getReason() { return reason; } + public void setReason(CatalogContractViolationReason reason) { this.reason = reason; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogInvalidRequestError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogInvalidRequestError.java new file mode 100644 index 0000000000..364fc1e5a4 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogInvalidRequestError.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The request was rejected because a bounded field fell outside its permitted range or a required field was unusable. Pagination may also be rejected by the authority after a continuation request; repeat the search without page. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogInvalidRequestError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "invalid-request"; + + @Override + public String getKind() { return kind; } + + /** Which request field was rejected. */ + @JsonProperty("field") + private CatalogInvalidRequestField field; + + /** Human-readable explanation, safe to surface. Never echoes the offending value, nor a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogInvalidRequestField getField() { return field; } + public void setField(CatalogInvalidRequestField field) { this.field = field; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogMalformedCardError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogMalformedCardError.java new file mode 100644 index 0000000000..faf3ab8f8b --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogMalformedCardError.java @@ -0,0 +1,51 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * A card could not be parsed or did not satisfy its declared media type's schema. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogMalformedCardError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "malformed-card"; + + @Override + public String getKind() { return kind; } + + /** How the card failed validation. */ + @JsonProperty("reason") + private CatalogMalformedCardReason reason; + + /** Media type the card was interpreted as, when it declared one this runtime recognises. */ + @JsonProperty("mediaType") + private CatalogMediaType mediaType; + + /** Human-readable explanation, safe to surface. Never echoes card content, nor a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogMalformedCardReason getReason() { return reason; } + public void setReason(CatalogMalformedCardReason reason) { this.reason = reason; } + + public CatalogMediaType getMediaType() { return mediaType; } + public void setMediaType(CatalogMediaType mediaType) { this.mediaType = mediaType; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogNegotiationRefusedError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogNegotiationRefusedError.java new file mode 100644 index 0000000000..bda5d35213 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogNegotiationRefusedError.java @@ -0,0 +1,73 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * The caller's protocol version or required capabilities cannot be honoured. Returned instead of a partial or ambiguous success. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogNegotiationRefusedError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "negotiation-refused"; + + @Override + public String getKind() { return kind; } + + /** Whether the version or the capability set was the problem. */ + @JsonProperty("reason") + private CatalogNegotiationRefusedReason reason; + + /** Protocol version of the runtime that refused the request. */ + @JsonProperty("runtimeProtocolVersion") + private Long runtimeProtocolVersion; + + /** Lowest caller protocol version this runtime will serve. */ + @JsonProperty("minimumSupportedProtocolVersion") + private Long minimumSupportedProtocolVersion; + + /** Capabilities this runtime can safely advertise to this caller. The complete five-capability protocol-3 legacy set is always present; every capability added after that baseline appears only when the caller required it, so an older closed-enum decoder can still consume a refusal. This list does not imply that every deployment has enabled every operation. */ + @JsonProperty("supportedCapabilities") + private List supportedCapabilities; + + /** The subset of the caller's bounded extensible capability identifiers this runtime cannot honour. */ + @JsonProperty("unsupportedCapabilities") + private List unsupportedCapabilities; + + /** Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogNegotiationRefusedReason getReason() { return reason; } + public void setReason(CatalogNegotiationRefusedReason reason) { this.reason = reason; } + + public Long getRuntimeProtocolVersion() { return runtimeProtocolVersion; } + public void setRuntimeProtocolVersion(Long runtimeProtocolVersion) { this.runtimeProtocolVersion = runtimeProtocolVersion; } + + public Long getMinimumSupportedProtocolVersion() { return minimumSupportedProtocolVersion; } + public void setMinimumSupportedProtocolVersion(Long minimumSupportedProtocolVersion) { this.minimumSupportedProtocolVersion = minimumSupportedProtocolVersion; } + + public List getSupportedCapabilities() { return supportedCapabilities; } + public void setSupportedCapabilities(List supportedCapabilities) { this.supportedCapabilities = supportedCapabilities; } + + public List getUnsupportedCapabilities() { return unsupportedCapabilities; } + public void setUnsupportedCapabilities(List unsupportedCapabilities) { this.unsupportedCapabilities = unsupportedCapabilities; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogNetworkFailureError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogNetworkFailureError.java new file mode 100644 index 0000000000..1b9e82d3cb --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogNetworkFailureError.java @@ -0,0 +1,58 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The runtime could not reach the catalog authority or retrieve a card. Covers being offline as well as transport-level failure. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogNetworkFailureError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "network-failure"; + + @Override + public String getKind() { return kind; } + + /** Categorised failure, low cardinality so it can be aggregated without carrying a URL. */ + @JsonProperty("reason") + private CatalogNetworkFailureReason reason; + + /** HTTP status code, when the failure was a rejected response. */ + @JsonProperty("statusCode") + private Long statusCode; + + /** Bounded cooldown in seconds before another catalog request should be attempted, when the authority supplied a numeric Retry-After value or the runtime applied its documented fallback. */ + @JsonProperty("retryAfterSeconds") + private Long retryAfterSeconds; + + /** Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogNetworkFailureReason getReason() { return reason; } + public void setReason(CatalogNetworkFailureReason reason) { this.reason = reason; } + + public Long getStatusCode() { return statusCode; } + public void setStatusCode(Long statusCode) { this.statusCode = statusCode; } + + public Long getRetryAfterSeconds() { return retryAfterSeconds; } + public void setRetryAfterSeconds(Long retryAfterSeconds) { this.retryAfterSeconds = retryAfterSeconds; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogPolicyRejectedError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogPolicyRejectedError.java new file mode 100644 index 0000000000..f979920b96 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogPolicyRejectedError.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Registry or enterprise policy refused the operation. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogPolicyRejectedError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "policy-rejected"; + + @Override + public String getKind() { return kind; } + + /** Which authority produced the decision. */ + @JsonProperty("source") + private McpPlanPolicySource source; + + /** Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public McpPlanPolicySource getSource() { return source; } + public void setSource(McpPlanPolicySource source) { this.source = source; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogUnavailableError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogUnavailableError.java new file mode 100644 index 0000000000..018ab98b68 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogUnavailableError.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * The operation is not available on this runtime. Distinct from a network failure: nothing was attempted. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogUnavailableError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "unavailable"; + + @Override + public String getKind() { return kind; } + + /** Why the operation is unavailable. */ + @JsonProperty("reason") + private CatalogUnavailableReason reason; + + /** Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogUnavailableReason getReason() { return reason; } + public void setReason(CatalogUnavailableReason reason) { this.reason = reason; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogUnsafeRetrievalError.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogUnsafeRetrievalError.java new file mode 100644 index 0000000000..09f2fdb0dc --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/McpPlanInstallResultCatalogUnsafeRetrievalError.java @@ -0,0 +1,44 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Retrieval was refused by the runtime's hardened fetch boundary before any request left the process, or before a redirect was followed. + * + * @since 1.0.0 + */ +@JsonIgnoreProperties(ignoreUnknown = true) +@JsonInclude(JsonInclude.Include.NON_NULL) +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class McpPlanInstallResultCatalogUnsafeRetrievalError extends McpPlanInstallResult { + + @JsonProperty("kind") + private final String kind = "unsafe-retrieval"; + + @Override + public String getKind() { return kind; } + + /** Which control refused the retrieval, low cardinality so it can be aggregated without carrying a URL. */ + @JsonProperty("reason") + private CatalogUnsafeRetrievalReason reason; + + /** Human-readable explanation, safe to surface. Never contains the refused URL, nor a query, handle, or secret. */ + @JsonProperty("message") + private String message; + + public CatalogUnsafeRetrievalReason getReason() { return reason; } + public void setReason(CatalogUnsafeRetrievalReason reason) { this.reason = reason; } + + public String getMessage() { return message; } + public void setMessage(String message) { this.message = message; } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ModelChangeSource.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ModelChangeSource.java index 6e5d4ea8da..6f0687414c 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ModelChangeSource.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ModelChangeSource.java @@ -36,6 +36,8 @@ public enum ModelChangeSource { PLAN_MODE("plan_mode"), /** The {@code automatic} variant. */ AUTOMATIC("automatic"), + /** The {@code changeboarding_shortcut} variant. */ + CHANGEBOARDING_SHORTCUT("changeboarding_shortcut"), /** The {@code sdk} variant. */ SDK("sdk"); diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PendingPermissionRequest.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PendingPermissionRequest.java index 7042864b01..eea95994a7 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PendingPermissionRequest.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PendingPermissionRequest.java @@ -24,6 +24,8 @@ public record PendingPermissionRequest( /** Unique identifier for the pending permission request */ @JsonProperty("requestId") String requestId, /** The user-facing permission prompt details (commands, write, read, mcp, url, memory, custom-tool, path, hook) */ - @JsonProperty("request") Object request + @JsonProperty("request") Object request, + /** Permission-recovery episode that authorized this request to surface for interactive attention */ + @JsonProperty("recoveryEpisodeId") String recoveryEpisodeId ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttempt.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttempt.java new file mode 100644 index 0000000000..0792cd6178 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttempt.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionRecoveryAttempt( + /** Unique identifier for this attempt record */ + @JsonProperty("attemptId") String attemptId, + /** Tool-call identifier associated with this attempt, when available */ + @JsonProperty("toolCallId") String toolCallId, + /** Controlled permission request kind, such as shell, path, URL, or tool */ + @JsonProperty("permissionKind") String permissionKind, + /** SHA-256 fingerprint of normalized request data; raw permission arguments are not included */ + @JsonProperty("requestFingerprint") String requestFingerprint, + /** Relationship between this attempt and earlier attempts in the episode */ + @JsonProperty("relation") PermissionRecoveryAttemptRelation relation, + /** How the runtime handled this attempt */ + @JsonProperty("disposition") PermissionRecoveryAttemptDisposition disposition, + /** Controlled reason for the attempt disposition */ + @JsonProperty("reason") PermissionRecoveryAttemptReason reason, + /** One-based position of this attempt in the episode */ + @JsonProperty("ordinal") Long ordinal +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptDisposition.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptDisposition.java new file mode 100644 index 0000000000..9f6d56e7be --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptDisposition.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Runtime handling applied to a recovery attempt + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryAttemptDisposition { + /** The {@code deferred} variant. */ + DEFERRED("deferred"), + /** The {@code prompted} variant. */ + PROMPTED("prompted"), + /** The {@code approved} variant. */ + APPROVED("approved"), + /** The {@code denied} variant. */ + DENIED("denied"), + /** The {@code blocked} variant. */ + BLOCKED("blocked"), + /** The {@code succeeded} variant. */ + SUCCEEDED("succeeded"); + + private final String value; + PermissionRecoveryAttemptDisposition(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryAttemptDisposition fromValue(String value) { + for (PermissionRecoveryAttemptDisposition v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryAttemptDisposition value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptReason.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptReason.java new file mode 100644 index 0000000000..4a37252289 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptReason.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Controlled reason for an individual attempt disposition + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryAttemptReason { + /** The {@code permission_required} variant. */ + PERMISSION_REQUIRED("permission_required"), + /** The {@code repeated_attempt} variant. */ + REPEATED_ATTEMPT("repeated_attempt"), + /** The {@code attempts_exhausted} variant. */ + ATTEMPTS_EXHAUSTED("attempts_exhausted"), + /** The {@code permission_approved} variant. */ + PERMISSION_APPROVED("permission_approved"), + /** The {@code permission_denied} variant. */ + PERMISSION_DENIED("permission_denied"), + /** The {@code responder_unavailable} variant. */ + RESPONDER_UNAVAILABLE("responder_unavailable"), + /** The {@code equivalent_alternative_succeeded} variant. */ + EQUIVALENT_ALTERNATIVE_SUCCEEDED("equivalent_alternative_succeeded"); + + private final String value; + PermissionRecoveryAttemptReason(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryAttemptReason fromValue(String value) { + for (PermissionRecoveryAttemptReason v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryAttemptReason value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptRelation.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptRelation.java new file mode 100644 index 0000000000..8b8c60fc7f --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryAttemptRelation.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Relationship of an attempt to earlier permission requests + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryAttemptRelation { + /** The {@code initial} variant. */ + INITIAL("initial"), + /** The {@code retry} variant. */ + RETRY("retry"), + /** The {@code alternative} variant. */ + ALTERNATIVE("alternative"); + + private final String value; + PermissionRecoveryAttemptRelation(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryAttemptRelation fromValue(String value) { + for (PermissionRecoveryAttemptRelation v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryAttemptRelation value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryData.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryData.java new file mode 100644 index 0000000000..e4c502116d --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryData.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Authoritative snapshot of an Autopilot permission-recovery episode + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record PermissionRecoveryData( + /** Stable identifier shared by every transition in this recovery episode */ + @JsonProperty("episodeId") String episodeId, + /** Current lifecycle state of the recovery episode */ + @JsonProperty("status") PermissionRecoveryStatus status, + /** Policy selected from the current client's response capability; mode or client changes may update it during recovery */ + @JsonProperty("onBlocked") PermissionRecoveryOnBlocked onBlocked, + /** Controlled reason for the latest episode transition */ + @JsonProperty("reason") PermissionRecoveryReason reason, + /** Maximum number of distinct autonomous permission attempts allowed before escalation */ + @JsonProperty("maxAttempts") Long maxAttempts, + /** Ordered privacy-safe record of permission attempts and the successful alternative, when any */ + @JsonProperty("attempts") List attempts +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryOnBlocked.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryOnBlocked.java new file mode 100644 index 0000000000..52db9cc965 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryOnBlocked.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Action selected when autonomous recovery cannot continue + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryOnBlocked { + /** The {@code ask} variant. */ + ASK("ask"), + /** The {@code fail} variant. */ + FAIL("fail"); + + private final String value; + PermissionRecoveryOnBlocked(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryOnBlocked fromValue(String value) { + for (PermissionRecoveryOnBlocked v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryOnBlocked value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryReason.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryReason.java new file mode 100644 index 0000000000..cc0896a299 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryReason.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Controlled reason for a permission-recovery episode transition + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryReason { + /** The {@code permission_required} variant. */ + PERMISSION_REQUIRED("permission_required"), + /** The {@code repeated_attempt} variant. */ + REPEATED_ATTEMPT("repeated_attempt"), + /** The {@code attempts_exhausted} variant. */ + ATTEMPTS_EXHAUSTED("attempts_exhausted"), + /** The {@code permission_approved} variant. */ + PERMISSION_APPROVED("permission_approved"), + /** The {@code permission_denied} variant. */ + PERMISSION_DENIED("permission_denied"), + /** The {@code responder_unavailable} variant. */ + RESPONDER_UNAVAILABLE("responder_unavailable"), + /** The {@code equivalent_alternative_succeeded} variant. */ + EQUIVALENT_ALTERNATIVE_SUCCEEDED("equivalent_alternative_succeeded"); + + private final String value; + PermissionRecoveryReason(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryReason fromValue(String value) { + for (PermissionRecoveryReason v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryReason value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryStatus.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryStatus.java new file mode 100644 index 0000000000..d067b9c759 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/PermissionRecoveryStatus.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Lifecycle state of a permission-recovery episode + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum PermissionRecoveryStatus { + /** The {@code recovering} variant. */ + RECOVERING("recovering"), + /** The {@code awaiting_approval} variant. */ + AWAITING_APPROVAL("awaiting_approval"), + /** The {@code resolved} variant. */ + RESOLVED("resolved"), + /** The {@code blocked} variant. */ + BLOCKED("blocked"); + + private final String value; + PermissionRecoveryStatus(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static PermissionRecoveryStatus fromValue(String value) { + for (PermissionRecoveryStatus v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown PermissionRecoveryStatus value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/Plugin.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/Plugin.java index 65268ab6e3..d30cccf922 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/Plugin.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/Plugin.java @@ -28,6 +28,18 @@ public record Plugin( /** Installed version */ @JsonProperty("version") String version, /** Whether the plugin is currently enabled */ - @JsonProperty("enabled") Boolean enabled + @JsonProperty("enabled") Boolean enabled, + /** Opaque stable identity for a direct plugin source. */ + @JsonProperty("directSourceId") String directSourceId, + /** Absolute marketplace directory for a live plugin. */ + @JsonProperty("installedFrom") String installedFrom, + /** Runtime plugin provenance, such as "builtin". */ + @JsonProperty("source") String source, + /** Whether enterprise managed settings control this plugin. */ + @JsonProperty("managed") Boolean managed, + /** Enabled state required by enterprise managed settings. */ + @JsonProperty("managedDesiredEnabled") Boolean managedDesiredEnabled, + /** Whether this managed desired plugin has an installed or live record. */ + @JsonProperty("installed") Boolean installed ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SandboxConfigUserPolicyNetwork.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SandboxConfigUserPolicyNetwork.java index 244555f3e9..603cc6abbc 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SandboxConfigUserPolicyNetwork.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SandboxConfigUserPolicyNetwork.java @@ -30,7 +30,7 @@ public record SandboxConfigUserPolicyNetwork( @JsonProperty("allowOutbound") Boolean allowOutbound, /** Whether traffic to local/loopback addresses is allowed. */ @JsonProperty("allowLocalNetwork") Boolean allowLocalNetwork, - /** HTTP(S) proxy for sandboxed traffic. With host rules, this is the built-in local proxy's upstream; credentials stay in the runtime, and Linux and macOS restrict the child to the local listener. Without host rules, Linux restricts egress to this endpoint but rejects credentials, and macOS proxying is cooperative. Windows enforcement depends on the application's networking stack. Configure credentials in the separate username/password fields. The transient local listener URL is never persisted. */ + /** HTTP(S) proxy for sandboxed traffic. This is the built-in local proxy's upstream: every sandboxed command reaches it through a loopback listener, so credentials stay in the runtime and never reach the child. On Windows the sandbox also needs local network access, because it reaches that listener over host loopback. Configure credentials in the separate username/password fields. The transient local listener URL is never persisted. */ @JsonProperty("proxy") SandboxConfigUserPolicyNetworkProxy proxy ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ServerCatalogApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ServerCatalogApi.java index 9b320cbb39..992faada12 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ServerCatalogApi.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ServerCatalogApi.java @@ -37,4 +37,15 @@ public CompletableFuture search(CatalogSearchParams params) return caller.invoke("catalog.search", params, CatalogSearchResult.class); } + /** + * Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture select(CatalogSelectParams params) { + return caller.invoke("catalog.select", params, CatalogSelectionResult.class); + } + } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ServerSessionFsApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ServerSessionFsApi.java index 5f540897eb..872702997a 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ServerSessionFsApi.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/ServerSessionFsApi.java @@ -27,7 +27,7 @@ public final class ServerSessionFsApi { } /** - * Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. + * Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderParams.java index bcc1d964ef..05f6e34eca 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderParams.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionFsSetProviderParams.java @@ -14,7 +14,7 @@ import javax.annotation.processing.Generated; /** - * Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. + * Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots. * * @apiNote This method is experimental and may change in a future version. * @since 1.0.0 @@ -24,7 +24,7 @@ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record SessionFsSetProviderParams( - /** Initial working directory for sessions */ + /** Absolute initial working directory for sessions. Registering the provider establishes this path as the root of its virtual namespace; the runtime does not require the provider to materialize or stat it before creating a session. */ @JsonProperty("initialCwd") String initialCwd, /** Path within each session's SessionFs where the runtime stores files for that session */ @JsonProperty("sessionStatePath") String sessionStatePath, diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedPermissions.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedPermissions.java index 8d52a1eb1e..6bf568c985 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedPermissions.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedPermissions.java @@ -22,7 +22,7 @@ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record SessionManagedPermissions( - /** When set to `disable`, prevents bypass/allow-all permission modes. `allow-auto-only` blocks full allow-all but permits advisory auto-approval. Any other value is accepted rather than failing the session, but is enforced as `disable`: the key is only present to restrict something, so a mode this runtime cannot interpret fails closed to the most restrictive one it knows. Omit the key entirely to impose no restriction. */ + /** When set to `disable`, prevents bypass/allow-all permission modes. Advisory auto-approval remains available because normal prompt paths stay active. Any other value is accepted rather than failing the session, but is enforced as `disable`: the key is only present to restrict something, so a mode this runtime cannot interpret fails closed to the most restrictive one it knows. Omit the key entirely to impose no restriction. */ @JsonProperty("disableBypassPermissionsMode") String disableBypassPermissionsMode, /** Permission rules that block matching operations. Deny has highest precedence. */ @JsonProperty("deny") List deny, diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsApi.java new file mode 100644 index 0000000000..adf8568aa2 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsApi.java @@ -0,0 +1,42 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.github.copilot.CopilotExperimental; +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code managedSettings} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionManagedSettingsApi { + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionManagedSettingsApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture get() { + return caller.invoke("session.managedSettings.get", java.util.Map.of("sessionId", this.sessionId), SessionManagedSettingsGetResult.class); + } + +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsGetParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsGetParams.java new file mode 100644 index 0000000000..3444b1a9d5 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsGetParams.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionManagedSettingsGetParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsGetResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsGetResult.java new file mode 100644 index 0000000000..c432e26725 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionManagedSettingsGetResult.java @@ -0,0 +1,51 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Enterprise managed-settings resolution: the effective managed settings the session applied and which channels contributed, so SDK clients can show users what is enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on resume, and on account switch. This is an ephemeral live snapshot (delivered to subscribers but not persisted to the session event log), because at session start it resolves before `session.start` is emitted. Device values take precedence over server values, then the policy helper, per ordinary key, while permissions compose restrictively across device, server, policy-helper, and SDK-client layers. The account-scoped `getManagedSettings()` API does not include session-local client injection. Marked experimental while the managed-settings surface stabilizes. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionManagedSettingsGetResult( + /** Channel summary: `server`, `device`, `client`, or `policyHelper` when exactly one channel contributed; `mixed` when multiple channels contributed; otherwise `none`. Consult the per-channel booleans for exact provenance. */ + @JsonProperty("source") ManagedSettingsResolvedSource source, + /** Whether the server (account/org) managed-settings layer was present */ + @JsonProperty("serverManaged") Boolean serverManaged, + /** Whether an actual device MDM/plist/registry/file managed-settings layer was present */ + @JsonProperty("deviceManaged") Boolean deviceManaged, + /** Whether a session-local permissions layer injected by the SDK host was present */ + @JsonProperty("clientManaged") Boolean clientManaged, + /** Whether the policy-helper managed-settings layer was present. The policy helper is the weakest channel: it fills keys no enterprise source set and can never replace one. */ + @JsonProperty("policyHelperManaged") Boolean policyHelperManaged, + /** Whether managed policy could not be determined (e.g. a failed server fetch) and the session fell back to the fail-closed restriction. When true, restrictions such as disabling bypass-permissions are enforced even though `settings` may be absent. */ + @JsonProperty("failClosed") Boolean failClosed, + /** Whether the effective sandbox policy forces the sandbox on *only* because managed policy could not be determined, rather than because the policy requires it. Lets clients tell a user whose `--no-sandbox` was overridden that the sandbox stayed on as a fail-closed fallback, instead of attributing it to an administrator who set no such policy. */ + @JsonProperty("sandboxEnabledByUndeterminedPolicy") Boolean sandboxEnabledByUndeterminedPolicy, + /** Whether enterprise policy disables bypass-permissions ("yolo") mode for this session. Deny-wins across layers, and forced on when `failClosed` is true. */ + @JsonProperty("bypassPermissionsDisabled") Boolean bypassPermissionsDisabled, + /** Whether at least two managed sources supplied permission allowlists, so enforcement intersects them and the flattened settings payload omits `permissions.allow`. */ + @JsonProperty("permissionsAllowIntersected") Boolean permissionsAllowIntersected, + /** The setting keys under enterprise management in the effective managed settings (e.g. `model`, `enabledPlugins`, `permissions`). Empty when no managed settings are in force. */ + @JsonProperty("managedKeys") List managedKeys, + /** The effective (resolved) managed settings values, so clients can render exactly what is enforced. Absent when no managed policy is in force. */ + @JsonProperty("settings") Object settings +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotResult.java index 6c29e07b6e..b18afb31d6 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotResult.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionMetadataSnapshotResult.java @@ -53,6 +53,8 @@ public record SessionMetadataSnapshotResult( @JsonProperty("selectedModel") String selectedModel, /** Current session limits, or null when no limits are active */ @JsonProperty("sessionLimits") SessionLimitsConfig sessionLimits, + /** Live indexed-search state for this session activation. Omitted by runtimes that do not expose indexed-search status; absence does not indicate enablement. */ + @JsonProperty("indexedSearch") IndexedSearchState indexedSearch, /** Public-facing workspace metadata for this session, or null if the session has no associated workspace. Excludes runtime-internal fields (GitHub IDs, summary count, internal flags). */ @JsonProperty("workspace") SessionMetadataSnapshotResultWorkspace workspace ) { diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayParams.java index 4a83b7b43b..d24ac9e7c2 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayParams.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayParams.java @@ -32,6 +32,8 @@ public record SessionModelApplyStartupOverlayParams( @JsonProperty("serverManagedModel") String serverManagedModel, /** Startup default model from the enterprise policy helper, when configured. Weakest of the managed sources: it applies only when neither device nor server policy names a model, and an explicit user selection still wins. */ @JsonProperty("policyHelperModel") String policyHelperModel, + /** Effective default Auto routing preference from user and managed settings. Applies only to fresh sessions and never replaces a per-session selection. */ + @JsonProperty("autoTier") AutoTier autoTier, /** Model selected by repository settings, when configured. */ @JsonProperty("repoModel") String repoModel, /** Reasoning effort selected by repository settings, when configured. */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayResult.java index 53ce443e08..325b70c8f1 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayResult.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelApplyStartupOverlayResult.java @@ -25,6 +25,8 @@ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record SessionModelApplyStartupOverlayResult( + /** Stable queue item identifier when this request was enqueued. Remains present if the item drains before the response is returned. */ + @JsonProperty("queueId") String queueId, /** Currently active model identifier after the switch */ @JsonProperty("modelId") String modelId, /** True when the switch was deferred (enqueued as a cancellable `/model` command) because a turn was active or another model change was already queued, rather than applied immediately. When true, the session's live model is unchanged until the queued change drains. */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java index 47099e42ea..5c3720d17f 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionModelSwitchToResult.java @@ -25,6 +25,8 @@ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record SessionModelSwitchToResult( + /** Stable queue item identifier when this request was enqueued. Remains present if the item drains before the response is returned. */ + @JsonProperty("queueId") String queueId, /** Currently active model identifier after the switch */ @JsonProperty("modelId") String modelId, /** True when the switch was deferred (enqueued as a cancellable `/model` command) because a turn was active or another model change was already queued, rather than applied immediately. When true, the session's live model is unchanged until the queued change drains. */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsApi.java index fa4da43dc3..6a49785b30 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsApi.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsApi.java @@ -24,10 +24,14 @@ public final class SessionPluginsApi { private final RpcCaller caller; private final String sessionId; + /** API methods for the {@code plugins.marketplaces} sub-namespace. */ + public final SessionPluginsMarketplacesApi marketplaces; + /** @param caller the RPC transport function */ SessionPluginsApi(RpcCaller caller, String sessionId) { this.caller = caller; this.sessionId = sessionId; + this.marketplaces = new SessionPluginsMarketplacesApi(caller, sessionId); } /** @@ -41,6 +45,86 @@ public CompletableFuture list() { return caller.invoke("session.plugins.list", java.util.Map.of("sessionId", this.sessionId), SessionPluginsListResult.class); } + /** + * Plugin source resolved relative to the session's authoritative working directory. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture install(SessionPluginsInstallParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.install", _p, SessionPluginsInstallResult.class); + } + + /** + * Name (or spec) of the plugin to uninstall. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture uninstall(SessionPluginsUninstallParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.uninstall", _p, Void.class); + } + + /** + * Name (or spec) of the plugin to update. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture update(SessionPluginsUpdateParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.update", _p, SessionPluginsUpdateResult.class); + } + + /** + * Plugin names (or specs) to enable in the session's authoritative working directory. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture enable(SessionPluginsEnableParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.enable", _p, Void.class); + } + + /** + * Plugin names (or specs) to disable in the session's authoritative working directory. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture disable(SessionPluginsDisableParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.disable", _p, Void.class); + } + /** * Optional flags controlling which side effects the reload performs. *

diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsDisableParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsDisableParams.java new file mode 100644 index 0000000000..eb14151c4d --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsDisableParams.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Plugin names (or specs) to disable in the session's authoritative working directory. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsDisableParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Plugin names or "plugin@marketplace" specs to disable. Unknown names are ignored. Non-marketplace direct installs cannot be disabled via this API; uninstall them instead. Plugin-owned MCP servers are stopped in active sessions immediately; other plugin contributions remain available until each session reloads plugins. */ + @JsonProperty("names") List names +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsEnableParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsEnableParams.java new file mode 100644 index 0000000000..b8fed836ec --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsEnableParams.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Plugin names (or specs) to enable in the session's authoritative working directory. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsEnableParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Plugin names or "plugin@marketplace" specs to enable. Unknown names are ignored. Non-marketplace direct installs are always enabled and cannot be toggled via this API. */ + @JsonProperty("names") List names +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsInstallParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsInstallParams.java new file mode 100644 index 0000000000..eb79d50da4 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsInstallParams.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Plugin source resolved relative to the session's authoritative working directory. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsInstallParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Plugin install spec. Accepts the same forms as the CLI: "plugin@marketplace" (marketplace install), "owner/repo" or "owner/repo:subpath" (GitHub direct), an http/https/ssh URL, or a local path. Direct (non-marketplace) installs are deprecated and will produce a deprecationWarning in the result. */ + @JsonProperty("source") String source +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsInstallResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsInstallResult.java new file mode 100644 index 0000000000..e063aefcae --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsInstallResult.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result of installing a plugin. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsInstallResult( + /** The newly installed plugin's metadata */ + @JsonProperty("plugin") InstalledPluginInfo plugin, + /** Number of skills discovered and installed from the plugin */ + @JsonProperty("skillsInstalled") Long skillsInstalled, + /** Where the completed plugin tree was staged before atomic promotion */ + @JsonProperty("stagingMode") PluginInstallStagingMode stagingMode, + /** Optional post-install message provided by the plugin (e.g. setup instructions) */ + @JsonProperty("postInstallMessage") String postInstallMessage, + /** Set when the install path is deprecated (e.g. direct repo / URL / local installs). Callers should surface this to end users. */ + @JsonProperty("deprecationWarning") String deprecationWarning +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesAddParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesAddParams.java new file mode 100644 index 0000000000..de5442612a --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesAddParams.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Marketplace source and optional working directory for relative-path resolution. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesAddParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Marketplace source. Accepts the same forms as the CLI: "owner/repo" or "owner/repo#ref" (GitHub), an http/https/ssh URL (optionally with #ref), a git scp-style URL (user@host:path), or a local path. The marketplace's own name (from its manifest) is used as the registration key. */ + @JsonProperty("source") String source, + /** Working directory used to resolve relative local paths in `source`. Defaults to the server's current working directory. */ + @JsonProperty("workingDirectory") String workingDirectory +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesAddResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesAddResult.java new file mode 100644 index 0000000000..9329b794fc --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesAddResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result of registering a new marketplace. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesAddResult( + /** Final name of the marketplace as resolved from its manifest */ + @JsonProperty("name") String name +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesApi.java new file mode 100644 index 0000000000..3ec14c5cf7 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesApi.java @@ -0,0 +1,121 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.github.copilot.CopilotExperimental; +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code plugins.marketplaces} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionPluginsMarketplacesApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionPluginsMarketplacesApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture list() { + return caller.invoke("session.plugins.marketplaces.list", java.util.Map.of("sessionId", this.sessionId), SessionPluginsMarketplacesListResult.class); + } + + /** + * Marketplace source and optional working directory for relative-path resolution. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture add(SessionPluginsMarketplacesAddParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.marketplaces.add", _p, SessionPluginsMarketplacesAddResult.class); + } + + /** + * Name of the marketplace to remove and an optional force flag. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture remove(SessionPluginsMarketplacesRemoveParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.marketplaces.remove", _p, SessionPluginsMarketplacesRemoveResult.class); + } + + /** + * Name of the marketplace whose plugin catalog to fetch. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture browse(SessionPluginsMarketplacesBrowseParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.marketplaces.browse", _p, SessionPluginsMarketplacesBrowseResult.class); + } + + /** + * Optional marketplace name; omit to refresh all. + *

+ * Invokes the method with no params, applying the runtime defaults. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture refresh() { + return refresh(null); + } + + /** + * Optional marketplace name; omit to refresh all. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture refresh(SessionPluginsMarketplacesRefreshParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = params == null ? MAPPER.createObjectNode() : MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.plugins.marketplaces.refresh", _p, SessionPluginsMarketplacesRefreshResult.class); + } + +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesBrowseParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesBrowseParams.java new file mode 100644 index 0000000000..fa2dffa801 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesBrowseParams.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Name of the marketplace whose plugin catalog to fetch. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesBrowseParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Marketplace name to browse */ + @JsonProperty("name") String name +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesBrowseResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesBrowseResult.java new file mode 100644 index 0000000000..988a5f71e8 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesBrowseResult.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Plugins advertised by the marketplace. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesBrowseResult( + /** Plugins advertised by the marketplace */ + @JsonProperty("plugins") List plugins +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesListParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesListParams.java new file mode 100644 index 0000000000..0badb3cd70 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesListParams.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Identifies the target session. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesListParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesListResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesListResult.java new file mode 100644 index 0000000000..b84ffa78f0 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesListResult.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * All registered marketplaces, including built-in defaults. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesListResult( + /** Registered marketplaces */ + @JsonProperty("marketplaces") List marketplaces +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRefreshParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRefreshParams.java new file mode 100644 index 0000000000..c54b2e23c6 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRefreshParams.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Request parameters for the {@code session.plugins.marketplaces.refresh} RPC method. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesRefreshParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Marketplace name to refresh. When omitted, every registered marketplace is refreshed. */ + @JsonProperty("name") String name +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRefreshResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRefreshResult.java new file mode 100644 index 0000000000..a9e075760d --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRefreshResult.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Result of refreshing one or more marketplace catalogs. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesRefreshResult( + /** Per-marketplace refresh results in deterministic order. */ + @JsonProperty("results") List results +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRemoveParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRemoveParams.java new file mode 100644 index 0000000000..ece06ae682 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRemoveParams.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Name of the marketplace to remove and an optional force flag. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesRemoveParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Marketplace name to remove */ + @JsonProperty("name") String name, + /** When true, also uninstall every plugin sourced from this marketplace. When false (default), removal is a no-op if any plugin from this marketplace is installed and the dependent plugin names are returned in the result. */ + @JsonProperty("force") Boolean force +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRemoveResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRemoveResult.java new file mode 100644 index 0000000000..3ae8bab8d5 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsMarketplacesRemoveResult.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Outcome of the remove attempt, including dependent-plugin info when applicable. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsMarketplacesRemoveResult( + /** True when the marketplace was actually removed. False when removal was skipped because the marketplace has dependent plugins and `force` was not set. */ + @JsonProperty("removed") Boolean removed, + /** Names of installed plugins that prevented removal. Populated only when `removed=false`. */ + @JsonProperty("dependentPlugins") List dependentPlugins +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUninstallParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUninstallParams.java new file mode 100644 index 0000000000..c3001848e3 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUninstallParams.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Name (or spec) of the plugin to uninstall. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsUninstallParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Plugin name or "plugin@marketplace" spec to uninstall. When ambiguous, prefer the fully-qualified spec. */ + @JsonProperty("name") String name, + /** Stable source identity for a direct (non-marketplace) install. Disambiguates uninstall when multiple installed plugins share the same name. */ + @JsonProperty("directSourceId") String directSourceId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUpdateParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUpdateParams.java new file mode 100644 index 0000000000..88a863a036 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUpdateParams.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Name (or spec) of the plugin to update. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsUpdateParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Plugin name or "plugin@marketplace" spec to update. */ + @JsonProperty("name") String name +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUpdateResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUpdateResult.java new file mode 100644 index 0000000000..0809cf663f --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionPluginsUpdateResult.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result of updating a single plugin. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionPluginsUpdateResult( + /** Version that was previously installed, when available */ + @JsonProperty("previousVersion") String previousVersion, + /** Version after the update, when reported by the plugin manifest */ + @JsonProperty("newVersion") String newVersion, + /** Number of skills discovered and installed after the update */ + @JsonProperty("skillsInstalled") Long skillsInstalled +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueApi.java index 6e40bdfeba..9b8f333825 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueApi.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueApi.java @@ -116,6 +116,38 @@ public CompletableFuture updateText(SessionQueueUp return caller.invoke("session.queue.updateText", _p, SessionQueueUpdateTextResult.class); } + /** + * Conditional withdrawal of a single user message, before the runtime claims it for delivery. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture withdrawMessage(SessionQueueWithdrawMessageParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.queue.withdrawMessage", _p, SessionQueueWithdrawMessageResult.class); + } + + /** + * Append to one pending steering message without changing its identity or delivery position. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture appendSteering(SessionQueueAppendSteeringParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.queue.appendSteering", _p, SessionQueueAppendSteeringResult.class); + } + /** * Parameters for duplicating a queued item. *

diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueAppendSteeringParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueAppendSteeringParams.java new file mode 100644 index 0000000000..705cf70d65 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueAppendSteeringParams.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Append to one pending steering message without changing its identity or delivery position. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueueAppendSteeringParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Message identity returned by send, not the queue item id. Only unclaimed user steering messages are eligible. */ + @JsonProperty("messageId") String messageId, + /** Expected current prompt, including any previous appends. The runtime applies plan-mode normalization before comparing and refuses a changed message. */ + @JsonProperty("expectedPrompt") String expectedPrompt, + /** Mode captured at submission. Only steering messages in the same mode may be combined. */ + @JsonProperty("agentMode") SendAgentMode agentMode, + /** Text to append after a blank line. */ + @JsonProperty("prompt") String prompt, + /** Display text to append to the existing preview after a blank line. */ + @JsonProperty("displayPrompt") String displayPrompt, + /** Attachments to add after the message's existing attachments. An empty list preserves the existing attachments. */ + @JsonProperty("attachments") List attachments +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueAppendSteeringResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueAppendSteeringResult.java new file mode 100644 index 0000000000..70919e1314 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueAppendSteeringResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result of editing a queued message. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueueAppendSteeringResult( + /** True when the stored text changed. */ + @JsonProperty("updated") Boolean updated +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueSnapshotResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueSnapshotResult.java index 7ae1076d63..708d9ef1df 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueSnapshotResult.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueSnapshotResult.java @@ -25,6 +25,8 @@ @JsonInclude(JsonInclude.Include.NON_NULL) @JsonIgnoreProperties(ignoreUnknown = true) public record SessionQueueSnapshotResult( + /** Queue item identifier of a model switch that has been dequeued but not yet applied. */ + @JsonProperty("inFlightModelChangeId") String inFlightModelChangeId, /** User-facing pending items in FIFO order. */ @JsonProperty("items") List items, /** Immediate steering messages waiting for an active turn. */ diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueWithdrawMessageParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueWithdrawMessageParams.java new file mode 100644 index 0000000000..3f90ba10c4 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueWithdrawMessageParams.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Conditional withdrawal of a single user message, before the runtime claims it for delivery. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueueWithdrawMessageParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Message identity returned by send, not the queue item id. Batch messages are not eligible. */ + @JsonProperty("messageId") String messageId, + /** The prompt originally sent. A message edited since submission is not withdrawn, so an obsolete draft cannot replace the edit. */ + @JsonProperty("expectedPrompt") String expectedPrompt +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueWithdrawMessageResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueWithdrawMessageResult.java new file mode 100644 index 0000000000..2208472b94 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionQueueWithdrawMessageResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result of removing a queued item. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionQueueWithdrawMessageResult( + /** True when the addressed item was removed. */ + @JsonProperty("removed") Boolean removed +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java index cf89d37208..3ffe83d142 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionRpc.java @@ -39,6 +39,8 @@ public final class SessionRpc { public final SessionCanvasApi canvas; /** API methods for the {@code factory} namespace. */ public final SessionFactoryApi factory; + /** API methods for the {@code workflow} namespace. */ + public final SessionWorkflowApi workflow; /** API methods for the {@code model} namespace. */ public final SessionModelApi model; /** API methods for the {@code mode} namespace. */ @@ -65,6 +67,8 @@ public final class SessionRpc { public final SessionSkillsApi skills; /** API methods for the {@code mcp} namespace. */ public final SessionMcpApi mcp; + /** API methods for the {@code managedSettings} namespace. */ + public final SessionManagedSettingsApi managedSettings; /** API methods for the {@code plugins} namespace. */ public final SessionPluginsApi plugins; /** API methods for the {@code provider} namespace. */ @@ -124,6 +128,7 @@ public SessionRpc(RpcCaller caller, String sessionId) { this.debug = new SessionDebugApi(caller, sessionId); this.canvas = new SessionCanvasApi(caller, sessionId); this.factory = new SessionFactoryApi(caller, sessionId); + this.workflow = new SessionWorkflowApi(caller, sessionId); this.model = new SessionModelApi(caller, sessionId); this.mode = new SessionModeApi(caller, sessionId); this.name = new SessionNameApi(caller, sessionId); @@ -137,6 +142,7 @@ public SessionRpc(RpcCaller caller, String sessionId) { this.tasks = new SessionTasksApi(caller, sessionId); this.skills = new SessionSkillsApi(caller, sessionId); this.mcp = new SessionMcpApi(caller, sessionId); + this.managedSettings = new SessionManagedSettingsApi(caller, sessionId); this.plugins = new SessionPluginsApi(caller, sessionId); this.provider = new SessionProviderApi(caller, sessionId); this.options = new SessionOptionsApi(caller, sessionId); diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionToolsTaskCompleteEventDataResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionToolsTaskCompleteEventDataResult.java index f95ad8a76e..b96d8667f8 100644 --- a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionToolsTaskCompleteEventDataResult.java +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionToolsTaskCompleteEventDataResult.java @@ -33,6 +33,8 @@ public record SessionToolsTaskCompleteEventDataResult( /** Label-safe runtime rationale for the completion decision (e.g. a cancellation or pause/resume downgrade), when one applies. Reviewer-authored rationale is intentionally omitted here because this event has no IFC label channel; the reviewer's findings remain available through its own labeled sub-agent events */ @JsonProperty("reason") String reason, /** Active autopilot objective ID evaluated by the completion reviewer */ - @JsonProperty("objectiveId") Long objectiveId + @JsonProperty("objectiveId") Long objectiveId, + /** Structured blocker details when outcome is blocked */ + @JsonProperty("blocker") TaskBlocker blocker ) { } diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowAgentParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowAgentParams.java new file mode 100644 index 0000000000..9099ce6265 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowAgentParams.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for one workflow-scoped subagent call. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowAgentParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier that owns the subagent. */ + @JsonProperty("workflowRunId") String workflowRunId, + /** Opaque token identifying the current workflow execution attempt. */ + @JsonProperty("executionToken") String executionToken, + /** Prompt to send to the subagent. */ + @JsonProperty("prompt") String prompt, + /** Subagent execution options. */ + @JsonProperty("opts") WorkflowAgentOptions opts +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowAgentResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowAgentResult.java new file mode 100644 index 0000000000..aa521a65dd --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowAgentResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result of one workflow-scoped subagent call. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowAgentResult( + /** Agent result, omitted when the agent produced no result. */ + @JsonProperty("result") Object result +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowApi.java new file mode 100644 index 0000000000..adffbd7302 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowApi.java @@ -0,0 +1,245 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.github.copilot.CopilotExperimental; +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code workflow} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionWorkflowApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** API methods for the {@code workflow.journal} sub-namespace. */ + public final SessionWorkflowJournalApi journal; + + /** @param caller the RPC transport function */ + SessionWorkflowApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + this.journal = new SessionWorkflowJournalApi(caller, sessionId); + } + + /** + * Parameters for invoking a registered workflow. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture run(SessionWorkflowRunParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.run", _p, SessionWorkflowRunResult.class); + } + + /** + * Parameters for resuming a workflow run from its persisted identity. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture resume(SessionWorkflowResumeParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.resume", _p, SessionWorkflowResumeResult.class); + } + + /** + * Internal parameters for invoking a registered workflow from a tool. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture runFromTool(SessionWorkflowRunFromToolParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.runFromTool", _p, SessionWorkflowRunFromToolResult.class); + } + + /** + * Internal parameters for resuming a workflow run from a tool. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture resumeFromTool(SessionWorkflowResumeFromToolParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.resumeFromTool", _p, SessionWorkflowResumeFromToolResult.class); + } + + /** + * Parameters for retrieving a workflow run. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture getRun(SessionWorkflowGetRunParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.getRun", _p, SessionWorkflowGetRunResult.class); + } + + /** + * Parameters for paging workflow runs. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture listRuns(SessionWorkflowListRunsParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.listRuns", _p, SessionWorkflowListRunsResult.class); + } + + /** + * Parameters for retrieving a workflow run. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture getRunDetail(SessionWorkflowGetRunDetailParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.getRunDetail", _p, SessionWorkflowGetRunDetailResult.class); + } + + /** + * Parameters for paging workflow progress. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture getRunProgress(SessionWorkflowGetRunProgressParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.getRunProgress", _p, SessionWorkflowGetRunProgressResult.class); + } + + /** + * Parameters for cancelling a workflow run. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture cancel(SessionWorkflowCancelParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.cancel", _p, SessionWorkflowCancelResult.class); + } + + /** + * Parameters for pausing a running workflow. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture pause(SessionWorkflowPauseParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.pause", _p, SessionWorkflowPauseResult.class); + } + + /** + * Parameters for an owned durable pause checkpoint. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture pauseAtCheckpoint(SessionWorkflowPauseAtCheckpointParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.pauseAtCheckpoint", _p, SessionWorkflowPauseAtCheckpointResult.class); + } + + /** + * Parameters for recording workflow progress. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture log(SessionWorkflowLogParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.log", _p, Void.class); + } + + /** + * Parameters for one workflow-scoped subagent call. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture agent(SessionWorkflowAgentParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.agent", _p, SessionWorkflowAgentResult.class); + } + +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowCancelParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowCancelParams.java new file mode 100644 index 0000000000..f1c4105943 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowCancelParams.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for cancelling a workflow run. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowCancelParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowCancelResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowCancelResult.java new file mode 100644 index 0000000000..ee6ce8ed7d --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowCancelResult.java @@ -0,0 +1,46 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Complete current or terminal workflow run envelope. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowCancelResult( + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. */ + @JsonProperty("attempt") Long attempt, + /** Current or terminal workflow run status. */ + @JsonProperty("status") WorkflowRunStatus status, + /** Completed workflow result. */ + @JsonProperty("result") Object result, + /** Error message for an errored run. */ + @JsonProperty("error") String error, + /** Machine-readable failure details for a halted or errored run. */ + @JsonProperty("failure") Object failure, + /** Reason for a halted or cancelled run. */ + @JsonProperty("reason") String reason, + /** Partial journal and progress snapshot for a halted, cancelled, or errored run. */ + @JsonProperty("snapshot") Object snapshot, + /** Structured pause initiator metadata for a paused attempt. */ + @JsonProperty("pauseInfo") Object pauseInfo +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunDetailParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunDetailParams.java new file mode 100644 index 0000000000..036156cb7a --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunDetailParams.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for retrieving a workflow run. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowGetRunDetailParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunDetailResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunDetailResult.java new file mode 100644 index 0000000000..716831fd12 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunDetailResult.java @@ -0,0 +1,75 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Full workflow run observability detail. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowGetRunDetailResult( + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Registered workflow name. */ + @JsonProperty("workflowName") String workflowName, + /** Human-readable workflow description. */ + @JsonProperty("description") String description, + /** Current workflow run status. */ + @JsonProperty("status") WorkflowRunStatus status, + /** Monotonic durable run revision. */ + @JsonProperty("revision") Long revision, + /** Epoch milliseconds when the run was created. */ + @JsonProperty("createdAt") Long createdAt, + /** Epoch milliseconds when execution first started, or null before start. */ + @JsonProperty("startedAt") Long startedAt, + /** Epoch milliseconds when the durable run was last updated. */ + @JsonProperty("updatedAt") Long updatedAt, + /** Epoch milliseconds when the run completed, or null while nonterminal. */ + @JsonProperty("completedAt") Long completedAt, + /** Current phase identity, or null before any phase is entered. */ + @JsonProperty("currentPhase") WorkflowCurrentPhase currentPhase, + /** Number of phases declared by the workflow. */ + @JsonProperty("declaredPhaseCount") Long declaredPhaseCount, + /** Number of direct workflow agents currently live. */ + @JsonProperty("liveAgentCount") Long liveAgentCount, + /** Total direct workflow agents spawned across all attempts. */ + @JsonProperty("totalSpawnedAgentCount") Long totalSpawnedAgentCount, + /** Durable resource consumption. */ + @JsonProperty("consumed") WorkflowRunConsumed consumed, + /** Resource ceilings declared by the workflow. */ + @JsonProperty("declaredLimits") WorkflowDeclaredLimits declaredLimits, + /** Approved effective resource ceilings, or null until approved. */ + @JsonProperty("approved") WorkflowDeclaredLimits approved, + /** Epoch milliseconds when this live-overlay snapshot was observed. */ + @JsonProperty("observedAt") Long observedAt, + /** Epoch milliseconds when the current active segment started, or null while inactive. */ + @JsonProperty("activeSegmentStartedAt") Long activeSegmentStartedAt, + /** Terminal run outcome, or null while nonterminal. */ + @JsonProperty("terminal") WorkflowRunTerminal terminal, + /** Whether the durable run state currently passes runtime resume eligibility checks. */ + @JsonProperty("canResume") Boolean canResume, + /** Lifecycle and timing observations for each workflow phase. */ + @JsonProperty("phases") List phases, + /** Durable identities and live statuses for direct workflow agents. */ + @JsonProperty("agents") List agents, + /** Bidirectional page of durable workflow progress. */ + @JsonProperty("progress") WorkflowProgressPage progress +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunParams.java new file mode 100644 index 0000000000..92724d9aa2 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunParams.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for retrieving a workflow run. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowGetRunParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunProgressParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunProgressParams.java new file mode 100644 index 0000000000..6168056b82 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunProgressParams.java @@ -0,0 +1,40 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for paging workflow progress. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowGetRunProgressParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Optional phase identifier used to scope records and cursors. */ + @JsonProperty("phaseId") String phaseId, + /** Exclusive forward cursor. */ + @JsonProperty("afterSeq") Long afterSeq, + /** Exclusive backward cursor. */ + @JsonProperty("beforeSeq") Long beforeSeq, + /** Maximum records to return. Defaults to 200 and is capped at 500. */ + @JsonProperty("limit") Long limit +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunProgressResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunProgressResult.java new file mode 100644 index 0000000000..7306154a68 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunProgressResult.java @@ -0,0 +1,41 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * A bidirectional page of workflow progress. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowGetRunProgressResult( + /** Progress records in sequence order. */ + @JsonProperty("records") List records, + /** Oldest sequence number in this page, or null when empty. */ + @JsonProperty("oldestSeq") Long oldestSeq, + /** Newest sequence number in this page, or null when empty. */ + @JsonProperty("newestSeq") Long newestSeq, + /** Whether progress records older than this page exist. */ + @JsonProperty("hasMoreOlder") Boolean hasMoreOlder, + /** Whether progress records newer than this page exist. */ + @JsonProperty("hasMoreNewer") Boolean hasMoreNewer, + /** Run revision reflected by this page. */ + @JsonProperty("revision") Long revision +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunResult.java new file mode 100644 index 0000000000..f58b1e6a2d --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowGetRunResult.java @@ -0,0 +1,46 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Complete current or terminal workflow run envelope. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowGetRunResult( + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. */ + @JsonProperty("attempt") Long attempt, + /** Current or terminal workflow run status. */ + @JsonProperty("status") WorkflowRunStatus status, + /** Completed workflow result. */ + @JsonProperty("result") Object result, + /** Error message for an errored run. */ + @JsonProperty("error") String error, + /** Machine-readable failure details for a halted or errored run. */ + @JsonProperty("failure") Object failure, + /** Reason for a halted or cancelled run. */ + @JsonProperty("reason") String reason, + /** Partial journal and progress snapshot for a halted, cancelled, or errored run. */ + @JsonProperty("snapshot") Object snapshot, + /** Structured pause initiator metadata for a paused attempt. */ + @JsonProperty("pauseInfo") Object pauseInfo +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalApi.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalApi.java new file mode 100644 index 0000000000..0909931439 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalApi.java @@ -0,0 +1,65 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.github.copilot.CopilotExperimental; +import java.util.concurrent.CompletableFuture; +import javax.annotation.processing.Generated; + +/** + * API methods for the {@code workflow.journal} namespace. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public final class SessionWorkflowJournalApi { + + private static final com.fasterxml.jackson.databind.ObjectMapper MAPPER = RpcMapper.INSTANCE; + + private final RpcCaller caller; + private final String sessionId; + + /** @param caller the RPC transport function */ + SessionWorkflowJournalApi(RpcCaller caller, String sessionId) { + this.caller = caller; + this.sessionId = sessionId; + } + + /** + * Parameters for reading a workflow journal entry. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture get(SessionWorkflowJournalGetParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.journal.get", _p, SessionWorkflowJournalGetResult.class); + } + + /** + * Parameters for storing a workflow journal entry. + *

+ * Note: the {@code sessionId} field in the params record is overridden + * by the session-scoped wrapper; any value provided is ignored. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ + @CopilotExperimental + public CompletableFuture put(SessionWorkflowJournalPutParams params) { + com.fasterxml.jackson.databind.node.ObjectNode _p = MAPPER.valueToTree(params); + _p.put("sessionId", this.sessionId); + return caller.invoke("session.workflow.journal.put", _p, Void.class); + } + +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalGetParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalGetParams.java new file mode 100644 index 0000000000..3b79842b27 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalGetParams.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for reading a workflow journal entry. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowJournalGetParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Opaque token identifying the current workflow execution attempt. */ + @JsonProperty("executionToken") String executionToken, + /** Namespaced journal key. */ + @JsonProperty("key") String key +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalGetResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalGetResult.java new file mode 100644 index 0000000000..e7d518a1ec --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalGetResult.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result of reading a workflow journal entry. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowJournalGetResult( + /** Whether the journal contained the requested key. */ + @JsonProperty("hit") Boolean hit, + /** Cached JSON result. The hit field distinguishes a cached JSON null from a miss. */ + @JsonProperty("resultJson") Object resultJson +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalPutParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalPutParams.java new file mode 100644 index 0000000000..890c69647e --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowJournalPutParams.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for storing a workflow journal entry. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowJournalPutParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Opaque token identifying the current workflow execution attempt. */ + @JsonProperty("executionToken") String executionToken, + /** Namespaced journal key. */ + @JsonProperty("key") String key, + /** JSON result to memoize. */ + @JsonProperty("resultJson") Object resultJson +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowListRunsParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowListRunsParams.java new file mode 100644 index 0000000000..c914fc3d46 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowListRunsParams.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for paging workflow runs. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowListRunsParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Exclusive forward cursor. */ + @JsonProperty("afterSeq") Long afterSeq, + /** Exclusive backward cursor. */ + @JsonProperty("beforeSeq") Long beforeSeq, + /** Maximum terminal runs to return. Defaults to 200 and is capped at 500. */ + @JsonProperty("limit") Long limit +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowListRunsResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowListRunsResult.java new file mode 100644 index 0000000000..8793664bc1 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowListRunsResult.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * A page of workflow runs in durable creation order. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowListRunsResult( + /** Workflow run summaries in durable creation order. */ + @JsonProperty("runs") List runs, + /** Oldest terminal-run cursor in this page, or null when the terminal window is empty. */ + @JsonProperty("oldestSeq") Long oldestSeq, + /** Newest terminal-run cursor in this page, or null when the terminal window is empty. */ + @JsonProperty("newestSeq") Long newestSeq, + /** Whether terminal runs newer than this page exist. */ + @JsonProperty("hasMoreNewer") Boolean hasMoreNewer, + /** Number of terminal runs older than this page. */ + @JsonProperty("omittedOlder") Long omittedOlder +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowLogParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowLogParams.java new file mode 100644 index 0000000000..c76f9f4ffb --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowLogParams.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * Parameters for recording workflow progress. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowLogParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Opaque token identifying the current workflow execution attempt. */ + @JsonProperty("executionToken") String executionToken, + /** Ordered progress lines to append. */ + @JsonProperty("lines") List lines +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseAtCheckpointParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseAtCheckpointParams.java new file mode 100644 index 0000000000..5000a5c4d8 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseAtCheckpointParams.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for an owned durable pause checkpoint. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowPauseAtCheckpointParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Opaque token identifying the execution attempt that reached the checkpoint. */ + @JsonProperty("executionToken") String executionToken, + /** Stable author-defined checkpoint key. */ + @JsonProperty("key") String key +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseAtCheckpointResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseAtCheckpointResult.java new file mode 100644 index 0000000000..9c2a46ab38 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseAtCheckpointResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result for the {@code session.workflow.pauseAtCheckpoint} RPC method. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowPauseAtCheckpointResult( + /** Whether this execution attempt must pause or may continue. */ + @JsonProperty("action") WorkflowPauseCheckpointAction action +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseParams.java new file mode 100644 index 0000000000..9472662351 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseParams.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for pausing a running workflow. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowPauseParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseResult.java new file mode 100644 index 0000000000..14a1d880eb --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowPauseResult.java @@ -0,0 +1,46 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Complete current or terminal workflow run envelope. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowPauseResult( + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. */ + @JsonProperty("attempt") Long attempt, + /** Current or terminal workflow run status. */ + @JsonProperty("status") WorkflowRunStatus status, + /** Completed workflow result. */ + @JsonProperty("result") Object result, + /** Error message for an errored run. */ + @JsonProperty("error") String error, + /** Machine-readable failure details for a halted or errored run. */ + @JsonProperty("failure") Object failure, + /** Reason for a halted or cancelled run. */ + @JsonProperty("reason") String reason, + /** Partial journal and progress snapshot for a halted, cancelled, or errored run. */ + @JsonProperty("snapshot") Object snapshot, + /** Structured pause initiator metadata for a paused attempt. */ + @JsonProperty("pauseInfo") Object pauseInfo +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeFromToolParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeFromToolParams.java new file mode 100644 index 0000000000..c9630f6ede --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeFromToolParams.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Internal parameters for resuming a workflow run from a tool. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowResumeFromToolParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Optional per-invocation resource ceiling overrides. */ + @JsonProperty("limits") WorkflowRunLimits limits, + /** Opaque identifier of the originating tool call. */ + @JsonProperty("toolCallId") String toolCallId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeFromToolResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeFromToolResult.java new file mode 100644 index 0000000000..65dc8bfbfe --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeFromToolResult.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Resolved persisted workflow identity and resumed run envelope. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowResumeFromToolResult( + /** Persisted workflow name resolved for the resumed run. */ + @JsonProperty("workflowName") String workflowName, + /** Terminal resumed run envelope. */ + @JsonProperty("run") WorkflowRunResult run +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeParams.java new file mode 100644 index 0000000000..ed905259eb --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeParams.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for resuming a workflow run from its persisted identity. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowResumeParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Optional per-invocation resource ceiling overrides. */ + @JsonProperty("limits") WorkflowRunLimits limits, + /** Whether to notify the originating session when the workflow completes. */ + @JsonProperty("notifyOnComplete") Boolean notifyOnComplete, + /** Whether to emit workflow phase names to the session transcript. */ + @JsonProperty("logPhaseNames") Boolean logPhaseNames +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeResult.java new file mode 100644 index 0000000000..9665cafcdc --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowResumeResult.java @@ -0,0 +1,32 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Resolved persisted workflow identity and resumed run envelope. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowResumeResult( + /** Persisted workflow name resolved for the resumed run. */ + @JsonProperty("workflowName") String workflowName, + /** Terminal resumed run envelope. */ + @JsonProperty("run") WorkflowRunResult run +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunFromToolParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunFromToolParams.java new file mode 100644 index 0000000000..8fc9661ea4 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunFromToolParams.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Internal parameters for invoking a registered workflow from a tool. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowRunFromToolParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Registered workflow name. */ + @JsonProperty("name") String name, + /** Workflow input value. */ + @JsonProperty("args") Object args, + /** Tool-originated workflow invocation options. */ + @JsonProperty("options") WorkflowToolRunOptions options, + /** Opaque identifier of the originating tool call. */ + @JsonProperty("toolCallId") String toolCallId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunFromToolResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunFromToolResult.java new file mode 100644 index 0000000000..d5ab4d5e6e --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunFromToolResult.java @@ -0,0 +1,46 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Complete current or terminal workflow run envelope. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowRunFromToolResult( + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. */ + @JsonProperty("attempt") Long attempt, + /** Current or terminal workflow run status. */ + @JsonProperty("status") WorkflowRunStatus status, + /** Completed workflow result. */ + @JsonProperty("result") Object result, + /** Error message for an errored run. */ + @JsonProperty("error") String error, + /** Machine-readable failure details for a halted or errored run. */ + @JsonProperty("failure") Object failure, + /** Reason for a halted or cancelled run. */ + @JsonProperty("reason") String reason, + /** Partial journal and progress snapshot for a halted, cancelled, or errored run. */ + @JsonProperty("snapshot") Object snapshot, + /** Structured pause initiator metadata for a paused attempt. */ + @JsonProperty("pauseInfo") Object pauseInfo +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunParams.java new file mode 100644 index 0000000000..642e2f7fcf --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunParams.java @@ -0,0 +1,36 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for invoking a registered workflow. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowRunParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Registered workflow name. */ + @JsonProperty("name") String name, + /** Workflow input value. */ + @JsonProperty("args") Object args, + /** Workflow invocation options. */ + @JsonProperty("options") WorkflowRunOptions options +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunResult.java new file mode 100644 index 0000000000..47ab4d74dc --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/SessionWorkflowRunResult.java @@ -0,0 +1,46 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Complete current or terminal workflow run envelope. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record SessionWorkflowRunResult( + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. */ + @JsonProperty("attempt") Long attempt, + /** Current or terminal workflow run status. */ + @JsonProperty("status") WorkflowRunStatus status, + /** Completed workflow result. */ + @JsonProperty("result") Object result, + /** Error message for an errored run. */ + @JsonProperty("error") String error, + /** Machine-readable failure details for a halted or errored run. */ + @JsonProperty("failure") Object failure, + /** Reason for a halted or cancelled run. */ + @JsonProperty("reason") String reason, + /** Partial journal and progress snapshot for a halted, cancelled, or errored run. */ + @JsonProperty("snapshot") Object snapshot, + /** Structured pause initiator metadata for a paused attempt. */ + @JsonProperty("pauseInfo") Object pauseInfo +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskBlocker.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskBlocker.java new file mode 100644 index 0000000000..c54d63865d --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskBlocker.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Structured reason that the task cannot continue without intervention + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record TaskBlocker( + /** Category of intervention that blocked the task */ + @JsonProperty("kind") TaskBlockerKind kind, + /** Controlled reason for the current blocked state */ + @JsonProperty("reason") PermissionRecoveryReason reason, + /** Whether a later user response or steering message can resume the task */ + @JsonProperty("resumable") Boolean resumable, + /** Permission-recovery episode that produced this blocker */ + @JsonProperty("permissionRecovery") PermissionRecoveryData permissionRecovery +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskBlockerKind.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskBlockerKind.java new file mode 100644 index 0000000000..3615bea73b --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/TaskBlockerKind.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Category of structured task blocker + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum TaskBlockerKind { + /** The {@code permission_recovery} variant. */ + PERMISSION_RECOVERY("permission_recovery"); + + private final String value; + TaskBlockerKind(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static TaskBlockerKind fromValue(String value) { + for (TaskBlockerKind v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown TaskBlockerKind value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAbortParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAbortParams.java new file mode 100644 index 0000000000..9d9e489534 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAbortParams.java @@ -0,0 +1,34 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters for cooperatively aborting a workflow body. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowAbortParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Opaque token identifying the execution attempt to abort. */ + @JsonProperty("executionToken") String executionToken +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAgentOptions.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAgentOptions.java new file mode 100644 index 0000000000..d3774baf0c --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAgentOptions.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Options for one workflow-scoped subagent call. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowAgentOptions( + /** Optional label distinguishing otherwise identical memoized agent calls. */ + @JsonProperty("label") String label, + /** Optional JSON Schema for structured agent output. */ + @JsonProperty("schema") Object schema, + /** Optional model identifier for the subagent. */ + @JsonProperty("model") String model, + /** Optional reasoning effort override for the subagent. */ + @JsonProperty("reasoningEffort") String reasoningEffort, + /** Optional context tier override for the subagent. */ + @JsonProperty("contextTier") ContextTier contextTier, + /** Optional built-in or custom agent name whose definition configures the subagent. */ + @JsonProperty("agent") String agent +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAgentSummary.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAgentSummary.java new file mode 100644 index 0000000000..17546d7c57 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowAgentSummary.java @@ -0,0 +1,53 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Prompt-safe durable identity and live status for a direct workflow agent. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowAgentSummary( + /** Stable direct-agent identifier. */ + @JsonProperty("agentId") String agentId, + /** Tool-call identifier that launched the agent. */ + @JsonProperty("toolCallId") String toolCallId, + /** Owning workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Phase identifier active when the agent was launched, or null. */ + @JsonProperty("phaseId") String phaseId, + /** Friendly, non-unique name intended for display */ + @JsonProperty("label") String label, + /** Friendly, non-unique name intended for display */ + @JsonProperty("displayName") String displayName, + /** Registered agent type. */ + @JsonProperty("agentType") String agentType, + /** Current durable or live agent status. */ + @JsonProperty("status") String status, + /** Model requested when the agent was launched. */ + @JsonProperty("requestedModel") String requestedModel, + /** Concrete model resolved for the agent. */ + @JsonProperty("resolvedModel") String resolvedModel, + /** Epoch milliseconds when the agent started. */ + @JsonProperty("startedAt") Long startedAt, + /** Epoch milliseconds when the agent completed. */ + @JsonProperty("completedAt") Long completedAt, + /** Accumulated active agent time in milliseconds. */ + @JsonProperty("activeMs") Long activeMs, + /** Prompt-safe live activity text. */ + @JsonProperty("activity") String activity +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowCurrentPhase.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowCurrentPhase.java new file mode 100644 index 0000000000..d89ec13e47 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowCurrentPhase.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Current workflow phase identity. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowCurrentPhase( + /** Current phase identifier. */ + @JsonProperty("id") String id, + /** Zero-based declared phase ordinal, or null for an undeclared phase. */ + @JsonProperty("ordinal") Long ordinal +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowDeclaredLimits.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowDeclaredLimits.java new file mode 100644 index 0000000000..d5caca470a --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowDeclaredLimits.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Declared or approved workflow resource ceilings. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowDeclaredLimits( + /** Maximum concurrently active subagents. */ + @JsonProperty("maxConcurrentSubagents") Long maxConcurrentSubagents, + /** Maximum total subagents spawned by the run. */ + @JsonProperty("maxTotalSubagents") Long maxTotalSubagents, + /** Maximum accumulated active execution time in seconds. */ + @JsonProperty("timeoutSeconds") Double timeoutSeconds, + /** Maximum AI credits consumed by subagents and descendants. */ + @JsonProperty("maxAiCredits") Double maxAiCredits +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowExecuteParams.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowExecuteParams.java new file mode 100644 index 0000000000..5c53ad155f --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowExecuteParams.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Parameters sent to the owning extension to execute a workflow closure. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowExecuteParams( + /** Target session identifier */ + @JsonProperty("sessionId") String sessionId, + /** Registered workflow name. */ + @JsonProperty("name") String name, + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Opaque token identifying this workflow execution attempt. */ + @JsonProperty("executionToken") String executionToken, + /** Workflow input value. */ + @JsonProperty("args") Object args +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowExecuteResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowExecuteResult.java new file mode 100644 index 0000000000..bdb92c4789 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowExecuteResult.java @@ -0,0 +1,30 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import com.github.copilot.CopilotExperimental; +import javax.annotation.processing.Generated; + +/** + * Result returned by an extension workflow closure. + * + * @apiNote This method is experimental and may change in a future version. + * @since 1.0.0 + */ +@CopilotExperimental +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowExecuteResult( + /** Workflow result value. */ + @JsonProperty("result") Object result +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowLogLine.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowLogLine.java new file mode 100644 index 0000000000..3338b9670f --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowLogLine.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * One ordered workflow progress line. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowLogLine( + /** Monotonic sequence number within the workflow run. */ + @JsonProperty("seq") Long seq, + /** Progress line kind. */ + @JsonProperty("kind") WorkflowLogLineKind kind, + /** Progress text. */ + @JsonProperty("text") String text +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowLogLineKind.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowLogLineKind.java new file mode 100644 index 0000000000..8f4d36e5e6 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowLogLineKind.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Kind of workflow progress line. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum WorkflowLogLineKind { + /** The {@code log} variant. */ + LOG("log"), + /** The {@code phase} variant. */ + PHASE("phase"); + + private final String value; + WorkflowLogLineKind(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static WorkflowLogLineKind fromValue(String value) { + for (WorkflowLogLineKind v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown WorkflowLogLineKind value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPauseCheckpointAction.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPauseCheckpointAction.java new file mode 100644 index 0000000000..9c034a66a9 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPauseCheckpointAction.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Action the runtime selected for a durable workflow pause checkpoint. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum WorkflowPauseCheckpointAction { + /** The {@code continue} variant. */ + CONTINUE("continue"), + /** The {@code pause} variant. */ + PAUSE("pause"); + + private final String value; + WorkflowPauseCheckpointAction(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static WorkflowPauseCheckpointAction fromValue(String value) { + for (WorkflowPauseCheckpointAction v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown WorkflowPauseCheckpointAction value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPhaseObservation.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPhaseObservation.java new file mode 100644 index 0000000000..1848365d8e --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPhaseObservation.java @@ -0,0 +1,51 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Durable lifecycle and timing for one workflow phase. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowPhaseObservation( + /** Phase identifier. */ + @JsonProperty("id") String id, + /** Zero-based declared phase ordinal, or null for an undeclared phase. */ + @JsonProperty("ordinal") Long ordinal, + /** Human-readable phase title. */ + @JsonProperty("title") String title, + /** Optional human-readable phase detail. */ + @JsonProperty("detail") String detail, + /** Derived lifecycle state of the phase. */ + @JsonProperty("status") WorkflowPhaseStatus status, + /** Most recent run attempt that entered this phase, or `0` if the phase has never been entered. */ + @JsonProperty("lastEnteredRunAttempt") Long lastEnteredRunAttempt, + /** Number of times execution entered this phase. */ + @JsonProperty("entryCount") Long entryCount, + /** Epoch milliseconds when this phase first started; for a skipped phase, the synthetic skip timestamp (equal to `completedAt`). */ + @JsonProperty("startedAt") Long startedAt, + /** Epoch milliseconds when this phase completed; for a skipped phase, the synthetic skip timestamp (equal to `startedAt`). */ + @JsonProperty("completedAt") Long completedAt, + /** Completed active time accumulated by this phase in milliseconds. */ + @JsonProperty("accumulatedActiveMs") Long accumulatedActiveMs, + /** Current live active time for this phase in milliseconds. */ + @JsonProperty("currentActiveMs") Long currentActiveMs, + /** Total direct agents associated with this phase. */ + @JsonProperty("totalAgentCount") Long totalAgentCount, + /** Direct agents in this phase that are currently live. */ + @JsonProperty("liveAgentCount") Long liveAgentCount +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPhaseStatus.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPhaseStatus.java new file mode 100644 index 0000000000..9029a3f410 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowPhaseStatus.java @@ -0,0 +1,39 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Derived lifecycle state of a workflow phase. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum WorkflowPhaseStatus { + /** The {@code pending} variant. */ + PENDING("pending"), + /** The {@code active} variant. */ + ACTIVE("active"), + /** The {@code completed} variant. */ + COMPLETED("completed"), + /** The {@code skipped} variant. */ + SKIPPED("skipped"); + + private final String value; + WorkflowPhaseStatus(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static WorkflowPhaseStatus fromValue(String value) { + for (WorkflowPhaseStatus v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown WorkflowPhaseStatus value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowProgressLine.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowProgressLine.java new file mode 100644 index 0000000000..bed10aebe1 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowProgressLine.java @@ -0,0 +1,37 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * One durable workflow progress record. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowProgressLine( + /** Global monotonic sequence number within the run. */ + @JsonProperty("seq") Long seq, + /** Resume attempt that emitted this record. */ + @JsonProperty("attempt") Long attempt, + /** Phase active when the record was emitted, or null before any phase. */ + @JsonProperty("phaseId") String phaseId, + /** Epoch milliseconds when the record was persisted. */ + @JsonProperty("recordedAt") Long recordedAt, + /** Progress record kind. */ + @JsonProperty("kind") WorkflowLogLineKind kind, + /** Prompt-safe progress text. */ + @JsonProperty("text") String text +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowProgressPage.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowProgressPage.java new file mode 100644 index 0000000000..733c0cfb86 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowProgressPage.java @@ -0,0 +1,38 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import java.util.List; +import javax.annotation.processing.Generated; + +/** + * A bidirectional page of workflow progress. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowProgressPage( + /** Progress records in sequence order. */ + @JsonProperty("records") List records, + /** Oldest sequence number in this page, or null when empty. */ + @JsonProperty("oldestSeq") Long oldestSeq, + /** Newest sequence number in this page, or null when empty. */ + @JsonProperty("newestSeq") Long newestSeq, + /** Whether progress records older than this page exist. */ + @JsonProperty("hasMoreOlder") Boolean hasMoreOlder, + /** Whether progress records newer than this page exist. */ + @JsonProperty("hasMoreNewer") Boolean hasMoreNewer, + /** Run revision reflected by this page. */ + @JsonProperty("revision") Long revision +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunConsumed.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunConsumed.java new file mode 100644 index 0000000000..db72711af2 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunConsumed.java @@ -0,0 +1,31 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Durable workflow resource consumption. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowRunConsumed( + /** Accumulated active execution time in milliseconds. */ + @JsonProperty("activeMs") Long activeMs, + /** Total subagents spawned by the run. */ + @JsonProperty("subagents") Long subagents, + /** AI usage consumed by the run in nano-AIU. */ + @JsonProperty("nanoAiu") Long nanoAiu +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunLimits.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunLimits.java new file mode 100644 index 0000000000..1bdf9dc877 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunLimits.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Wire-only per-invocation workflow resource ceiling overrides. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowRunLimits( + /** Maximum number of workflow subagents that may run concurrently. */ + @JsonProperty("maxConcurrentSubagents") Long maxConcurrentSubagents, + /** Maximum total number of workflow subagents that may be admitted. */ + @JsonProperty("maxTotalSubagents") Long maxTotalSubagents, + /** Maximum accumulated active-execution time in seconds. Active execution includes the entire extension body, subprocess waits, queued-agent waits, and sleeps; time between resumed attempts is not counted. */ + @JsonProperty("timeoutSeconds") Double timeoutSeconds, + /** Maximum AI credits consumed by workflow subagents and their descendants. The post-paid ceiling is soft: parallel turns can settle beyond it before the run stops. */ + @JsonProperty("maxAiCredits") Double maxAiCredits +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunOptions.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunOptions.java new file mode 100644 index 0000000000..2ab3115d4a --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunOptions.java @@ -0,0 +1,33 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Options controlling workflow invocation. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowRunOptions( + /** Per-invocation resource ceiling overrides. */ + @JsonProperty("limits") WorkflowRunLimits limits, + /** Whether to notify the originating session when the workflow completes. */ + @JsonProperty("notifyOnComplete") Boolean notifyOnComplete, + /** Whether to emit workflow phase names to the session transcript. */ + @JsonProperty("logPhaseNames") Boolean logPhaseNames, + /** Run identifier whose journal and progress should seed this resumed run. */ + @JsonProperty("resumeFromRunId") String resumeFromRunId +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunResult.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunResult.java new file mode 100644 index 0000000000..81ff204316 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunResult.java @@ -0,0 +1,43 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Complete current or terminal workflow run envelope. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowRunResult( + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. */ + @JsonProperty("attempt") Long attempt, + /** Current or terminal workflow run status. */ + @JsonProperty("status") WorkflowRunStatus status, + /** Completed workflow result. */ + @JsonProperty("result") Object result, + /** Error message for an errored run. */ + @JsonProperty("error") String error, + /** Machine-readable failure details for a halted or errored run. */ + @JsonProperty("failure") Object failure, + /** Reason for a halted or cancelled run. */ + @JsonProperty("reason") String reason, + /** Partial journal and progress snapshot for a halted, cancelled, or errored run. */ + @JsonProperty("snapshot") Object snapshot, + /** Structured pause initiator metadata for a paused attempt. */ + @JsonProperty("pauseInfo") Object pauseInfo +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunStatus.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunStatus.java new file mode 100644 index 0000000000..c207df880e --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunStatus.java @@ -0,0 +1,45 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import javax.annotation.processing.Generated; + +/** + * Current or terminal state of a workflow run. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +public enum WorkflowRunStatus { + /** The {@code pending} variant. */ + PENDING("pending"), + /** The {@code running} variant. */ + RUNNING("running"), + /** The {@code completed} variant. */ + COMPLETED("completed"), + /** The {@code halted} variant. */ + HALTED("halted"), + /** The {@code paused} variant. */ + PAUSED("paused"), + /** The {@code cancelled} variant. */ + CANCELLED("cancelled"), + /** The {@code error} variant. */ + ERROR("error"); + + private final String value; + WorkflowRunStatus(String value) { this.value = value; } + @com.fasterxml.jackson.annotation.JsonValue + public String getValue() { return value; } + @com.fasterxml.jackson.annotation.JsonCreator + public static WorkflowRunStatus fromValue(String value) { + for (WorkflowRunStatus v : values()) { + if (v.value.equals(value)) return v; + } + throw new IllegalArgumentException("Unknown WorkflowRunStatus value: " + value); + } +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunSummary.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunSummary.java new file mode 100644 index 0000000000..6c0288d616 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunSummary.java @@ -0,0 +1,65 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Durable workflow run summary with read-time live overlays. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowRunSummary( + /** Workflow run identifier. */ + @JsonProperty("runId") String runId, + /** Registered workflow name. */ + @JsonProperty("workflowName") String workflowName, + /** Human-readable workflow description. */ + @JsonProperty("description") String description, + /** Current workflow run status. */ + @JsonProperty("status") WorkflowRunStatus status, + /** Monotonic durable run revision. */ + @JsonProperty("revision") Long revision, + /** Epoch milliseconds when the run was created. */ + @JsonProperty("createdAt") Long createdAt, + /** Epoch milliseconds when execution first started, or null before start. */ + @JsonProperty("startedAt") Long startedAt, + /** Epoch milliseconds when the durable run was last updated. */ + @JsonProperty("updatedAt") Long updatedAt, + /** Epoch milliseconds when the run completed, or null while nonterminal. */ + @JsonProperty("completedAt") Long completedAt, + /** Current phase identity, or null before any phase is entered. */ + @JsonProperty("currentPhase") WorkflowCurrentPhase currentPhase, + /** Number of phases declared by the workflow. */ + @JsonProperty("declaredPhaseCount") Long declaredPhaseCount, + /** Number of direct workflow agents currently live. */ + @JsonProperty("liveAgentCount") Long liveAgentCount, + /** Total direct workflow agents spawned across all attempts. */ + @JsonProperty("totalSpawnedAgentCount") Long totalSpawnedAgentCount, + /** Durable resource consumption. */ + @JsonProperty("consumed") WorkflowRunConsumed consumed, + /** Resource ceilings declared by the workflow. */ + @JsonProperty("declaredLimits") WorkflowDeclaredLimits declaredLimits, + /** Approved effective resource ceilings, or null until approved. */ + @JsonProperty("approved") WorkflowDeclaredLimits approved, + /** Epoch milliseconds when this live-overlay snapshot was observed. */ + @JsonProperty("observedAt") Long observedAt, + /** Epoch milliseconds when the current active segment started, or null while inactive. */ + @JsonProperty("activeSegmentStartedAt") Long activeSegmentStartedAt, + /** Terminal run outcome, or null while nonterminal. */ + @JsonProperty("terminal") WorkflowRunTerminal terminal, + /** Whether the durable run state currently passes runtime resume eligibility checks. */ + @JsonProperty("canResume") Boolean canResume +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunTerminal.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunTerminal.java new file mode 100644 index 0000000000..6563df4001 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowRunTerminal.java @@ -0,0 +1,35 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Prompt-safe terminal workflow outcome. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowRunTerminal( + /** Human-readable terminal reason. */ + @JsonProperty("reason") String reason, + /** Machine-readable terminal failure. */ + @JsonProperty("failure") Object failure, + /** Human-readable terminal error. */ + @JsonProperty("error") String error, + /** Prompt-safe preview of the completed result. */ + @JsonProperty("resultPreview") String resultPreview, + /** Pause initiator metadata, or null when the run did not pause. */ + @JsonProperty("pauseInfo") Object pauseInfo +) { +} diff --git a/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowToolRunOptions.java b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowToolRunOptions.java new file mode 100644 index 0000000000..a14a606554 --- /dev/null +++ b/java/sdk/src/generated/java/com/github/copilot/generated/rpc/WorkflowToolRunOptions.java @@ -0,0 +1,29 @@ +/*--------------------------------------------------------------------------------------------- + * Copyright (c) Microsoft Corporation. All rights reserved. + *--------------------------------------------------------------------------------------------*/ + +// AUTO-GENERATED FILE - DO NOT EDIT +// Generated from: api.schema.json + +package com.github.copilot.generated.rpc; + +import com.fasterxml.jackson.annotation.JsonIgnoreProperties; +import com.fasterxml.jackson.annotation.JsonInclude; +import com.fasterxml.jackson.annotation.JsonProperty; +import javax.annotation.processing.Generated; + +/** + * Options for an internal tool-originated workflow invocation. + * + * @since 1.0.0 + */ +@javax.annotation.processing.Generated("copilot-sdk-codegen") +@JsonInclude(JsonInclude.Include.NON_NULL) +@JsonIgnoreProperties(ignoreUnknown = true) +public record WorkflowToolRunOptions( + /** Per-invocation resource ceiling overrides. */ + @JsonProperty("limits") WorkflowRunLimits limits, + /** Run identifier whose journal and progress should seed this resumed run. */ + @JsonProperty("resumeFromRunId") String resumeFromRunId +) { +} diff --git a/java/sdk/src/test/java/com/github/copilot/SessionEventDeserializationTest.java b/java/sdk/src/test/java/com/github/copilot/SessionEventDeserializationTest.java index 8d9b70a348..619ad627a3 100644 --- a/java/sdk/src/test/java/com/github/copilot/SessionEventDeserializationTest.java +++ b/java/sdk/src/test/java/com/github/copilot/SessionEventDeserializationTest.java @@ -9,6 +9,8 @@ import java.util.UUID; import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.ValueSource; import com.fasterxml.jackson.databind.ObjectMapper; @@ -32,6 +34,20 @@ private static SessionEvent parseJson(String json) throws Exception { return MAPPER.readValue(json, SessionEvent.class); } + private static String eventEnvelope(String type, String payload) { + return """ + { + "id": "00000000-0000-4000-8000-000000000001", + "timestamp": "2026-09-18T12:00:00Z", + "parentId": "00000000-0000-4000-8000-000000000002", + "agentId": "test-agent", + "ephemeral": true, + "type": "%s", + "data": %s + } + """.formatted(type, payload); + } + // ========================================================================= // Session Events // ========================================================================= @@ -113,6 +129,126 @@ void testParseSessionIdleEvent() throws Exception { assertEquals("session.idle", event.getType()); } + @ParameterizedTest + @ValueSource(strings = {""" + {"kind":"status","state":"ready"} + """, """ + {"kind":"startup","outcome":"skipped_disabled","fileCount":0, + "startupDurationMs":1.25,"forcedByEnv":false,"warmStart":false, + "disabledReason":"organization_policy_unknown","errorMessage":"startup diagnostic", + "eligible":false} + """, """ + {"kind":"server_error","errorType":"unexpected_exit","exitCode":0, + "errorMessage":"server diagnostic"} + """, """ + {"kind":"incremental","phase":"updated","changedFileCount":0, + "addedFileCount":2,"deletedFileCount":1,"totalChangeCount":3, + "walkDurationMs":0,"updateDurationMs":2.5,"totalDurationMs":3.75} + """}) + void testIndexedSearchFullEnvelopeRoundTrip(String payload) throws Exception { + String json = eventEnvelope("session.indexed_search", payload); + + var event = assertInstanceOf(SessionIndexedSearchEvent.class, parseJson(json)); + var data = assertInstanceOf(SessionIndexedSearchEvent.SessionIndexedSearchEventData.class, event.getData()); + var expected = MAPPER.readTree(json); + assertEquals(expected.get("data"), data.raw()); + assertEquals(expected.get("data"), MAPPER.valueToTree(data)); + var serialized = MAPPER.writeValueAsString(event); + assertEquals(expected, MAPPER.readTree(serialized)); + var reparsed = assertInstanceOf(SessionIndexedSearchEvent.class, parseJson(serialized)); + assertEquals(data, reparsed.getData()); + } + + @ParameterizedTest + @ValueSource(strings = {""" + {"kind":"policy_resolved","control":"filesystem","outcome":"degraded","toolCallId":null, + "platform":"linux","backend":"bubblewrap","policySource":"user_policy", + "enforcementPoint":"shell","readwritePathsCount":1,"readonlyPathsCount":0,"deniedPathsCount":1, + "addCurrentWorkingDirectory":false,"allowOutbound":false,"allowLocalNetwork":false, + "proxyMode":"none","allowBypass":false,"gitAuth":false,"ghAuth":false,"keychainAccess":false, + "effectiveFilesystemPolicy":{"readwritePaths":["/workspace"],"readonlyPaths":[], + "deniedPaths":["/private"]},"degradationReason":"denied_paths_unsupported"} + """, """ + {"kind":"spawn_completed","control":"process","outcome":"succeeded","toolCallId":"tool-spawn", + "platform":"macos","backend":"seatbelt","enforcementPoint":"shell","durationMs":1.25, + "degradationReason":null} + """, """ + {"kind":"enforcement_state","control":"process","outcome":"engaged","toolCallId":"tool-state", + "platform":"windows","backend":"process_container","enforcementPoint":"shell", + "attestation":"spawn_succeeded","command":"echo example"} + """, """ + {"kind":"access_denied","control":"filesystem","outcome":"denied","toolCallId":"tool-denied", + "platform":"linux","enforcementPoint":"builtin_filesystem","denialClass":"filesystem_read", + "attestation":"builtin_policy_checked","confidence":"policy_corroborated", + "deniedResource":"/private/example.txt","command":null,"processName":"example"} + """, """ + {"kind":"bypass_decided","control":"bypass","outcome":"declined","toolCallId":"tool-bypass", + "platform":"macos","enforcementPoint":"shell","source":"user_prompted", + "denialClass":"network_outbound","confidence":"captured","deniedResource":"example.invalid", + "command":"example --network","processName":"example"} + """, """ + {"kind":"permissive_retry_decided","control":"bypass","outcome":"approved", + "toolCallId":"tool-retry","platform":"linux","enforcementPoint":"shell", + "source":"model_requested","denialClass":"filesystem_write","confidence":"sandbox_reported", + "deniedResource":"/workspace/example.txt","command":"example --write","processName":"example"} + """, """ + {"kind":"permissive_retry_completed","control":"process","outcome":"succeeded", + "toolCallId":"tool-retry","platform":"linux","enforcementPoint":"shell", + "denialClass":null,"confidence":null,"deniedResource":null,"command":"example --write", + "processName":"example"} + """}) + void testSandboxDecisionFullEnvelopeRoundTrip(String payload) throws Exception { + String json = eventEnvelope("sandbox.decision", payload); + var event = assertInstanceOf(SandboxDecisionEvent.class, parseJson(json)); + var data = assertInstanceOf(SandboxDecisionEvent.SandboxDecisionEventData.class, event.getData()); + var expected = MAPPER.readTree(json); + assertEquals(expected.get("data"), data.raw()); + assertEquals(expected.get("data"), MAPPER.valueToTree(data)); + var serialized = MAPPER.writeValueAsString(event); + assertEquals(expected, MAPPER.readTree(serialized)); + var reparsed = assertInstanceOf(SandboxDecisionEvent.class, parseJson(serialized)); + assertEquals(data, reparsed.getData()); + } + + @Test + void testOrdinaryObjectFullEnvelopeRoundTrip() throws Exception { + String json = eventEnvelope("session.info", """ + {"infoType":"status","message":"Processing request"} + """); + var event = assertInstanceOf(SessionInfoEvent.class, parseJson(json)); + var data = assertInstanceOf(SessionInfoEvent.SessionInfoEventData.class, event.getData()); + assertEquals("status", data.infoType()); + assertEquals("Processing request", data.message()); + var serialized = MAPPER.writeValueAsString(event); + assertEquals(MAPPER.readTree(json), MAPPER.readTree(serialized)); + assertEquals(data, assertInstanceOf(SessionInfoEvent.class, parseJson(serialized)).getData()); + } + + @Test + void testEmptyObjectFullEnvelopeRoundTrip() throws Exception { + String json = eventEnvelope("session.todos_changed", "{}"); + var event = assertInstanceOf(SessionTodosChangedEvent.class, parseJson(json)); + var data = assertInstanceOf(SessionTodosChangedEvent.SessionTodosChangedEventData.class, event.getData()); + assertEquals(new SessionTodosChangedEvent.SessionTodosChangedEventData(), data); + assertEquals("{}", MAPPER.writeValueAsString(data)); + var serialized = MAPPER.writeValueAsString(event); + assertEquals(MAPPER.readTree(json), MAPPER.readTree(serialized)); + assertEquals(data, assertInstanceOf(SessionTodosChangedEvent.class, parseJson(serialized)).getData()); + } + + @Test + void testRootUnionDataNoArgConstructors() throws Exception { + var indexedSearch = new SessionIndexedSearchEvent(); + indexedSearch.setData(new SessionIndexedSearchEvent.SessionIndexedSearchEventData()); + assertEquals(MAPPER.readTree("{}"), indexedSearch.getData().raw()); + assertEquals("{}", MAPPER.writeValueAsString(indexedSearch.getData())); + + var sandboxDecision = new SandboxDecisionEvent(); + sandboxDecision.setData(new SandboxDecisionEvent.SandboxDecisionEventData()); + assertEquals(MAPPER.readTree("{}"), sandboxDecision.getData().raw()); + assertEquals("{}", MAPPER.writeValueAsString(sandboxDecision.getData())); + } + @Test void testManagedSettingsResolvedClientProvenance() throws Exception { assertEquals("server", ManagedSettingsResolvedSource.SERVER.getValue()); @@ -2600,11 +2736,16 @@ void testParseSessionTaskCompleteEvent() throws Exception { var castedEvent = (SessionTaskCompleteEvent) event; assertNotNull(castedEvent.getData()); assertEquals("Task completed successfully", castedEvent.getData().summary()); + assertNull(castedEvent.getData().blocker()); // Verify setData round-trip - castedEvent.setData( - new SessionTaskCompleteEvent.SessionTaskCompleteEventData("New summary", null, null, null, null)); + castedEvent.setData(new SessionTaskCompleteEvent.SessionTaskCompleteEventData("New summary", true, + TaskCompletionOutcome.COMPLETED, null, 42L, null)); assertEquals("New summary", castedEvent.getData().summary()); + assertTrue(castedEvent.getData().success()); + assertEquals(TaskCompletionOutcome.COMPLETED, castedEvent.getData().outcome()); + assertEquals(42L, castedEvent.getData().objectiveId()); + assertNull(castedEvent.getData().blocker()); } @Test diff --git a/java/sdk/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcApiCoverageTest.java b/java/sdk/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcApiCoverageTest.java index 7e89457df1..ed5150a1a5 100644 --- a/java/sdk/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcApiCoverageTest.java +++ b/java/sdk/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcApiCoverageTest.java @@ -10,9 +10,15 @@ import java.util.List; import java.util.Map; import java.util.concurrent.CompletableFuture; +import java.util.function.BiFunction; +import java.util.stream.Stream; import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.MethodSource; +import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.node.ObjectNode; /** @@ -40,6 +46,182 @@ public CompletableFuture invoke(String method, Object params, Class re } } + @ParameterizedTest(name = "{0}") + @MethodSource("newRpcDispatches") + void newRpcEndpoints_dispatch_expected_method_params_and_result_type(String expectedMethod, + Class expectedResultType, String expectedParams, + BiFunction> invoke) throws Exception { + var stub = new StubCaller(); + invoke.apply(new ServerRpc(stub), new SessionRpc(stub, "bound-session")).join(); + + assertEquals(1, stub.calls.size()); + var call = stub.calls.get(0); + assertEquals(expectedMethod, call.method()); + assertEquals(expectedResultType, call.resultType()); + var mapper = new ObjectMapper(); + assertEquals(mapper.readTree(expectedParams), mapper.readTree(mapper.writeValueAsString(call.params()))); + } + + static Stream newRpcDispatches() { + return Stream.of( + dispatch("catalog.select", CatalogSelectionResult.class, """ + {"contract":{"protocolVersion":3,"requiredCapabilities":["catalog-selection"]}, + "sessionId":"catalog-session","selectionRef":"selection-1","outcome":"selected"} + """, + (server, session) -> server.catalog.select( + new CatalogSelectParams(new CatalogClientContract(3L, List.of("catalog-selection")), + "catalog-session", "selection-1", CatalogSelectionDecision.SELECTED))), + dispatch("session.managedSettings.get", SessionManagedSettingsGetResult.class, """ + {"sessionId":"bound-session"} + """, (server, session) -> session.managedSettings.get()), + dispatch("session.plugins.install", SessionPluginsInstallResult.class, """ + {"sessionId":"bound-session","source":"plugin@market"} + """, + (server, session) -> session.plugins + .install(new SessionPluginsInstallParams("foreign-session", "plugin@market"))), + dispatch("session.plugins.uninstall", Void.class, """ + {"sessionId":"bound-session","name":"plugin","directSourceId":"source-1"} + """, + (server, session) -> session.plugins + .uninstall(new SessionPluginsUninstallParams("foreign-session", "plugin", "source-1"))), + dispatch("session.plugins.update", SessionPluginsUpdateResult.class, """ + {"sessionId":"bound-session","name":"plugin@market"} + """, + (server, session) -> session.plugins + .update(new SessionPluginsUpdateParams("foreign-session", "plugin@market"))), + dispatch("session.plugins.enable", Void.class, """ + {"sessionId":"bound-session","names":["first@market","second@market"]} + """, + (server, session) -> session.plugins.enable(new SessionPluginsEnableParams("foreign-session", + List.of("first@market", "second@market")))), + dispatch("session.plugins.disable", Void.class, """ + {"sessionId":"bound-session","names":["plugin@market"]} + """, + (server, session) -> session.plugins + .disable(new SessionPluginsDisableParams("foreign-session", List.of("plugin@market")))), + dispatch("session.plugins.marketplaces.list", SessionPluginsMarketplacesListResult.class, """ + {"sessionId":"bound-session"} + """, (server, session) -> session.plugins.marketplaces.list()), + dispatch("session.plugins.marketplaces.add", SessionPluginsMarketplacesAddResult.class, """ + {"sessionId":"bound-session","source":"./market","workingDirectory":"/workspace"} + """, + (server, session) -> session.plugins.marketplaces.add( + new SessionPluginsMarketplacesAddParams("foreign-session", "./market", "/workspace"))), + dispatch("session.plugins.marketplaces.remove", SessionPluginsMarketplacesRemoveResult.class, """ + {"sessionId":"bound-session","name":"market","force":true} + """, + (server, session) -> session.plugins.marketplaces + .remove(new SessionPluginsMarketplacesRemoveParams("foreign-session", "market", true))), + dispatch("session.plugins.marketplaces.browse", SessionPluginsMarketplacesBrowseResult.class, """ + {"sessionId":"bound-session","name":"market"} + """, + (server, session) -> session.plugins.marketplaces + .browse(new SessionPluginsMarketplacesBrowseParams("foreign-session", "market"))), + dispatch("session.plugins.marketplaces.refresh", SessionPluginsMarketplacesRefreshResult.class, """ + {"sessionId":"bound-session","name":"market"} + """, + (server, session) -> session.plugins.marketplaces + .refresh(new SessionPluginsMarketplacesRefreshParams("foreign-session", "market"))), + dispatch("session.plugins.marketplaces.refresh", SessionPluginsMarketplacesRefreshResult.class, """ + {"sessionId":"bound-session"} + """, (server, session) -> session.plugins.marketplaces.refresh(null)), + dispatch("session.queue.withdrawMessage", SessionQueueWithdrawMessageResult.class, """ + {"sessionId":"bound-session","messageId":"message-1","expectedPrompt":"original"} + """, + (server, session) -> session.queue.withdrawMessage( + new SessionQueueWithdrawMessageParams("foreign-session", "message-1", "original"))), + dispatch("session.queue.appendSteering", SessionQueueAppendSteeringResult.class, """ + {"sessionId":"bound-session","messageId":"message-1","expectedPrompt":"original", + "agentMode":"interactive","prompt":"more","displayPrompt":"preview","attachments":[]} + """, (server, + session) -> session.queue.appendSteering(new SessionQueueAppendSteeringParams("foreign-session", + "message-1", "original", SendAgentMode.INTERACTIVE, "more", "preview", List.of()))), + dispatch("session.workflow.run", SessionWorkflowRunResult.class, """ + {"sessionId":"bound-session","name":"workflow-1","args":{"topic":"input"}} + """, + (server, session) -> session.workflow.run(new SessionWorkflowRunParams("foreign-session", + "workflow-1", Map.of("topic", "input"), null))), + dispatch("session.workflow.resume", SessionWorkflowResumeResult.class, """ + {"sessionId":"bound-session","runId":"run-1","notifyOnComplete":true,"logPhaseNames":false} + """, + (server, session) -> session.workflow.resume( + new SessionWorkflowResumeParams("foreign-session", "run-1", null, true, false))), + dispatch("session.workflow.runFromTool", SessionWorkflowRunFromToolResult.class, """ + {"sessionId":"bound-session","name":"workflow-1","args":{"topic":"input"},"toolCallId":"tool-1"} + """, + (server, session) -> session.workflow.runFromTool(new SessionWorkflowRunFromToolParams( + "foreign-session", "workflow-1", Map.of("topic", "input"), null, "tool-1"))), + dispatch("session.workflow.resumeFromTool", SessionWorkflowResumeFromToolResult.class, """ + {"sessionId":"bound-session","runId":"run-1","toolCallId":"tool-1"} + """, + (server, session) -> session.workflow.resumeFromTool( + new SessionWorkflowResumeFromToolParams("foreign-session", "run-1", null, "tool-1"))), + dispatch("session.workflow.getRun", SessionWorkflowGetRunResult.class, """ + {"sessionId":"bound-session","runId":"run-1"} + """, + (server, session) -> session.workflow + .getRun(new SessionWorkflowGetRunParams("foreign-session", "run-1"))), + dispatch("session.workflow.listRuns", SessionWorkflowListRunsResult.class, """ + {"sessionId":"bound-session","afterSeq":2,"limit":5} + """, + (server, session) -> session.workflow + .listRuns(new SessionWorkflowListRunsParams("foreign-session", 2L, null, 5L))), + dispatch("session.workflow.getRunDetail", SessionWorkflowGetRunDetailResult.class, """ + {"sessionId":"bound-session","runId":"run-1"} + """, + (server, session) -> session.workflow + .getRunDetail(new SessionWorkflowGetRunDetailParams("foreign-session", "run-1"))), + dispatch("session.workflow.getRunProgress", SessionWorkflowGetRunProgressResult.class, """ + {"sessionId":"bound-session","runId":"run-1","phaseId":"phase-1","afterSeq":2,"limit":5} + """, + (server, session) -> session.workflow.getRunProgress(new SessionWorkflowGetRunProgressParams( + "foreign-session", "run-1", "phase-1", 2L, null, 5L))), + dispatch("session.workflow.cancel", SessionWorkflowCancelResult.class, """ + {"sessionId":"bound-session","runId":"run-1"} + """, + (server, session) -> session.workflow + .cancel(new SessionWorkflowCancelParams("foreign-session", "run-1"))), + dispatch("session.workflow.pause", SessionWorkflowPauseResult.class, """ + {"sessionId":"bound-session","runId":"run-1"} + """, + (server, session) -> session.workflow + .pause(new SessionWorkflowPauseParams("foreign-session", "run-1"))), + dispatch("session.workflow.pauseAtCheckpoint", SessionWorkflowPauseAtCheckpointResult.class, + """ + {"sessionId":"bound-session","runId":"run-1","executionToken":"execution-1","key":"checkpoint-1"} + """, + (server, session) -> session.workflow + .pauseAtCheckpoint(new SessionWorkflowPauseAtCheckpointParams("foreign-session", + "run-1", "execution-1", "checkpoint-1"))), + dispatch("session.workflow.log", Void.class, """ + {"sessionId":"bound-session","runId":"run-1","executionToken":"execution-1", + "lines":[{"seq":1,"kind":"log","text":"progress"}]} + """, (server, + session) -> session.workflow.log(new SessionWorkflowLogParams("foreign-session", "run-1", + "execution-1", List.of(new WorkflowLogLine(1L, WorkflowLogLineKind.LOG, "progress"))))), + dispatch("session.workflow.agent", SessionWorkflowAgentResult.class, + """ + {"sessionId":"bound-session","workflowRunId":"run-1","executionToken":"execution-1","prompt":"inspect"} + """, + (server, session) -> session.workflow.agent(new SessionWorkflowAgentParams("foreign-session", + "run-1", "execution-1", "inspect", null))), + dispatch("session.workflow.journal.get", SessionWorkflowJournalGetResult.class, """ + {"sessionId":"bound-session","runId":"run-1","executionToken":"execution-1","key":"journal-1"} + """, + (server, session) -> session.workflow.journal.get(new SessionWorkflowJournalGetParams( + "foreign-session", "run-1", "execution-1", "journal-1"))), + dispatch("session.workflow.journal.put", Void.class, """ + {"sessionId":"bound-session","runId":"run-1","executionToken":"execution-1","key":"journal-1", + "resultJson":{"answer":42}} + """, (server, session) -> session.workflow.journal.put(new SessionWorkflowJournalPutParams( + "foreign-session", "run-1", "execution-1", "journal-1", Map.of("answer", 42))))); + } + + private static Arguments dispatch(String method, Class resultType, String expectedParams, + BiFunction> invoke) { + return Arguments.of(method, resultType, expectedParams, invoke); + } + // ── ServerRpc additional methods ─────────────────────────────────────── @Test diff --git a/java/sdk/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcRecordsCoverageTest.java b/java/sdk/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcRecordsCoverageTest.java index 648709722a..51827080b5 100644 --- a/java/sdk/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcRecordsCoverageTest.java +++ b/java/sdk/src/test/java/com/github/copilot/generated/rpc/GeneratedRpcRecordsCoverageTest.java @@ -10,8 +10,13 @@ import java.util.List; import java.util.Map; import java.util.UUID; +import java.util.function.Function; +import java.util.stream.Stream; import org.junit.jupiter.api.Test; +import org.junit.jupiter.params.ParameterizedTest; +import org.junit.jupiter.params.provider.Arguments; +import org.junit.jupiter.params.provider.MethodSource; import com.fasterxml.jackson.databind.ObjectMapper; import com.github.copilot.TestUtil; @@ -546,6 +551,102 @@ void sessionUsageGetMetricsParams_record() { // ── Result records ───────────────────────────────────────────────────── + @ParameterizedTest + @MethodSource("catalogSearchSharedErrors") + void catalogSearchResult_shared_errors_round_trip(Class subtype, String json) + throws Exception { + assertSame(CatalogSearchResult.class, subtype.getSuperclass()); + assertCatalogErrorRoundTrip(CatalogSearchResult.class, subtype, json, CatalogSearchResult::getKind); + } + + static Stream catalogSearchSharedErrors() { + return Stream.of(Arguments.of(CatalogNegotiationRefusedError.class, catalogNegotiationRefusedJson()), + Arguments.of(CatalogInvalidRequestError.class, """ + {"kind":"invalid-request","field":"query","message":"A query is required"} + """), Arguments.of(CatalogUnavailableError.class, """ + {"kind":"unavailable","reason":"search-unavailable","message":"Search is unavailable"} + """)); + } + + @ParameterizedTest + @MethodSource("catalogSelectionSharedErrors") + void catalogSelectionResult_shared_errors_round_trip(Class subtype, String json) + throws Exception { + assertCatalogErrorRoundTrip(CatalogSelectionResult.class, subtype, json, CatalogSelectionResult::getKind); + } + + static Stream catalogSelectionSharedErrors() { + return Stream.of( + Arguments.of(CatalogSelectionResultCatalogNegotiationRefusedError.class, + catalogNegotiationRefusedJson()), + Arguments.of(CatalogSelectionResultCatalogInvalidRequestError.class, """ + {"kind":"invalid-request","field":"selectionRef","message":"A selection reference is required"} + """), Arguments.of(CatalogSelectionResultCatalogUnavailableError.class, """ + {"kind":"unavailable","reason":"selection-unavailable","message":"Selection is unavailable"} + """)); + } + + @ParameterizedTest + @MethodSource("mcpPlanInstallSharedErrors") + void mcpPlanInstallResult_shared_errors_round_trip(Class subtype, String json) + throws Exception { + assertCatalogErrorRoundTrip(McpPlanInstallResult.class, subtype, json, McpPlanInstallResult::getKind); + } + + static Stream mcpPlanInstallSharedErrors() { + return Stream.of( + Arguments.of(McpPlanInstallResultCatalogNegotiationRefusedError.class, catalogNegotiationRefusedJson()), + Arguments.of(McpPlanInstallResultCatalogInvalidRequestError.class, """ + {"kind":"invalid-request","field":"card","message":"A card is required"} + """), Arguments.of(McpPlanInstallResultCatalogAuthenticationRequiredError.class, """ + {"kind":"authentication-required","reason":"credential-expired","message":"Sign in again"} + """), Arguments.of(McpPlanInstallResultCatalogPolicyRejectedError.class, """ + {"kind":"policy-rejected","source":"enterprise-allowlist","message":"Installation is blocked"} + """), Arguments.of(McpPlanInstallResultCatalogNetworkFailureError.class, """ + {"kind":"network-failure","reason":"rate-limited","statusCode":429, + "retryAfterSeconds":30,"message":"Retry later"} + """), Arguments.of(McpPlanInstallResultCatalogUnsafeRetrievalError.class, """ + {"kind":"unsafe-retrieval","reason":"blocked-address","message":"Retrieval is blocked"} + """), Arguments.of(McpPlanInstallResultCatalogMalformedCardError.class, """ + {"kind":"malformed-card","reason":"schema-violation", + "mediaType":"application/mcp-server-card+json","message":"The card does not match its schema"} + """), Arguments.of(McpPlanInstallResultCatalogContractViolationError.class, """ + {"kind":"contract-violation","reason":"both-url-and-data","message":"Use one card source"} + """), Arguments.of(McpPlanInstallResultCatalogUnavailableError.class, """ + {"kind":"unavailable","reason":"planning-unavailable","message":"Planning is unavailable"} + """)); + } + + private static String catalogNegotiationRefusedJson() { + return """ + {"kind":"negotiation-refused","reason":"unsupported-capability","runtimeProtocolVersion":3, + "minimumSupportedProtocolVersion":3, + "supportedCapabilities":["mcp-server-card","legacy-mcp-server-card","ai-skill-discovery", + "agent-plugin-discovery","mcp-install-planning"], + "unsupportedCapabilities":["catalog-selection"],"message":"The required capability is unavailable"} + """; + } + + private static void assertCatalogErrorRoundTrip(Class root, Class subtype, String json, + Function kind) throws Exception { + var mapper = new ObjectMapper(); + var expected = mapper.readTree(json); + assertTrue(root.isAssignableFrom(subtype)); + + var result = mapper.readValue(json, root); + assertInstanceOf(root, result); + assertEquals(subtype, result.getClass()); + assertEquals(expected.get("kind").asText(), kind.apply(result)); + + var serialized = mapper.writeValueAsString(result); + assertEquals(expected, mapper.readTree(serialized)); + var roundTripped = mapper.readValue(serialized, root); + assertInstanceOf(root, roundTripped); + assertEquals(subtype, roundTripped.getClass()); + assertEquals(expected.get("kind").asText(), kind.apply(roundTripped)); + assertEquals(expected, mapper.readTree(mapper.writeValueAsString(roundTripped))); + } + @Test void pingResult_fields() { var ts = OffsetDateTime.now(); @@ -755,7 +856,9 @@ void sessionModelGetCurrentResult_record() { @Test void sessionModelSwitchToResult_record() { - var result = new SessionModelSwitchToResult("gpt-5", true, null, null, null, null, null, null, null); + var result = new SessionModelSwitchToResult("queue-model-1", "gpt-5", true, null, null, null, null, null, null, + null); + assertEquals("queue-model-1", result.queueId()); assertEquals("gpt-5", result.modelId()); assertEquals(true, result.deferred()); } @@ -777,13 +880,20 @@ void sessionPlanReadResult_record() { @Test void sessionPluginsListResult_nested() { - var plugin = new Plugin("my-plugin", "marketplace-x", "1.2.3", true); + var plugin = new Plugin("my-plugin", "marketplace-x", "1.2.3", true, null, "/marketplaces/marketplace-x", null, + true, true, true); var result = new SessionPluginsListResult(List.of(plugin)); assertEquals(1, result.plugins().size()); assertEquals("my-plugin", result.plugins().get(0).name()); assertEquals("marketplace-x", result.plugins().get(0).marketplace()); assertEquals("1.2.3", result.plugins().get(0).version()); assertTrue(result.plugins().get(0).enabled()); + assertNull(result.plugins().get(0).directSourceId()); + assertEquals("/marketplaces/marketplace-x", result.plugins().get(0).installedFrom()); + assertNull(result.plugins().get(0).source()); + assertTrue(result.plugins().get(0).managed()); + assertTrue(result.plugins().get(0).managedDesiredEnabled()); + assertTrue(result.plugins().get(0).installed()); } @Test diff --git a/nodejs/package.json b/nodejs/package.json index 440c533d7d..8ea4551eae 100644 --- a/nodejs/package.json +++ b/nodejs/package.json @@ -5,7 +5,7 @@ "url": "https://github.com/github/copilot-sdk.git" }, "version": "0.0.0-dev", - "copilotCliVersion": "1.0.86-0", + "copilotCliVersion": "1.0.87-0", "description": "TypeScript SDK for programmatic control of GitHub Copilot CLI via JSON-RPC", "main": "./dist/cjs/index.js", "types": "./dist/index.d.ts", diff --git a/nodejs/src/cliVersion.ts b/nodejs/src/cliVersion.ts index 3eb4b744ab..5524be8340 100644 --- a/nodejs/src/cliVersion.ts +++ b/nodejs/src/cliVersion.ts @@ -1,3 +1,3 @@ -export const COPILOT_CLI_VERSION = "1.0.86-0"; +export const COPILOT_CLI_VERSION = "1.0.87-0"; export const COPILOT_CLI_USE_NPM_PACKAGE = false; diff --git a/nodejs/src/generated/rpc.ts b/nodejs/src/generated/rpc.ts index b0bbbb56e4..7d517cb9e6 100644 --- a/nodejs/src/generated/rpc.ts +++ b/nodejs/src/generated/rpc.ts @@ -5,7 +5,7 @@ import type { MessageConnection } from "vscode-jsonrpc/node.js"; -import type { AbortReason, AgentModelPolicy, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerMetadata, McpServerSource, McpServerStatus, ModelChangeSource, PermissionDecisionSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, RemediationAction, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompleteData, TaskCompletionOutcome, UserToolSessionApproval, Verbosity } from "./session-events.js"; +import type { AbortReason, AgentModelPolicy, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, IndexedSearchState, ManagedSettingsResolvedData, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerMetadata, McpServerSource, McpServerStatus, ModelChangeSource, PermissionDecisionSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, RemediationAction, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompleteData, TaskCompletionOutcome, UserToolSessionApproval, Verbosity } from "./session-events.js"; /** A value that can be represented losslessly on the SDK JSON wire. */ export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue }; @@ -349,13 +349,53 @@ export type CardDigestAlgorithm = /** SHA-256 over RFC 8785 canonical JSON encod /** @experimental */ export type CardDigestValue = string; /** - * Where a candidate's card came from. Exactly one of a URL or embedded data: the union has no variant carrying both, and no variant carrying neither, so the rule holds structurally rather than by validation. + * Discriminator for an Agent Plugin candidate * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "CatalogCandidateSource". + * via the `definition` "CatalogAgentPluginCandidateKind". */ /** @experimental */ -export type CatalogCandidateSource = CatalogCandidateSourceUrl | CatalogCandidateSourceEmbedded; +export type CatalogAgentPluginCandidateKind = /** An Agent Plugin. */ "plugin"; +/** + * Canonical Agent Plugin media type + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogAgentPluginMediaType". + */ +/** @experimental */ +export type CatalogAgentPluginMediaType = + /** A GitHub Copilot Agent Plugin descriptor. */ + "application/vnd.github.copilot-plugin"; +/** + * Canonical catalogue resource identity. The runtime rewrites accepted urn:ai and urn:air identifiers to urn:air, lowercases the authority, and preserves the remaining resource components. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogResourceIdentity". + */ +/** @experimental */ +export type CatalogResourceIdentity = string; +/** + * Bounded source-declared resource version, preserved exactly after validation and never inferred. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogResourceVersion". + */ +/** @experimental */ +export type CatalogResourceVersion = string; +/** + * Explicit Agent Plugin compatibility declared by exact catalog tags. Clients must not infer these values from display text or other metadata. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogAgentPluginCompatibilityTag". + */ +/** @experimental */ +export type CatalogAgentPluginCompatibilityTag = + /** The plugin contributes at least one GitHub Copilot Canvas. */ + | "canvas" + /** The plugin depends on Canvas for its intended functionality. */ + | "canvas-only" + /** The plugin targets GitHub Copilot. */ + | "github-copilot"; /** * A versioned, bounded trust observation carried unchanged with a catalog candidate and its private handle context. Current observations require a recognised T1/T2 tier; every non-current state structurally forbids a tier. Eligibility remains `unknown` while Agent Finder supplies no exposure decision, and states absent from its current wire are never inferred from age, relevance, popularity, or a tier transition. * @@ -481,6 +521,38 @@ export type CatalogTrustSnapshotUnsupportedStatus = export type CatalogTrustSnapshotMalformedStatus = /** The trust field was empty, unbounded, or had the wrong JSON type. */ "malformed"; +/** + * Discriminator for an AI skill candidate + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogAiSkillCandidateKind". + */ +/** @experimental */ +export type CatalogAiSkillCandidateKind = /** An AI skill. */ "ai-skill"; +/** + * Canonical AI skill media type + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogAiSkillMediaType". + */ +/** @experimental */ +export type CatalogAiSkillMediaType = /** An AI skill card. */ "application/ai-skill"; +/** + * Typed non-installable state for an AI skill candidate + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogAiSkillInstallability". + */ +/** @experimental */ +export type CatalogAiSkillInstallability = /** AI skills are discovery-only on this surface. */ "not-installable-kind"; +/** + * Where a candidate's card came from. Exactly one of a URL or embedded data: the union has no variant carrying both, and no variant carrying neither, so the rule holds structurally rather than by validation. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogCandidateSource". + */ +/** @experimental */ +export type CatalogCandidateSource = CatalogCandidateSourceUrl | CatalogCandidateSourceEmbedded; /** * Why the catalog authority did not accept the caller's identity * @@ -496,13 +568,21 @@ export type CatalogAuthenticationRequiredReason = /** A credential was presented and the authority refused it, for example because it was revoked, malformed, or issued for another audience. Refreshing the same rejected credential is not useful; the caller must sign in again. */ | "credential-rejected"; /** - * One inert catalog result, represented as an MCP server or discovery-only AI skill variant so kind, media type, provenance, and installability cannot contradict each other. + * One inert catalog result, represented as an MCP server, discovery-only AI skill, or opt-in Agent Plugin variant so kind, media type, provenance, and available operations cannot contradict each other. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema * via the `definition` "CatalogCandidate". */ /** @experimental */ -export type CatalogCandidate = CatalogMcpServerCandidate | CatalogAiSkillCandidate; +export type CatalogCandidate = CatalogMcpServerCandidate | CatalogAiSkillCandidate | CatalogAgentPluginCandidate; +/** + * Discriminator for an MCP server candidate + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogMcpServerCandidateKind". + */ +/** @experimental */ +export type CatalogMcpServerCandidateKind = /** An MCP server. */ "mcp-server"; /** * JSON MCP card media type accepted for install planning * @@ -538,7 +618,9 @@ export type CatalogCandidateKind = /** An MCP server, which can be planned for installation. */ | "mcp-server" /** An AI skill, which is discoverable but not installable through this surface. */ - | "ai-skill"; + | "ai-skill" + /** An inert Agent Plugin candidate, available only when explicitly requested. */ + | "plugin"; /** * A wire feature a caller can require of the catalog surface, negotiated per request. A grant means the runtime understands the feature's contract, not that the deployment has enabled the operation; typed unavailable results report availability separately. * @@ -553,12 +635,18 @@ export type CatalogCapability = | "legacy-mcp-server-card" /** Understands `application/ai-skill` candidates as discovery-only and typed non-installable. */ | "ai-skill-discovery" + /** Understands opt-in `application/vnd.github.copilot-plugin` candidates and their typed identity, version, source, and compatibility fields. */ + | "agent-plugin-discovery" /** Understands side-effect-free MCP install-plan requests, results, and plan handles; `planning-unavailable` separately reports that planning is not enabled. */ | "mcp-install-planning" /** Understands plans that enumerate every eligible transport rather than a single preferred one. */ | "multiple-transport-choice" + /** Understands explicit numbered navigation and authority-reported pagination metadata with opaque tokens. Advertised and granted only when requested. */ + | "catalog-search-pagination" /** Understands versioned candidate trust snapshots. Protocol-3 callers must require this capability before the runtime adds the optional snapshot field. */ - | "trust-snapshot"; + | "trust-snapshot" + /** Understands exact candidate selection through model-safe opaque references and host-only candidate-handle hand-off. */ + | "catalog-selection"; /** * Bounded extensible wire-feature identifier. Known values are described by `CatalogCapability`; newer callers may send future identifiers so an older runtime can return a typed negotiation refusal instead of failing schema validation. Capability negotiation establishes contract understanding, while each operation's result separately reports runtime availability. * @@ -579,7 +667,7 @@ export type CatalogContractViolationReason = | "both-url-and-data" /** A result carried neither a URL nor embedded data, when exactly one is required. */ | "neither-url-nor-data" - /** Two results claimed the same normalised identity. */ + /** Two results claimed the same collision key: normalised identity for existing kinds, or normalised identity and declared version for Agent Plugins. */ | "duplicate-identity" /** A result declared no media type, or one this contract does not model. */ | "unknown-media-type"; @@ -594,7 +682,9 @@ export type CatalogHandleType = /** A search candidate handle. */ | "candidate" /** An install plan handle. */ - | "plan"; + | "plan" + /** A model-safe reference to one retained search candidate. */ + | "selection"; /** * Why a presented handle was rejected * @@ -603,16 +693,20 @@ export type CatalogHandleType = */ /** @experimental */ export type CatalogHandleRejectionReason = - /** The handle is unparseable, unknown, or was issued for a different operation. */ + /** The handle is unparseable or unknown. */ | "invalid" /** The handle's time to live has elapsed. */ | "stale" /** The handle has already been used, and handles are single-use. */ | "replayed" - /** The handle was issued by a different runtime instance. */ - | "foreign"; + /** The handle was issued by a different runtime instance or session. */ + | "foreign" + /** The handle was issued for another catalog operation. */ + | "wrong-kind" + /** The supplied search identifier does not match the retained candidate. */ + | "search-mismatch"; /** - * Which request field was rejected before any work was done + * Which request field was rejected locally or by the catalog authority * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema * via the `definition` "CatalogInvalidRequestField". @@ -632,7 +726,15 @@ export type CatalogInvalidRequestField = /** The supplied card was missing its media type, URL, or data. */ | "card" /** The requested configuration scope is not one this runtime writes. */ - | "scope"; + | "scope" + /** The pagination token or target was invalid, or the authority rejected the continuation. Repeat the search without page. */ + | "page" + /** The locally owned session identifier was missing or malformed. */ + | "sessionId" + /** The opaque selection reference was missing or malformed. */ + | "selectionRef" + /** The terminal selection outcome was missing or unsupported. */ + | "outcome"; /** * How a card failed validation * @@ -664,7 +766,9 @@ export type CatalogMediaType = /** The legacy MCP server card media type, accepted for compatibility. */ | "application/mcp-server+json" /** An AI skill card. Representable and searchable, but typed non-installable. */ - | "application/ai-skill"; + | "application/ai-skill" + /** An inert Agent Plugin descriptor. */ + | "application/vnd.github.copilot-plugin"; /** * Why capability and protocol-version negotiation refused a caller * @@ -737,6 +841,16 @@ export type McpPlanPolicySource = | "registry-policy" /** Local trust settings evaluated the server. */ | "local-trust"; +/** + * Relationship of the backend-reported count to the complete query result set. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogSearchTotalCountRelation". + */ +/** @experimental */ +export type CatalogSearchTotalCountRelation = + /** No exact/full-query or lower-bound guarantee is available. */ + "unknown"; /** * Outcome of a catalog.search call: either bounded inert candidates, or one typed refusal. Never a partial success. * @@ -788,10 +902,48 @@ export type CatalogUnavailableReason = | "search-unavailable" /** Install planning is not wired up on this runtime build. */ | "planning-unavailable" + /** Exact candidate selection is not available in this session or runtime. */ + | "selection-unavailable" /** No catalog authority is configured for this runtime. */ | "authority-not-configured" /** The surface is disabled by policy on this runtime. */ | "disabled-by-policy"; +/** + * Terminal outcome declared for a retained catalog selection group + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogSelectionDecision". + */ +/** @experimental */ +export type CatalogSelectionDecision = + /** Choose the candidate named by selectionRef. */ + | "selected" + /** Explicitly decline every candidate in the search. */ + | "declined" + /** Cancel the selection interaction without choosing a candidate. */ + | "cancelled" + /** Declare that the host's live interaction deadline elapsed while the reference remained valid. */ + | "timed-out"; +/** + * Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogSelectionResult". + */ +/** @experimental */ +export type CatalogSelectionResult = + | CatalogSelectionSelected + | CatalogSelectionDeclined + | CatalogSelectionCancelled + | CatalogSelectionTimedOut + | CatalogSelectionInvalid + | CatalogSelectionStale + | CatalogSelectionReplayed + | CatalogSelectionForeign + | CatalogSelectionWrongKind + | CatalogNegotiationRefusedError + | CatalogInvalidRequestError + | CatalogUnavailableError; /** * Why no usable transport could be offered * @@ -4254,6 +4406,216 @@ export type UISessionLimitsExhaustedResponseAction = | "unset" /** Leave the limit unchanged and cancel the blocked model request. */ | "cancel"; +/** + * Execution-critical workflow storage operation. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowDurableOperation". + */ +/** @experimental */ +export type WorkflowDurableOperation = + /** Creating the durable run and declared phases. */ + | "createRun" + /** Persisting the transition to running. */ + | "markRunStarted" + /** Persisting the terminal run envelope. */ + | "finishRun" + /** Persisting subagent admission accounting. */ + | "reserveAgent" + /** Rolling back an uncommitted subagent admission. */ + | "releaseAgent" + /** Persisting an idempotent model-usage charge. */ + | "chargeCredit" + /** Persisting active execution time. */ + | "addElapsed" + /** Reading the authoritative AI-credit total. */ + | "reconcileCreditTotal" + /** Reading a journal entry without treating storage failure as a cache miss. */ + | "journalGet" + /** Persisting a journal entry before reporting success. */ + | "journalPut" + /** Renewing the durable owner lease that proves this process still owns the run. */ + | "refreshLease"; +/** + * Current or terminal state of a workflow run. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunStatus". + */ +/** @experimental */ +export type WorkflowRunStatus = + /** The run was minted and is awaiting approval. */ + | "pending" + /** The run is executing. */ + | "running" + /** The run completed successfully. */ + | "completed" + /** The run was interrupted while resource budget remained. */ + | "halted" + /** The current attempt stopped intentionally and the run may be resumed. */ + | "paused" + /** The run was cancelled before completion. */ + | "cancelled" + /** The workflow body failed or reached a cumulative resource ceiling. */ + | "error"; +/** + * Machine-readable workflow run failure. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunFailure". + */ +/** @experimental */ +export type WorkflowRunFailure = + | { + kind: WorkflowRunFailureKind; + /** + * Approved effective ceiling that was reached. + */ + value: number; + /** + * Suggested larger ceiling when the runtime can derive one safely. + */ + suggestedValue?: number; + /** + * Workflow run identifier. + */ + runId: string; + /** + * Workflow failure variant discriminator. + */ + type: "workflow_limit_reached"; + } + | { + /** + * Workflow run identifier whose changed limits were declined. + */ + runId: string; + /** + * Human-readable reason the resume did not proceed. + */ + reason: string; + /** + * Workflow failure variant discriminator. + */ + type: "workflow_resume_declined"; + } + | { + /** + * Stable failure code. + */ + code: string; + operation: WorkflowDurableOperation; + /** + * Workflow run identifier. + */ + runId: string; + /** + * Workflow failure variant discriminator. + */ + type: "workflow_durable_failure"; + } + | { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Confirmed usage in nano-AIU, representing the floor of what the run spent. + */ + drainedNanoAiu: number; + /** + * Workflow failure variant discriminator. + */ + type: "workflow_accounting_incomplete"; + } + | { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Workflow failure variant discriminator. + */ + type: "workflow_provider_disconnected"; + }; +/** + * Cumulative resource ceiling that stopped a workflow run. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunFailureKind". + */ +/** @experimental */ +export type WorkflowRunFailureKind = + /** The run admitted the approved maximum total number of subagents. */ + | "maxTotalSubagents" + /** The run reached the approved accumulated active-execution time in seconds. */ + | "timeoutSeconds" + /** The run's settled subagent model usage exceeded the approved AI-credit ceiling, or no headroom remained for another subagent. */ + | "maxAiCredits"; +/** + * Durable metadata describing who initiated a workflow pause. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowPauseInfo". + */ +/** @experimental */ +export type WorkflowPauseInfo = + | { + /** + * Workflow pause initiator discriminator. + */ + type: "user"; + } + | { + /** + * Stable author-defined checkpoint key that initiated the pause. + */ + key: string; + /** + * Workflow pause initiator discriminator. + */ + type: "checkpoint"; + }; +/** + * Kind of workflow progress line. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowLogLineKind". + */ +/** @experimental */ +export type WorkflowLogLineKind = + /** A narrator log line. */ + | "log" + /** A named workflow phase marker. */ + | "phase"; +/** + * Action the runtime selected for a durable workflow pause checkpoint. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowPauseCheckpointAction". + */ +/** @experimental */ +export type WorkflowPauseCheckpointAction = + /** The checkpoint was committed by a prior paused attempt, so execution may continue. */ + | "continue" + /** This attempt claimed the checkpoint and must cooperatively stop. */ + | "pause"; +/** + * Derived lifecycle state of a workflow phase. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowPhaseStatus". + */ +/** @experimental */ +export type WorkflowPhaseStatus = + /** The phase has not been entered yet. */ + | "pending" + /** The phase is currently entered and accumulating active time. */ + | "active" + /** The phase was entered and has since been closed. */ + | "completed" + /** The phase was never entered because a later phase was entered or the run reached a terminal state. */ + | "skipped"; /** * Type of change represented by this file diff. * @@ -4562,6 +4924,15 @@ export interface CopilotUserResponse { * Whether CLI remote control is enabled for the user. */ cli_remote_control_enabled?: boolean; + /** + * Enterprises that provide the user's Copilot license, each with a stable numeric ID. + */ + enterprise_list?: { + /** + * Numeric database ID of the enterprise. + */ + id: number; + }[]; } /** * Endpoint URLs from the raw Copilot `/copilot_internal/v2/token` user-response passthrough. @@ -6145,87 +6516,70 @@ export interface CardDigest { value: CardDigestValue; } /** - * An inert AI skill catalog result. AI skills are discovery-only and cannot be represented as installable through this surface. + * An inert Agent Plugin catalog result. Its canonical catalog identity, declared version, repository source claim, and explicit compatibility tags are safe to correlate, while its descriptor, URL, raw data, and installed-plugin state remain runtime-private. This contract-only variant does not mint or expose a candidate handle. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "CatalogAiSkillCandidate". + * via the `definition` "CatalogAgentPluginCandidate". */ /** @experimental */ -export interface CatalogAiSkillCandidate { +export interface CatalogAgentPluginCandidate { + kind: CatalogAgentPluginCandidateKind; + mediaType: CatalogAgentPluginMediaType; + identity: CatalogResourceIdentity; + version?: CatalogResourceVersion; /** - * Opaque, runtime-instance scoped, TTL-bound, single-use handle for this candidate. Carries no readable information and is rejected when stale, replayed, or presented to a different runtime instance. Never logged. + * Display name taken verbatim from the card. Inert untrusted text. */ - handle: string; + displayName: string; /** - * ISO 8601 timestamp after which the handle is stale and will be rejected. + * Description taken verbatim from the card. Inert untrusted text. */ - handleExpiresAt: string; + description?: string; /** - * Discriminator: this candidate describes an AI skill + * Publisher taken verbatim from the card. Inert untrusted text. */ - kind: "ai-skill"; + publisher?: string; + source: CatalogPluginRepositorySource; /** - * Media type of the underlying AI skill card + * Explicit validated compatibility tags, in canonical order. An empty list means the source declared no recognised compatibility; clients must not infer compatibility from other fields. `canvas-only` requires both `canvas` and `github-copilot`. + * + * @maxItems 3 */ - mediaType: "application/ai-skill"; - /** - * AI skills are discovery-only and cannot be installed through this surface - */ - installability: "not-installable-kind"; - /** - * Display name taken verbatim from the card. Inert untrusted text. - */ - displayName: string; - /** - * Description taken verbatim from the card. Inert untrusted text. - */ - description?: string; - /** - * Publisher taken verbatim from the card. Inert untrusted text. - */ - publisher?: string; - source: CatalogCandidateSource; - provenance: CatalogAiSkillCandidateProvenance; + compatibilityTags: + | ({ + [k: string]: unknown | undefined; + } & []) + | [CatalogAgentPluginCompatibilityTag] + | [CatalogAgentPluginCompatibilityTag, CatalogAgentPluginCompatibilityTag] + | [CatalogAgentPluginCompatibilityTag, CatalogAgentPluginCompatibilityTag, CatalogAgentPluginCompatibilityTag]; + provenance: CatalogAgentPluginCandidateProvenance; trust?: CatalogTrustSnapshot; } /** - * Candidate whose card is retrieved from a URL through the runtime's hardened fetch boundary. + * Syntactically validated GitHub repository provenance declared by catalog metadata. This is a source claim rather than proof that the descriptor URL resolves to the repository. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "CatalogCandidateSourceUrl". + * via the `definition` "CatalogPluginRepositorySource". */ /** @experimental */ -export interface CatalogCandidateSourceUrl { - /** - * Discriminator: the card is URL-backed, and carries no embedded data - */ - kind: "url"; +export interface CatalogPluginRepositorySource { /** - * Card URL as advertised. Inert untrusted data: the runtime retrieves it only through its own hardened boundary, and it is never logged. + * Canonical lowercase owner/repository name derived from metadata.sourceSet. */ - url: string; -} -/** - * Candidate whose card reference arrived inline. The document and its content-derived properties stay behind the runtime boundary. - * - * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "CatalogCandidateSourceEmbedded". - */ -/** @experimental */ -export interface CatalogCandidateSourceEmbedded { + repository: string; /** - * Discriminator: the card is embedded, and carries no URL + * Case-preserving safe relative POSIX path derived from metadata.repoPath. */ - kind: "embedded"; + path: string; } /** - * Where and when an AI skill catalog reference was observed. Discovery provenance deliberately carries no content digest because search does not establish the exact validated content a later plan will bind. + * Where and when an Agent Plugin catalog reference was observed. Discovery provenance deliberately carries no descriptor URL, raw data, candidate handle, or content digest. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "CatalogAiSkillCandidateProvenance". + * via the `definition` "CatalogAgentPluginCandidateProvenance". */ /** @experimental */ -export interface CatalogAiSkillCandidateProvenance { +export interface CatalogAgentPluginCandidateProvenance { /** * Host of the catalog authority that advertised the reference, without path, query, or credentials. Inert untrusted data. */ @@ -6234,10 +6588,7 @@ export interface CatalogAiSkillCandidateProvenance { * ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a retrieval or validation timestamp. */ observedAt: string; - /** - * Media type advertised for the referenced AI skill card - */ - mediaType: "application/ai-skill"; + mediaType: CatalogAgentPluginMediaType; } /** * A recognised current Agent Finder T1 or T2 trust tier. @@ -6345,6 +6696,89 @@ export interface CatalogTrustSnapshotMalformed { eligibility: CatalogTrustEligibility; provenance: CatalogTrustProvenance; } +/** + * An inert AI skill catalog result. AI skills are discovery-only and cannot be represented as installable through this surface. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogAiSkillCandidate". + */ +/** @experimental */ +export interface CatalogAiSkillCandidate { + /** + * Opaque, runtime-instance scoped, TTL-bound, single-use handle for this candidate. Carries no readable information and is rejected when stale, replayed, or presented to a different runtime instance. Never logged. + */ + handle: string; + /** + * ISO 8601 timestamp after which the handle is stale and will be rejected. + */ + handleExpiresAt: string; + kind: CatalogAiSkillCandidateKind; + mediaType: CatalogAiSkillMediaType; + installability: CatalogAiSkillInstallability; + /** + * Display name taken verbatim from the card. Inert untrusted text. + */ + displayName: string; + /** + * Description taken verbatim from the card. Inert untrusted text. + */ + description?: string; + /** + * Publisher taken verbatim from the card. Inert untrusted text. + */ + publisher?: string; + source: CatalogCandidateSource; + provenance: CatalogAiSkillCandidateProvenance; + trust?: CatalogTrustSnapshot; +} +/** + * Candidate whose card is retrieved from a URL through the runtime's hardened fetch boundary. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogCandidateSourceUrl". + */ +/** @experimental */ +export interface CatalogCandidateSourceUrl { + /** + * Discriminator: the card is URL-backed, and carries no embedded data + */ + kind: "url"; + /** + * Card URL as advertised. Inert untrusted data: the runtime retrieves it only through its own hardened boundary, and it is never logged. + */ + url: string; +} +/** + * Candidate whose card reference arrived inline. The document and its content-derived properties stay behind the runtime boundary. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogCandidateSourceEmbedded". + */ +/** @experimental */ +export interface CatalogCandidateSourceEmbedded { + /** + * Discriminator: the card is embedded, and carries no URL + */ + kind: "embedded"; +} +/** + * Where and when an AI skill catalog reference was observed. Discovery provenance deliberately carries no content digest because search does not establish the exact validated content a later plan will bind. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogAiSkillCandidateProvenance". + */ +/** @experimental */ +export interface CatalogAiSkillCandidateProvenance { + /** + * Host of the catalog authority that advertised the reference, without path, query, or credentials. Inert untrusted data. + */ + authority: string; + /** + * ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a retrieval or validation timestamp. + */ + observedAt: string; + mediaType: CatalogAiSkillMediaType; +} /** * An optional catalog authentication exchange did not establish the caller's identity. Anonymous search remains supported; this refusal is reserved for an operation that cannot continue after the attempted exchange. It is distinct from `policy-rejected` and from a network failure, and the reason identifies the recovery action. * @@ -6379,10 +6813,7 @@ export interface CatalogMcpServerCandidate { * ISO 8601 timestamp after which the handle is stale and will be rejected. */ handleExpiresAt: string; - /** - * Discriminator: this candidate describes an MCP server - */ - kind: "mcp-server"; + kind: CatalogMcpServerCandidateKind; mediaType: McpServerCardMediaType; installability: CatalogMcpServerInstallability; /** @@ -6476,7 +6907,7 @@ export interface CatalogHandleRejectedError { message: string; } /** - * The request was rejected before any work was done, because a bounded field fell outside its permitted range or a required field was unusable. + * The request was rejected because a bounded field fell outside its permitted range or a required field was unusable. Pagination may also be rejected by the authority after a continuation request; repeat the search without page. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema * via the `definition` "CatalogInvalidRequestError". @@ -6525,7 +6956,7 @@ export interface CatalogNegotiatedContract { */ runtimeProtocolVersion: number; /** - * Wire features the runtime understood for this operation. Always a superset of the caller's required features, because any shortfall is a refusal instead. Operation availability remains a separate typed result. + * Wire features the runtime understood for this operation. Includes the five original catalog capabilities and only explicitly requested supported additions, in supported order without duplicates. Capabilities that introduce new success-union variants or operations are therefore included only when explicitly required, preserving older protocol-v3 clients. Always a superset of the caller's required features, because any shortfall is a refusal instead. Operation availability remains a separate typed result. */ grantedCapabilities: CatalogCapability[]; } @@ -6629,6 +7060,61 @@ export interface CatalogPolicyRejectedError { */ message: string; } +/** + * An explicit numbered-page request. The SDK treats the token as opaque; only the runtime decodes it and changes its targetPage. Authority validation binds navigation to the original search. No snapshot stability or token TTL is promised. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogSearchPage". + */ +/** @experimental */ +export interface CatalogSearchPage { + /** + * Opaque authority-issued pagination token from an earlier response. Never decode, modify or log it in an SDK consumer. + */ + token: string; + /** + * Requested one-based page. Must not exceed either the token's signed pageCount or the navigation window ceil(1000 / pageSize). Repeat the search without page to discover newly available pages beyond that signed pageCount. + */ + number: number; +} +/** + * Authority-reported navigation metadata, returned only to callers requiring catalog-search-pagination and only when a supported token is present. Tokenless first-page and continuation responses omit this object; no counts are inferred from candidates. The opaque token may be retained for previous or numbered navigation even when hasNextPage is false. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogSearchPagination". + */ +/** @experimental */ +export interface CatalogSearchPagination { + /** + * Opaque authority-issued pagination token. Only the runtime decodes it or changes targetPage; SDK consumers must not decode, modify or log it. It has no runtime-created expiry or cache. + */ + token: string; + /** + * One-based page returned by the authority. + */ + currentPage: number; + /** + * Page size bound to the search, equal to the effective request limit. + */ + pageSize: number; + /** + * Backend-reported count for this response, not the number of returned candidates. Its relationship to the full query result set is unknown. + */ + totalCount: number; + totalCountRelation: CatalogSearchTotalCountRelation; + /** + * Backend-reported page count, which may exceed maxPage. Present pagination metadata always describes a multi-page result; zero- and single-page responses omit pagination. Navigation targets must also be within the signed pageCount carried by the supplied token. + */ + pageCount: number; + /** + * Navigation window ceiling ceil(1000 / pageSize), not the number of existing pages. Legal targets must not exceed this ceiling or the token's signed pageCount. + */ + maxPage: number; + /** + * Whether the authority token advertises a valid next target within the navigation window. Not inferred from token presence, truncated, or currentPage being less than pageCount. + */ + hasNextPage: boolean; +} /** * A bounded catalog search. Both the query length and the result count are capped by the schema so a caller cannot request an unbounded scan. * @@ -6647,15 +7133,19 @@ export interface CatalogSearchRequest { */ limit?: number; /** - * Restrict results to these candidate kinds. When omitted, every kind the runtime supports is searched. + * Restrict results to these candidate kinds. Agent Plugins are opt-in and require the `agent-plugin-discovery` capability so protocol-v3 clients generated before that variant cannot receive an unknown result; when omitted, the backwards-compatible MCP server and AI skill kinds are searched. * * @minItems 1 - * @maxItems 2 + * @maxItems 3 */ - kinds?: [CatalogCandidateKind] | [CatalogCandidateKind, CatalogCandidateKind]; + kinds?: + | [CatalogCandidateKind] + | [CatalogCandidateKind, CatalogCandidateKind] + | [CatalogCandidateKind, CatalogCandidateKind, CatalogCandidateKind]; + page?: CatalogSearchPage; } /** - * A completed catalog search: inert candidate summaries, each carrying a single-use handle. + * A completed catalog search containing inert candidate summaries. MCP server and AI skill variants carry a single-use handle; the Agent Plugin variant is handleless. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema * via the `definition` "CatalogSearchSucceeded". @@ -6677,10 +7167,11 @@ export interface CatalogSearchSucceeded { */ candidates: CatalogCandidate[]; /** - * Whether further matches existed beyond the requested limit. + * Legacy indication that the authority returned a page token. Preserved for compatibility; this is not a has-next-page indicator. Use pagination.hasNextPage when pagination metadata is present. */ truncated: boolean; negotiated: CatalogNegotiatedContract; + pagination?: CatalogSearchPagination; } /** * The request asked for a candidate kind this runtime does not serve. @@ -6744,138 +7235,314 @@ export interface CatalogUnavailableError { message: string; } /** - * No transport this runtime can use is available for the requested server. + * The caller cancelled the selection interaction and the retained search state was released. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "CatalogUnavailableTransportError". + * via the `definition` "CatalogSelectionCancelled". */ /** @experimental */ -export interface CatalogUnavailableTransportError { +export interface CatalogSelectionCancelled { /** - * Discriminator: no usable transport is available + * Discriminator: selection was cancelled */ - kind: "unavailable-transport"; - reason: CatalogUnavailableTransportReason; + kind: "cancelled"; /** - * Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. + * The search identifier privately bound to the released selection group. */ - message: string; + searchId: string; } /** - * Client-owned, case-sensitive string metadata persisted with a local session. Clients should namespace keys by owner. Keys must be non-empty and at most 256 UTF-8 bytes; keys under `copilot/` and `github/` are reserved. Values may contain at most 16 KiB of UTF-8 data. A bag may contain at most 128 entries and its serialized sidecar may contain at most 64 KiB. The runtime stores but never interprets these values. + * The caller explicitly declined every candidate and the retained search state was released. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "ClientMetadata". + * via the `definition` "CatalogSelectionDeclined". */ /** @experimental */ -export interface ClientMetadata { - [k: string]: string | undefined; +export interface CatalogSelectionDeclined { + /** + * Discriminator: the candidates were declined + */ + kind: "declined"; + /** + * The search identifier privately bound to the released selection group. + */ + searchId: string; } /** - * Runtime-to-owner cancellation request for a client-owned task. + * The selection reference belongs to another runtime instance or session. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "ClientTaskCancelRequest". + * via the `definition` "CatalogSelectionForeign". */ /** @experimental */ -export interface ClientTaskCancelRequest { +export interface CatalogSelectionForeign { /** - * Session that owns the client task + * Discriminator for this typed selection rejection */ - sessionId: string; + kind: "foreign"; /** - * Canonical runtime-generated task identifier + * Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. */ - id: string; + message: string; +} +/** + * The selection reference was malformed or unknown. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogSelectionInvalid". + */ +/** @experimental */ +export interface CatalogSelectionInvalid { /** - * Owner-scoped task key included for correlation + * Discriminator for this typed selection rejection */ - clientTaskId: string; + kind: "invalid"; /** - * Opaque identifier shared by coalesced cancellation callers + * Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. */ - cancellationId: string; - reason: ClientTaskCancelReason; + message: string; } /** - * Whether the client authoritatively confirmed its external work stopped. + * The selection group was already terminated or its pending host hand-off was already claimed. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "ClientTaskCancelResult". + * via the `definition` "CatalogSelectionReplayed". */ /** @experimental */ -export interface ClientTaskCancelResult { +export interface CatalogSelectionReplayed { /** - * True only when the owner confirms that external work stopped before responding + * Discriminator for this typed selection rejection */ - cancelled: boolean; + kind: "replayed"; + /** + * Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + */ + message: string; } /** - * Slash commands available in the session, after applying any include/exclude filters. + * Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "CommandList". + * via the `definition` "CatalogSelectionRequest". */ /** @experimental */ -export interface CommandList { +export interface CatalogSelectionRequest { + contract: CatalogClientContract; /** - * Commands available in this session + * Locally owned root session whose retained search state is being resolved. */ - commands: SlashCommandInfo[]; + sessionId: string; + /** + * Opaque runtime-instance scoped reference to one visible candidate. For a non-selected outcome, any candidate reference from the same search closes that search's retained group. + */ + selectionRef: string; + outcome: CatalogSelectionDecision; } /** - * Slash-command metadata with name, aliases, description, kind, input hint, execution allowance, and schedulability. + * The chosen candidate was transferred into a fresh bounded single-use handle for a later explicit planning request. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "SlashCommandInfo". + * via the `definition` "CatalogSelectionSelected". */ /** @experimental */ -export interface SlashCommandInfo { +export interface CatalogSelectionSelected { /** - * Canonical command name without a leading slash - */ - name: string; - /** - * Canonical aliases without leading slashes + * Discriminator: one candidate was selected */ - aliases?: string[]; + kind: "selected"; /** - * Human-readable command description + * Fresh single-use candidate handle accepted by mcp.planInstall. Returned only to the native host and never included in model-tool output. */ - description: string; - kind: SlashCommandKind; - input?: SlashCommandInput; + candidateHandle: string; /** - * Whether the command may run while an agent turn is active + * The exact search identifier privately bound to the selected candidate. */ - allowDuringAgentExecution: boolean; + searchId: string; +} +/** + * The host declared that its live selection interaction timed out, and the retained search state was released. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogSelectionTimedOut". + */ +/** @experimental */ +export interface CatalogSelectionTimedOut { /** - * Whether the command is experimental + * Discriminator: the host's live interaction timed out */ - experimental?: boolean; + kind: "timed-out"; /** - * Whether the command may be the target of `/every` / `/after` schedules. Resolution happens at every tick, so only set this when the command is safe to re-invoke and produces an agent prompt. + * The search identifier privately bound to the released selection group. */ - schedulable?: boolean; + searchId: string; } /** - * Optional unstructured input hint + * The runtime-enforced selection reference lifetime elapsed before the request arrived. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "SlashCommandInput". + * via the `definition` "CatalogSelectionStale". */ /** @experimental */ -export interface SlashCommandInput { +export interface CatalogSelectionStale { /** - * Hint to display when command input has not been provided + * Discriminator for this typed selection rejection */ - hint: string; + kind: "stale"; /** - * Optional literal choices the input accepts, each with a human-facing description; clients may render these as selectable options + * Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. */ - choices?: SlashCommandInputChoice[]; + message: string; +} +/** + * The presented opaque handle was issued for another catalog operation. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogSelectionWrongKind". + */ +/** @experimental */ +export interface CatalogSelectionWrongKind { /** - * When true, the command requires non-empty input; clients should render the input hint as required + * Discriminator for this typed selection rejection + */ + kind: "wrong-kind"; + /** + * Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + */ + message: string; +} +/** + * No transport this runtime can use is available for the requested server. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CatalogUnavailableTransportError". + */ +/** @experimental */ +export interface CatalogUnavailableTransportError { + /** + * Discriminator: no usable transport is available + */ + kind: "unavailable-transport"; + reason: CatalogUnavailableTransportReason; + /** + * Human-readable explanation, safe to surface. Never contains a query, URL, handle, or secret. + */ + message: string; +} +/** + * Client-owned, case-sensitive string metadata persisted with a local session. Clients should namespace keys by owner. Keys must be non-empty and at most 256 UTF-8 bytes; keys under `copilot/` and `github/` are reserved. Values may contain at most 16 KiB of UTF-8 data. A bag may contain at most 128 entries and its serialized sidecar may contain at most 64 KiB. The runtime stores but never interprets these values. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "ClientMetadata". + */ +/** @experimental */ +export interface ClientMetadata { + [k: string]: string | undefined; +} +/** + * Runtime-to-owner cancellation request for a client-owned task. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "ClientTaskCancelRequest". + */ +/** @experimental */ +export interface ClientTaskCancelRequest { + /** + * Session that owns the client task + */ + sessionId: string; + /** + * Canonical runtime-generated task identifier + */ + id: string; + /** + * Owner-scoped task key included for correlation + */ + clientTaskId: string; + /** + * Opaque identifier shared by coalesced cancellation callers + */ + cancellationId: string; + reason: ClientTaskCancelReason; +} +/** + * Whether the client authoritatively confirmed its external work stopped. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "ClientTaskCancelResult". + */ +/** @experimental */ +export interface ClientTaskCancelResult { + /** + * True only when the owner confirms that external work stopped before responding + */ + cancelled: boolean; +} +/** + * Slash commands available in the session, after applying any include/exclude filters. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "CommandList". + */ +/** @experimental */ +export interface CommandList { + /** + * Commands available in this session + */ + commands: SlashCommandInfo[]; +} +/** + * Slash-command metadata with name, aliases, description, kind, input hint, execution allowance, and schedulability. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "SlashCommandInfo". + */ +/** @experimental */ +export interface SlashCommandInfo { + /** + * Canonical command name without a leading slash + */ + name: string; + /** + * Canonical aliases without leading slashes + */ + aliases?: string[]; + /** + * Human-readable command description + */ + description: string; + kind: SlashCommandKind; + input?: SlashCommandInput; + /** + * Whether the command may run while an agent turn is active + */ + allowDuringAgentExecution: boolean; + /** + * Whether the command is experimental + */ + experimental?: boolean; + /** + * Whether the command may be the target of `/every` / `/after` schedules. Resolution happens at every tick, so only set this when the command is safe to re-invoke and produces an agent prompt. + */ + schedulable?: boolean; +} +/** + * Optional unstructured input hint + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "SlashCommandInput". + */ +/** @experimental */ +export interface SlashCommandInput { + /** + * Hint to display when command input has not been provided + */ + hint: string; + /** + * Optional literal choices the input accepts, each with a human-facing description; clients may render these as selectable options + */ + choices?: SlashCommandInputChoice[]; + /** + * When true, the command requires non-empty input; clients should render the input hint as required */ required?: boolean; completion?: SlashCommandInputCompletion; @@ -10136,6 +10803,18 @@ export interface InstalledPluginInfo { * Runtime-reported plugin provenance. Currently set to "builtin" only for plugins registered through the trusted host built-in boundary; absent for installed, marketplace, direct, and live plugins. */ source?: string; + /** + * Whether enterprise managed settings control this plugin's enabled state. + */ + managed?: boolean; + /** + * The enabled state required by enterprise managed settings, when this plugin spec is managed. + */ + managedDesiredEnabled?: boolean; + /** + * Whether the managed desired plugin currently has an installed or live record. Set to false for a managed desired entry retained in the listing after installation or reconciliation failed. + */ + installed?: boolean; } /** * Canonical file or directory where custom instructions can be discovered or created, with location, kind, preference, and project path. @@ -10769,6 +11448,14 @@ export interface MarketplaceInfo { * True when this is a default marketplace shipped with the runtime. Defaults are not removable. */ isDefault?: boolean; + /** + * Whether enterprise managed settings provide and control this marketplace entry. + */ + managed?: boolean; + /** + * Whether the managed marketplace currently resolved into the runtime marketplace registry. Set to false when the desired managed entry is retained for governance visibility after loading or reconciliation failed. + */ + available?: boolean; } /** * All registered marketplaces, including built-in defaults. @@ -11185,6 +11872,10 @@ export interface McpServerConfigStdio { * Timeout in milliseconds for tool discovery and tool calls. */ timeout?: number; + /** + * Milliseconds this server may spend connecting before the CLI warns that it is taking longer than expected. Presentation only: it does not change how long the connection is allowed to take. + */ + slowConnectionThresholdMs?: number; oidc?: McpServerAuthConfig; auth?: McpServerAuthConfig; deferTools?: McpServerConfigDeferTools; @@ -11306,6 +11997,10 @@ export interface McpServerConfigHttp { * Timeout in milliseconds for tool discovery and tool calls. */ timeout?: number; + /** + * Milliseconds this server may spend connecting before the CLI warns that it is taking longer than expected. Presentation only: it does not change how long the connection is allowed to take. + */ + slowConnectionThresholdMs?: number; oidc?: McpServerAuthConfig; auth?: McpServerAuthConfig; deferTools?: McpServerConfigDeferTools; @@ -11746,7 +12441,7 @@ export interface McpInstallPlan { target: McpPlanTarget; policy: McpPlanPolicyResult; /** - * The configuration changes installing would make, described rather than serialised, so the mutable configuration payload stays behind the runtime boundary. + * Alternative configuration changes, with exactly one entry for each transportChoices entry in the same order. Only the entry for the subsequently selected transport applies; these are not cumulative writes. Payloads remain behind the runtime boundary. */ configurationChanges: McpPlanConfigurationChange[]; /** @@ -11754,7 +12449,7 @@ export interface McpInstallPlan { */ reloadRequired: boolean; /** - * Whether the plan cannot be applied without further input, because a required value has no default or a secret must be supplied. + * True only when every eligible transport choice needs additional values or secrets. False means at least one choice needs no additional configuration, not that every choice is ready. A later apply operation must validate the selected choice's own inputs, secrets and policy after explicit confirmation. */ requiresInteractiveConfiguration: boolean; } @@ -11986,7 +12681,7 @@ export interface McpPlanPolicyResult { reason?: string; } /** - * One change applying the plan would make, described rather than serialised so the configuration payload stays behind the runtime boundary. + * The configuration-change alternative for the transportChoices entry at the same index. Only the selected alternative is applied; entries are not cumulative. The payload stays behind the runtime boundary. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema * via the `definition` "McpPlanConfigurationChange". @@ -12270,7 +12965,7 @@ export interface McpPlanInstallSourceCandidate { */ candidateHandle: string; /** - * The runtime- or authority-minted `searchId` returned with the search that produced this candidate. A search implementation binds it to private candidate-handle context; a planning implementation must verify that context before returning a plan. The unavailable planning implementation in this contract layer validates presence but does not claim the verification has occurred. It identifies a search rather than a person and must never be joined with user identity to re-identify anyone. + * The runtime- or authority-minted `searchId` returned with the search that produced this candidate. Planning verifies the private correlation and atomically consumes a matching candidate before downstream work, including attempts that subsequently fail or report unavailable. A mismatched search does not consume the candidate. It identifies a search rather than a person and must never be joined with user identity to re-identify anyone. */ searchId: string; } @@ -12777,6 +13472,10 @@ export interface McpServerConfigMemory { * Timeout in milliseconds for tool discovery and tool calls. */ timeout?: number; + /** + * Milliseconds this server may spend connecting before the CLI warns that it is taking longer than expected. Presentation only: it does not change how long the connection is allowed to take. + */ + slowConnectionThresholdMs?: number; oidc?: McpServerAuthConfig; deferTools?: McpServerConfigDeferTools; /** @@ -13538,6 +14237,7 @@ export interface ModelApplyStartupOverlayRequest { * Startup default model from the enterprise policy helper, when configured. Weakest of the managed sources: it applies only when neither device nor server policy names a model, and an explicit user selection still wins. */ policyHelperModel?: string; + autoTier?: AutoTier; /** * Model selected by repository settings, when configured. */ @@ -13870,6 +14570,10 @@ export interface ModelSwitchToRequest { */ /** @experimental */ export interface ModelSwitchToResult { + /** + * Stable queue item identifier when this request was enqueued. Remains present if the item drains before the response is returned. + */ + queueId?: string; /** * Currently active model identifier after the switch */ @@ -14178,6 +14882,10 @@ export interface PendingPermissionRequest { */ requestId: string; request: PermissionPromptRequest; + /** + * Permission-recovery episode that authorized this request to surface for interactive attention + */ + recoveryEpisodeId?: string; } /** * List of pending permission requests reconstructed from event history. @@ -15824,6 +16532,30 @@ export interface Plugin { * Whether the plugin is currently enabled */ enabled: boolean; + /** + * Opaque stable identity for a direct plugin source. + */ + directSourceId?: string; + /** + * Absolute marketplace directory for a live plugin. + */ + installedFrom?: string; + /** + * Runtime plugin provenance, such as "builtin". + */ + source?: string; + /** + * Whether enterprise managed settings control this plugin. + */ + managed?: boolean; + /** + * Enabled state required by enterprise managed settings. + */ + managedDesiredEnabled?: boolean; + /** + * Whether this managed desired plugin has an installed or live record. + */ + installed?: boolean; } /** * Result of installing a plugin. @@ -16874,6 +17606,36 @@ export interface PushAttachmentBlob { */ displayName?: string; } +/** + * Append to one pending steering message without changing its identity or delivery position. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "QueueAppendSteeringRequest". + */ +/** @experimental */ +export interface QueueAppendSteeringRequest { + /** + * Message identity returned by send, not the queue item id. Only unclaimed user steering messages are eligible. + */ + messageId: string; + /** + * Expected current prompt, including any previous appends. The runtime applies plan-mode normalization before comparing and refuses a changed message. + */ + expectedPrompt: string; + agentMode: SendAgentMode; + /** + * Text to append after a blank line. + */ + prompt: string; + /** + * Display text to append to the existing preview after a blank line. + */ + displayPrompt: string; + /** + * Attachments to add after the message's existing attachments. An empty list preserves the existing attachments. + */ + attachments: Attachment[]; +} /** * Inputs for starting a deferred-idle drain. * @@ -17252,6 +18014,10 @@ export interface QueueSetDrainPausedRequest { */ /** @experimental */ export interface QueueSnapshotResult { + /** + * Queue item identifier of a model switch that has been dequeued but not yet applied. + */ + inFlightModelChangeId?: string; /** * User-facing pending items in FIFO order. */ @@ -17303,6 +18069,23 @@ export interface QueueUpdateTextResult { */ updated: boolean; } +/** + * Conditional withdrawal of a single user message, before the runtime claims it for delivery. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "QueueWithdrawMessageRequest". + */ +/** @experimental */ +export interface QueueWithdrawMessageRequest { + /** + * Message identity returned by send, not the queue item id. Batch messages are not eligible. + */ + messageId: string; + /** + * The prompt originally sent. A message edited since submission is not withdrawn, so an obsolete draft cannot replace the edit. + */ + expectedPrompt: string; +} /** * Event type to register consumer interest for, used by runtime gating logic. * @@ -18837,7 +19620,7 @@ export interface SessionFsSetProviderCapabilities { sqlite?: boolean; } /** - * Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. + * Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema * via the `definition` "SessionFsSetProviderRequest". @@ -18845,7 +19628,7 @@ export interface SessionFsSetProviderCapabilities { /** @experimental */ export interface SessionFsSetProviderRequest { /** - * Initial working directory for sessions + * Absolute initial working directory for sessions. Registering the provider establishes this path as the root of its virtual namespace; the runtime does not require the provider to materialize or stat it before creating a session. */ initialCwd: string; /** @@ -19315,7 +20098,7 @@ export interface SessionLoadDeferredRepoHooksResult { /** @experimental */ export interface SessionManagedPermissions { /** - * When set to `disable`, prevents bypass/allow-all permission modes. `allow-auto-only` blocks full allow-all but permits advisory auto-approval. Any other value is accepted rather than failing the session, but is enforced as `disable`: the key is only present to restrict something, so a mode this runtime cannot interpret fails closed to the most restrictive one it knows. Omit the key entirely to impose no restriction. + * When set to `disable`, prevents bypass/allow-all permission modes. Advisory auto-approval remains available because normal prompt paths stay active. Any other value is accepted rather than failing the session, but is enforced as `disable`: the key is only present to restrict something, so a mode this runtime cannot interpret fails closed to the most restrictive one it knows. Omit the key entirely to impose no restriction. */ disableBypassPermissionsMode?: string; /** @@ -19399,6 +20182,7 @@ export interface SessionMetadataSnapshot { * Current session limits, or null when no limits are active */ sessionLimits: SessionLimitsConfig | null; + indexedSearch?: IndexedSearchState; /** * Public-facing workspace metadata for this session, or null if the session has no associated workspace. Excludes runtime-internal fields (GitHub IDs, summary count, internal flags). */ @@ -20076,6 +20860,45 @@ export interface SessionsOpenProgress { */ message?: string; } +/** + * Plugin names (or specs) to disable in the session's authoritative working directory. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "SessionPluginsDisableRequest". + */ +/** @experimental */ +export interface SessionPluginsDisableRequest { + /** + * Plugin names or "plugin@marketplace" specs to disable. Unknown names are ignored. Non-marketplace direct installs cannot be disabled via this API; uninstall them instead. Plugin-owned MCP servers are stopped in active sessions immediately; other plugin contributions remain available until each session reloads plugins. + */ + names: string[]; +} +/** + * Plugin names (or specs) to enable in the session's authoritative working directory. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "SessionPluginsEnableRequest". + */ +/** @experimental */ +export interface SessionPluginsEnableRequest { + /** + * Plugin names or "plugin@marketplace" specs to enable. Unknown names are ignored. Non-marketplace direct installs are always enabled and cannot be toggled via this API. + */ + names: string[]; +} +/** + * Plugin source resolved relative to the session's authoritative working directory. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "SessionPluginsInstallRequest". + */ +/** @experimental */ +export interface SessionPluginsInstallRequest { + /** + * Plugin install spec. Accepts the same forms as the CLI: "plugin@marketplace" (marketplace install), "owner/repo" or "owner/repo:subpath" (GitHub direct), an http/https/ssh URL, or a local path. Direct (non-marketplace) installs are deprecated and will produce a deprecationWarning in the result. + */ + source: string; +} /** * Outcome of the prune operation: deleted IDs, dry-run candidates, skipped IDs, total bytes freed, and the dry-run flag. * @@ -23826,121 +24649,1141 @@ export interface UserRequestedShellCommandResult { */ output: string; /** - * Process exit code, when available + * Process exit code, when available + */ + exitCode?: number | null; + /** + * Error output when the execution failed + */ + error?: string; +} +/** + * A single user setting's effective value alongside its default, so consumers can render settings left at their default. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "UserSettingMetadata". + */ +/** @experimental */ +export interface UserSettingMetadata { + /** + * The effective value: the user's value if set, otherwise the default. + */ + value: JsonValue; + /** + * The centrally-known default for this setting (null when no default is registered). + */ + default: JsonValue; + /** + * True when the user has not set an explicit value for this setting (i.e. it is left at its default). Reflects whether the user has overridden the key, not whether the effective value happens to equal the default — a key explicitly set to a value identical to the default still reports false. + */ + isDefault: boolean; +} +/** + * Per-key metadata for every known user setting (settings.json overlaid with the legacy config.json, config.json wins), including settings left at their default. Excludes repository- and enterprise-managed overrides. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "UserSettingsGetResult". + */ +/** @experimental */ +export interface UserSettingsGetResult { + /** + * Every known user setting keyed by setting name, each with its effective value, default, and whether it is at the default. + */ + settings: { + [k: string]: UserSettingMetadata; + }; +} +/** + * 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. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "UserSettingsSetRequest". + */ +/** @experimental */ +export interface UserSettingsSetRequest { + /** + * Partial user settings to write, as a free-form object keyed by setting name + */ + settings: JsonValue; +} +/** + * Outcome of writing user settings. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "UserSettingsSetResult". + */ +/** @experimental */ +export interface UserSettingsSetResult { + /** + * Top-level keys whose write landed in settings.json but is shadowed by a value still present in the legacy config.json (config.json wins on read). The write does not take effect until the legacy value is removed. + */ + shadowedKeys: string[]; +} +/** + * Current sharing status and shareable GitHub URL for a session. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "VisibilityGetResult". + */ +/** @experimental */ +export interface VisibilityGetResult { + /** + * Whether the session has been synced to Mission Control (i.e. has a GitHub task). When false, the session cannot be shared and `status`/`shareUrl` are absent. + */ + synced: boolean; + status?: SessionVisibilityStatus; + /** + * Shareable GitHub URL for the session. Present when the session is synced and the URL can be resolved. + */ + shareUrl?: string; +} +/** + * Desired sharing status for the session. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "VisibilitySetRequest". + */ +/** @experimental */ +export interface VisibilitySetRequest { + status: SessionVisibilityStatus; +} +/** + * Effective sharing status and shareable GitHub URL after updating session visibility. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "VisibilitySetResult". + */ +/** @experimental */ +export interface VisibilitySetResult { + /** + * Whether the session has been synced to Mission Control (i.e. has a GitHub task). When false, the visibility change could not be applied and `status`/`shareUrl` are absent. + */ + synced: boolean; + status?: SessionVisibilityStatus; + /** + * Shareable GitHub URL for the session. Present when the session is synced and the URL can be resolved. + */ + shareUrl?: string; +} +/** + * Parameters for cooperatively aborting a workflow body. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowAbortRequest". + */ +/** @experimental */ +export interface WorkflowAbortRequest { + /** + * Target session identifier + */ + sessionId: string; + /** + * Workflow run identifier. + */ + runId: string; + /** + * Opaque token identifying the execution attempt to abort. + */ + executionToken: string; +} +/** + * Acknowledgement that a workflow request was accepted. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowAckResult". + */ +/** @experimental */ +export interface WorkflowAckResult {} +/** + * Options for one workflow-scoped subagent call. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowAgentOptions". + */ +/** @experimental */ +export interface WorkflowAgentOptions { + /** + * Optional label distinguishing otherwise identical memoized agent calls. + */ + label?: string; + /** + * Optional JSON Schema for structured agent output. + */ + schema?: JsonValue; + /** + * Optional model identifier for the subagent. + */ + model?: string; + /** + * Optional reasoning effort override for the subagent. + */ + reasoningEffort?: string; + contextTier?: ContextTier; + /** + * Optional built-in or custom agent name whose definition configures the subagent. + */ + agent?: string; +} +/** + * Parameters for one workflow-scoped subagent call. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowAgentRequest". + */ +/** @experimental */ +export interface WorkflowAgentRequest { + /** + * Workflow run identifier that owns the subagent. + */ + workflowRunId: string; + /** + * Opaque token identifying the current workflow execution attempt. + */ + executionToken: string; + /** + * Prompt to send to the subagent. + */ + prompt: string; + opts: WorkflowAgentOptions; +} +/** + * Result of one workflow-scoped subagent call. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowAgentResult". + */ +/** @experimental */ +export interface WorkflowAgentResult { + /** + * Agent result, omitted when the agent produced no result. + */ + result?: JsonValue; +} +/** + * Prompt-safe durable identity and live status for a direct workflow agent. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowAgentSummary". + */ +/** @experimental */ +export interface WorkflowAgentSummary { + /** + * Stable direct-agent identifier. + */ + agentId: string; + /** + * Tool-call identifier that launched the agent. + */ + toolCallId: string; + /** + * Owning workflow run identifier. + */ + runId: string; + /** + * Phase identifier active when the agent was launched, or null. + */ + phaseId: string | null; + /** + * Friendly, non-unique name intended for display + */ + label: string; + /** + * Friendly, non-unique name intended for display + */ + displayName?: string; + /** + * Registered agent type. + */ + agentType: string; + /** + * Current durable or live agent status. + */ + status: string; + /** + * Model requested when the agent was launched. + */ + requestedModel?: string; + /** + * Concrete model resolved for the agent. + */ + resolvedModel?: string; + /** + * Epoch milliseconds when the agent started. + */ + startedAt?: number; + /** + * Epoch milliseconds when the agent completed. + */ + completedAt?: number; + /** + * Accumulated active agent time in milliseconds. + */ + activeMs: number; + /** + * Prompt-safe live activity text. + */ + activity?: string; +} +/** + * Parameters for cancelling a workflow run. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowCancelRequest". + */ +/** @experimental */ +export interface WorkflowCancelRequest { + /** + * Workflow run identifier. + */ + runId: string; +} +/** + * Current workflow phase identity. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowCurrentPhase". + */ +/** @experimental */ +export interface WorkflowCurrentPhase { + /** + * Current phase identifier. + */ + id: string; + /** + * Zero-based declared phase ordinal, or null for an undeclared phase. + */ + ordinal: number | null; +} +/** + * Declared or approved workflow resource ceilings. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowDeclaredLimits". + */ +/** @experimental */ +export interface WorkflowDeclaredLimits { + /** + * Maximum concurrently active subagents. + */ + maxConcurrentSubagents?: number; + /** + * Maximum total subagents spawned by the run. + */ + maxTotalSubagents?: number; + /** + * Maximum accumulated active execution time in seconds. + */ + timeoutSeconds?: number; + /** + * Maximum AI credits consumed by subagents and descendants. + */ + maxAiCredits?: number; +} +/** + * Parameters sent to the owning extension to execute a workflow closure. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowExecuteRequest". + */ +/** @experimental */ +export interface WorkflowExecuteRequest { + /** + * Target session identifier + */ + sessionId: string; + /** + * Registered workflow name. + */ + name: string; + /** + * Workflow run identifier. + */ + runId: string; + /** + * Opaque token identifying this workflow execution attempt. + */ + executionToken: string; + /** + * Workflow input value. + */ + args: JsonValue; +} +/** + * Result returned by an extension workflow closure. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowExecuteResult". + */ +/** @experimental */ +export interface WorkflowExecuteResult { + /** + * Workflow result value. + */ + result?: JsonValue; +} +/** + * Parameters for paging workflow progress. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowGetRunProgressRequest". + */ +/** @experimental */ +export interface WorkflowGetRunProgressRequest { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Optional phase identifier used to scope records and cursors. + */ + phaseId?: string; + /** + * Exclusive forward cursor. + */ + afterSeq?: number; + /** + * Exclusive backward cursor. + */ + beforeSeq?: number; + /** + * Maximum records to return. Defaults to 200 and is capped at 500. + */ + limit?: number; +} +/** + * Parameters for retrieving a workflow run. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowGetRunRequest". + */ +/** @experimental */ +export interface WorkflowGetRunRequest { + /** + * Workflow run identifier. + */ + runId: string; +} +/** + * Parameters for reading a workflow journal entry. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowJournalGetRequest". + */ +/** @experimental */ +export interface WorkflowJournalGetRequest { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Opaque token identifying the current workflow execution attempt. + */ + executionToken: string; + /** + * Namespaced journal key. + */ + key: string; +} +/** + * Result of reading a workflow journal entry. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowJournalGetResult". + */ +/** @experimental */ +export interface WorkflowJournalGetResult { + /** + * Whether the journal contained the requested key. + */ + hit: boolean; + /** + * Cached JSON result. The hit field distinguishes a cached JSON null from a miss. + */ + resultJson?: JsonValue; +} +/** + * Parameters for storing a workflow journal entry. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowJournalPutRequest". + */ +/** @experimental */ +export interface WorkflowJournalPutRequest { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Opaque token identifying the current workflow execution attempt. + */ + executionToken: string; + /** + * Namespaced journal key. + */ + key: string; + /** + * JSON result to memoize. + */ + resultJson: JsonValue; +} +/** + * Parameters for paging workflow runs. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowListRunsRequest". + */ +/** @experimental */ +export interface WorkflowListRunsRequest { + /** + * Exclusive forward cursor. + */ + afterSeq?: number; + /** + * Exclusive backward cursor. + */ + beforeSeq?: number; + /** + * Maximum terminal runs to return. Defaults to 200 and is capped at 500. + */ + limit?: number; +} +/** + * A page of workflow runs in durable creation order. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowListRunsResult". + */ +/** @experimental */ +export interface WorkflowListRunsResult { + /** + * Workflow run summaries in durable creation order. + */ + runs: WorkflowRunSummary[]; + /** + * Oldest terminal-run cursor in this page, or null when the terminal window is empty. + */ + oldestSeq?: number | null; + /** + * Newest terminal-run cursor in this page, or null when the terminal window is empty. + */ + newestSeq?: number | null; + /** + * Whether terminal runs newer than this page exist. + */ + hasMoreNewer?: boolean; + /** + * Number of terminal runs older than this page. + */ + omittedOlder?: number; +} +/** + * Durable workflow run summary with read-time live overlays. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunSummary". + */ +/** @experimental */ +export interface WorkflowRunSummary { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Registered workflow name. + */ + workflowName: string; + /** + * Human-readable workflow description. + */ + description: string; + status: WorkflowRunStatus; + /** + * Monotonic durable run revision. + */ + revision: number; + /** + * Epoch milliseconds when the run was created. + */ + createdAt: number; + /** + * Epoch milliseconds when execution first started, or null before start. + */ + startedAt: number | null; + /** + * Epoch milliseconds when the durable run was last updated. + */ + updatedAt: number; + /** + * Epoch milliseconds when the run completed, or null while nonterminal. + */ + completedAt: number | null; + /** + * Current phase identity, or null before any phase is entered. + */ + currentPhase: WorkflowCurrentPhase | null; + /** + * Number of phases declared by the workflow. + */ + declaredPhaseCount: number; + /** + * Number of direct workflow agents currently live. + */ + liveAgentCount: number; + /** + * Total direct workflow agents spawned across all attempts. + */ + totalSpawnedAgentCount: number; + consumed: WorkflowRunConsumed; + declaredLimits: WorkflowDeclaredLimits; + /** + * Approved effective resource ceilings, or null until approved. + */ + approved: WorkflowDeclaredLimits | null; + /** + * Epoch milliseconds when this live-overlay snapshot was observed. + */ + observedAt: number; + /** + * Epoch milliseconds when the current active segment started, or null while inactive. + */ + activeSegmentStartedAt: number | null; + /** + * Terminal run outcome, or null while nonterminal. + */ + terminal: WorkflowRunTerminal | null; + /** + * Whether the durable run state currently passes runtime resume eligibility checks. + */ + canResume: boolean; +} +/** + * Durable workflow resource consumption. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunConsumed". + */ +/** @experimental */ +export interface WorkflowRunConsumed { + /** + * Accumulated active execution time in milliseconds. + */ + activeMs: number; + /** + * Total subagents spawned by the run. + */ + subagents: number; + /** + * AI usage consumed by the run in nano-AIU. + */ + nanoAiu: number; +} +/** + * Prompt-safe terminal workflow outcome. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunTerminal". + */ +/** @experimental */ +export interface WorkflowRunTerminal { + /** + * Human-readable terminal reason. + */ + reason?: string; + failure?: WorkflowRunFailure; + /** + * Human-readable terminal error. + */ + error?: string; + /** + * Prompt-safe preview of the completed result. + */ + resultPreview?: string; + /** + * Pause initiator metadata, or null when the run did not pause. + */ + pauseInfo: WorkflowPauseInfo | null; +} +/** + * One ordered workflow progress line. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowLogLine". + */ +/** @experimental */ +export interface WorkflowLogLine { + /** + * Monotonic sequence number within the workflow run. + */ + seq: number; + kind: WorkflowLogLineKind; + /** + * Progress text. + */ + text: string; +} +/** + * Parameters for recording workflow progress. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowLogRequest". + */ +/** @experimental */ +export interface WorkflowLogRequest { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Opaque token identifying the current workflow execution attempt. + */ + executionToken: string; + /** + * Ordered progress lines to append. + */ + lines: WorkflowLogLine[]; +} +/** + * Parameters for an owned durable pause checkpoint. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowPauseCheckpointRequest". + */ +/** @experimental */ +export interface WorkflowPauseCheckpointRequest { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Opaque token identifying the execution attempt that reached the checkpoint. + */ + executionToken: string; + /** + * Stable author-defined checkpoint key. + */ + key: string; +} + +/** @experimental */ +export interface WorkflowPauseCheckpointResult { + action: WorkflowPauseCheckpointAction; +} +/** + * Parameters for pausing a running workflow. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowPauseRequest". + */ +/** @experimental */ +export interface WorkflowPauseRequest { + /** + * Workflow run identifier. + */ + runId: string; +} +/** + * Durable lifecycle and timing for one workflow phase. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowPhaseObservation". + */ +/** @experimental */ +export interface WorkflowPhaseObservation { + /** + * Phase identifier. + */ + id: string; + /** + * Zero-based declared phase ordinal, or null for an undeclared phase. + */ + ordinal: number | null; + /** + * Human-readable phase title. + */ + title: string; + /** + * Optional human-readable phase detail. + */ + detail?: string; + status: WorkflowPhaseStatus; + /** + * Most recent run attempt that entered this phase, or `0` if the phase has never been entered. + */ + lastEnteredRunAttempt: number; + /** + * Number of times execution entered this phase. + */ + entryCount: number; + /** + * Epoch milliseconds when this phase first started; for a skipped phase, the synthetic skip timestamp (equal to `completedAt`). + */ + startedAt?: number; + /** + * Epoch milliseconds when this phase completed; for a skipped phase, the synthetic skip timestamp (equal to `startedAt`). + */ + completedAt?: number; + /** + * Completed active time accumulated by this phase in milliseconds. + */ + accumulatedActiveMs: number; + /** + * Current live active time for this phase in milliseconds. + */ + currentActiveMs: number; + /** + * Total direct agents associated with this phase. + */ + totalAgentCount: number; + /** + * Direct agents in this phase that are currently live. + */ + liveAgentCount: number; +} +/** + * One durable workflow progress record. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowProgressLine". + */ +/** @experimental */ +export interface WorkflowProgressLine { + /** + * Global monotonic sequence number within the run. + */ + seq: number; + /** + * Resume attempt that emitted this record. + */ + attempt: number; + /** + * Phase active when the record was emitted, or null before any phase. + */ + phaseId: string | null; + /** + * Epoch milliseconds when the record was persisted. + */ + recordedAt: number; + kind: WorkflowLogLineKind; + /** + * Prompt-safe progress text. + */ + text: string; +} +/** + * A bidirectional page of workflow progress. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowProgressPage". + */ +/** @experimental */ +export interface WorkflowProgressPage { + /** + * Progress records in sequence order. + */ + records: WorkflowProgressLine[]; + /** + * Oldest sequence number in this page, or null when empty. + */ + oldestSeq: number | null; + /** + * Newest sequence number in this page, or null when empty. + */ + newestSeq: number | null; + /** + * Whether progress records older than this page exist. + */ + hasMoreOlder: boolean; + /** + * Whether progress records newer than this page exist. + */ + hasMoreNewer: boolean; + /** + * Run revision reflected by this page. + */ + revision: number; +} +/** + * Parameters for resuming a workflow run from its persisted identity. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowResumeRequest". + */ +/** @experimental */ +export interface WorkflowResumeRequest { + /** + * Workflow run identifier. + */ + runId: string; + limits?: WorkflowRunLimits; + /** + * Whether to notify the originating session when the workflow completes. + */ + notifyOnComplete?: boolean; + /** + * Whether to emit workflow phase names to the session transcript. + */ + logPhaseNames?: boolean; +} +/** + * Wire-only per-invocation workflow resource ceiling overrides. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunLimits". + */ +/** @experimental */ +export interface WorkflowRunLimits { + /** + * Maximum number of workflow subagents that may run concurrently. + */ + maxConcurrentSubagents?: number | null; + /** + * Maximum total number of workflow subagents that may be admitted. + */ + maxTotalSubagents?: number | null; + /** + * Maximum accumulated active-execution time in seconds. Active execution includes the entire extension body, subprocess waits, queued-agent waits, and sleeps; time between resumed attempts is not counted. + */ + timeoutSeconds?: number | null; + /** + * Maximum AI credits consumed by workflow subagents and their descendants. The post-paid ceiling is soft: parallel turns can settle beyond it before the run stops. + */ + maxAiCredits?: number | null; +} +/** + * Resolved persisted workflow identity and resumed run envelope. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowResumeResult". + */ +/** @experimental */ +export interface WorkflowResumeResult { + /** + * Persisted workflow name resolved for the resumed run. + */ + workflowName: string; + run: WorkflowRunResult; +} +/** + * Complete current or terminal workflow run envelope. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunResult". + */ +/** @experimental */ +export interface WorkflowRunResult { + /** + * Workflow run identifier. + */ + runId: string; + /** + * One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. + */ + attempt?: number; + status: WorkflowRunStatus; + /** + * Completed workflow result. + */ + result?: JsonValue; + /** + * Error message for an errored run. + */ + error?: string; + failure?: WorkflowRunFailure; + /** + * Reason for a halted or cancelled run. + */ + reason?: string; + /** + * Partial journal and progress snapshot for a halted, cancelled, or errored run. + */ + snapshot?: JsonValue; + pauseInfo?: WorkflowPauseInfo; +} +/** + * Full workflow run observability detail. + * + * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema + * via the `definition` "WorkflowRunDetail". + */ +/** @experimental */ +export interface WorkflowRunDetail { + /** + * Workflow run identifier. + */ + runId: string; + /** + * Registered workflow name. + */ + workflowName: string; + /** + * Human-readable workflow description. + */ + description: string; + status: WorkflowRunStatus; + /** + * Monotonic durable run revision. + */ + revision: number; + /** + * Epoch milliseconds when the run was created. + */ + createdAt: number; + /** + * Epoch milliseconds when execution first started, or null before start. + */ + startedAt: number | null; + /** + * Epoch milliseconds when the durable run was last updated. + */ + updatedAt: number; + /** + * Epoch milliseconds when the run completed, or null while nonterminal. + */ + completedAt: number | null; + /** + * Current phase identity, or null before any phase is entered. + */ + currentPhase: WorkflowCurrentPhase | null; + /** + * Number of phases declared by the workflow. + */ + declaredPhaseCount: number; + /** + * Number of direct workflow agents currently live. + */ + liveAgentCount: number; + /** + * Total direct workflow agents spawned across all attempts. + */ + totalSpawnedAgentCount: number; + consumed: WorkflowRunConsumed; + declaredLimits: WorkflowDeclaredLimits; + /** + * Approved effective resource ceilings, or null until approved. + */ + approved: WorkflowDeclaredLimits | null; + /** + * Epoch milliseconds when this live-overlay snapshot was observed. + */ + observedAt: number; + /** + * Epoch milliseconds when the current active segment started, or null while inactive. + */ + activeSegmentStartedAt: number | null; + /** + * Terminal run outcome, or null while nonterminal. + */ + terminal: WorkflowRunTerminal | null; + /** + * Whether the durable run state currently passes runtime resume eligibility checks. + */ + canResume: boolean; + /** + * Lifecycle and timing observations for each workflow phase. */ - exitCode?: number | null; + phases: WorkflowPhaseObservation[]; /** - * Error output when the execution failed + * Durable identities and live statuses for direct workflow agents. */ - error?: string; + agents: WorkflowAgentSummary[]; + progress: WorkflowProgressPage; } /** - * A single user setting's effective value alongside its default, so consumers can render settings left at their default. + * Options controlling workflow invocation. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "UserSettingMetadata". + * via the `definition` "WorkflowRunOptions". */ /** @experimental */ -export interface UserSettingMetadata { - /** - * The effective value: the user's value if set, otherwise the default. - */ - value: JsonValue; +export interface WorkflowRunOptions { + limits?: WorkflowRunLimits; /** - * The centrally-known default for this setting (null when no default is registered). + * Whether to notify the originating session when the workflow completes. */ - default: JsonValue; + notifyOnComplete?: boolean; /** - * True when the user has not set an explicit value for this setting (i.e. it is left at its default). Reflects whether the user has overridden the key, not whether the effective value happens to equal the default — a key explicitly set to a value identical to the default still reports false. + * Whether to emit workflow phase names to the session transcript. */ - isDefault: boolean; -} -/** - * Per-key metadata for every known user setting (settings.json overlaid with the legacy config.json, config.json wins), including settings left at their default. Excludes repository- and enterprise-managed overrides. - * - * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "UserSettingsGetResult". - */ -/** @experimental */ -export interface UserSettingsGetResult { + logPhaseNames?: boolean; /** - * Every known user setting keyed by setting name, each with its effective value, default, and whether it is at the default. + * Run identifier whose journal and progress should seed this resumed run. */ - settings: { - [k: string]: UserSettingMetadata; - }; + resumeFromRunId?: string; } /** - * 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. + * Parameters for invoking a registered workflow. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "UserSettingsSetRequest". + * via the `definition` "WorkflowRunRequest". */ /** @experimental */ -export interface UserSettingsSetRequest { +export interface WorkflowRunRequest { /** - * Partial user settings to write, as a free-form object keyed by setting name + * Registered workflow name. */ - settings: JsonValue; -} -/** - * Outcome of writing user settings. - * - * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "UserSettingsSetResult". - */ -/** @experimental */ -export interface UserSettingsSetResult { + name: string; /** - * Top-level keys whose write landed in settings.json but is shadowed by a value still present in the legacy config.json (config.json wins on read). The write does not take effect until the legacy value is removed. + * Workflow input value. */ - shadowedKeys: string[]; + args: JsonValue; + options?: WorkflowRunOptions; } /** - * Current sharing status and shareable GitHub URL for a session. + * Internal parameters for resuming a workflow run from a tool. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "VisibilityGetResult". + * via the `definition` "WorkflowToolResumeRequest". */ /** @experimental */ -export interface VisibilityGetResult { +/** @internal */ +export interface WorkflowToolResumeRequest { /** - * Whether the session has been synced to Mission Control (i.e. has a GitHub task). When false, the session cannot be shared and `status`/`shareUrl` are absent. + * Workflow run identifier. */ - synced: boolean; - status?: SessionVisibilityStatus; + runId: string; + limits?: WorkflowRunLimits; /** - * Shareable GitHub URL for the session. Present when the session is synced and the URL can be resolved. + * Opaque identifier of the originating tool call. */ - shareUrl?: string; + toolCallId?: string; } /** - * Desired sharing status for the session. + * Options for an internal tool-originated workflow invocation. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "VisibilitySetRequest". + * via the `definition` "WorkflowToolRunOptions". */ /** @experimental */ -export interface VisibilitySetRequest { - status: SessionVisibilityStatus; +/** @internal */ +export interface WorkflowToolRunOptions { + limits?: WorkflowRunLimits; + /** + * Run identifier whose journal and progress should seed this resumed run. + */ + resumeFromRunId?: string; } /** - * Effective sharing status and shareable GitHub URL after updating session visibility. + * Internal parameters for invoking a registered workflow from a tool. * * This interface was referenced by `_RpcSchemaRoot`'s JSON-Schema - * via the `definition` "VisibilitySetResult". + * via the `definition` "WorkflowToolRunRequest". */ /** @experimental */ -export interface VisibilitySetResult { +/** @internal */ +export interface WorkflowToolRunRequest { /** - * Whether the session has been synced to Mission Control (i.e. has a GitHub task). When false, the visibility change could not be applied and `status`/`shareUrl` are absent. + * Registered workflow name. */ - synced: boolean; - status?: SessionVisibilityStatus; + name: string; /** - * Shareable GitHub URL for the session. Present when the session is synced and the URL can be resolved. + * Workflow input value. */ - shareUrl?: string; + args: JsonValue; + options?: WorkflowToolRunOptions; + /** + * Opaque identifier of the originating tool call. + */ + toolCallId?: string; } /** * A single changed file and its unified diff. @@ -24490,6 +26333,11 @@ export interface SessionFactoryPauseAtCheckpointResult { action: FactoryPauseCheckpointAction; } +/** @experimental */ +export interface SessionWorkflowPauseAtCheckpointResult { + action: WorkflowPauseCheckpointAction; +} + /** @experimental */ export interface SessionModelListRequest { /** @@ -24520,6 +26368,14 @@ export interface SessionMcpAppsCallToolResult { [k: string]: JsonValue | undefined; } +/** @experimental */ +export interface SessionPluginsMarketplacesRefreshRequest { + /** + * Marketplace name to refresh. When omitted, every registered marketplace is refreshed. + */ + name?: string; +} + /** @experimental */ export interface SessionPluginsReloadRequest { /** @@ -24848,6 +26704,15 @@ export function createServerRpc(connection: MessageConnection) { */ search: async (params: CatalogSearchRequest): Promise => connection.sendRequest("catalog.search", params), + /** + * Terminates one retained catalog selection group. A selected outcome returns the native host a fresh single-use candidate handle plus the original searchId for a later explicit mcp.planInstall call; non-selected outcomes release the group without producing a planning input. Candidate state, cards, URLs, credentials and private identifiers remain inside the runtime. The model-facing catalog_select tool projects the result separately and never exposes the candidate handle or searchId. + * + * @param params Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection. + * + * @returns Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId. + */ + select: async (params: CatalogSelectionRequest): Promise => + connection.sendRequest("catalog.select", params), }, /** @experimental */ plugins: { @@ -25106,7 +26971,7 @@ export function createServerRpc(connection: MessageConnection) { /** * Registers an SDK client as the session filesystem provider. * - * @param params Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. + * @param params Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots. * * @returns Indicates whether the calling client was registered as the session filesystem provider. */ @@ -25745,6 +27610,120 @@ export function createSessionRpc(connection: MessageConnection, sessionId: strin }, }, /** @experimental */ + workflow: { + /** + * Runs a registered dynamic workflow by name at the top level. + * + * @param params Parameters for invoking a registered workflow. + * + * @returns Complete current or terminal workflow run envelope. + */ + run: async (params: WorkflowRunRequest): Promise => + connection.sendRequest("session.workflow.run", { sessionId, ...params }), + /** + * Resumes a dynamic workflow run using its persisted name, arguments, journal, and accounting. + * + * @param params Parameters for resuming a workflow run from its persisted identity. + * + * @returns Resolved persisted workflow identity and resumed run envelope. + */ + resume: async (params: WorkflowResumeRequest): Promise => + connection.sendRequest("session.workflow.resume", { sessionId, ...params }), + /** + * Gets the current or settled envelope for a dynamic workflow run. + * + * @param params Parameters for retrieving a workflow run. + * + * @returns Complete current or terminal workflow run envelope. + */ + getRun: async (params: WorkflowGetRunRequest): Promise => + connection.sendRequest("session.workflow.getRun", { sessionId, ...params }), + /** + * Lists durable dynamic workflow runs for this session in creation order. + * + * @param params Parameters for paging workflow runs. + * + * @returns A page of workflow runs in durable creation order. + */ + listRuns: async (params: WorkflowListRunsRequest): Promise => + connection.sendRequest("session.workflow.listRuns", { sessionId, ...params }), + /** + * Gets durable and live observability detail for one dynamic workflow run. + * + * @param params Parameters for retrieving a workflow run. + * + * @returns Full workflow run observability detail. + */ + getRunDetail: async (params: WorkflowGetRunRequest): Promise => + connection.sendRequest("session.workflow.getRunDetail", { sessionId, ...params }), + /** + * Pages durable progress for one dynamic workflow run. + * + * @param params Parameters for paging workflow progress. + * + * @returns A bidirectional page of workflow progress. + */ + getRunProgress: async (params: WorkflowGetRunProgressRequest): Promise => + connection.sendRequest("session.workflow.getRunProgress", { sessionId, ...params }), + /** + * Requests cancellation of a dynamic workflow run and returns its run envelope. + * + * @param params Parameters for cancelling a workflow run. + * + * @returns Complete current or terminal workflow run envelope. + */ + cancel: async (params: WorkflowCancelRequest): Promise => + connection.sendRequest("session.workflow.cancel", { sessionId, ...params }), + /** + * Pauses a running dynamic workflow and returns its settled run envelope. + * + * @param params Parameters for pausing a running workflow. + * + * @returns Complete current or terminal workflow run envelope. + */ + pause: async (params: WorkflowPauseRequest): Promise => + connection.sendRequest("session.workflow.pause", { sessionId, ...params }), + /** + * Records a batch of ordered dynamic workflow progress lines. + * + * @param params Parameters for recording workflow progress. + * + * @returns Acknowledgement that a workflow request was accepted. + */ + log: async (params: WorkflowLogRequest): Promise => + connection.sendRequest("session.workflow.log", { sessionId, ...params }), + /** + * Runs one dynamic-workflow-scoped subagent and returns its result. + * + * @param params Parameters for one workflow-scoped subagent call. + * + * @returns Result of one workflow-scoped subagent call. + */ + agent: async (params: WorkflowAgentRequest): Promise => + connection.sendRequest("session.workflow.agent", { sessionId, ...params }), + /** @experimental */ + journal: { + /** + * Reads a memoized dynamic workflow journal entry. + * + * @param params Parameters for reading a workflow journal entry. + * + * @returns Result of reading a workflow journal entry. + */ + get: async (params: WorkflowJournalGetRequest): Promise => + connection.sendRequest("session.workflow.journal.get", { sessionId, ...params }), + /** + * Stores a memoized dynamic workflow journal entry. + * + * @param params Parameters for storing a workflow journal entry. + * + * @returns Acknowledgement that a workflow request was accepted. + */ + put: async (params: WorkflowJournalPutRequest): Promise => + connection.sendRequest("session.workflow.journal.put", { sessionId, ...params }), + }, + }, + /** @experimental */ model: { /** * Gets the session's authoritative model snapshot, including the committed Auto preference and any newer unclaimed Auto preference waiting for a future user turn. @@ -26545,14 +28524,109 @@ export function createSessionRpc(connection: MessageConnection, sessionId: strin }, }, /** @experimental */ + managedSettings: { + /** + * Waits for the live session's in-flight managed-settings application, then returns the retained effective snapshot used by runtime enforcement and by `session.managed_settings_resolved`. It does not perform another account, device, or server resolution, and rejects when resolution has not produced a snapshot. + * + * @returns Enterprise managed-settings resolution: the effective managed settings the session applied and which channels contributed, so SDK clients can show users what is enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on resume, and on account switch. This is an ephemeral live snapshot (delivered to subscribers but not persisted to the session event log), because at session start it resolves before `session.start` is emitted. Device values take precedence over server values, then the policy helper, per ordinary key, while permissions compose restrictively across device, server, policy-helper, and SDK-client layers. The account-scoped `getManagedSettings()` API does not include session-local client injection. Marked experimental while the managed-settings surface stabilizes. + */ + get: async (): Promise => + connection.sendRequest("session.managedSettings.get", { sessionId }), + }, + /** @experimental */ plugins: { /** - * Lists plugins installed for the session. + * Lists globally installed, live, built-in, and enterprise-managed desired plugins using the live session's authoritative account, working directory, and retained managed policy. * * @returns Plugins installed for the session, with their enabled state and version metadata. */ list: async (): Promise => connection.sendRequest("session.plugins.list", { sessionId }), + /** + * Installs a plugin using the live session's authoritative account, working directory, and retained managed policy. + * + * @param params Plugin source resolved relative to the session's authoritative working directory. + * + * @returns Result of installing a plugin. + */ + install: async (params: SessionPluginsInstallRequest): Promise => + connection.sendRequest("session.plugins.install", { sessionId, ...params }), + /** + * Uninstalls a plugin when permitted by the live session's retained managed policy. + * + * @param params Name (or spec) of the plugin to uninstall. + */ + uninstall: async (params: PluginsUninstallRequest): Promise => + connection.sendRequest("session.plugins.uninstall", { sessionId, ...params }), + /** + * Updates an installed plugin using the live session's authoritative account, working directory, and retained managed policy. + * + * @param params Name (or spec) of the plugin to update. + * + * @returns Result of updating a single plugin. + */ + update: async (params: PluginsUpdateRequest): Promise => + connection.sendRequest("session.plugins.update", { sessionId, ...params }), + /** + * Enables installed plugins when permitted by the live session's retained managed policy. + * + * @param params Plugin names (or specs) to enable in the session's authoritative working directory. + */ + enable: async (params: SessionPluginsEnableRequest): Promise => + connection.sendRequest("session.plugins.enable", { sessionId, ...params }), + /** + * Disables installed plugins when permitted by the live session's retained managed policy. + * + * @param params Plugin names (or specs) to disable in the session's authoritative working directory. + */ + disable: async (params: SessionPluginsDisableRequest): Promise => + connection.sendRequest("session.plugins.disable", { sessionId, ...params }), + /** @experimental */ + marketplaces: { + /** + * Lists registered and enterprise-managed desired marketplaces using the live session's retained policy. + * + * @returns All registered marketplaces, including built-in defaults. + */ + list: async (): Promise => + connection.sendRequest("session.plugins.marketplaces.list", { sessionId }), + /** + * Adds a marketplace when permitted by the live session's retained managed policy. + * + * @param params Marketplace source and optional working directory for relative-path resolution. + * + * @returns Result of registering a new marketplace. + */ + add: async (params: PluginsMarketplacesAddRequest): Promise => + connection.sendRequest("session.plugins.marketplaces.add", { sessionId, ...params }), + /** + * Removes a marketplace when permitted by the live session's retained managed policy. + * + * @param params Name of the marketplace to remove and an optional force flag. + * + * @returns Outcome of the remove attempt, including dependent-plugin info when applicable. + */ + remove: async (params: PluginsMarketplacesRemoveRequest): Promise => + connection.sendRequest("session.plugins.marketplaces.remove", { sessionId, ...params }), + /** + * Browses a marketplace resolved through the live session's working directory and retained managed policy. + * + * @param params Name of the marketplace whose plugin catalog to fetch. + * + * @returns Plugins advertised by the marketplace. + */ + browse: async (params: PluginsMarketplacesBrowseRequest): Promise => + connection.sendRequest("session.plugins.marketplaces.browse", { sessionId, ...params }), + /** + * Refreshes marketplaces resolved through the live session's working directory and retained managed policy. + * + * @param params Optional marketplace name; omit to refresh all. + * + * @returns Result of refreshing one or more marketplace catalogs. + */ + refresh: async (params?: SessionPluginsMarketplacesRefreshRequest): Promise => + connection.sendRequest("session.plugins.marketplaces.refresh", { sessionId, ...params }), + }, /** * 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. * @@ -27349,6 +29423,24 @@ export function createSessionRpc(connection: MessageConnection, sessionId: strin */ updateText: async (params: QueueUpdateTextRequest): Promise => connection.sendRequest("session.queue.updateText", { sessionId, ...params }), + /** + * Atomically withdraws an unchanged, unconsumed user message from the local queued or steering lane. A client retaining the original draft may restore it only when removed is true. Does not interrupt the running turn. + * + * @param params Conditional withdrawal of a single user message, before the runtime claims it for delivery. + * + * @returns Result of removing a queued item. + */ + withdrawMessage: async (params: QueueWithdrawMessageRequest): Promise => + connection.sendRequest("session.queue.withdrawMessage", { sessionId, ...params }), + /** + * Atomically appends text and attachments to an unchanged, unconsumed local steering message. Returns updated=false if delivery or withdrawal already claimed the message. + * + * @param params Append to one pending steering message without changing its identity or delivery position. + * + * @returns Result of editing a queued message. + */ + appendSteering: async (params: QueueAppendSteeringRequest): Promise => + connection.sendRequest("session.queue.appendSteering", { sessionId, ...params }), /** * Duplicates an addressable queued item immediately after its source. * @@ -27641,6 +29733,34 @@ export function createInternalSessionRpc(connection: MessageConnection, sessionI connection.sendRequest("session.factory.pauseAtCheckpoint", { sessionId, ...params }), }, /** @experimental */ + workflow: { + /** + * Internal tool-originated dynamic workflow invocation. + * + * @param params Internal parameters for invoking a registered workflow from a tool. + * + * @returns Complete current or terminal workflow run envelope. + */ + runFromTool: async (params: WorkflowToolRunRequest): Promise => + connection.sendRequest("session.workflow.runFromTool", { sessionId, ...params }), + /** + * Internal tool-originated dynamic workflow resume. + * + * @param params Internal parameters for resuming a workflow run from a tool. + * + * @returns Resolved persisted workflow identity and resumed run envelope. + */ + resumeFromTool: async (params: WorkflowToolResumeRequest): Promise => + connection.sendRequest("session.workflow.resumeFromTool", { sessionId, ...params }), + /** + * Atomically pauses an owned dynamic workflow attempt at a durable checkpoint. + * + * @param params Parameters for an owned durable pause checkpoint. + */ + pauseAtCheckpoint: async (params: WorkflowPauseCheckpointRequest): Promise => + connection.sendRequest("session.workflow.pauseAtCheckpoint", { sessionId, ...params }), + }, + /** @experimental */ model: { /** * Resolves and applies organization-managed and repository model overlays. @@ -27878,6 +29998,27 @@ export interface FactoryHandler { abort(params: FactoryAbortRequest): Promise; } +/** Handler for `workflow` client session API methods. */ +/** @experimental */ +export interface WorkflowHandler { + /** + * Asks the owning extension connection to execute a registered dynamic workflow. + * + * @param params Parameters sent to the owning extension to execute a workflow closure. + * + * @returns Result returned by an extension workflow closure. + */ + execute(params: WorkflowExecuteRequest): Promise; + /** + * Asks the owning extension connection to abort a running dynamic workflow cooperatively. + * + * @param params Parameters for cooperatively aborting a workflow body. + * + * @returns Acknowledgement that a workflow request was accepted. + */ + abort(params: WorkflowAbortRequest): Promise; +} + /** Handler for `tasks` client session API methods. */ /** @experimental */ export interface TasksHandler { @@ -28031,6 +30172,7 @@ export interface CanvasHandler { export interface ClientSessionApiHandlers { providerToken?: ProviderTokenHandler; factory?: FactoryHandler; + workflow?: WorkflowHandler; tasks?: TasksHandler; sessionFs?: SessionFsHandler; canvas?: CanvasHandler; @@ -28061,6 +30203,16 @@ export function registerClientSessionApiHandlers( if (!handler) throw new Error(`No factory handler registered for session: ${params.sessionId}`); return handler.abort(params); }); + connection.onRequest("workflow.execute", async (params: WorkflowExecuteRequest) => { + const handler = getHandlers(params.sessionId).workflow; + if (!handler) throw new Error(`No workflow handler registered for session: ${params.sessionId}`); + return handler.execute(params); + }); + connection.onRequest("workflow.abort", async (params: WorkflowAbortRequest) => { + const handler = getHandlers(params.sessionId).workflow; + if (!handler) throw new Error(`No workflow handler registered for session: ${params.sessionId}`); + return handler.abort(params); + }); connection.onRequest("tasks.cancel", async (params: ClientTaskCancelRequest) => { const handler = getHandlers(params.sessionId).tasks; if (!handler) throw new Error(`No tasks handler registered for session: ${params.sessionId}`); diff --git a/nodejs/src/generated/session-events.ts b/nodejs/src/generated/session-events.ts index acaf485146..a5fd0337c6 100644 --- a/nodejs/src/generated/session-events.ts +++ b/nodejs/src/generated/session-events.ts @@ -21,6 +21,7 @@ export type SessionEvent = | ScheduleRearmedEvent | AutopilotObjectiveChangedEvent | InfoEvent + | IndexedSearchEvent | WarningEvent | ModelChangeEvent | AutoTierRecommendationEvent @@ -48,6 +49,7 @@ export type SessionEvent = | FusionRouteFailedEvent | FusionResolvedEvent | FusionCompletedEvent + | PermissionRecoveryEvent | UserMessageEvent | PendingMessagesModifiedEvent | AssistantTurnStartEvent @@ -250,6 +252,169 @@ export type AutopilotObjectiveChangedStatus = | "cap_reached" /** Objective was completed by the agent. */ | "completed"; +/** + * Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. + */ +export type IndexedSearchData = + | { + /** + * Indexed-search event variant discriminator. + */ + kind: "status"; + state: IndexedSearchState; + } + | { + disabledReason?: IndexedSearchDisabledReason; + /** + * Whether the repository meets the automatic indexing file-count threshold, when known. + */ + eligible?: boolean; + /** + * Startup failure details. May contain sensitive user data; restricted telemetry only. + */ + errorMessage?: string; + /** + * Number of text files counted in the repository. + */ + fileCount?: number; + /** + * Whether indexed search was explicitly enabled through the environment. + */ + forcedByEnv: boolean; + /** + * Indexed-search event variant discriminator. + */ + kind: "startup"; + outcome: IndexedSearchOutcome; + /** + * Wall-clock duration of startup in milliseconds. + */ + startupDurationMs: number; + /** + * Whether waiting for index readiness was requested, including skipped attempts. + */ + warmStart: boolean; + } + | { + /** + * Server failure details. May contain sensitive user data; restricted telemetry only. + */ + errorMessage?: string; + errorType: IndexedSearchErrorType; + /** + * Process exit code, when available. + */ + exitCode?: number; + /** + * Indexed-search event variant discriminator. + */ + kind: "server_error"; + } + | { + /** + * Number of added files. + */ + addedFileCount?: number; + /** + * Number of modified files. + */ + changedFileCount?: number; + /** + * Number of deleted files. + */ + deletedFileCount?: number; + /** + * Indexed-search event variant discriminator. + */ + kind: "incremental"; + phase: IndexedSearchIncrementalPhase; + /** + * Total number of detected changes. + */ + totalChangeCount?: number; + /** + * Total incremental indexing duration in milliseconds. + */ + totalDurationMs?: number; + /** + * Index update duration in milliseconds. + */ + updateDurationMs?: number; + /** + * Workspace scan duration in milliseconds. + */ + walkDurationMs?: number; + }; +/** + * Live indexed-search state for this session activation, never inferred from persisted history. + */ +export type IndexedSearchState = + /** Indexed search is not active for this session. */ + | "disabled" + /** Indexed-search startup is in progress. */ + | "starting" + /** The indexed-search server started successfully; its index may still be warming. */ + | "enabled" + /** The indexed-search server and its index are ready. */ + | "ready" + /** Indexed-search startup or the active server failed. */ + | "failed"; +/** + * Configuration, policy, or workspace condition that disabled indexed search. + */ +export type IndexedSearchDisabledReason = + /** Indexed search was explicitly disabled by the environment. */ + | "use_tgrep_false" + /** Search uses the external ripgrep binary instead of bundled search. */ + | "use_builtin_ripgrep_false" + /** Organization policy disables indexed search. */ + | "organization" + /** Authentication has not resolved organization policy. */ + | "organization_policy_auth_pending" + /** Organization policy could not be determined. */ + | "organization_policy_unknown" + /** The workspace uses a virtualized or network filesystem. */ + | "virtual_filesystem" + /** The workspace is inside a Windows cloud-sync root. */ + | "cloud_sync_root" + /** The Windows cloud-sync safety check failed. */ + | "cloud_sync_detection_failed" + /** The workspace is not available on the runtime's local filesystem. */ + | "workspace_not_local"; +/** + * Result of an indexed-search startup attempt. + */ +export type IndexedSearchOutcome = + /** A new indexed-search server was started. */ + | "started" + /** The repository has too few files for automatic indexing. */ + | "skipped_below_threshold" + /** No Git repository was found and indexing was not forced. */ + | "skipped_no_gitroot" + /** Configuration, policy, or workspace safety disabled indexing. */ + | "skipped_disabled" + /** An existing indexed-search server was reused. */ + | "reused_existing" + /** The startup attempt failed. */ + | "failed"; +/** + * Category of an indexed-search server failure. + */ +export type IndexedSearchErrorType = + /** The indexed-search server could not be spawned. */ + | "spawn_error" + /** The indexed-search server exited unexpectedly. */ + | "unexpected_exit" + /** The indexed-search server was terminated by a signal. */ + | "killed_by_signal"; +/** + * Phase of an incremental indexed-search update. + */ +export type IndexedSearchIncrementalPhase = + /** A workspace scan found changes to index. */ + | "changes_detected" + /** The incremental index update completed. */ + | "updated"; /** * Origin of an effective session model change. */ @@ -274,6 +439,8 @@ export type ModelChangeSource = | "plan_mode" /** The runtime selected the model automatically, such as rate-limit recovery or refusal fallback. */ | "automatic" + /** The user selected the promoted model from the changeboarding card or its keyboard shortcut. */ + | "changeboarding_shortcut" /** An SDK or RPC caller selected the model. */ | "sdk"; /** @@ -357,6 +524,94 @@ export type CompactionTrigger = | "memory_pressure" /** Compaction requested while switching to a model with a smaller context window. */ | "model_switch"; +/** + * Category of structured task blocker + */ +export type TaskBlockerKind = + /** Autopilot permission recovery requires intervention or has no safe autonomous path. */ + "permission_recovery"; +/** + * Runtime handling applied to a recovery attempt + */ +export type PermissionRecoveryAttemptDisposition = + /** The request was denied without prompting so the agent could try an alternative. */ + | "deferred" + /** The request was surfaced to an interactive responder. */ + | "prompted" + /** The interactive responder approved the request. */ + | "approved" + /** The interactive responder denied the request or became unavailable. */ + | "denied" + /** The request exhausted unattended recovery and produced a blocked outcome. */ + | "blocked" + /** A tool call succeeded as an equivalent alternative. */ + | "succeeded"; +/** + * Controlled reason for an individual attempt disposition + */ +export type PermissionRecoveryAttemptReason = + /** The attempt required permission that Assisted Permissions could not grant. */ + | "permission_required" + /** The request repeated an earlier attempt. */ + | "repeated_attempt" + /** The request exceeded the bounded number of distinct attempts. */ + | "attempts_exhausted" + /** The interactive responder approved the request. */ + | "permission_approved" + /** The interactive responder denied the request. */ + | "permission_denied" + /** The interactive responder became unavailable. */ + | "responder_unavailable" + /** The tool call succeeded without the blocked permission. */ + | "equivalent_alternative_succeeded"; +/** + * Relationship of an attempt to earlier permission requests + */ +export type PermissionRecoveryAttemptRelation = + /** The first denied permission request in the episode. */ + | "initial" + /** A request equivalent to an earlier attempt. */ + | "retry" + /** A distinct request or a successful alternative tool call. */ + | "alternative"; +/** + * Action selected when autonomous recovery cannot continue + */ +export type PermissionRecoveryOnBlocked = + /** Surface the existing permission prompt to a response-capable client. */ + | "ask" + /** Return a structured unsuccessful blocked outcome because no responder is available. */ + | "fail"; +/** + * Controlled reason for a permission-recovery episode transition + */ +export type PermissionRecoveryReason = + /** An action required permission that Assisted Permissions could not grant. */ + | "permission_required" + /** The agent repeated an equivalent permission request instead of making progress. */ + | "repeated_attempt" + /** The bounded number of distinct permission attempts was exhausted. */ + | "attempts_exhausted" + /** A responder approved the escalated permission request. */ + | "permission_approved" + /** A responder denied the escalated permission request. */ + | "permission_denied" + /** The response-capable client became unavailable while escalation was pending. */ + | "responder_unavailable" + /** A later tool call succeeded without requiring the blocked permission. */ + | "equivalent_alternative_succeeded"; +/** + * Lifecycle state of a permission-recovery episode + */ +export type PermissionRecoveryStatus = + /** Autopilot may try a bounded equivalent alternative. */ + | "recovering" + /** An interactive permission response is required. */ + | "awaiting_approval" + /** The episode ended through approval or a successful equivalent alternative. */ + | "resolved" + /** No autonomous path remains and the task requires intervention. */ + | "blocked"; /** * Semantic result of evaluating a task completion request */ @@ -1933,6 +2188,36 @@ export interface InfoData { */ url?: string; } +/** + * Session event "session.indexed_search". Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. + */ +export interface IndexedSearchEvent { + /** + * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events. + */ + agentId?: string; + data: IndexedSearchData; + /** + * Always true for events that are transient and not persisted to the session event log on disk. + */ + ephemeral: true; + /** + * Unique event identifier (UUID v4), generated when the event is emitted + */ + id: string; + /** + * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event. + */ + parentId: string | null; + /** + * ISO 8601 timestamp when the event was created + */ + timestamp: string; + /** + * Type discriminator. Always "session.indexed_search". + */ + type: "session.indexed_search"; +} /** * Session event "session.warning". Warning message for timeline display with categorization */ @@ -3178,6 +3463,7 @@ export interface CompactionCompleteData { * GitHub request tracing ID (x-github-request-id header) for the compaction LLM call */ requestId?: string; + responsesReasoning?: ResponsesReasoning; /** * Copilot service request ID (x-copilot-service-request-id header) for the compaction LLM call */ @@ -3294,6 +3580,23 @@ export interface CompactionCompleteCompactionTokensUsedCopilotUsageTokenDetail { */ tokenType: string; } +/** + * Original request-level and effective conversation reasoning effort for a Responses history boundary + */ +export interface ResponsesReasoning { + /** + * Effective effort selected before this message, independent of the response-level reasoning field + */ + effort: string; + /** + * Original request-level effort, retained while replaying this conversation prefix + */ + initialEffort: string; + /** + * Provider model whose reasoning settings this boundary records + */ + model: string; +} /** * Session event "session.task_complete". Task completion notification with summary from the agent */ @@ -3328,6 +3631,7 @@ export interface TaskCompleteEvent { * Task completion notification with summary from the agent */ export interface TaskCompleteData { + blocker?: TaskBlocker; /** * Active autopilot objective ID evaluated by the completion reviewer */ @@ -3346,6 +3650,64 @@ export interface TaskCompleteData { */ summary?: string; } +/** + * Structured reason that the task cannot continue without intervention + */ +/** @experimental */ +export interface TaskBlocker { + kind: TaskBlockerKind; + permissionRecovery: PermissionRecoveryData; + reason: PermissionRecoveryReason; + /** + * Whether a later user response or steering message can resume the task + */ + resumable: boolean; +} +/** + * Authoritative snapshot of an Autopilot permission-recovery episode + */ +export interface PermissionRecoveryData { + /** + * Ordered privacy-safe record of permission attempts and the successful alternative, when any + */ + attempts: PermissionRecoveryAttempt[]; + /** + * Stable identifier shared by every transition in this recovery episode + */ + episodeId: string; + /** + * Maximum number of distinct autonomous permission attempts allowed before escalation + */ + maxAttempts: number; + onBlocked: PermissionRecoveryOnBlocked; + reason: PermissionRecoveryReason; + status: PermissionRecoveryStatus; +} +export interface PermissionRecoveryAttempt { + /** + * Unique identifier for this attempt record + */ + attemptId: string; + disposition: PermissionRecoveryAttemptDisposition; + /** + * One-based position of this attempt in the episode + */ + ordinal: number; + /** + * Controlled permission request kind, such as shell, path, URL, or tool + */ + permissionKind: string; + reason: PermissionRecoveryAttemptReason; + relation: PermissionRecoveryAttemptRelation; + /** + * SHA-256 fingerprint of normalized request data; raw permission arguments are not included + */ + requestFingerprint: string; + /** + * Tool-call identifier associated with this attempt, when available + */ + toolCallId?: string; +} /** * Session event "session.completion_receipt". Behavior-neutral record of structured runtime facts present when an agent completion decision is accepted. */ @@ -3818,6 +4180,36 @@ export interface FusionCompletedData { */ turnId: string; } +/** + * Session event "session.permission_recovery". Authoritative snapshot of an Autopilot permission-recovery episode + */ +export interface PermissionRecoveryEvent { + /** + * Sub-agent instance identifier. Absent for events from the root/main agent and session-level events. + */ + agentId?: string; + data: PermissionRecoveryData; + /** + * When true, the event is transient and not persisted to the session event log on disk + */ + ephemeral?: boolean; + /** + * Unique event identifier (UUID v4), generated when the event is emitted + */ + id: string; + /** + * ID of the chronologically preceding event in the session, forming a linked chain. Null for the first event. + */ + parentId: string | null; + /** + * ISO 8601 timestamp when the event was created + */ + timestamp: string; + /** + * Type discriminator. Always "session.permission_recovery". + */ + type: "session.permission_recovery"; +} /** * Session event "user.message". Payload of `user.message` with displayed and model-transformed content, attachments, source/delivery metadata, mode, and telemetry IDs. */ @@ -3882,6 +4274,7 @@ export interface UserMessageData { * Parent agent task ID for background telemetry correlated to this user turn */ parentAgentTaskId?: string; + responsesReasoning?: ResponsesReasoning; /** * Origin of this message, used for timeline filtering and attribution (e.g., `skill-pdf` for hidden skill injection or `agent-` for an inter-agent prompt) */ @@ -5764,6 +6157,18 @@ export interface AssistantUsageData { * Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation */ serviceRequestId?: string; + /** + * Number of prior thinking blocks the provider dropped while transforming the request + * + * @internal + */ + thinkingDroppedBlocks?: number; + /** + * Recognized provider-reported reasons for dropped thinking blocks, in response order + * + * @internal + */ + thinkingDroppedReasons?: string[]; /** * Time to first token in milliseconds. Only available for streaming requests */ @@ -7107,6 +7512,10 @@ export interface SkillInvokedData { * Whether model invocation is disabled for this skill */ disableModelInvocation?: boolean; + /** + * Projected chat-message count when the skill was invoked. New writers persist this so replay does not need to reconstruct superseded history; readers derive it for legacy events when absent. + */ + invokedAtTurn?: number; /** * Model identifier active when the skill was invoked, when known */ @@ -7859,6 +8268,7 @@ export interface SystemNotificationData { */ content: string; kind: SystemNotification; + responsesReasoning?: ResponsesReasoning; } /** * System notification metadata for a background agent that completed or failed, including agent ID, type, status, description, and prompt. @@ -8098,8 +8508,13 @@ export interface PermissionRequestedEvent { */ export interface PermissionRequestedData { agentMode?: SessionMode; + permissionMode?: PermissionMode; permissionRequest: PermissionRequest; promptRequest?: PermissionPromptRequest; + /** + * Permission-recovery episode that authorized this request to surface for interactive attention + */ + recoveryEpisodeId?: string; /** * Unique identifier for this permission request; used to respond via session.respondToPermission() */ @@ -8440,6 +8855,7 @@ export interface PermissionRequestMemory { */ /** @experimental */ export interface PermissionAssistedApproval { + evaluation?: PermissionApprovalEvaluation; failureReason?: AssistedApprovalJudgeFailureReason; /** * Model id that produced the recommendation, when the judge was consulted and reported one. Absent for `excluded` (the judge was not consulted) and for failures that occurred before a model was selected. @@ -8451,6 +8867,98 @@ export interface PermissionAssistedApproval { reason?: string; recommendation: AssistedApprovalRecommendation; } +/** + * Bounded runtime attribution, independent of free-text rationale. Telemetry revalidates this vocabulary before standard collection. + */ +export interface PermissionApprovalEvaluation { + /** + * Stage that produced this attribution. + */ + evaluationStage: /** The attribution stage is unknown. */ + | "unknown" + /** The request resolved before assisted-approval evaluation. */ + | "not_reached" + /** A runtime gate skipped the judge. */ + | "pre_judge" + /** The judge interface produced the evaluation. */ + | "judge" + /** A cached recommendation or another request's outcome was reused. */ + | "reuse"; + /** + * Whether the request invoked the judge interface. A cached recommendation retains the original attempt fact. Omitted means unknown, including inherited outcomes. + */ + judgeAttempted?: boolean; + /** + * Status of the local judge interface, not proof of a model network call. + */ + judgeStatus: /** No authoritative attribution is available. */ + | "unknown" + /** This evaluation did not invoke the judge interface. */ + | "not_called" + /** The judge interface returned a usable verdict. */ + | "completed" + /** The judge interface returned an error. */ + | "failed" + /** This evaluation reused a cached recommendation. */ + | "cached" + /** This request inherited another decision without local judge attribution. */ + | "inherited"; + /** + * Machine-readable runtime gate reason, never a command, path or human rationale. + */ + reasonCode: /** Attribution is missing or outside the supported vocabulary. */ + | "unknown" + /** The request resolved before assisted-approval evaluation. */ + | "not-reached" + /** Assisted approval was inactive for this request. */ + | "inactive" + /** The judge was skipped because authorization extraction could not safely establish a complete recent history. */ + | "authorization-history-incomplete" + /** Managed policy required a human decision. */ + | "managed-approval-required" + /** The request asked to bypass sandbox restrictions. */ + | "sandbox-bypass" + /** An action field exceeded the judge input limit. */ + | "action-too-long" + /** The script path was not authorized for inspection. */ + | "path-not-authorized" + /** The script working directory was invalid. */ + | "invalid-working-directory" + /** The script snapshot could not be read. */ + | "unreadable" + /** The script path was not a regular file. */ + | "not-regular-file" + /** The script snapshot exceeded the size limit. */ + | "too-large" + /** The script snapshot was not UTF-8. */ + | "non-utf8" + /** The script interpreter could not be inspected. */ + | "interpreter-unavailable" + /** The interpreter snapshot exceeded the size limit. */ + | "interpreter-too-large" + /** The shell environment could not be reviewed. */ + | "shell-environment-unreviewable" + /** A script path could not be represented for review. */ + | "unrepresentable-path" + /** An interpreter wrapped a script that could not be reviewed. */ + | "interpreter-wrapped-script" + /** The script invocation could not be reviewed. */ + | "unreviewable-script-invocation" + /** The script argument binding could not be reviewed. */ + | "argument-binding-unreviewable" + /** The script review metadata was malformed. */ + | "malformed-script-action-review" + /** The script snapshot manifest was malformed. */ + | "malformed-script-action-manifest" + /** Script review was unavailable. */ + | "unavailable" + /** The judge interface returned a usable verdict. */ + | "judge-verdict" + /** The judge interface returned an error. */ + | "judge-error" + /** The request inherited an outcome from another decision. */ + | "inherited"; +} /** * Custom tool invocation permission request */ @@ -9194,12 +9702,17 @@ export interface PermissionCompletedEvent { * Permission request completion notification signaling UI dismissal */ export interface PermissionCompletedData { + blocker?: TaskBlocker; /** * Who decided this permission request. Absent on completions recorded before this field existed, which consumers must treat as "not a human decision" rather than assuming one. Authorization records are minted only for `human_response`; an assisted-approval verdict, a host policy, an unattended fallback, and a hook resolution all produce the same `result` a person does, so this is the only field that distinguishes them. * * @experimental */ decisionSource?: PermissionDecisionSource; + /** + * Permission-recovery episode settled by this response, when the request was escalated by Autopilot + */ + recoveryEpisodeId?: string; /** * Request ID of the resolved permission request; clients should dismiss any UI for this request */ diff --git a/nodejs/test/csharp-codegen.test.ts b/nodejs/test/csharp-codegen.test.ts index f9b3281322..a0c802ac49 100644 --- a/nodejs/test/csharp-codegen.test.ts +++ b/nodejs/test/csharp-codegen.test.ts @@ -1,10 +1,231 @@ import type { JSONSchema7 } from "json-schema"; import { describe, expect, it } from "vitest"; -import { generateRpcCode } from "../../scripts/codegen/csharp.ts"; +import { generateRpcCode, generateSessionEventsCode } from "../../scripts/codegen/csharp.ts"; import type { ApiSchema } from "../../scripts/codegen/utils.ts"; +describe("C# root event payload unions", () => { + it.each(["anyOf", "oneOf"] as const)("preserves referenced %s payload variants", (keyword) => { + const code = generateSessionEventsCode({ + definitions: { + Payload: { + [keyword]: ["status", "startup", "server_error", "incremental"].map((kind) => ({ + type: "object", + properties: { kind: { const: kind }, value: { type: "string" } }, + required: ["kind", "value"], + })), + }, + SessionEvent: { + anyOf: [ + { + type: "object", + properties: { + type: { const: "sample.union" }, + data: { $ref: "#/definitions/Payload" }, + }, + required: ["type", "data"], + }, + { + type: "object", + properties: { + type: { const: "sample.empty" }, + data: { type: "object", properties: {} }, + }, + required: ["type", "data"], + }, + ], + }, + }, + }); + expect(code).toContain("public required SampleUnionData Data"); + expect(code).toContain('TypeDiscriminatorPropertyName = "kind"'); + for (const suffix of ["Status", "Startup", "ServerError", "Incremental"]) { + expect(code).toContain( + `public sealed partial class SampleUnionData${suffix} : SampleUnionData` + ); + expect(code).toContain(`[JsonSerializable(typeof(SampleUnionData${suffix}))]`); + } + expect(code).toContain("public required string Value"); + expect(code).toContain("public sealed partial class SampleEmptyData"); + expect(code).not.toContain("public sealed partial class SampleUnionData { }"); + }); +}); + describe("C# RPC codegen", () => { + it.each(["uninstall", "update"])( + "separates the session wire envelope from the shared plugins %s request", + (method) => { + const title = `Plugins${method === "uninstall" ? "Uninstall" : "Update"}Request`; + const params: JSONSchema7 = { + title, + type: "object", + properties: { + name: { type: "string" }, + directSourceId: { type: ["string", "null"] }, + mode: { type: "string", enum: ["local", "global"] }, + }, + required: ["name"], + additionalProperties: false, + }; + const code = generateRpcCode({ + definitions: { [title]: params }, + server: { + plugins: { + [method]: { + rpcMethod: `plugins.${method}`, + params: { $ref: `#/definitions/${title}` }, + }, + }, + }, + session: { + plugins: { + [method]: { + rpcMethod: `session.plugins.${method}`, + params: { + ...params, + properties: { + sessionId: { type: "string" }, + ...params.properties, + }, + required: ["sessionId", "name"], + }, + }, + }, + }, + }); + + expect(code).toContain(`internal sealed class ${title}\n`); + expect(code).toContain(`internal sealed class ${title}WithSession\n`); + expect(code).toContain( + `new ${title}WithSession { SessionId = _session.SessionId, Name = name, DirectSourceId = directSourceId, Mode = mode }` + ); + expect(code).toContain( + `new ${title} { Name = name, DirectSourceId = directSourceId, Mode = mode }` + ); + expect(code).toContain( + `string name, string? directSourceId = null, ${title}Mode? mode = null, CancellationToken cancellationToken = default` + ); + expect(code).not.toContain(`${title}WithSessionMode`); + expect(code).toContain(`[JsonSerializable(typeof(${title}))]`); + expect(code).toContain(`[JsonSerializable(typeof(${title}WithSession))]`); + } + ); + + it("still rejects incompatible schemas sharing a request title", () => { + expect(() => + generateRpcCode({ + server: { + first: { + rpcMethod: "first", + params: { + title: "SharedRequest", + type: "object", + properties: { name: { type: "string" } }, + }, + }, + second: { + rpcMethod: "second", + params: { + title: "SharedRequest", + type: "object", + properties: { count: { type: "integer" } }, + }, + }, + }, + }) + ).toThrow('Conflicting RPC class name "SharedRequest"'); + }); + + it("does not hide non-envelope differences in a shared session request", () => { + const params: JSONSchema7 = { + title: "SharedRequest", + type: "object", + properties: { name: { type: "string" } }, + required: ["name"], + }; + expect(() => + generateRpcCode({ + definitions: { SharedRequest: params }, + server: { + configure: { rpcMethod: "configure", params }, + }, + session: { + configure: { + rpcMethod: "session.configure", + params: { + ...params, + properties: { + sessionId: { type: "string" }, + name: { type: "integer" }, + }, + required: ["sessionId", "name"], + }, + }, + }, + }) + ).toThrow('Conflicting RPC class name "SharedRequest"'); + }); + + it("preserves nullable public requests and their separate session wire type", () => { + const code = generateRpcCode({ + session: { + configure: { + rpcMethod: "session.configure", + params: { + anyOf: [ + { type: "null" }, + { + title: "ConfigureRequest", + type: "object", + properties: { + sessionId: { type: "string" }, + mode: { type: "string", enum: ["local", "global"] }, + }, + required: ["sessionId"], + }, + ], + }, + }, + }, + }); + expect(code).toContain("public sealed class ConfigureRequest\n"); + expect(code).toContain("internal sealed class ConfigureRequestWithSession\n"); + expect(code).toContain("ConfigureAsync(ConfigureRequest? request = null,"); + expect(code).toContain( + "new ConfigureRequestWithSession { SessionId = _session.SessionId, Mode = request?.Mode }" + ); + expect(code).not.toContain("ConfigureRequestWithSessionMode"); + }); + + it("preserves session-only wire type names used by handwritten SDK code", () => { + const params: JSONSchema7 = { + title: "ModelSwitchToRequest", + type: "object", + properties: { modelId: { type: "string" } }, + required: ["modelId"], + }; + const code = generateRpcCode({ + definitions: { ModelSwitchToRequest: params }, + session: { + model: { + switchTo: { + rpcMethod: "session.model.switchTo", + params: { + ...params, + properties: { sessionId: { type: "string" }, ...params.properties }, + required: ["sessionId", "modelId"], + }, + }, + }, + }, + }); + expect(code).toContain("internal sealed class ModelSwitchToRequest\n"); + expect(code).toContain( + "new ModelSwitchToRequest { SessionId = _session.SessionId, ModelId = modelId }" + ); + expect(code).not.toContain("ModelSwitchToRequestWithSession"); + }); + it.each([ ["anyOf", false], ["anyOf", true], diff --git a/nodejs/test/python-codegen.test.ts b/nodejs/test/python-codegen.test.ts new file mode 100644 index 0000000000..8bb8efb9b2 --- /dev/null +++ b/nodejs/test/python-codegen.test.ts @@ -0,0 +1,48 @@ +import { describe, expect, it } from "vitest"; + +import { generatePythonSessionEventsCode } from "../../scripts/codegen/python.ts"; + +describe("Python root event payload unions", () => { + it.each(["anyOf", "oneOf"] as const)("preserves referenced %s payload variants", (keyword) => { + const code = generatePythonSessionEventsCode({ + definitions: { + Payload: { + [keyword]: ["status", "startup", "server_error", "incremental"].map((kind) => ({ + type: "object", + properties: { kind: { const: kind }, value: { type: "string" } }, + required: ["kind", "value"], + })), + }, + SessionEvent: { + anyOf: [ + { + type: "object", + properties: { + type: { const: "sample.union" }, + data: { $ref: "#/definitions/Payload" }, + }, + required: ["type", "data"], + }, + { + type: "object", + properties: { + type: { const: "sample.empty" }, + data: { type: "object", properties: {} }, + }, + required: ["type", "data"], + }, + ], + }, + }, + }); + expect(code).toContain("class SampleUnionData:"); + expect(code).toContain("kind: SampleUnionDataKind"); + expect(code).toContain("value: str"); + for (const kind of ["status", "startup", "server_error", "incremental"]) { + expect(code).toContain(`= "${kind}"`); + } + expect(code).toContain('result["value"] = from_str(self.value)'); + expect(code).toContain("data = SampleUnionData.from_dict(data_obj)"); + expect(code).toContain("return SampleEmptyData()"); + }); +}); diff --git a/nodejs/test/rust-codegen.test.ts b/nodejs/test/rust-codegen.test.ts index 577ace1dc0..41b60f07c0 100644 --- a/nodejs/test/rust-codegen.test.ts +++ b/nodejs/test/rust-codegen.test.ts @@ -1,9 +1,64 @@ import type { ApiSchema } from "../../scripts/codegen/utils.ts"; +import type { JSONSchema7 } from "json-schema"; import { describe, expect, it } from "vitest"; -import { generateApiTypesCode } from "../../scripts/codegen/rust.ts"; +import { generateApiTypesCode, generateSessionEventsCode } from "../../scripts/codegen/rust.ts"; describe("Rust API type codegen", () => { + it.each([true, false])( + "validates a reference's sibling constant without changing its enum (required: %s)", + (required) => { + const code = generateApiTypesCode({ + definitions: { + CandidateKind: { + type: "string", + enum: ["mcp-server", "ai-skill", "unknown"], + }, + Candidate: { + type: "object", + required: required ? ["kind", "ordinaryKind"] : ["ordinaryKind"], + properties: { + kind: { + $ref: "#/definitions/CandidateKind", + const: "ai-skill", + }, + ordinaryKind: { $ref: "#/definitions/CandidateKind" }, + }, + }, + }, + } as ApiSchema); + + expect(code).toContain( + `#[serde(${required ? "" : "default, "}deserialize_with = "Candidate::deserialize_kind")]` + ); + expect(code).toContain( + `pub kind: ${required ? "CandidateKind" : "Option"},` + ); + expect(code).toContain("pub ordinary_kind: CandidateKind,"); + expect(code).not.toContain("Candidate::deserialize_ordinary_kind"); + expect(code).toContain(`if value != "ai-skill" {`); + expect(code).toContain(`&["ai-skill"]`); + expect(code).toContain( + "::deserialize(serde::de::value::StringDeserializer::::new(value))" + ); + expect(code.match(/fn deserialize_/g)).toHaveLength(1); + if (!required) { + expect(code).toContain("Option::::deserialize(deserializer)?"); + expect(code).toContain("return Ok(None);"); + expect(code).toContain(".map(Some)"); + } + expect(code).toContain(`#[serde(rename = "mcp-server")] + McpServer,`); + expect(code).toContain(`#[serde(rename = "ai-skill")] + AiSkill,`); + expect(code).toContain(`#[serde(rename = "unknown")] + UnknownValue,`); + expect(code).toContain(`#[default] + #[serde(other)] + Unknown,`); + } + ); + it("distinguishes a protocol-defined unknown value from the forward-compatible fallback", () => { const code = generateApiTypesCode({ definitions: { @@ -40,4 +95,177 @@ describe("Rust API type codegen", () => { expect(code).toContain("pub use super::session_events::{PermissionDecisionSource};"); expect(code).toContain("use crate::types::{RequestId, SessionId};"); }); + + it.each([ + ["unknown", "unknown_value"], + ["unknown_value", "unknown"], + ["not-called", "not_called"], + ])("rejects colliding wire values %s and %s", (first, second) => { + expect(() => + generateApiTypesCode({ + definitions: { + Collision: { type: "string", enum: [first, second] }, + }, + } as ApiSchema) + ).toThrow("is not unique"); + }); + + it("keeps the fallback name reserved for wire values other than exact lowercase unknown", () => { + expect(() => + generateApiTypesCode({ + definitions: { + Collision: { type: "string", enum: ["Unknown"] }, + }, + } as ApiSchema) + ).toThrow('Generated Rust enum variant identifier "Unknown" is not unique'); + }); +}); + +describe("Rust session event codegen", () => { + function eventSchema( + data: JSONSchema7, + definitions: JSONSchema7["definitions"] = {} + ): JSONSchema7 { + return { + definitions: { + ...definitions, + SessionEvent: { + anyOf: [ + { + type: "object", + required: ["type", "data"], + properties: { + type: { const: "session.search" }, + data, + }, + }, + ], + }, + }, + }; + } + + it.each([ + ["anyOf", false], + ["anyOf", true], + ["oneOf", false], + ["oneOf", true], + ] as const)("preserves root %s event unions (referenced: %s)", (keyword, referenced) => { + const payload: JSONSchema7 = { + ...(referenced ? { title: "SearchPayload" } : {}), + [keyword]: [ + { + type: "object", + required: ["kind", "ready"], + properties: { + kind: { type: "string", const: "status" }, + ready: { type: "boolean" }, + }, + }, + { + type: "object", + required: ["kind", "durationMs"], + properties: { + kind: { type: "string", const: "startup" }, + durationMs: { type: "number" }, + }, + }, + ], + }; + const code = generateSessionEventsCode( + eventSchema( + referenced ? { $ref: "#/definitions/SearchPayload" } : payload, + referenced ? { SearchPayload: payload } : {} + ) + ); + const name = referenced ? "SearchPayload" : "SessionSearchData"; + + expect(code).toContain("SessionSearch(SessionSearchData),"); + expect(code).toContain(`#[serde(untagged)] +pub enum ${name} { + Status(${name}Status), + Startup(${name}Startup), +}`); + expect(code).toContain("pub ready: bool,"); + expect(code).toContain("pub duration_ms: f64,"); + expect(code).not.toContain("pub struct SessionSearchData {"); + if (referenced) { + expect(code).toContain("pub type SessionSearchData = SearchPayload;"); + } else { + expect(code).not.toContain("pub type SessionSearchData = SessionSearchData;"); + } + }); + + it.each(["anyOf", "oneOf"] as const)( + "preserves unrepresentable root %s event payloads as raw JSON", + (keyword) => { + const code = generateSessionEventsCode( + eventSchema({ [keyword]: [{ type: "string" }, { type: "number" }] }) + ); + + expect(code).toContain("pub type SessionSearchData = serde_json::Value;"); + expect(code).toContain("SessionSearch(SessionSearchData),"); + expect(code).not.toContain("pub struct SessionSearchData"); + } + ); + + it("keeps ordinary and empty object event payloads as structs", () => { + const ordinary = generateSessionEventsCode( + eventSchema({ + type: "object", + required: ["message"], + properties: { message: { type: "string" } }, + }) + ); + const empty = generateSessionEventsCode(eventSchema({ type: "object", properties: {} })); + + expect(ordinary).toContain("pub struct SessionSearchData {\n pub message: String,\n}"); + expect(empty).toContain("pub struct SessionSearchData {\n}"); + expect(ordinary).not.toContain("pub type SessionSearchData"); + expect(empty).not.toContain("pub type SessionSearchData"); + }); + + it.each(["reasonCode", "judgeStatus", "evaluationStage"])( + "preserves explicit unknown values in nested approval %s enums", + (property) => { + const code = generateSessionEventsCode({ + definitions: { + SessionEvent: { + anyOf: [ + { + type: "object", + required: ["type", "data"], + properties: { + type: { const: "permission.completed" }, + data: { + type: "object", + properties: { + approval: { + type: "object", + properties: { + [property]: { + type: "string", + enum: ["unknown", "inherited"], + }, + }, + }, + }, + }, + }, + }, + ], + }, + }, + }); + + expect(code).toContain(`#[serde(rename = "unknown")] + UnknownValue,`); + expect(code).toContain(`#[serde(rename = "inherited")] + Inherited,`); + expect(code).toContain(`/// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown,`); + } + ); }); diff --git a/nodejs/test/session-event-codegen.test.ts b/nodejs/test/session-event-codegen.test.ts index 2dad8f4f18..ec3c1d2169 100644 --- a/nodejs/test/session-event-codegen.test.ts +++ b/nodejs/test/session-event-codegen.test.ts @@ -10,6 +10,141 @@ import { import { generateSessionEventsCode as generateRustSessionEventsCode } from "../../scripts/codegen/rust.ts"; describe("session event codegen", () => { + describe.each(["anyOf", "oneOf"] as const)("Go root %s payloads", (unionKeyword) => { + it.each(["inline", "local", "shared"])( + "preserves %s union payloads as raw JSON", + (shape) => { + const union: JSONSchema7 = { + [unionKeyword]: [ + { + type: "object", + required: ["kind", "state"], + properties: { + kind: { const: "status" }, + state: { type: "string" }, + }, + }, + { + type: "object", + required: ["kind", "duration"], + properties: { + kind: { const: "finished" }, + duration: { type: "number" }, + }, + }, + ], + }; + const data = + shape === "inline" + ? union + : { + $ref: `${shape === "shared" ? "api.schema.json" : ""}#/definitions/Payload`, + }; + const schema: JSONSchema7 = { + definitions: { + Payload: union, + SessionEvent: { + anyOf: [ + { + type: "object", + required: ["type", "data"], + properties: { + type: { const: "session.synthetic" }, + data, + }, + }, + ], + }, + }, + }; + + const { typeCode, encodingCode } = generateGoSessionEventsCode(schema, "rpc"); + const payload = typeCode.match(/type SessionSyntheticData struct \{[^}]*\}/)?.[0]; + expect(payload).toContain('Raw json.RawMessage `json:"-"`'); + expect(typeCode).toContain( + "func (*SessionSyntheticData) Type() SessionEventType { return SessionEventTypeSessionSynthetic }" + ); + expect(encodingCode).toContain("func (r *SessionSyntheticData) UnmarshalJSON"); + expect(encodingCode).toContain("func (r SessionSyntheticData) MarshalJSON"); + expect(encodingCode).toContain("var d SessionSyntheticData"); + } + ); + }); + + it.each([ + { type: "object", properties: {} }, + { type: "object", properties: { count: { type: "integer" } }, required: ["count"] }, + { + anyOf: [ + { + type: "object", + properties: { count: { type: "integer" } }, + required: ["count"], + }, + { type: "null" }, + ], + }, + ] satisfies JSONSchema7[])("keeps ordinary and empty Go payloads typed: %j", (data) => { + const schema: JSONSchema7 = { + definitions: { + SessionEvent: { + anyOf: [ + { + type: "object", + properties: { type: { const: "session.synthetic" }, data }, + }, + ], + }, + }, + }; + const { typeCode } = generateGoSessionEventsCode(schema, "rpc"); + const payload = typeCode.match(/type SessionSyntheticData struct \{[^}]*\}/)?.[0]; + expect(payload).not.toContain("Raw json.RawMessage"); + if ("anyOf" in data || "count" in (data.properties ?? {})) { + expect(payload).toContain('Count int64 `json:"count"`'); + } else { + expect(payload).toBe("type SessionSyntheticData struct {\n}"); + } + }); + + it("preserves Go event payload fields behind shared external references", () => { + const schema: JSONSchema7 = { + definitions: { + SessionEvent: { + anyOf: [ + { + type: "object", + required: ["type", "data"], + properties: { + type: { const: "session.synthetic" }, + data: { + $ref: "api.schema.json#/definitions/SharedPayload", + }, + }, + }, + ], + }, + SharedPayload: { + type: "object", + required: ["source", "failClosed"], + properties: { + source: { type: "string" }, + failClosed: { type: "boolean" }, + clientManaged: { type: "boolean" }, + }, + }, + }, + }; + + const { typeCode, encodingCode } = generateGoSessionEventsCode(schema, "rpc"); + const payload = typeCode.match(/type SessionSyntheticData struct \{[^}]*\}/)?.[0]; + + expect(payload).toContain('Source string `json:"source"`'); + expect(payload).toContain('FailClosed bool `json:"failClosed"`'); + expect(payload).toContain('ClientManaged *bool `json:"clientManaged,omitempty"`'); + expect(encodingCode).toContain("var d SessionSyntheticData"); + }); + it("replaces external reference placeholders regardless of acronym casing", () => { const code = `@dataclass class ExternalRefMCPOauthHTTPResponse: diff --git a/python/copilot/generated/rpc.py b/python/copilot/generated/rpc.py index bcf53a1495..b45ada8420 100644 --- a/python/copilot/generated/rpc.py +++ b/python/copilot/generated/rpc.py @@ -6,7 +6,7 @@ from typing import ClassVar, TYPE_CHECKING -from .session_events import AbortReason, AgentModelPolicy, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerMetadata, McpServerSource, McpServerStatus, ModelChangeSource, PermissionDecisionSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, RemediationAction, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompletionOutcome, UserToolSessionApproval, Verbosity +from .session_events import AbortReason, AgentModelPolicy, Attachment, AutoTier, ContextTier, EmbeddedBlobResourceContents, EmbeddedTextResourceContents, IndexedSearchState, ManagedSettingsResolvedSource, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, McpServerMetadata, McpServerSource, McpServerStatus, ModelChangeSource, PermissionDecisionSource, PermissionMode, PermissionPromptRequest, PermissionRule, ReasoningSummary, RemediationAction, SessionEvent, SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskBlocker, TaskCompletionOutcome, UserToolSessionApproval, Verbosity if TYPE_CHECKING: from .._jsonrpc import JsonRpcClient @@ -48,6 +48,11 @@ def from_bool(x: Any) -> bool: assert isinstance(x, bool) return x +def from_int(x: Any) -> int: + assert isinstance(x, (int, float)) and not isinstance(x, bool) + assert not isinstance(x, float) or x.is_integer() + return int(x) + def from_float(x: Any) -> float: assert isinstance(x, (float, int)) and not isinstance(x, bool) return float(x) @@ -56,23 +61,18 @@ def to_float(x: Any) -> float: assert isinstance(x, (int, float)) return x -def from_dict(f: Callable[[Any], T], x: Any) -> dict[str, T]: - assert isinstance(x, dict) - return { k: f(v) for (k, v) in x.items() } - def from_list(f: Callable[[Any], T], x: Any) -> list[T]: assert isinstance(x, list) return [f(y) for y in x] +def from_dict(f: Callable[[Any], T], x: Any) -> dict[str, T]: + assert isinstance(x, dict) + return { k: f(v) for (k, v) in x.items() } + def to_enum(c: type[EnumT], x: Any) -> EnumT: assert isinstance(x, c) return x.value -def from_int(x: Any) -> int: - assert isinstance(x, (int, float)) and not isinstance(x, bool) - assert not isinstance(x, float) or x.is_integer() - return int(x) - def from_datetime(x: Any) -> datetime: return dateutil.parser.parse(x) @@ -165,6 +165,22 @@ def to_dict(self) -> dict: result["telemetry"] = from_union([from_str, from_none], self.telemetry) return result +@dataclass +class EnterpriseList: + id: int + """Numeric database ID of the enterprise.""" + + @staticmethod + def from_dict(obj: Any) -> 'EnterpriseList': + assert isinstance(obj, dict) + id = from_int(obj.get("id")) + return EnterpriseList(id) + + def to_dict(self) -> dict: + result: dict = {} + result["id"] = from_int(self.id) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class CopilotUserResponseQuotaSnapshots: @@ -1072,22 +1088,33 @@ class CardDigestAlgorithm(Enum): SHA256_RFC8785 = "sha256-rfc8785" -class Installability(Enum): - NOT_INSTALLABLE_KIND = "not-installable-kind" +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogPluginRepositorySource: + """Bounded repository provenance declared through the catalog's sourceSet and repoPath + metadata. It contains no descriptor URL. -class CatalogAISkillCandidateKind(Enum): - AI_SKILL = "ai-skill" + Syntactically validated GitHub repository provenance declared by catalog metadata. This + is a source claim rather than proof that the descriptor URL resolves to the repository. + """ + path: str + """Case-preserving safe relative POSIX path derived from metadata.repoPath.""" -class MediaType(Enum): - APPLICATION_AI_SKILL = "application/ai-skill" + repository: str + """Canonical lowercase owner/repository name derived from metadata.sourceSet.""" -class CatalogCandidateSourceKind(Enum): - """Discriminator for a URL-backed MCP server card + @staticmethod + def from_dict(obj: Any) -> 'CatalogPluginRepositorySource': + assert isinstance(obj, dict) + path = from_str(obj.get("path")) + repository = from_str(obj.get("repository")) + return CatalogPluginRepositorySource(path, repository) - Discriminator for an embedded MCP server card - """ - EMBEDDED = "embedded" - URL = "url" + def to_dict(self) -> dict: + result: dict = {} + result["path"] = from_str(self.path) + result["repository"] = from_str(self.repository) + return result # Experimental: this type is part of an experimental API and may change or be removed. class CatalogTrustEligibility(Enum): @@ -1151,6 +1178,32 @@ class CatalogTrustTier(Enum): T1 = "T1" T2 = "T2" +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogAISkillInstallability(Enum): + """Typed non-installable state for an AI skill candidate""" + + NOT_INSTALLABLE_KIND = "not-installable-kind" + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogAISkillCandidateKind(Enum): + """Discriminator for an AI skill candidate""" + + AI_SKILL = "ai-skill" + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogAISkillMediaType(Enum): + """Canonical AI skill media type""" + + APPLICATION_AI_SKILL = "application/ai-skill" + +class CatalogCandidateSourceKind(Enum): + """Discriminator for a URL-backed MCP server card + + Discriminator for an embedded MCP server card + """ + EMBEDDED = "embedded" + URL = "url" + class CatalogAuthenticationRequiredErrorKind(Enum): AUTHENTICATION_REQUIRED = "authentication-required" @@ -1169,38 +1222,13 @@ class CatalogCandidateInstallability(Enum): """Whether this MCP server can be planned for installation, and if policy prevents it. Whether an MCP server candidate can be planned for installation + + Typed non-installable state for an AI skill candidate """ INSTALLABLE = "installable" NOT_INSTALLABLE_KIND = "not-installable-kind" NOT_INSTALLABLE_POLICY = "not-installable-policy" -# Experimental: this type is part of an experimental API and may change or be removed. -class CatalogCandidateKind(Enum): - """What kind of resource a catalog candidate describes""" - - AI_SKILL = "ai-skill" - MCP_SERVER = "mcp-server" - -# Experimental: this type is part of an experimental API and may change or be removed. -class CatalogMediaType(Enum): - """JSON MCP media type of the underlying card. - - JSON MCP card media type accepted for install planning - - JSON MCP media type advertised for the referenced card. - - JSON MCP media type the validated card was interpreted as. - - Media type the card is expected to conform to. - - Media type the card was interpreted as, when it declared one this runtime recognises. - - Media type a catalog card is interpreted as - """ - APPLICATION_AI_SKILL = "application/ai-skill" - APPLICATION_MCP_SERVER_CARD_JSON = "application/mcp-server-card+json" - APPLICATION_MCP_SERVER_JSON = "application/mcp-server+json" - # Experimental: this type is part of an experimental API and may change or be removed. class MCPServerCardEmbeddedKind(Enum): """Discriminator for an embedded MCP server card""" @@ -1219,7 +1247,10 @@ class CatalogCapability(Enum): grant means the runtime understands the feature's contract, not that the deployment has enabled the operation; typed unavailable results report availability separately. """ + AGENT_PLUGIN_DISCOVERY = "agent-plugin-discovery" AI_SKILL_DISCOVERY = "ai-skill-discovery" + CATALOG_SEARCH_PAGINATION = "catalog-search-pagination" + CATALOG_SELECTION = "catalog-selection" LEGACY_MCP_SERVER_CARD = "legacy-mcp-server-card" MCP_INSTALL_PLANNING = "mcp-install-planning" MCP_SERVER_CARD = "mcp-server-card" @@ -1281,6 +1312,7 @@ class CatalogHandleType(Enum): """ CANDIDATE = "candidate" PLAN = "plan" + SELECTION = "selection" class CatalogHandleRejectedErrorKind(Enum): HANDLE_REJECTED = "handle-rejected" @@ -1294,20 +1326,26 @@ class CatalogHandleRejectionReason(Enum): FOREIGN = "foreign" INVALID = "invalid" REPLAYED = "replayed" + SEARCH_MISMATCH = "search-mismatch" STALE = "stale" + WRONG_KIND = "wrong-kind" # Experimental: this type is part of an experimental API and may change or be removed. class CatalogInvalidRequestField(Enum): """Which request field was rejected. - Which request field was rejected before any work was done + Which request field was rejected locally or by the catalog authority """ CARD = "card" CONTRACT = "contract" KINDS = "kinds" LIMIT = "limit" + OUTCOME = "outcome" + PAGE = "page" QUERY = "query" SCOPE = "scope" + SELECTION_REF = "selectionRef" + SESSION_ID = "sessionId" SOURCE = "source" class CatalogInvalidRequestErrorKind(Enum): @@ -1337,7 +1375,10 @@ class CatalogMCPServerInstallabilityEnum(Enum): INSTALLABLE = "installable" NOT_INSTALLABLE_POLICY = "not-installable-policy" +# Experimental: this type is part of an experimental API and may change or be removed. class CatalogMCPServerCandidateKind(Enum): + """Discriminator for an MCP server candidate""" + MCP_SERVER = "mcp-server" # Experimental: this type is part of an experimental API and may change or be removed. @@ -1416,6 +1457,49 @@ class MCPPlanPolicySource(Enum): NONE = "none" REGISTRY_POLICY = "registry-policy" +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSearchPage: + """An explicit numbered-page request. The SDK treats the token as opaque; only the runtime + decodes it and changes its targetPage. Authority validation binds navigation to the + original search. No snapshot stability or token TTL is promised. + + Numbered navigation using metadata from an earlier response. Requires + catalog-search-pagination and the same query, kinds and effective limit. Omit for a fresh + first-page search. + """ + number: int + """Requested one-based page. Must not exceed either the token's signed pageCount or the + navigation window ceil(1000 / pageSize). Repeat the search without page to discover newly + available pages beyond that signed pageCount. + """ + token: str + """Opaque authority-issued pagination token from an earlier response. Never decode, modify + or log it in an SDK consumer. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSearchPage': + assert isinstance(obj, dict) + number = from_int(obj.get("number")) + token = from_str(obj.get("token")) + return CatalogSearchPage(number, token) + + def to_dict(self) -> dict: + result: dict = {} + result["number"] = from_int(self.number) + result["token"] = from_str(self.token) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogSearchTotalCountRelation(Enum): + """The relationship of totalCount to the complete query result set is unknown; neither + exactness nor a lower-bound guarantee is implied. + + Relationship of the backend-reported count to the complete query result set. + """ + UNKNOWN = "unknown" + class CatalogSearchResultKind(Enum): AUTHENTICATION_REQUIRED = "authentication-required" CONTRACT_VIOLATION = "contract-violation" @@ -1488,6 +1572,7 @@ class CatalogSearchResultReason(Enum): RESPONSE_TOO_LARGE = "response-too-large" SCHEMA_VIOLATION = "schema-violation" SEARCH_UNAVAILABLE = "search-unavailable" + SELECTION_UNAVAILABLE = "selection-unavailable" SERVICE_UNAVAILABLE = "service-unavailable" SIZE_LIMIT_EXCEEDED = "size-limit-exceeded" TIMEOUT = "timeout" @@ -1500,6 +1585,79 @@ class CatalogSearchResultReason(Enum): class CatalogSearchSucceededKind(Enum): SUCCEEDED = "succeeded" +class CatalogSelectionCancelledKind(Enum): + CANCELLED = "cancelled" + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogSelectionDecision(Enum): + """Terminal outcome declared for a retained catalog selection group + + The terminal outcome declared by the caller. Timed-out means the host's live interaction + deadline elapsed; a reference whose runtime TTL elapsed is rejected separately as stale. + """ + CANCELLED = "cancelled" + DECLINED = "declined" + SELECTED = "selected" + TIMED_OUT = "timed-out" + +class CatalogSelectionDeclinedKind(Enum): + DECLINED = "declined" + +class CatalogSelectionForeignKind(Enum): + FOREIGN = "foreign" + +class CatalogSelectionInvalidKind(Enum): + INVALID = "invalid" + +class CatalogSelectionReplayedKind(Enum): + REPLAYED = "replayed" + +class CatalogSelectionResultKind(Enum): + CANCELLED = "cancelled" + DECLINED = "declined" + FOREIGN = "foreign" + INVALID = "invalid" + INVALID_REQUEST = "invalid-request" + NEGOTIATION_REFUSED = "negotiation-refused" + REPLAYED = "replayed" + SELECTED = "selected" + STALE = "stale" + TIMED_OUT = "timed-out" + UNAVAILABLE = "unavailable" + WRONG_KIND = "wrong-kind" + +class CatalogSelectionResultReason(Enum): + """Whether the version or the capability set was the problem. + + Why capability and protocol-version negotiation refused a caller + + Why the operation is unavailable. + + Why a catalog operation is not available on this runtime + """ + AUTHORITY_NOT_CONFIGURED = "authority-not-configured" + DISABLED_BY_POLICY = "disabled-by-policy" + PLANNING_UNAVAILABLE = "planning-unavailable" + SEARCH_UNAVAILABLE = "search-unavailable" + SELECTION_UNAVAILABLE = "selection-unavailable" + UNSUPPORTED_CAPABILITY = "unsupported-capability" + UNSUPPORTED_PROTOCOL_VERSION = "unsupported-protocol-version" + +class CatalogSelectionSelectedKind(Enum): + SELECTED = "selected" + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogTrustSnapshotStaleStatus(Enum): + """The authority explicitly marked its assessment stale.""" + + STALE = "stale" + +class CatalogSelectionTimedOutKind(Enum): + TIMED_OUT = "timed-out" + +class CatalogSelectionWrongKindKind(Enum): + WRONG_KIND = "wrong-kind" + # Experimental: this type is part of an experimental API and may change or be removed. class CatalogTrustSnapshotAbsentStatus(Enum): """The authority omitted trust metadata.""" @@ -1530,12 +1688,6 @@ class CatalogTrustSnapshotRevokedStatus(Enum): REVOKED = "revoked" -# Experimental: this type is part of an experimental API and may change or be removed. -class CatalogTrustSnapshotStaleStatus(Enum): - """The authority explicitly marked its assessment stale.""" - - STALE = "stale" - # Experimental: this type is part of an experimental API and may change or be removed. class CatalogTrustSnapshotUnsupportedStatus(Enum): """The authority supplied a bounded trust value this runtime does not understand.""" @@ -1555,6 +1707,7 @@ class CatalogUnavailableReason(Enum): DISABLED_BY_POLICY = "disabled-by-policy" PLANNING_UNAVAILABLE = "planning-unavailable" SEARCH_UNAVAILABLE = "search-unavailable" + SELECTION_UNAVAILABLE = "selection-unavailable" class CatalogUnavailableTransportErrorKind(Enum): UNAVAILABLE_TRANSPORT = "unavailable-transport" @@ -3218,10 +3371,12 @@ def to_dict(self) -> dict: return result # Experimental: this type is part of an experimental API and may change or be removed. -class FactoryDurableOperation(Enum): +class DurableOperation(Enum): """Execution-critical factory storage operation. Execution-critical durable operation that failed. + + Execution-critical workflow storage operation. """ ADD_ELAPSED = "addElapsed" CHARGE_CREDIT = "chargeCredit" @@ -3508,12 +3663,18 @@ def to_dict(self) -> dict: return result # Experimental: this type is part of an experimental API and may change or be removed. -class FactoryRunStatus(Enum): +class RunStatus(Enum): """Current factory run status. Current or terminal state of a factory run. Current or terminal factory run status. + + Current workflow run status. + + Current or terminal state of a workflow run. + + Current or terminal workflow run status. """ CANCELLED = "cancelled" COMPLETED = "completed" @@ -3524,10 +3685,12 @@ class FactoryRunStatus(Enum): RUNNING = "running" # Experimental: this type is part of an experimental API and may change or be removed. -class FactoryRunFailureKind(Enum): +class RunFailureKind(Enum): """Resource ceiling that stopped the run. Cumulative resource ceiling that stopped a factory run. + + Cumulative resource ceiling that stopped a workflow run. """ MAX_AI_CREDITS = "maxAiCredits" MAX_TOTAL_SUBAGENTS = "maxTotalSubagents" @@ -3545,12 +3708,14 @@ class PauseInfoType(Enum): USER = "user" # Experimental: this type is part of an experimental API and may change or be removed. -class FactoryLogLineKind(Enum): +class LogLineKind(Enum): """Progress line kind. Kind of factory progress line. Progress record kind. + + Kind of workflow progress line. """ LOG = "log" PHASE = "phase" @@ -3604,10 +3769,12 @@ def to_dict(self) -> dict: return result # Experimental: this type is part of an experimental API and may change or be removed. -class FactoryPhaseStatus(Enum): +class PhaseStatus(Enum): """Derived lifecycle state of the phase. Derived lifecycle state of a factory phase. + + Derived lifecycle state of a workflow phase. """ ACTIVE = "active" COMPLETED = "completed" @@ -4862,6 +5029,102 @@ def to_dict(self) -> dict: result["settingsJson"] = self.settings_json return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class ManagedSettingsResolvedData: + """Enterprise managed-settings resolution: the effective managed settings the session + applied and which channels contributed, so SDK clients can show users what is + enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on + resume, and on account switch. This is an ephemeral live snapshot (delivered to + subscribers but not persisted to the session event log), because at session start it + resolves before `session.start` is emitted. Device values take precedence over server + values, then the policy helper, per ordinary key, while permissions compose restrictively + across device, server, policy-helper, and SDK-client layers. The account-scoped + `getManagedSettings()` API does not include session-local client injection. Marked + experimental while the managed-settings surface stabilizes. + """ + bypass_permissions_disabled: bool + """Whether enterprise policy disables bypass-permissions ("yolo") mode for this session. + Deny-wins across layers, and forced on when `failClosed` is true. + """ + device_managed: bool + """Whether an actual device MDM/plist/registry/file managed-settings layer was present""" + + fail_closed: bool + """Whether managed policy could not be determined (e.g. a failed server fetch) and the + session fell back to the fail-closed restriction. When true, restrictions such as + disabling bypass-permissions are enforced even though `settings` may be absent. + """ + managed_keys: list[str] + """The setting keys under enterprise management in the effective managed settings (e.g. + `model`, `enabledPlugins`, `permissions`). Empty when no managed settings are in force. + """ + server_managed: bool + """Whether the server (account/org) managed-settings layer was present""" + + source: ManagedSettingsResolvedSource + """Channel summary: `server`, `device`, `client`, or `policyHelper` when exactly one channel + contributed; `mixed` when multiple channels contributed; otherwise `none`. Consult the + per-channel booleans for exact provenance. + """ + client_managed: bool | None = None + """Whether a session-local permissions layer injected by the SDK host was present""" + + permissions_allow_intersected: bool | None = None + """Whether at least two managed sources supplied permission allowlists, so enforcement + intersects them and the flattened settings payload omits `permissions.allow`. + """ + policy_helper_managed: bool | None = None + """Whether the policy-helper managed-settings layer was present. The policy helper is the + weakest channel: it fills keys no enterprise source set and can never replace one. + """ + sandbox_enabled_by_undetermined_policy: bool | None = None + """Whether the effective sandbox policy forces the sandbox on *only* because managed policy + could not be determined, rather than because the policy requires it. Lets clients tell a + user whose `--no-sandbox` was overridden that the sandbox stayed on as a fail-closed + fallback, instead of attributing it to an administrator who set no such policy. + """ + settings: Any = None + """The effective (resolved) managed settings values, so clients can render exactly what is + enforced. Absent when no managed policy is in force. + """ + + @staticmethod + def from_dict(obj: Any) -> 'ManagedSettingsResolvedData': + assert isinstance(obj, dict) + bypass_permissions_disabled = from_bool(obj.get("bypassPermissionsDisabled")) + device_managed = from_bool(obj.get("deviceManaged")) + fail_closed = from_bool(obj.get("failClosed")) + managed_keys = from_list(from_str, obj.get("managedKeys")) + server_managed = from_bool(obj.get("serverManaged")) + source = ManagedSettingsResolvedSource(obj.get("source")) + client_managed = from_union([from_bool, from_none], obj.get("clientManaged")) + permissions_allow_intersected = from_union([from_bool, from_none], obj.get("permissionsAllowIntersected")) + policy_helper_managed = from_union([from_bool, from_none], obj.get("policyHelperManaged")) + sandbox_enabled_by_undetermined_policy = from_union([from_bool, from_none], obj.get("sandboxEnabledByUndeterminedPolicy")) + settings = obj.get("settings") + return ManagedSettingsResolvedData(bypass_permissions_disabled, device_managed, fail_closed, managed_keys, server_managed, source, client_managed, permissions_allow_intersected, policy_helper_managed, sandbox_enabled_by_undetermined_policy, settings) + + def to_dict(self) -> dict: + result: dict = {} + result["bypassPermissionsDisabled"] = from_bool(self.bypass_permissions_disabled) + result["deviceManaged"] = from_bool(self.device_managed) + result["failClosed"] = from_bool(self.fail_closed) + result["managedKeys"] = from_list(from_str, self.managed_keys) + result["serverManaged"] = from_bool(self.server_managed) + result["source"] = to_enum(ManagedSettingsResolvedSource, self.source) + if self.client_managed is not None: + result["clientManaged"] = from_union([from_bool, from_none], self.client_managed) + if self.permissions_allow_intersected is not None: + result["permissionsAllowIntersected"] = from_union([from_bool, from_none], self.permissions_allow_intersected) + if self.policy_helper_managed is not None: + result["policyHelperManaged"] = from_union([from_bool, from_none], self.policy_helper_managed) + if self.sandbox_enabled_by_undetermined_policy is not None: + result["sandboxEnabledByUndeterminedPolicy"] = from_union([from_bool, from_none], self.sandbox_enabled_by_undetermined_policy) + if self.settings is not None: + result["settings"] = self.settings + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class MarketplaceAddResult: @@ -4893,25 +5156,38 @@ class MarketplaceInfo: """Human-readable description of where the marketplace data is fetched from (e.g. "GitHub: owner/repo"). """ + available: bool | None = None + """Whether the managed marketplace currently resolved into the runtime marketplace registry. + Set to false when the desired managed entry is retained for governance visibility after + loading or reconciliation failed. + """ is_default: bool | None = None """True when this is a default marketplace shipped with the runtime. Defaults are not removable. """ + managed: bool | None = None + """Whether enterprise managed settings provide and control this marketplace entry.""" @staticmethod def from_dict(obj: Any) -> 'MarketplaceInfo': assert isinstance(obj, dict) name = from_str(obj.get("name")) source = from_str(obj.get("source")) + available = from_union([from_bool, from_none], obj.get("available")) is_default = from_union([from_bool, from_none], obj.get("isDefault")) - return MarketplaceInfo(name, source, is_default) + managed = from_union([from_bool, from_none], obj.get("managed")) + return MarketplaceInfo(name, source, available, is_default, managed) def to_dict(self) -> dict: result: dict = {} result["name"] = from_str(self.name) result["source"] = from_str(self.source) + if self.available is not None: + result["available"] = from_union([from_bool, from_none], self.available) if self.is_default is not None: result["isDefault"] = from_union([from_bool, from_none], self.is_default) + if self.managed is not None: + result["managed"] = from_union([from_bool, from_none], self.managed) return result # Experimental: this type is part of an experimental API and may change or be removed. @@ -6116,7 +6392,9 @@ class MCPPlanInstallResultReason(Enum): REPLAYED = "replayed" RESPONSE_TOO_LARGE = "response-too-large" SCHEMA_VIOLATION = "schema-violation" + SEARCH_MISMATCH = "search-mismatch" SEARCH_UNAVAILABLE = "search-unavailable" + SELECTION_UNAVAILABLE = "selection-unavailable" SERVICE_UNAVAILABLE = "service-unavailable" SIZE_LIMIT_EXCEEDED = "size-limit-exceeded" STALE = "stale" @@ -6127,6 +6405,7 @@ class MCPPlanInstallResultReason(Enum): UNSUPPORTED_CAPABILITY = "unsupported-capability" UNSUPPORTED_MEDIA_TYPE = "unsupported-media-type" UNSUPPORTED_PROTOCOL_VERSION = "unsupported-protocol-version" + WRONG_KIND = "wrong-kind" # Experimental: this type is part of an experimental API and may change or be removed. class MCPPlanInstallSourceCandidateKind(Enum): @@ -7615,17 +7894,25 @@ class PendingPermissionRequest: request_id: str """Unique identifier for the pending permission request""" + recovery_episode_id: str | None = None + """Permission-recovery episode that authorized this request to surface for interactive + attention + """ + @staticmethod def from_dict(obj: Any) -> 'PendingPermissionRequest': assert isinstance(obj, dict) request = PermissionPromptRequest.from_dict(obj.get("request")) request_id = from_str(obj.get("requestId")) - return PendingPermissionRequest(request, request_id) + recovery_episode_id = from_union([from_str, from_none], obj.get("recoveryEpisodeId")) + return PendingPermissionRequest(request, request_id, recovery_episode_id) def to_dict(self) -> dict: result: dict = {} result["request"] = to_class(PermissionPromptRequest, self.request) result["requestId"] = from_str(self.request_id) + if self.recovery_episode_id is not None: + result["recoveryEpisodeId"] = from_union([from_str, from_none], self.recovery_episode_id) return result class ApprovalKind(Enum): @@ -7709,9 +7996,6 @@ class PermissionDecisionApprovedForLocationKind(Enum): class PermissionDecisionApprovedForSessionKind(Enum): APPROVED_FOR_SESSION = "approved-for-session" -class PermissionDecisionCancelledKind(Enum): - CANCELLED = "cancelled" - # Experimental: this type is part of an experimental API and may change or be removed. class PermissionDecisionOutcome(Enum): """Disposition of the permission request as observed by the responding client. @@ -8624,6 +8908,24 @@ class Plugin: name: str """Plugin name""" + direct_source_id: str | None = None + """Opaque stable identity for a direct plugin source.""" + + installed: bool | None = None + """Whether this managed desired plugin has an installed or live record.""" + + installed_from: str | None = None + """Absolute marketplace directory for a live plugin.""" + + managed: bool | None = None + """Whether enterprise managed settings control this plugin.""" + + managed_desired_enabled: bool | None = None + """Enabled state required by enterprise managed settings.""" + + source: str | None = None + """Runtime plugin provenance, such as "builtin".""" + version: str | None = None """Installed version""" @@ -8633,14 +8935,32 @@ def from_dict(obj: Any) -> 'Plugin': enabled = from_bool(obj.get("enabled")) marketplace = from_str(obj.get("marketplace")) name = from_str(obj.get("name")) + direct_source_id = from_union([from_str, from_none], obj.get("directSourceId")) + installed = from_union([from_bool, from_none], obj.get("installed")) + installed_from = from_union([from_str, from_none], obj.get("installedFrom")) + managed = from_union([from_bool, from_none], obj.get("managed")) + managed_desired_enabled = from_union([from_bool, from_none], obj.get("managedDesiredEnabled")) + source = from_union([from_str, from_none], obj.get("source")) version = from_union([from_str, from_none], obj.get("version")) - return Plugin(enabled, marketplace, name, version) + return Plugin(enabled, marketplace, name, direct_source_id, installed, installed_from, managed, managed_desired_enabled, source, version) def to_dict(self) -> dict: result: dict = {} result["enabled"] = from_bool(self.enabled) result["marketplace"] = from_str(self.marketplace) result["name"] = from_str(self.name) + if self.direct_source_id is not None: + result["directSourceId"] = from_union([from_str, from_none], self.direct_source_id) + if self.installed is not None: + result["installed"] = from_union([from_bool, from_none], self.installed) + if self.installed_from is not None: + result["installedFrom"] = from_union([from_str, from_none], self.installed_from) + if self.managed is not None: + result["managed"] = from_union([from_bool, from_none], self.managed) + if self.managed_desired_enabled is not None: + result["managedDesiredEnabled"] = from_union([from_bool, from_none], self.managed_desired_enabled) + if self.source is not None: + result["source"] = from_union([from_str, from_none], self.source) if self.version is not None: result["version"] = from_union([from_str, from_none], self.version) return result @@ -9165,6 +9485,28 @@ class PushAttachmentGitHubURLType(Enum): class PushAttachmentSelectionType(Enum): SELECTION = "selection" +# Experimental: this type is part of an experimental API and may change or be removed. +class SendAgentMode(Enum): + """Mode captured at submission. Only steering messages in the same mode may be combined. + + The UI mode the agent was in when this message was sent. Defaults to the session's + current mode. + + Optional explicit agent mode. When omitted, the session's current mode is assigned. + + Agent mode stored on this queued entry, as stamped when it was enqueued. Items without an + explicit mode report interactive. This is not necessarily the mode that will constrain + the turn: a plan or autopilot session applies its own write gate, continuation loop and + permission posture to every drained item regardless of the mode stored here. + + The UI mode the agent was in when these messages were sent. Defaults to the session's + current mode. + """ + AUTOPILOT = "autopilot" + INTERACTIVE = "interactive" + PLAN = "plan" + SHELL = "shell" + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class QueueBeginDeferredIdleDrainRequest: @@ -9341,26 +9683,6 @@ def to_dict(self) -> dict: result["hasPending"] = from_bool(self.has_pending) return result -# Experimental: this type is part of an experimental API and may change or be removed. -class SendAgentMode(Enum): - """Optional explicit agent mode. When omitted, the session's current mode is assigned. - - The UI mode the agent was in when this message was sent. Defaults to the session's - current mode. - - Agent mode stored on this queued entry, as stamped when it was enqueued. Items without an - explicit mode report interactive. This is not necessarily the mode that will constrain - the turn: a plan or autopilot session applies its own write gate, continuation loop and - permission posture to every drained item regardless of the mode stored here. - - The UI mode the agent was in when these messages were sent. Defaults to the session's - current mode. - """ - AUTOPILOT = "autopilot" - INTERACTIVE = "interactive" - PLAN = "plan" - SHELL = "shell" - # Experimental: this type is part of an experimental API and may change or be removed. class SendMode(Enum): """Accepted for SendOptions compatibility but ignored; inserted items always use queued @@ -9616,6 +9938,32 @@ def to_dict(self) -> dict: result["updated"] = from_bool(self.updated) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class QueueWithdrawMessageRequest: + """Conditional withdrawal of a single user message, before the runtime claims it for + delivery. + """ + expected_prompt: str + """The prompt originally sent. A message edited since submission is not withdrawn, so an + obsolete draft cannot replace the edit. + """ + message_id: str + """Message identity returned by send, not the queue item id. Batch messages are not eligible.""" + + @staticmethod + def from_dict(obj: Any) -> 'QueueWithdrawMessageRequest': + assert isinstance(obj, dict) + expected_prompt = from_str(obj.get("expectedPrompt")) + message_id = from_str(obj.get("messageId")) + return QueueWithdrawMessageRequest(expected_prompt, message_id) + + def to_dict(self) -> dict: + result: dict = {} + result["expectedPrompt"] = from_str(self.expected_prompt) + result["messageId"] = from_str(self.message_id) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class QueuedCommandHandled: @@ -10102,12 +10450,11 @@ def to_dict(self) -> dict: # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class SandboxConfigUserPolicyNetworkProxy: - """HTTP(S) proxy for sandboxed traffic. With host rules, this is the built-in local proxy's - upstream; credentials stay in the runtime, and Linux and macOS restrict the child to the - local listener. Without host rules, Linux restricts egress to this endpoint but rejects - credentials, and macOS proxying is cooperative. Windows enforcement depends on the - application's networking stack. Configure credentials in the separate username/password - fields. The transient local listener URL is never persisted. + """HTTP(S) proxy for sandboxed traffic. This is the built-in local proxy's upstream: every + sandboxed command reaches it through a loopback listener, so credentials stay in the + runtime and never reach the child. On Windows the sandbox also needs local network + access, because it reaches that listener over host loopback. Configure credentials in the + separate username/password fields. The transient local listener URL is never persisted. HTTP proxy configuration for sandboxed traffic. """ @@ -11578,8 +11925,8 @@ class SessionManagedPermissions: """Permission rules that block matching operations. Deny has highest precedence.""" disable_bypass_permissions_mode: str | None = None - """When set to `disable`, prevents bypass/allow-all permission modes. `allow-auto-only` - blocks full allow-all but permits advisory auto-approval. Any other value is accepted + """When set to `disable`, prevents bypass/allow-all permission modes. Advisory auto-approval + remains available because normal prompt paths stay active. Any other value is accepted rather than failing the session, but is enforced as `disable`: the key is only present to restrict something, so a mode this runtime cannot interpret fails closed to the most restrictive one it knows. Omit the key entirely to impose no restriction. @@ -11771,6 +12118,24 @@ class SessionsOpenStatus(Enum): NOT_FOUND = "not_found" RESUMED = "resumed" +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class SessionPluginsMarketplacesRefreshRequest: + name: str | None = None + """Marketplace name to refresh. When omitted, every registered marketplace is refreshed.""" + + @staticmethod + def from_dict(obj: Any) -> 'SessionPluginsMarketplacesRefreshRequest': + assert isinstance(obj, dict) + name = from_union([from_str, from_none], obj.get("name")) + return SessionPluginsMarketplacesRefreshRequest(name) + + def to_dict(self) -> dict: + result: dict = {} + if self.name is not None: + result["name"] = from_union([from_str, from_none], self.name) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class SessionPluginsReloadRequest: @@ -13736,6 +14101,9 @@ class TaskClientUpdateKind(Enum): class TaskCompleteData: """Task completion notification with summary from the agent""" + blocker: TaskBlocker | None = None + """Structured blocker details when outcome is blocked""" + objective_id: int | None = None """Active autopilot objective ID evaluated by the completion reviewer""" @@ -13758,15 +14126,18 @@ class TaskCompleteData: @staticmethod def from_dict(obj: Any) -> 'TaskCompleteData': assert isinstance(obj, dict) + blocker = from_union([TaskBlocker.from_dict, from_none], obj.get("blocker")) objective_id = from_union([from_int, from_none], obj.get("objectiveId")) outcome = from_union([TaskCompletionOutcome, from_none], obj.get("outcome")) reason = from_union([from_str, from_none], obj.get("reason")) success = from_union([from_bool, from_none], obj.get("success")) summary = from_union([from_str, from_none], obj.get("summary")) - return TaskCompleteData(objective_id, outcome, reason, success, summary) + return TaskCompleteData(blocker, objective_id, outcome, reason, success, summary) def to_dict(self) -> dict: result: dict = {} + if self.blocker is not None: + result["blocker"] = from_union([lambda x: to_class(TaskBlocker, x), from_none], self.blocker) if self.objective_id is not None: result["objectiveId"] = from_union([from_int, from_none], self.objective_id) if self.outcome is not None: @@ -14934,6 +15305,576 @@ def to_dict(self) -> dict: result["shadowedKeys"] = from_list(from_str, self.shadowed_keys) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowAbortRequest: + """Parameters for cooperatively aborting a workflow body.""" + + execution_token: str + """Opaque token identifying the execution attempt to abort.""" + + run_id: str + """Workflow run identifier.""" + + session_id: str + """Target session identifier""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowAbortRequest': + assert isinstance(obj, dict) + execution_token = from_str(obj.get("executionToken")) + run_id = from_str(obj.get("runId")) + session_id = from_str(obj.get("sessionId")) + return WorkflowAbortRequest(execution_token, run_id, session_id) + + def to_dict(self) -> dict: + result: dict = {} + result["executionToken"] = from_str(self.execution_token) + result["runId"] = from_str(self.run_id) + result["sessionId"] = from_str(self.session_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowACKResult: + """Acknowledgement that a workflow request was accepted.""" + @staticmethod + def from_dict(obj: Any) -> 'WorkflowACKResult': + assert isinstance(obj, dict) + return WorkflowACKResult() + + def to_dict(self) -> dict: + result: dict = {} + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowAgentOptions: + """Options for one workflow-scoped subagent call. + + Subagent execution options. + """ + agent: str | None = None + """Optional built-in or custom agent name whose definition configures the subagent.""" + + context_tier: ContextTier | None = None + """Optional context tier override for the subagent.""" + + label: str | None = None + """Optional label distinguishing otherwise identical memoized agent calls.""" + + model: str | None = None + """Optional model identifier for the subagent.""" + + reasoning_effort: str | None = None + """Optional reasoning effort override for the subagent.""" + + schema: Any = None + """Optional JSON Schema for structured agent output.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowAgentOptions': + assert isinstance(obj, dict) + agent = from_union([from_str, from_none], obj.get("agent")) + context_tier = from_union([ContextTier, from_none], obj.get("contextTier")) + label = from_union([from_str, from_none], obj.get("label")) + model = from_union([from_str, from_none], obj.get("model")) + reasoning_effort = from_union([from_str, from_none], obj.get("reasoningEffort")) + schema = obj.get("schema") + return WorkflowAgentOptions(agent, context_tier, label, model, reasoning_effort, schema) + + def to_dict(self) -> dict: + result: dict = {} + if self.agent is not None: + result["agent"] = from_union([from_str, from_none], self.agent) + if self.context_tier is not None: + result["contextTier"] = from_union([lambda x: to_enum(ContextTier, x), from_none], self.context_tier) + if self.label is not None: + result["label"] = from_union([from_str, from_none], self.label) + if self.model is not None: + result["model"] = from_union([from_str, from_none], self.model) + if self.reasoning_effort is not None: + result["reasoningEffort"] = from_union([from_str, from_none], self.reasoning_effort) + if self.schema is not None: + result["schema"] = self.schema + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowAgentResult: + """Result of one workflow-scoped subagent call.""" + + result: Any = None + """Agent result, omitted when the agent produced no result.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowAgentResult': + assert isinstance(obj, dict) + result = obj.get("result") + return WorkflowAgentResult(result) + + def to_dict(self) -> dict: + result: dict = {} + if self.result is not None: + result["result"] = self.result + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowCancelRequest: + """Parameters for cancelling a workflow run.""" + + run_id: str + """Workflow run identifier.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowCancelRequest': + assert isinstance(obj, dict) + run_id = from_str(obj.get("runId")) + return WorkflowCancelRequest(run_id) + + def to_dict(self) -> dict: + result: dict = {} + result["runId"] = from_str(self.run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowCurrentPhase: + """Current workflow phase identity.""" + + id: str + """Current phase identifier.""" + + ordinal: int | None = None + """Zero-based declared phase ordinal, or null for an undeclared phase.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowCurrentPhase': + assert isinstance(obj, dict) + id = from_str(obj.get("id")) + ordinal = from_union([from_none, from_int], obj.get("ordinal")) + return WorkflowCurrentPhase(id, ordinal) + + def to_dict(self) -> dict: + result: dict = {} + result["id"] = from_str(self.id) + result["ordinal"] = from_union([from_none, from_int], self.ordinal) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowDeclaredLimits: + """Declared or approved workflow resource ceilings. + + Resource ceilings declared by the workflow. + """ + max_ai_credits: float | None = None + """Maximum AI credits consumed by subagents and descendants.""" + + max_concurrent_subagents: int | None = None + """Maximum concurrently active subagents.""" + + max_total_subagents: int | None = None + """Maximum total subagents spawned by the run.""" + + timeout_seconds: float | None = None + """Maximum accumulated active execution time in seconds.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowDeclaredLimits': + assert isinstance(obj, dict) + max_ai_credits = from_union([from_float, from_none], obj.get("maxAiCredits")) + max_concurrent_subagents = from_union([from_int, from_none], obj.get("maxConcurrentSubagents")) + max_total_subagents = from_union([from_int, from_none], obj.get("maxTotalSubagents")) + timeout_seconds = from_union([from_float, from_none], obj.get("timeoutSeconds")) + return WorkflowDeclaredLimits(max_ai_credits, max_concurrent_subagents, max_total_subagents, timeout_seconds) + + def to_dict(self) -> dict: + result: dict = {} + if self.max_ai_credits is not None: + result["maxAiCredits"] = from_union([to_float, from_none], self.max_ai_credits) + if self.max_concurrent_subagents is not None: + result["maxConcurrentSubagents"] = from_union([from_int, from_none], self.max_concurrent_subagents) + if self.max_total_subagents is not None: + result["maxTotalSubagents"] = from_union([from_int, from_none], self.max_total_subagents) + if self.timeout_seconds is not None: + result["timeoutSeconds"] = from_union([to_float, from_none], self.timeout_seconds) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowExecuteRequest: + """Parameters sent to the owning extension to execute a workflow closure.""" + + args: Any + """Workflow input value.""" + + execution_token: str + """Opaque token identifying this workflow execution attempt.""" + + name: str + """Registered workflow name.""" + + run_id: str + """Workflow run identifier.""" + + session_id: str + """Target session identifier""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowExecuteRequest': + assert isinstance(obj, dict) + args = obj.get("args") + execution_token = from_str(obj.get("executionToken")) + name = from_str(obj.get("name")) + run_id = from_str(obj.get("runId")) + session_id = from_str(obj.get("sessionId")) + return WorkflowExecuteRequest(args, execution_token, name, run_id, session_id) + + def to_dict(self) -> dict: + result: dict = {} + result["args"] = self.args + result["executionToken"] = from_str(self.execution_token) + result["name"] = from_str(self.name) + result["runId"] = from_str(self.run_id) + result["sessionId"] = from_str(self.session_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowExecuteResult: + """Result returned by an extension workflow closure.""" + + result: Any = None + """Workflow result value.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowExecuteResult': + assert isinstance(obj, dict) + result = obj.get("result") + return WorkflowExecuteResult(result) + + def to_dict(self) -> dict: + result: dict = {} + if self.result is not None: + result["result"] = self.result + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowGetRunProgressRequest: + """Parameters for paging workflow progress.""" + + run_id: str + """Workflow run identifier.""" + + after_seq: int | None = None + """Exclusive forward cursor.""" + + before_seq: int | None = None + """Exclusive backward cursor.""" + + limit: int | None = None + """Maximum records to return. Defaults to 200 and is capped at 500.""" + + phase_id: str | None = None + """Optional phase identifier used to scope records and cursors.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowGetRunProgressRequest': + assert isinstance(obj, dict) + run_id = from_str(obj.get("runId")) + after_seq = from_union([from_int, from_none], obj.get("afterSeq")) + before_seq = from_union([from_int, from_none], obj.get("beforeSeq")) + limit = from_union([from_int, from_none], obj.get("limit")) + phase_id = from_union([from_str, from_none], obj.get("phaseId")) + return WorkflowGetRunProgressRequest(run_id, after_seq, before_seq, limit, phase_id) + + def to_dict(self) -> dict: + result: dict = {} + result["runId"] = from_str(self.run_id) + if self.after_seq is not None: + result["afterSeq"] = from_union([from_int, from_none], self.after_seq) + if self.before_seq is not None: + result["beforeSeq"] = from_union([from_int, from_none], self.before_seq) + if self.limit is not None: + result["limit"] = from_union([from_int, from_none], self.limit) + if self.phase_id is not None: + result["phaseId"] = from_union([from_str, from_none], self.phase_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowGetRunRequest: + """Parameters for retrieving a workflow run.""" + + run_id: str + """Workflow run identifier.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowGetRunRequest': + assert isinstance(obj, dict) + run_id = from_str(obj.get("runId")) + return WorkflowGetRunRequest(run_id) + + def to_dict(self) -> dict: + result: dict = {} + result["runId"] = from_str(self.run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowJournalGetRequest: + """Parameters for reading a workflow journal entry.""" + + execution_token: str + """Opaque token identifying the current workflow execution attempt.""" + + key: str + """Namespaced journal key.""" + + run_id: str + """Workflow run identifier.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowJournalGetRequest': + assert isinstance(obj, dict) + execution_token = from_str(obj.get("executionToken")) + key = from_str(obj.get("key")) + run_id = from_str(obj.get("runId")) + return WorkflowJournalGetRequest(execution_token, key, run_id) + + def to_dict(self) -> dict: + result: dict = {} + result["executionToken"] = from_str(self.execution_token) + result["key"] = from_str(self.key) + result["runId"] = from_str(self.run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowJournalGetResult: + """Result of reading a workflow journal entry.""" + + hit: bool + """Whether the journal contained the requested key.""" + + result_json: Any = None + """Cached JSON result. The hit field distinguishes a cached JSON null from a miss.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowJournalGetResult': + assert isinstance(obj, dict) + hit = from_bool(obj.get("hit")) + result_json = obj.get("resultJson") + return WorkflowJournalGetResult(hit, result_json) + + def to_dict(self) -> dict: + result: dict = {} + result["hit"] = from_bool(self.hit) + if self.result_json is not None: + result["resultJson"] = self.result_json + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowJournalPutRequest: + """Parameters for storing a workflow journal entry.""" + + execution_token: str + """Opaque token identifying the current workflow execution attempt.""" + + key: str + """Namespaced journal key.""" + + result_json: Any + """JSON result to memoize.""" + + run_id: str + """Workflow run identifier.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowJournalPutRequest': + assert isinstance(obj, dict) + execution_token = from_str(obj.get("executionToken")) + key = from_str(obj.get("key")) + result_json = obj.get("resultJson") + run_id = from_str(obj.get("runId")) + return WorkflowJournalPutRequest(execution_token, key, result_json, run_id) + + def to_dict(self) -> dict: + result: dict = {} + result["executionToken"] = from_str(self.execution_token) + result["key"] = from_str(self.key) + result["resultJson"] = self.result_json + result["runId"] = from_str(self.run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowListRunsRequest: + """Parameters for paging workflow runs.""" + + after_seq: int | None = None + """Exclusive forward cursor.""" + + before_seq: int | None = None + """Exclusive backward cursor.""" + + limit: int | None = None + """Maximum terminal runs to return. Defaults to 200 and is capped at 500.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowListRunsRequest': + assert isinstance(obj, dict) + after_seq = from_union([from_int, from_none], obj.get("afterSeq")) + before_seq = from_union([from_int, from_none], obj.get("beforeSeq")) + limit = from_union([from_int, from_none], obj.get("limit")) + return WorkflowListRunsRequest(after_seq, before_seq, limit) + + def to_dict(self) -> dict: + result: dict = {} + if self.after_seq is not None: + result["afterSeq"] = from_union([from_int, from_none], self.after_seq) + if self.before_seq is not None: + result["beforeSeq"] = from_union([from_int, from_none], self.before_seq) + if self.limit is not None: + result["limit"] = from_union([from_int, from_none], self.limit) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunConsumed: + """Durable resource consumption. + + Durable workflow resource consumption. + """ + active_ms: int + """Accumulated active execution time in milliseconds.""" + + nano_aiu: int + """AI usage consumed by the run in nano-AIU.""" + + subagents: int + """Total subagents spawned by the run.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunConsumed': + assert isinstance(obj, dict) + active_ms = from_int(obj.get("activeMs")) + nano_aiu = from_int(obj.get("nanoAiu")) + subagents = from_int(obj.get("subagents")) + return WorkflowRunConsumed(active_ms, nano_aiu, subagents) + + def to_dict(self) -> dict: + result: dict = {} + result["activeMs"] = from_int(self.active_ms) + result["nanoAiu"] = from_int(self.nano_aiu) + result["subagents"] = from_int(self.subagents) + return result + +class WorkflowRunFailureType(Enum): + WORKFLOW_ACCOUNTING_INCOMPLETE = "workflow_accounting_incomplete" + WORKFLOW_DURABLE_FAILURE = "workflow_durable_failure" + WORKFLOW_LIMIT_REACHED = "workflow_limit_reached" + WORKFLOW_PROVIDER_DISCONNECTED = "workflow_provider_disconnected" + WORKFLOW_RESUME_DECLINED = "workflow_resume_declined" + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowPauseCheckpointRequest: + """Parameters for an owned durable pause checkpoint.""" + + execution_token: str + """Opaque token identifying the execution attempt that reached the checkpoint.""" + + key: str + """Stable author-defined checkpoint key.""" + + run_id: str + """Workflow run identifier.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowPauseCheckpointRequest': + assert isinstance(obj, dict) + execution_token = from_str(obj.get("executionToken")) + key = from_str(obj.get("key")) + run_id = from_str(obj.get("runId")) + return WorkflowPauseCheckpointRequest(execution_token, key, run_id) + + def to_dict(self) -> dict: + result: dict = {} + result["executionToken"] = from_str(self.execution_token) + result["key"] = from_str(self.key) + result["runId"] = from_str(self.run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowPauseRequest: + """Parameters for pausing a running workflow.""" + + run_id: str + """Workflow run identifier.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowPauseRequest': + assert isinstance(obj, dict) + run_id = from_str(obj.get("runId")) + return WorkflowPauseRequest(run_id) + + def to_dict(self) -> dict: + result: dict = {} + result["runId"] = from_str(self.run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunLimits: + """Optional per-invocation resource ceiling overrides. + + Wire-only per-invocation workflow resource ceiling overrides. + + Per-invocation resource ceiling overrides. + """ + max_ai_credits: float | None = None + """Maximum AI credits consumed by workflow subagents and their descendants. The post-paid + ceiling is soft: parallel turns can settle beyond it before the run stops. + """ + max_concurrent_subagents: int | None = None + """Maximum number of workflow subagents that may run concurrently.""" + + max_total_subagents: int | None = None + """Maximum total number of workflow subagents that may be admitted.""" + + timeout_seconds: float | None = None + """Maximum accumulated active-execution time in seconds. Active execution includes the + entire extension body, subprocess waits, queued-agent waits, and sleeps; time between + resumed attempts is not counted. + """ + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunLimits': + assert isinstance(obj, dict) + max_ai_credits = from_union([from_float, from_none], obj.get("maxAiCredits")) + max_concurrent_subagents = from_union([from_none, from_int], obj.get("maxConcurrentSubagents")) + max_total_subagents = from_union([from_none, from_int], obj.get("maxTotalSubagents")) + timeout_seconds = from_union([from_none, from_float], obj.get("timeoutSeconds")) + return WorkflowRunLimits(max_ai_credits, max_concurrent_subagents, max_total_subagents, timeout_seconds) + + def to_dict(self) -> dict: + result: dict = {} + if self.max_ai_credits is not None: + result["maxAiCredits"] = from_union([to_float, from_none], self.max_ai_credits) + if self.max_concurrent_subagents is not None: + result["maxConcurrentSubagents"] = from_union([from_none, from_int], self.max_concurrent_subagents) + if self.max_total_subagents is not None: + result["maxTotalSubagents"] = from_union([from_none, from_int], self.max_total_subagents) + if self.timeout_seconds is not None: + result["timeoutSeconds"] = from_union([from_none, to_float], self.timeout_seconds) + return result + # Experimental: this type is part of an experimental API and may change or be removed. class WorkspaceDiffFileChangeType(Enum): """Type of change represented by this file diff.""" @@ -15904,6 +16845,63 @@ def to_dict(self) -> dict: result["source"] = to_enum(CatalogTrustSource, self.source) return result +@dataclass +class SourceClass: + """Where the card came from: exactly one of a URL or embedded data, encoded as a tagged + union so neither both nor neither can be represented. + + Where a candidate's card came from. Exactly one of a URL or embedded data: the union has + no variant carrying both, and no variant carrying neither, so the rule holds structurally + rather than by validation. + + Candidate whose card is retrieved from a URL through the runtime's hardened fetch + boundary. + + Candidate whose card reference arrived inline. The document and its content-derived + properties stay behind the runtime boundary. + + Bounded repository provenance declared through the catalog's sourceSet and repoPath + metadata. It contains no descriptor URL. + + Syntactically validated GitHub repository provenance declared by catalog metadata. This + is a source claim rather than proof that the descriptor URL resolves to the repository. + """ + kind: CatalogCandidateSourceKind | None = None + """Discriminator: the card is URL-backed, and carries no embedded data + + Discriminator: the card is embedded, and carries no URL + """ + url: str | None = None + """Card URL as advertised. Inert untrusted data: the runtime retrieves it only through its + own hardened boundary, and it is never logged. + """ + path: str | None = None + """Case-preserving safe relative POSIX path derived from metadata.repoPath.""" + + repository: str | None = None + """Canonical lowercase owner/repository name derived from metadata.sourceSet.""" + + @staticmethod + def from_dict(obj: Any) -> 'SourceClass': + assert isinstance(obj, dict) + kind = from_union([CatalogCandidateSourceKind, from_none], obj.get("kind")) + url = from_union([from_str, from_none], obj.get("url")) + path = from_union([from_str, from_none], obj.get("path")) + repository = from_union([from_str, from_none], obj.get("repository")) + return SourceClass(kind, url, path, repository) + + def to_dict(self) -> dict: + result: dict = {} + if self.kind is not None: + result["kind"] = from_union([lambda x: to_enum(CatalogCandidateSourceKind, x), from_none], self.kind) + if self.url is not None: + result["url"] = from_union([from_str, from_none], self.url) + if self.path is not None: + result["path"] = from_union([from_str, from_none], self.path) + if self.repository is not None: + result["repository"] = from_union([from_str, from_none], self.repository) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class CatalogAuthenticationRequiredError: @@ -16078,9 +17076,12 @@ class CatalogNegotiatedContract: Protocol version and capabilities the runtime honoured. """ granted_capabilities: list[CatalogCapability] - """Wire features the runtime understood for this operation. Always a superset of the - caller's required features, because any shortfall is a refusal instead. Operation - availability remains a separate typed result. + """Wire features the runtime understood for this operation. Includes the five original + catalog capabilities and only explicitly requested supported additions, in supported + order without duplicates. Capabilities that introduce new success-union variants or + operations are therefore included only when explicitly required, preserving older + protocol-v3 clients. Always a superset of the caller's required features, because any + shortfall is a refusal instead. Operation availability remains a separate typed result. """ runtime_protocol_version: int """Protocol version of the runtime that served the request.""" @@ -16098,45 +17099,6 @@ def to_dict(self) -> dict: result["runtimeProtocolVersion"] = from_int(self.runtime_protocol_version) return result -# Experimental: this type is part of an experimental API and may change or be removed. -@dataclass -class CatalogSearchRequest: - """A bounded catalog search. Both the query length and the result count are capped by the - schema so a caller cannot request an unbounded scan. - """ - contract: CatalogClientContract - """Protocol version and capabilities the caller requires.""" - - query: str - """Free-text search query. Persisted as tool input for session continuity, but omitted from - telemetry. - """ - kinds: list[CatalogCandidateKind] | None = None - """Restrict results to these candidate kinds. When omitted, every kind the runtime supports - is searched. - """ - limit: int | None = None - """Maximum number of candidates to return. Defaults to 10 when omitted.""" - - @staticmethod - def from_dict(obj: Any) -> 'CatalogSearchRequest': - assert isinstance(obj, dict) - contract = CatalogClientContract.from_dict(obj.get("contract")) - query = from_str(obj.get("query")) - kinds = from_union([lambda x: from_list(CatalogCandidateKind, x), from_none], obj.get("kinds")) - limit = from_union([from_int, from_none], obj.get("limit")) - return CatalogSearchRequest(contract, query, kinds, limit) - - def to_dict(self) -> dict: - result: dict = {} - result["contract"] = to_class(CatalogClientContract, self.contract) - result["query"] = from_str(self.query) - if self.kinds is not None: - result["kinds"] = from_union([lambda x: from_list(lambda x: to_enum(CatalogCandidateKind, x), x), from_none], self.kinds) - if self.limit is not None: - result["limit"] = from_union([from_int, from_none], self.limit) - return result - # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class CatalogContractViolationError: @@ -16206,8 +17168,9 @@ def to_dict(self) -> dict: # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class CatalogInvalidRequestError: - """The request was rejected before any work was done, because a bounded field fell outside - its permitted range or a required field was unusable. + """The request was rejected because a bounded field fell outside its permitted range or a + required field was unusable. Pagination may also be rejected by the authority after a + continuation request; repeat the search without page. """ field: CatalogInvalidRequestField """Which request field was rejected.""" @@ -16234,41 +17197,6 @@ def to_dict(self) -> dict: result["message"] = from_str(self.message) return result -# Experimental: this type is part of an experimental API and may change or be removed. -@dataclass -class CatalogMalformedCardError: - """A card could not be parsed or did not satisfy its declared media type's schema.""" - - kind: ClassVar[str] = "malformed-card" - """Discriminator: the card was malformed""" - - message: str - """Human-readable explanation, safe to surface. Never echoes card content, nor a query, URL, - handle, or secret. - """ - reason: CatalogMalformedCardReason - """How the card failed validation.""" - - media_type: CatalogMediaType | None = None - """Media type the card was interpreted as, when it declared one this runtime recognises.""" - - @staticmethod - def from_dict(obj: Any) -> 'CatalogMalformedCardError': - assert isinstance(obj, dict) - message = from_str(obj.get("message")) - reason = CatalogMalformedCardReason(obj.get("reason")) - media_type = from_union([CatalogMediaType, from_none], obj.get("mediaType")) - return CatalogMalformedCardError(message, reason, media_type) - - def to_dict(self) -> dict: - result: dict = {} - result["kind"] = self.kind - result["message"] = from_str(self.message) - result["reason"] = to_enum(CatalogMalformedCardReason, self.reason) - if self.media_type is not None: - result["mediaType"] = from_union([lambda x: to_enum(CatalogMediaType, x), from_none], self.media_type) - return result - # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class MCPServerCardEmbedded: @@ -16489,6 +17417,365 @@ def to_dict(self) -> dict: result["source"] = to_enum(MCPPlanPolicySource, self.source) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSearchPagination: + """Authority-reported navigation metadata, returned only to callers requiring + catalog-search-pagination and only when a supported token is present. Tokenless + first-page and continuation responses omit this object; no counts are inferred from + candidates. The opaque token may be retained for previous or numbered navigation even + when hasNextPage is false. + + Navigation metadata for callers explicitly requiring catalog-search-pagination. Omitted + when the authority returns no token, including tokenless first-page and continuation + responses. Counts are never substituted from candidates.length. + """ + current_page: int + """One-based page returned by the authority.""" + + has_next_page: bool + """Whether the authority token advertises a valid next target within the navigation window. + Not inferred from token presence, truncated, or currentPage being less than pageCount. + """ + max_page: int + """Navigation window ceiling ceil(1000 / pageSize), not the number of existing pages. Legal + targets must not exceed this ceiling or the token's signed pageCount. + """ + page_count: int + """Backend-reported page count, which may exceed maxPage. Present pagination metadata always + describes a multi-page result; zero- and single-page responses omit pagination. + Navigation targets must also be within the signed pageCount carried by the supplied token. + """ + page_size: int + """Page size bound to the search, equal to the effective request limit.""" + + token: str + """Opaque authority-issued pagination token. Only the runtime decodes it or changes + targetPage; SDK consumers must not decode, modify or log it. It has no runtime-created + expiry or cache. + """ + total_count: int + """Backend-reported count for this response, not the number of returned candidates. Its + relationship to the full query result set is unknown. + """ + total_count_relation: CatalogSearchTotalCountRelation + """The relationship of totalCount to the complete query result set is unknown; neither + exactness nor a lower-bound guarantee is implied. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSearchPagination': + assert isinstance(obj, dict) + current_page = from_int(obj.get("currentPage")) + has_next_page = from_bool(obj.get("hasNextPage")) + max_page = from_int(obj.get("maxPage")) + page_count = from_int(obj.get("pageCount")) + page_size = from_int(obj.get("pageSize")) + token = from_str(obj.get("token")) + total_count = from_int(obj.get("totalCount")) + total_count_relation = CatalogSearchTotalCountRelation(obj.get("totalCountRelation")) + return CatalogSearchPagination(current_page, has_next_page, max_page, page_count, page_size, token, total_count, total_count_relation) + + def to_dict(self) -> dict: + result: dict = {} + result["currentPage"] = from_int(self.current_page) + result["hasNextPage"] = from_bool(self.has_next_page) + result["maxPage"] = from_int(self.max_page) + result["pageCount"] = from_int(self.page_count) + result["pageSize"] = from_int(self.page_size) + result["token"] = from_str(self.token) + result["totalCount"] = from_int(self.total_count) + result["totalCountRelation"] = to_enum(CatalogSearchTotalCountRelation, self.total_count_relation) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionCancelled: + """The caller cancelled the selection interaction and the retained search state was released.""" + + kind: ClassVar[str] = "cancelled" + """Discriminator: selection was cancelled""" + + search_id: str + """The search identifier privately bound to the released selection group.""" + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionCancelled': + assert isinstance(obj, dict) + search_id = from_str(obj.get("searchId")) + return CatalogSelectionCancelled(search_id) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["searchId"] = from_str(self.search_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class PermissionDecisionCancelled: + """Permission-decision variant indicating the request was cancelled before use, with an + optional reason. + """ + kind: ClassVar[str] = "cancelled" + """The permission request was cancelled before a response was used""" + + reason: str | None = None + """Optional explanation of why the request was cancelled""" + + @staticmethod + def from_dict(obj: Any) -> 'PermissionDecisionCancelled': + assert isinstance(obj, dict) + reason = from_union([from_str, from_none], obj.get("reason")) + return PermissionDecisionCancelled(reason) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + if self.reason is not None: + result["reason"] = from_union([from_str, from_none], self.reason) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionRequest: + """Terminates one retained catalog selection group through an opaque reference previously + returned by the model-safe search projection. + """ + contract: CatalogClientContract + """Protocol version and capabilities the caller requires.""" + + outcome: CatalogSelectionDecision + """The terminal outcome declared by the caller. Timed-out means the host's live interaction + deadline elapsed; a reference whose runtime TTL elapsed is rejected separately as stale. + """ + selection_ref: str + """Opaque runtime-instance scoped reference to one visible candidate. For a non-selected + outcome, any candidate reference from the same search closes that search's retained group. + """ + session_id: str + """Locally owned root session whose retained search state is being resolved.""" + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionRequest': + assert isinstance(obj, dict) + contract = CatalogClientContract.from_dict(obj.get("contract")) + outcome = CatalogSelectionDecision(obj.get("outcome")) + selection_ref = from_str(obj.get("selectionRef")) + session_id = from_str(obj.get("sessionId")) + return CatalogSelectionRequest(contract, outcome, selection_ref, session_id) + + def to_dict(self) -> dict: + result: dict = {} + result["contract"] = to_class(CatalogClientContract, self.contract) + result["outcome"] = to_enum(CatalogSelectionDecision, self.outcome) + result["selectionRef"] = from_str(self.selection_ref) + result["sessionId"] = from_str(self.session_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionDeclined: + """The caller explicitly declined every candidate and the retained search state was released.""" + + kind: ClassVar[str] = "declined" + """Discriminator: the candidates were declined""" + + search_id: str + """The search identifier privately bound to the released selection group.""" + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionDeclined': + assert isinstance(obj, dict) + search_id = from_str(obj.get("searchId")) + return CatalogSelectionDeclined(search_id) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["searchId"] = from_str(self.search_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionForeign: + """The selection reference belongs to another runtime instance or session.""" + + kind: ClassVar[str] = "foreign" + """Discriminator for this typed selection rejection""" + + message: str + """Human-readable explanation safe to surface. Never contains the presented reference or + private candidate state. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionForeign': + assert isinstance(obj, dict) + message = from_str(obj.get("message")) + return CatalogSelectionForeign(message) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["message"] = from_str(self.message) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionInvalid: + """The selection reference was malformed or unknown.""" + + kind: ClassVar[str] = "invalid" + """Discriminator for this typed selection rejection""" + + message: str + """Human-readable explanation safe to surface. Never contains the presented reference or + private candidate state. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionInvalid': + assert isinstance(obj, dict) + message = from_str(obj.get("message")) + return CatalogSelectionInvalid(message) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["message"] = from_str(self.message) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionReplayed: + """The selection group was already terminated or its pending host hand-off was already + claimed. + """ + kind: ClassVar[str] = "replayed" + """Discriminator for this typed selection rejection""" + + message: str + """Human-readable explanation safe to surface. Never contains the presented reference or + private candidate state. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionReplayed': + assert isinstance(obj, dict) + message = from_str(obj.get("message")) + return CatalogSelectionReplayed(message) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["message"] = from_str(self.message) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionSelected: + """The chosen candidate was transferred into a fresh bounded single-use handle for a later + explicit planning request. + """ + candidate_handle: str + """Fresh single-use candidate handle accepted by mcp.planInstall. Returned only to the + native host and never included in model-tool output. + """ + kind: ClassVar[str] = "selected" + """Discriminator: one candidate was selected""" + + search_id: str + """The exact search identifier privately bound to the selected candidate.""" + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionSelected': + assert isinstance(obj, dict) + candidate_handle = from_str(obj.get("candidateHandle")) + search_id = from_str(obj.get("searchId")) + return CatalogSelectionSelected(candidate_handle, search_id) + + def to_dict(self) -> dict: + result: dict = {} + result["candidateHandle"] = from_str(self.candidate_handle) + result["kind"] = self.kind + result["searchId"] = from_str(self.search_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionStale: + """The runtime-enforced selection reference lifetime elapsed before the request arrived.""" + + kind: ClassVar[str] = "stale" + """Discriminator for this typed selection rejection""" + + message: str + """Human-readable explanation safe to surface. Never contains the presented reference or + private candidate state. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionStale': + assert isinstance(obj, dict) + message = from_str(obj.get("message")) + return CatalogSelectionStale(message) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["message"] = from_str(self.message) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionTimedOut: + """The host declared that its live selection interaction timed out, and the retained search + state was released. + """ + kind: ClassVar[str] = "timed-out" + """Discriminator: the host's live interaction timed out""" + + search_id: str + """The search identifier privately bound to the released selection group.""" + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionTimedOut': + assert isinstance(obj, dict) + search_id = from_str(obj.get("searchId")) + return CatalogSelectionTimedOut(search_id) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["searchId"] = from_str(self.search_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSelectionWrongKind: + """The presented opaque handle was issued for another catalog operation.""" + + kind: ClassVar[str] = "wrong-kind" + """Discriminator for this typed selection rejection""" + + message: str + """Human-readable explanation safe to surface. Never contains the presented reference or + private candidate state. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSelectionWrongKind': + assert isinstance(obj, dict) + message = from_str(obj.get("message")) + return CatalogSelectionWrongKind(message) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["message"] = from_str(self.message) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class CatalogUnavailableError: @@ -16580,40 +17867,6 @@ def to_dict(self) -> dict: result["reason"] = to_enum(CatalogUnsafeRetrievalReason, self.reason) return result -# Experimental: this type is part of an experimental API and may change or be removed. -@dataclass -class CatalogUnsupportedKindError: - """The request asked for a candidate kind this runtime does not serve.""" - - kind: ClassVar[str] = "unsupported-kind" - """Discriminator: an unsupported candidate kind was requested""" - - message: str - """Human-readable explanation, safe to surface. Never contains a query, URL, handle, or - secret. - """ - requested_kinds: list[CatalogCandidateKind] - """The kinds from the request that are not supported.""" - - supported_kinds: list[CatalogCandidateKind] - """Every candidate kind this runtime can serve.""" - - @staticmethod - def from_dict(obj: Any) -> 'CatalogUnsupportedKindError': - assert isinstance(obj, dict) - message = from_str(obj.get("message")) - requested_kinds = from_list(CatalogCandidateKind, obj.get("requestedKinds")) - supported_kinds = from_list(CatalogCandidateKind, obj.get("supportedKinds")) - return CatalogUnsupportedKindError(message, requested_kinds, supported_kinds) - - def to_dict(self) -> dict: - result: dict = {} - result["kind"] = self.kind - result["message"] = from_str(self.message) - result["requestedKinds"] = from_list(lambda x: to_enum(CatalogCandidateKind, x), self.requested_kinds) - result["supportedKinds"] = from_list(lambda x: to_enum(CatalogCandidateKind, x), self.supported_kinds) - return result - # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class ClientTaskCancelRequest: @@ -17095,7 +18348,7 @@ class CatalogAISkillCandidateProvenance: """Host of the catalog authority that advertised the reference, without path, query, or credentials. Inert untrusted data. """ - media_type: MediaType + media_type: CatalogAISkillMediaType """Media type advertised for the referenced AI skill card""" observed_at: str @@ -17107,55 +18360,14 @@ class CatalogAISkillCandidateProvenance: def from_dict(obj: Any) -> 'CatalogAISkillCandidateProvenance': assert isinstance(obj, dict) authority = from_str(obj.get("authority")) - media_type = MediaType(obj.get("mediaType")) + media_type = CatalogAISkillMediaType(obj.get("mediaType")) observed_at = from_str(obj.get("observedAt")) return CatalogAISkillCandidateProvenance(authority, media_type, observed_at) def to_dict(self) -> dict: result: dict = {} result["authority"] = from_str(self.authority) - result["mediaType"] = to_enum(MediaType, self.media_type) - result["observedAt"] = from_str(self.observed_at) - return result - -@dataclass -class CatalogCandidateProvenance: - """Where the catalog reference was observed, without the card itself or any content digest. - - Where and when an MCP server catalog reference was observed. Discovery provenance - deliberately carries no content digest because search does not establish the exact - validated content a later plan will bind. - - Where and when an AI skill catalog reference was observed. Discovery provenance - deliberately carries no content digest because search does not establish the exact - validated content a later plan will bind. - """ - authority: str - """Host of the catalog authority that advertised the reference, without path, query, or - credentials. Inert untrusted data. - """ - media_type: CatalogMediaType - """JSON MCP media type advertised for the referenced card. - - Media type advertised for the referenced AI skill card - """ - observed_at: str - """ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a - retrieval or validation timestamp. - """ - - @staticmethod - def from_dict(obj: Any) -> 'CatalogCandidateProvenance': - assert isinstance(obj, dict) - authority = from_str(obj.get("authority")) - media_type = CatalogMediaType(obj.get("mediaType")) - observed_at = from_str(obj.get("observedAt")) - return CatalogCandidateProvenance(authority, media_type, observed_at) - - def to_dict(self) -> dict: - result: dict = {} - result["authority"] = from_str(self.authority) - result["mediaType"] = to_enum(CatalogMediaType, self.media_type) + result["mediaType"] = to_enum(CatalogAISkillMediaType, self.media_type) result["observedAt"] = from_str(self.observed_at) return result @@ -18077,7 +19289,7 @@ class FactoryRunFailure: type: FactoryRunFailureType """Factory failure variant discriminator.""" - kind: FactoryRunFailureKind | None = None + kind: RunFailureKind | None = None """Resource ceiling that stopped the run.""" suggested_value: float | None = None @@ -18092,7 +19304,7 @@ class FactoryRunFailure: code: str | None = None """Stable failure code.""" - operation: FactoryDurableOperation | None = None + operation: DurableOperation | None = None """Execution-critical durable operation that failed.""" drained_nano_aiu: int | None = None @@ -18103,12 +19315,12 @@ def from_dict(obj: Any) -> 'FactoryRunFailure': assert isinstance(obj, dict) run_id = from_str(obj.get("runId")) type = FactoryRunFailureType(obj.get("type")) - kind = from_union([FactoryRunFailureKind, from_none], obj.get("kind")) + kind = from_union([RunFailureKind, from_none], obj.get("kind")) suggested_value = from_union([from_float, from_none], obj.get("suggestedValue")) value = from_union([from_float, from_none], obj.get("value")) reason = from_union([from_str, from_none], obj.get("reason")) code = from_union([from_str, from_none], obj.get("code")) - operation = from_union([FactoryDurableOperation, from_none], obj.get("operation")) + operation = from_union([DurableOperation, from_none], obj.get("operation")) drained_nano_aiu = from_union([from_int, from_none], obj.get("drainedNanoAiu")) return FactoryRunFailure(run_id, type, kind, suggested_value, value, reason, code, operation, drained_nano_aiu) @@ -18117,7 +19329,7 @@ def to_dict(self) -> dict: result["runId"] = from_str(self.run_id) result["type"] = to_enum(FactoryRunFailureType, self.type) if self.kind is not None: - result["kind"] = from_union([lambda x: to_enum(FactoryRunFailureKind, x), from_none], self.kind) + result["kind"] = from_union([lambda x: to_enum(RunFailureKind, x), from_none], self.kind) if self.suggested_value is not None: result["suggestedValue"] = from_union([to_float, from_none], self.suggested_value) if self.value is not None: @@ -18127,7 +19339,7 @@ def to_dict(self) -> dict: if self.code is not None: result["code"] = from_union([from_str, from_none], self.code) if self.operation is not None: - result["operation"] = from_union([lambda x: to_enum(FactoryDurableOperation, x), from_none], self.operation) + result["operation"] = from_union([lambda x: to_enum(DurableOperation, x), from_none], self.operation) if self.drained_nano_aiu is not None: result["drainedNanoAiu"] = from_union([from_int, from_none], self.drained_nano_aiu) return result @@ -18181,12 +19393,61 @@ def to_dict(self) -> dict: result["key"] = from_union([from_str, from_none], self.key) return result +@dataclass +class WorkflowRunTerminalPauseInfo: + type: PauseInfoType + """Workflow pause initiator discriminator.""" + + key: str | None = None + """Stable author-defined checkpoint key that initiated the pause.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunTerminalPauseInfo': + assert isinstance(obj, dict) + type = PauseInfoType(obj.get("type")) + key = from_union([from_str, from_none], obj.get("key")) + return WorkflowRunTerminalPauseInfo(type, key) + + def to_dict(self) -> dict: + result: dict = {} + result["type"] = to_enum(PauseInfoType, self.type) + if self.key is not None: + result["key"] = from_union([from_str, from_none], self.key) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowPauseInfo: + """Durable metadata describing who initiated a workflow pause. + + Structured pause initiator metadata for a paused attempt. + """ + type: PauseInfoType + """Workflow pause initiator discriminator.""" + + key: str | None = None + """Stable author-defined checkpoint key that initiated the pause.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowPauseInfo': + assert isinstance(obj, dict) + type = PauseInfoType(obj.get("type")) + key = from_union([from_str, from_none], obj.get("key")) + return WorkflowPauseInfo(type, key) + + def to_dict(self) -> dict: + result: dict = {} + result["type"] = to_enum(PauseInfoType, self.type) + if self.key is not None: + result["key"] = from_union([from_str, from_none], self.key) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class FactoryLogLine: """One ordered factory progress line.""" - kind: FactoryLogLineKind + kind: LogLineKind """Progress line kind.""" seq: int @@ -18198,14 +19459,14 @@ class FactoryLogLine: @staticmethod def from_dict(obj: Any) -> 'FactoryLogLine': assert isinstance(obj, dict) - kind = FactoryLogLineKind(obj.get("kind")) + kind = LogLineKind(obj.get("kind")) seq = from_int(obj.get("seq")) text = from_str(obj.get("text")) return FactoryLogLine(kind, seq, text) def to_dict(self) -> dict: result: dict = {} - result["kind"] = to_enum(FactoryLogLineKind, self.kind) + result["kind"] = to_enum(LogLineKind, self.kind) result["seq"] = from_int(self.seq) result["text"] = from_str(self.text) return result @@ -18218,7 +19479,7 @@ class FactoryProgressLine: attempt: int """Resume attempt that emitted this record.""" - kind: FactoryLogLineKind + kind: LogLineKind """Progress record kind.""" recorded_at: int @@ -18237,7 +19498,7 @@ class FactoryProgressLine: def from_dict(obj: Any) -> 'FactoryProgressLine': assert isinstance(obj, dict) attempt = from_int(obj.get("attempt")) - kind = FactoryLogLineKind(obj.get("kind")) + kind = LogLineKind(obj.get("kind")) recorded_at = from_int(obj.get("recordedAt")) seq = from_int(obj.get("seq")) text = from_str(obj.get("text")) @@ -18247,7 +19508,80 @@ def from_dict(obj: Any) -> 'FactoryProgressLine': def to_dict(self) -> dict: result: dict = {} result["attempt"] = from_int(self.attempt) - result["kind"] = to_enum(FactoryLogLineKind, self.kind) + result["kind"] = to_enum(LogLineKind, self.kind) + result["recordedAt"] = from_int(self.recorded_at) + result["seq"] = from_int(self.seq) + result["text"] = from_str(self.text) + result["phaseId"] = from_union([from_none, from_str], self.phase_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowLogLine: + """One ordered workflow progress line.""" + + kind: LogLineKind + """Progress line kind.""" + + seq: int + """Monotonic sequence number within the workflow run.""" + + text: str + """Progress text.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowLogLine': + assert isinstance(obj, dict) + kind = LogLineKind(obj.get("kind")) + seq = from_int(obj.get("seq")) + text = from_str(obj.get("text")) + return WorkflowLogLine(kind, seq, text) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = to_enum(LogLineKind, self.kind) + result["seq"] = from_int(self.seq) + result["text"] = from_str(self.text) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowProgressLine: + """One durable workflow progress record.""" + + attempt: int + """Resume attempt that emitted this record.""" + + kind: LogLineKind + """Progress record kind.""" + + recorded_at: int + """Epoch milliseconds when the record was persisted.""" + + seq: int + """Global monotonic sequence number within the run.""" + + text: str + """Prompt-safe progress text.""" + + phase_id: str | None = None + """Phase active when the record was emitted, or null before any phase.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowProgressLine': + assert isinstance(obj, dict) + attempt = from_int(obj.get("attempt")) + kind = LogLineKind(obj.get("kind")) + recorded_at = from_int(obj.get("recordedAt")) + seq = from_int(obj.get("seq")) + text = from_str(obj.get("text")) + phase_id = from_union([from_none, from_str], obj.get("phaseId")) + return WorkflowProgressLine(attempt, kind, recorded_at, seq, text, phase_id) + + def to_dict(self) -> dict: + result: dict = {} + result["attempt"] = from_int(self.attempt) + result["kind"] = to_enum(LogLineKind, self.kind) result["recordedAt"] = from_int(self.recorded_at) result["seq"] = from_int(self.seq) result["text"] = from_str(self.text) @@ -18278,7 +19612,7 @@ class FactoryPhaseObservation: live_agent_count: int """Direct agents in this phase that are currently live.""" - status: FactoryPhaseStatus + status: PhaseStatus """Derived lifecycle state of the phase.""" title: str @@ -18311,7 +19645,7 @@ def from_dict(obj: Any) -> 'FactoryPhaseObservation': id = from_str(obj.get("id")) last_entered_run_attempt = from_int(obj.get("lastEnteredRunAttempt")) live_agent_count = from_int(obj.get("liveAgentCount")) - status = FactoryPhaseStatus(obj.get("status")) + status = PhaseStatus(obj.get("status")) title = from_str(obj.get("title")) total_agent_count = from_int(obj.get("totalAgentCount")) completed_at = from_union([from_int, from_none], obj.get("completedAt")) @@ -18328,7 +19662,93 @@ def to_dict(self) -> dict: result["id"] = from_str(self.id) result["lastEnteredRunAttempt"] = from_int(self.last_entered_run_attempt) result["liveAgentCount"] = from_int(self.live_agent_count) - result["status"] = to_enum(FactoryPhaseStatus, self.status) + result["status"] = to_enum(PhaseStatus, self.status) + result["title"] = from_str(self.title) + result["totalAgentCount"] = from_int(self.total_agent_count) + if self.completed_at is not None: + result["completedAt"] = from_union([from_int, from_none], self.completed_at) + if self.detail is not None: + result["detail"] = from_union([from_str, from_none], self.detail) + result["ordinal"] = from_union([from_none, from_int], self.ordinal) + if self.started_at is not None: + result["startedAt"] = from_union([from_int, from_none], self.started_at) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowPhaseObservation: + """Durable lifecycle and timing for one workflow phase.""" + + accumulated_active_ms: int + """Completed active time accumulated by this phase in milliseconds.""" + + current_active_ms: int + """Current live active time for this phase in milliseconds.""" + + entry_count: int + """Number of times execution entered this phase.""" + + id: str + """Phase identifier.""" + + last_entered_run_attempt: int + """Most recent run attempt that entered this phase, or `0` if the phase has never been + entered. + """ + live_agent_count: int + """Direct agents in this phase that are currently live.""" + + status: PhaseStatus + """Derived lifecycle state of the phase.""" + + title: str + """Human-readable phase title.""" + + total_agent_count: int + """Total direct agents associated with this phase.""" + + completed_at: int | None = None + """Epoch milliseconds when this phase completed; for a skipped phase, the synthetic skip + timestamp (equal to `startedAt`). + """ + detail: str | None = None + """Optional human-readable phase detail.""" + + ordinal: int | None = None + """Zero-based declared phase ordinal, or null for an undeclared phase.""" + + started_at: int | None = None + """Epoch milliseconds when this phase first started; for a skipped phase, the synthetic skip + timestamp (equal to `completedAt`). + """ + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowPhaseObservation': + assert isinstance(obj, dict) + accumulated_active_ms = from_int(obj.get("accumulatedActiveMs")) + current_active_ms = from_int(obj.get("currentActiveMs")) + entry_count = from_int(obj.get("entryCount")) + id = from_str(obj.get("id")) + last_entered_run_attempt = from_int(obj.get("lastEnteredRunAttempt")) + live_agent_count = from_int(obj.get("liveAgentCount")) + status = PhaseStatus(obj.get("status")) + title = from_str(obj.get("title")) + total_agent_count = from_int(obj.get("totalAgentCount")) + completed_at = from_union([from_int, from_none], obj.get("completedAt")) + detail = from_union([from_str, from_none], obj.get("detail")) + ordinal = from_union([from_none, from_int], obj.get("ordinal")) + started_at = from_union([from_int, from_none], obj.get("startedAt")) + return WorkflowPhaseObservation(accumulated_active_ms, current_active_ms, entry_count, id, last_entered_run_attempt, live_agent_count, status, title, total_agent_count, completed_at, detail, ordinal, started_at) + + def to_dict(self) -> dict: + result: dict = {} + result["accumulatedActiveMs"] = from_int(self.accumulated_active_ms) + result["currentActiveMs"] = from_int(self.current_active_ms) + result["entryCount"] = from_int(self.entry_count) + result["id"] = from_str(self.id) + result["lastEnteredRunAttempt"] = from_int(self.last_entered_run_attempt) + result["liveAgentCount"] = from_int(self.live_agent_count) + result["status"] = to_enum(PhaseStatus, self.status) result["title"] = from_str(self.title) result["totalAgentCount"] = from_int(self.total_agent_count) if self.completed_at is not None: @@ -19869,8 +21289,9 @@ def to_dict(self) -> dict: # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class MCPPlanConfigurationChange: - """One change applying the plan would make, described rather than serialised so the - configuration payload stays behind the runtime boundary. + """The configuration-change alternative for the transportChoices entry at the same index. + Only the selected alternative is applied; entries are not cumulative. The payload stays + behind the runtime boundary. """ changed_fields: list[str] """Names of the configuration fields the change would set, without their values.""" @@ -20083,11 +21504,10 @@ class MCPPlanInstallSourceCandidate: search_id: str """The runtime- or authority-minted `searchId` returned with the search that produced this - candidate. A search implementation binds it to private candidate-handle context; a - planning implementation must verify that context before returning a plan. The unavailable - planning implementation in this contract layer validates presence but does not claim the - verification has occurred. It identifies a search rather than a person and must never be - joined with user identity to re-identify anyone. + candidate. Planning verifies the private correlation and atomically consumes a matching + candidate before downstream work, including attempts that subsequently fail or report + unavailable. A mismatched search does not consume the candidate. It identifies a search + rather than a person and must never be joined with user identity to re-identify anyone. """ @staticmethod @@ -20726,6 +22146,10 @@ class ModelSwitchToResult: persistence_error: str | None = None """Persistence failure encountered after applying the model switch.""" + queue_id: str | None = None + """Stable queue item identifier when this request was enqueued. Remains present if the item + drains before the response is returned. + """ status: str | None = None """Lifecycle result for the requested switch""" @@ -20742,9 +22166,10 @@ def from_dict(obj: Any) -> 'ModelSwitchToResult': model_id = from_union([from_str, from_none], obj.get("modelId")) model_state = from_union([CurrentModel.from_dict, from_none], obj.get("modelState")) persistence_error = from_union([from_str, from_none], obj.get("persistenceError")) + queue_id = from_union([from_str, from_none], obj.get("queueId")) status = from_union([from_str, from_none], obj.get("status")) warning = from_union([from_str, from_none], obj.get("warning")) - return ModelSwitchToResult(confirmation, deferred, deprecation_warnings, message, model_id, model_state, persistence_error, status, warning) + return ModelSwitchToResult(confirmation, deferred, deprecation_warnings, message, model_id, model_state, persistence_error, queue_id, status, warning) def to_dict(self) -> dict: result: dict = {} @@ -20762,6 +22187,8 @@ def to_dict(self) -> dict: result["modelState"] = from_union([lambda x: to_class(CurrentModel, x), from_none], self.model_state) if self.persistence_error is not None: result["persistenceError"] = from_union([from_str, from_none], self.persistence_error) + if self.queue_id is not None: + result["queueId"] = from_union([from_str, from_none], self.queue_id) if self.status is not None: result["status"] = from_union([from_str, from_none], self.status) if self.warning is not None: @@ -21889,31 +23316,6 @@ def to_dict(self) -> dict: result["kind"] = self.kind return result -# Experimental: this type is part of an experimental API and may change or be removed. -@dataclass -class PermissionDecisionCancelled: - """Permission-decision variant indicating the request was cancelled before use, with an - optional reason. - """ - kind: ClassVar[str] = "cancelled" - """The permission request was cancelled before a response was used""" - - reason: str | None = None - """Optional explanation of why the request was cancelled""" - - @staticmethod - def from_dict(obj: Any) -> 'PermissionDecisionCancelled': - assert isinstance(obj, dict) - reason = from_union([from_str, from_none], obj.get("reason")) - return PermissionDecisionCancelled(reason) - - def to_dict(self) -> dict: - result: dict = {} - result["kind"] = self.kind - if self.reason is not None: - result["reason"] = from_union([from_str, from_none], self.reason) - return result - # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class PermissionDecisionContext: @@ -22355,6 +23757,70 @@ def to_dict(self) -> dict: result["prompt"] = from_str(self.prompt) return result +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogAgentPluginCompatibilityTag(Enum): + """Explicit Agent Plugin compatibility declared by exact catalog tags. Clients must not + infer these values from display text or other metadata. + """ + CANVAS = "canvas" + CANVAS_ONLY = "canvas-only" + GITHUB_COPILOT = "github-copilot" + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogAgentPluginCandidateKind(Enum): + """Discriminator for an Agent Plugin candidate""" + + PLUGIN = "plugin" + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogAgentPluginMediaType(Enum): + """Canonical Agent Plugin media type. + + Canonical Agent Plugin media type + """ + APPLICATION_VND_GITHUB_COPILOT_PLUGIN = "application/vnd.github.copilot-plugin" + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogCandidateKind(Enum): + """Discriminator for an MCP server candidate + + Discriminator for an AI skill candidate + + Discriminator for an Agent Plugin candidate + + What kind of resource a catalog candidate describes + """ + AI_SKILL = "ai-skill" + MCP_SERVER = "mcp-server" + PLUGIN = "plugin" + +# Experimental: this type is part of an experimental API and may change or be removed. +class CatalogMediaType(Enum): + """JSON MCP media type of the underlying card. + + JSON MCP card media type accepted for install planning + + JSON MCP media type advertised for the referenced card. + + JSON MCP media type the validated card was interpreted as. + + Media type the card is expected to conform to. + + Canonical AI skill media type + + Canonical Agent Plugin media type. + + Canonical Agent Plugin media type + + Media type the card was interpreted as, when it declared one this runtime recognises. + + Media type a catalog card is interpreted as + """ + APPLICATION_AI_SKILL = "application/ai-skill" + APPLICATION_MCP_SERVER_CARD_JSON = "application/mcp-server-card+json" + APPLICATION_MCP_SERVER_JSON = "application/mcp-server+json" + APPLICATION_VND_GITHUB_COPILOT_PLUGIN = "application/vnd.github.copilot-plugin" + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class MCPSourcePlugin: @@ -22410,6 +23876,11 @@ class InstalledPluginInfo: for direct repo / URL / local installs; absent for marketplace plugins. Same source yields the same id; distinct sources never collide. """ + installed: bool | None = None + """Whether the managed desired plugin currently has an installed or live record. Set to + false for a managed desired entry retained in the listing after installation or + reconciliation failed. + """ installed_from: str | None = None """Absolute path of the marketplace directory a live plugin was resolved from. Present only on live, never-persisted records — a plugin belonging to a directory/local marketplace, @@ -22418,6 +23889,13 @@ class InstalledPluginInfo: plugin is always present on disk, so `enabled` is its only meaningful state and it is never "not installed". """ + managed: bool | None = None + """Whether enterprise managed settings control this plugin's enabled state.""" + + managed_desired_enabled: bool | None = None + """The enabled state required by enterprise managed settings, when this plugin spec is + managed. + """ source: str | None = None """Runtime-reported plugin provenance. Currently set to "builtin" only for plugins registered through the trusted host built-in boundary; absent for installed, marketplace, @@ -22433,10 +23911,13 @@ def from_dict(obj: Any) -> 'InstalledPluginInfo': marketplace = from_str(obj.get("marketplace")) name = from_str(obj.get("name")) direct_source_id = from_union([from_str, from_none], obj.get("directSourceId")) + installed = from_union([from_bool, from_none], obj.get("installed")) installed_from = from_union([from_str, from_none], obj.get("installedFrom")) + managed = from_union([from_bool, from_none], obj.get("managed")) + managed_desired_enabled = from_union([from_bool, from_none], obj.get("managedDesiredEnabled")) source = from_union([from_str, from_none], obj.get("source")) version = from_union([from_str, from_none], obj.get("version")) - return InstalledPluginInfo(enabled, marketplace, name, direct_source_id, installed_from, source, version) + return InstalledPluginInfo(enabled, marketplace, name, direct_source_id, installed, installed_from, managed, managed_desired_enabled, source, version) def to_dict(self) -> dict: result: dict = {} @@ -22445,8 +23926,14 @@ def to_dict(self) -> dict: result["name"] = from_str(self.name) if self.direct_source_id is not None: result["directSourceId"] = from_union([from_str, from_none], self.direct_source_id) + if self.installed is not None: + result["installed"] = from_union([from_bool, from_none], self.installed) if self.installed_from is not None: result["installedFrom"] = from_union([from_str, from_none], self.installed_from) + if self.managed is not None: + result["managed"] = from_union([from_bool, from_none], self.managed) + if self.managed_desired_enabled is not None: + result["managedDesiredEnabled"] = from_union([from_bool, from_none], self.managed_desired_enabled) if self.source is not None: result["source"] = from_union([from_str, from_none], self.source) if self.version is not None: @@ -22757,6 +24244,73 @@ def to_dict(self) -> dict: result["name"] = from_str(self.name) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class SessionPluginsDisableRequest: + """Plugin names (or specs) to disable in the session's authoritative working directory.""" + + names: list[str] + """Plugin names or "plugin@marketplace" specs to disable. Unknown names are ignored. + Non-marketplace direct installs cannot be disabled via this API; uninstall them instead. + Plugin-owned MCP servers are stopped in active sessions immediately; other plugin + contributions remain available until each session reloads plugins. + """ + + @staticmethod + def from_dict(obj: Any) -> 'SessionPluginsDisableRequest': + assert isinstance(obj, dict) + names = from_list(from_str, obj.get("names")) + return SessionPluginsDisableRequest(names) + + def to_dict(self) -> dict: + result: dict = {} + result["names"] = from_list(from_str, self.names) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class SessionPluginsEnableRequest: + """Plugin names (or specs) to enable in the session's authoritative working directory.""" + + names: list[str] + """Plugin names or "plugin@marketplace" specs to enable. Unknown names are ignored. + Non-marketplace direct installs are always enabled and cannot be toggled via this API. + """ + + @staticmethod + def from_dict(obj: Any) -> 'SessionPluginsEnableRequest': + assert isinstance(obj, dict) + names = from_list(from_str, obj.get("names")) + return SessionPluginsEnableRequest(names) + + def to_dict(self) -> dict: + result: dict = {} + result["names"] = from_list(from_str, self.names) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class SessionPluginsInstallRequest: + """Plugin source resolved relative to the session's authoritative working directory.""" + + source: str + """Plugin install spec. Accepts the same forms as the CLI: "plugin@marketplace" (marketplace + install), "owner/repo" or "owner/repo:subpath" (GitHub direct), an http/https/ssh URL, or + a local path. Direct (non-marketplace) installs are deprecated and will produce a + deprecationWarning in the result. + """ + + @staticmethod + def from_dict(obj: Any) -> 'SessionPluginsInstallRequest': + assert isinstance(obj, dict) + source = from_str(obj.get("source")) + return SessionPluginsInstallRequest(source) + + def to_dict(self) -> dict: + result: dict = {} + result["source"] = from_str(self.source) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class ProtocolSystemMessageAppendConfig: @@ -22844,10 +24398,12 @@ def to_dict(self) -> dict: return result # Experimental: this type is part of an experimental API and may change or be removed. -class FactoryPauseCheckpointAction(Enum): +class PauseCheckpointAction(Enum): """Action the runtime selected for a durable factory pause checkpoint. Whether this execution attempt must pause or may continue. + + Action the runtime selected for a durable workflow pause checkpoint. """ CONTINUE = "continue" PAUSE = "pause" @@ -23590,6 +25146,53 @@ def to_dict(self) -> dict: result["url"] = from_str(self.url) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class QueueAppendSteeringRequest: + """Append to one pending steering message without changing its identity or delivery position.""" + + agent_mode: SendAgentMode + """Mode captured at submission. Only steering messages in the same mode may be combined.""" + + attachments: list[Attachment] + """Attachments to add after the message's existing attachments. An empty list preserves the + existing attachments. + """ + display_prompt: str + """Display text to append to the existing preview after a blank line.""" + + expected_prompt: str + """Expected current prompt, including any previous appends. The runtime applies plan-mode + normalization before comparing and refuses a changed message. + """ + message_id: str + """Message identity returned by send, not the queue item id. Only unclaimed user steering + messages are eligible. + """ + prompt: str + """Text to append after a blank line.""" + + @staticmethod + def from_dict(obj: Any) -> 'QueueAppendSteeringRequest': + assert isinstance(obj, dict) + agent_mode = SendAgentMode(obj.get("agentMode")) + attachments = from_list(Attachment.from_dict, obj.get("attachments")) + display_prompt = from_str(obj.get("displayPrompt")) + expected_prompt = from_str(obj.get("expectedPrompt")) + message_id = from_str(obj.get("messageId")) + prompt = from_str(obj.get("prompt")) + return QueueAppendSteeringRequest(agent_mode, attachments, display_prompt, expected_prompt, message_id, prompt) + + def to_dict(self) -> dict: + result: dict = {} + result["agentMode"] = to_enum(SendAgentMode, self.agent_mode) + result["attachments"] = from_list(lambda x: to_class(Attachment, x), self.attachments) + result["displayPrompt"] = from_str(self.display_prompt) + result["expectedPrompt"] = from_str(self.expected_prompt) + result["messageId"] = from_str(self.message_id) + result["prompt"] = from_str(self.prompt) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class QueueInsertMessage: @@ -24006,12 +25609,11 @@ class SandboxConfigUserPolicyNetwork: matches strict subdomains, and * denies every host. """ proxy: SandboxConfigUserPolicyNetworkProxy | None = None - """HTTP(S) proxy for sandboxed traffic. With host rules, this is the built-in local proxy's - upstream; credentials stay in the runtime, and Linux and macOS restrict the child to the - local listener. Without host rules, Linux restricts egress to this endpoint but rejects - credentials, and macOS proxying is cooperative. Windows enforcement depends on the - application's networking stack. Configure credentials in the separate username/password - fields. The transient local listener URL is never persisted. + """HTTP(S) proxy for sandboxed traffic. This is the built-in local proxy's upstream: every + sandboxed command reaches it through a loopback listener, so credentials stay in the + runtime and never reach the child. On Windows the sandbox also needs local network + access, because it reaches that listener over host loopback. Configure credentials in the + separate username/password fields. The transient local listener URL is never persisted. """ @staticmethod @@ -24210,14 +25812,21 @@ def to_dict(self) -> dict: @dataclass class SessionFSSetProviderRequest: """Initial working directory, session-state path layout, and path conventions used to - register the calling SDK client as the session filesystem provider. + register the calling SDK client as the session filesystem provider. A registered provider + is authoritative for path interpretation and filesystem facts used by workspace + permission validation. Paths are interpreted lexically; home-relative paths (`~` and + `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until + provider-side canonicalization is supported, providers must not expose symlinks inside + allowed roots that escape those roots. """ conventions: SessionFSSetProviderConventions """Path conventions used by this filesystem""" initial_cwd: str - """Initial working directory for sessions""" - + """Absolute initial working directory for sessions. Registering the provider establishes + this path as the root of its virtual namespace; the runtime does not require the provider + to materialize or stat it before creating a session. + """ session_state_path: str """Path within each session's SessionFs where the runtime stores files for that session""" @@ -26660,6 +28269,256 @@ def to_dict(self) -> dict: result["settings"] = from_dict(lambda x: to_class(UserSettingMetadata, x), self.settings) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowAgentRequest: + """Parameters for one workflow-scoped subagent call.""" + + execution_token: str + """Opaque token identifying the current workflow execution attempt.""" + + opts: WorkflowAgentOptions + """Subagent execution options.""" + + prompt: str + """Prompt to send to the subagent.""" + + workflow_run_id: str + """Workflow run identifier that owns the subagent.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowAgentRequest': + assert isinstance(obj, dict) + execution_token = from_str(obj.get("executionToken")) + opts = WorkflowAgentOptions.from_dict(obj.get("opts")) + prompt = from_str(obj.get("prompt")) + workflow_run_id = from_str(obj.get("workflowRunId")) + return WorkflowAgentRequest(execution_token, opts, prompt, workflow_run_id) + + def to_dict(self) -> dict: + result: dict = {} + result["executionToken"] = from_str(self.execution_token) + result["opts"] = to_class(WorkflowAgentOptions, self.opts) + result["prompt"] = from_str(self.prompt) + result["workflowRunId"] = from_str(self.workflow_run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunFailure: + """Machine-readable terminal failure. + + Machine-readable workflow run failure. + + Machine-readable failure details for a halted or errored run. + + The run stopped because its usage accounting could not be completed. + + The extension that owns the workflow disconnected while the run was executing, so the + host halted it. The run's journaled subagent results are preserved so a resume can reuse + them. + """ + run_id: str + """Workflow run identifier. + + Workflow run identifier whose changed limits were declined. + """ + type: WorkflowRunFailureType + """Workflow failure variant discriminator.""" + + kind: RunFailureKind | None = None + """Resource ceiling that stopped the run.""" + + suggested_value: float | None = None + """Suggested larger ceiling when the runtime can derive one safely.""" + + value: float | None = None + """Approved effective ceiling that was reached.""" + + reason: str | None = None + """Human-readable reason the resume did not proceed.""" + + code: str | None = None + """Stable failure code.""" + + operation: DurableOperation | None = None + """Execution-critical durable operation that failed.""" + + drained_nano_aiu: int | None = None + """Confirmed usage in nano-AIU, representing the floor of what the run spent.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunFailure': + assert isinstance(obj, dict) + run_id = from_str(obj.get("runId")) + type = WorkflowRunFailureType(obj.get("type")) + kind = from_union([RunFailureKind, from_none], obj.get("kind")) + suggested_value = from_union([from_float, from_none], obj.get("suggestedValue")) + value = from_union([from_float, from_none], obj.get("value")) + reason = from_union([from_str, from_none], obj.get("reason")) + code = from_union([from_str, from_none], obj.get("code")) + operation = from_union([DurableOperation, from_none], obj.get("operation")) + drained_nano_aiu = from_union([from_int, from_none], obj.get("drainedNanoAiu")) + return WorkflowRunFailure(run_id, type, kind, suggested_value, value, reason, code, operation, drained_nano_aiu) + + def to_dict(self) -> dict: + result: dict = {} + result["runId"] = from_str(self.run_id) + result["type"] = to_enum(WorkflowRunFailureType, self.type) + if self.kind is not None: + result["kind"] = from_union([lambda x: to_enum(RunFailureKind, x), from_none], self.kind) + if self.suggested_value is not None: + result["suggestedValue"] = from_union([to_float, from_none], self.suggested_value) + if self.value is not None: + result["value"] = from_union([to_float, from_none], self.value) + if self.reason is not None: + result["reason"] = from_union([from_str, from_none], self.reason) + if self.code is not None: + result["code"] = from_union([from_str, from_none], self.code) + if self.operation is not None: + result["operation"] = from_union([lambda x: to_enum(DurableOperation, x), from_none], self.operation) + if self.drained_nano_aiu is not None: + result["drainedNanoAiu"] = from_union([from_int, from_none], self.drained_nano_aiu) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowResumeRequest: + """Parameters for resuming a workflow run from its persisted identity.""" + + run_id: str + """Workflow run identifier.""" + + limits: WorkflowRunLimits | None = None + """Optional per-invocation resource ceiling overrides.""" + + log_phase_names: bool | None = None + """Whether to emit workflow phase names to the session transcript.""" + + notify_on_complete: bool | None = None + """Whether to notify the originating session when the workflow completes.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowResumeRequest': + assert isinstance(obj, dict) + run_id = from_str(obj.get("runId")) + limits = from_union([WorkflowRunLimits.from_dict, from_none], obj.get("limits")) + log_phase_names = from_union([from_bool, from_none], obj.get("logPhaseNames")) + notify_on_complete = from_union([from_bool, from_none], obj.get("notifyOnComplete")) + return WorkflowResumeRequest(run_id, limits, log_phase_names, notify_on_complete) + + def to_dict(self) -> dict: + result: dict = {} + result["runId"] = from_str(self.run_id) + if self.limits is not None: + result["limits"] = from_union([lambda x: to_class(WorkflowRunLimits, x), from_none], self.limits) + if self.log_phase_names is not None: + result["logPhaseNames"] = from_union([from_bool, from_none], self.log_phase_names) + if self.notify_on_complete is not None: + result["notifyOnComplete"] = from_union([from_bool, from_none], self.notify_on_complete) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunOptions: + """Options controlling workflow invocation. + + Workflow invocation options. + """ + limits: WorkflowRunLimits | None = None + """Per-invocation resource ceiling overrides.""" + + log_phase_names: bool | None = None + """Whether to emit workflow phase names to the session transcript.""" + + notify_on_complete: bool | None = None + """Whether to notify the originating session when the workflow completes.""" + + resume_from_run_id: str | None = None + """Run identifier whose journal and progress should seed this resumed run.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunOptions': + assert isinstance(obj, dict) + limits = from_union([WorkflowRunLimits.from_dict, from_none], obj.get("limits")) + log_phase_names = from_union([from_bool, from_none], obj.get("logPhaseNames")) + notify_on_complete = from_union([from_bool, from_none], obj.get("notifyOnComplete")) + resume_from_run_id = from_union([from_str, from_none], obj.get("resumeFromRunId")) + return WorkflowRunOptions(limits, log_phase_names, notify_on_complete, resume_from_run_id) + + def to_dict(self) -> dict: + result: dict = {} + if self.limits is not None: + result["limits"] = from_union([lambda x: to_class(WorkflowRunLimits, x), from_none], self.limits) + if self.log_phase_names is not None: + result["logPhaseNames"] = from_union([from_bool, from_none], self.log_phase_names) + if self.notify_on_complete is not None: + result["notifyOnComplete"] = from_union([from_bool, from_none], self.notify_on_complete) + if self.resume_from_run_id is not None: + result["resumeFromRunId"] = from_union([from_str, from_none], self.resume_from_run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +# Internal: this type is an internal SDK API and is not part of the public surface. +@dataclass +class _WorkflowToolResumeRequest: + """Internal parameters for resuming a workflow run from a tool.""" + + run_id: str + """Workflow run identifier.""" + + limits: WorkflowRunLimits | None = None + """Optional per-invocation resource ceiling overrides.""" + + tool_call_id: str | None = None + """Opaque identifier of the originating tool call.""" + + @staticmethod + def from_dict(obj: Any) -> '_WorkflowToolResumeRequest': + assert isinstance(obj, dict) + run_id = from_str(obj.get("runId")) + limits = from_union([WorkflowRunLimits.from_dict, from_none], obj.get("limits")) + tool_call_id = from_union([from_str, from_none], obj.get("toolCallId")) + return _WorkflowToolResumeRequest(run_id, limits, tool_call_id) + + def to_dict(self) -> dict: + result: dict = {} + result["runId"] = from_str(self.run_id) + if self.limits is not None: + result["limits"] = from_union([lambda x: to_class(WorkflowRunLimits, x), from_none], self.limits) + if self.tool_call_id is not None: + result["toolCallId"] = from_union([from_str, from_none], self.tool_call_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +# Internal: this type is an internal SDK API and is not part of the public surface. +@dataclass +class _WorkflowToolRunOptions: + """Options for an internal tool-originated workflow invocation. + + Tool-originated workflow invocation options. + """ + limits: WorkflowRunLimits | None = None + """Per-invocation resource ceiling overrides.""" + + resume_from_run_id: str | None = None + """Run identifier whose journal and progress should seed this resumed run.""" + + @staticmethod + def from_dict(obj: Any) -> '_WorkflowToolRunOptions': + assert isinstance(obj, dict) + limits = from_union([WorkflowRunLimits.from_dict, from_none], obj.get("limits")) + resume_from_run_id = from_union([from_str, from_none], obj.get("resumeFromRunId")) + return _WorkflowToolRunOptions(limits, resume_from_run_id) + + def to_dict(self) -> dict: + result: dict = {} + if self.limits is not None: + result["limits"] = from_union([lambda x: to_class(WorkflowRunLimits, x), from_none], self.limits) + if self.resume_from_run_id is not None: + result["resumeFromRunId"] = from_union([from_str, from_none], self.resume_from_run_id) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class WorkspaceDiffFileChange: @@ -27254,13 +29113,13 @@ class CatalogAISkillCandidate: handle_expires_at: str """ISO 8601 timestamp after which the handle is stale and will be rejected.""" - installability: Installability + installability: CatalogAISkillInstallability """AI skills are discovery-only and cannot be installed through this surface""" kind: CatalogAISkillCandidateKind """Discriminator: this candidate describes an AI skill""" - media_type: MediaType + media_type: CatalogAISkillMediaType """Media type of the underlying AI skill card""" provenance: CatalogAISkillCandidateProvenance @@ -27288,9 +29147,9 @@ def from_dict(obj: Any) -> 'CatalogAISkillCandidate': display_name = from_str(obj.get("displayName")) handle = from_str(obj.get("handle")) handle_expires_at = from_str(obj.get("handleExpiresAt")) - installability = Installability(obj.get("installability")) + installability = CatalogAISkillInstallability(obj.get("installability")) kind = CatalogAISkillCandidateKind(obj.get("kind")) - media_type = MediaType(obj.get("mediaType")) + media_type = CatalogAISkillMediaType(obj.get("mediaType")) provenance = CatalogAISkillCandidateProvenance.from_dict(obj.get("provenance")) source = _load_CatalogCandidateSource(obj.get("source")) description = from_union([from_str, from_none], obj.get("description")) @@ -27303,9 +29162,9 @@ def to_dict(self) -> dict: result["displayName"] = from_str(self.display_name) result["handle"] = from_str(self.handle) result["handleExpiresAt"] = from_str(self.handle_expires_at) - result["installability"] = to_enum(Installability, self.installability) + result["installability"] = to_enum(CatalogAISkillInstallability, self.installability) result["kind"] = to_enum(CatalogAISkillCandidateKind, self.kind) - result["mediaType"] = to_enum(MediaType, self.media_type) + result["mediaType"] = to_enum(CatalogAISkillMediaType, self.media_type) result["provenance"] = to_class(CatalogAISkillCandidateProvenance, self.provenance) result["source"] = (self.source).to_dict() if self.description is not None: @@ -27316,98 +29175,6 @@ def to_dict(self) -> dict: result["trust"] = from_union([lambda x: (x).to_dict(), from_none], self.trust) return result -# Experimental: this type is part of an experimental API and may change or be removed. -@dataclass -class CatalogCandidate: - """One inert catalog result, represented as an MCP server or discovery-only AI skill variant - so kind, media type, provenance, and installability cannot contradict each other. - - An inert MCP server catalog result. Every free-text field is untrusted external data and - must never be treated as an instruction, and the handle is the only way to refer to the - candidate in a later operation. - - An inert AI skill catalog result. AI skills are discovery-only and cannot be represented - as installable through this surface. - """ - display_name: str - """Display name taken verbatim from the card. Inert untrusted text.""" - - handle: str - """Opaque, runtime-instance scoped, TTL-bound, single-use handle for this candidate. Carries - no readable information and is rejected when stale, replayed, or presented to a different - runtime instance. Never logged. - """ - handle_expires_at: str - """ISO 8601 timestamp after which the handle is stale and will be rejected.""" - - installability: CatalogCandidateInstallability - """Whether this MCP server can be planned for installation, and if policy prevents it. - - AI skills are discovery-only and cannot be installed through this surface - """ - kind: CatalogCandidateKind - """Discriminator: this candidate describes an MCP server - - Discriminator: this candidate describes an AI skill - """ - media_type: CatalogMediaType - """JSON MCP media type of the underlying card. - - Media type of the underlying AI skill card - """ - provenance: CatalogCandidateProvenance - """Where the catalog reference was observed, without the card itself or any content digest.""" - - source: CatalogCandidateSource - """Where the card came from: exactly one of a URL or embedded data, encoded as a tagged - union so neither both nor neither can be represented. - """ - description: str | None = None - """Description taken verbatim from the card. Inert untrusted text.""" - - publisher: str | None = None - """Publisher taken verbatim from the card. Inert untrusted text.""" - - trust: CatalogTrustSnapshot | None = None - """Versioned trust metadata observed from the catalog authority. Optional for protocol-3 - compatibility with runtimes that predate trust snapshots. A trust-capable runtime emits - an explicit snapshot even when the authority omitted or malformed its trust field. - """ - - @staticmethod - def from_dict(obj: Any) -> 'CatalogCandidate': - assert isinstance(obj, dict) - display_name = from_str(obj.get("displayName")) - handle = from_str(obj.get("handle")) - handle_expires_at = from_str(obj.get("handleExpiresAt")) - installability = CatalogCandidateInstallability(obj.get("installability")) - kind = CatalogCandidateKind(obj.get("kind")) - media_type = CatalogMediaType(obj.get("mediaType")) - provenance = CatalogCandidateProvenance.from_dict(obj.get("provenance")) - source = _load_CatalogCandidateSource(obj.get("source")) - description = from_union([from_str, from_none], obj.get("description")) - publisher = from_union([from_str, from_none], obj.get("publisher")) - trust = from_union([_load_CatalogTrustSnapshot, from_none], obj.get("trust")) - return CatalogCandidate(display_name, handle, handle_expires_at, installability, kind, media_type, provenance, source, description, publisher, trust) - - def to_dict(self) -> dict: - result: dict = {} - result["displayName"] = from_str(self.display_name) - result["handle"] = from_str(self.handle) - result["handleExpiresAt"] = from_str(self.handle_expires_at) - result["installability"] = to_enum(CatalogCandidateInstallability, self.installability) - result["kind"] = to_enum(CatalogCandidateKind, self.kind) - result["mediaType"] = to_enum(CatalogMediaType, self.media_type) - result["provenance"] = to_class(CatalogCandidateProvenance, self.provenance) - result["source"] = (self.source).to_dict() - if self.description is not None: - result["description"] = from_union([from_str, from_none], self.description) - if self.publisher is not None: - result["publisher"] = from_union([from_str, from_none], self.publisher) - if self.trust is not None: - result["trust"] = from_union([lambda x: (x).to_dict(), from_none], self.trust) - return result - # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class CatalogMCPServerCandidate: @@ -28060,7 +29827,7 @@ class FactoryRunResult: run_id: str """Factory run identifier.""" - status: FactoryRunStatus + status: RunStatus """Current or terminal factory run status.""" attempt: int | None = None @@ -28089,7 +29856,7 @@ class FactoryRunResult: def from_dict(obj: Any) -> 'FactoryRunResult': assert isinstance(obj, dict) run_id = from_str(obj.get("runId")) - status = FactoryRunStatus(obj.get("status")) + status = RunStatus(obj.get("status")) attempt = from_union([from_int, from_none], obj.get("attempt")) error = from_union([from_str, from_none], obj.get("error")) failure = from_union([FactoryRunFailure.from_dict, from_none], obj.get("failure")) @@ -28102,7 +29869,7 @@ def from_dict(obj: Any) -> 'FactoryRunResult': def to_dict(self) -> dict: result: dict = {} result["runId"] = from_str(self.run_id) - result["status"] = to_enum(FactoryRunStatus, self.status) + result["status"] = to_enum(RunStatus, self.status) if self.attempt is not None: result["attempt"] = from_union([from_int, from_none], self.attempt) if self.error is not None: @@ -28194,6 +29961,81 @@ def to_dict(self) -> dict: result["oldestSeq"] = from_union([from_int, from_none], self.oldest_seq) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowLogRequest: + """Parameters for recording workflow progress.""" + + execution_token: str + """Opaque token identifying the current workflow execution attempt.""" + + lines: list[WorkflowLogLine] + """Ordered progress lines to append.""" + + run_id: str + """Workflow run identifier.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowLogRequest': + assert isinstance(obj, dict) + execution_token = from_str(obj.get("executionToken")) + lines = from_list(WorkflowLogLine.from_dict, obj.get("lines")) + run_id = from_str(obj.get("runId")) + return WorkflowLogRequest(execution_token, lines, run_id) + + def to_dict(self) -> dict: + result: dict = {} + result["executionToken"] = from_str(self.execution_token) + result["lines"] = from_list(lambda x: to_class(WorkflowLogLine, x), self.lines) + result["runId"] = from_str(self.run_id) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowProgressPage: + """A bidirectional page of workflow progress. + + Bidirectional page of durable workflow progress. + """ + has_more_newer: bool + """Whether progress records newer than this page exist.""" + + has_more_older: bool + """Whether progress records older than this page exist.""" + + records: list[WorkflowProgressLine] + """Progress records in sequence order.""" + + revision: int + """Run revision reflected by this page.""" + + newest_seq: int | None = None + """Newest sequence number in this page, or null when empty.""" + + oldest_seq: int | None = None + """Oldest sequence number in this page, or null when empty.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowProgressPage': + assert isinstance(obj, dict) + has_more_newer = from_bool(obj.get("hasMoreNewer")) + has_more_older = from_bool(obj.get("hasMoreOlder")) + records = from_list(WorkflowProgressLine.from_dict, obj.get("records")) + revision = from_int(obj.get("revision")) + newest_seq = from_union([from_int, from_none], obj.get("newestSeq")) + oldest_seq = from_union([from_int, from_none], obj.get("oldestSeq")) + return WorkflowProgressPage(has_more_newer, has_more_older, records, revision, newest_seq, oldest_seq) + + def to_dict(self) -> dict: + result: dict = {} + result["hasMoreNewer"] = from_bool(self.has_more_newer) + result["hasMoreOlder"] = from_bool(self.has_more_older) + result["records"] = from_list(lambda x: to_class(WorkflowProgressLine, x), self.records) + result["revision"] = from_int(self.revision) + result["newestSeq"] = from_union([from_int, from_none], self.newest_seq) + result["oldestSeq"] = from_union([from_int, from_none], self.oldest_seq) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class FactoryRunRequest: @@ -29392,6 +31234,210 @@ def to_dict(self) -> dict: result["scope"] = to_enum(AdditionalContentExclusionPolicyScope, self.scope) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogAgentPluginCandidateProvenance: + """Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw + data, or content digest. + + Where and when an Agent Plugin catalog reference was observed. Discovery provenance + deliberately carries no descriptor URL, raw data, candidate handle, or content digest. + """ + authority: str + """Host of the catalog authority that advertised the reference, without path, query, or + credentials. Inert untrusted data. + """ + media_type: CatalogAgentPluginMediaType + """Canonical Agent Plugin media type.""" + + observed_at: str + """ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a + retrieval or validation timestamp. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogAgentPluginCandidateProvenance': + assert isinstance(obj, dict) + authority = from_str(obj.get("authority")) + media_type = CatalogAgentPluginMediaType(obj.get("mediaType")) + observed_at = from_str(obj.get("observedAt")) + return CatalogAgentPluginCandidateProvenance(authority, media_type, observed_at) + + def to_dict(self) -> dict: + result: dict = {} + result["authority"] = from_str(self.authority) + result["mediaType"] = to_enum(CatalogAgentPluginMediaType, self.media_type) + result["observedAt"] = from_str(self.observed_at) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSearchRequest: + """A bounded catalog search. Both the query length and the result count are capped by the + schema so a caller cannot request an unbounded scan. + """ + contract: CatalogClientContract + """Protocol version and capabilities the caller requires.""" + + query: str + """Free-text search query. Persisted as tool input for session continuity, but omitted from + telemetry. + """ + kinds: list[CatalogCandidateKind] | None = None + """Restrict results to these candidate kinds. Agent Plugins are opt-in and require the + `agent-plugin-discovery` capability so protocol-v3 clients generated before that variant + cannot receive an unknown result; when omitted, the backwards-compatible MCP server and + AI skill kinds are searched. + """ + limit: int | None = None + """Maximum number of candidates to return. Defaults to 10 when omitted.""" + + page: CatalogSearchPage | None = None + """Numbered navigation using metadata from an earlier response. Requires + catalog-search-pagination and the same query, kinds and effective limit. Omit for a fresh + first-page search. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSearchRequest': + assert isinstance(obj, dict) + contract = CatalogClientContract.from_dict(obj.get("contract")) + query = from_str(obj.get("query")) + kinds = from_union([lambda x: from_list(CatalogCandidateKind, x), from_none], obj.get("kinds")) + limit = from_union([from_int, from_none], obj.get("limit")) + page = from_union([CatalogSearchPage.from_dict, from_none], obj.get("page")) + return CatalogSearchRequest(contract, query, kinds, limit, page) + + def to_dict(self) -> dict: + result: dict = {} + result["contract"] = to_class(CatalogClientContract, self.contract) + result["query"] = from_str(self.query) + if self.kinds is not None: + result["kinds"] = from_union([lambda x: from_list(lambda x: to_enum(CatalogCandidateKind, x), x), from_none], self.kinds) + if self.limit is not None: + result["limit"] = from_union([from_int, from_none], self.limit) + if self.page is not None: + result["page"] = from_union([lambda x: to_class(CatalogSearchPage, x), from_none], self.page) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogUnsupportedKindError: + """The request asked for a candidate kind this runtime does not serve.""" + + kind: ClassVar[str] = "unsupported-kind" + """Discriminator: an unsupported candidate kind was requested""" + + message: str + """Human-readable explanation, safe to surface. Never contains a query, URL, handle, or + secret. + """ + requested_kinds: list[CatalogCandidateKind] + """The kinds from the request that are not supported.""" + + supported_kinds: list[CatalogCandidateKind] + """Every candidate kind this runtime can serve.""" + + @staticmethod + def from_dict(obj: Any) -> 'CatalogUnsupportedKindError': + assert isinstance(obj, dict) + message = from_str(obj.get("message")) + requested_kinds = from_list(CatalogCandidateKind, obj.get("requestedKinds")) + supported_kinds = from_list(CatalogCandidateKind, obj.get("supportedKinds")) + return CatalogUnsupportedKindError(message, requested_kinds, supported_kinds) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["message"] = from_str(self.message) + result["requestedKinds"] = from_list(lambda x: to_enum(CatalogCandidateKind, x), self.requested_kinds) + result["supportedKinds"] = from_list(lambda x: to_enum(CatalogCandidateKind, x), self.supported_kinds) + return result + +@dataclass +class CatalogCandidateProvenance: + """Where the catalog reference was observed, without the card itself or any content digest. + + Where and when an MCP server catalog reference was observed. Discovery provenance + deliberately carries no content digest because search does not establish the exact + validated content a later plan will bind. + + Where and when an AI skill catalog reference was observed. Discovery provenance + deliberately carries no content digest because search does not establish the exact + validated content a later plan will bind. + + Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw + data, or content digest. + + Where and when an Agent Plugin catalog reference was observed. Discovery provenance + deliberately carries no descriptor URL, raw data, candidate handle, or content digest. + """ + authority: str + """Host of the catalog authority that advertised the reference, without path, query, or + credentials. Inert untrusted data. + """ + media_type: CatalogMediaType + """JSON MCP media type advertised for the referenced card. + + Media type advertised for the referenced AI skill card + + Canonical Agent Plugin media type. + """ + observed_at: str + """ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a + retrieval or validation timestamp. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogCandidateProvenance': + assert isinstance(obj, dict) + authority = from_str(obj.get("authority")) + media_type = CatalogMediaType(obj.get("mediaType")) + observed_at = from_str(obj.get("observedAt")) + return CatalogCandidateProvenance(authority, media_type, observed_at) + + def to_dict(self) -> dict: + result: dict = {} + result["authority"] = from_str(self.authority) + result["mediaType"] = to_enum(CatalogMediaType, self.media_type) + result["observedAt"] = from_str(self.observed_at) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogMalformedCardError: + """A card could not be parsed or did not satisfy its declared media type's schema.""" + + kind: ClassVar[str] = "malformed-card" + """Discriminator: the card was malformed""" + + message: str + """Human-readable explanation, safe to surface. Never echoes card content, nor a query, URL, + handle, or secret. + """ + reason: CatalogMalformedCardReason + """How the card failed validation.""" + + media_type: CatalogMediaType | None = None + """Media type the card was interpreted as, when it declared one this runtime recognises.""" + + @staticmethod + def from_dict(obj: Any) -> 'CatalogMalformedCardError': + assert isinstance(obj, dict) + message = from_str(obj.get("message")) + reason = CatalogMalformedCardReason(obj.get("reason")) + media_type = from_union([CatalogMediaType, from_none], obj.get("mediaType")) + return CatalogMalformedCardError(message, reason, media_type) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = self.kind + result["message"] = from_str(self.message) + result["reason"] = to_enum(CatalogMalformedCardReason, self.reason) + if self.media_type is not None: + result["mediaType"] = from_union([lambda x: to_enum(CatalogMediaType, x), from_none], self.media_type) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class MCPSourceRef: @@ -29623,35 +31669,69 @@ def to_dict(self) -> dict: # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class FactoryPauseCheckpointResult: - action: FactoryPauseCheckpointAction + action: PauseCheckpointAction """Whether this execution attempt must pause or may continue.""" @staticmethod def from_dict(obj: Any) -> 'FactoryPauseCheckpointResult': assert isinstance(obj, dict) - action = FactoryPauseCheckpointAction(obj.get("action")) + action = PauseCheckpointAction(obj.get("action")) return FactoryPauseCheckpointResult(action) def to_dict(self) -> dict: result: dict = {} - result["action"] = to_enum(FactoryPauseCheckpointAction, self.action) + result["action"] = to_enum(PauseCheckpointAction, self.action) return result # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class SessionFactoryPauseAtCheckpointResult: - action: FactoryPauseCheckpointAction + action: PauseCheckpointAction """Whether this execution attempt must pause or may continue.""" @staticmethod def from_dict(obj: Any) -> 'SessionFactoryPauseAtCheckpointResult': assert isinstance(obj, dict) - action = FactoryPauseCheckpointAction(obj.get("action")) + action = PauseCheckpointAction(obj.get("action")) return SessionFactoryPauseAtCheckpointResult(action) def to_dict(self) -> dict: result: dict = {} - result["action"] = to_enum(FactoryPauseCheckpointAction, self.action) + result["action"] = to_enum(PauseCheckpointAction, self.action) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class SessionWorkflowPauseAtCheckpointResult: + action: PauseCheckpointAction + """Whether this execution attempt must pause or may continue.""" + + @staticmethod + def from_dict(obj: Any) -> 'SessionWorkflowPauseAtCheckpointResult': + assert isinstance(obj, dict) + action = PauseCheckpointAction(obj.get("action")) + return SessionWorkflowPauseAtCheckpointResult(action) + + def to_dict(self) -> dict: + result: dict = {} + result["action"] = to_enum(PauseCheckpointAction, self.action) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowPauseCheckpointResult: + action: PauseCheckpointAction + """Whether this execution attempt must pause or may continue.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowPauseCheckpointResult': + assert isinstance(obj, dict) + action = PauseCheckpointAction(obj.get("action")) + return WorkflowPauseCheckpointResult(action) + + def to_dict(self) -> dict: + result: dict = {} + result["action"] = to_enum(PauseCheckpointAction, self.action) return result # Experimental: this type is part of an experimental API and may change or be removed. @@ -29943,6 +32023,9 @@ class QueueSnapshotResult: steering_messages: list[str] """Immediate steering messages waiting for an active turn.""" + in_flight_model_change_id: str | None = None + """Queue item identifier of a model switch that has been dequeued but not yet applied.""" + item_orders: list[int] | None = None """Insertion orders for queued items, aligned with `items`.""" @@ -29954,14 +32037,17 @@ def from_dict(obj: Any) -> 'QueueSnapshotResult': assert isinstance(obj, dict) items = from_list(QueuePendingItems.from_dict, obj.get("items")) steering_messages = from_list(from_str, obj.get("steeringMessages")) + in_flight_model_change_id = from_union([from_str, from_none], obj.get("inFlightModelChangeId")) item_orders = from_union([lambda x: from_list(from_int, x), from_none], obj.get("itemOrders")) steering_message_orders = from_union([lambda x: from_list(from_int, x), from_none], obj.get("steeringMessageOrders")) - return QueueSnapshotResult(items, steering_messages, item_orders, steering_message_orders) + return QueueSnapshotResult(items, steering_messages, in_flight_model_change_id, item_orders, steering_message_orders) def to_dict(self) -> dict: result: dict = {} result["items"] = from_list(lambda x: to_class(QueuePendingItems, x), self.items) result["steeringMessages"] = from_list(from_str, self.steering_messages) + if self.in_flight_model_change_id is not None: + result["inFlightModelChangeId"] = from_union([from_str, from_none], self.in_flight_model_change_id) if self.item_orders is not None: result["itemOrders"] = from_union([lambda x: from_list(from_int, x), from_none], self.item_orders) if self.steering_message_orders is not None: @@ -30952,6 +33038,11 @@ class MCPSerializableServerConfig: safe_for_telemetry: bool | MCPSafeForTelemetryFields | None = None """Telemetry-obfuscation policy for this server's tools.""" + slow_connection_threshold_ms: int | None = None + """Milliseconds this server may spend connecting before the CLI warns that it is taking + longer than expected. Presentation only: it does not change how long the connection is + allowed to take. + """ source: McpServerSource | None = None """The origin of this server configuration.""" @@ -31016,6 +33107,7 @@ def from_dict(obj: Any) -> 'MCPSerializableServerConfig': notifications = from_union([lambda x: from_list(from_str, x), from_none], obj.get("notifications")) oidc = from_union([from_bool, MCPServerAuthConfigRedirectPort.from_dict, from_none], obj.get("oidc")) safe_for_telemetry = from_union([from_bool, MCPSafeForTelemetryFields.from_dict, from_none], obj.get("safeForTelemetry")) + slow_connection_threshold_ms = from_union([from_int, from_none], obj.get("slowConnectionThresholdMs")) source = from_union([McpServerSource, from_none], obj.get("source")) source_path = from_union([from_str, from_none], obj.get("sourcePath")) source_plugin = from_union([from_str, from_none], obj.get("sourcePlugin")) @@ -31030,7 +33122,7 @@ def from_dict(obj: Any) -> 'MCPSerializableServerConfig': oauth_grant_type = from_union([MCPGrantType, from_none], obj.get("oauthGrantType")) oauth_public_client = from_union([from_bool, from_none], obj.get("oauthPublicClient")) url = from_union([from_str, from_none], obj.get("url")) - return MCPSerializableServerConfig(args, auth, command, config_warnings, cwd, defer_tools, disable_secret_masking, disable_tool_cache, display_name, env, events, exclude_tools, filter_mapping, is_default_server, notifications, oidc, safe_for_telemetry, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools, type, headers, headers_refresh_ttl_ms, oauth_client_id, oauth_grant_type, oauth_public_client, url) + return MCPSerializableServerConfig(args, auth, command, config_warnings, cwd, defer_tools, disable_secret_masking, disable_tool_cache, display_name, env, events, exclude_tools, filter_mapping, is_default_server, notifications, oidc, safe_for_telemetry, slow_connection_threshold_ms, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools, type, headers, headers_refresh_ttl_ms, oauth_client_id, oauth_grant_type, oauth_public_client, url) def to_dict(self) -> dict: result: dict = {} @@ -31068,6 +33160,8 @@ def to_dict(self) -> dict: result["oidc"] = from_union([from_bool, lambda x: to_class(MCPServerAuthConfigRedirectPort, x), from_none], self.oidc) if self.safe_for_telemetry is not None: result["safeForTelemetry"] = from_union([from_bool, lambda x: to_class(MCPSafeForTelemetryFields, x), from_none], self.safe_for_telemetry) + if self.slow_connection_threshold_ms is not None: + result["slowConnectionThresholdMs"] = from_union([from_int, from_none], self.slow_connection_threshold_ms) if self.source is not None: result["source"] = from_union([lambda x: to_enum(McpServerSource, x), from_none], self.source) if self.source_path is not None: @@ -31164,6 +33258,11 @@ class MCPServerConfigHTTP: safe_for_telemetry: bool | MCPSafeForTelemetryFields | None = None """Telemetry-obfuscation policy for this server's tools.""" + slow_connection_threshold_ms: int | None = None + """Milliseconds this server may spend connecting before the CLI warns that it is taking + longer than expected. Presentation only: it does not change how long the connection is + allowed to take. + """ source: McpServerSource | None = None """The origin of this server configuration.""" @@ -31210,6 +33309,7 @@ def from_dict(obj: Any) -> 'MCPServerConfigHTTP': oauth_public_client = from_union([from_bool, from_none], obj.get("oauthPublicClient")) oidc = from_union([from_bool, MCPServerAuthConfigRedirectPort.from_dict, from_none], obj.get("oidc")) safe_for_telemetry = from_union([from_bool, MCPSafeForTelemetryFields.from_dict, from_none], obj.get("safeForTelemetry")) + slow_connection_threshold_ms = from_union([from_int, from_none], obj.get("slowConnectionThresholdMs")) source = from_union([McpServerSource, from_none], obj.get("source")) source_path = from_union([from_str, from_none], obj.get("sourcePath")) source_plugin = from_union([from_str, from_none], obj.get("sourcePlugin")) @@ -31218,7 +33318,7 @@ def from_dict(obj: Any) -> 'MCPServerConfigHTTP': timeout = from_union([from_int, from_none], obj.get("timeout")) tools = from_union([lambda x: from_list(from_str, x), from_none], obj.get("tools")) type = from_union([MCPServerConfigHTTPType, from_none], obj.get("type")) - return MCPServerConfigHTTP(url, auth, config_warnings, defer_tools, disable_secret_masking, disable_tool_cache, display_name, events, exclude_tools, filter_mapping, headers, headers_refresh_ttl_ms, is_default_server, notifications, oauth_client_id, oauth_grant_type, oauth_public_client, oidc, safe_for_telemetry, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools, type) + return MCPServerConfigHTTP(url, auth, config_warnings, defer_tools, disable_secret_masking, disable_tool_cache, display_name, events, exclude_tools, filter_mapping, headers, headers_refresh_ttl_ms, is_default_server, notifications, oauth_client_id, oauth_grant_type, oauth_public_client, oidc, safe_for_telemetry, slow_connection_threshold_ms, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools, type) def to_dict(self) -> dict: result: dict = {} @@ -31259,6 +33359,8 @@ def to_dict(self) -> dict: result["oidc"] = from_union([from_bool, lambda x: to_class(MCPServerAuthConfigRedirectPort, x), from_none], self.oidc) if self.safe_for_telemetry is not None: result["safeForTelemetry"] = from_union([from_bool, lambda x: to_class(MCPSafeForTelemetryFields, x), from_none], self.safe_for_telemetry) + if self.slow_connection_threshold_ms is not None: + result["slowConnectionThresholdMs"] = from_union([from_int, from_none], self.slow_connection_threshold_ms) if self.source is not None: result["source"] = from_union([lambda x: to_enum(McpServerSource, x), from_none], self.source) if self.source_path is not None: @@ -31337,6 +33439,11 @@ class MCPServerConfigStdio: safe_for_telemetry: bool | MCPSafeForTelemetryFields | None = None """Telemetry-obfuscation policy for this server's tools.""" + slow_connection_threshold_ms: int | None = None + """Milliseconds this server may spend connecting before the CLI warns that it is taking + longer than expected. Presentation only: it does not change how long the connection is + allowed to take. + """ source: McpServerSource | None = None """The origin of this server configuration.""" @@ -31381,6 +33488,7 @@ def from_dict(obj: Any) -> 'MCPServerConfigStdio': notifications = from_union([lambda x: from_list(from_str, x), from_none], obj.get("notifications")) oidc = from_union([from_bool, MCPServerAuthConfigRedirectPort.from_dict, from_none], obj.get("oidc")) safe_for_telemetry = from_union([from_bool, MCPSafeForTelemetryFields.from_dict, from_none], obj.get("safeForTelemetry")) + slow_connection_threshold_ms = from_union([from_int, from_none], obj.get("slowConnectionThresholdMs")) source = from_union([McpServerSource, from_none], obj.get("source")) source_path = from_union([from_str, from_none], obj.get("sourcePath")) source_plugin = from_union([from_str, from_none], obj.get("sourcePlugin")) @@ -31389,7 +33497,7 @@ def from_dict(obj: Any) -> 'MCPServerConfigStdio': timeout = from_union([from_int, from_none], obj.get("timeout")) tools = from_union([lambda x: from_list(from_str, x), from_none], obj.get("tools")) type = from_union([MCPServerConfigStdioType, from_none], obj.get("type")) - return MCPServerConfigStdio(command, args, auth, config_warnings, cwd, defer_tools, disable_secret_masking, disable_tool_cache, display_name, env, events, exclude_tools, filter_mapping, is_default_server, notifications, oidc, safe_for_telemetry, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools, type) + return MCPServerConfigStdio(command, args, auth, config_warnings, cwd, defer_tools, disable_secret_masking, disable_tool_cache, display_name, env, events, exclude_tools, filter_mapping, is_default_server, notifications, oidc, safe_for_telemetry, slow_connection_threshold_ms, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools, type) def to_dict(self) -> dict: result: dict = {} @@ -31426,6 +33534,8 @@ def to_dict(self) -> dict: result["oidc"] = from_union([from_bool, lambda x: to_class(MCPServerAuthConfigRedirectPort, x), from_none], self.oidc) if self.safe_for_telemetry is not None: result["safeForTelemetry"] = from_union([from_bool, lambda x: to_class(MCPSafeForTelemetryFields, x), from_none], self.safe_for_telemetry) + if self.slow_connection_threshold_ms is not None: + result["slowConnectionThresholdMs"] = from_union([from_int, from_none], self.slow_connection_threshold_ms) if self.source is not None: result["source"] = from_union([lambda x: to_enum(McpServerSource, x), from_none], self.source) if self.source_path is not None: @@ -31865,6 +33975,185 @@ def to_dict(self) -> dict: result["agentName"] = from_union([from_str, from_none], self.agent_name) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunTerminal: + """Prompt-safe terminal workflow outcome.""" + + error: str | None = None + """Human-readable terminal error.""" + + failure: WorkflowRunFailure | None = None + """Machine-readable terminal failure.""" + + pause_info: WorkflowRunTerminalPauseInfo | None = None + """Pause initiator metadata, or null when the run did not pause.""" + + reason: str | None = None + """Human-readable terminal reason.""" + + result_preview: str | None = None + """Prompt-safe preview of the completed result.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunTerminal': + assert isinstance(obj, dict) + error = from_union([from_str, from_none], obj.get("error")) + failure = from_union([WorkflowRunFailure.from_dict, from_none], obj.get("failure")) + pause_info = from_union([WorkflowRunTerminalPauseInfo.from_dict, from_none], obj.get("pauseInfo")) + reason = from_union([from_str, from_none], obj.get("reason")) + result_preview = from_union([from_str, from_none], obj.get("resultPreview")) + return WorkflowRunTerminal(error, failure, pause_info, reason, result_preview) + + def to_dict(self) -> dict: + result: dict = {} + if self.error is not None: + result["error"] = from_union([from_str, from_none], self.error) + if self.failure is not None: + result["failure"] = from_union([lambda x: to_class(WorkflowRunFailure, x), from_none], self.failure) + result["pauseInfo"] = from_union([lambda x: to_class(WorkflowRunTerminalPauseInfo, x), from_none], self.pause_info) + if self.reason is not None: + result["reason"] = from_union([from_str, from_none], self.reason) + if self.result_preview is not None: + result["resultPreview"] = from_union([from_str, from_none], self.result_preview) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunResult: + """Terminal resumed run envelope. + + Complete current or terminal workflow run envelope. + """ + run_id: str + """Workflow run identifier.""" + + status: RunStatus + """Current or terminal workflow run status.""" + + attempt: int | None = None + """One-based execution attempt represented by this envelope. Absent before the first attempt + starts or when returned by an older runtime. + """ + error: str | None = None + """Error message for an errored run.""" + + failure: WorkflowRunFailure | None = None + """Machine-readable failure details for a halted or errored run.""" + + pause_info: WorkflowPauseInfo | None = None + """Structured pause initiator metadata for a paused attempt.""" + + reason: str | None = None + """Reason for a halted or cancelled run.""" + + result: Any = None + """Completed workflow result.""" + + snapshot: Any = None + """Partial journal and progress snapshot for a halted, cancelled, or errored run.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunResult': + assert isinstance(obj, dict) + run_id = from_str(obj.get("runId")) + status = RunStatus(obj.get("status")) + attempt = from_union([from_int, from_none], obj.get("attempt")) + error = from_union([from_str, from_none], obj.get("error")) + failure = from_union([WorkflowRunFailure.from_dict, from_none], obj.get("failure")) + pause_info = from_union([WorkflowPauseInfo.from_dict, from_none], obj.get("pauseInfo")) + reason = from_union([from_str, from_none], obj.get("reason")) + result = obj.get("result") + snapshot = obj.get("snapshot") + return WorkflowRunResult(run_id, status, attempt, error, failure, pause_info, reason, result, snapshot) + + def to_dict(self) -> dict: + result: dict = {} + result["runId"] = from_str(self.run_id) + result["status"] = to_enum(RunStatus, self.status) + if self.attempt is not None: + result["attempt"] = from_union([from_int, from_none], self.attempt) + if self.error is not None: + result["error"] = from_union([from_str, from_none], self.error) + if self.failure is not None: + result["failure"] = from_union([lambda x: to_class(WorkflowRunFailure, x), from_none], self.failure) + if self.pause_info is not None: + result["pauseInfo"] = from_union([lambda x: to_class(WorkflowPauseInfo, x), from_none], self.pause_info) + if self.reason is not None: + result["reason"] = from_union([from_str, from_none], self.reason) + if self.result is not None: + result["result"] = self.result + if self.snapshot is not None: + result["snapshot"] = self.snapshot + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunRequest: + """Parameters for invoking a registered workflow.""" + + args: Any + """Workflow input value.""" + + name: str + """Registered workflow name.""" + + options: WorkflowRunOptions | None = None + """Workflow invocation options.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunRequest': + assert isinstance(obj, dict) + args = obj.get("args") + name = from_str(obj.get("name")) + options = from_union([WorkflowRunOptions.from_dict, from_none], obj.get("options")) + return WorkflowRunRequest(args, name, options) + + def to_dict(self) -> dict: + result: dict = {} + result["args"] = self.args + result["name"] = from_str(self.name) + if self.options is not None: + result["options"] = from_union([lambda x: to_class(WorkflowRunOptions, x), from_none], self.options) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +# Internal: this type is an internal SDK API and is not part of the public surface. +@dataclass +class _WorkflowToolRunRequest: + """Internal parameters for invoking a registered workflow from a tool.""" + + args: Any + """Workflow input value.""" + + name: str + """Registered workflow name.""" + + options: _WorkflowToolRunOptions | None = None + """Tool-originated workflow invocation options.""" + + tool_call_id: str | None = None + """Opaque identifier of the originating tool call.""" + + @staticmethod + def from_dict(obj: Any) -> '_WorkflowToolRunRequest': + assert isinstance(obj, dict) + args = obj.get("args") + name = from_str(obj.get("name")) + options = from_union([_WorkflowToolRunOptions.from_dict, from_none], obj.get("options")) + tool_call_id = from_union([from_str, from_none], obj.get("toolCallId")) + return _WorkflowToolRunRequest(args, name, options, tool_call_id) + + def to_dict(self) -> dict: + result: dict = {} + result["args"] = self.args + result["name"] = from_str(self.name) + if self.options is not None: + result["options"] = from_union([lambda x: to_class(_WorkflowToolRunOptions, x), from_none], self.options) + if self.tool_call_id is not None: + result["toolCallId"] = from_union([from_str, from_none], self.tool_call_id) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class WorkspaceDiffResult: @@ -31928,8 +34217,9 @@ class MCPInstallPlan: The normalised plan. """ configuration_changes: list[MCPPlanConfigurationChange] - """The configuration changes installing would make, described rather than serialised, so the - mutable configuration payload stays behind the runtime boundary. + """Alternative configuration changes, with exactly one entry for each transportChoices entry + in the same order. Only the entry for the subsequently selected transport applies; these + are not cumulative writes. Payloads remain behind the runtime boundary. """ identity: MCPPlanResourceIdentity """Normalised identity of the server the plan would install.""" @@ -31955,8 +34245,10 @@ class MCPInstallPlan: never reloads. """ requires_interactive_configuration: bool - """Whether the plan cannot be applied without further input, because a required value has no - default or a secret must be supplied. + """True only when every eligible transport choice needs additional values or secrets. False + means at least one choice needs no additional configuration, not that every choice is + ready. A later apply operation must validate the selected choice's own inputs, secrets + and policy after explicit confirmation. """ target: MCPPlanTarget """Configuration scope and key the plan would write to.""" @@ -32177,50 +34469,6 @@ def to_dict(self) -> dict: result["session"] = from_union([lambda x: to_class(CanvasSessionContext, x), from_none], self.session) return result -# Experimental: this type is part of an experimental API and may change or be removed. -@dataclass -class CatalogSearchSucceeded: - """A completed catalog search: inert candidate summaries, each carrying a single-use handle.""" - - candidates: list[CatalogCandidate] - """Matching candidates, never more than the requested limit. All text is inert untrusted - data. - """ - kind: ClassVar[str] = "succeeded" - """Discriminator: the search completed""" - - negotiated: CatalogNegotiatedContract - """Protocol version and capabilities the runtime honoured.""" - - search_id: str - """Pseudonymous identifier for this search, issued by the runtime or by the catalog - authority it queried and never by the caller, so it cannot be forged or replayed to - attribute an install to a search that never happened. Always present on a success, so a - result set can be tied to the installs it leads to. It identifies a search rather than a - person: it is derived from no user, account, device, or query data, and must never be - joined with user identity to re-identify anyone. - """ - truncated: bool - """Whether further matches existed beyond the requested limit.""" - - @staticmethod - def from_dict(obj: Any) -> 'CatalogSearchSucceeded': - assert isinstance(obj, dict) - candidates = from_list(CatalogCandidate.from_dict, obj.get("candidates")) - negotiated = CatalogNegotiatedContract.from_dict(obj.get("negotiated")) - search_id = from_str(obj.get("searchId")) - truncated = from_bool(obj.get("truncated")) - return CatalogSearchSucceeded(candidates, negotiated, search_id, truncated) - - def to_dict(self) -> dict: - result: dict = {} - result["candidates"] = from_list(lambda x: to_class(CatalogCandidate, x), self.candidates) - result["kind"] = self.kind - result["negotiated"] = to_class(CatalogNegotiatedContract, self.negotiated) - result["searchId"] = from_str(self.search_id) - result["truncated"] = from_bool(self.truncated) - return result - # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class HandlePendingToolCallRequest: @@ -32316,7 +34564,7 @@ class FactoryRunSummary: run_id: str """Factory run identifier.""" - status: FactoryRunStatus + status: RunStatus """Current factory run status.""" total_spawned_agent_count: int @@ -32357,7 +34605,7 @@ def from_dict(obj: Any) -> 'FactoryRunSummary': observed_at = from_int(obj.get("observedAt")) revision = from_int(obj.get("revision")) run_id = from_str(obj.get("runId")) - status = FactoryRunStatus(obj.get("status")) + status = RunStatus(obj.get("status")) total_spawned_agent_count = from_int(obj.get("totalSpawnedAgentCount")) updated_at = from_int(obj.get("updatedAt")) active_segment_started_at = from_union([from_int, from_none], obj.get("activeSegmentStartedAt")) @@ -32381,7 +34629,7 @@ def to_dict(self) -> dict: result["observedAt"] = from_int(self.observed_at) result["revision"] = from_int(self.revision) result["runId"] = from_str(self.run_id) - result["status"] = to_enum(FactoryRunStatus, self.status) + result["status"] = to_enum(RunStatus, self.status) result["totalSpawnedAgentCount"] = from_int(self.total_spawned_agent_count) result["updatedAt"] = from_int(self.updated_at) result["activeSegmentStartedAt"] = from_union([from_int, from_none], self.active_segment_started_at) @@ -32594,6 +34842,10 @@ class SessionMetadataSnapshot: client_name: str | None = None """Runtime client name associated with the session (telemetry identifier).""" + indexed_search: IndexedSearchState | None = None + """Live indexed-search state for this session activation. Omitted by runtimes that do not + expose indexed-search status; absence does not indicate enablement. + """ initial_name: str | None = None """User-provided name supplied at session construction (via `--name`), if any. Immutable after construction. @@ -32633,6 +34885,7 @@ def from_dict(obj: Any) -> 'SessionMetadataSnapshot': start_time = from_datetime(obj.get("startTime")) working_directory = from_str(obj.get("workingDirectory")) client_name = from_union([from_str, from_none], obj.get("clientName")) + indexed_search = from_union([IndexedSearchState, from_none], obj.get("indexedSearch")) initial_name = from_union([from_str, from_none], obj.get("initialName")) remote_metadata = from_union([MetadataSnapshotRemoteMetadata.from_dict, from_none], obj.get("remoteMetadata")) selected_model = from_union([from_str, from_none], obj.get("selectedModel")) @@ -32640,7 +34893,7 @@ def from_dict(obj: Any) -> 'SessionMetadataSnapshot': summary = from_union([from_str, from_none], obj.get("summary")) workspace = from_union([WorkspaceSummary.from_dict, from_none], obj.get("workspace")) workspace_path = from_union([from_none, from_str], obj.get("workspacePath")) - return SessionMetadataSnapshot(already_in_use, current_mode, is_remote, modified_time, session_id, start_time, working_directory, client_name, initial_name, remote_metadata, selected_model, session_limits, summary, workspace, workspace_path) + return SessionMetadataSnapshot(already_in_use, current_mode, is_remote, modified_time, session_id, start_time, working_directory, client_name, indexed_search, initial_name, remote_metadata, selected_model, session_limits, summary, workspace, workspace_path) def to_dict(self) -> dict: result: dict = {} @@ -32653,6 +34906,8 @@ def to_dict(self) -> dict: result["workingDirectory"] = from_str(self.working_directory) if self.client_name is not None: result["clientName"] = from_union([from_str, from_none], self.client_name) + if self.indexed_search is not None: + result["indexedSearch"] = from_union([lambda x: to_enum(IndexedSearchState, x), from_none], self.indexed_search) if self.initial_name is not None: result["initialName"] = from_union([from_str, from_none], self.initial_name) if self.remote_metadata is not None: @@ -32948,6 +35203,228 @@ def to_dict(self) -> dict: result["urls"] = from_union([lambda x: to_class(PermissionUrlsConfig, x), from_none], self.urls) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogAgentPluginCandidate: + """An inert Agent Plugin catalog result. Its canonical catalog identity, declared version, + repository source claim, and explicit compatibility tags are safe to correlate, while its + descriptor, URL, raw data, and installed-plugin state remain runtime-private. This + contract-only variant does not mint or expose a candidate handle. + """ + compatibility_tags: list[CatalogAgentPluginCompatibilityTag] + """Explicit validated compatibility tags, in canonical order. An empty list means the source + declared no recognised compatibility; clients must not infer compatibility from other + fields. `canvas-only` requires both `canvas` and `github-copilot`. + """ + display_name: str + """Display name taken verbatim from the card. Inert untrusted text.""" + + identity: str + """Validated, normalised catalogue resource URN. This identity comes only from the catalog + identifier and is never inferred from display text or installed-plugin state. + """ + kind: CatalogAgentPluginCandidateKind + """Discriminator: this candidate describes an Agent Plugin.""" + + media_type: CatalogAgentPluginMediaType + """Canonical Agent Plugin media type.""" + + provenance: CatalogAgentPluginCandidateProvenance + """Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw + data, or content digest. + """ + source: CatalogPluginRepositorySource + """Bounded repository provenance declared through the catalog's sourceSet and repoPath + metadata. It contains no descriptor URL. + """ + description: str | None = None + """Description taken verbatim from the card. Inert untrusted text.""" + + publisher: str | None = None + """Publisher taken verbatim from the card. Inert untrusted text.""" + + trust: CatalogTrustSnapshot | None = None + """Versioned trust metadata observed from the catalog authority. Optional for protocol-3 + compatibility and emitted only when the caller also requires the trust-snapshot + capability. + """ + version: str | None = None + """Optional version declared by the catalog source. Omitted rather than guessed when the + source supplies no version. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogAgentPluginCandidate': + assert isinstance(obj, dict) + compatibility_tags = from_list(CatalogAgentPluginCompatibilityTag, obj.get("compatibilityTags")) + display_name = from_str(obj.get("displayName")) + identity = from_str(obj.get("identity")) + kind = CatalogAgentPluginCandidateKind(obj.get("kind")) + media_type = CatalogAgentPluginMediaType(obj.get("mediaType")) + provenance = CatalogAgentPluginCandidateProvenance.from_dict(obj.get("provenance")) + source = CatalogPluginRepositorySource.from_dict(obj.get("source")) + description = from_union([from_str, from_none], obj.get("description")) + publisher = from_union([from_str, from_none], obj.get("publisher")) + trust = from_union([_load_CatalogTrustSnapshot, from_none], obj.get("trust")) + version = from_union([from_str, from_none], obj.get("version")) + return CatalogAgentPluginCandidate(compatibility_tags, display_name, identity, kind, media_type, provenance, source, description, publisher, trust, version) + + def to_dict(self) -> dict: + result: dict = {} + result["compatibilityTags"] = from_list(lambda x: to_enum(CatalogAgentPluginCompatibilityTag, x), self.compatibility_tags) + result["displayName"] = from_str(self.display_name) + result["identity"] = from_str(self.identity) + result["kind"] = to_enum(CatalogAgentPluginCandidateKind, self.kind) + result["mediaType"] = to_enum(CatalogAgentPluginMediaType, self.media_type) + result["provenance"] = to_class(CatalogAgentPluginCandidateProvenance, self.provenance) + result["source"] = to_class(CatalogPluginRepositorySource, self.source) + if self.description is not None: + result["description"] = from_union([from_str, from_none], self.description) + if self.publisher is not None: + result["publisher"] = from_union([from_str, from_none], self.publisher) + if self.trust is not None: + result["trust"] = from_union([lambda x: (x).to_dict(), from_none], self.trust) + if self.version is not None: + result["version"] = from_union([from_str, from_none], self.version) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogCandidate: + """One inert catalog result, represented as an MCP server, discovery-only AI skill, or + opt-in Agent Plugin variant so kind, media type, provenance, and available operations + cannot contradict each other. + + An inert MCP server catalog result. Every free-text field is untrusted external data and + must never be treated as an instruction, and the handle is the only way to refer to the + candidate in a later operation. + + An inert AI skill catalog result. AI skills are discovery-only and cannot be represented + as installable through this surface. + + An inert Agent Plugin catalog result. Its canonical catalog identity, declared version, + repository source claim, and explicit compatibility tags are safe to correlate, while its + descriptor, URL, raw data, and installed-plugin state remain runtime-private. This + contract-only variant does not mint or expose a candidate handle. + """ + display_name: str + """Display name taken verbatim from the card. Inert untrusted text.""" + + kind: CatalogCandidateKind + """Discriminator: this candidate describes an MCP server + + Discriminator: this candidate describes an AI skill + + Discriminator: this candidate describes an Agent Plugin. + """ + media_type: CatalogMediaType + """JSON MCP media type of the underlying card. + + Media type of the underlying AI skill card + + Canonical Agent Plugin media type. + """ + provenance: CatalogCandidateProvenance + """Where the catalog reference was observed, without the card itself or any content digest. + + Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw + data, or content digest. + """ + source: SourceClass + """Where the card came from: exactly one of a URL or embedded data, encoded as a tagged + union so neither both nor neither can be represented. + + Bounded repository provenance declared through the catalog's sourceSet and repoPath + metadata. It contains no descriptor URL. + """ + description: str | None = None + """Description taken verbatim from the card. Inert untrusted text.""" + + handle: str | None = None + """Opaque, runtime-instance scoped, TTL-bound, single-use handle for this candidate. Carries + no readable information and is rejected when stale, replayed, or presented to a different + runtime instance. Never logged. + """ + handle_expires_at: str | None = None + """ISO 8601 timestamp after which the handle is stale and will be rejected.""" + + installability: CatalogCandidateInstallability | None = None + """Whether this MCP server can be planned for installation, and if policy prevents it. + + AI skills are discovery-only and cannot be installed through this surface + """ + publisher: str | None = None + """Publisher taken verbatim from the card. Inert untrusted text.""" + + trust: CatalogTrustSnapshot | None = None + """Versioned trust metadata observed from the catalog authority. Optional for protocol-3 + compatibility with runtimes that predate trust snapshots. A trust-capable runtime emits + an explicit snapshot even when the authority omitted or malformed its trust field. + + Versioned trust metadata observed from the catalog authority. Optional for protocol-3 + compatibility and emitted only when the caller also requires the trust-snapshot + capability. + """ + compatibility_tags: list[CatalogAgentPluginCompatibilityTag] | None = None + """Explicit validated compatibility tags, in canonical order. An empty list means the source + declared no recognised compatibility; clients must not infer compatibility from other + fields. `canvas-only` requires both `canvas` and `github-copilot`. + """ + identity: str | None = None + """Validated, normalised catalogue resource URN. This identity comes only from the catalog + identifier and is never inferred from display text or installed-plugin state. + """ + version: str | None = None + """Optional version declared by the catalog source. Omitted rather than guessed when the + source supplies no version. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogCandidate': + assert isinstance(obj, dict) + display_name = from_str(obj.get("displayName")) + kind = CatalogCandidateKind(obj.get("kind")) + media_type = CatalogMediaType(obj.get("mediaType")) + provenance = CatalogCandidateProvenance.from_dict(obj.get("provenance")) + source = SourceClass.from_dict(obj.get("source")) + description = from_union([from_str, from_none], obj.get("description")) + handle = from_union([from_str, from_none], obj.get("handle")) + handle_expires_at = from_union([from_str, from_none], obj.get("handleExpiresAt")) + installability = from_union([CatalogCandidateInstallability, from_none], obj.get("installability")) + publisher = from_union([from_str, from_none], obj.get("publisher")) + trust = from_union([_load_CatalogTrustSnapshot, from_none], obj.get("trust")) + compatibility_tags = from_union([lambda x: from_list(CatalogAgentPluginCompatibilityTag, x), from_none], obj.get("compatibilityTags")) + identity = from_union([from_str, from_none], obj.get("identity")) + version = from_union([from_str, from_none], obj.get("version")) + return CatalogCandidate(display_name, kind, media_type, provenance, source, description, handle, handle_expires_at, installability, publisher, trust, compatibility_tags, identity, version) + + def to_dict(self) -> dict: + result: dict = {} + result["displayName"] = from_str(self.display_name) + result["kind"] = to_enum(CatalogCandidateKind, self.kind) + result["mediaType"] = to_enum(CatalogMediaType, self.media_type) + result["provenance"] = to_class(CatalogCandidateProvenance, self.provenance) + result["source"] = to_class(SourceClass, self.source) + if self.description is not None: + result["description"] = from_union([from_str, from_none], self.description) + if self.handle is not None: + result["handle"] = from_union([from_str, from_none], self.handle) + if self.handle_expires_at is not None: + result["handleExpiresAt"] = from_union([from_str, from_none], self.handle_expires_at) + if self.installability is not None: + result["installability"] = from_union([lambda x: to_enum(CatalogCandidateInstallability, x), from_none], self.installability) + if self.publisher is not None: + result["publisher"] = from_union([from_str, from_none], self.publisher) + if self.trust is not None: + result["trust"] = from_union([lambda x: (x).to_dict(), from_none], self.trust) + if self.compatibility_tags is not None: + result["compatibilityTags"] = from_union([lambda x: from_list(lambda x: to_enum(CatalogAgentPluginCompatibilityTag, x), x), from_none], self.compatibility_tags) + if self.identity is not None: + result["identity"] = from_union([from_str, from_none], self.identity) + if self.version is not None: + result["version"] = from_union([from_str, from_none], self.version) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class DiscoveredMCPServer: @@ -33559,6 +36036,144 @@ def to_dict(self) -> dict: result["totalNanoAiu"] = from_union([to_float, from_none], self.total_nano_aiu) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunSummary: + """Durable workflow run summary with read-time live overlays.""" + + can_resume: bool + """Whether the durable run state currently passes runtime resume eligibility checks.""" + + consumed: WorkflowRunConsumed + """Durable resource consumption.""" + + created_at: int + """Epoch milliseconds when the run was created.""" + + declared_limits: WorkflowDeclaredLimits + """Resource ceilings declared by the workflow.""" + + declared_phase_count: int + """Number of phases declared by the workflow.""" + + description: str + """Human-readable workflow description.""" + + live_agent_count: int + """Number of direct workflow agents currently live.""" + + observed_at: int + """Epoch milliseconds when this live-overlay snapshot was observed.""" + + revision: int + """Monotonic durable run revision.""" + + run_id: str + """Workflow run identifier.""" + + status: RunStatus + """Current workflow run status.""" + + total_spawned_agent_count: int + """Total direct workflow agents spawned across all attempts.""" + + updated_at: int + """Epoch milliseconds when the durable run was last updated.""" + + workflow_name: str + """Registered workflow name.""" + + active_segment_started_at: int | None = None + """Epoch milliseconds when the current active segment started, or null while inactive.""" + + approved: WorkflowDeclaredLimits | None = None + """Approved effective resource ceilings, or null until approved.""" + + completed_at: int | None = None + """Epoch milliseconds when the run completed, or null while nonterminal.""" + + current_phase: WorkflowCurrentPhase | None = None + """Current phase identity, or null before any phase is entered.""" + + started_at: int | None = None + """Epoch milliseconds when execution first started, or null before start.""" + + terminal: WorkflowRunTerminal | None = None + """Terminal run outcome, or null while nonterminal.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunSummary': + assert isinstance(obj, dict) + can_resume = from_bool(obj.get("canResume")) + consumed = WorkflowRunConsumed.from_dict(obj.get("consumed")) + created_at = from_int(obj.get("createdAt")) + declared_limits = WorkflowDeclaredLimits.from_dict(obj.get("declaredLimits")) + declared_phase_count = from_int(obj.get("declaredPhaseCount")) + description = from_str(obj.get("description")) + live_agent_count = from_int(obj.get("liveAgentCount")) + observed_at = from_int(obj.get("observedAt")) + revision = from_int(obj.get("revision")) + run_id = from_str(obj.get("runId")) + status = RunStatus(obj.get("status")) + total_spawned_agent_count = from_int(obj.get("totalSpawnedAgentCount")) + updated_at = from_int(obj.get("updatedAt")) + workflow_name = from_str(obj.get("workflowName")) + active_segment_started_at = from_union([from_int, from_none], obj.get("activeSegmentStartedAt")) + approved = from_union([WorkflowDeclaredLimits.from_dict, from_none], obj.get("approved")) + completed_at = from_union([from_int, from_none], obj.get("completedAt")) + current_phase = from_union([WorkflowCurrentPhase.from_dict, from_none], obj.get("currentPhase")) + started_at = from_union([from_int, from_none], obj.get("startedAt")) + terminal = from_union([WorkflowRunTerminal.from_dict, from_none], obj.get("terminal")) + return WorkflowRunSummary(can_resume, consumed, created_at, declared_limits, declared_phase_count, description, live_agent_count, observed_at, revision, run_id, status, total_spawned_agent_count, updated_at, workflow_name, active_segment_started_at, approved, completed_at, current_phase, started_at, terminal) + + def to_dict(self) -> dict: + result: dict = {} + result["canResume"] = from_bool(self.can_resume) + result["consumed"] = to_class(WorkflowRunConsumed, self.consumed) + result["createdAt"] = from_int(self.created_at) + result["declaredLimits"] = to_class(WorkflowDeclaredLimits, self.declared_limits) + result["declaredPhaseCount"] = from_int(self.declared_phase_count) + result["description"] = from_str(self.description) + result["liveAgentCount"] = from_int(self.live_agent_count) + result["observedAt"] = from_int(self.observed_at) + result["revision"] = from_int(self.revision) + result["runId"] = from_str(self.run_id) + result["status"] = to_enum(RunStatus, self.status) + result["totalSpawnedAgentCount"] = from_int(self.total_spawned_agent_count) + result["updatedAt"] = from_int(self.updated_at) + result["workflowName"] = from_str(self.workflow_name) + result["activeSegmentStartedAt"] = from_union([from_int, from_none], self.active_segment_started_at) + result["approved"] = from_union([lambda x: to_class(WorkflowDeclaredLimits, x), from_none], self.approved) + result["completedAt"] = from_union([from_int, from_none], self.completed_at) + result["currentPhase"] = from_union([lambda x: to_class(WorkflowCurrentPhase, x), from_none], self.current_phase) + result["startedAt"] = from_union([from_int, from_none], self.started_at) + result["terminal"] = from_union([lambda x: to_class(WorkflowRunTerminal, x), from_none], self.terminal) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowResumeResult: + """Resolved persisted workflow identity and resumed run envelope.""" + + run: WorkflowRunResult + """Terminal resumed run envelope.""" + + workflow_name: str + """Persisted workflow name resolved for the resumed run.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowResumeResult': + assert isinstance(obj, dict) + run = WorkflowRunResult.from_dict(obj.get("run")) + workflow_name = from_str(obj.get("workflowName")) + return WorkflowResumeResult(run, workflow_name) + + def to_dict(self) -> dict: + result: dict = {} + result["run"] = to_class(WorkflowRunResult, self.run) + result["workflowName"] = from_str(self.workflow_name) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class MCPPlanInstallPlanned: @@ -33631,6 +36246,62 @@ def to_dict(self) -> dict: result["omittedOlder"] = from_union([from_int, from_none], self.omitted_older) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class CatalogSearchSucceeded: + """A completed catalog search containing inert candidate summaries. MCP server and AI skill + variants carry a single-use handle; the Agent Plugin variant is handleless. + """ + candidates: list[CatalogCandidate] + """Matching candidates, never more than the requested limit. All text is inert untrusted + data. + """ + kind: ClassVar[str] = "succeeded" + """Discriminator: the search completed""" + + negotiated: CatalogNegotiatedContract + """Protocol version and capabilities the runtime honoured.""" + + search_id: str + """Pseudonymous identifier for this search, issued by the runtime or by the catalog + authority it queried and never by the caller, so it cannot be forged or replayed to + attribute an install to a search that never happened. Always present on a success, so a + result set can be tied to the installs it leads to. It identifies a search rather than a + person: it is derived from no user, account, device, or query data, and must never be + joined with user identity to re-identify anyone. + """ + truncated: bool + """Legacy indication that the authority returned a page token. Preserved for compatibility; + this is not a has-next-page indicator. Use pagination.hasNextPage when pagination + metadata is present. + """ + pagination: CatalogSearchPagination | None = None + """Navigation metadata for callers explicitly requiring catalog-search-pagination. Omitted + when the authority returns no token, including tokenless first-page and continuation + responses. Counts are never substituted from candidates.length. + """ + + @staticmethod + def from_dict(obj: Any) -> 'CatalogSearchSucceeded': + assert isinstance(obj, dict) + candidates = from_list(CatalogCandidate.from_dict, obj.get("candidates")) + negotiated = CatalogNegotiatedContract.from_dict(obj.get("negotiated")) + search_id = from_str(obj.get("searchId")) + truncated = from_bool(obj.get("truncated")) + pagination = from_union([CatalogSearchPagination.from_dict, from_none], obj.get("pagination")) + return CatalogSearchSucceeded(candidates, negotiated, search_id, truncated, pagination) + + def to_dict(self) -> dict: + result: dict = {} + result["candidates"] = from_list(lambda x: to_class(CatalogCandidate, x), self.candidates) + result["kind"] = self.kind + result["negotiated"] = to_class(CatalogNegotiatedContract, self.negotiated) + result["searchId"] = from_str(self.search_id) + result["truncated"] = from_bool(self.truncated) + if self.pagination is not None: + result["pagination"] = from_union([lambda x: to_class(CatalogSearchPagination, x), from_none], self.pagination) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class MCPDiscoverResult: @@ -34650,6 +37321,49 @@ def to_dict(self) -> dict: result["task"] = from_union([lambda x: to_class(MCPTaskMetadata, x), from_none], self.task) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowListRunsResult: + """A page of workflow runs in durable creation order.""" + + runs: list[WorkflowRunSummary] + """Workflow run summaries in durable creation order.""" + + has_more_newer: bool | None = None + """Whether terminal runs newer than this page exist.""" + + newest_seq: int | None = None + """Newest terminal-run cursor in this page, or null when the terminal window is empty.""" + + oldest_seq: int | None = None + """Oldest terminal-run cursor in this page, or null when the terminal window is empty.""" + + omitted_older: int | None = None + """Number of terminal runs older than this page.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowListRunsResult': + assert isinstance(obj, dict) + runs = from_list(WorkflowRunSummary.from_dict, obj.get("runs")) + has_more_newer = from_union([from_bool, from_none], obj.get("hasMoreNewer")) + newest_seq = from_union([from_int, from_none], obj.get("newestSeq")) + oldest_seq = from_union([from_int, from_none], obj.get("oldestSeq")) + omitted_older = from_union([from_int, from_none], obj.get("omittedOlder")) + return WorkflowListRunsResult(runs, has_more_newer, newest_seq, oldest_seq, omitted_older) + + def to_dict(self) -> dict: + result: dict = {} + result["runs"] = from_list(lambda x: to_class(WorkflowRunSummary, x), self.runs) + if self.has_more_newer is not None: + result["hasMoreNewer"] = from_union([from_bool, from_none], self.has_more_newer) + if self.newest_seq is not None: + result["newestSeq"] = from_union([from_int, from_none], self.newest_seq) + if self.oldest_seq is not None: + result["oldestSeq"] = from_union([from_int, from_none], self.oldest_seq) + if self.omitted_older is not None: + result["omittedOlder"] = from_union([from_int, from_none], self.omitted_older) + return result + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class SessionsOpenCreate: @@ -34840,6 +37554,9 @@ class CopilotUserResponse: endpoints: CopilotUserResponseEndpoints | None = None """Endpoint URLs from the raw Copilot `/copilot_internal/v2/token` user-response passthrough.""" + enterprise_list: list[EnterpriseList] | None = None + """Enterprises that provide the user's Copilot license, each with a stable numeric ID.""" + is_mcp_enabled: Any = None """Whether MCP (Model Context Protocol) support is enabled for the user.""" @@ -34902,6 +37619,7 @@ def from_dict(obj: Any) -> 'CopilotUserResponse': copilot_plan = from_union([from_str, from_none], obj.get("copilot_plan")) copilotignore_enabled = from_union([from_bool, from_none], obj.get("copilotignore_enabled")) endpoints = from_union([CopilotUserResponseEndpoints.from_dict, from_none], obj.get("endpoints")) + enterprise_list = from_union([lambda x: from_list(EnterpriseList.from_dict, x), from_none], obj.get("enterprise_list")) is_mcp_enabled = obj.get("is_mcp_enabled") is_staff = from_union([from_bool, from_none], obj.get("is_staff")) limited_user_quotas = from_union([lambda x: from_dict(from_float, x), from_none], obj.get("limited_user_quotas")) @@ -34916,7 +37634,7 @@ def from_dict(obj: Any) -> 'CopilotUserResponse': restricted_telemetry = from_union([from_bool, from_none], obj.get("restricted_telemetry")) te = from_union([from_bool, from_none], obj.get("te")) token_based_billing = from_union([from_bool, from_none], obj.get("token_based_billing")) - return CopilotUserResponse(access_type_sku, analytics_tracking_id, assigned_date, can_signup_for_limited, can_upgrade_plan, chat_enabled, cli_remote_control_enabled, cloud_session_storage_enabled, codex_agent_enabled, copilot_plan, copilotignore_enabled, endpoints, is_mcp_enabled, is_staff, limited_user_quotas, limited_user_reset_date, login, monthly_quotas, organization_list, organization_login_list, quota_reset_date, quota_reset_date_utc, quota_snapshots, restricted_telemetry, te, token_based_billing) + return CopilotUserResponse(access_type_sku, analytics_tracking_id, assigned_date, can_signup_for_limited, can_upgrade_plan, chat_enabled, cli_remote_control_enabled, cloud_session_storage_enabled, codex_agent_enabled, copilot_plan, copilotignore_enabled, endpoints, enterprise_list, is_mcp_enabled, is_staff, limited_user_quotas, limited_user_reset_date, login, monthly_quotas, organization_list, organization_login_list, quota_reset_date, quota_reset_date_utc, quota_snapshots, restricted_telemetry, te, token_based_billing) def to_dict(self) -> dict: result: dict = {} @@ -34944,6 +37662,8 @@ def to_dict(self) -> dict: result["copilotignore_enabled"] = from_union([from_bool, from_none], self.copilotignore_enabled) if self.endpoints is not None: result["endpoints"] = from_union([lambda x: to_class(CopilotUserResponseEndpoints, x), from_none], self.endpoints) + if self.enterprise_list is not None: + result["enterprise_list"] = from_union([lambda x: from_list(lambda x: to_class(EnterpriseList, x), x), from_none], self.enterprise_list) if self.is_mcp_enabled is not None: result["is_mcp_enabled"] = self.is_mcp_enabled if self.is_staff is not None: @@ -35697,7 +38417,7 @@ class FactoryRunDetail: run_id: str """Factory run identifier.""" - status: FactoryRunStatus + status: RunStatus """Current factory run status.""" total_spawned_agent_count: int @@ -35741,7 +38461,7 @@ def from_dict(obj: Any) -> 'FactoryRunDetail': progress = FactoryProgressPage.from_dict(obj.get("progress")) revision = from_int(obj.get("revision")) run_id = from_str(obj.get("runId")) - status = FactoryRunStatus(obj.get("status")) + status = RunStatus(obj.get("status")) total_spawned_agent_count = from_int(obj.get("totalSpawnedAgentCount")) updated_at = from_int(obj.get("updatedAt")) active_segment_started_at = from_union([from_int, from_none], obj.get("activeSegmentStartedAt")) @@ -35768,7 +38488,7 @@ def to_dict(self) -> dict: result["progress"] = to_class(FactoryProgressPage, self.progress) result["revision"] = from_int(self.revision) result["runId"] = from_str(self.run_id) - result["status"] = to_enum(FactoryRunStatus, self.status) + result["status"] = to_enum(RunStatus, self.status) result["totalSpawnedAgentCount"] = from_int(self.total_spawned_agent_count) result["updatedAt"] = from_int(self.updated_at) result["activeSegmentStartedAt"] = from_union([from_int, from_none], self.active_segment_started_at) @@ -36180,6 +38900,11 @@ class MCPServerConfig: safe_for_telemetry: bool | MCPSafeForTelemetryFields | None = None """Telemetry-obfuscation policy for this server's tools.""" + slow_connection_threshold_ms: int | None = None + """Milliseconds this server may spend connecting before the CLI warns that it is taking + longer than expected. Presentation only: it does not change how long the connection is + allowed to take. + """ source: McpServerSource | None = None """The origin of this server configuration.""" @@ -36247,6 +38972,7 @@ def from_dict(obj: Any) -> 'MCPServerConfig': notifications = from_union([lambda x: from_list(from_str, x), from_none], obj.get("notifications")) oidc = from_union([from_bool, MCPServerAuthConfigRedirectPort.from_dict, from_none], obj.get("oidc")) safe_for_telemetry = from_union([from_bool, MCPSafeForTelemetryFields.from_dict, from_none], obj.get("safeForTelemetry")) + slow_connection_threshold_ms = from_union([from_int, from_none], obj.get("slowConnectionThresholdMs")) source = from_union([McpServerSource, from_none], obj.get("source")) source_path = from_union([from_str, from_none], obj.get("sourcePath")) source_plugin = from_union([from_str, from_none], obj.get("sourcePlugin")) @@ -36262,7 +38988,7 @@ def from_dict(obj: Any) -> 'MCPServerConfig': oauth_public_client = from_union([from_bool, from_none], obj.get("oauthPublicClient")) url = from_union([from_str, from_none], obj.get("url")) server_instance = obj.get("serverInstance") - return MCPServerConfig(args, auth, command, config_warnings, cwd, defer_tools, disable_secret_masking, disable_tool_cache, display_name, env, events, exclude_tools, filter_mapping, is_default_server, notifications, oidc, safe_for_telemetry, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools, type, headers, headers_refresh_ttl_ms, oauth_client_id, oauth_grant_type, oauth_public_client, url, server_instance) + return MCPServerConfig(args, auth, command, config_warnings, cwd, defer_tools, disable_secret_masking, disable_tool_cache, display_name, env, events, exclude_tools, filter_mapping, is_default_server, notifications, oidc, safe_for_telemetry, slow_connection_threshold_ms, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools, type, headers, headers_refresh_ttl_ms, oauth_client_id, oauth_grant_type, oauth_public_client, url, server_instance) def to_dict(self) -> dict: result: dict = {} @@ -36300,6 +39026,8 @@ def to_dict(self) -> dict: result["oidc"] = from_union([from_bool, lambda x: to_class(MCPServerAuthConfigRedirectPort, x), from_none], self.oidc) if self.safe_for_telemetry is not None: result["safeForTelemetry"] = from_union([from_bool, lambda x: to_class(MCPSafeForTelemetryFields, x), from_none], self.safe_for_telemetry) + if self.slow_connection_threshold_ms is not None: + result["slowConnectionThresholdMs"] = from_union([from_int, from_none], self.slow_connection_threshold_ms) if self.source is not None: result["source"] = from_union([lambda x: to_enum(McpServerSource, x), from_none], self.source) if self.source_path is not None: @@ -36682,6 +39410,11 @@ class MCPServerConfigMemory: safe_for_telemetry: bool | MCPSafeForTelemetryFields | None = None """Telemetry-obfuscation policy for this server's tools.""" + slow_connection_threshold_ms: int | None = None + """Milliseconds this server may spend connecting before the CLI warns that it is taking + longer than expected. Presentation only: it does not change how long the connection is + allowed to take. + """ source: McpServerSource | None = None """The origin of this server configuration.""" @@ -36720,6 +39453,7 @@ def from_dict(obj: Any) -> 'MCPServerConfigMemory': notifications = from_union([lambda x: from_list(from_str, x), from_none], obj.get("notifications")) oidc = from_union([from_bool, MCPServerAuthConfigRedirectPort.from_dict, from_none], obj.get("oidc")) safe_for_telemetry = from_union([from_bool, MCPSafeForTelemetryFields.from_dict, from_none], obj.get("safeForTelemetry")) + slow_connection_threshold_ms = from_union([from_int, from_none], obj.get("slowConnectionThresholdMs")) source = from_union([McpServerSource, from_none], obj.get("source")) source_path = from_union([from_str, from_none], obj.get("sourcePath")) source_plugin = from_union([from_str, from_none], obj.get("sourcePlugin")) @@ -36727,7 +39461,7 @@ def from_dict(obj: Any) -> 'MCPServerConfigMemory': source_plugin_version = from_union([from_str, from_none], obj.get("sourcePluginVersion")) timeout = from_union([from_int, from_none], obj.get("timeout")) tools = from_union([lambda x: from_list(from_str, x), from_none], obj.get("tools")) - return MCPServerConfigMemory(server_instance, type, config_warnings, defer_tools, disable_secret_masking, disable_tool_cache, display_name, events, exclude_tools, filter_mapping, is_default_server, notifications, oidc, safe_for_telemetry, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools) + return MCPServerConfigMemory(server_instance, type, config_warnings, defer_tools, disable_secret_masking, disable_tool_cache, display_name, events, exclude_tools, filter_mapping, is_default_server, notifications, oidc, safe_for_telemetry, slow_connection_threshold_ms, source, source_path, source_plugin, source_plugin_spec, source_plugin_version, timeout, tools) def to_dict(self) -> dict: result: dict = {} @@ -36757,6 +39491,8 @@ def to_dict(self) -> dict: result["oidc"] = from_union([from_bool, lambda x: to_class(MCPServerAuthConfigRedirectPort, x), from_none], self.oidc) if self.safe_for_telemetry is not None: result["safeForTelemetry"] = from_union([from_bool, lambda x: to_class(MCPSafeForTelemetryFields, x), from_none], self.safe_for_telemetry) + if self.slow_connection_threshold_ms is not None: + result["slowConnectionThresholdMs"] = from_union([from_int, from_none], self.slow_connection_threshold_ms) if self.source is not None: result["source"] = from_union([lambda x: to_enum(McpServerSource, x), from_none], self.source) if self.source_path is not None: @@ -36972,6 +39708,10 @@ def to_dict(self) -> dict: class ModelApplyStartupOverlayRequest: """Managed, repository, and CLI model overrides to overlay onto the session at startup.""" + auto_tier: AutoTier | None = None + """Effective default Auto routing preference from user and managed settings. Applies only to + fresh sessions and never replaces a per-session selection. + """ cli_model: str | None = None """Model explicitly selected by the CLI, when provided.""" @@ -37005,6 +39745,7 @@ class ModelApplyStartupOverlayRequest: @staticmethod def from_dict(obj: Any) -> 'ModelApplyStartupOverlayRequest': assert isinstance(obj, dict) + auto_tier = from_union([AutoTier, from_none], obj.get("autoTier")) cli_model = from_union([from_str, from_none], obj.get("cliModel")) deferred_resume = from_union([from_bool, from_none], obj.get("deferredResume")) device_managed_model = from_union([from_str, from_none], obj.get("deviceManagedModel")) @@ -37014,10 +39755,12 @@ def from_dict(obj: Any) -> 'ModelApplyStartupOverlayRequest': repo_model = from_union([from_str, from_none], obj.get("repoModel")) repo_reasoning_effort = from_union([from_str, from_none], obj.get("repoReasoningEffort")) server_managed_model = from_union([from_str, from_none], obj.get("serverManagedModel")) - return ModelApplyStartupOverlayRequest(cli_model, deferred_resume, device_managed_model, policy_helper_model, repo_auto_tier, repo_context_tier, repo_model, repo_reasoning_effort, server_managed_model) + return ModelApplyStartupOverlayRequest(auto_tier, cli_model, deferred_resume, device_managed_model, policy_helper_model, repo_auto_tier, repo_context_tier, repo_model, repo_reasoning_effort, server_managed_model) def to_dict(self) -> dict: result: dict = {} + if self.auto_tier is not None: + result["autoTier"] = from_union([lambda x: to_enum(AutoTier, x), from_none], self.auto_tier) if self.cli_model is not None: result["cliModel"] = from_union([from_str, from_none], self.cli_model) if self.deferred_resume is not None: @@ -38119,6 +40862,225 @@ def to_dict(self) -> dict: result["copilotUser"] = from_union([lambda x: to_class(CopilotUserResponse, x), from_none], self.copilot_user) return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowAgentSummary: + """Prompt-safe durable identity and live status for a direct workflow agent.""" + + active_ms: int + """Accumulated active agent time in milliseconds.""" + + agent_id: str + """Stable direct-agent identifier.""" + + agent_type: str + """Registered agent type.""" + + label: str + """Friendly, non-unique name intended for display""" + + run_id: str + """Owning workflow run identifier.""" + + status: str + """Current durable or live agent status.""" + + tool_call_id: str + """Tool-call identifier that launched the agent.""" + + activity: str | None = None + """Prompt-safe live activity text.""" + + completed_at: int | None = None + """Epoch milliseconds when the agent completed.""" + + display_name: str | None = None + """Friendly, non-unique name intended for display""" + + phase_id: str | None = None + """Phase identifier active when the agent was launched, or null.""" + + requested_model: str | None = None + """Model requested when the agent was launched.""" + + resolved_model: str | None = None + """Concrete model resolved for the agent.""" + + started_at: int | None = None + """Epoch milliseconds when the agent started.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowAgentSummary': + assert isinstance(obj, dict) + active_ms = from_int(obj.get("activeMs")) + agent_id = from_str(obj.get("agentId")) + agent_type = from_str(obj.get("agentType")) + label = from_str(obj.get("label")) + run_id = from_str(obj.get("runId")) + status = from_str(obj.get("status")) + tool_call_id = from_str(obj.get("toolCallId")) + activity = from_union([from_str, from_none], obj.get("activity")) + completed_at = from_union([from_int, from_none], obj.get("completedAt")) + display_name = from_union([from_str, from_none], obj.get("displayName")) + phase_id = from_union([from_none, from_str], obj.get("phaseId")) + requested_model = from_union([from_str, from_none], obj.get("requestedModel")) + resolved_model = from_union([from_str, from_none], obj.get("resolvedModel")) + started_at = from_union([from_int, from_none], obj.get("startedAt")) + return WorkflowAgentSummary(active_ms, agent_id, agent_type, label, run_id, status, tool_call_id, activity, completed_at, display_name, phase_id, requested_model, resolved_model, started_at) + + def to_dict(self) -> dict: + result: dict = {} + result["activeMs"] = from_int(self.active_ms) + result["agentId"] = from_str(self.agent_id) + result["agentType"] = from_str(self.agent_type) + result["label"] = from_str(self.label) + result["runId"] = from_str(self.run_id) + result["status"] = from_str(self.status) + result["toolCallId"] = from_str(self.tool_call_id) + if self.activity is not None: + result["activity"] = from_union([from_str, from_none], self.activity) + if self.completed_at is not None: + result["completedAt"] = from_union([from_int, from_none], self.completed_at) + if self.display_name is not None: + result["displayName"] = from_union([from_str, from_none], self.display_name) + result["phaseId"] = from_union([from_none, from_str], self.phase_id) + if self.requested_model is not None: + result["requestedModel"] = from_union([from_str, from_none], self.requested_model) + if self.resolved_model is not None: + result["resolvedModel"] = from_union([from_str, from_none], self.resolved_model) + if self.started_at is not None: + result["startedAt"] = from_union([from_int, from_none], self.started_at) + return result + +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class WorkflowRunDetail: + """Full workflow run observability detail.""" + + agents: list[WorkflowAgentSummary] + """Durable identities and live statuses for direct workflow agents.""" + + can_resume: bool + """Whether the durable run state currently passes runtime resume eligibility checks.""" + + consumed: WorkflowRunConsumed + """Durable resource consumption.""" + + created_at: int + """Epoch milliseconds when the run was created.""" + + declared_limits: WorkflowDeclaredLimits + """Resource ceilings declared by the workflow.""" + + declared_phase_count: int + """Number of phases declared by the workflow.""" + + description: str + """Human-readable workflow description.""" + + live_agent_count: int + """Number of direct workflow agents currently live.""" + + observed_at: int + """Epoch milliseconds when this live-overlay snapshot was observed.""" + + phases: list[WorkflowPhaseObservation] + """Lifecycle and timing observations for each workflow phase.""" + + progress: WorkflowProgressPage + """Bidirectional page of durable workflow progress.""" + + revision: int + """Monotonic durable run revision.""" + + run_id: str + """Workflow run identifier.""" + + status: RunStatus + """Current workflow run status.""" + + total_spawned_agent_count: int + """Total direct workflow agents spawned across all attempts.""" + + updated_at: int + """Epoch milliseconds when the durable run was last updated.""" + + workflow_name: str + """Registered workflow name.""" + + active_segment_started_at: int | None = None + """Epoch milliseconds when the current active segment started, or null while inactive.""" + + approved: WorkflowDeclaredLimits | None = None + """Approved effective resource ceilings, or null until approved.""" + + completed_at: int | None = None + """Epoch milliseconds when the run completed, or null while nonterminal.""" + + current_phase: WorkflowCurrentPhase | None = None + """Current phase identity, or null before any phase is entered.""" + + started_at: int | None = None + """Epoch milliseconds when execution first started, or null before start.""" + + terminal: WorkflowRunTerminal | None = None + """Terminal run outcome, or null while nonterminal.""" + + @staticmethod + def from_dict(obj: Any) -> 'WorkflowRunDetail': + assert isinstance(obj, dict) + agents = from_list(WorkflowAgentSummary.from_dict, obj.get("agents")) + can_resume = from_bool(obj.get("canResume")) + consumed = WorkflowRunConsumed.from_dict(obj.get("consumed")) + created_at = from_int(obj.get("createdAt")) + declared_limits = WorkflowDeclaredLimits.from_dict(obj.get("declaredLimits")) + declared_phase_count = from_int(obj.get("declaredPhaseCount")) + description = from_str(obj.get("description")) + live_agent_count = from_int(obj.get("liveAgentCount")) + observed_at = from_int(obj.get("observedAt")) + phases = from_list(WorkflowPhaseObservation.from_dict, obj.get("phases")) + progress = WorkflowProgressPage.from_dict(obj.get("progress")) + revision = from_int(obj.get("revision")) + run_id = from_str(obj.get("runId")) + status = RunStatus(obj.get("status")) + total_spawned_agent_count = from_int(obj.get("totalSpawnedAgentCount")) + updated_at = from_int(obj.get("updatedAt")) + workflow_name = from_str(obj.get("workflowName")) + active_segment_started_at = from_union([from_int, from_none], obj.get("activeSegmentStartedAt")) + approved = from_union([WorkflowDeclaredLimits.from_dict, from_none], obj.get("approved")) + completed_at = from_union([from_int, from_none], obj.get("completedAt")) + current_phase = from_union([WorkflowCurrentPhase.from_dict, from_none], obj.get("currentPhase")) + started_at = from_union([from_int, from_none], obj.get("startedAt")) + terminal = from_union([WorkflowRunTerminal.from_dict, from_none], obj.get("terminal")) + return WorkflowRunDetail(agents, can_resume, consumed, created_at, declared_limits, declared_phase_count, description, live_agent_count, observed_at, phases, progress, revision, run_id, status, total_spawned_agent_count, updated_at, workflow_name, active_segment_started_at, approved, completed_at, current_phase, started_at, terminal) + + def to_dict(self) -> dict: + result: dict = {} + result["agents"] = from_list(lambda x: to_class(WorkflowAgentSummary, x), self.agents) + result["canResume"] = from_bool(self.can_resume) + result["consumed"] = to_class(WorkflowRunConsumed, self.consumed) + result["createdAt"] = from_int(self.created_at) + result["declaredLimits"] = to_class(WorkflowDeclaredLimits, self.declared_limits) + result["declaredPhaseCount"] = from_int(self.declared_phase_count) + result["description"] = from_str(self.description) + result["liveAgentCount"] = from_int(self.live_agent_count) + result["observedAt"] = from_int(self.observed_at) + result["phases"] = from_list(lambda x: to_class(WorkflowPhaseObservation, x), self.phases) + result["progress"] = to_class(WorkflowProgressPage, self.progress) + result["revision"] = from_int(self.revision) + result["runId"] = from_str(self.run_id) + result["status"] = to_enum(RunStatus, self.status) + result["totalSpawnedAgentCount"] = from_int(self.total_spawned_agent_count) + result["updatedAt"] = from_int(self.updated_at) + result["workflowName"] = from_str(self.workflow_name) + result["activeSegmentStartedAt"] = from_union([from_int, from_none], self.active_segment_started_at) + result["approved"] = from_union([lambda x: to_class(WorkflowDeclaredLimits, x), from_none], self.approved) + result["completedAt"] = from_union([from_int, from_none], self.completed_at) + result["currentPhase"] = from_union([lambda x: to_class(WorkflowCurrentPhase, x), from_none], self.current_phase) + result["startedAt"] = from_union([from_int, from_none], self.started_at) + result["terminal"] = from_union([lambda x: to_class(WorkflowRunTerminal, x), from_none], self.terminal) + return result + @dataclass class RPC: abort_request: AbortRequest @@ -38205,8 +41167,16 @@ class RPC: card_digest: CardDigest card_digest_algorithm: CardDigestAlgorithm card_digest_value: str + catalog_agent_plugin_candidate: CatalogAgentPluginCandidate + catalog_agent_plugin_candidate_kind: CatalogAgentPluginCandidateKind + catalog_agent_plugin_candidate_provenance: CatalogAgentPluginCandidateProvenance + catalog_agent_plugin_compatibility_tag: CatalogAgentPluginCompatibilityTag + catalog_agent_plugin_media_type: CatalogAgentPluginMediaType catalog_ai_skill_candidate: CatalogAISkillCandidate + catalog_ai_skill_candidate_kind: CatalogAISkillCandidateKind catalog_ai_skill_candidate_provenance: CatalogAISkillCandidateProvenance + catalog_ai_skill_installability: CatalogAISkillInstallability + catalog_ai_skill_media_type: CatalogAISkillMediaType catalog_authentication_required_error: CatalogAuthenticationRequiredError catalog_authentication_required_reason: CatalogAuthenticationRequiredReason catalog_candidate: CatalogCandidate @@ -38227,6 +41197,7 @@ class RPC: catalog_malformed_card_error: CatalogMalformedCardError catalog_malformed_card_reason: CatalogMalformedCardReason catalog_mcp_server_candidate: CatalogMCPServerCandidate + catalog_mcp_server_candidate_kind: CatalogMCPServerCandidateKind catalog_mcp_server_candidate_provenance: CatalogMCPServerCandidateProvenance catalog_mcp_server_installability: CatalogMCPServerInstallabilityEnum catalog_media_type: CatalogMediaType @@ -38237,10 +41208,28 @@ class RPC: catalog_network_failure_reason: CatalogNetworkFailureReason catalog_not_installable_error: CatalogNotInstallableError catalog_not_installable_reason: CatalogNotInstallableReason + catalog_plugin_repository_source: CatalogPluginRepositorySource catalog_policy_rejected_error: CatalogPolicyRejectedError + catalog_resource_identity: str + catalog_resource_version: str + catalog_search_page: CatalogSearchPage + catalog_search_pagination: CatalogSearchPagination catalog_search_request: CatalogSearchRequest catalog_search_result: CatalogSearchResult catalog_search_succeeded: CatalogSearchSucceeded + catalog_search_total_count_relation: CatalogSearchTotalCountRelation + catalog_selection_cancelled: CatalogSelectionCancelled + catalog_selection_decision: CatalogSelectionDecision + catalog_selection_declined: CatalogSelectionDeclined + catalog_selection_foreign: CatalogSelectionForeign + catalog_selection_invalid: CatalogSelectionInvalid + catalog_selection_replayed: CatalogSelectionReplayed + catalog_selection_request: CatalogSelectionRequest + catalog_selection_result: CatalogSelectionResult + catalog_selection_selected: CatalogSelectionSelected + catalog_selection_stale: CatalogSelectionStale + catalog_selection_timed_out: CatalogSelectionTimedOut + catalog_selection_wrong_kind: CatalogSelectionWrongKind catalog_trust_eligibility: CatalogTrustEligibility catalog_trust_provenance: CatalogTrustProvenance catalog_trust_snapshot: CatalogTrustSnapshot @@ -38377,7 +41366,7 @@ class RPC: factory_cancel_request: FactoryCancelRequest factory_current_phase: FactoryCurrentPhase factory_declared_limits: FactoryDeclaredLimits - factory_durable_operation: FactoryDurableOperation + factory_durable_operation: DurableOperation factory_execute_request: FactoryExecuteRequest factory_execute_result: FactoryExecuteResult factory_get_run_progress_request: FactoryGetRunProgressRequest @@ -38388,15 +41377,15 @@ class RPC: factory_list_runs_request: FactoryListRunsRequest factory_list_runs_result: FactoryListRunsResult factory_log_line: FactoryLogLine - factory_log_line_kind: FactoryLogLineKind + factory_log_line_kind: LogLineKind factory_log_request: FactoryLogRequest - factory_pause_checkpoint_action: FactoryPauseCheckpointAction + factory_pause_checkpoint_action: PauseCheckpointAction factory_pause_checkpoint_request: FactoryPauseCheckpointRequest factory_pause_checkpoint_result: FactoryPauseCheckpointResult factory_pause_info: FactoryPauseInfo factory_pause_request: FactoryPauseRequest factory_phase_observation: FactoryPhaseObservation - factory_phase_status: FactoryPhaseStatus + factory_phase_status: PhaseStatus factory_progress_line: FactoryProgressLine factory_progress_page: FactoryProgressPage factory_resume_request: FactoryResumeRequest @@ -38404,11 +41393,11 @@ class RPC: factory_run_consumed: FactoryRunConsumed factory_run_detail: FactoryRunDetail factory_run_failure: FactoryRunFailure - factory_run_failure_kind: FactoryRunFailureKind + factory_run_failure_kind: RunFailureKind factory_run_limits: FactoryRunLimits factory_run_request: FactoryRunRequest factory_run_result: FactoryRunResult - factory_run_status: FactoryRunStatus + factory_run_status: RunStatus factory_run_summary: FactoryRunSummary factory_run_terminal: FactoryRunTerminal factory_tool_resume_request: _FactoryToolResumeRequest @@ -38496,6 +41485,7 @@ class RPC: lsp_initialize_request: LspInitializeRequest managed_mcp_server_config: ManagedMCPServerConfig managed_settings_read_result: ManagedSettingsReadResult + managed_settings_resolved_data: ManagedSettingsResolvedData marketplace_add_result: MarketplaceAddResult marketplace_browse_result: MarketplaceBrowseResult marketplace_info: MarketplaceInfo @@ -38914,6 +41904,7 @@ class RPC: push_attachment_selection_details_end: PushAttachmentSelectionDetailsEnd push_attachment_selection_details_start: PushAttachmentSelectionDetailsStart push_git_hub_repo_ref: PushGitHubRepoRef + queue_append_steering_request: QueueAppendSteeringRequest queue_begin_deferred_idle_drain_request: QueueBeginDeferredIdleDrainRequest queue_begin_deferred_idle_drain_result: QueueBeginDeferredIdleDrainResult queue_consume_system_notifications_request: QueueConsumeSystemNotificationsRequest @@ -38944,6 +41935,7 @@ class RPC: queue_snapshot_result: QueueSnapshotResult queue_update_text_request: QueueUpdateTextRequest queue_update_text_result: QueueUpdateTextResult + queue_withdraw_message_request: QueueWithdrawMessageRequest register_event_interest_params: RegisterEventInterestParams register_event_interest_result: RegisterEventInterestResult release_event_interest_params: ReleaseEventInterestParams @@ -39099,6 +42091,10 @@ class RPC: session_open_options_reasoning_summary: ReasoningSummary session_open_params: SessionOpenParams session_open_result: SessionOpenResult + session_plugins_disable_request: SessionPluginsDisableRequest + session_plugins_enable_request: SessionPluginsEnableRequest + session_plugins_install_request: SessionPluginsInstallRequest + session_plugins_marketplaces_refresh_request: SessionPluginsMarketplacesRefreshRequest session_plugins_reload_request: SessionPluginsReloadRequest session_provider_get_endpoint_request: SessionProviderGetEndpointRequest session_prune_result: SessionPruneResult @@ -39176,6 +42172,7 @@ class RPC: session_update_options_params: SessionUpdateOptionsParams session_update_options_result: SessionUpdateOptionsResult session_visibility_status: SessionVisibilityStatus + session_workflow_pause_at_checkpoint_result: SessionWorkflowPauseAtCheckpointResult session_working_directory_context: SessionWorkingDirectoryContext session_working_directory_context_host_type: HostType settable_auth_info: SettableAuthInfo @@ -39353,6 +42350,53 @@ class RPC: visibility_get_result: VisibilityGetResult visibility_set_request: VisibilitySetRequest visibility_set_result: VisibilitySetResult + workflow_abort_request: WorkflowAbortRequest + workflow_ack_result: WorkflowACKResult + workflow_agent_options: WorkflowAgentOptions + workflow_agent_request: WorkflowAgentRequest + workflow_agent_result: WorkflowAgentResult + workflow_agent_summary: WorkflowAgentSummary + workflow_cancel_request: WorkflowCancelRequest + workflow_current_phase: WorkflowCurrentPhase + workflow_declared_limits: WorkflowDeclaredLimits + workflow_durable_operation: DurableOperation + workflow_execute_request: WorkflowExecuteRequest + workflow_execute_result: WorkflowExecuteResult + workflow_get_run_progress_request: WorkflowGetRunProgressRequest + workflow_get_run_request: WorkflowGetRunRequest + workflow_journal_get_request: WorkflowJournalGetRequest + workflow_journal_get_result: WorkflowJournalGetResult + workflow_journal_put_request: WorkflowJournalPutRequest + workflow_list_runs_request: WorkflowListRunsRequest + workflow_list_runs_result: WorkflowListRunsResult + workflow_log_line: WorkflowLogLine + workflow_log_line_kind: LogLineKind + workflow_log_request: WorkflowLogRequest + workflow_pause_checkpoint_action: PauseCheckpointAction + workflow_pause_checkpoint_request: WorkflowPauseCheckpointRequest + workflow_pause_checkpoint_result: WorkflowPauseCheckpointResult + workflow_pause_info: WorkflowPauseInfo + workflow_pause_request: WorkflowPauseRequest + workflow_phase_observation: WorkflowPhaseObservation + workflow_phase_status: PhaseStatus + workflow_progress_line: WorkflowProgressLine + workflow_progress_page: WorkflowProgressPage + workflow_resume_request: WorkflowResumeRequest + workflow_resume_result: WorkflowResumeResult + workflow_run_consumed: WorkflowRunConsumed + workflow_run_detail: WorkflowRunDetail + workflow_run_failure: WorkflowRunFailure + workflow_run_failure_kind: RunFailureKind + workflow_run_limits: WorkflowRunLimits + workflow_run_options: WorkflowRunOptions + workflow_run_request: WorkflowRunRequest + workflow_run_result: WorkflowRunResult + workflow_run_status: RunStatus + workflow_run_summary: WorkflowRunSummary + workflow_run_terminal: WorkflowRunTerminal + workflow_tool_resume_request: _WorkflowToolResumeRequest + workflow_tool_run_options: _WorkflowToolRunOptions + workflow_tool_run_request: _WorkflowToolRunRequest workspace_diff_file_change: WorkspaceDiffFileChange workspace_diff_file_change_type: WorkspaceDiffFileChangeType workspace_diff_mode: WorkspaceDiffMode @@ -39480,8 +42524,16 @@ def from_dict(obj: Any) -> 'RPC': card_digest = CardDigest.from_dict(obj.get("CardDigest")) card_digest_algorithm = CardDigestAlgorithm(obj.get("CardDigestAlgorithm")) card_digest_value = from_str(obj.get("CardDigestValue")) + catalog_agent_plugin_candidate = CatalogAgentPluginCandidate.from_dict(obj.get("CatalogAgentPluginCandidate")) + catalog_agent_plugin_candidate_kind = CatalogAgentPluginCandidateKind(obj.get("CatalogAgentPluginCandidateKind")) + catalog_agent_plugin_candidate_provenance = CatalogAgentPluginCandidateProvenance.from_dict(obj.get("CatalogAgentPluginCandidateProvenance")) + catalog_agent_plugin_compatibility_tag = CatalogAgentPluginCompatibilityTag(obj.get("CatalogAgentPluginCompatibilityTag")) + catalog_agent_plugin_media_type = CatalogAgentPluginMediaType(obj.get("CatalogAgentPluginMediaType")) catalog_ai_skill_candidate = CatalogAISkillCandidate.from_dict(obj.get("CatalogAiSkillCandidate")) + catalog_ai_skill_candidate_kind = CatalogAISkillCandidateKind(obj.get("CatalogAiSkillCandidateKind")) catalog_ai_skill_candidate_provenance = CatalogAISkillCandidateProvenance.from_dict(obj.get("CatalogAiSkillCandidateProvenance")) + catalog_ai_skill_installability = CatalogAISkillInstallability(obj.get("CatalogAiSkillInstallability")) + catalog_ai_skill_media_type = CatalogAISkillMediaType(obj.get("CatalogAiSkillMediaType")) catalog_authentication_required_error = CatalogAuthenticationRequiredError.from_dict(obj.get("CatalogAuthenticationRequiredError")) catalog_authentication_required_reason = CatalogAuthenticationRequiredReason(obj.get("CatalogAuthenticationRequiredReason")) catalog_candidate = CatalogCandidate.from_dict(obj.get("CatalogCandidate")) @@ -39502,6 +42554,7 @@ def from_dict(obj: Any) -> 'RPC': catalog_malformed_card_error = CatalogMalformedCardError.from_dict(obj.get("CatalogMalformedCardError")) catalog_malformed_card_reason = CatalogMalformedCardReason(obj.get("CatalogMalformedCardReason")) catalog_mcp_server_candidate = CatalogMCPServerCandidate.from_dict(obj.get("CatalogMcpServerCandidate")) + catalog_mcp_server_candidate_kind = CatalogMCPServerCandidateKind(obj.get("CatalogMcpServerCandidateKind")) catalog_mcp_server_candidate_provenance = CatalogMCPServerCandidateProvenance.from_dict(obj.get("CatalogMcpServerCandidateProvenance")) catalog_mcp_server_installability = CatalogMCPServerInstallabilityEnum(obj.get("CatalogMcpServerInstallability")) catalog_media_type = CatalogMediaType(obj.get("CatalogMediaType")) @@ -39512,10 +42565,28 @@ def from_dict(obj: Any) -> 'RPC': catalog_network_failure_reason = CatalogNetworkFailureReason(obj.get("CatalogNetworkFailureReason")) catalog_not_installable_error = CatalogNotInstallableError.from_dict(obj.get("CatalogNotInstallableError")) catalog_not_installable_reason = CatalogNotInstallableReason(obj.get("CatalogNotInstallableReason")) + catalog_plugin_repository_source = CatalogPluginRepositorySource.from_dict(obj.get("CatalogPluginRepositorySource")) catalog_policy_rejected_error = CatalogPolicyRejectedError.from_dict(obj.get("CatalogPolicyRejectedError")) + catalog_resource_identity = from_str(obj.get("CatalogResourceIdentity")) + catalog_resource_version = from_str(obj.get("CatalogResourceVersion")) + catalog_search_page = CatalogSearchPage.from_dict(obj.get("CatalogSearchPage")) + catalog_search_pagination = CatalogSearchPagination.from_dict(obj.get("CatalogSearchPagination")) catalog_search_request = CatalogSearchRequest.from_dict(obj.get("CatalogSearchRequest")) catalog_search_result = _load_CatalogSearchResult(obj.get("CatalogSearchResult")) catalog_search_succeeded = CatalogSearchSucceeded.from_dict(obj.get("CatalogSearchSucceeded")) + catalog_search_total_count_relation = CatalogSearchTotalCountRelation(obj.get("CatalogSearchTotalCountRelation")) + catalog_selection_cancelled = CatalogSelectionCancelled.from_dict(obj.get("CatalogSelectionCancelled")) + catalog_selection_decision = CatalogSelectionDecision(obj.get("CatalogSelectionDecision")) + catalog_selection_declined = CatalogSelectionDeclined.from_dict(obj.get("CatalogSelectionDeclined")) + catalog_selection_foreign = CatalogSelectionForeign.from_dict(obj.get("CatalogSelectionForeign")) + catalog_selection_invalid = CatalogSelectionInvalid.from_dict(obj.get("CatalogSelectionInvalid")) + catalog_selection_replayed = CatalogSelectionReplayed.from_dict(obj.get("CatalogSelectionReplayed")) + catalog_selection_request = CatalogSelectionRequest.from_dict(obj.get("CatalogSelectionRequest")) + catalog_selection_result = _load_CatalogSelectionResult(obj.get("CatalogSelectionResult")) + catalog_selection_selected = CatalogSelectionSelected.from_dict(obj.get("CatalogSelectionSelected")) + catalog_selection_stale = CatalogSelectionStale.from_dict(obj.get("CatalogSelectionStale")) + catalog_selection_timed_out = CatalogSelectionTimedOut.from_dict(obj.get("CatalogSelectionTimedOut")) + catalog_selection_wrong_kind = CatalogSelectionWrongKind.from_dict(obj.get("CatalogSelectionWrongKind")) catalog_trust_eligibility = CatalogTrustEligibility(obj.get("CatalogTrustEligibility")) catalog_trust_provenance = CatalogTrustProvenance.from_dict(obj.get("CatalogTrustProvenance")) catalog_trust_snapshot = _load_CatalogTrustSnapshot(obj.get("CatalogTrustSnapshot")) @@ -39652,7 +42723,7 @@ def from_dict(obj: Any) -> 'RPC': factory_cancel_request = FactoryCancelRequest.from_dict(obj.get("FactoryCancelRequest")) factory_current_phase = FactoryCurrentPhase.from_dict(obj.get("FactoryCurrentPhase")) factory_declared_limits = FactoryDeclaredLimits.from_dict(obj.get("FactoryDeclaredLimits")) - factory_durable_operation = FactoryDurableOperation(obj.get("FactoryDurableOperation")) + factory_durable_operation = DurableOperation(obj.get("FactoryDurableOperation")) factory_execute_request = FactoryExecuteRequest.from_dict(obj.get("FactoryExecuteRequest")) factory_execute_result = FactoryExecuteResult.from_dict(obj.get("FactoryExecuteResult")) factory_get_run_progress_request = FactoryGetRunProgressRequest.from_dict(obj.get("FactoryGetRunProgressRequest")) @@ -39663,15 +42734,15 @@ def from_dict(obj: Any) -> 'RPC': factory_list_runs_request = FactoryListRunsRequest.from_dict(obj.get("FactoryListRunsRequest")) factory_list_runs_result = FactoryListRunsResult.from_dict(obj.get("FactoryListRunsResult")) factory_log_line = FactoryLogLine.from_dict(obj.get("FactoryLogLine")) - factory_log_line_kind = FactoryLogLineKind(obj.get("FactoryLogLineKind")) + factory_log_line_kind = LogLineKind(obj.get("FactoryLogLineKind")) factory_log_request = FactoryLogRequest.from_dict(obj.get("FactoryLogRequest")) - factory_pause_checkpoint_action = FactoryPauseCheckpointAction(obj.get("FactoryPauseCheckpointAction")) + factory_pause_checkpoint_action = PauseCheckpointAction(obj.get("FactoryPauseCheckpointAction")) factory_pause_checkpoint_request = FactoryPauseCheckpointRequest.from_dict(obj.get("FactoryPauseCheckpointRequest")) factory_pause_checkpoint_result = FactoryPauseCheckpointResult.from_dict(obj.get("FactoryPauseCheckpointResult")) factory_pause_info = FactoryPauseInfo.from_dict(obj.get("FactoryPauseInfo")) factory_pause_request = FactoryPauseRequest.from_dict(obj.get("FactoryPauseRequest")) factory_phase_observation = FactoryPhaseObservation.from_dict(obj.get("FactoryPhaseObservation")) - factory_phase_status = FactoryPhaseStatus(obj.get("FactoryPhaseStatus")) + factory_phase_status = PhaseStatus(obj.get("FactoryPhaseStatus")) factory_progress_line = FactoryProgressLine.from_dict(obj.get("FactoryProgressLine")) factory_progress_page = FactoryProgressPage.from_dict(obj.get("FactoryProgressPage")) factory_resume_request = FactoryResumeRequest.from_dict(obj.get("FactoryResumeRequest")) @@ -39679,11 +42750,11 @@ def from_dict(obj: Any) -> 'RPC': factory_run_consumed = FactoryRunConsumed.from_dict(obj.get("FactoryRunConsumed")) factory_run_detail = FactoryRunDetail.from_dict(obj.get("FactoryRunDetail")) factory_run_failure = FactoryRunFailure.from_dict(obj.get("FactoryRunFailure")) - factory_run_failure_kind = FactoryRunFailureKind(obj.get("FactoryRunFailureKind")) + factory_run_failure_kind = RunFailureKind(obj.get("FactoryRunFailureKind")) factory_run_limits = FactoryRunLimits.from_dict(obj.get("FactoryRunLimits")) factory_run_request = FactoryRunRequest.from_dict(obj.get("FactoryRunRequest")) factory_run_result = FactoryRunResult.from_dict(obj.get("FactoryRunResult")) - factory_run_status = FactoryRunStatus(obj.get("FactoryRunStatus")) + factory_run_status = RunStatus(obj.get("FactoryRunStatus")) factory_run_summary = FactoryRunSummary.from_dict(obj.get("FactoryRunSummary")) factory_run_terminal = FactoryRunTerminal.from_dict(obj.get("FactoryRunTerminal")) factory_tool_resume_request = _FactoryToolResumeRequest.from_dict(obj.get("FactoryToolResumeRequest")) @@ -39771,6 +42842,7 @@ def from_dict(obj: Any) -> 'RPC': lsp_initialize_request = LspInitializeRequest.from_dict(obj.get("LspInitializeRequest")) managed_mcp_server_config = ManagedMCPServerConfig.from_dict(obj.get("ManagedMcpServerConfig")) managed_settings_read_result = ManagedSettingsReadResult.from_dict(obj.get("ManagedSettingsReadResult")) + managed_settings_resolved_data = ManagedSettingsResolvedData.from_dict(obj.get("ManagedSettingsResolvedData")) marketplace_add_result = MarketplaceAddResult.from_dict(obj.get("MarketplaceAddResult")) marketplace_browse_result = MarketplaceBrowseResult.from_dict(obj.get("MarketplaceBrowseResult")) marketplace_info = MarketplaceInfo.from_dict(obj.get("MarketplaceInfo")) @@ -40189,6 +43261,7 @@ def from_dict(obj: Any) -> 'RPC': push_attachment_selection_details_end = PushAttachmentSelectionDetailsEnd.from_dict(obj.get("PushAttachmentSelectionDetailsEnd")) push_attachment_selection_details_start = PushAttachmentSelectionDetailsStart.from_dict(obj.get("PushAttachmentSelectionDetailsStart")) push_git_hub_repo_ref = PushGitHubRepoRef.from_dict(obj.get("PushGitHubRepoRef")) + queue_append_steering_request = QueueAppendSteeringRequest.from_dict(obj.get("QueueAppendSteeringRequest")) queue_begin_deferred_idle_drain_request = QueueBeginDeferredIdleDrainRequest.from_dict(obj.get("QueueBeginDeferredIdleDrainRequest")) queue_begin_deferred_idle_drain_result = QueueBeginDeferredIdleDrainResult.from_dict(obj.get("QueueBeginDeferredIdleDrainResult")) queue_consume_system_notifications_request = QueueConsumeSystemNotificationsRequest.from_dict(obj.get("QueueConsumeSystemNotificationsRequest")) @@ -40219,6 +43292,7 @@ def from_dict(obj: Any) -> 'RPC': queue_snapshot_result = QueueSnapshotResult.from_dict(obj.get("QueueSnapshotResult")) queue_update_text_request = QueueUpdateTextRequest.from_dict(obj.get("QueueUpdateTextRequest")) queue_update_text_result = QueueUpdateTextResult.from_dict(obj.get("QueueUpdateTextResult")) + queue_withdraw_message_request = QueueWithdrawMessageRequest.from_dict(obj.get("QueueWithdrawMessageRequest")) register_event_interest_params = RegisterEventInterestParams.from_dict(obj.get("RegisterEventInterestParams")) register_event_interest_result = RegisterEventInterestResult.from_dict(obj.get("RegisterEventInterestResult")) release_event_interest_params = ReleaseEventInterestParams.from_dict(obj.get("ReleaseEventInterestParams")) @@ -40374,6 +43448,10 @@ def from_dict(obj: Any) -> 'RPC': session_open_options_reasoning_summary = ReasoningSummary(obj.get("SessionOpenOptionsReasoningSummary")) session_open_params = _load_SessionOpenParams(obj.get("SessionOpenParams")) session_open_result = SessionOpenResult.from_dict(obj.get("SessionOpenResult")) + session_plugins_disable_request = SessionPluginsDisableRequest.from_dict(obj.get("SessionPluginsDisableRequest")) + session_plugins_enable_request = SessionPluginsEnableRequest.from_dict(obj.get("SessionPluginsEnableRequest")) + session_plugins_install_request = SessionPluginsInstallRequest.from_dict(obj.get("SessionPluginsInstallRequest")) + session_plugins_marketplaces_refresh_request = SessionPluginsMarketplacesRefreshRequest.from_dict(obj.get("SessionPluginsMarketplacesRefreshRequest")) session_plugins_reload_request = SessionPluginsReloadRequest.from_dict(obj.get("SessionPluginsReloadRequest")) session_provider_get_endpoint_request = SessionProviderGetEndpointRequest.from_dict(obj.get("SessionProviderGetEndpointRequest")) session_prune_result = SessionPruneResult.from_dict(obj.get("SessionPruneResult")) @@ -40451,6 +43529,7 @@ def from_dict(obj: Any) -> 'RPC': session_update_options_params = SessionUpdateOptionsParams.from_dict(obj.get("SessionUpdateOptionsParams")) session_update_options_result = SessionUpdateOptionsResult.from_dict(obj.get("SessionUpdateOptionsResult")) session_visibility_status = SessionVisibilityStatus(obj.get("SessionVisibilityStatus")) + session_workflow_pause_at_checkpoint_result = SessionWorkflowPauseAtCheckpointResult.from_dict(obj.get("SessionWorkflowPauseAtCheckpointResult")) session_working_directory_context = SessionWorkingDirectoryContext.from_dict(obj.get("SessionWorkingDirectoryContext")) session_working_directory_context_host_type = HostType(obj.get("SessionWorkingDirectoryContextHostType")) settable_auth_info = _load_SettableAuthInfo(obj.get("SettableAuthInfo")) @@ -40628,6 +43707,53 @@ def from_dict(obj: Any) -> 'RPC': visibility_get_result = VisibilityGetResult.from_dict(obj.get("VisibilityGetResult")) visibility_set_request = VisibilitySetRequest.from_dict(obj.get("VisibilitySetRequest")) visibility_set_result = VisibilitySetResult.from_dict(obj.get("VisibilitySetResult")) + workflow_abort_request = WorkflowAbortRequest.from_dict(obj.get("WorkflowAbortRequest")) + workflow_ack_result = WorkflowACKResult.from_dict(obj.get("WorkflowAckResult")) + workflow_agent_options = WorkflowAgentOptions.from_dict(obj.get("WorkflowAgentOptions")) + workflow_agent_request = WorkflowAgentRequest.from_dict(obj.get("WorkflowAgentRequest")) + workflow_agent_result = WorkflowAgentResult.from_dict(obj.get("WorkflowAgentResult")) + workflow_agent_summary = WorkflowAgentSummary.from_dict(obj.get("WorkflowAgentSummary")) + workflow_cancel_request = WorkflowCancelRequest.from_dict(obj.get("WorkflowCancelRequest")) + workflow_current_phase = WorkflowCurrentPhase.from_dict(obj.get("WorkflowCurrentPhase")) + workflow_declared_limits = WorkflowDeclaredLimits.from_dict(obj.get("WorkflowDeclaredLimits")) + workflow_durable_operation = DurableOperation(obj.get("WorkflowDurableOperation")) + workflow_execute_request = WorkflowExecuteRequest.from_dict(obj.get("WorkflowExecuteRequest")) + workflow_execute_result = WorkflowExecuteResult.from_dict(obj.get("WorkflowExecuteResult")) + workflow_get_run_progress_request = WorkflowGetRunProgressRequest.from_dict(obj.get("WorkflowGetRunProgressRequest")) + workflow_get_run_request = WorkflowGetRunRequest.from_dict(obj.get("WorkflowGetRunRequest")) + workflow_journal_get_request = WorkflowJournalGetRequest.from_dict(obj.get("WorkflowJournalGetRequest")) + workflow_journal_get_result = WorkflowJournalGetResult.from_dict(obj.get("WorkflowJournalGetResult")) + workflow_journal_put_request = WorkflowJournalPutRequest.from_dict(obj.get("WorkflowJournalPutRequest")) + workflow_list_runs_request = WorkflowListRunsRequest.from_dict(obj.get("WorkflowListRunsRequest")) + workflow_list_runs_result = WorkflowListRunsResult.from_dict(obj.get("WorkflowListRunsResult")) + workflow_log_line = WorkflowLogLine.from_dict(obj.get("WorkflowLogLine")) + workflow_log_line_kind = LogLineKind(obj.get("WorkflowLogLineKind")) + workflow_log_request = WorkflowLogRequest.from_dict(obj.get("WorkflowLogRequest")) + workflow_pause_checkpoint_action = PauseCheckpointAction(obj.get("WorkflowPauseCheckpointAction")) + workflow_pause_checkpoint_request = WorkflowPauseCheckpointRequest.from_dict(obj.get("WorkflowPauseCheckpointRequest")) + workflow_pause_checkpoint_result = WorkflowPauseCheckpointResult.from_dict(obj.get("WorkflowPauseCheckpointResult")) + workflow_pause_info = WorkflowPauseInfo.from_dict(obj.get("WorkflowPauseInfo")) + workflow_pause_request = WorkflowPauseRequest.from_dict(obj.get("WorkflowPauseRequest")) + workflow_phase_observation = WorkflowPhaseObservation.from_dict(obj.get("WorkflowPhaseObservation")) + workflow_phase_status = PhaseStatus(obj.get("WorkflowPhaseStatus")) + workflow_progress_line = WorkflowProgressLine.from_dict(obj.get("WorkflowProgressLine")) + workflow_progress_page = WorkflowProgressPage.from_dict(obj.get("WorkflowProgressPage")) + workflow_resume_request = WorkflowResumeRequest.from_dict(obj.get("WorkflowResumeRequest")) + workflow_resume_result = WorkflowResumeResult.from_dict(obj.get("WorkflowResumeResult")) + workflow_run_consumed = WorkflowRunConsumed.from_dict(obj.get("WorkflowRunConsumed")) + workflow_run_detail = WorkflowRunDetail.from_dict(obj.get("WorkflowRunDetail")) + workflow_run_failure = WorkflowRunFailure.from_dict(obj.get("WorkflowRunFailure")) + workflow_run_failure_kind = RunFailureKind(obj.get("WorkflowRunFailureKind")) + workflow_run_limits = WorkflowRunLimits.from_dict(obj.get("WorkflowRunLimits")) + workflow_run_options = WorkflowRunOptions.from_dict(obj.get("WorkflowRunOptions")) + workflow_run_request = WorkflowRunRequest.from_dict(obj.get("WorkflowRunRequest")) + workflow_run_result = WorkflowRunResult.from_dict(obj.get("WorkflowRunResult")) + workflow_run_status = RunStatus(obj.get("WorkflowRunStatus")) + workflow_run_summary = WorkflowRunSummary.from_dict(obj.get("WorkflowRunSummary")) + workflow_run_terminal = WorkflowRunTerminal.from_dict(obj.get("WorkflowRunTerminal")) + workflow_tool_resume_request = _WorkflowToolResumeRequest.from_dict(obj.get("WorkflowToolResumeRequest")) + workflow_tool_run_options = _WorkflowToolRunOptions.from_dict(obj.get("WorkflowToolRunOptions")) + workflow_tool_run_request = _WorkflowToolRunRequest.from_dict(obj.get("WorkflowToolRunRequest")) workspace_diff_file_change = WorkspaceDiffFileChange.from_dict(obj.get("WorkspaceDiffFileChange")) workspace_diff_file_change_type = WorkspaceDiffFileChangeType(obj.get("WorkspaceDiffFileChangeType")) workspace_diff_mode = WorkspaceDiffMode(obj.get("WorkspaceDiffMode")) @@ -40667,7 +43793,7 @@ def from_dict(obj: Any) -> 'RPC': subagent_settings = from_union([SubagentSettings.from_dict, from_none], obj.get("SubagentSettings")) task_progress = from_union([TaskProgress.from_dict, from_none], obj.get("TaskProgress")) workspace_summary = from_union([WorkspaceSummary.from_dict, from_none], obj.get("WorkspaceSummary")) - return RPC(abort_request, abort_result, account_all_users, account_get_all_users_result, account_get_current_auth_result, account_get_quota_request, account_get_quota_result, account_login_request, account_login_result, account_logout_request, account_logout_result, account_quota_snapshot, adaptive_thinking_support, agent_discovery_path, agent_discovery_path_list, agent_discovery_path_scope, agent_get_current_result, agent_info, agent_info_source, agent_list, agent_list_request, agent_registry_live_target_entry, agent_registry_live_target_entry_attention_kind, agent_registry_live_target_entry_kind, agent_registry_live_target_entry_last_terminal_event, agent_registry_live_target_entry_status, agent_registry_log_capture, agent_registry_log_capture_open_error_reason, agent_registry_spawn_error, agent_registry_spawn_permission_mode, agent_registry_spawn_registry_timeout, agent_registry_spawn_request, agent_registry_spawn_result, agent_registry_spawn_spawned, agent_registry_spawn_validation_error, agent_registry_spawn_validation_error_field, agent_registry_spawn_validation_error_reason, agent_reload_result, agents_discover_request, agent_select_request, agent_select_result, agent_set_prompt_request, agents_get_discovery_paths_request, api_key_auth_info, auth_identity, auth_info, auth_info_type, auth_validation_error, auth_validation_errors, autopilot_objective_credit_limit, autopilot_objective_get_state_result, autopilot_objective_state, autopilot_objective_status, built_in_model_catalog, built_in_model_catalog_entry, builtin_tool_descriptor, builtin_tool_format, builtin_tool_format_type, builtin_tool_input_schema, builtin_tool_input_schema_type, builtin_tool_safe_for_telemetry, builtin_tool_safe_telemetry_fields, cancel_user_requested_shell_command_result, canvas_action, canvas_action_invoke_request, canvas_action_invoke_result, canvas_close_request, canvas_host_context, canvas_host_context_capabilities, canvas_json_schema, canvas_list, canvas_list_open_result, canvas_open_request, canvas_provider_close_request, canvas_provider_invoke_action_request, canvas_provider_open_request, canvas_provider_open_result, canvas_provider_register_request, canvas_provider_unregister_request, canvas_session_context, capi_session_options, card_digest, card_digest_algorithm, card_digest_value, catalog_ai_skill_candidate, catalog_ai_skill_candidate_provenance, catalog_authentication_required_error, catalog_authentication_required_reason, catalog_candidate, catalog_candidate_kind, catalog_candidate_source, catalog_candidate_source_embedded, catalog_candidate_source_url, catalog_capability, catalog_capability_id, catalog_client_contract, catalog_contract_violation_error, catalog_contract_violation_reason, catalog_handle_rejected_error, catalog_handle_rejection_reason, catalog_handle_type, catalog_invalid_request_error, catalog_invalid_request_field, catalog_malformed_card_error, catalog_malformed_card_reason, catalog_mcp_server_candidate, catalog_mcp_server_candidate_provenance, catalog_mcp_server_installability, catalog_media_type, catalog_negotiated_contract, catalog_negotiation_refused_error, catalog_negotiation_refused_reason, catalog_network_failure_error, catalog_network_failure_reason, catalog_not_installable_error, catalog_not_installable_reason, catalog_policy_rejected_error, catalog_search_request, catalog_search_result, catalog_search_succeeded, catalog_trust_eligibility, catalog_trust_provenance, catalog_trust_snapshot, catalog_trust_snapshot_absent, catalog_trust_snapshot_absent_status, catalog_trust_snapshot_current, catalog_trust_snapshot_current_status, catalog_trust_snapshot_downgraded, catalog_trust_snapshot_downgraded_status, catalog_trust_snapshot_malformed, catalog_trust_snapshot_malformed_status, catalog_trust_snapshot_revoked, catalog_trust_snapshot_revoked_status, catalog_trust_snapshot_schema_version, catalog_trust_snapshot_stale, catalog_trust_snapshot_stale_status, catalog_trust_snapshot_unsupported, catalog_trust_snapshot_unsupported_status, catalog_trust_source, catalog_trust_tier, catalog_unavailable_error, catalog_unavailable_reason, catalog_unavailable_transport_error, catalog_unavailable_transport_reason, catalog_unsafe_retrieval_error, catalog_unsafe_retrieval_reason, catalog_unsupported_kind_error, client_metadata, client_task_cancel_reason, client_task_cancel_request, client_task_cancel_result, command_list, commands_finalize_invocation_effect_request, commands_finalize_invocation_effect_result, commands_handle_pending_command_request, commands_handle_pending_command_result, commands_invocation_effect_outcome, commands_invocation_origin, commands_invoke_request, commands_list_request, commands_respond_to_queued_command_request, commands_respond_to_queued_command_result, completions_get_trigger_characters_result, completions_request_request, completions_request_result, configure_session_extensions_params, connect_client_info, connected_remote_session_metadata, connected_remote_session_metadata_kind, connected_remote_session_metadata_repository, connect_remote_session_params, connect_request, connect_result, content_exclusion_check_paths_request, content_exclusion_check_paths_result, content_exclusion_path_check, content_filter_mode, context_heaviest_message, copilot_api_token_auth_info, copilot_user_response, copilot_user_response_endpoints, copilot_user_response_quota_snapshots, copilot_user_response_quota_snapshots_chat, copilot_user_response_quota_snapshots_completions, copilot_user_response_quota_snapshots_premium_interactions, current_model, current_tool_metadata, debug_collect_logs_collected_entry, debug_collect_logs_destination, debug_collect_logs_entry, debug_collect_logs_entry_kind, debug_collect_logs_include, debug_collect_logs_redaction, debug_collect_logs_request, debug_collect_logs_result, debug_collect_logs_result_kind, debug_collect_logs_skipped_entry, debug_collect_logs_source, discovered_canvas, discovered_extension, discovered_extension_mode, discovered_extension_plugin, discovered_extensions, discovered_extensions_disable_request, discovered_extensions_enable_request, discovered_extension_source, discovered_hook, discovered_mcp_server, discovered_mcp_server_type, enqueue_command_params, enqueue_command_result, env_auth_info, event_log_read_request, event_log_release_interest_result, event_log_tail_result, event_log_types, events_agent_scope, events_cursor_status, events_read_direction, events_read_result, execute_command_params, execute_command_result, extension, extension_context_push_input, extension_launch_profile, extension_launch_provider_resolve_request, extension_launch_provider_resolve_result, extension_list, extensions_disable_request, extensions_enable_request, extension_source, extension_status, external_tool_result, external_tool_text_result_for_llm, external_tool_text_result_for_llm_binary_results_for_llm, external_tool_text_result_for_llm_binary_results_for_llm_type, external_tool_text_result_for_llm_content, external_tool_text_result_for_llm_content_audio, external_tool_text_result_for_llm_content_image, external_tool_text_result_for_llm_content_resource, external_tool_text_result_for_llm_content_resource_details, external_tool_text_result_for_llm_content_resource_link, external_tool_text_result_for_llm_content_resource_link_icon, external_tool_text_result_for_llm_content_resource_link_icon_theme, external_tool_text_result_for_llm_content_shell_exit, external_tool_text_result_for_llm_content_terminal, external_tool_text_result_for_llm_content_text, factory_abort_request, factory_ack_result, factory_agent_options, factory_agent_request, factory_agent_result, factory_agent_summary, factory_cancel_request, factory_current_phase, factory_declared_limits, factory_durable_operation, factory_execute_request, factory_execute_result, factory_get_run_progress_request, factory_get_run_request, factory_journal_get_request, factory_journal_get_result, factory_journal_put_request, factory_list_runs_request, factory_list_runs_result, factory_log_line, factory_log_line_kind, factory_log_request, factory_pause_checkpoint_action, factory_pause_checkpoint_request, factory_pause_checkpoint_result, factory_pause_info, factory_pause_request, factory_phase_observation, factory_phase_status, factory_progress_line, factory_progress_page, factory_resume_request, factory_resume_result, factory_run_consumed, factory_run_detail, factory_run_failure, factory_run_failure_kind, factory_run_limits, factory_run_request, factory_run_result, factory_run_status, factory_run_summary, factory_run_terminal, factory_tool_resume_request, factory_tool_run_options, factory_tool_run_request, filter_mapping, fleet_start_request, fleet_start_result, folder_trust_add_params, folder_trust_check_params, folder_trust_check_result, gh_cli_auth_info, git_hub_telemetry_client_info, git_hub_telemetry_event, git_hub_telemetry_notification, git_hub_token_acquire_reason, git_hub_token_acquire_request, git_hub_token_acquire_result, handle_pending_tool_call_request, handle_pending_tool_call_result, history_abort_manual_compaction_result, history_cancel_background_compaction_result, history_clear_context_request, history_clear_context_result, history_compact_context_window, history_compact_request, history_compact_result, history_file_restore_skip_reason, history_list_rewind_points_result, history_preview_rewind_request, history_preview_rewind_result, history_rewind_change_type, history_rewind_file_preview, history_rewind_mode, history_rewind_outcome, history_rewind_point, history_rewind_request, history_rewind_result, history_rewind_unavailable_reason, history_skipped_file_restore, history_summarize_for_handoff_result, history_truncate_request, history_truncate_result, hmac_auth_info, hook_invoke_request, hook_invoke_response, hook_origin, hooks_discover_request, hooks_discover_result, hook_type, installed_plugin, installed_plugin_info, installed_plugin_source, installed_plugin_source_git_hub, installed_plugin_source_local, installed_plugin_source_url, instruction_discovery_path, instruction_discovery_path_kind, instruction_discovery_path_list, instruction_discovery_path_location, instructions_discover_request, instructions_get_discovery_paths_request, instructions_get_sources_result, instruction_source, instruction_source_location, instruction_source_type, interrupt_main_turn_request, interrupt_main_turn_result, json_schema_response_format, llm_inference_headers, llm_inference_http_request_chunk_request, llm_inference_http_request_chunk_result, llm_inference_http_request_start_request, llm_inference_http_request_start_result, llm_inference_http_request_start_transport, llm_inference_http_response_chunk_error, llm_inference_http_response_chunk_request, llm_inference_http_response_chunk_result, llm_inference_http_response_start_request, llm_inference_http_response_start_result, llm_inference_set_provider_result, local_session_metadata_value, log_request, log_result, lsp_initialize_request, managed_mcp_server_config, managed_settings_read_result, marketplace_add_result, marketplace_browse_result, marketplace_info, marketplace_list_result, marketplace_plugin_info, marketplace_refresh_entry, marketplace_refresh_result, marketplace_remove_result, mcp_allowed_server, mcp_apps_call_tool_request, mcp_apps_diagnose_capability, mcp_apps_diagnose_request, mcp_apps_diagnose_result, mcp_apps_diagnose_server, mcp_apps_host_context, mcp_apps_host_context_details, mcp_apps_host_context_details_available_display_mode, mcp_apps_host_context_details_display_mode, mcp_apps_host_context_details_platform, mcp_apps_host_context_details_theme, mcp_apps_list_tools_request, mcp_apps_list_tools_result, mcp_apps_read_resource_request, mcp_apps_read_resource_result, mcp_apps_resource_content, mcp_apps_set_host_context_details, mcp_apps_set_host_context_details_available_display_mode, mcp_apps_set_host_context_details_display_mode, mcp_apps_set_host_context_details_platform, mcp_apps_set_host_context_details_theme, mcp_apps_set_host_context_request, mcp_cancel_sampling_execution_params, mcp_cancel_sampling_execution_result, mcp_config_add_request, mcp_config_disable_request, mcp_config_enable_request, mcp_config_list, mcp_config_remove_request, mcp_config_update_request, mcp_configure_git_hub_request, mcp_configure_git_hub_result, mcp_disable_request, mcp_discover_request, mcp_discover_result, mcp_elicitation_form_mode, mcp_enable_request, mcp_execute_sampling_params, mcp_execute_sampling_request, mcp_execute_sampling_result, mcp_failed_server, mcp_filtered_server, mcp_headers_handle_pending_headers_refresh_request, mcp_headers_handle_pending_headers_refresh_request_request, mcp_headers_handle_pending_headers_refresh_request_result, mcp_host_state, mcp_install_plan, mcp_is_server_running_request, mcp_is_server_running_result, mcp_list_tools_request, mcp_list_tools_result, mcp_oauth_authentication_state_changed_request, mcp_oauth_handle_pending_request, mcp_oauth_handle_pending_result, mcp_oauth_login_grant_type, mcp_oauth_login_request, mcp_oauth_login_result, mcp_oauth_pending_request_response, mcp_oauth_probe_needs_auth_reason, mcp_oauth_probe_request, mcp_oauth_probe_result, mcp_oauth_respond_request, mcp_oauth_respond_result, mcp_plan_configuration_change, mcp_plan_configuration_operation, mcp_plan_enum_value_type, mcp_plan_install_planned, mcp_plan_install_request, mcp_plan_install_result, mcp_plan_install_source, mcp_plan_install_source_candidate, mcp_plan_install_source_candidate_kind, mcp_plan_install_source_card, mcp_plan_install_source_card_kind, mcp_plan_package_install_method, mcp_plan_package_transport, mcp_plan_policy_decision, mcp_plan_policy_result, mcp_plan_policy_source, mcp_plan_provenance, mcp_plan_remote_install_method, mcp_plan_remote_transport, mcp_plan_required_value, mcp_plan_required_value_enum, mcp_plan_required_value_enum_kind, mcp_plan_required_value_scalar, mcp_plan_required_value_scalar_kind, mcp_plan_resource_identity, mcp_plan_scalar_value_type, mcp_plan_scope, mcp_plan_secret_placeholder, mcp_plan_secret_reference, mcp_plan_target, mcp_plan_transport_choice, mcp_plan_transport_choice_package, mcp_plan_transport_choice_remote, mcp_plan_value_category, mcp_register_external_client_request, mcp_reload_config, mcp_reload_with_config_request, mcp_remove_git_hub_result, mcp_resource, mcp_resource_annotations, mcp_resource_content, mcp_resource_icon, mcp_resources_list_request, mcp_resources_list_result, mcp_resources_list_templates_request, mcp_resources_list_templates_result, mcp_resources_read_request, mcp_resources_read_result, mcp_resource_template, mcp_restart_server_request, mcp_safe_for_telemetry, mcp_safe_for_telemetry_fields, mcp_sampling_execution_action, mcp_sampling_execution_result, mcp_serializable_server_config, mcp_server, mcp_server_auth_config, mcp_server_auth_config_redirect_port, mcp_server_card_embedded, mcp_server_card_embedded_kind, mcp_server_card_media_type, mcp_server_card_reference, mcp_server_card_url, mcp_server_card_url_kind, mcp_server_config, mcp_server_config_defer_tools, mcp_server_config_http, mcp_server_config_http_oauth_grant_type, mcp_server_config_http_type, mcp_server_config_memory, mcp_server_config_memory_type, mcp_server_config_stdio, mcp_server_config_stdio_type, mcp_server_failure_info, mcp_server_list, mcp_server_needs_auth_info, mcp_set_env_value_mode_details, mcp_set_env_value_mode_params, mcp_set_env_value_mode_result, mcp_source_file, mcp_source_plugin, mcp_source_ref, mcp_start_server_request, mcp_start_servers_result, mcp_stop_server_request, mcp_task_metadata, mcp_tools, mcp_tool_ui, mcp_tool_ui_visibility, mcp_unregister_external_client_request, memory_configuration, metadata_context_attribution_result, metadata_context_heaviest_messages_request, metadata_context_heaviest_messages_result, metadata_context_info_request, metadata_context_info_result, metadata_is_processing_result, metadata_recompute_context_tokens_request, metadata_recompute_context_tokens_result, metadata_record_context_change_request, metadata_record_context_change_result, metadata_set_working_directory_request, metadata_set_working_directory_result, metadata_snapshot_current_mode, metadata_snapshot_remote_metadata, metadata_snapshot_remote_metadata_repository, metadata_snapshot_remote_metadata_task_type, metadata_update_client_metadata_request, model, model_apply_startup_overlay_request, model_billing, model_billing_promo, model_billing_token_prices, model_billing_token_prices_long_context, model_capabilities, model_capabilities_limits, model_capabilities_limits_vision, model_capabilities_override, model_capabilities_override_limits, model_capabilities_override_limits_vision, model_capabilities_override_supports, model_capabilities_supports, model_list, model_list_request, model_message, model_picker_category, model_picker_persistence_request, model_picker_price_category, model_picker_settings_context, model_policy, model_policy_state, model_set_allowed_models_request, model_set_allowed_models_result, model_set_reasoning_effort_request, model_set_reasoning_effort_result, models_list_request, model_switch_auto_tier_request, model_switch_auto_tier_result, model_switch_auto_tier_status, model_switch_confirmation, model_switch_to_request, model_switch_to_result, model_warning_text, mode_set_request, mode_set_result, move_mcp_loading_to_background_result, named_provider_config, name_get_result, name_set_auto_request, name_set_auto_result, name_set_request, open_canvas_instance, options_update_additional_content_exclusion_policy, options_update_additional_content_exclusion_policy_rule, options_update_additional_content_exclusion_policy_rule_source, options_update_additional_content_exclusion_policy_scope, options_update_context_tier, options_update_env_value_mode, options_update_reasoning_summary, options_update_tool_filter_precedence, pending_permission_request, pending_permission_request_list, permission_decision, permission_decision_approved, permission_decision_approved_for_location, permission_decision_approved_for_session, permission_decision_approve_for_location, permission_decision_approve_for_location_approval, permission_decision_approve_for_location_approval_commands, permission_decision_approve_for_location_approval_custom_tool, permission_decision_approve_for_location_approval_extension_env_access, permission_decision_approve_for_location_approval_extension_management, permission_decision_approve_for_location_approval_extension_permission_access, permission_decision_approve_for_location_approval_factory, permission_decision_approve_for_location_approval_mcp, permission_decision_approve_for_location_approval_mcp_sampling, permission_decision_approve_for_location_approval_memory, permission_decision_approve_for_location_approval_read, permission_decision_approve_for_location_approval_write, permission_decision_approve_for_session, permission_decision_approve_for_session_approval, permission_decision_approve_for_session_approval_commands, permission_decision_approve_for_session_approval_custom_tool, permission_decision_approve_for_session_approval_extension_env_access, permission_decision_approve_for_session_approval_extension_management, permission_decision_approve_for_session_approval_extension_permission_access, permission_decision_approve_for_session_approval_factory, permission_decision_approve_for_session_approval_mcp, permission_decision_approve_for_session_approval_mcp_sampling, permission_decision_approve_for_session_approval_memory, permission_decision_approve_for_session_approval_read, permission_decision_approve_for_session_approval_write, permission_decision_approve_once, permission_decision_approve_permanently, permission_decision_cancelled, permission_decision_context, permission_decision_denied_by_content_exclusion_policy, permission_decision_denied_by_permission_request_hook, permission_decision_denied_by_rules, permission_decision_denied_interactively_by_user, permission_decision_denied_no_approval_rule_and_could_not_request_from_user, permission_decision_outcome, permission_decision_reject, permission_decision_request, permission_decision_surface, permission_decision_user_not_available, permission_location_add_tool_approval_params, permission_location_apply_params, permission_location_apply_result, permission_location_resolve_params, permission_location_resolve_result, permission_location_type, permission_mode_source, permission_paths_add_params, permission_paths_allowed_check_params, permission_paths_allowed_check_result, permission_paths_config, permission_paths_list, permission_paths_update_primary_params, permission_paths_workspace_check_params, permission_paths_workspace_check_result, permission_prompt_shown_notification, permission_request_result, permission_response_capability, permission_rules_set, permissions_configure_additional_content_exclusion_policy, permissions_configure_additional_content_exclusion_policy_rule, permissions_configure_additional_content_exclusion_policy_rule_source, permissions_configure_additional_content_exclusion_policy_scope, permissions_configure_params, permissions_configure_result, permissions_folder_trust_add_trusted_result, permissions_get_mode_request, permissions_get_mode_result, permissions_locations_add_tool_approval_details, permissions_locations_add_tool_approval_details_commands, permissions_locations_add_tool_approval_details_custom_tool, permissions_locations_add_tool_approval_details_extension_env_access, permissions_locations_add_tool_approval_details_extension_management, permissions_locations_add_tool_approval_details_extension_permission_access, permissions_locations_add_tool_approval_details_factory, permissions_locations_add_tool_approval_details_mcp, permissions_locations_add_tool_approval_details_mcp_sampling, permissions_locations_add_tool_approval_details_memory, permissions_locations_add_tool_approval_details_read, permissions_locations_add_tool_approval_details_write, permissions_locations_add_tool_approval_result, permissions_modify_rules_params, permissions_modify_rules_result, permissions_modify_rules_scope, permissions_notify_prompt_shown_result, permissions_paths_add_result, permissions_paths_list_request, permissions_paths_update_primary_result, permissions_pending_requests_request, permissions_reset_session_approvals_request, permissions_reset_session_approvals_result, permissions_set_approve_all_request, permissions_set_approve_all_result, permissions_set_approve_all_source, permissions_set_mode_request, permissions_set_mode_result, permissions_set_required_request, permissions_set_required_result, permissions_urls_set_unrestricted_mode_result, permission_urls_config, permission_urls_set_unrestricted_mode_params, ping_request, ping_result, plan_read_result, plan_read_sql_todos_result, plan_read_sql_todos_with_dependencies_result, plan_sql_todo_dependency, plan_sql_todos_row, plan_update_request, plugin, plugin_install_result, plugin_install_staging_mode, plugin_list, plugin_list_result, plugins_builtin_set_request, plugins_disable_request, plugins_enable_request, plugins_install_request, plugins_marketplaces_add_request, plugins_marketplaces_browse_request, plugins_marketplaces_refresh_request, plugins_marketplaces_remove_request, plugins_reload_request, plugins_uninstall_request, plugins_update_request, plugin_update_all_entry, plugin_update_all_result, plugin_update_result, protocol_append_mode, protocol_customize_mode, protocol_external_tool_defer, protocol_external_tool_definition, protocol_marker_section_override, protocol_replace_mode, protocol_section_override, protocol_static_section_action, protocol_static_section_override, protocol_system_message_append_config, protocol_system_message_config, protocol_system_message_customize_config, protocol_system_message_replace_config, provider_add_request, provider_add_result, provider_config, provider_config_azure, provider_config_transport, provider_config_type, provider_config_wire_api, provider_endpoint, provider_endpoint_transport, provider_endpoint_type, provider_endpoint_wire_api, provider_get_endpoint_request, provider_model_config, provider_session_token, provider_token_acquire_request, provider_token_acquire_result, push_attachment, push_attachment_blob, push_attachment_directory, push_attachment_file, push_attachment_file_line_range, push_attachment_git_hub_actions_job, push_attachment_git_hub_commit, push_attachment_git_hub_file, push_attachment_git_hub_file_diff, push_attachment_git_hub_file_diff_side, push_attachment_git_hub_reference, push_attachment_git_hub_reference_type, push_attachment_git_hub_release, push_attachment_git_hub_repository, push_attachment_git_hub_snippet, push_attachment_git_hub_tree_comparison, push_attachment_git_hub_tree_comparison_side, push_attachment_git_hub_url, push_attachment_selection, push_attachment_selection_details, push_attachment_selection_details_end, push_attachment_selection_details_start, push_git_hub_repo_ref, queue_begin_deferred_idle_drain_request, queue_begin_deferred_idle_drain_result, queue_consume_system_notifications_request, queued_command_handled, queued_command_not_handled, queued_command_result, queue_defer_session_idle_request, queue_duplicate_at_request, queue_duplicate_at_result, queue_enqueue_resume_pending_result, queue_finish_deferred_idle_drain_request, queue_finish_deferred_idle_drain_result, queue_has_pending_result, queue_insert_at_request, queue_insert_at_result, queue_insert_message, queue_move_item_request, queue_move_item_result, queue_pending_items, queue_pending_items_kind, queue_pending_items_result, queue_remove_at_request, queue_remove_at_result, queue_remove_most_recent_result, queue_send_now_request, queue_send_now_result, queue_set_drain_paused_request, queue_snapshot_result, queue_update_text_request, queue_update_text_result, register_event_interest_params, register_event_interest_result, release_event_interest_params, remote_control_config, remote_control_config_existing_mc_session, remote_control_status, remote_control_status_active, remote_control_status_connecting, remote_control_status_error, remote_control_status_off, remote_control_status_result, remote_control_stop_result, remote_control_transfer_result, remote_enable_request, remote_enable_result, remote_notify_steerable_changed_request, remote_notify_steerable_changed_result, remote_session_connection_result, remote_session_host_status, remote_session_metadata_repository, remote_session_metadata_task_type, remote_session_metadata_value, remote_session_mode, remote_session_repository, response_format, run_options, sandbox_config, sandbox_config_auth, sandbox_config_source, sandbox_config_user_policy, sandbox_config_user_policy_experimental, sandbox_config_user_policy_experimental_seatbelt, sandbox_config_user_policy_filesystem, sandbox_config_user_policy_network, sandbox_config_user_policy_network_proxy, sandbox_config_user_policy_seatbelt, sandbox_disable_for_session_request, sandbox_disable_for_session_result, sandbox_enforcement_status, sandbox_session_change, schedule_add_at_request, schedule_add_cron_request, schedule_add_request, schedule_add_result, schedule_add_self_paced_request, schedule_entry, schedule_has_self_paced_result, schedule_list, schedule_rearm_self_paced_request, schedule_stop_request, schedule_stop_result, secrets_add_filter_values_request, secrets_add_filter_values_result, send_agent_mode, send_attachments_to_message_params, send_message_item, send_messages_request, send_messages_result, send_mode, send_request, send_result, send_system_notification_request, server_agent_list, server_instruction_source_list, server_skill, server_skill_list, session_activity, session_agent_list_request, session_auth_login_request, session_auth_logout_user_request, session_auth_status, session_auth_switch_request, session_bulk_delete_result, session_cancel_all_background_agents_result, session_capability, session_commands_list_request, session_completion_item, session_context, session_context_host_type, session_enrich_metadata_result, session_factory_pause_at_checkpoint_result, session_fs_append_file_request, session_fs_error, session_fs_error_code, session_fs_exists_request, session_fs_exists_result, session_fs_mkdir_request, session_fs_readdir_request, session_fs_readdir_result, session_fs_readdir_with_types_entry, session_fs_readdir_with_types_entry_type, session_fs_readdir_with_types_request, session_fs_readdir_with_types_result, session_fs_read_file_request, session_fs_read_file_result, session_fs_rename_request, session_fs_rm_request, session_fs_set_provider_capabilities, session_fs_set_provider_conventions, session_fs_set_provider_request, session_fs_set_provider_result, session_fs_sqlite_exists_request, session_fs_sqlite_exists_result, session_fs_sqlite_query_request, session_fs_sqlite_query_result, session_fs_sqlite_query_type, session_fs_sqlite_transaction_error, session_fs_sqlite_transaction_error_class, session_fs_sqlite_transaction_request, session_fs_sqlite_transaction_result, session_fs_sqlite_transaction_statement, session_fs_stat_request, session_fs_stat_result, session_fs_write_file_request, session_git_hub_auth_get_all_auth_available_result, session_git_hub_auth_logout_result, session_git_hub_auth_logout_user_result, session_history_compact_request, session_installed_plugin, session_installed_plugin_source, session_installed_plugin_source_git_hub, session_installed_plugin_source_local, session_installed_plugin_source_url, session_limit_prediction_baseline_data, session_limit_prediction_client_type, session_limit_prediction_details, session_limit_prediction_predict_request, session_limit_prediction_request, session_limit_prediction_result, session_limit_prediction_source, session_limit_prediction_tier, session_limit_prediction_tier_option, session_limit_prediction_unavailable_reason, session_list, session_list_entry, session_list_filter, session_load_deferred_repo_hooks_result, session_log_level, session_managed_permissions, session_managed_settings, session_mcp_apps_call_tool_result, session_metadata_snapshot, session_mode, session_model_list, session_model_list_request, session_model_price_category, session_open_options, session_open_options_additional_content_exclusion_policy, session_open_options_additional_content_exclusion_policy_rule, session_open_options_additional_content_exclusion_policy_rule_source, session_open_options_additional_content_exclusion_policy_scope, session_open_options_env_value_mode, session_open_options_reasoning_summary, session_open_params, session_open_result, session_plugins_reload_request, session_provider_get_endpoint_request, session_prune_result, sessions_bulk_delete_request, sessions_check_in_use_request, sessions_check_in_use_result, sessions_client_metadata_entry, sessions_close_request, sessions_close_result, sessions_delete_request, sessions_enrich_metadata_request, session_set_credentials_params, session_set_credentials_result, session_settings_built_in_tool_availability_snapshot, session_settings_evaluate_predicate_request, session_settings_evaluate_predicate_result, session_settings_job_snapshot, session_settings_model_snapshot, session_settings_online_evaluation_snapshot, session_settings_predicate_name, session_settings_repo_snapshot, session_settings_snapshot, session_settings_validation_snapshot, sessions_find_by_prefix_request, sessions_find_by_prefix_result, sessions_find_by_task_id_request, sessions_find_by_task_id_result, sessions_fork_request, sessions_fork_result, sessions_get_board_entry_count_request, sessions_get_board_entry_count_result, sessions_get_client_metadata_request, sessions_get_client_metadata_result, sessions_get_event_file_path_request, sessions_get_event_file_path_result, sessions_get_last_for_context_request, sessions_get_last_for_context_result, sessions_get_metadata_request, sessions_get_metadata_result, sessions_get_persisted_remote_steerable_request, sessions_get_persisted_remote_steerable_result, session_sizes, sessions_list_non_empty_session_ids_request, sessions_list_non_empty_session_ids_result, sessions_list_request, sessions_load_deferred_repo_hooks_request, sessions_open_attach, sessions_open_cloud, sessions_open_create, sessions_open_handoff, sessions_open_handoff_task_type, sessions_open_progress, sessions_open_progress_status, sessions_open_progress_step, sessions_open_remote, sessions_open_resume, sessions_open_resume_last, sessions_open_status, session_source, sessions_prune_old_request, sessions_read_persisted_events_request, sessions_release_lock_request, sessions_release_lock_result, sessions_reload_plugin_hooks_request, sessions_reload_plugin_hooks_result, sessions_save_request, sessions_save_result, sessions_set_additional_plugins_request, sessions_set_additional_plugins_result, sessions_set_remote_control_steering_request, sessions_start_remote_control_request, sessions_stop_remote_control_request, sessions_transfer_remote_control_request, session_telemetry_engagement, session_update_options_params, session_update_options_result, session_visibility_status, session_working_directory_context, session_working_directory_context_host_type, settable_auth_info, settable_token_auth_info, shell_cancel_user_requested_request, shell_credentials, shell_exec_request, shell_exec_result, shell_execute_user_requested_request, shell_init_profile, shell_init_script, shell_init_script_shell, shell_kill_request, shell_kill_result, shell_kill_signal, shell_options, shutdown_request, skill, skill_discovery_path, skill_discovery_path_list, skill_discovery_scope, skill_list, skill_provider_descriptor, skill_provider_list_request, skill_provider_list_result, skill_provider_read_request, skill_provider_read_result, skills_config_set_disabled_skills_request, skills_config_set_skill_disabled_request, skills_disable_request, skills_discover_request, skills_enable_request, skills_get_discovery_paths_request, skills_get_invoked_result, skills_invoked_skill, skills_load_diagnostics, slash_command_add_timeline_entry_result, slash_command_agent_prompt_result, slash_command_completed_result, slash_command_info, slash_command_input, slash_command_input_choice, slash_command_input_completion, slash_command_invocation_result, slash_command_kind, slash_command_model_picker_dialog, slash_command_select_subcommand_option, slash_command_select_subcommand_result, slash_command_set_model_result, slash_command_set_plan_model_result, slash_command_show_dialog_result, slash_command_text_result, slash_command_timeline_entry, subagent_settings_entry, subagent_settings_entry_context_tier, system_message_block, task_agent_info, task_agent_progress, task_client_active_status, task_client_execution_mode, task_client_info, task_client_owner, task_client_owner_kind, task_client_owner_presence, task_client_progress, task_client_status, task_client_type, task_client_update, task_complete_data, task_completion_decision, task_execution_mode, task_info, task_kind, task_list, task_progress_line, tasks_cancel_request, tasks_cancel_result, tasks_get_current_promotable_result, tasks_get_progress_request, tasks_get_progress_result, task_shell_info, task_shell_info_attachment_mode, task_shell_progress, tasks_promote_current_to_background_result, tasks_promote_to_background_request, tasks_promote_to_background_result, tasks_refresh_result, tasks_register_request, tasks_register_result, tasks_remove_request, tasks_remove_result, tasks_send_message_request, tasks_send_message_result, tasks_start_agent_request, tasks_start_agent_result, task_status, tasks_update_request, tasks_update_result, tasks_wait_for_pending_result, telemetry_set_feature_overrides_request, token_auth_info, token_provider_auth_info, tool, tool_list, tool_result, tool_result_expanded, tool_result_new_message, tool_result_type, tools_execute_request, tools_get_builtin_descriptors_request, tools_get_builtin_descriptors_result, tools_get_current_metadata_result, tools_initialize_and_validate_result, tools_list_request, tools_set_request, tools_set_result, tools_shell_descriptor_config, tools_task_complete_event_data_request, tools_update_subagent_settings_result, ui_auto_mode_switch_response, ui_elicitation_array_any_of_field, ui_elicitation_array_any_of_field_items, ui_elicitation_array_any_of_field_items_any_of, ui_elicitation_array_enum_field, ui_elicitation_array_enum_field_items, ui_elicitation_field_value, ui_elicitation_request, ui_elicitation_response, ui_elicitation_response_action, ui_elicitation_response_content, ui_elicitation_result, ui_elicitation_schema, ui_elicitation_schema_property, ui_elicitation_schema_property_boolean, ui_elicitation_schema_property_number, ui_elicitation_schema_property_number_type, ui_elicitation_schema_property_string, ui_elicitation_schema_property_string_format, ui_elicitation_string_enum_field, ui_elicitation_string_one_of_field, ui_elicitation_string_one_of_field_one_of, ui_ephemeral_query_request, ui_ephemeral_query_result, ui_exit_plan_mode_action, ui_exit_plan_mode_response, ui_handle_pending_auto_mode_switch_request, ui_handle_pending_elicitation_request, ui_handle_pending_exit_plan_mode_request, ui_handle_pending_result, ui_handle_pending_sampling_request, ui_handle_pending_sampling_response, ui_handle_pending_session_limits_exhausted_request, ui_handle_pending_user_input_request, ui_register_direct_auto_mode_switch_handler_result, ui_session_limits_exhausted_response, ui_session_limits_exhausted_response_action, ui_unregister_direct_auto_mode_switch_handler_request, ui_unregister_direct_auto_mode_switch_handler_result, ui_user_input_response, update_subagent_settings_request, usage_get_metrics_result, usage_metrics_agent_metric, usage_metrics_code_changes, usage_metrics_model_metric, usage_metrics_model_metric_requests, usage_metrics_model_metric_token_detail, usage_metrics_model_metric_usage, usage_metrics_token_detail, user_auth_info, user_requested_shell_command_result, user_setting_metadata, user_settings_get_result, user_settings_set_request, user_settings_set_result, visibility_get_result, visibility_set_request, visibility_set_result, workspace_diff_file_change, workspace_diff_file_change_type, workspace_diff_mode, workspace_diff_result, workspaces_add_summary_request, workspaces_add_summary_result, workspaces_autopilot_objective_exists_result, workspaces_checkpoints, workspaces_create_directory_request, workspaces_create_file_request, workspaces_delete_autopilot_objective_result, workspaces_diff_request, workspaces_ensure_request, workspaces_get_workspace_result, workspaces_list_checkpoints_result, workspaces_list_files_result, workspaces_read_autopilot_objective_result, workspaces_read_checkpoint_request, workspaces_read_checkpoint_result, workspaces_read_file_request, workspaces_read_file_result, workspaces_remove_path_request, workspaces_rename_path_request, workspaces_save_large_paste_request, workspaces_save_large_paste_result, workspaces_stat_file_request, workspaces_stat_file_result, workspaces_truncate_summaries_request, workspace_summary_host_type, workspaces_update_metadata_request, workspaces_workspace_details_host_type, workspaces_write_autopilot_objective_request, workspaces_write_autopilot_objective_result, session_auth_info_result, session_context_attribution, session_context_info, subagent_settings, task_progress, workspace_summary) + return RPC(abort_request, abort_result, account_all_users, account_get_all_users_result, account_get_current_auth_result, account_get_quota_request, account_get_quota_result, account_login_request, account_login_result, account_logout_request, account_logout_result, account_quota_snapshot, adaptive_thinking_support, agent_discovery_path, agent_discovery_path_list, agent_discovery_path_scope, agent_get_current_result, agent_info, agent_info_source, agent_list, agent_list_request, agent_registry_live_target_entry, agent_registry_live_target_entry_attention_kind, agent_registry_live_target_entry_kind, agent_registry_live_target_entry_last_terminal_event, agent_registry_live_target_entry_status, agent_registry_log_capture, agent_registry_log_capture_open_error_reason, agent_registry_spawn_error, agent_registry_spawn_permission_mode, agent_registry_spawn_registry_timeout, agent_registry_spawn_request, agent_registry_spawn_result, agent_registry_spawn_spawned, agent_registry_spawn_validation_error, agent_registry_spawn_validation_error_field, agent_registry_spawn_validation_error_reason, agent_reload_result, agents_discover_request, agent_select_request, agent_select_result, agent_set_prompt_request, agents_get_discovery_paths_request, api_key_auth_info, auth_identity, auth_info, auth_info_type, auth_validation_error, auth_validation_errors, autopilot_objective_credit_limit, autopilot_objective_get_state_result, autopilot_objective_state, autopilot_objective_status, built_in_model_catalog, built_in_model_catalog_entry, builtin_tool_descriptor, builtin_tool_format, builtin_tool_format_type, builtin_tool_input_schema, builtin_tool_input_schema_type, builtin_tool_safe_for_telemetry, builtin_tool_safe_telemetry_fields, cancel_user_requested_shell_command_result, canvas_action, canvas_action_invoke_request, canvas_action_invoke_result, canvas_close_request, canvas_host_context, canvas_host_context_capabilities, canvas_json_schema, canvas_list, canvas_list_open_result, canvas_open_request, canvas_provider_close_request, canvas_provider_invoke_action_request, canvas_provider_open_request, canvas_provider_open_result, canvas_provider_register_request, canvas_provider_unregister_request, canvas_session_context, capi_session_options, card_digest, card_digest_algorithm, card_digest_value, catalog_agent_plugin_candidate, catalog_agent_plugin_candidate_kind, catalog_agent_plugin_candidate_provenance, catalog_agent_plugin_compatibility_tag, catalog_agent_plugin_media_type, catalog_ai_skill_candidate, catalog_ai_skill_candidate_kind, catalog_ai_skill_candidate_provenance, catalog_ai_skill_installability, catalog_ai_skill_media_type, catalog_authentication_required_error, catalog_authentication_required_reason, catalog_candidate, catalog_candidate_kind, catalog_candidate_source, catalog_candidate_source_embedded, catalog_candidate_source_url, catalog_capability, catalog_capability_id, catalog_client_contract, catalog_contract_violation_error, catalog_contract_violation_reason, catalog_handle_rejected_error, catalog_handle_rejection_reason, catalog_handle_type, catalog_invalid_request_error, catalog_invalid_request_field, catalog_malformed_card_error, catalog_malformed_card_reason, catalog_mcp_server_candidate, catalog_mcp_server_candidate_kind, catalog_mcp_server_candidate_provenance, catalog_mcp_server_installability, catalog_media_type, catalog_negotiated_contract, catalog_negotiation_refused_error, catalog_negotiation_refused_reason, catalog_network_failure_error, catalog_network_failure_reason, catalog_not_installable_error, catalog_not_installable_reason, catalog_plugin_repository_source, catalog_policy_rejected_error, catalog_resource_identity, catalog_resource_version, catalog_search_page, catalog_search_pagination, catalog_search_request, catalog_search_result, catalog_search_succeeded, catalog_search_total_count_relation, catalog_selection_cancelled, catalog_selection_decision, catalog_selection_declined, catalog_selection_foreign, catalog_selection_invalid, catalog_selection_replayed, catalog_selection_request, catalog_selection_result, catalog_selection_selected, catalog_selection_stale, catalog_selection_timed_out, catalog_selection_wrong_kind, catalog_trust_eligibility, catalog_trust_provenance, catalog_trust_snapshot, catalog_trust_snapshot_absent, catalog_trust_snapshot_absent_status, catalog_trust_snapshot_current, catalog_trust_snapshot_current_status, catalog_trust_snapshot_downgraded, catalog_trust_snapshot_downgraded_status, catalog_trust_snapshot_malformed, catalog_trust_snapshot_malformed_status, catalog_trust_snapshot_revoked, catalog_trust_snapshot_revoked_status, catalog_trust_snapshot_schema_version, catalog_trust_snapshot_stale, catalog_trust_snapshot_stale_status, catalog_trust_snapshot_unsupported, catalog_trust_snapshot_unsupported_status, catalog_trust_source, catalog_trust_tier, catalog_unavailable_error, catalog_unavailable_reason, catalog_unavailable_transport_error, catalog_unavailable_transport_reason, catalog_unsafe_retrieval_error, catalog_unsafe_retrieval_reason, catalog_unsupported_kind_error, client_metadata, client_task_cancel_reason, client_task_cancel_request, client_task_cancel_result, command_list, commands_finalize_invocation_effect_request, commands_finalize_invocation_effect_result, commands_handle_pending_command_request, commands_handle_pending_command_result, commands_invocation_effect_outcome, commands_invocation_origin, commands_invoke_request, commands_list_request, commands_respond_to_queued_command_request, commands_respond_to_queued_command_result, completions_get_trigger_characters_result, completions_request_request, completions_request_result, configure_session_extensions_params, connect_client_info, connected_remote_session_metadata, connected_remote_session_metadata_kind, connected_remote_session_metadata_repository, connect_remote_session_params, connect_request, connect_result, content_exclusion_check_paths_request, content_exclusion_check_paths_result, content_exclusion_path_check, content_filter_mode, context_heaviest_message, copilot_api_token_auth_info, copilot_user_response, copilot_user_response_endpoints, copilot_user_response_quota_snapshots, copilot_user_response_quota_snapshots_chat, copilot_user_response_quota_snapshots_completions, copilot_user_response_quota_snapshots_premium_interactions, current_model, current_tool_metadata, debug_collect_logs_collected_entry, debug_collect_logs_destination, debug_collect_logs_entry, debug_collect_logs_entry_kind, debug_collect_logs_include, debug_collect_logs_redaction, debug_collect_logs_request, debug_collect_logs_result, debug_collect_logs_result_kind, debug_collect_logs_skipped_entry, debug_collect_logs_source, discovered_canvas, discovered_extension, discovered_extension_mode, discovered_extension_plugin, discovered_extensions, discovered_extensions_disable_request, discovered_extensions_enable_request, discovered_extension_source, discovered_hook, discovered_mcp_server, discovered_mcp_server_type, enqueue_command_params, enqueue_command_result, env_auth_info, event_log_read_request, event_log_release_interest_result, event_log_tail_result, event_log_types, events_agent_scope, events_cursor_status, events_read_direction, events_read_result, execute_command_params, execute_command_result, extension, extension_context_push_input, extension_launch_profile, extension_launch_provider_resolve_request, extension_launch_provider_resolve_result, extension_list, extensions_disable_request, extensions_enable_request, extension_source, extension_status, external_tool_result, external_tool_text_result_for_llm, external_tool_text_result_for_llm_binary_results_for_llm, external_tool_text_result_for_llm_binary_results_for_llm_type, external_tool_text_result_for_llm_content, external_tool_text_result_for_llm_content_audio, external_tool_text_result_for_llm_content_image, external_tool_text_result_for_llm_content_resource, external_tool_text_result_for_llm_content_resource_details, external_tool_text_result_for_llm_content_resource_link, external_tool_text_result_for_llm_content_resource_link_icon, external_tool_text_result_for_llm_content_resource_link_icon_theme, external_tool_text_result_for_llm_content_shell_exit, external_tool_text_result_for_llm_content_terminal, external_tool_text_result_for_llm_content_text, factory_abort_request, factory_ack_result, factory_agent_options, factory_agent_request, factory_agent_result, factory_agent_summary, factory_cancel_request, factory_current_phase, factory_declared_limits, factory_durable_operation, factory_execute_request, factory_execute_result, factory_get_run_progress_request, factory_get_run_request, factory_journal_get_request, factory_journal_get_result, factory_journal_put_request, factory_list_runs_request, factory_list_runs_result, factory_log_line, factory_log_line_kind, factory_log_request, factory_pause_checkpoint_action, factory_pause_checkpoint_request, factory_pause_checkpoint_result, factory_pause_info, factory_pause_request, factory_phase_observation, factory_phase_status, factory_progress_line, factory_progress_page, factory_resume_request, factory_resume_result, factory_run_consumed, factory_run_detail, factory_run_failure, factory_run_failure_kind, factory_run_limits, factory_run_request, factory_run_result, factory_run_status, factory_run_summary, factory_run_terminal, factory_tool_resume_request, factory_tool_run_options, factory_tool_run_request, filter_mapping, fleet_start_request, fleet_start_result, folder_trust_add_params, folder_trust_check_params, folder_trust_check_result, gh_cli_auth_info, git_hub_telemetry_client_info, git_hub_telemetry_event, git_hub_telemetry_notification, git_hub_token_acquire_reason, git_hub_token_acquire_request, git_hub_token_acquire_result, handle_pending_tool_call_request, handle_pending_tool_call_result, history_abort_manual_compaction_result, history_cancel_background_compaction_result, history_clear_context_request, history_clear_context_result, history_compact_context_window, history_compact_request, history_compact_result, history_file_restore_skip_reason, history_list_rewind_points_result, history_preview_rewind_request, history_preview_rewind_result, history_rewind_change_type, history_rewind_file_preview, history_rewind_mode, history_rewind_outcome, history_rewind_point, history_rewind_request, history_rewind_result, history_rewind_unavailable_reason, history_skipped_file_restore, history_summarize_for_handoff_result, history_truncate_request, history_truncate_result, hmac_auth_info, hook_invoke_request, hook_invoke_response, hook_origin, hooks_discover_request, hooks_discover_result, hook_type, installed_plugin, installed_plugin_info, installed_plugin_source, installed_plugin_source_git_hub, installed_plugin_source_local, installed_plugin_source_url, instruction_discovery_path, instruction_discovery_path_kind, instruction_discovery_path_list, instruction_discovery_path_location, instructions_discover_request, instructions_get_discovery_paths_request, instructions_get_sources_result, instruction_source, instruction_source_location, instruction_source_type, interrupt_main_turn_request, interrupt_main_turn_result, json_schema_response_format, llm_inference_headers, llm_inference_http_request_chunk_request, llm_inference_http_request_chunk_result, llm_inference_http_request_start_request, llm_inference_http_request_start_result, llm_inference_http_request_start_transport, llm_inference_http_response_chunk_error, llm_inference_http_response_chunk_request, llm_inference_http_response_chunk_result, llm_inference_http_response_start_request, llm_inference_http_response_start_result, llm_inference_set_provider_result, local_session_metadata_value, log_request, log_result, lsp_initialize_request, managed_mcp_server_config, managed_settings_read_result, managed_settings_resolved_data, marketplace_add_result, marketplace_browse_result, marketplace_info, marketplace_list_result, marketplace_plugin_info, marketplace_refresh_entry, marketplace_refresh_result, marketplace_remove_result, mcp_allowed_server, mcp_apps_call_tool_request, mcp_apps_diagnose_capability, mcp_apps_diagnose_request, mcp_apps_diagnose_result, mcp_apps_diagnose_server, mcp_apps_host_context, mcp_apps_host_context_details, mcp_apps_host_context_details_available_display_mode, mcp_apps_host_context_details_display_mode, mcp_apps_host_context_details_platform, mcp_apps_host_context_details_theme, mcp_apps_list_tools_request, mcp_apps_list_tools_result, mcp_apps_read_resource_request, mcp_apps_read_resource_result, mcp_apps_resource_content, mcp_apps_set_host_context_details, mcp_apps_set_host_context_details_available_display_mode, mcp_apps_set_host_context_details_display_mode, mcp_apps_set_host_context_details_platform, mcp_apps_set_host_context_details_theme, mcp_apps_set_host_context_request, mcp_cancel_sampling_execution_params, mcp_cancel_sampling_execution_result, mcp_config_add_request, mcp_config_disable_request, mcp_config_enable_request, mcp_config_list, mcp_config_remove_request, mcp_config_update_request, mcp_configure_git_hub_request, mcp_configure_git_hub_result, mcp_disable_request, mcp_discover_request, mcp_discover_result, mcp_elicitation_form_mode, mcp_enable_request, mcp_execute_sampling_params, mcp_execute_sampling_request, mcp_execute_sampling_result, mcp_failed_server, mcp_filtered_server, mcp_headers_handle_pending_headers_refresh_request, mcp_headers_handle_pending_headers_refresh_request_request, mcp_headers_handle_pending_headers_refresh_request_result, mcp_host_state, mcp_install_plan, mcp_is_server_running_request, mcp_is_server_running_result, mcp_list_tools_request, mcp_list_tools_result, mcp_oauth_authentication_state_changed_request, mcp_oauth_handle_pending_request, mcp_oauth_handle_pending_result, mcp_oauth_login_grant_type, mcp_oauth_login_request, mcp_oauth_login_result, mcp_oauth_pending_request_response, mcp_oauth_probe_needs_auth_reason, mcp_oauth_probe_request, mcp_oauth_probe_result, mcp_oauth_respond_request, mcp_oauth_respond_result, mcp_plan_configuration_change, mcp_plan_configuration_operation, mcp_plan_enum_value_type, mcp_plan_install_planned, mcp_plan_install_request, mcp_plan_install_result, mcp_plan_install_source, mcp_plan_install_source_candidate, mcp_plan_install_source_candidate_kind, mcp_plan_install_source_card, mcp_plan_install_source_card_kind, mcp_plan_package_install_method, mcp_plan_package_transport, mcp_plan_policy_decision, mcp_plan_policy_result, mcp_plan_policy_source, mcp_plan_provenance, mcp_plan_remote_install_method, mcp_plan_remote_transport, mcp_plan_required_value, mcp_plan_required_value_enum, mcp_plan_required_value_enum_kind, mcp_plan_required_value_scalar, mcp_plan_required_value_scalar_kind, mcp_plan_resource_identity, mcp_plan_scalar_value_type, mcp_plan_scope, mcp_plan_secret_placeholder, mcp_plan_secret_reference, mcp_plan_target, mcp_plan_transport_choice, mcp_plan_transport_choice_package, mcp_plan_transport_choice_remote, mcp_plan_value_category, mcp_register_external_client_request, mcp_reload_config, mcp_reload_with_config_request, mcp_remove_git_hub_result, mcp_resource, mcp_resource_annotations, mcp_resource_content, mcp_resource_icon, mcp_resources_list_request, mcp_resources_list_result, mcp_resources_list_templates_request, mcp_resources_list_templates_result, mcp_resources_read_request, mcp_resources_read_result, mcp_resource_template, mcp_restart_server_request, mcp_safe_for_telemetry, mcp_safe_for_telemetry_fields, mcp_sampling_execution_action, mcp_sampling_execution_result, mcp_serializable_server_config, mcp_server, mcp_server_auth_config, mcp_server_auth_config_redirect_port, mcp_server_card_embedded, mcp_server_card_embedded_kind, mcp_server_card_media_type, mcp_server_card_reference, mcp_server_card_url, mcp_server_card_url_kind, mcp_server_config, mcp_server_config_defer_tools, mcp_server_config_http, mcp_server_config_http_oauth_grant_type, mcp_server_config_http_type, mcp_server_config_memory, mcp_server_config_memory_type, mcp_server_config_stdio, mcp_server_config_stdio_type, mcp_server_failure_info, mcp_server_list, mcp_server_needs_auth_info, mcp_set_env_value_mode_details, mcp_set_env_value_mode_params, mcp_set_env_value_mode_result, mcp_source_file, mcp_source_plugin, mcp_source_ref, mcp_start_server_request, mcp_start_servers_result, mcp_stop_server_request, mcp_task_metadata, mcp_tools, mcp_tool_ui, mcp_tool_ui_visibility, mcp_unregister_external_client_request, memory_configuration, metadata_context_attribution_result, metadata_context_heaviest_messages_request, metadata_context_heaviest_messages_result, metadata_context_info_request, metadata_context_info_result, metadata_is_processing_result, metadata_recompute_context_tokens_request, metadata_recompute_context_tokens_result, metadata_record_context_change_request, metadata_record_context_change_result, metadata_set_working_directory_request, metadata_set_working_directory_result, metadata_snapshot_current_mode, metadata_snapshot_remote_metadata, metadata_snapshot_remote_metadata_repository, metadata_snapshot_remote_metadata_task_type, metadata_update_client_metadata_request, model, model_apply_startup_overlay_request, model_billing, model_billing_promo, model_billing_token_prices, model_billing_token_prices_long_context, model_capabilities, model_capabilities_limits, model_capabilities_limits_vision, model_capabilities_override, model_capabilities_override_limits, model_capabilities_override_limits_vision, model_capabilities_override_supports, model_capabilities_supports, model_list, model_list_request, model_message, model_picker_category, model_picker_persistence_request, model_picker_price_category, model_picker_settings_context, model_policy, model_policy_state, model_set_allowed_models_request, model_set_allowed_models_result, model_set_reasoning_effort_request, model_set_reasoning_effort_result, models_list_request, model_switch_auto_tier_request, model_switch_auto_tier_result, model_switch_auto_tier_status, model_switch_confirmation, model_switch_to_request, model_switch_to_result, model_warning_text, mode_set_request, mode_set_result, move_mcp_loading_to_background_result, named_provider_config, name_get_result, name_set_auto_request, name_set_auto_result, name_set_request, open_canvas_instance, options_update_additional_content_exclusion_policy, options_update_additional_content_exclusion_policy_rule, options_update_additional_content_exclusion_policy_rule_source, options_update_additional_content_exclusion_policy_scope, options_update_context_tier, options_update_env_value_mode, options_update_reasoning_summary, options_update_tool_filter_precedence, pending_permission_request, pending_permission_request_list, permission_decision, permission_decision_approved, permission_decision_approved_for_location, permission_decision_approved_for_session, permission_decision_approve_for_location, permission_decision_approve_for_location_approval, permission_decision_approve_for_location_approval_commands, permission_decision_approve_for_location_approval_custom_tool, permission_decision_approve_for_location_approval_extension_env_access, permission_decision_approve_for_location_approval_extension_management, permission_decision_approve_for_location_approval_extension_permission_access, permission_decision_approve_for_location_approval_factory, permission_decision_approve_for_location_approval_mcp, permission_decision_approve_for_location_approval_mcp_sampling, permission_decision_approve_for_location_approval_memory, permission_decision_approve_for_location_approval_read, permission_decision_approve_for_location_approval_write, permission_decision_approve_for_session, permission_decision_approve_for_session_approval, permission_decision_approve_for_session_approval_commands, permission_decision_approve_for_session_approval_custom_tool, permission_decision_approve_for_session_approval_extension_env_access, permission_decision_approve_for_session_approval_extension_management, permission_decision_approve_for_session_approval_extension_permission_access, permission_decision_approve_for_session_approval_factory, permission_decision_approve_for_session_approval_mcp, permission_decision_approve_for_session_approval_mcp_sampling, permission_decision_approve_for_session_approval_memory, permission_decision_approve_for_session_approval_read, permission_decision_approve_for_session_approval_write, permission_decision_approve_once, permission_decision_approve_permanently, permission_decision_cancelled, permission_decision_context, permission_decision_denied_by_content_exclusion_policy, permission_decision_denied_by_permission_request_hook, permission_decision_denied_by_rules, permission_decision_denied_interactively_by_user, permission_decision_denied_no_approval_rule_and_could_not_request_from_user, permission_decision_outcome, permission_decision_reject, permission_decision_request, permission_decision_surface, permission_decision_user_not_available, permission_location_add_tool_approval_params, permission_location_apply_params, permission_location_apply_result, permission_location_resolve_params, permission_location_resolve_result, permission_location_type, permission_mode_source, permission_paths_add_params, permission_paths_allowed_check_params, permission_paths_allowed_check_result, permission_paths_config, permission_paths_list, permission_paths_update_primary_params, permission_paths_workspace_check_params, permission_paths_workspace_check_result, permission_prompt_shown_notification, permission_request_result, permission_response_capability, permission_rules_set, permissions_configure_additional_content_exclusion_policy, permissions_configure_additional_content_exclusion_policy_rule, permissions_configure_additional_content_exclusion_policy_rule_source, permissions_configure_additional_content_exclusion_policy_scope, permissions_configure_params, permissions_configure_result, permissions_folder_trust_add_trusted_result, permissions_get_mode_request, permissions_get_mode_result, permissions_locations_add_tool_approval_details, permissions_locations_add_tool_approval_details_commands, permissions_locations_add_tool_approval_details_custom_tool, permissions_locations_add_tool_approval_details_extension_env_access, permissions_locations_add_tool_approval_details_extension_management, permissions_locations_add_tool_approval_details_extension_permission_access, permissions_locations_add_tool_approval_details_factory, permissions_locations_add_tool_approval_details_mcp, permissions_locations_add_tool_approval_details_mcp_sampling, permissions_locations_add_tool_approval_details_memory, permissions_locations_add_tool_approval_details_read, permissions_locations_add_tool_approval_details_write, permissions_locations_add_tool_approval_result, permissions_modify_rules_params, permissions_modify_rules_result, permissions_modify_rules_scope, permissions_notify_prompt_shown_result, permissions_paths_add_result, permissions_paths_list_request, permissions_paths_update_primary_result, permissions_pending_requests_request, permissions_reset_session_approvals_request, permissions_reset_session_approvals_result, permissions_set_approve_all_request, permissions_set_approve_all_result, permissions_set_approve_all_source, permissions_set_mode_request, permissions_set_mode_result, permissions_set_required_request, permissions_set_required_result, permissions_urls_set_unrestricted_mode_result, permission_urls_config, permission_urls_set_unrestricted_mode_params, ping_request, ping_result, plan_read_result, plan_read_sql_todos_result, plan_read_sql_todos_with_dependencies_result, plan_sql_todo_dependency, plan_sql_todos_row, plan_update_request, plugin, plugin_install_result, plugin_install_staging_mode, plugin_list, plugin_list_result, plugins_builtin_set_request, plugins_disable_request, plugins_enable_request, plugins_install_request, plugins_marketplaces_add_request, plugins_marketplaces_browse_request, plugins_marketplaces_refresh_request, plugins_marketplaces_remove_request, plugins_reload_request, plugins_uninstall_request, plugins_update_request, plugin_update_all_entry, plugin_update_all_result, plugin_update_result, protocol_append_mode, protocol_customize_mode, protocol_external_tool_defer, protocol_external_tool_definition, protocol_marker_section_override, protocol_replace_mode, protocol_section_override, protocol_static_section_action, protocol_static_section_override, protocol_system_message_append_config, protocol_system_message_config, protocol_system_message_customize_config, protocol_system_message_replace_config, provider_add_request, provider_add_result, provider_config, provider_config_azure, provider_config_transport, provider_config_type, provider_config_wire_api, provider_endpoint, provider_endpoint_transport, provider_endpoint_type, provider_endpoint_wire_api, provider_get_endpoint_request, provider_model_config, provider_session_token, provider_token_acquire_request, provider_token_acquire_result, push_attachment, push_attachment_blob, push_attachment_directory, push_attachment_file, push_attachment_file_line_range, push_attachment_git_hub_actions_job, push_attachment_git_hub_commit, push_attachment_git_hub_file, push_attachment_git_hub_file_diff, push_attachment_git_hub_file_diff_side, push_attachment_git_hub_reference, push_attachment_git_hub_reference_type, push_attachment_git_hub_release, push_attachment_git_hub_repository, push_attachment_git_hub_snippet, push_attachment_git_hub_tree_comparison, push_attachment_git_hub_tree_comparison_side, push_attachment_git_hub_url, push_attachment_selection, push_attachment_selection_details, push_attachment_selection_details_end, push_attachment_selection_details_start, push_git_hub_repo_ref, queue_append_steering_request, queue_begin_deferred_idle_drain_request, queue_begin_deferred_idle_drain_result, queue_consume_system_notifications_request, queued_command_handled, queued_command_not_handled, queued_command_result, queue_defer_session_idle_request, queue_duplicate_at_request, queue_duplicate_at_result, queue_enqueue_resume_pending_result, queue_finish_deferred_idle_drain_request, queue_finish_deferred_idle_drain_result, queue_has_pending_result, queue_insert_at_request, queue_insert_at_result, queue_insert_message, queue_move_item_request, queue_move_item_result, queue_pending_items, queue_pending_items_kind, queue_pending_items_result, queue_remove_at_request, queue_remove_at_result, queue_remove_most_recent_result, queue_send_now_request, queue_send_now_result, queue_set_drain_paused_request, queue_snapshot_result, queue_update_text_request, queue_update_text_result, queue_withdraw_message_request, register_event_interest_params, register_event_interest_result, release_event_interest_params, remote_control_config, remote_control_config_existing_mc_session, remote_control_status, remote_control_status_active, remote_control_status_connecting, remote_control_status_error, remote_control_status_off, remote_control_status_result, remote_control_stop_result, remote_control_transfer_result, remote_enable_request, remote_enable_result, remote_notify_steerable_changed_request, remote_notify_steerable_changed_result, remote_session_connection_result, remote_session_host_status, remote_session_metadata_repository, remote_session_metadata_task_type, remote_session_metadata_value, remote_session_mode, remote_session_repository, response_format, run_options, sandbox_config, sandbox_config_auth, sandbox_config_source, sandbox_config_user_policy, sandbox_config_user_policy_experimental, sandbox_config_user_policy_experimental_seatbelt, sandbox_config_user_policy_filesystem, sandbox_config_user_policy_network, sandbox_config_user_policy_network_proxy, sandbox_config_user_policy_seatbelt, sandbox_disable_for_session_request, sandbox_disable_for_session_result, sandbox_enforcement_status, sandbox_session_change, schedule_add_at_request, schedule_add_cron_request, schedule_add_request, schedule_add_result, schedule_add_self_paced_request, schedule_entry, schedule_has_self_paced_result, schedule_list, schedule_rearm_self_paced_request, schedule_stop_request, schedule_stop_result, secrets_add_filter_values_request, secrets_add_filter_values_result, send_agent_mode, send_attachments_to_message_params, send_message_item, send_messages_request, send_messages_result, send_mode, send_request, send_result, send_system_notification_request, server_agent_list, server_instruction_source_list, server_skill, server_skill_list, session_activity, session_agent_list_request, session_auth_login_request, session_auth_logout_user_request, session_auth_status, session_auth_switch_request, session_bulk_delete_result, session_cancel_all_background_agents_result, session_capability, session_commands_list_request, session_completion_item, session_context, session_context_host_type, session_enrich_metadata_result, session_factory_pause_at_checkpoint_result, session_fs_append_file_request, session_fs_error, session_fs_error_code, session_fs_exists_request, session_fs_exists_result, session_fs_mkdir_request, session_fs_readdir_request, session_fs_readdir_result, session_fs_readdir_with_types_entry, session_fs_readdir_with_types_entry_type, session_fs_readdir_with_types_request, session_fs_readdir_with_types_result, session_fs_read_file_request, session_fs_read_file_result, session_fs_rename_request, session_fs_rm_request, session_fs_set_provider_capabilities, session_fs_set_provider_conventions, session_fs_set_provider_request, session_fs_set_provider_result, session_fs_sqlite_exists_request, session_fs_sqlite_exists_result, session_fs_sqlite_query_request, session_fs_sqlite_query_result, session_fs_sqlite_query_type, session_fs_sqlite_transaction_error, session_fs_sqlite_transaction_error_class, session_fs_sqlite_transaction_request, session_fs_sqlite_transaction_result, session_fs_sqlite_transaction_statement, session_fs_stat_request, session_fs_stat_result, session_fs_write_file_request, session_git_hub_auth_get_all_auth_available_result, session_git_hub_auth_logout_result, session_git_hub_auth_logout_user_result, session_history_compact_request, session_installed_plugin, session_installed_plugin_source, session_installed_plugin_source_git_hub, session_installed_plugin_source_local, session_installed_plugin_source_url, session_limit_prediction_baseline_data, session_limit_prediction_client_type, session_limit_prediction_details, session_limit_prediction_predict_request, session_limit_prediction_request, session_limit_prediction_result, session_limit_prediction_source, session_limit_prediction_tier, session_limit_prediction_tier_option, session_limit_prediction_unavailable_reason, session_list, session_list_entry, session_list_filter, session_load_deferred_repo_hooks_result, session_log_level, session_managed_permissions, session_managed_settings, session_mcp_apps_call_tool_result, session_metadata_snapshot, session_mode, session_model_list, session_model_list_request, session_model_price_category, session_open_options, session_open_options_additional_content_exclusion_policy, session_open_options_additional_content_exclusion_policy_rule, session_open_options_additional_content_exclusion_policy_rule_source, session_open_options_additional_content_exclusion_policy_scope, session_open_options_env_value_mode, session_open_options_reasoning_summary, session_open_params, session_open_result, session_plugins_disable_request, session_plugins_enable_request, session_plugins_install_request, session_plugins_marketplaces_refresh_request, session_plugins_reload_request, session_provider_get_endpoint_request, session_prune_result, sessions_bulk_delete_request, sessions_check_in_use_request, sessions_check_in_use_result, sessions_client_metadata_entry, sessions_close_request, sessions_close_result, sessions_delete_request, sessions_enrich_metadata_request, session_set_credentials_params, session_set_credentials_result, session_settings_built_in_tool_availability_snapshot, session_settings_evaluate_predicate_request, session_settings_evaluate_predicate_result, session_settings_job_snapshot, session_settings_model_snapshot, session_settings_online_evaluation_snapshot, session_settings_predicate_name, session_settings_repo_snapshot, session_settings_snapshot, session_settings_validation_snapshot, sessions_find_by_prefix_request, sessions_find_by_prefix_result, sessions_find_by_task_id_request, sessions_find_by_task_id_result, sessions_fork_request, sessions_fork_result, sessions_get_board_entry_count_request, sessions_get_board_entry_count_result, sessions_get_client_metadata_request, sessions_get_client_metadata_result, sessions_get_event_file_path_request, sessions_get_event_file_path_result, sessions_get_last_for_context_request, sessions_get_last_for_context_result, sessions_get_metadata_request, sessions_get_metadata_result, sessions_get_persisted_remote_steerable_request, sessions_get_persisted_remote_steerable_result, session_sizes, sessions_list_non_empty_session_ids_request, sessions_list_non_empty_session_ids_result, sessions_list_request, sessions_load_deferred_repo_hooks_request, sessions_open_attach, sessions_open_cloud, sessions_open_create, sessions_open_handoff, sessions_open_handoff_task_type, sessions_open_progress, sessions_open_progress_status, sessions_open_progress_step, sessions_open_remote, sessions_open_resume, sessions_open_resume_last, sessions_open_status, session_source, sessions_prune_old_request, sessions_read_persisted_events_request, sessions_release_lock_request, sessions_release_lock_result, sessions_reload_plugin_hooks_request, sessions_reload_plugin_hooks_result, sessions_save_request, sessions_save_result, sessions_set_additional_plugins_request, sessions_set_additional_plugins_result, sessions_set_remote_control_steering_request, sessions_start_remote_control_request, sessions_stop_remote_control_request, sessions_transfer_remote_control_request, session_telemetry_engagement, session_update_options_params, session_update_options_result, session_visibility_status, session_workflow_pause_at_checkpoint_result, session_working_directory_context, session_working_directory_context_host_type, settable_auth_info, settable_token_auth_info, shell_cancel_user_requested_request, shell_credentials, shell_exec_request, shell_exec_result, shell_execute_user_requested_request, shell_init_profile, shell_init_script, shell_init_script_shell, shell_kill_request, shell_kill_result, shell_kill_signal, shell_options, shutdown_request, skill, skill_discovery_path, skill_discovery_path_list, skill_discovery_scope, skill_list, skill_provider_descriptor, skill_provider_list_request, skill_provider_list_result, skill_provider_read_request, skill_provider_read_result, skills_config_set_disabled_skills_request, skills_config_set_skill_disabled_request, skills_disable_request, skills_discover_request, skills_enable_request, skills_get_discovery_paths_request, skills_get_invoked_result, skills_invoked_skill, skills_load_diagnostics, slash_command_add_timeline_entry_result, slash_command_agent_prompt_result, slash_command_completed_result, slash_command_info, slash_command_input, slash_command_input_choice, slash_command_input_completion, slash_command_invocation_result, slash_command_kind, slash_command_model_picker_dialog, slash_command_select_subcommand_option, slash_command_select_subcommand_result, slash_command_set_model_result, slash_command_set_plan_model_result, slash_command_show_dialog_result, slash_command_text_result, slash_command_timeline_entry, subagent_settings_entry, subagent_settings_entry_context_tier, system_message_block, task_agent_info, task_agent_progress, task_client_active_status, task_client_execution_mode, task_client_info, task_client_owner, task_client_owner_kind, task_client_owner_presence, task_client_progress, task_client_status, task_client_type, task_client_update, task_complete_data, task_completion_decision, task_execution_mode, task_info, task_kind, task_list, task_progress_line, tasks_cancel_request, tasks_cancel_result, tasks_get_current_promotable_result, tasks_get_progress_request, tasks_get_progress_result, task_shell_info, task_shell_info_attachment_mode, task_shell_progress, tasks_promote_current_to_background_result, tasks_promote_to_background_request, tasks_promote_to_background_result, tasks_refresh_result, tasks_register_request, tasks_register_result, tasks_remove_request, tasks_remove_result, tasks_send_message_request, tasks_send_message_result, tasks_start_agent_request, tasks_start_agent_result, task_status, tasks_update_request, tasks_update_result, tasks_wait_for_pending_result, telemetry_set_feature_overrides_request, token_auth_info, token_provider_auth_info, tool, tool_list, tool_result, tool_result_expanded, tool_result_new_message, tool_result_type, tools_execute_request, tools_get_builtin_descriptors_request, tools_get_builtin_descriptors_result, tools_get_current_metadata_result, tools_initialize_and_validate_result, tools_list_request, tools_set_request, tools_set_result, tools_shell_descriptor_config, tools_task_complete_event_data_request, tools_update_subagent_settings_result, ui_auto_mode_switch_response, ui_elicitation_array_any_of_field, ui_elicitation_array_any_of_field_items, ui_elicitation_array_any_of_field_items_any_of, ui_elicitation_array_enum_field, ui_elicitation_array_enum_field_items, ui_elicitation_field_value, ui_elicitation_request, ui_elicitation_response, ui_elicitation_response_action, ui_elicitation_response_content, ui_elicitation_result, ui_elicitation_schema, ui_elicitation_schema_property, ui_elicitation_schema_property_boolean, ui_elicitation_schema_property_number, ui_elicitation_schema_property_number_type, ui_elicitation_schema_property_string, ui_elicitation_schema_property_string_format, ui_elicitation_string_enum_field, ui_elicitation_string_one_of_field, ui_elicitation_string_one_of_field_one_of, ui_ephemeral_query_request, ui_ephemeral_query_result, ui_exit_plan_mode_action, ui_exit_plan_mode_response, ui_handle_pending_auto_mode_switch_request, ui_handle_pending_elicitation_request, ui_handle_pending_exit_plan_mode_request, ui_handle_pending_result, ui_handle_pending_sampling_request, ui_handle_pending_sampling_response, ui_handle_pending_session_limits_exhausted_request, ui_handle_pending_user_input_request, ui_register_direct_auto_mode_switch_handler_result, ui_session_limits_exhausted_response, ui_session_limits_exhausted_response_action, ui_unregister_direct_auto_mode_switch_handler_request, ui_unregister_direct_auto_mode_switch_handler_result, ui_user_input_response, update_subagent_settings_request, usage_get_metrics_result, usage_metrics_agent_metric, usage_metrics_code_changes, usage_metrics_model_metric, usage_metrics_model_metric_requests, usage_metrics_model_metric_token_detail, usage_metrics_model_metric_usage, usage_metrics_token_detail, user_auth_info, user_requested_shell_command_result, user_setting_metadata, user_settings_get_result, user_settings_set_request, user_settings_set_result, visibility_get_result, visibility_set_request, visibility_set_result, workflow_abort_request, workflow_ack_result, workflow_agent_options, workflow_agent_request, workflow_agent_result, workflow_agent_summary, workflow_cancel_request, workflow_current_phase, workflow_declared_limits, workflow_durable_operation, workflow_execute_request, workflow_execute_result, workflow_get_run_progress_request, workflow_get_run_request, workflow_journal_get_request, workflow_journal_get_result, workflow_journal_put_request, workflow_list_runs_request, workflow_list_runs_result, workflow_log_line, workflow_log_line_kind, workflow_log_request, workflow_pause_checkpoint_action, workflow_pause_checkpoint_request, workflow_pause_checkpoint_result, workflow_pause_info, workflow_pause_request, workflow_phase_observation, workflow_phase_status, workflow_progress_line, workflow_progress_page, workflow_resume_request, workflow_resume_result, workflow_run_consumed, workflow_run_detail, workflow_run_failure, workflow_run_failure_kind, workflow_run_limits, workflow_run_options, workflow_run_request, workflow_run_result, workflow_run_status, workflow_run_summary, workflow_run_terminal, workflow_tool_resume_request, workflow_tool_run_options, workflow_tool_run_request, workspace_diff_file_change, workspace_diff_file_change_type, workspace_diff_mode, workspace_diff_result, workspaces_add_summary_request, workspaces_add_summary_result, workspaces_autopilot_objective_exists_result, workspaces_checkpoints, workspaces_create_directory_request, workspaces_create_file_request, workspaces_delete_autopilot_objective_result, workspaces_diff_request, workspaces_ensure_request, workspaces_get_workspace_result, workspaces_list_checkpoints_result, workspaces_list_files_result, workspaces_read_autopilot_objective_result, workspaces_read_checkpoint_request, workspaces_read_checkpoint_result, workspaces_read_file_request, workspaces_read_file_result, workspaces_remove_path_request, workspaces_rename_path_request, workspaces_save_large_paste_request, workspaces_save_large_paste_result, workspaces_stat_file_request, workspaces_stat_file_result, workspaces_truncate_summaries_request, workspace_summary_host_type, workspaces_update_metadata_request, workspaces_workspace_details_host_type, workspaces_write_autopilot_objective_request, workspaces_write_autopilot_objective_result, session_auth_info_result, session_context_attribution, session_context_info, subagent_settings, task_progress, workspace_summary) def to_dict(self) -> dict: result: dict = {} @@ -40755,8 +43881,16 @@ def to_dict(self) -> dict: result["CardDigest"] = to_class(CardDigest, self.card_digest) result["CardDigestAlgorithm"] = to_enum(CardDigestAlgorithm, self.card_digest_algorithm) result["CardDigestValue"] = from_str(self.card_digest_value) + result["CatalogAgentPluginCandidate"] = to_class(CatalogAgentPluginCandidate, self.catalog_agent_plugin_candidate) + result["CatalogAgentPluginCandidateKind"] = to_enum(CatalogAgentPluginCandidateKind, self.catalog_agent_plugin_candidate_kind) + result["CatalogAgentPluginCandidateProvenance"] = to_class(CatalogAgentPluginCandidateProvenance, self.catalog_agent_plugin_candidate_provenance) + result["CatalogAgentPluginCompatibilityTag"] = to_enum(CatalogAgentPluginCompatibilityTag, self.catalog_agent_plugin_compatibility_tag) + result["CatalogAgentPluginMediaType"] = to_enum(CatalogAgentPluginMediaType, self.catalog_agent_plugin_media_type) result["CatalogAiSkillCandidate"] = to_class(CatalogAISkillCandidate, self.catalog_ai_skill_candidate) + result["CatalogAiSkillCandidateKind"] = to_enum(CatalogAISkillCandidateKind, self.catalog_ai_skill_candidate_kind) result["CatalogAiSkillCandidateProvenance"] = to_class(CatalogAISkillCandidateProvenance, self.catalog_ai_skill_candidate_provenance) + result["CatalogAiSkillInstallability"] = to_enum(CatalogAISkillInstallability, self.catalog_ai_skill_installability) + result["CatalogAiSkillMediaType"] = to_enum(CatalogAISkillMediaType, self.catalog_ai_skill_media_type) result["CatalogAuthenticationRequiredError"] = to_class(CatalogAuthenticationRequiredError, self.catalog_authentication_required_error) result["CatalogAuthenticationRequiredReason"] = to_enum(CatalogAuthenticationRequiredReason, self.catalog_authentication_required_reason) result["CatalogCandidate"] = to_class(CatalogCandidate, self.catalog_candidate) @@ -40777,6 +43911,7 @@ def to_dict(self) -> dict: result["CatalogMalformedCardError"] = to_class(CatalogMalformedCardError, self.catalog_malformed_card_error) result["CatalogMalformedCardReason"] = to_enum(CatalogMalformedCardReason, self.catalog_malformed_card_reason) result["CatalogMcpServerCandidate"] = to_class(CatalogMCPServerCandidate, self.catalog_mcp_server_candidate) + result["CatalogMcpServerCandidateKind"] = to_enum(CatalogMCPServerCandidateKind, self.catalog_mcp_server_candidate_kind) result["CatalogMcpServerCandidateProvenance"] = to_class(CatalogMCPServerCandidateProvenance, self.catalog_mcp_server_candidate_provenance) result["CatalogMcpServerInstallability"] = to_enum(CatalogMCPServerInstallabilityEnum, self.catalog_mcp_server_installability) result["CatalogMediaType"] = to_enum(CatalogMediaType, self.catalog_media_type) @@ -40787,10 +43922,28 @@ def to_dict(self) -> dict: result["CatalogNetworkFailureReason"] = to_enum(CatalogNetworkFailureReason, self.catalog_network_failure_reason) result["CatalogNotInstallableError"] = to_class(CatalogNotInstallableError, self.catalog_not_installable_error) result["CatalogNotInstallableReason"] = to_enum(CatalogNotInstallableReason, self.catalog_not_installable_reason) + result["CatalogPluginRepositorySource"] = to_class(CatalogPluginRepositorySource, self.catalog_plugin_repository_source) result["CatalogPolicyRejectedError"] = to_class(CatalogPolicyRejectedError, self.catalog_policy_rejected_error) + result["CatalogResourceIdentity"] = from_str(self.catalog_resource_identity) + result["CatalogResourceVersion"] = from_str(self.catalog_resource_version) + result["CatalogSearchPage"] = to_class(CatalogSearchPage, self.catalog_search_page) + result["CatalogSearchPagination"] = to_class(CatalogSearchPagination, self.catalog_search_pagination) result["CatalogSearchRequest"] = to_class(CatalogSearchRequest, self.catalog_search_request) result["CatalogSearchResult"] = (self.catalog_search_result).to_dict() result["CatalogSearchSucceeded"] = to_class(CatalogSearchSucceeded, self.catalog_search_succeeded) + result["CatalogSearchTotalCountRelation"] = to_enum(CatalogSearchTotalCountRelation, self.catalog_search_total_count_relation) + result["CatalogSelectionCancelled"] = to_class(CatalogSelectionCancelled, self.catalog_selection_cancelled) + result["CatalogSelectionDecision"] = to_enum(CatalogSelectionDecision, self.catalog_selection_decision) + result["CatalogSelectionDeclined"] = to_class(CatalogSelectionDeclined, self.catalog_selection_declined) + result["CatalogSelectionForeign"] = to_class(CatalogSelectionForeign, self.catalog_selection_foreign) + result["CatalogSelectionInvalid"] = to_class(CatalogSelectionInvalid, self.catalog_selection_invalid) + result["CatalogSelectionReplayed"] = to_class(CatalogSelectionReplayed, self.catalog_selection_replayed) + result["CatalogSelectionRequest"] = to_class(CatalogSelectionRequest, self.catalog_selection_request) + result["CatalogSelectionResult"] = (self.catalog_selection_result).to_dict() + result["CatalogSelectionSelected"] = to_class(CatalogSelectionSelected, self.catalog_selection_selected) + result["CatalogSelectionStale"] = to_class(CatalogSelectionStale, self.catalog_selection_stale) + result["CatalogSelectionTimedOut"] = to_class(CatalogSelectionTimedOut, self.catalog_selection_timed_out) + result["CatalogSelectionWrongKind"] = to_class(CatalogSelectionWrongKind, self.catalog_selection_wrong_kind) result["CatalogTrustEligibility"] = to_enum(CatalogTrustEligibility, self.catalog_trust_eligibility) result["CatalogTrustProvenance"] = to_class(CatalogTrustProvenance, self.catalog_trust_provenance) result["CatalogTrustSnapshot"] = (self.catalog_trust_snapshot).to_dict() @@ -40927,7 +44080,7 @@ def to_dict(self) -> dict: result["FactoryCancelRequest"] = to_class(FactoryCancelRequest, self.factory_cancel_request) result["FactoryCurrentPhase"] = to_class(FactoryCurrentPhase, self.factory_current_phase) result["FactoryDeclaredLimits"] = to_class(FactoryDeclaredLimits, self.factory_declared_limits) - result["FactoryDurableOperation"] = to_enum(FactoryDurableOperation, self.factory_durable_operation) + result["FactoryDurableOperation"] = to_enum(DurableOperation, self.factory_durable_operation) result["FactoryExecuteRequest"] = to_class(FactoryExecuteRequest, self.factory_execute_request) result["FactoryExecuteResult"] = to_class(FactoryExecuteResult, self.factory_execute_result) result["FactoryGetRunProgressRequest"] = to_class(FactoryGetRunProgressRequest, self.factory_get_run_progress_request) @@ -40938,15 +44091,15 @@ def to_dict(self) -> dict: result["FactoryListRunsRequest"] = to_class(FactoryListRunsRequest, self.factory_list_runs_request) result["FactoryListRunsResult"] = to_class(FactoryListRunsResult, self.factory_list_runs_result) result["FactoryLogLine"] = to_class(FactoryLogLine, self.factory_log_line) - result["FactoryLogLineKind"] = to_enum(FactoryLogLineKind, self.factory_log_line_kind) + result["FactoryLogLineKind"] = to_enum(LogLineKind, self.factory_log_line_kind) result["FactoryLogRequest"] = to_class(FactoryLogRequest, self.factory_log_request) - result["FactoryPauseCheckpointAction"] = to_enum(FactoryPauseCheckpointAction, self.factory_pause_checkpoint_action) + result["FactoryPauseCheckpointAction"] = to_enum(PauseCheckpointAction, self.factory_pause_checkpoint_action) result["FactoryPauseCheckpointRequest"] = to_class(FactoryPauseCheckpointRequest, self.factory_pause_checkpoint_request) result["FactoryPauseCheckpointResult"] = to_class(FactoryPauseCheckpointResult, self.factory_pause_checkpoint_result) result["FactoryPauseInfo"] = to_class(FactoryPauseInfo, self.factory_pause_info) result["FactoryPauseRequest"] = to_class(FactoryPauseRequest, self.factory_pause_request) result["FactoryPhaseObservation"] = to_class(FactoryPhaseObservation, self.factory_phase_observation) - result["FactoryPhaseStatus"] = to_enum(FactoryPhaseStatus, self.factory_phase_status) + result["FactoryPhaseStatus"] = to_enum(PhaseStatus, self.factory_phase_status) result["FactoryProgressLine"] = to_class(FactoryProgressLine, self.factory_progress_line) result["FactoryProgressPage"] = to_class(FactoryProgressPage, self.factory_progress_page) result["FactoryResumeRequest"] = to_class(FactoryResumeRequest, self.factory_resume_request) @@ -40954,11 +44107,11 @@ def to_dict(self) -> dict: result["FactoryRunConsumed"] = to_class(FactoryRunConsumed, self.factory_run_consumed) result["FactoryRunDetail"] = to_class(FactoryRunDetail, self.factory_run_detail) result["FactoryRunFailure"] = to_class(FactoryRunFailure, self.factory_run_failure) - result["FactoryRunFailureKind"] = to_enum(FactoryRunFailureKind, self.factory_run_failure_kind) + result["FactoryRunFailureKind"] = to_enum(RunFailureKind, self.factory_run_failure_kind) result["FactoryRunLimits"] = to_class(FactoryRunLimits, self.factory_run_limits) result["FactoryRunRequest"] = to_class(FactoryRunRequest, self.factory_run_request) result["FactoryRunResult"] = to_class(FactoryRunResult, self.factory_run_result) - result["FactoryRunStatus"] = to_enum(FactoryRunStatus, self.factory_run_status) + result["FactoryRunStatus"] = to_enum(RunStatus, self.factory_run_status) result["FactoryRunSummary"] = to_class(FactoryRunSummary, self.factory_run_summary) result["FactoryRunTerminal"] = to_class(FactoryRunTerminal, self.factory_run_terminal) result["FactoryToolResumeRequest"] = to_class(_FactoryToolResumeRequest, self.factory_tool_resume_request) @@ -41046,6 +44199,7 @@ def to_dict(self) -> dict: result["LspInitializeRequest"] = to_class(LspInitializeRequest, self.lsp_initialize_request) result["ManagedMcpServerConfig"] = to_class(ManagedMCPServerConfig, self.managed_mcp_server_config) result["ManagedSettingsReadResult"] = to_class(ManagedSettingsReadResult, self.managed_settings_read_result) + result["ManagedSettingsResolvedData"] = to_class(ManagedSettingsResolvedData, self.managed_settings_resolved_data) result["MarketplaceAddResult"] = to_class(MarketplaceAddResult, self.marketplace_add_result) result["MarketplaceBrowseResult"] = to_class(MarketplaceBrowseResult, self.marketplace_browse_result) result["MarketplaceInfo"] = to_class(MarketplaceInfo, self.marketplace_info) @@ -41464,6 +44618,7 @@ def to_dict(self) -> dict: result["PushAttachmentSelectionDetailsEnd"] = to_class(PushAttachmentSelectionDetailsEnd, self.push_attachment_selection_details_end) result["PushAttachmentSelectionDetailsStart"] = to_class(PushAttachmentSelectionDetailsStart, self.push_attachment_selection_details_start) result["PushGitHubRepoRef"] = to_class(PushGitHubRepoRef, self.push_git_hub_repo_ref) + result["QueueAppendSteeringRequest"] = to_class(QueueAppendSteeringRequest, self.queue_append_steering_request) result["QueueBeginDeferredIdleDrainRequest"] = to_class(QueueBeginDeferredIdleDrainRequest, self.queue_begin_deferred_idle_drain_request) result["QueueBeginDeferredIdleDrainResult"] = to_class(QueueBeginDeferredIdleDrainResult, self.queue_begin_deferred_idle_drain_result) result["QueueConsumeSystemNotificationsRequest"] = to_class(QueueConsumeSystemNotificationsRequest, self.queue_consume_system_notifications_request) @@ -41494,6 +44649,7 @@ def to_dict(self) -> dict: result["QueueSnapshotResult"] = to_class(QueueSnapshotResult, self.queue_snapshot_result) result["QueueUpdateTextRequest"] = to_class(QueueUpdateTextRequest, self.queue_update_text_request) result["QueueUpdateTextResult"] = to_class(QueueUpdateTextResult, self.queue_update_text_result) + result["QueueWithdrawMessageRequest"] = to_class(QueueWithdrawMessageRequest, self.queue_withdraw_message_request) result["RegisterEventInterestParams"] = to_class(RegisterEventInterestParams, self.register_event_interest_params) result["RegisterEventInterestResult"] = to_class(RegisterEventInterestResult, self.register_event_interest_result) result["ReleaseEventInterestParams"] = to_class(ReleaseEventInterestParams, self.release_event_interest_params) @@ -41649,6 +44805,10 @@ def to_dict(self) -> dict: result["SessionOpenOptionsReasoningSummary"] = to_enum(ReasoningSummary, self.session_open_options_reasoning_summary) result["SessionOpenParams"] = (self.session_open_params).to_dict() result["SessionOpenResult"] = to_class(SessionOpenResult, self.session_open_result) + result["SessionPluginsDisableRequest"] = to_class(SessionPluginsDisableRequest, self.session_plugins_disable_request) + result["SessionPluginsEnableRequest"] = to_class(SessionPluginsEnableRequest, self.session_plugins_enable_request) + result["SessionPluginsInstallRequest"] = to_class(SessionPluginsInstallRequest, self.session_plugins_install_request) + result["SessionPluginsMarketplacesRefreshRequest"] = to_class(SessionPluginsMarketplacesRefreshRequest, self.session_plugins_marketplaces_refresh_request) result["SessionPluginsReloadRequest"] = to_class(SessionPluginsReloadRequest, self.session_plugins_reload_request) result["SessionProviderGetEndpointRequest"] = to_class(SessionProviderGetEndpointRequest, self.session_provider_get_endpoint_request) result["SessionPruneResult"] = to_class(SessionPruneResult, self.session_prune_result) @@ -41726,6 +44886,7 @@ def to_dict(self) -> dict: result["SessionUpdateOptionsParams"] = to_class(SessionUpdateOptionsParams, self.session_update_options_params) result["SessionUpdateOptionsResult"] = to_class(SessionUpdateOptionsResult, self.session_update_options_result) result["SessionVisibilityStatus"] = to_enum(SessionVisibilityStatus, self.session_visibility_status) + result["SessionWorkflowPauseAtCheckpointResult"] = to_class(SessionWorkflowPauseAtCheckpointResult, self.session_workflow_pause_at_checkpoint_result) result["SessionWorkingDirectoryContext"] = to_class(SessionWorkingDirectoryContext, self.session_working_directory_context) result["SessionWorkingDirectoryContextHostType"] = to_enum(HostType, self.session_working_directory_context_host_type) result["SettableAuthInfo"] = (self.settable_auth_info).to_dict() @@ -41903,6 +45064,53 @@ def to_dict(self) -> dict: result["VisibilityGetResult"] = to_class(VisibilityGetResult, self.visibility_get_result) result["VisibilitySetRequest"] = to_class(VisibilitySetRequest, self.visibility_set_request) result["VisibilitySetResult"] = to_class(VisibilitySetResult, self.visibility_set_result) + result["WorkflowAbortRequest"] = to_class(WorkflowAbortRequest, self.workflow_abort_request) + result["WorkflowAckResult"] = to_class(WorkflowACKResult, self.workflow_ack_result) + result["WorkflowAgentOptions"] = to_class(WorkflowAgentOptions, self.workflow_agent_options) + result["WorkflowAgentRequest"] = to_class(WorkflowAgentRequest, self.workflow_agent_request) + result["WorkflowAgentResult"] = to_class(WorkflowAgentResult, self.workflow_agent_result) + result["WorkflowAgentSummary"] = to_class(WorkflowAgentSummary, self.workflow_agent_summary) + result["WorkflowCancelRequest"] = to_class(WorkflowCancelRequest, self.workflow_cancel_request) + result["WorkflowCurrentPhase"] = to_class(WorkflowCurrentPhase, self.workflow_current_phase) + result["WorkflowDeclaredLimits"] = to_class(WorkflowDeclaredLimits, self.workflow_declared_limits) + result["WorkflowDurableOperation"] = to_enum(DurableOperation, self.workflow_durable_operation) + result["WorkflowExecuteRequest"] = to_class(WorkflowExecuteRequest, self.workflow_execute_request) + result["WorkflowExecuteResult"] = to_class(WorkflowExecuteResult, self.workflow_execute_result) + result["WorkflowGetRunProgressRequest"] = to_class(WorkflowGetRunProgressRequest, self.workflow_get_run_progress_request) + result["WorkflowGetRunRequest"] = to_class(WorkflowGetRunRequest, self.workflow_get_run_request) + result["WorkflowJournalGetRequest"] = to_class(WorkflowJournalGetRequest, self.workflow_journal_get_request) + result["WorkflowJournalGetResult"] = to_class(WorkflowJournalGetResult, self.workflow_journal_get_result) + result["WorkflowJournalPutRequest"] = to_class(WorkflowJournalPutRequest, self.workflow_journal_put_request) + result["WorkflowListRunsRequest"] = to_class(WorkflowListRunsRequest, self.workflow_list_runs_request) + result["WorkflowListRunsResult"] = to_class(WorkflowListRunsResult, self.workflow_list_runs_result) + result["WorkflowLogLine"] = to_class(WorkflowLogLine, self.workflow_log_line) + result["WorkflowLogLineKind"] = to_enum(LogLineKind, self.workflow_log_line_kind) + result["WorkflowLogRequest"] = to_class(WorkflowLogRequest, self.workflow_log_request) + result["WorkflowPauseCheckpointAction"] = to_enum(PauseCheckpointAction, self.workflow_pause_checkpoint_action) + result["WorkflowPauseCheckpointRequest"] = to_class(WorkflowPauseCheckpointRequest, self.workflow_pause_checkpoint_request) + result["WorkflowPauseCheckpointResult"] = to_class(WorkflowPauseCheckpointResult, self.workflow_pause_checkpoint_result) + result["WorkflowPauseInfo"] = to_class(WorkflowPauseInfo, self.workflow_pause_info) + result["WorkflowPauseRequest"] = to_class(WorkflowPauseRequest, self.workflow_pause_request) + result["WorkflowPhaseObservation"] = to_class(WorkflowPhaseObservation, self.workflow_phase_observation) + result["WorkflowPhaseStatus"] = to_enum(PhaseStatus, self.workflow_phase_status) + result["WorkflowProgressLine"] = to_class(WorkflowProgressLine, self.workflow_progress_line) + result["WorkflowProgressPage"] = to_class(WorkflowProgressPage, self.workflow_progress_page) + result["WorkflowResumeRequest"] = to_class(WorkflowResumeRequest, self.workflow_resume_request) + result["WorkflowResumeResult"] = to_class(WorkflowResumeResult, self.workflow_resume_result) + result["WorkflowRunConsumed"] = to_class(WorkflowRunConsumed, self.workflow_run_consumed) + result["WorkflowRunDetail"] = to_class(WorkflowRunDetail, self.workflow_run_detail) + result["WorkflowRunFailure"] = to_class(WorkflowRunFailure, self.workflow_run_failure) + result["WorkflowRunFailureKind"] = to_enum(RunFailureKind, self.workflow_run_failure_kind) + result["WorkflowRunLimits"] = to_class(WorkflowRunLimits, self.workflow_run_limits) + result["WorkflowRunOptions"] = to_class(WorkflowRunOptions, self.workflow_run_options) + result["WorkflowRunRequest"] = to_class(WorkflowRunRequest, self.workflow_run_request) + result["WorkflowRunResult"] = to_class(WorkflowRunResult, self.workflow_run_result) + result["WorkflowRunStatus"] = to_enum(RunStatus, self.workflow_run_status) + result["WorkflowRunSummary"] = to_class(WorkflowRunSummary, self.workflow_run_summary) + result["WorkflowRunTerminal"] = to_class(WorkflowRunTerminal, self.workflow_run_terminal) + result["WorkflowToolResumeRequest"] = to_class(_WorkflowToolResumeRequest, self.workflow_tool_resume_request) + result["WorkflowToolRunOptions"] = to_class(_WorkflowToolRunOptions, self.workflow_tool_run_options) + result["WorkflowToolRunRequest"] = to_class(_WorkflowToolRunRequest, self.workflow_tool_run_request) result["WorkspaceDiffFileChange"] = to_class(WorkspaceDiffFileChange, self.workspace_diff_file_change) result["WorkspaceDiffFileChangeType"] = to_enum(WorkspaceDiffFileChangeType, self.workspace_diff_file_change_type) result["WorkspaceDiffMode"] = to_enum(WorkspaceDiffMode, self.workspace_diff_mode) @@ -42011,6 +45219,27 @@ def _load_CatalogSearchResult(obj: Any) -> "CatalogSearchResult": case "unavailable": return CatalogUnavailableError.from_dict(obj) case _: raise ValueError(f"Unknown CatalogSearchResult kind: {kind!r}") +# Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId. +CatalogSelectionResult = CatalogSelectionSelected | CatalogSelectionDeclined | CatalogSelectionCancelled | CatalogSelectionTimedOut | CatalogSelectionInvalid | CatalogSelectionStale | CatalogSelectionReplayed | CatalogSelectionForeign | CatalogSelectionWrongKind | CatalogNegotiationRefusedError | CatalogInvalidRequestError | CatalogUnavailableError + +def _load_CatalogSelectionResult(obj: Any) -> "CatalogSelectionResult": + assert isinstance(obj, dict) + kind = obj.get("kind") + match kind: + case "selected": return CatalogSelectionSelected.from_dict(obj) + case "declined": return CatalogSelectionDeclined.from_dict(obj) + case "cancelled": return CatalogSelectionCancelled.from_dict(obj) + case "timed-out": return CatalogSelectionTimedOut.from_dict(obj) + case "invalid": return CatalogSelectionInvalid.from_dict(obj) + case "stale": return CatalogSelectionStale.from_dict(obj) + case "replayed": return CatalogSelectionReplayed.from_dict(obj) + case "foreign": return CatalogSelectionForeign.from_dict(obj) + case "wrong-kind": return CatalogSelectionWrongKind.from_dict(obj) + case "negotiation-refused": return CatalogNegotiationRefusedError.from_dict(obj) + case "invalid-request": return CatalogInvalidRequestError.from_dict(obj) + case "unavailable": return CatalogUnavailableError.from_dict(obj) + case _: raise ValueError(f"Unknown CatalogSelectionResult kind: {kind!r}") + # A versioned, bounded trust observation carried unchanged with a catalog candidate and its private handle context. Current observations require a recognised T1/T2 tier; every non-current state structurally forbids a tier. Eligibility remains `unknown` while Agent Finder supplies no exposure decision, and states absent from its current wire are never inferred from age, relevance, popularity, or a tier transition. CatalogTrustSnapshot = CatalogTrustSnapshotCurrent | CatalogTrustSnapshotAbsent | CatalogTrustSnapshotStale | CatalogTrustSnapshotDowngraded | CatalogTrustSnapshotRevoked | CatalogTrustSnapshotUnsupported | CatalogTrustSnapshotMalformed @@ -42323,10 +45552,18 @@ def _load_TaskInfo(obj: Any) -> "TaskInfo": CardDigestValue = str CatalogCapabilityId = str CatalogMcpServerInstallability = CatalogMCPServerInstallabilityEnum +CatalogResourceIdentity = str +CatalogResourceVersion = str ClientMetadata = dict CommandsListRequest = Any ExternalToolResult = ExternalToolTextResultForLlm ExternalToolTextResultForLlmContentResourceLinkIconTheme = Theme +FactoryDurableOperation = DurableOperation +FactoryLogLineKind = LogLineKind +FactoryPauseCheckpointAction = PauseCheckpointAction +FactoryPhaseStatus = PhaseStatus +FactoryRunFailureKind = RunFailureKind +FactoryRunStatus = RunStatus FilterMapping = dict HistoryCompactRequest = Any InstructionDiscoveryPathKind = DebugCollectLogsEntryKind @@ -42389,6 +45626,12 @@ def _load_TaskInfo(obj: Any) -> "TaskInfo": TaskInfoExecutionMode = TaskExecutionMode TaskInfoStatus = TaskStatus ToolResult = ToolResultExpanded +WorkflowDurableOperation = DurableOperation +WorkflowLogLineKind = LogLineKind +WorkflowPauseCheckpointAction = PauseCheckpointAction +WorkflowPhaseStatus = PhaseStatus +WorkflowRunFailureKind = RunFailureKind +WorkflowRunStatus = RunStatus WorkspaceSummaryHostType = HostType WorkspacesWorkspaceDetailsHostType = HostType @@ -42583,6 +45826,11 @@ async def search(self, params: CatalogSearchRequest, *, timeout: float | None = params_dict = {k: v for k, v in params.to_dict().items() if v is not None} return _load_CatalogSearchResult(await self._client.request("catalog.search", params_dict, **_timeout_kwargs(timeout))) + async def select(self, params: CatalogSelectionRequest, *, timeout: float | None = None) -> CatalogSelectionResult: + "Terminates one retained catalog selection group. A selected outcome returns the native host a fresh single-use candidate handle plus the original searchId for a later explicit mcp.planInstall call; non-selected outcomes release the group without producing a planning input. Candidate state, cards, URLs, credentials and private identifiers remain inside the runtime. The model-facing catalog_select tool projects the result separately and never exposes the candidate handle or searchId.\n\nArgs:\n params: Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection.\n\nReturns:\n Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId." + params_dict = {k: v for k, v in params.to_dict().items() if v is not None} + return _load_CatalogSelectionResult(await self._client.request("catalog.select", params_dict, **_timeout_kwargs(timeout))) + # Experimental: this API group is experimental and may change or be removed. class ServerPluginsBuiltinApi: @@ -42797,7 +46045,7 @@ def __init__(self, client: "JsonRpcClient"): self._client = client async def set_provider(self, params: SessionFSSetProviderRequest, *, timeout: float | None = None) -> SessionFSSetProviderResult: - "Registers an SDK client as the session filesystem provider.\n\nArgs:\n params: Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider.\n\nReturns:\n Indicates whether the calling client was registered as the session filesystem provider." + "Registers an SDK client as the session filesystem provider.\n\nArgs:\n params: Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots.\n\nReturns:\n Indicates whether the calling client was registered as the session filesystem provider." params_dict = {k: v for k, v in params.to_dict().items() if v is not None} return SessionFSSetProviderResult.from_dict(await self._client.request("sessionFs.setProvider", params_dict, **_timeout_kwargs(timeout))) @@ -43225,6 +46473,93 @@ async def agent(self, params: FactoryAgentRequest, *, timeout: float | None = No return FactoryAgentResult.from_dict(await self._client.request("session.factory.agent", params_dict, **_timeout_kwargs(timeout))) +# Experimental: this API group is experimental and may change or be removed. +class WorkflowJournalApi: + def __init__(self, client: "JsonRpcClient", session_id: str): + self._client = client + self._session_id = session_id + + async def get(self, params: WorkflowJournalGetRequest, *, timeout: float | None = None) -> WorkflowJournalGetResult: + "Reads a memoized dynamic workflow journal entry.\n\nArgs:\n params: Parameters for reading a workflow journal entry.\n\nReturns:\n Result of reading a workflow journal entry." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowJournalGetResult.from_dict(await self._client.request("session.workflow.journal.get", params_dict, **_timeout_kwargs(timeout))) + + async def put(self, params: WorkflowJournalPutRequest, *, timeout: float | None = None) -> WorkflowACKResult: + "Stores a memoized dynamic workflow journal entry.\n\nArgs:\n params: Parameters for storing a workflow journal entry.\n\nReturns:\n Acknowledgement that a workflow request was accepted." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowACKResult.from_dict(await self._client.request("session.workflow.journal.put", params_dict, **_timeout_kwargs(timeout))) + + +# Experimental: this API group is experimental and may change or be removed. +class WorkflowApi: + def __init__(self, client: "JsonRpcClient", session_id: str): + self._client = client + self._session_id = session_id + self.journal = WorkflowJournalApi(client, session_id) + + async def run(self, params: WorkflowRunRequest, *, timeout: float | None = None) -> WorkflowRunResult: + "Runs a registered dynamic workflow by name at the top level.\n\nArgs:\n params: Parameters for invoking a registered workflow.\n\nReturns:\n Complete current or terminal workflow run envelope." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowRunResult.from_dict(await self._client.request("session.workflow.run", params_dict, **_timeout_kwargs(timeout))) + + async def resume(self, params: WorkflowResumeRequest, *, timeout: float | None = None) -> WorkflowResumeResult: + "Resumes a dynamic workflow run using its persisted name, arguments, journal, and accounting.\n\nArgs:\n params: Parameters for resuming a workflow run from its persisted identity.\n\nReturns:\n Resolved persisted workflow identity and resumed run envelope." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowResumeResult.from_dict(await self._client.request("session.workflow.resume", params_dict, **_timeout_kwargs(timeout))) + + async def get_run(self, params: WorkflowGetRunRequest, *, timeout: float | None = None) -> WorkflowRunResult: + "Gets the current or settled envelope for a dynamic workflow run.\n\nArgs:\n params: Parameters for retrieving a workflow run.\n\nReturns:\n Complete current or terminal workflow run envelope." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowRunResult.from_dict(await self._client.request("session.workflow.getRun", params_dict, **_timeout_kwargs(timeout))) + + async def list_runs(self, params: WorkflowListRunsRequest, *, timeout: float | None = None) -> WorkflowListRunsResult: + "Lists durable dynamic workflow runs for this session in creation order.\n\nArgs:\n params: Parameters for paging workflow runs.\n\nReturns:\n A page of workflow runs in durable creation order." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowListRunsResult.from_dict(await self._client.request("session.workflow.listRuns", params_dict, **_timeout_kwargs(timeout))) + + async def get_run_detail(self, params: WorkflowGetRunRequest, *, timeout: float | None = None) -> WorkflowRunDetail: + "Gets durable and live observability detail for one dynamic workflow run.\n\nArgs:\n params: Parameters for retrieving a workflow run.\n\nReturns:\n Full workflow run observability detail." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowRunDetail.from_dict(await self._client.request("session.workflow.getRunDetail", params_dict, **_timeout_kwargs(timeout))) + + async def get_run_progress(self, params: WorkflowGetRunProgressRequest, *, timeout: float | None = None) -> WorkflowProgressPage: + "Pages durable progress for one dynamic workflow run.\n\nArgs:\n params: Parameters for paging workflow progress.\n\nReturns:\n A bidirectional page of workflow progress." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowProgressPage.from_dict(await self._client.request("session.workflow.getRunProgress", params_dict, **_timeout_kwargs(timeout))) + + async def cancel(self, params: WorkflowCancelRequest, *, timeout: float | None = None) -> WorkflowRunResult: + "Requests cancellation of a dynamic workflow run and returns its run envelope.\n\nArgs:\n params: Parameters for cancelling a workflow run.\n\nReturns:\n Complete current or terminal workflow run envelope." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowRunResult.from_dict(await self._client.request("session.workflow.cancel", params_dict, **_timeout_kwargs(timeout))) + + async def pause(self, params: WorkflowPauseRequest, *, timeout: float | None = None) -> WorkflowRunResult: + "Pauses a running dynamic workflow and returns its settled run envelope.\n\nArgs:\n params: Parameters for pausing a running workflow.\n\nReturns:\n Complete current or terminal workflow run envelope." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowRunResult.from_dict(await self._client.request("session.workflow.pause", params_dict, **_timeout_kwargs(timeout))) + + async def log(self, params: WorkflowLogRequest, *, timeout: float | None = None) -> WorkflowACKResult: + "Records a batch of ordered dynamic workflow progress lines.\n\nArgs:\n params: Parameters for recording workflow progress.\n\nReturns:\n Acknowledgement that a workflow request was accepted." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowACKResult.from_dict(await self._client.request("session.workflow.log", params_dict, **_timeout_kwargs(timeout))) + + async def agent(self, params: WorkflowAgentRequest, *, timeout: float | None = None) -> WorkflowAgentResult: + "Runs one dynamic-workflow-scoped subagent and returns its result.\n\nArgs:\n params: Parameters for one workflow-scoped subagent call.\n\nReturns:\n Result of one workflow-scoped subagent call." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowAgentResult.from_dict(await self._client.request("session.workflow.agent", params_dict, **_timeout_kwargs(timeout))) + + # Experimental: this API group is experimental and may change or be removed. class ModelApi: def __init__(self, client: "JsonRpcClient", session_id: str): @@ -43852,16 +47187,93 @@ async def is_server_running(self, params: MCPIsServerRunningRequest, *, timeout: return MCPIsServerRunningResult.from_dict(await self._client.request("session.mcp.isServerRunning", params_dict, **_timeout_kwargs(timeout))) +# Experimental: this API group is experimental and may change or be removed. +class ManagedSettingsApi: + def __init__(self, client: "JsonRpcClient", session_id: str): + self._client = client + self._session_id = session_id + + async def get(self, *, timeout: float | None = None) -> ManagedSettingsResolvedData: + "Waits for the live session's in-flight managed-settings application, then returns the retained effective snapshot used by runtime enforcement and by `session.managed_settings_resolved`. It does not perform another account, device, or server resolution, and rejects when resolution has not produced a snapshot.\n\nReturns:\n Enterprise managed-settings resolution: the effective managed settings the session applied and which channels contributed, so SDK clients can show users what is enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on resume, and on account switch. This is an ephemeral live snapshot (delivered to subscribers but not persisted to the session event log), because at session start it resolves before `session.start` is emitted. Device values take precedence over server values, then the policy helper, per ordinary key, while permissions compose restrictively across device, server, policy-helper, and SDK-client layers. The account-scoped `getManagedSettings()` API does not include session-local client injection. Marked experimental while the managed-settings surface stabilizes." + return ManagedSettingsResolvedData.from_dict(await self._client.request("session.managedSettings.get", {"sessionId": self._session_id}, **_timeout_kwargs(timeout))) + + +# Experimental: this API group is experimental and may change or be removed. +class PluginsMarketplacesApi: + def __init__(self, client: "JsonRpcClient", session_id: str): + self._client = client + self._session_id = session_id + + async def list(self, *, timeout: float | None = None) -> MarketplaceListResult: + "Lists registered and enterprise-managed desired marketplaces using the live session's retained policy.\n\nReturns:\n All registered marketplaces, including built-in defaults." + return MarketplaceListResult.from_dict(await self._client.request("session.plugins.marketplaces.list", {"sessionId": self._session_id}, **_timeout_kwargs(timeout))) + + async def add(self, params: PluginsMarketplacesAddRequest, *, timeout: float | None = None) -> MarketplaceAddResult: + "Adds a marketplace when permitted by the live session's retained managed policy.\n\nArgs:\n params: Marketplace source and optional working directory for relative-path resolution.\n\nReturns:\n Result of registering a new marketplace." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return MarketplaceAddResult.from_dict(await self._client.request("session.plugins.marketplaces.add", params_dict, **_timeout_kwargs(timeout))) + + async def remove(self, params: PluginsMarketplacesRemoveRequest, *, timeout: float | None = None) -> MarketplaceRemoveResult: + "Removes a marketplace when permitted by the live session's retained managed policy.\n\nArgs:\n params: Name of the marketplace to remove and an optional force flag.\n\nReturns:\n Outcome of the remove attempt, including dependent-plugin info when applicable." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return MarketplaceRemoveResult.from_dict(await self._client.request("session.plugins.marketplaces.remove", params_dict, **_timeout_kwargs(timeout))) + + async def browse(self, params: PluginsMarketplacesBrowseRequest, *, timeout: float | None = None) -> MarketplaceBrowseResult: + "Browses a marketplace resolved through the live session's working directory and retained managed policy.\n\nArgs:\n params: Name of the marketplace whose plugin catalog to fetch.\n\nReturns:\n Plugins advertised by the marketplace." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return MarketplaceBrowseResult.from_dict(await self._client.request("session.plugins.marketplaces.browse", params_dict, **_timeout_kwargs(timeout))) + + async def refresh(self, params: SessionPluginsMarketplacesRefreshRequest | None = None, *, timeout: float | None = None) -> MarketplaceRefreshResult: + "Refreshes marketplaces resolved through the live session's working directory and retained managed policy.\n\nArgs:\n params: Optional marketplace name; omit to refresh all.\n\nReturns:\n Result of refreshing one or more marketplace catalogs." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} if params is not None else {} + params_dict["sessionId"] = self._session_id + return MarketplaceRefreshResult.from_dict(await self._client.request("session.plugins.marketplaces.refresh", params_dict, **_timeout_kwargs(timeout))) + + # Experimental: this API group is experimental and may change or be removed. class PluginsApi: def __init__(self, client: "JsonRpcClient", session_id: str): self._client = client self._session_id = session_id + self.marketplaces = PluginsMarketplacesApi(client, session_id) async def list(self, *, timeout: float | None = None) -> PluginList: - "Lists plugins installed for the session.\n\nReturns:\n Plugins installed for the session, with their enabled state and version metadata." + "Lists globally installed, live, built-in, and enterprise-managed desired plugins using the live session's authoritative account, working directory, and retained managed policy.\n\nReturns:\n Plugins installed for the session, with their enabled state and version metadata." return PluginList.from_dict(await self._client.request("session.plugins.list", {"sessionId": self._session_id}, **_timeout_kwargs(timeout))) + async def install(self, params: SessionPluginsInstallRequest, *, timeout: float | None = None) -> PluginInstallResult: + "Installs a plugin using the live session's authoritative account, working directory, and retained managed policy.\n\nArgs:\n params: Plugin source resolved relative to the session's authoritative working directory.\n\nReturns:\n Result of installing a plugin." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return PluginInstallResult.from_dict(await self._client.request("session.plugins.install", params_dict, **_timeout_kwargs(timeout))) + + async def uninstall(self, params: PluginsUninstallRequest, *, timeout: float | None = None) -> None: + "Uninstalls a plugin when permitted by the live session's retained managed policy.\n\nArgs:\n params: Name (or spec) of the plugin to uninstall." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + await self._client.request("session.plugins.uninstall", params_dict, **_timeout_kwargs(timeout)) + + async def update(self, params: PluginsUpdateRequest, *, timeout: float | None = None) -> PluginUpdateResult: + "Updates an installed plugin using the live session's authoritative account, working directory, and retained managed policy.\n\nArgs:\n params: Name (or spec) of the plugin to update.\n\nReturns:\n Result of updating a single plugin." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return PluginUpdateResult.from_dict(await self._client.request("session.plugins.update", params_dict, **_timeout_kwargs(timeout))) + + async def enable(self, params: SessionPluginsEnableRequest, *, timeout: float | None = None) -> None: + "Enables installed plugins when permitted by the live session's retained managed policy.\n\nArgs:\n params: Plugin names (or specs) to enable in the session's authoritative working directory." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + await self._client.request("session.plugins.enable", params_dict, **_timeout_kwargs(timeout)) + + async def disable(self, params: SessionPluginsDisableRequest, *, timeout: float | None = None) -> None: + "Disables installed plugins when permitted by the live session's retained managed policy.\n\nArgs:\n params: Plugin names (or specs) to disable in the session's authoritative working directory." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + await self._client.request("session.plugins.disable", params_dict, **_timeout_kwargs(timeout)) + async def reload(self, params: SessionPluginsReloadRequest | None = None, *, timeout: float | None = None) -> None: "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.\n\nArgs:\n params: Optional flags controlling which side effects the reload performs." params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} if params is not None else {} @@ -44476,6 +47888,18 @@ async def update_text(self, params: QueueUpdateTextRequest, *, timeout: float | params_dict["sessionId"] = self._session_id return QueueUpdateTextResult.from_dict(await self._client.request("session.queue.updateText", params_dict, **_timeout_kwargs(timeout))) + async def withdraw_message(self, params: QueueWithdrawMessageRequest, *, timeout: float | None = None) -> QueueRemoveAtResult: + "Atomically withdraws an unchanged, unconsumed user message from the local queued or steering lane. A client retaining the original draft may restore it only when removed is true. Does not interrupt the running turn.\n\nArgs:\n params: Conditional withdrawal of a single user message, before the runtime claims it for delivery.\n\nReturns:\n Result of removing a queued item." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return QueueRemoveAtResult.from_dict(await self._client.request("session.queue.withdrawMessage", params_dict, **_timeout_kwargs(timeout))) + + async def append_steering(self, params: QueueAppendSteeringRequest, *, timeout: float | None = None) -> QueueUpdateTextResult: + "Atomically appends text and attachments to an unchanged, unconsumed local steering message. Returns updated=false if delivery or withdrawal already claimed the message.\n\nArgs:\n params: Append to one pending steering message without changing its identity or delivery position.\n\nReturns:\n Result of editing a queued message." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return QueueUpdateTextResult.from_dict(await self._client.request("session.queue.appendSteering", params_dict, **_timeout_kwargs(timeout))) + async def duplicate_at(self, params: QueueDuplicateAtRequest, *, timeout: float | None = None) -> QueueDuplicateAtResult: "Duplicates an addressable queued item immediately after its source.\n\nArgs:\n params: Parameters for duplicating a queued item.\n\nReturns:\n Result of duplicating a queued item." params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} @@ -44623,6 +48047,7 @@ def __init__(self, client: "JsonRpcClient", session_id: str): self.debug = DebugApi(client, session_id) self.canvas = CanvasApi(client, session_id) self.factory = FactoryApi(client, session_id) + self.workflow = WorkflowApi(client, session_id) self.model = ModelApi(client, session_id) self.mode = ModeApi(client, session_id) self.name = NameApi(client, session_id) @@ -44636,6 +48061,7 @@ def __init__(self, client: "JsonRpcClient", session_id: str): self.tasks = TasksApi(client, session_id) self.skills = SkillsApi(client, session_id) self.mcp = McpApi(client, session_id) + self.managed_settings = ManagedSettingsApi(client, session_id) self.plugins = PluginsApi(client, session_id) self.provider = ProviderApi(client, session_id) self.options = OptionsApi(client, session_id) @@ -44802,6 +48228,31 @@ async def _pause_at_checkpoint(self, params: FactoryPauseCheckpointRequest, *, t return SessionFactoryPauseAtCheckpointResult.from_dict(await self._client.request("session.factory.pauseAtCheckpoint", params_dict, **_timeout_kwargs(timeout))) +# Experimental: this API group is experimental and may change or be removed. +class _InternalWorkflowApi: + def __init__(self, client: "JsonRpcClient", session_id: str): + self._client = client + self._session_id = session_id + + async def _run_from_tool(self, params: _WorkflowToolRunRequest, *, timeout: float | None = None) -> WorkflowRunResult: + "Internal tool-originated dynamic workflow invocation.\n\nArgs:\n params: Internal parameters for invoking a registered workflow from a tool.\n\nReturns:\n Complete current or terminal workflow run envelope.\n\n:meta private:\n\nInternal SDK API; not part of the public surface." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowRunResult.from_dict(await self._client.request("session.workflow.runFromTool", params_dict, **_timeout_kwargs(timeout))) + + async def _resume_from_tool(self, params: _WorkflowToolResumeRequest, *, timeout: float | None = None) -> WorkflowResumeResult: + "Internal tool-originated dynamic workflow resume.\n\nArgs:\n params: Internal parameters for resuming a workflow run from a tool.\n\nReturns:\n Resolved persisted workflow identity and resumed run envelope.\n\n:meta private:\n\nInternal SDK API; not part of the public surface." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return WorkflowResumeResult.from_dict(await self._client.request("session.workflow.resumeFromTool", params_dict, **_timeout_kwargs(timeout))) + + async def _pause_at_checkpoint(self, params: WorkflowPauseCheckpointRequest, *, timeout: float | None = None) -> SessionWorkflowPauseAtCheckpointResult: + "Atomically pauses an owned dynamic workflow attempt at a durable checkpoint.\n\nArgs:\n params: Parameters for an owned durable pause checkpoint.\n\n:meta private:\n\nInternal SDK API; not part of the public surface." + params_dict: dict[str, Any] = {k: v for k, v in params.to_dict().items() if v is not None} + params_dict["sessionId"] = self._session_id + return SessionWorkflowPauseAtCheckpointResult.from_dict(await self._client.request("session.workflow.pauseAtCheckpoint", params_dict, **_timeout_kwargs(timeout))) + + # Experimental: this API group is experimental and may change or be removed. class _InternalModelApi: def __init__(self, client: "JsonRpcClient", session_id: str): @@ -44976,6 +48427,7 @@ def __init__(self, client: "JsonRpcClient", session_id: str): self.git_hub_auth = _InternalGitHubAuthApi(client, session_id) self.canvas = _InternalCanvasApi(client, session_id) self.factory = _InternalFactoryApi(client, session_id) + self.workflow = _InternalWorkflowApi(client, session_id) self.model = _InternalModelApi(client, session_id) self.mcp = _InternalMcpApi(client, session_id) self.commands = _InternalCommandsApi(client, session_id) @@ -45005,6 +48457,15 @@ async def abort(self, params: FactoryAbortRequest) -> FactoryACKResult: "Asks the owning extension connection to abort a running factory cooperatively.\n\nArgs:\n params: Parameters for cooperatively aborting a factory body.\n\nReturns:\n Acknowledgement that a factory request was accepted." pass +# Experimental: this API group is experimental and may change or be removed. +class WorkflowHandler(Protocol): + async def execute(self, params: WorkflowExecuteRequest) -> WorkflowExecuteResult: + "Asks the owning extension connection to execute a registered dynamic workflow.\n\nArgs:\n params: Parameters sent to the owning extension to execute a workflow closure.\n\nReturns:\n Result returned by an extension workflow closure." + pass + async def abort(self, params: WorkflowAbortRequest) -> WorkflowACKResult: + "Asks the owning extension connection to abort a running dynamic workflow cooperatively.\n\nArgs:\n params: Parameters for cooperatively aborting a workflow body.\n\nReturns:\n Acknowledgement that a workflow request was accepted." + pass + # Experimental: this API group is experimental and may change or be removed. class TasksHandler(Protocol): async def cancel(self, params: ClientTaskCancelRequest) -> ClientTaskCancelResult: @@ -45069,6 +48530,7 @@ async def invoke(self, params: CanvasProviderInvokeActionRequest) -> Any: class ClientSessionApiHandlers: provider_token: ProviderTokenHandler | None = None factory: FactoryHandler | None = None + workflow: WorkflowHandler | None = None tasks: TasksHandler | None = None session_fs: SessionFsHandler | None = None canvas: CanvasHandler | None = None @@ -45099,6 +48561,20 @@ async def handle_factory_abort(params: dict) -> dict | None: result = await handler.abort(request) return result.to_dict() client.set_request_handler("factory.abort", handle_factory_abort) + async def handle_workflow_execute(params: dict) -> dict | None: + request = WorkflowExecuteRequest.from_dict(params) + handler = get_handlers(request.session_id).workflow + if handler is None: raise RuntimeError(f"No workflow handler registered for session: {request.session_id}") + result = await handler.execute(request) + return result.to_dict() + client.set_request_handler("workflow.execute", handle_workflow_execute) + async def handle_workflow_abort(params: dict) -> dict | None: + request = WorkflowAbortRequest.from_dict(params) + handler = get_handlers(request.session_id).workflow + if handler is None: raise RuntimeError(f"No workflow handler registered for session: {request.session_id}") + result = await handler.abort(request) + return result.to_dict() + client.set_request_handler("workflow.abort", handle_workflow_abort) async def handle_tasks_cancel(params: dict) -> dict | None: request = ClientTaskCancelRequest.from_dict(params) handler = get_handlers(request.session_id).tasks @@ -45415,6 +48891,13 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "CatalogAISkillCandidate", "CatalogAISkillCandidateKind", "CatalogAISkillCandidateProvenance", + "CatalogAISkillInstallability", + "CatalogAISkillMediaType", + "CatalogAgentPluginCandidate", + "CatalogAgentPluginCandidateKind", + "CatalogAgentPluginCandidateProvenance", + "CatalogAgentPluginCompatibilityTag", + "CatalogAgentPluginMediaType", "CatalogAuthenticationRequiredError", "CatalogAuthenticationRequiredErrorKind", "CatalogAuthenticationRequiredReason", @@ -45458,14 +48941,42 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "CatalogNotInstallableError", "CatalogNotInstallableErrorKind", "CatalogNotInstallableReason", + "CatalogPluginRepositorySource", "CatalogPolicyRejectedError", "CatalogPolicyRejectedErrorKind", + "CatalogResourceIdentity", + "CatalogResourceVersion", + "CatalogSearchPage", + "CatalogSearchPagination", "CatalogSearchRequest", "CatalogSearchResult", "CatalogSearchResultKind", "CatalogSearchResultReason", "CatalogSearchSucceeded", "CatalogSearchSucceededKind", + "CatalogSearchTotalCountRelation", + "CatalogSelectionCancelled", + "CatalogSelectionCancelledKind", + "CatalogSelectionDecision", + "CatalogSelectionDeclined", + "CatalogSelectionDeclinedKind", + "CatalogSelectionForeign", + "CatalogSelectionForeignKind", + "CatalogSelectionInvalid", + "CatalogSelectionInvalidKind", + "CatalogSelectionReplayed", + "CatalogSelectionReplayedKind", + "CatalogSelectionRequest", + "CatalogSelectionResult", + "CatalogSelectionResultKind", + "CatalogSelectionResultReason", + "CatalogSelectionSelected", + "CatalogSelectionSelectedKind", + "CatalogSelectionStale", + "CatalogSelectionTimedOut", + "CatalogSelectionTimedOutKind", + "CatalogSelectionWrongKind", + "CatalogSelectionWrongKindKind", "CatalogTrustEligibility", "CatalogTrustProvenance", "CatalogTrustSnapshot", @@ -45565,8 +49076,10 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "DiscoveredHook", "DiscoveredMCPServer", "DiscoveredMCPServerType", + "DurableOperation", "EnqueueCommandParams", "EnqueueCommandResult", + "EnterpriseList", "Entry", "EnvAuthInfo", "EnvAuthInfoType", @@ -45719,7 +49232,6 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "Host", "HostType", "InstallMethod", - "Installability", "InstalledPlugin", "InstalledPluginInfo", "InstalledPluginSource", @@ -45758,6 +49270,7 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "LlmInferenceHeaders", "LlmInferenceSetProviderResult", "LocalSessionMetadataValue", + "LogLineKind", "LogRequest", "LogResult", "LspApi", @@ -45915,7 +49428,9 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "MCPTools", "MCPUnregisterExternalClientRequest", "ManagedMCPServerConfig", + "ManagedSettingsApi", "ManagedSettingsReadResult", + "ManagedSettingsResolvedData", "MarketplaceAddResult", "MarketplaceBrowseResult", "MarketplaceInfo", @@ -45951,7 +49466,6 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "McpServerAuthConfig", "McpServerCardReference", "McpServerConfigHttpOauthGrantType", - "MediaType", "MemoryConfiguration", "MetadataApi", "MetadataContextAttributionResult", @@ -46027,6 +49541,7 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "OptionsUpdateEnvValueMode", "OptionsUpdateReasoningSummary", "OptionsUpdateToolFilterPrecedence", + "PauseCheckpointAction", "PauseInfoClass", "PauseInfoType", "PendingPermissionRequest", @@ -46081,7 +49596,6 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "PermissionDecisionApprovedForSessionKind", "PermissionDecisionApprovedKind", "PermissionDecisionCancelled", - "PermissionDecisionCancelledKind", "PermissionDecisionContext", "PermissionDecisionDeniedByContentExclusionPolicy", "PermissionDecisionDeniedByContentExclusionPolicyKind", @@ -46167,6 +49681,7 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "PermissionsSetRequiredResult", "PermissionsUrlsApi", "PermissionsUrlsSetUnrestrictedModeResult", + "PhaseStatus", "PingRequest", "PingResult", "PlanApi", @@ -46190,6 +49705,7 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "PluginsEnableRequest", "PluginsInstallRequest", "PluginsMarketplacesAddRequest", + "PluginsMarketplacesApi", "PluginsMarketplacesBrowseRequest", "PluginsMarketplacesRefreshRequest", "PluginsMarketplacesRemoveRequest", @@ -46271,6 +49787,7 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "PushAttachmentType", "PushGitHubRepoRef", "QueueApi", + "QueueAppendSteeringRequest", "QueueBeginDeferredIdleDrainRequest", "QueueBeginDeferredIdleDrainResult", "QueueConsumeSystemNotificationsRequest", @@ -46298,6 +49815,7 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "QueueSnapshotResult", "QueueUpdateTextRequest", "QueueUpdateTextResult", + "QueueWithdrawMessageRequest", "QueuedCommandHandled", "QueuedCommandNotHandled", "QueuedCommandResult", @@ -46334,7 +49852,9 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "RemoteSessionRepository", "ResponseFormat", "ResponseFormatType", + "RunFailureKind", "RunOptions", + "RunStatus", "SandboxApi", "SandboxConfig", "SandboxConfigAuth", @@ -46497,6 +50017,10 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "SessionOpenParams", "SessionOpenParamsKind", "SessionOpenResult", + "SessionPluginsDisableRequest", + "SessionPluginsEnableRequest", + "SessionPluginsInstallRequest", + "SessionPluginsMarketplacesRefreshRequest", "SessionPluginsReloadRequest", "SessionProviderGetEndpointRequest", "SessionPruneResult", @@ -46519,6 +50043,7 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "SessionUpdateOptionsParams", "SessionUpdateOptionsResult", "SessionVisibilityStatus", + "SessionWorkflowPauseAtCheckpointResult", "SessionWorkingDirectoryContext", "SessionWorkingDirectoryContextHostType", "SessionsBulkDeleteRequest", @@ -46645,6 +50170,7 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "SlashCommandShowDialogResultKind", "SlashCommandTextResult", "SlashCommandTimelineEntry", + "SourceClass", "SubagentSettings", "SubagentSettingsEntry", "SubagentSettingsEntryContextTier", @@ -46789,6 +50315,55 @@ async def handle_git_hub_token_get_token(params: dict) -> dict | None: "VisibilityGetResult", "VisibilitySetRequest", "VisibilitySetResult", + "WorkflowACKResult", + "WorkflowAbortRequest", + "WorkflowAgentOptions", + "WorkflowAgentRequest", + "WorkflowAgentResult", + "WorkflowAgentSummary", + "WorkflowApi", + "WorkflowCancelRequest", + "WorkflowCurrentPhase", + "WorkflowDeclaredLimits", + "WorkflowDurableOperation", + "WorkflowExecuteRequest", + "WorkflowExecuteResult", + "WorkflowGetRunProgressRequest", + "WorkflowGetRunRequest", + "WorkflowHandler", + "WorkflowJournalApi", + "WorkflowJournalGetRequest", + "WorkflowJournalGetResult", + "WorkflowJournalPutRequest", + "WorkflowListRunsRequest", + "WorkflowListRunsResult", + "WorkflowLogLine", + "WorkflowLogLineKind", + "WorkflowLogRequest", + "WorkflowPauseCheckpointAction", + "WorkflowPauseCheckpointRequest", + "WorkflowPauseCheckpointResult", + "WorkflowPauseInfo", + "WorkflowPauseRequest", + "WorkflowPhaseObservation", + "WorkflowPhaseStatus", + "WorkflowProgressLine", + "WorkflowProgressPage", + "WorkflowResumeRequest", + "WorkflowResumeResult", + "WorkflowRunConsumed", + "WorkflowRunDetail", + "WorkflowRunFailure", + "WorkflowRunFailureKind", + "WorkflowRunFailureType", + "WorkflowRunLimits", + "WorkflowRunOptions", + "WorkflowRunRequest", + "WorkflowRunResult", + "WorkflowRunStatus", + "WorkflowRunSummary", + "WorkflowRunTerminal", + "WorkflowRunTerminalPauseInfo", "Workspace", "WorkspaceDiffFileChange", "WorkspaceDiffFileChangeType", diff --git a/python/copilot/generated/session_events.py b/python/copilot/generated/session_events.py index f9cb382aab..5261019ae3 100644 --- a/python/copilot/generated/session_events.py +++ b/python/copilot/generated/session_events.py @@ -134,6 +134,7 @@ class SessionEventType(Enum): SESSION_SCHEDULE_REARMED = "session.schedule_rearmed" SESSION_AUTOPILOT_OBJECTIVE_CHANGED = "session.autopilot_objective_changed" SESSION_INFO = "session.info" + SESSION_INDEXED_SEARCH = "session.indexed_search" SESSION_WARNING = "session.warning" SESSION_MODEL_CHANGE = "session.model_change" # Experimental: this event is part of an experimental API and may change or be removed. @@ -168,6 +169,7 @@ class SessionEventType(Enum): SESSION_FUSION_RESOLVED = "session.fusion_resolved" # Experimental: this event is part of an experimental API and may change or be removed. SESSION_FUSION_COMPLETED = "session.fusion_completed" + SESSION_PERMISSION_RECOVERY = "session.permission_recovery" USER_MESSAGE = "user.message" PENDING_MESSAGES_MODIFIED = "pending_messages.modified" ASSISTANT_TURN_START = "assistant.turn_start" @@ -1497,6 +1499,7 @@ def to_dict(self) -> dict: class PermissionAssistedApproval: "Assisted-approval judge information attached to a permission request. Present only in assisted mode; its absence means the judge did not evaluate the request. The `recommendation` conveys the judge's disposition for this request." recommendation: AssistedApprovalRecommendation + evaluation: PermissionApprovalEvaluation | None = None failure_reason: AssistedApprovalJudgeFailureReason | None = None model: str | None = None reason: str | None = None @@ -1505,11 +1508,13 @@ class PermissionAssistedApproval: def from_dict(obj: Any) -> "PermissionAssistedApproval": assert isinstance(obj, dict) recommendation = parse_enum(AssistedApprovalRecommendation, obj.get("recommendation")) + evaluation = from_union([from_none, PermissionApprovalEvaluation.from_dict], obj.get("evaluation")) failure_reason = from_union([from_none, lambda x: parse_enum(AssistedApprovalJudgeFailureReason, x)], obj.get("failureReason")) model = from_union([from_none, from_str], obj.get("model")) reason = from_union([from_none, from_str], obj.get("reason")) return PermissionAssistedApproval( recommendation=recommendation, + evaluation=evaluation, failure_reason=failure_reason, model=model, reason=reason, @@ -1518,6 +1523,8 @@ def from_dict(obj: Any) -> "PermissionAssistedApproval": def to_dict(self) -> dict: result: dict = {} result["recommendation"] = to_enum(AssistedApprovalRecommendation, self.recommendation) + if self.evaluation is not None: + result["evaluation"] = from_union([from_none, lambda x: to_class(PermissionApprovalEvaluation, x)], self.evaluation) if self.failure_reason is not None: result["failureReason"] = from_union([from_none, lambda x: to_enum(AssistedApprovalJudgeFailureReason, x)], self.failure_reason) if self.model is not None: @@ -2497,6 +2504,38 @@ def to_dict(self) -> dict: return result +# Experimental: this type is part of an experimental API and may change or be removed. +@dataclass +class TaskBlocker: + "Structured reason that the task cannot continue without intervention" + kind: TaskBlockerKind + permission_recovery: PermissionRecoveryData + reason: PermissionRecoveryReason + resumable: bool + + @staticmethod + def from_dict(obj: Any) -> "TaskBlocker": + assert isinstance(obj, dict) + kind = parse_enum(TaskBlockerKind, obj.get("kind")) + permission_recovery = PermissionRecoveryData.from_dict(obj.get("permissionRecovery")) + reason = parse_enum(PermissionRecoveryReason, obj.get("reason")) + resumable = from_bool(obj.get("resumable")) + return TaskBlocker( + kind=kind, + permission_recovery=permission_recovery, + reason=reason, + resumable=resumable, + ) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = to_enum(TaskBlockerKind, self.kind) + result["permissionRecovery"] = to_class(PermissionRecoveryData, self.permission_recovery) + result["reason"] = to_enum(PermissionRecoveryReason, self.reason) + result["resumable"] = from_bool(self.resumable) + return result + + # Experimental: this type is part of an experimental API and may change or be removed. @dataclass class ToolExecutionCompleteShellExecution: @@ -3293,6 +3332,10 @@ class AssistantUsageData: rejected_prediction_tokens: int | None = None rte: bool | None = None service_request_id: str | None = None + # Internal: this field is an internal SDK API and is not part of the public surface. + _thinking_dropped_blocks: int | None = None + # Internal: this field is an internal SDK API and is not part of the public surface. + _thinking_dropped_reasons: list[str] | None = None time_to_first_token: timedelta | None = None # Internal: this field is an internal SDK API and is not part of the public surface. _tool_counts: dict[str, int] | None = None @@ -3340,6 +3383,8 @@ def from_dict(obj: Any) -> "AssistantUsageData": rejected_prediction_tokens = from_union([from_none, from_int], obj.get("rejectedPredictionTokens")) rte = from_union([from_none, from_bool], obj.get("rte")) service_request_id = from_union([from_none, from_str], obj.get("serviceRequestId")) + _thinking_dropped_blocks = from_union([from_none, from_int], obj.get("thinkingDroppedBlocks")) + _thinking_dropped_reasons = from_union([from_none, lambda x: from_list(from_str, x)], obj.get("thinkingDroppedReasons")) time_to_first_token = from_union([from_none, from_timedelta], obj.get("timeToFirstTokenMs")) _tool_counts = from_union([from_none, lambda x: from_dict(from_int, x)], obj.get("toolCounts")) _tool_token_count = from_union([from_none, from_int], obj.get("toolTokenCount")) @@ -3382,6 +3427,8 @@ def from_dict(obj: Any) -> "AssistantUsageData": rejected_prediction_tokens=rejected_prediction_tokens, rte=rte, service_request_id=service_request_id, + _thinking_dropped_blocks=_thinking_dropped_blocks, + _thinking_dropped_reasons=_thinking_dropped_reasons, time_to_first_token=time_to_first_token, _tool_counts=_tool_counts, _tool_token_count=_tool_token_count, @@ -3463,6 +3510,10 @@ def to_dict(self) -> dict: result["rte"] = from_union([from_none, from_bool], self.rte) if self.service_request_id is not None: result["serviceRequestId"] = from_union([from_none, from_str], self.service_request_id) + if self._thinking_dropped_blocks is not None: + result["thinkingDroppedBlocks"] = from_union([from_none, to_int], self._thinking_dropped_blocks) + if self._thinking_dropped_reasons is not None: + result["thinkingDroppedReasons"] = from_union([from_none, lambda x: from_list(from_str, x)], self._thinking_dropped_reasons) if self.time_to_first_token is not None: result["timeToFirstTokenMs"] = from_union([from_none, to_timedelta], self.time_to_first_token) if self._tool_counts is not None: @@ -6039,6 +6090,38 @@ def to_dict(self) -> dict: return {} +@dataclass +class PermissionApprovalEvaluation: + "Bounded runtime attribution, independent of free-text rationale. Telemetry revalidates this vocabulary before standard collection." + evaluation_stage: PermissionApprovalEvaluationEvaluationStage + judge_status: PermissionApprovalEvaluationJudgeStatus + reason_code: PermissionApprovalEvaluationReasonCode + judge_attempted: bool | None = None + + @staticmethod + def from_dict(obj: Any) -> "PermissionApprovalEvaluation": + assert isinstance(obj, dict) + evaluation_stage = parse_enum(PermissionApprovalEvaluationEvaluationStage, obj.get("evaluationStage")) + judge_status = parse_enum(PermissionApprovalEvaluationJudgeStatus, obj.get("judgeStatus")) + reason_code = parse_enum(PermissionApprovalEvaluationReasonCode, obj.get("reasonCode")) + judge_attempted = from_union([from_none, from_bool], obj.get("judgeAttempted")) + return PermissionApprovalEvaluation( + evaluation_stage=evaluation_stage, + judge_status=judge_status, + reason_code=reason_code, + judge_attempted=judge_attempted, + ) + + def to_dict(self) -> dict: + result: dict = {} + result["evaluationStage"] = to_enum(PermissionApprovalEvaluationEvaluationStage, self.evaluation_stage) + result["judgeStatus"] = to_enum(PermissionApprovalEvaluationJudgeStatus, self.judge_status) + result["reasonCode"] = to_enum(PermissionApprovalEvaluationReasonCode, self.reason_code) + if self.judge_attempted is not None: + result["judgeAttempted"] = from_union([from_none, from_bool], self.judge_attempted) + return result + + @dataclass class PermissionApproved: "Permission response variant indicating the request was approved without persisting an approval rule." @@ -6144,8 +6227,10 @@ class PermissionCompletedData: "Permission request completion notification signaling UI dismissal" request_id: str result: PermissionResult + blocker: TaskBlocker | None = None # Experimental: this field is part of an experimental API and may change or be removed. decision_source: PermissionDecisionSource | None = None + recovery_episode_id: str | None = None tool_call_id: str | None = None @staticmethod @@ -6153,12 +6238,16 @@ def from_dict(obj: Any) -> "PermissionCompletedData": assert isinstance(obj, dict) request_id = from_str(obj.get("requestId")) result = _load_PermissionResult(obj.get("result")) + blocker = from_union([from_none, TaskBlocker.from_dict], obj.get("blocker")) decision_source = from_union([from_none, lambda x: parse_enum(PermissionDecisionSource, x)], obj.get("decisionSource")) + recovery_episode_id = from_union([from_none, from_str], obj.get("recoveryEpisodeId")) tool_call_id = from_union([from_none, from_str], obj.get("toolCallId")) return PermissionCompletedData( request_id=request_id, result=result, + blocker=blocker, decision_source=decision_source, + recovery_episode_id=recovery_episode_id, tool_call_id=tool_call_id, ) @@ -6166,8 +6255,12 @@ def to_dict(self) -> dict: result: dict = {} result["requestId"] = from_str(self.request_id) result["result"] = self.result.to_dict() + if self.blocker is not None: + result["blocker"] = from_union([from_none, lambda x: to_class(TaskBlocker, x)], self.blocker) if self.decision_source is not None: result["decisionSource"] = from_union([from_none, lambda x: to_enum(PermissionDecisionSource, x)], self.decision_source) + if self.recovery_episode_id is not None: + result["recoveryEpisodeId"] = from_union([from_none, from_str], self.recovery_episode_id) if self.tool_call_id is not None: result["toolCallId"] = from_union([from_none, from_str], self.tool_call_id) return result @@ -6960,6 +7053,92 @@ def to_dict(self) -> dict: return result +@dataclass +class PermissionRecoveryAttempt: + attempt_id: str + disposition: PermissionRecoveryAttemptDisposition + ordinal: int + permission_kind: str + reason: PermissionRecoveryAttemptReason + relation: PermissionRecoveryAttemptRelation + request_fingerprint: str + tool_call_id: str | None = None + + @staticmethod + def from_dict(obj: Any) -> "PermissionRecoveryAttempt": + assert isinstance(obj, dict) + attempt_id = from_str(obj.get("attemptId")) + disposition = parse_enum(PermissionRecoveryAttemptDisposition, obj.get("disposition")) + ordinal = from_int(obj.get("ordinal")) + permission_kind = from_str(obj.get("permissionKind")) + reason = parse_enum(PermissionRecoveryAttemptReason, obj.get("reason")) + relation = parse_enum(PermissionRecoveryAttemptRelation, obj.get("relation")) + request_fingerprint = from_str(obj.get("requestFingerprint")) + tool_call_id = from_union([from_none, from_str], obj.get("toolCallId")) + return PermissionRecoveryAttempt( + attempt_id=attempt_id, + disposition=disposition, + ordinal=ordinal, + permission_kind=permission_kind, + reason=reason, + relation=relation, + request_fingerprint=request_fingerprint, + tool_call_id=tool_call_id, + ) + + def to_dict(self) -> dict: + result: dict = {} + result["attemptId"] = from_str(self.attempt_id) + result["disposition"] = to_enum(PermissionRecoveryAttemptDisposition, self.disposition) + result["ordinal"] = to_int(self.ordinal) + result["permissionKind"] = from_str(self.permission_kind) + result["reason"] = to_enum(PermissionRecoveryAttemptReason, self.reason) + result["relation"] = to_enum(PermissionRecoveryAttemptRelation, self.relation) + result["requestFingerprint"] = from_str(self.request_fingerprint) + if self.tool_call_id is not None: + result["toolCallId"] = from_union([from_none, from_str], self.tool_call_id) + return result + + +@dataclass +class PermissionRecoveryData: + "Authoritative snapshot of an Autopilot permission-recovery episode" + attempts: list[PermissionRecoveryAttempt] + episode_id: str + max_attempts: int + on_blocked: PermissionRecoveryOnBlocked + reason: PermissionRecoveryReason + status: PermissionRecoveryStatus + + @staticmethod + def from_dict(obj: Any) -> "PermissionRecoveryData": + assert isinstance(obj, dict) + attempts = from_list(PermissionRecoveryAttempt.from_dict, obj.get("attempts")) + episode_id = from_str(obj.get("episodeId")) + max_attempts = from_int(obj.get("maxAttempts")) + on_blocked = parse_enum(PermissionRecoveryOnBlocked, obj.get("onBlocked")) + reason = parse_enum(PermissionRecoveryReason, obj.get("reason")) + status = parse_enum(PermissionRecoveryStatus, obj.get("status")) + return PermissionRecoveryData( + attempts=attempts, + episode_id=episode_id, + max_attempts=max_attempts, + on_blocked=on_blocked, + reason=reason, + status=status, + ) + + def to_dict(self) -> dict: + result: dict = {} + result["attempts"] = from_list(lambda x: to_class(PermissionRecoveryAttempt, x), self.attempts) + result["episodeId"] = from_str(self.episode_id) + result["maxAttempts"] = to_int(self.max_attempts) + result["onBlocked"] = to_enum(PermissionRecoveryOnBlocked, self.on_blocked) + result["reason"] = to_enum(PermissionRecoveryReason, self.reason) + result["status"] = to_enum(PermissionRecoveryStatus, self.status) + return result + + @dataclass class PermissionRequestCustomTool: "Custom tool invocation permission request" @@ -7697,7 +7876,9 @@ class PermissionRequestedData: permission_request: PermissionRequest request_id: str agent_mode: SessionMode | None = None + permission_mode: PermissionMode | None = None prompt_request: PermissionPromptRequest | None = None + recovery_episode_id: str | None = None resolved_by_hook: bool | None = None risk_assessment: Any = None @@ -7707,14 +7888,18 @@ def from_dict(obj: Any) -> "PermissionRequestedData": permission_request = _load_PermissionRequest(obj.get("permissionRequest")) request_id = from_str(obj.get("requestId")) agent_mode = from_union([from_none, lambda x: parse_enum(SessionMode, x)], obj.get("agentMode")) + permission_mode = from_union([from_none, lambda x: parse_enum(PermissionMode, x)], obj.get("permissionMode")) prompt_request = from_union([from_none, _load_PermissionPromptRequest], obj.get("promptRequest")) + recovery_episode_id = from_union([from_none, from_str], obj.get("recoveryEpisodeId")) resolved_by_hook = from_union([from_none, from_bool], obj.get("resolvedByHook")) risk_assessment = obj.get("riskAssessment") return PermissionRequestedData( permission_request=permission_request, request_id=request_id, agent_mode=agent_mode, + permission_mode=permission_mode, prompt_request=prompt_request, + recovery_episode_id=recovery_episode_id, resolved_by_hook=resolved_by_hook, risk_assessment=risk_assessment, ) @@ -7725,8 +7910,12 @@ def to_dict(self) -> dict: result["requestId"] = from_str(self.request_id) if self.agent_mode is not None: result["agentMode"] = from_union([from_none, lambda x: to_enum(SessionMode, x)], self.agent_mode) + if self.permission_mode is not None: + result["permissionMode"] = from_union([from_none, lambda x: to_enum(PermissionMode, x)], self.permission_mode) if self.prompt_request is not None: result["promptRequest"] = from_union([from_none, lambda x: x.to_dict()], self.prompt_request) + if self.recovery_episode_id is not None: + result["recoveryEpisodeId"] = from_union([from_none, from_str], self.recovery_episode_id) if self.resolved_by_hook is not None: result["resolvedByHook"] = from_union([from_none, from_bool], self.resolved_by_hook) if self.risk_assessment is not None: @@ -7935,6 +8124,33 @@ def to_dict(self) -> dict: return result +@dataclass +class ResponsesReasoning: + "Original request-level and effective conversation reasoning effort for a Responses history boundary" + effort: str + initial_effort: str + model: str + + @staticmethod + def from_dict(obj: Any) -> "ResponsesReasoning": + assert isinstance(obj, dict) + effort = from_str(obj.get("effort")) + initial_effort = from_str(obj.get("initialEffort")) + model = from_str(obj.get("model")) + return ResponsesReasoning( + effort=effort, + initial_effort=initial_effort, + model=model, + ) + + def to_dict(self) -> dict: + result: dict = {} + result["effort"] = from_str(self.effort) + result["initialEffort"] = from_str(self.initial_effort) + result["model"] = from_str(self.model) + return result + + @dataclass class SamplingCompletedData: "Sampling request completion notification signaling UI dismissal" @@ -7984,13 +8200,183 @@ def to_dict(self) -> dict: @dataclass class SandboxDecisionData: "Payload of `sandbox.decision`, a bounded governance record of what the process sandbox was configured to do and whether it took effect. Discriminated by `kind`." + control: SandboxControl + enforcement_point: SandboxEnforcementPoint + kind: SandboxDecisionDataKind + outcome: SandboxOutcome + platform: SandboxPlatform + add_current_working_directory: bool | None = None + allow_bypass: bool | None = None + allow_local_network: bool | None = None + allow_outbound: bool | None = None + attestation: SandboxAttestation | None = None + backend: SandboxBackend | None = None + command: str | None = None + confidence: SandboxDenialConfidence | None = None + degradation_reason: SandboxDegradationReason | None = None + denial_class: SandboxDenialClass | None = None + denied_paths_count: int | None = None + denied_resource: str | None = None + duration_ms: float | None = None + effective_filesystem_policy: SandboxFilesystemPolicyDetails | None = None + gh_auth: bool | None = None + git_auth: bool | None = None + keychain_access: bool | None = None + policy_source: SandboxPolicySource | None = None + process_name: str | None = None + proxy_mode: SandboxProxyMode | None = None + readonly_paths_count: int | None = None + readwrite_paths_count: int | None = None + source: SandboxBypassSource | None = None + tool_call_id: str | None = None + @staticmethod def from_dict(obj: Any) -> "SandboxDecisionData": assert isinstance(obj, dict) - return SandboxDecisionData() + control = parse_enum(SandboxControl, obj.get("control")) + enforcement_point = parse_enum(SandboxEnforcementPoint, obj.get("enforcementPoint")) + kind = parse_enum(SandboxDecisionDataKind, obj.get("kind")) + outcome = parse_enum(SandboxOutcome, obj.get("outcome")) + platform = parse_enum(SandboxPlatform, obj.get("platform")) + add_current_working_directory = from_union([from_none, from_bool], obj.get("addCurrentWorkingDirectory")) + allow_bypass = from_union([from_none, from_bool], obj.get("allowBypass")) + allow_local_network = from_union([from_none, from_bool], obj.get("allowLocalNetwork")) + allow_outbound = from_union([from_none, from_bool], obj.get("allowOutbound")) + attestation = from_union([from_none, lambda x: parse_enum(SandboxAttestation, x)], obj.get("attestation")) + backend = from_union([from_none, lambda x: parse_enum(SandboxBackend, x)], obj.get("backend")) + command = from_union([from_none, from_str], obj.get("command")) + confidence = from_union([from_none, lambda x: parse_enum(SandboxDenialConfidence, x)], obj.get("confidence")) + degradation_reason = from_union([from_none, lambda x: parse_enum(SandboxDegradationReason, x)], obj.get("degradationReason")) + denial_class = from_union([from_none, lambda x: parse_enum(SandboxDenialClass, x)], obj.get("denialClass")) + denied_paths_count = from_union([from_none, from_int], obj.get("deniedPathsCount")) + denied_resource = from_union([from_none, from_str], obj.get("deniedResource")) + duration_ms = from_union([from_none, from_float], obj.get("durationMs")) + effective_filesystem_policy = from_union([from_none, SandboxFilesystemPolicyDetails.from_dict], obj.get("effectiveFilesystemPolicy")) + gh_auth = from_union([from_none, from_bool], obj.get("ghAuth")) + git_auth = from_union([from_none, from_bool], obj.get("gitAuth")) + keychain_access = from_union([from_none, from_bool], obj.get("keychainAccess")) + policy_source = from_union([from_none, lambda x: parse_enum(SandboxPolicySource, x)], obj.get("policySource")) + process_name = from_union([from_none, from_str], obj.get("processName")) + proxy_mode = from_union([from_none, lambda x: parse_enum(SandboxProxyMode, x)], obj.get("proxyMode")) + readonly_paths_count = from_union([from_none, from_int], obj.get("readonlyPathsCount")) + readwrite_paths_count = from_union([from_none, from_int], obj.get("readwritePathsCount")) + source = from_union([from_none, lambda x: parse_enum(SandboxBypassSource, x)], obj.get("source")) + tool_call_id = from_union([from_none, from_str], obj.get("toolCallId")) + return SandboxDecisionData( + control=control, + enforcement_point=enforcement_point, + kind=kind, + outcome=outcome, + platform=platform, + add_current_working_directory=add_current_working_directory, + allow_bypass=allow_bypass, + allow_local_network=allow_local_network, + allow_outbound=allow_outbound, + attestation=attestation, + backend=backend, + command=command, + confidence=confidence, + degradation_reason=degradation_reason, + denial_class=denial_class, + denied_paths_count=denied_paths_count, + denied_resource=denied_resource, + duration_ms=duration_ms, + effective_filesystem_policy=effective_filesystem_policy, + gh_auth=gh_auth, + git_auth=git_auth, + keychain_access=keychain_access, + policy_source=policy_source, + process_name=process_name, + proxy_mode=proxy_mode, + readonly_paths_count=readonly_paths_count, + readwrite_paths_count=readwrite_paths_count, + source=source, + tool_call_id=tool_call_id, + ) def to_dict(self) -> dict: - return {} + result: dict = {} + result["control"] = to_enum(SandboxControl, self.control) + result["enforcementPoint"] = to_enum(SandboxEnforcementPoint, self.enforcement_point) + result["kind"] = to_enum(SandboxDecisionDataKind, self.kind) + result["outcome"] = to_enum(SandboxOutcome, self.outcome) + result["platform"] = to_enum(SandboxPlatform, self.platform) + if self.add_current_working_directory is not None: + result["addCurrentWorkingDirectory"] = from_union([from_none, from_bool], self.add_current_working_directory) + if self.allow_bypass is not None: + result["allowBypass"] = from_union([from_none, from_bool], self.allow_bypass) + if self.allow_local_network is not None: + result["allowLocalNetwork"] = from_union([from_none, from_bool], self.allow_local_network) + if self.allow_outbound is not None: + result["allowOutbound"] = from_union([from_none, from_bool], self.allow_outbound) + if self.attestation is not None: + result["attestation"] = from_union([from_none, lambda x: to_enum(SandboxAttestation, x)], self.attestation) + if self.backend is not None: + result["backend"] = from_union([from_none, lambda x: to_enum(SandboxBackend, x)], self.backend) + if self.command is not None: + result["command"] = from_union([from_none, from_str], self.command) + if self.confidence is not None: + result["confidence"] = from_union([from_none, lambda x: to_enum(SandboxDenialConfidence, x)], self.confidence) + if self.degradation_reason is not None: + result["degradationReason"] = from_union([from_none, lambda x: to_enum(SandboxDegradationReason, x)], self.degradation_reason) + if self.denial_class is not None: + result["denialClass"] = from_union([from_none, lambda x: to_enum(SandboxDenialClass, x)], self.denial_class) + if self.denied_paths_count is not None: + result["deniedPathsCount"] = from_union([from_none, to_int], self.denied_paths_count) + if self.denied_resource is not None: + result["deniedResource"] = from_union([from_none, from_str], self.denied_resource) + if self.duration_ms is not None: + result["durationMs"] = from_union([from_none, to_float], self.duration_ms) + if self.effective_filesystem_policy is not None: + result["effectiveFilesystemPolicy"] = from_union([from_none, lambda x: to_class(SandboxFilesystemPolicyDetails, x)], self.effective_filesystem_policy) + if self.gh_auth is not None: + result["ghAuth"] = from_union([from_none, from_bool], self.gh_auth) + if self.git_auth is not None: + result["gitAuth"] = from_union([from_none, from_bool], self.git_auth) + if self.keychain_access is not None: + result["keychainAccess"] = from_union([from_none, from_bool], self.keychain_access) + if self.policy_source is not None: + result["policySource"] = from_union([from_none, lambda x: to_enum(SandboxPolicySource, x)], self.policy_source) + if self.process_name is not None: + result["processName"] = from_union([from_none, from_str], self.process_name) + if self.proxy_mode is not None: + result["proxyMode"] = from_union([from_none, lambda x: to_enum(SandboxProxyMode, x)], self.proxy_mode) + if self.readonly_paths_count is not None: + result["readonlyPathsCount"] = from_union([from_none, to_int], self.readonly_paths_count) + if self.readwrite_paths_count is not None: + result["readwritePathsCount"] = from_union([from_none, to_int], self.readwrite_paths_count) + if self.source is not None: + result["source"] = from_union([from_none, lambda x: to_enum(SandboxBypassSource, x)], self.source) + if self.tool_call_id is not None: + result["toolCallId"] = from_union([from_none, from_str], self.tool_call_id) + return result + + +@dataclass +class SandboxFilesystemPolicyDetails: + "Effective sandbox filesystem rules, in policy order. Only populated when content capture is enabled, since these are real host paths." + denied_paths: list[str] + readonly_paths: list[str] + readwrite_paths: list[str] + + @staticmethod + def from_dict(obj: Any) -> "SandboxFilesystemPolicyDetails": + assert isinstance(obj, dict) + denied_paths = from_list(from_str, obj.get("deniedPaths")) + readonly_paths = from_list(from_str, obj.get("readonlyPaths")) + readwrite_paths = from_list(from_str, obj.get("readwritePaths")) + return SandboxFilesystemPolicyDetails( + denied_paths=denied_paths, + readonly_paths=readonly_paths, + readwrite_paths=readwrite_paths, + ) + + def to_dict(self) -> dict: + result: dict = {} + result["deniedPaths"] = from_list(from_str, self.denied_paths) + result["readonlyPaths"] = from_list(from_str, self.readonly_paths) + result["readwritePaths"] = from_list(from_str, self.readwrite_paths) + return result @dataclass @@ -8125,6 +8511,7 @@ class SessionCompactionCompleteData: pre_compaction_messages_length: int | None = None pre_compaction_tokens: int | None = None request_id: str | None = None + responses_reasoning: ResponsesReasoning | None = None service_request_id: str | None = None status_code: int | None = None summary_content: str | None = None @@ -8151,6 +8538,7 @@ def from_dict(obj: Any) -> "SessionCompactionCompleteData": pre_compaction_messages_length = from_union([from_none, from_int], obj.get("preCompactionMessagesLength")) pre_compaction_tokens = from_union([from_none, from_int], obj.get("preCompactionTokens")) request_id = from_union([from_none, from_str], obj.get("requestId")) + responses_reasoning = from_union([from_none, ResponsesReasoning.from_dict], obj.get("responsesReasoning")) service_request_id = from_union([from_none, from_str], obj.get("serviceRequestId")) status_code = from_union([from_none, from_int], obj.get("statusCode")) summary_content = from_union([from_none, from_str], obj.get("summaryContent")) @@ -8174,6 +8562,7 @@ def from_dict(obj: Any) -> "SessionCompactionCompleteData": pre_compaction_messages_length=pre_compaction_messages_length, pre_compaction_tokens=pre_compaction_tokens, request_id=request_id, + responses_reasoning=responses_reasoning, service_request_id=service_request_id, status_code=status_code, summary_content=summary_content, @@ -8213,6 +8602,8 @@ def to_dict(self) -> dict: result["preCompactionTokens"] = from_union([from_none, to_int], self.pre_compaction_tokens) if self.request_id is not None: result["requestId"] = from_union([from_none, from_str], self.request_id) + if self.responses_reasoning is not None: + result["responsesReasoning"] = from_union([from_none, lambda x: to_class(ResponsesReasoning, x)], self.responses_reasoning) if self.service_request_id is not None: result["serviceRequestId"] = from_union([from_none, from_str], self.service_request_id) if self.status_code is not None: @@ -8603,6 +8994,120 @@ def to_dict(self) -> dict: return result +@dataclass +class SessionIndexedSearchData: + "Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history." + kind: SessionIndexedSearchDataKind + added_file_count: float | None = None + changed_file_count: float | None = None + deleted_file_count: float | None = None + disabled_reason: IndexedSearchDisabledReason | None = None + eligible: bool | None = None + error_message: str | None = None + error_type: IndexedSearchErrorType | None = None + exit_code: float | None = None + file_count: float | None = None + forced_by_env: bool | None = None + outcome: IndexedSearchOutcome | None = None + phase: IndexedSearchIncrementalPhase | None = None + startup_duration_ms: float | None = None + state: IndexedSearchState | None = None + total_change_count: float | None = None + total_duration_ms: float | None = None + update_duration_ms: float | None = None + walk_duration_ms: float | None = None + warm_start: bool | None = None + + @staticmethod + def from_dict(obj: Any) -> "SessionIndexedSearchData": + assert isinstance(obj, dict) + kind = parse_enum(SessionIndexedSearchDataKind, obj.get("kind")) + added_file_count = from_union([from_none, from_float], obj.get("addedFileCount")) + changed_file_count = from_union([from_none, from_float], obj.get("changedFileCount")) + deleted_file_count = from_union([from_none, from_float], obj.get("deletedFileCount")) + disabled_reason = from_union([from_none, lambda x: parse_enum(IndexedSearchDisabledReason, x)], obj.get("disabledReason")) + eligible = from_union([from_none, from_bool], obj.get("eligible")) + error_message = from_union([from_none, from_str], obj.get("errorMessage")) + error_type = from_union([from_none, lambda x: parse_enum(IndexedSearchErrorType, x)], obj.get("errorType")) + exit_code = from_union([from_none, from_float], obj.get("exitCode")) + file_count = from_union([from_none, from_float], obj.get("fileCount")) + forced_by_env = from_union([from_none, from_bool], obj.get("forcedByEnv")) + outcome = from_union([from_none, lambda x: parse_enum(IndexedSearchOutcome, x)], obj.get("outcome")) + phase = from_union([from_none, lambda x: parse_enum(IndexedSearchIncrementalPhase, x)], obj.get("phase")) + startup_duration_ms = from_union([from_none, from_float], obj.get("startupDurationMs")) + state = from_union([from_none, lambda x: parse_enum(IndexedSearchState, x)], obj.get("state")) + total_change_count = from_union([from_none, from_float], obj.get("totalChangeCount")) + total_duration_ms = from_union([from_none, from_float], obj.get("totalDurationMs")) + update_duration_ms = from_union([from_none, from_float], obj.get("updateDurationMs")) + walk_duration_ms = from_union([from_none, from_float], obj.get("walkDurationMs")) + warm_start = from_union([from_none, from_bool], obj.get("warmStart")) + return SessionIndexedSearchData( + kind=kind, + added_file_count=added_file_count, + changed_file_count=changed_file_count, + deleted_file_count=deleted_file_count, + disabled_reason=disabled_reason, + eligible=eligible, + error_message=error_message, + error_type=error_type, + exit_code=exit_code, + file_count=file_count, + forced_by_env=forced_by_env, + outcome=outcome, + phase=phase, + startup_duration_ms=startup_duration_ms, + state=state, + total_change_count=total_change_count, + total_duration_ms=total_duration_ms, + update_duration_ms=update_duration_ms, + walk_duration_ms=walk_duration_ms, + warm_start=warm_start, + ) + + def to_dict(self) -> dict: + result: dict = {} + result["kind"] = to_enum(SessionIndexedSearchDataKind, self.kind) + if self.added_file_count is not None: + result["addedFileCount"] = from_union([from_none, to_float], self.added_file_count) + if self.changed_file_count is not None: + result["changedFileCount"] = from_union([from_none, to_float], self.changed_file_count) + if self.deleted_file_count is not None: + result["deletedFileCount"] = from_union([from_none, to_float], self.deleted_file_count) + if self.disabled_reason is not None: + result["disabledReason"] = from_union([from_none, lambda x: to_enum(IndexedSearchDisabledReason, x)], self.disabled_reason) + if self.eligible is not None: + result["eligible"] = from_union([from_none, from_bool], self.eligible) + if self.error_message is not None: + result["errorMessage"] = from_union([from_none, from_str], self.error_message) + if self.error_type is not None: + result["errorType"] = from_union([from_none, lambda x: to_enum(IndexedSearchErrorType, x)], self.error_type) + if self.exit_code is not None: + result["exitCode"] = from_union([from_none, to_float], self.exit_code) + if self.file_count is not None: + result["fileCount"] = from_union([from_none, to_float], self.file_count) + if self.forced_by_env is not None: + result["forcedByEnv"] = from_union([from_none, from_bool], self.forced_by_env) + if self.outcome is not None: + result["outcome"] = from_union([from_none, lambda x: to_enum(IndexedSearchOutcome, x)], self.outcome) + if self.phase is not None: + result["phase"] = from_union([from_none, lambda x: to_enum(IndexedSearchIncrementalPhase, x)], self.phase) + if self.startup_duration_ms is not None: + result["startupDurationMs"] = from_union([from_none, to_float], self.startup_duration_ms) + if self.state is not None: + result["state"] = from_union([from_none, lambda x: to_enum(IndexedSearchState, x)], self.state) + if self.total_change_count is not None: + result["totalChangeCount"] = from_union([from_none, to_float], self.total_change_count) + if self.total_duration_ms is not None: + result["totalDurationMs"] = from_union([from_none, to_float], self.total_duration_ms) + if self.update_duration_ms is not None: + result["updateDurationMs"] = from_union([from_none, to_float], self.update_duration_ms) + if self.walk_duration_ms is not None: + result["walkDurationMs"] = from_union([from_none, to_float], self.walk_duration_ms) + if self.warm_start is not None: + result["warmStart"] = from_union([from_none, from_bool], self.warm_start) + return result + + @dataclass class SessionInfoData: "Informational message for timeline display with categorization" @@ -8946,6 +9451,45 @@ def to_dict(self) -> dict: return result +@dataclass +class SessionPermissionRecoveryData: + "Authoritative snapshot of an Autopilot permission-recovery episode" + attempts: list[PermissionRecoveryAttempt] + episode_id: str + max_attempts: int + on_blocked: PermissionRecoveryOnBlocked + reason: PermissionRecoveryReason + status: PermissionRecoveryStatus + + @staticmethod + def from_dict(obj: Any) -> "SessionPermissionRecoveryData": + assert isinstance(obj, dict) + attempts = from_list(PermissionRecoveryAttempt.from_dict, obj.get("attempts")) + episode_id = from_str(obj.get("episodeId")) + max_attempts = from_int(obj.get("maxAttempts")) + on_blocked = parse_enum(PermissionRecoveryOnBlocked, obj.get("onBlocked")) + reason = parse_enum(PermissionRecoveryReason, obj.get("reason")) + status = parse_enum(PermissionRecoveryStatus, obj.get("status")) + return SessionPermissionRecoveryData( + attempts=attempts, + episode_id=episode_id, + max_attempts=max_attempts, + on_blocked=on_blocked, + reason=reason, + status=status, + ) + + def to_dict(self) -> dict: + result: dict = {} + result["attempts"] = from_list(lambda x: to_class(PermissionRecoveryAttempt, x), self.attempts) + result["episodeId"] = from_str(self.episode_id) + result["maxAttempts"] = to_int(self.max_attempts) + result["onBlocked"] = to_enum(PermissionRecoveryOnBlocked, self.on_blocked) + result["reason"] = to_enum(PermissionRecoveryReason, self.reason) + result["status"] = to_enum(PermissionRecoveryStatus, self.status) + return result + + @dataclass class SessionPlanChangedData: "Plan file operation details indicating what changed" @@ -9428,6 +9972,7 @@ def to_dict(self) -> dict: @dataclass class SessionTaskCompleteData: "Task completion notification with summary from the agent" + blocker: TaskBlocker | None = None objective_id: int | None = None outcome: TaskCompletionOutcome | None = None reason: str | None = None @@ -9437,12 +9982,14 @@ class SessionTaskCompleteData: @staticmethod def from_dict(obj: Any) -> "SessionTaskCompleteData": assert isinstance(obj, dict) + blocker = from_union([from_none, TaskBlocker.from_dict], obj.get("blocker")) objective_id = from_union([from_none, from_int], obj.get("objectiveId")) outcome = from_union([from_none, lambda x: parse_enum(TaskCompletionOutcome, x)], obj.get("outcome")) reason = from_union([from_none, from_str], obj.get("reason")) success = from_union([from_none, from_bool], obj.get("success")) summary = from_union([from_none, from_str], obj.get("summary")) return SessionTaskCompleteData( + blocker=blocker, objective_id=objective_id, outcome=outcome, reason=reason, @@ -9452,6 +9999,8 @@ def from_dict(obj: Any) -> "SessionTaskCompleteData": def to_dict(self) -> dict: result: dict = {} + if self.blocker is not None: + result["blocker"] = from_union([from_none, lambda x: to_class(TaskBlocker, x)], self.blocker) if self.objective_id is not None: result["objectiveId"] = from_union([from_none, to_int], self.objective_id) if self.outcome is not None: @@ -9976,6 +10525,7 @@ class SkillInvokedData: allowed_tools: list[str] | None = None description: str | None = None disable_model_invocation: bool | None = None + invoked_at_turn: int | None = None model: str | None = None plugin_name: str | None = None plugin_version: str | None = None @@ -9991,6 +10541,7 @@ def from_dict(obj: Any) -> "SkillInvokedData": allowed_tools = from_union([from_none, lambda x: from_list(from_str, x)], obj.get("allowedTools")) description = from_union([from_none, from_str], obj.get("description")) disable_model_invocation = from_union([from_none, from_bool], obj.get("disableModelInvocation")) + invoked_at_turn = from_union([from_none, from_int], obj.get("invokedAtTurn")) model = from_union([from_none, from_str], obj.get("model")) plugin_name = from_union([from_none, from_str], obj.get("pluginName")) plugin_version = from_union([from_none, from_str], obj.get("pluginVersion")) @@ -10003,6 +10554,7 @@ def from_dict(obj: Any) -> "SkillInvokedData": allowed_tools=allowed_tools, description=description, disable_model_invocation=disable_model_invocation, + invoked_at_turn=invoked_at_turn, model=model, plugin_name=plugin_name, plugin_version=plugin_version, @@ -10021,6 +10573,8 @@ def to_dict(self) -> dict: result["description"] = from_union([from_none, from_str], self.description) if self.disable_model_invocation is not None: result["disableModelInvocation"] = from_union([from_none, from_bool], self.disable_model_invocation) + if self.invoked_at_turn is not None: + result["invokedAtTurn"] = from_union([from_none, to_int], self.invoked_at_turn) if self.model is not None: result["model"] = from_union([from_none, from_str], self.model) if self.plugin_name is not None: @@ -10044,6 +10598,7 @@ class SkillInvokedRefData: allowed_tools: list[str] | None = None description: str | None = None disable_model_invocation: bool | None = None + invoked_at_turn: int | None = None model: str | None = None plugin_name: str | None = None plugin_version: str | None = None @@ -10060,6 +10615,7 @@ def from_dict(obj: Any) -> "SkillInvokedRefData": allowed_tools = from_union([from_none, lambda x: from_list(from_str, x)], obj.get("allowedTools")) description = from_union([from_none, from_str], obj.get("description")) disable_model_invocation = from_union([from_none, from_bool], obj.get("disableModelInvocation")) + invoked_at_turn = from_union([from_none, from_int], obj.get("invokedAtTurn")) model = from_union([from_none, from_str], obj.get("model")) plugin_name = from_union([from_none, from_str], obj.get("pluginName")) plugin_version = from_union([from_none, from_str], obj.get("pluginVersion")) @@ -10073,6 +10629,7 @@ def from_dict(obj: Any) -> "SkillInvokedRefData": allowed_tools=allowed_tools, description=description, disable_model_invocation=disable_model_invocation, + invoked_at_turn=invoked_at_turn, model=model, plugin_name=plugin_name, plugin_version=plugin_version, @@ -10092,6 +10649,8 @@ def to_dict(self) -> dict: result["description"] = from_union([from_none, from_str], self.description) if self.disable_model_invocation is not None: result["disableModelInvocation"] = from_union([from_none, from_bool], self.disable_model_invocation) + if self.invoked_at_turn is not None: + result["invokedAtTurn"] = from_union([from_none, to_int], self.invoked_at_turn) if self.model is not None: result["model"] = from_union([from_none, from_str], self.model) if self.plugin_name is not None: @@ -10618,21 +11177,26 @@ class SystemNotificationData: "System-generated notification for runtime events like background task completion" content: str kind: SystemNotification + responses_reasoning: ResponsesReasoning | None = None @staticmethod def from_dict(obj: Any) -> "SystemNotificationData": assert isinstance(obj, dict) content = from_str(obj.get("content")) kind = _load_SystemNotification(obj.get("kind")) + responses_reasoning = from_union([from_none, ResponsesReasoning.from_dict], obj.get("responsesReasoning")) return SystemNotificationData( content=content, kind=kind, + responses_reasoning=responses_reasoning, ) def to_dict(self) -> dict: result: dict = {} result["content"] = from_str(self.content) result["kind"] = self.kind.to_dict() + if self.responses_reasoning is not None: + result["responsesReasoning"] = from_union([from_none, lambda x: to_class(ResponsesReasoning, x)], self.responses_reasoning) return result @@ -11962,6 +12526,7 @@ class UserMessageData: message_id: str | None = None native_document_path_fallback_paths: list[str] | None = None parent_agent_task_id: str | None = None + responses_reasoning: ResponsesReasoning | None = None source: str | None = None supported_native_document_mime_types: list[str] | None = None transformed_content: str | None = None @@ -11979,6 +12544,7 @@ def from_dict(obj: Any) -> "UserMessageData": message_id = from_union([from_none, from_str], obj.get("messageId")) native_document_path_fallback_paths = from_union([from_none, lambda x: from_list(from_str, x)], obj.get("nativeDocumentPathFallbackPaths")) parent_agent_task_id = from_union([from_none, from_str], obj.get("parentAgentTaskId")) + responses_reasoning = from_union([from_none, ResponsesReasoning.from_dict], obj.get("responsesReasoning")) source = from_union([from_none, from_str], obj.get("source")) supported_native_document_mime_types = from_union([from_none, lambda x: from_list(from_str, x)], obj.get("supportedNativeDocumentMimeTypes")) transformed_content = from_union([from_none, from_str], obj.get("transformedContent")) @@ -11993,6 +12559,7 @@ def from_dict(obj: Any) -> "UserMessageData": message_id=message_id, native_document_path_fallback_paths=native_document_path_fallback_paths, parent_agent_task_id=parent_agent_task_id, + responses_reasoning=responses_reasoning, source=source, supported_native_document_mime_types=supported_native_document_mime_types, transformed_content=transformed_content, @@ -12018,6 +12585,8 @@ def to_dict(self) -> dict: result["nativeDocumentPathFallbackPaths"] = from_union([from_none, lambda x: from_list(from_str, x)], self.native_document_path_fallback_paths) if self.parent_agent_task_id is not None: result["parentAgentTaskId"] = from_union([from_none, from_str], self.parent_agent_task_id) + if self.responses_reasoning is not None: + result["responsesReasoning"] = from_union([from_none, lambda x: to_class(ResponsesReasoning, x)], self.responses_reasoning) if self.source is not None: result["source"] = from_union([from_none, from_str], self.source) if self.supported_native_document_mime_types is not None: @@ -12935,6 +13504,76 @@ class HandoffSourceType(Enum): LOCAL = "local" +class IndexedSearchDisabledReason(Enum): + "Configuration, policy, or workspace condition that disabled indexed search." + # Indexed search was explicitly disabled by the environment. + USE_TGREP_FALSE = "use_tgrep_false" + # Search uses the external ripgrep binary instead of bundled search. + USE_BUILTIN_RIPGREP_FALSE = "use_builtin_ripgrep_false" + # Organization policy disables indexed search. + ORGANIZATION = "organization" + # Authentication has not resolved organization policy. + ORGANIZATION_POLICY_AUTH_PENDING = "organization_policy_auth_pending" + # Organization policy could not be determined. + ORGANIZATION_POLICY_UNKNOWN = "organization_policy_unknown" + # The workspace uses a virtualized or network filesystem. + VIRTUAL_FILESYSTEM = "virtual_filesystem" + # The workspace is inside a Windows cloud-sync root. + CLOUD_SYNC_ROOT = "cloud_sync_root" + # The Windows cloud-sync safety check failed. + CLOUD_SYNC_DETECTION_FAILED = "cloud_sync_detection_failed" + # The workspace is not available on the runtime's local filesystem. + WORKSPACE_NOT_LOCAL = "workspace_not_local" + + +class IndexedSearchErrorType(Enum): + "Category of an indexed-search server failure." + # The indexed-search server could not be spawned. + SPAWN_ERROR = "spawn_error" + # The indexed-search server exited unexpectedly. + UNEXPECTED_EXIT = "unexpected_exit" + # The indexed-search server was terminated by a signal. + KILLED_BY_SIGNAL = "killed_by_signal" + + +class IndexedSearchIncrementalPhase(Enum): + "Phase of an incremental indexed-search update." + # A workspace scan found changes to index. + CHANGES_DETECTED = "changes_detected" + # The incremental index update completed. + UPDATED = "updated" + + +class IndexedSearchOutcome(Enum): + "Result of an indexed-search startup attempt." + # A new indexed-search server was started. + STARTED = "started" + # The repository has too few files for automatic indexing. + SKIPPED_BELOW_THRESHOLD = "skipped_below_threshold" + # No Git repository was found and indexing was not forced. + SKIPPED_NO_GITROOT = "skipped_no_gitroot" + # Configuration, policy, or workspace safety disabled indexing. + SKIPPED_DISABLED = "skipped_disabled" + # An existing indexed-search server was reused. + REUSED_EXISTING = "reused_existing" + # The startup attempt failed. + FAILED = "failed" + + +class IndexedSearchState(Enum): + "Live indexed-search state for this session activation, never inferred from persisted history." + # Indexed search is not active for this session. + DISABLED = "disabled" + # Indexed-search startup is in progress. + STARTING = "starting" + # The indexed-search server started successfully; its index may still be warming. + ENABLED = "enabled" + # The indexed-search server and its index are ready. + READY = "ready" + # Indexed-search startup or the active server failed. + FAILED = "failed" + + class ManagedSettingsEnforcedAction(Enum): "The category of runtime action that enterprise managed settings governed (blocked or capped)" # An attempt to turn on a bypass-permissions ("yolo") escalation was refused or capped because policy disables bypass-permissions mode. @@ -13127,6 +13766,8 @@ class ModelChangeSource(Enum): PLAN_MODE = "plan_mode" # The runtime selected the model automatically, such as rate-limit recovery or refusal fallback. AUTOMATIC = "automatic" + # The user selected the promoted model from the changeboarding card or its keyboard shortcut. + CHANGEBOARDING_SHORTCUT = "changeboarding_shortcut" # An SDK or RPC caller selected the model. SDK = "sdk" @@ -13147,6 +13788,92 @@ class OmittedBinaryType(Enum): RESOURCE = "resource" +class PermissionApprovalEvaluationEvaluationStage(Enum): + "Stage that produced this attribution." + # The attribution stage is unknown. + UNKNOWN = "unknown" + # The request resolved before assisted-approval evaluation. + NOT_REACHED = "not_reached" + # A runtime gate skipped the judge. + PRE_JUDGE = "pre_judge" + # The judge interface produced the evaluation. + JUDGE = "judge" + # A cached recommendation or another request's outcome was reused. + REUSE = "reuse" + + +class PermissionApprovalEvaluationJudgeStatus(Enum): + "Status of the local judge interface, not proof of a model network call." + # No authoritative attribution is available. + UNKNOWN = "unknown" + # This evaluation did not invoke the judge interface. + NOT_CALLED = "not_called" + # The judge interface returned a usable verdict. + COMPLETED = "completed" + # The judge interface returned an error. + FAILED = "failed" + # This evaluation reused a cached recommendation. + CACHED = "cached" + # This request inherited another decision without local judge attribution. + INHERITED = "inherited" + + +class PermissionApprovalEvaluationReasonCode(Enum): + "Machine-readable runtime gate reason, never a command, path or human rationale." + # Attribution is missing or outside the supported vocabulary. + UNKNOWN = "unknown" + # The request resolved before assisted-approval evaluation. + NOT_REACHED = "not-reached" + # Assisted approval was inactive for this request. + INACTIVE = "inactive" + # The judge was skipped because authorization extraction could not safely establish a complete recent history. + AUTHORIZATION_HISTORY_INCOMPLETE = "authorization-history-incomplete" + # Managed policy required a human decision. + MANAGED_APPROVAL_REQUIRED = "managed-approval-required" + # The request asked to bypass sandbox restrictions. + SANDBOX_BYPASS = "sandbox-bypass" + # An action field exceeded the judge input limit. + ACTION_TOO_LONG = "action-too-long" + # The script path was not authorized for inspection. + PATH_NOT_AUTHORIZED = "path-not-authorized" + # The script working directory was invalid. + INVALID_WORKING_DIRECTORY = "invalid-working-directory" + # The script snapshot could not be read. + UNREADABLE = "unreadable" + # The script path was not a regular file. + NOT_REGULAR_FILE = "not-regular-file" + # The script snapshot exceeded the size limit. + TOO_LARGE = "too-large" + # The script snapshot was not UTF-8. + NON_UTF8 = "non-utf8" + # The script interpreter could not be inspected. + INTERPRETER_UNAVAILABLE = "interpreter-unavailable" + # The interpreter snapshot exceeded the size limit. + INTERPRETER_TOO_LARGE = "interpreter-too-large" + # The shell environment could not be reviewed. + SHELL_ENVIRONMENT_UNREVIEWABLE = "shell-environment-unreviewable" + # A script path could not be represented for review. + UNREPRESENTABLE_PATH = "unrepresentable-path" + # An interpreter wrapped a script that could not be reviewed. + INTERPRETER_WRAPPED_SCRIPT = "interpreter-wrapped-script" + # The script invocation could not be reviewed. + UNREVIEWABLE_SCRIPT_INVOCATION = "unreviewable-script-invocation" + # The script argument binding could not be reviewed. + ARGUMENT_BINDING_UNREVIEWABLE = "argument-binding-unreviewable" + # The script review metadata was malformed. + MALFORMED_SCRIPT_ACTION_REVIEW = "malformed-script-action-review" + # The script snapshot manifest was malformed. + MALFORMED_SCRIPT_ACTION_MANIFEST = "malformed-script-action-manifest" + # Script review was unavailable. + UNAVAILABLE = "unavailable" + # The judge interface returned a usable verdict. + JUDGE_VERDICT = "judge-verdict" + # The judge interface returned an error. + JUDGE_ERROR = "judge-error" + # The request inherited an outcome from another decision. + INHERITED = "inherited" + + class PermissionDecisionSource(Enum): "Controlled reason or actor responsible for a permission response." # The response followed the assisted-approval judge recommendation. @@ -13171,6 +13898,88 @@ class PermissionPromptRequestPathAccessKind(Enum): WRITE = "write" +class PermissionRecoveryAttemptDisposition(Enum): + "Runtime handling applied to a recovery attempt" + # The request was denied without prompting so the agent could try an alternative. + DEFERRED = "deferred" + # The request was surfaced to an interactive responder. + PROMPTED = "prompted" + # The interactive responder approved the request. + APPROVED = "approved" + # The interactive responder denied the request or became unavailable. + DENIED = "denied" + # The request exhausted unattended recovery and produced a blocked outcome. + BLOCKED = "blocked" + # A tool call succeeded as an equivalent alternative. + SUCCEEDED = "succeeded" + + +class PermissionRecoveryAttemptReason(Enum): + "Controlled reason for an individual attempt disposition" + # The attempt required permission that Assisted Permissions could not grant. + PERMISSION_REQUIRED = "permission_required" + # The request repeated an earlier attempt. + REPEATED_ATTEMPT = "repeated_attempt" + # The request exceeded the bounded number of distinct attempts. + ATTEMPTS_EXHAUSTED = "attempts_exhausted" + # The interactive responder approved the request. + PERMISSION_APPROVED = "permission_approved" + # The interactive responder denied the request. + PERMISSION_DENIED = "permission_denied" + # The interactive responder became unavailable. + RESPONDER_UNAVAILABLE = "responder_unavailable" + # The tool call succeeded without the blocked permission. + EQUIVALENT_ALTERNATIVE_SUCCEEDED = "equivalent_alternative_succeeded" + + +class PermissionRecoveryAttemptRelation(Enum): + "Relationship of an attempt to earlier permission requests" + # The first denied permission request in the episode. + INITIAL = "initial" + # A request equivalent to an earlier attempt. + RETRY = "retry" + # A distinct request or a successful alternative tool call. + ALTERNATIVE = "alternative" + + +class PermissionRecoveryOnBlocked(Enum): + "Action selected when autonomous recovery cannot continue" + # Surface the existing permission prompt to a response-capable client. + ASK = "ask" + # Return a structured unsuccessful blocked outcome because no responder is available. + FAIL = "fail" + + +class PermissionRecoveryReason(Enum): + "Controlled reason for a permission-recovery episode transition" + # An action required permission that Assisted Permissions could not grant. + PERMISSION_REQUIRED = "permission_required" + # The agent repeated an equivalent permission request instead of making progress. + REPEATED_ATTEMPT = "repeated_attempt" + # The bounded number of distinct permission attempts was exhausted. + ATTEMPTS_EXHAUSTED = "attempts_exhausted" + # A responder approved the escalated permission request. + PERMISSION_APPROVED = "permission_approved" + # A responder denied the escalated permission request. + PERMISSION_DENIED = "permission_denied" + # The response-capable client became unavailable while escalation was pending. + RESPONDER_UNAVAILABLE = "responder_unavailable" + # A later tool call succeeded without requiring the blocked permission. + EQUIVALENT_ALTERNATIVE_SUCCEEDED = "equivalent_alternative_succeeded" + + +class PermissionRecoveryStatus(Enum): + "Lifecycle state of a permission-recovery episode" + # Autopilot may try a bounded equivalent alternative. + RECOVERING = "recovering" + # An interactive permission response is required. + AWAITING_APPROVAL = "awaiting_approval" + # The episode ended through approval or a successful equivalent alternative. + RESOLVED = "resolved" + # No autonomous path remains and the task requires intervention. + BLOCKED = "blocked" + + class PermissionRequestMemoryAction(Enum): "Whether this is a store or vote memory operation" # Store a new memory. @@ -13247,6 +14056,185 @@ class RemediationAction(Enum): ALLOW_SANDBOX_OUTBOUND = "allow_sandbox_outbound" +class SandboxAttestation(Enum): + "Runtime observation backing an enforcement-state or denial claim. Absent on `enforcement_state` when no observation backs the state." + # A containment backend accepted and applied the spawn request. + SPAWN_SUCCEEDED = "spawn_succeeded" + # The spawn was refused for lack of a usable containment backend. + UNSUPPORTED = "unsupported" + # A runtime-owned policy check ran and returned a verdict. Attests the check, not that the caller honoured it. + BUILTIN_POLICY_CHECKED = "builtin_policy_checked" + + +class SandboxBackend(Enum): + "Process-containment backend selected for the host platform" + # Apple Seatbelt process sandbox. + SEATBELT = "seatbelt" + # Linux Bubblewrap process sandbox. + BUBBLEWRAP = "bubblewrap" + # Windows ProcessContainer sandbox. + PROCESS_CONTAINER = "process_container" + # No supported process-containment backend is available. + UNSUPPORTED = "unsupported" + + +class SandboxBypassSource(Enum): + "Where a request to run outside the process sandbox originated. Orthogonal to the outcome: the same verdict means a different thing depending on where the request came from." + # No longer produced. The model could once ask for a bypass in the tool call itself; no tool exposes that parameter now. Retained so historical events still deserialize. + MODEL_REQUESTED = "model_requested" + # The runtime raised the prompt itself — either after a sandboxed attempt looked blocked, or before a run the sandbox cannot enforce at all, such as a detached command — and a person answered it. In the second case nothing had executed when the decision was made. + USER_PROMPTED = "user_prompted" + # The runtime raised the prompt itself — after a sandboxed attempt looked blocked, or before a run it cannot enforce — but the permission flow produced no confirmed human answer. This includes unavailable or unreadable prompts, cancellation, and automated rule, hook, or content-exclusion denials. + PROMPT_UNAVAILABLE = "prompt_unavailable" + + +class SandboxControl(Enum): + "Customer-controllable sandbox governance area" + # Process containment and sandbox spawn behavior. + PROCESS = "process" + # Filesystem read, write, and deny policy. + FILESYSTEM = "filesystem" + # Outbound and local-network access policy. + NETWORK = "network" + # Selection of the sandbox or built-in enforcement route. + ROUTING = "routing" + # Decisions to run outside the process sandbox, whether requested by the model or resolved by a person. + BYPASS = "bypass" + # Credential and keychain capability injection. + CREDENTIALS = "credentials" + # Host-platform and backend support behavior. + PLATFORM = "platform" + + +class SandboxDecisionDataKind(Enum): + "Payload of `sandbox.decision`, a bounded governance record of what the process sandbox was configured to do and whether it took effect. Discriminated by `kind`. discriminator" + POLICY_RESOLVED = "policy_resolved" + SPAWN_COMPLETED = "spawn_completed" + ENFORCEMENT_STATE = "enforcement_state" + ACCESS_DENIED = "access_denied" + BYPASS_DECIDED = "bypass_decided" + PERMISSIVE_RETRY_DECIDED = "permissive_retry_decided" + PERMISSIVE_RETRY_COMPLETED = "permissive_retry_completed" + + +class SandboxDegradationReason(Enum): + "Finite reason why sandbox enforcement is weaker than configured" + # The selected backend cannot enforce per-path deny rules. + DENIED_PATHS_UNSUPPORTED = "denied_paths_unsupported" + # The host platform has no supported process-containment backend. + UNSUPPORTED_PLATFORM = "unsupported_platform" + + +class SandboxDenialClass(Enum): + "Bounded class of access an enforcement check refused. Raw resources, commands, and process names accompany it only when content capture is enabled; diagnostic text and matched rules are never exported." + # A read was refused because the effective policy does not grant it. + FILESYSTEM_READ = "filesystem_read" + # A write was refused. Distinct from `filesystem_read` because a read-only grant denies writes to a path it otherwise permits. + FILESYSTEM_WRITE = "filesystem_write" + # A process could not start because the sandbox refused a required process-scoped resource. Currently emitted for the Windows MSYS `BaseNamedObjects` fork failure confirmed by learning-mode capture. + PROCESS_STARTUP = "process_startup" + # Windows registry access was refused and correlated with capture evidence. + REGISTRY_ACCESS = "registry_access" + # Windows ALPC or RPC access was refused and correlated with capture evidence. + IPC_ACCESS = "ipc_access" + # Access to another Windows process was refused and correlated with capture evidence. + PROCESS_ACCESS = "process_access" + # Windows job-object access was refused and correlated with capture evidence. + JOB_ACCESS = "job_access" + # Windows UI-handle access was refused and correlated with capture evidence. + UI_ACCESS = "ui_access" + # Windows service-control-manager access was refused and correlated with capture evidence. + SERVICE_ACCESS = "service_access" + # An outbound connection was refused by `network.allowOutbound`. + NETWORK_OUTBOUND = "network_outbound" + # A connection to a local or loopback destination was refused by `network.allowLocalNetwork`. + NETWORK_LOCAL = "network_local" + # A destination was refused by the sandbox host allow/deny rules. + NETWORK_HOST = "network_host" + # The sandbox's denial capture recorded a refusal its record does not attribute to a more specific control: an unclassified resource (registry, COM, section object) or an AppContainer capability with no network meaning. Deliberately generic — the capture proves the denial happened, and naming a narrower class than the record supports would be a guess. + OTHER_ACCESS = "other_access" + + +class SandboxDenialConfidence(Enum): + "How strong the evidence behind a denial is. A denial the sandbox itself recorded is a fact; one inferred from a command's output text is a judgement, and an analysis that cannot tell them apart will treat a false positive as enforcement." + # The sandbox's own denial capture recorded the refused access. The strongest evidence available: the kernel observed it, not the runtime. + CAPTURED = "captured" + # The command named a path that the effective policy independently denies. No capture confirmed it, but the policy did. + POLICY_CORROBORATED = "policy_corroborated" + # The failure carried a fingerprint the sandbox itself emits, so the sandbox is known to have refused something even though the resource was not confirmed. + SANDBOX_REPORTED = "sandbox_reported" + # Classified from the command's own output text alone. The weakest evidence: a command that merely prints sandbox-like wording reaches this level. + OUTPUT_CLASSIFIED = "output_classified" + + +class SandboxEnforcementPoint(Enum): + "Runtime boundary that enforced or routed a sandbox decision" + # Shell command process containment. + SHELL = "shell" + # Built-in filesystem policy enforcement. + BUILTIN_FILESYSTEM = "builtin_filesystem" + # Search-tool sandbox or policy enforcement. + SEARCH = "search" + # Web-fetch network policy enforcement. + WEB_FETCH = "web_fetch" + # Model Context Protocol server routing. + MCP = "mcp" + # Language server process routing. + LSP = "lsp" + + +class SandboxOutcome(Enum): + "Finite result of a sandbox decision. Each `SandboxDecisionData` variant uses a disjoint subset: `policy_resolved` is `resolved | degraded`, `spawn_completed` and `permissive_retry_completed` are `succeeded | failed`, `enforcement_state` is `engaged | inactive | failed`, `access_denied` is `denied`, and escalation decisions are `approved | declined`." + # The sandbox policy resolved successfully. Describes configuration only and makes no claim that a backend engaged. + RESOLVED = "resolved" + # No sandbox governed the workload. + INACTIVE = "inactive" + # A runtime-owned containment backend accepted the workload. Evidence of engagement, not of verified containment for the workload's lifetime. + ENGAGED = "engaged" + # The sandbox operation completed successfully. + SUCCEEDED = "succeeded" + # The sandbox operation failed. + FAILED = "failed" + # The sandbox is active with one or more controls weakened by platform limitations or an explicitly selected relaxed mode. + DEGRADED = "degraded" + # An enforcement check refused the requested access. + DENIED = "denied" + # A request to run outside the process sandbox was granted. + APPROVED = "approved" + # A request to run outside the process sandbox was not granted. + DECLINED = "declined" + + +class SandboxPlatform(Enum): + "Host operating-system family used for sandbox enforcement" + # Apple macOS host. + MACOS = "macos" + # Linux host. + LINUX = "linux" + # Microsoft Windows host. + WINDOWS = "windows" + # Host platform outside the explicitly supported families. + OTHER = "other" + + +class SandboxPolicySource(Enum): + "Origin of the effective sandbox policy" + # Runtime default sandbox policy. + DEFAULT_POLICY = "default_policy" + # User-configured sandbox policy merged with runtime-required grants. + USER_POLICY = "user_policy" + + +class SandboxProxyMode(Enum): + "Bounded classification of effective sandbox proxy routing" + # No sandbox proxy is configured. + NONE = "none" + # Traffic routes through a loopback proxy. + LOOPBACK = "loopback" + # Traffic routes through a non-loopback proxy endpoint. + EXTERNAL = "external" + + class ScheduleOrigin(Enum): "Who created the schedule: `user` (an explicit user action such as `/every` or `/after`) or `model` (the agent via the `manage_schedule` tool). Gates whether a scheduled skill that opted out of model invocation may fire: only user-created schedules may." # The schedule was created by an explicit user action, such as `/every` or `/after`. @@ -13255,6 +14243,14 @@ class ScheduleOrigin(Enum): MODEL = "model" +class SessionIndexedSearchDataKind(Enum): + "Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. discriminator" + STATUS = "status" + STARTUP = "startup" + SERVER_ERROR = "server_error" + INCREMENTAL = "incremental" + + class SessionLimitsExhaustedResponseAction(Enum): "User action selected for an exhausted session limit." # Increase the current max by an exact AI Credits amount. @@ -13381,6 +14377,12 @@ class SystemNotificationFactoryPauseInfoType(Enum): CHECKPOINT = "checkpoint" +class TaskBlockerKind(Enum): + "Category of structured task blocker" + # Autopilot permission recovery requires intervention or has no safe autonomous path. + PERMISSION_RECOVERY = "permission_recovery" + + class TaskCompletionOutcome(Enum): "Semantic result of evaluating a task completion request" # The completion request was accepted and the objective is complete. @@ -13463,7 +14465,7 @@ class WorkspaceFileChangedOperation(Enum): UPDATE = "update" -SessionEventData = SessionStartData | SessionResumeData | SessionRemoteSteerableChangedData | SessionErrorData | SessionIdleData | SessionTitleChangedData | SessionScheduleCreatedData | SessionScheduleCancelledData | SessionScheduleRearmedData | SessionAutopilotObjectiveChangedData | SessionInfoData | SessionWarningData | SessionModelChangeData | SessionAutoTierRecommendationData | SessionAutoTierSwitchFailedData | SessionModeChangedData | SessionModeNoticeDeliveredData | SessionSessionLimitsChangedData | SessionPermissionsChangedData | SessionPlanChangedData | SessionTodosChangedData | SessionWorkspaceFileChangedData | SessionHandoffData | SessionTruncationData | SessionSnapshotRewindData | SessionShutdownData | SessionUsageCheckpointData | SessionContextChangedData | SessionUsageInfoData | SessionContextClearedData | SessionCompactionStartData | SessionCompactionCompleteData | SessionTaskCompleteData | SessionCompletionReceiptData | SessionFusionRouteStartedData | SessionFusionRouteFailedData | SessionFusionResolvedData | SessionFusionCompletedData | UserMessageData | PendingMessagesModifiedData | AssistantTurnStartData | AssistantTurnRetryData | AgentInterruptedData | AssistantIntentData | AssistantFusionPhaseStartedData | AssistantFusionPhaseActivityData | AssistantFusionPhaseCompletedData | AssistantFusionPhaseFailedData | AssistantServerToolProgressData | AssistantReasoningData | AssistantReasoningDeltaData | AssistantToolCallDeltaData | AssistantStreamingDeltaData | AssistantMessageData | AssistantMessageStartData | AssistantMessageDeltaData | AssistantTurnEndData | AssistantIdleData | AssistantUsageData | PromptCacheBreakData | ModelCallFailureData | ModelCallFinishedData | ModelCallStartData | AbortData | ToolUserRequestedData | ToolExecutionStartData | ToolExecutionPartialResultData | ToolExecutionProgressData | ToolExecutionCompleteData | ToolSearchActivatedData | SkillInvokedData | SkillInvokedRefData | SkillContextDeliveredData | SkillContextDeliveredRefData | SandboxDecisionData | SubagentStartedData | SubagentConfiguredData | SubagentCompletedData | SubagentFailedData | SubagentSelectedData | SubagentDeselectedData | HookStartData | HookEndData | HookProgressData | SessionBinaryAssetData | SystemMessageData | SystemNotificationData | PermissionRequestedData | PermissionCompletedData | PermissionCarriedForwardData | PermissionMessageAuthorizationData | PermissionMessageAuthorizationReadData | PermissionMessageAuthorizationDegradedData | PermissionAssentDetectedData | PermissionContextualAuthorizationData | UserInputRequestedData | UserInputCompletedData | ElicitationRequestedData | ElicitationCompletedData | SamplingRequestedData | SamplingCompletedData | McpOauthRequiredData | McpOauthCompletedData | McpHeadersRefreshRequiredData | McpHeadersRefreshCompletedData | SessionCustomNotificationData | UiEphemeralQueryData | ExternalToolRequestedData | ExternalToolCompletedData | CommandQueuedData | CommandExecuteData | CommandCompletedData | AutoModeSwitchRequestedData | AutoModeSwitchCompletedData | SessionLimitsExhaustedRequestedData | SessionLimitsExhaustedCompletedData | SessionAutoModeResolvedData | SessionManagedSettingsResolvedData | SessionManagedSettingsEnforcedData | CommandsChangedData | CapabilitiesChangedData | ExitPlanModeRequestedData | ExitPlanModeCompletedData | SessionToolsUpdatedData | SessionBackgroundTasksChangedData | FactoryRunUpdatedData | FactoryRunStartedData | FactoryRunSettledData | SessionSkillsLoadedData | SessionCustomAgentsUpdatedData | SessionMcpServersLoadedData | SessionMcpServerStatusChangedData | SessionMcpServerRemovedData | SessionMcpServerNeedsReconnectData | McpToolsListChangedData | McpResourcesListChangedData | McpPromptsListChangedData | SessionExtensionsLoadedData | SessionCanvasOpenedData | SessionCanvasRegistryChangedData | SessionCanvasClosedData | SessionCanvasUnavailableData | SessionCanvasRecordedData | SessionCanvasRemovedData | SessionExtensionsAttachmentsPushedData | McpAppToolCallCompleteData | RawSessionEventData | Data +SessionEventData = SessionStartData | SessionResumeData | SessionRemoteSteerableChangedData | SessionErrorData | SessionIdleData | SessionTitleChangedData | SessionScheduleCreatedData | SessionScheduleCancelledData | SessionScheduleRearmedData | SessionAutopilotObjectiveChangedData | SessionInfoData | SessionIndexedSearchData | SessionWarningData | SessionModelChangeData | SessionAutoTierRecommendationData | SessionAutoTierSwitchFailedData | SessionModeChangedData | SessionModeNoticeDeliveredData | SessionSessionLimitsChangedData | SessionPermissionsChangedData | SessionPlanChangedData | SessionTodosChangedData | SessionWorkspaceFileChangedData | SessionHandoffData | SessionTruncationData | SessionSnapshotRewindData | SessionShutdownData | SessionUsageCheckpointData | SessionContextChangedData | SessionUsageInfoData | SessionContextClearedData | SessionCompactionStartData | SessionCompactionCompleteData | SessionTaskCompleteData | SessionCompletionReceiptData | SessionFusionRouteStartedData | SessionFusionRouteFailedData | SessionFusionResolvedData | SessionFusionCompletedData | SessionPermissionRecoveryData | UserMessageData | PendingMessagesModifiedData | AssistantTurnStartData | AssistantTurnRetryData | AgentInterruptedData | AssistantIntentData | AssistantFusionPhaseStartedData | AssistantFusionPhaseActivityData | AssistantFusionPhaseCompletedData | AssistantFusionPhaseFailedData | AssistantServerToolProgressData | AssistantReasoningData | AssistantReasoningDeltaData | AssistantToolCallDeltaData | AssistantStreamingDeltaData | AssistantMessageData | AssistantMessageStartData | AssistantMessageDeltaData | AssistantTurnEndData | AssistantIdleData | AssistantUsageData | PromptCacheBreakData | ModelCallFailureData | ModelCallFinishedData | ModelCallStartData | AbortData | ToolUserRequestedData | ToolExecutionStartData | ToolExecutionPartialResultData | ToolExecutionProgressData | ToolExecutionCompleteData | ToolSearchActivatedData | SkillInvokedData | SkillInvokedRefData | SkillContextDeliveredData | SkillContextDeliveredRefData | SandboxDecisionData | SubagentStartedData | SubagentConfiguredData | SubagentCompletedData | SubagentFailedData | SubagentSelectedData | SubagentDeselectedData | HookStartData | HookEndData | HookProgressData | SessionBinaryAssetData | SystemMessageData | SystemNotificationData | PermissionRequestedData | PermissionCompletedData | PermissionCarriedForwardData | PermissionMessageAuthorizationData | PermissionMessageAuthorizationReadData | PermissionMessageAuthorizationDegradedData | PermissionAssentDetectedData | PermissionContextualAuthorizationData | UserInputRequestedData | UserInputCompletedData | ElicitationRequestedData | ElicitationCompletedData | SamplingRequestedData | SamplingCompletedData | McpOauthRequiredData | McpOauthCompletedData | McpHeadersRefreshRequiredData | McpHeadersRefreshCompletedData | SessionCustomNotificationData | UiEphemeralQueryData | ExternalToolRequestedData | ExternalToolCompletedData | CommandQueuedData | CommandExecuteData | CommandCompletedData | AutoModeSwitchRequestedData | AutoModeSwitchCompletedData | SessionLimitsExhaustedRequestedData | SessionLimitsExhaustedCompletedData | SessionAutoModeResolvedData | SessionManagedSettingsResolvedData | SessionManagedSettingsEnforcedData | CommandsChangedData | CapabilitiesChangedData | ExitPlanModeRequestedData | ExitPlanModeCompletedData | SessionToolsUpdatedData | SessionBackgroundTasksChangedData | FactoryRunUpdatedData | FactoryRunStartedData | FactoryRunSettledData | SessionSkillsLoadedData | SessionCustomAgentsUpdatedData | SessionMcpServersLoadedData | SessionMcpServerStatusChangedData | SessionMcpServerRemovedData | SessionMcpServerNeedsReconnectData | McpToolsListChangedData | McpResourcesListChangedData | McpPromptsListChangedData | SessionExtensionsLoadedData | SessionCanvasOpenedData | SessionCanvasRegistryChangedData | SessionCanvasClosedData | SessionCanvasUnavailableData | SessionCanvasRecordedData | SessionCanvasRemovedData | SessionExtensionsAttachmentsPushedData | McpAppToolCallCompleteData | RawSessionEventData | Data @dataclass @@ -13500,6 +14502,7 @@ def from_dict(obj: Any) -> "SessionEvent": case SessionEventType.SESSION_SCHEDULE_REARMED: data = SessionScheduleRearmedData.from_dict(data_obj) case SessionEventType.SESSION_AUTOPILOT_OBJECTIVE_CHANGED: data = SessionAutopilotObjectiveChangedData.from_dict(data_obj) case SessionEventType.SESSION_INFO: data = SessionInfoData.from_dict(data_obj) + case SessionEventType.SESSION_INDEXED_SEARCH: data = SessionIndexedSearchData.from_dict(data_obj) case SessionEventType.SESSION_WARNING: data = SessionWarningData.from_dict(data_obj) case SessionEventType.SESSION_MODEL_CHANGE: data = SessionModelChangeData.from_dict(data_obj) case SessionEventType.SESSION_AUTO_TIER_RECOMMENDATION: data = SessionAutoTierRecommendationData.from_dict(data_obj) @@ -13527,6 +14530,7 @@ def from_dict(obj: Any) -> "SessionEvent": case SessionEventType.SESSION_FUSION_ROUTE_FAILED: data = SessionFusionRouteFailedData.from_dict(data_obj) case SessionEventType.SESSION_FUSION_RESOLVED: data = SessionFusionResolvedData.from_dict(data_obj) case SessionEventType.SESSION_FUSION_COMPLETED: data = SessionFusionCompletedData.from_dict(data_obj) + case SessionEventType.SESSION_PERMISSION_RECOVERY: data = SessionPermissionRecoveryData.from_dict(data_obj) case SessionEventType.USER_MESSAGE: data = UserMessageData.from_dict(data_obj) case SessionEventType.PENDING_MESSAGES_MODIFIED: data = PendingMessagesModifiedData.from_dict(data_obj) case SessionEventType.ASSISTANT_TURN_START: data = AssistantTurnStartData.from_dict(data_obj) @@ -13810,6 +14814,11 @@ def session_event_to_dict(x: SessionEvent) -> Any: "HookEndError", "HookProgressData", "HookStartData", + "IndexedSearchDisabledReason", + "IndexedSearchErrorType", + "IndexedSearchIncrementalPhase", + "IndexedSearchOutcome", + "IndexedSearchState", "ManagedSettingsEnforcedAction", "ManagedSettingsEnforcedEscalation", "ManagedSettingsResolvedSource", @@ -13850,6 +14859,10 @@ def session_event_to_dict(x: SessionEvent) -> Any: "OmittedBinaryResult", "OmittedBinaryType", "PendingMessagesModifiedData", + "PermissionApprovalEvaluation", + "PermissionApprovalEvaluationEvaluationStage", + "PermissionApprovalEvaluationJudgeStatus", + "PermissionApprovalEvaluationReasonCode", "PermissionApproved", "PermissionApprovedForLocation", "PermissionApprovedForSession", @@ -13886,6 +14899,14 @@ def session_event_to_dict(x: SessionEvent) -> Any: "PermissionPromptRequestUrl", "PermissionPromptRequestWrite", "PermissionRecommendation", + "PermissionRecoveryAttempt", + "PermissionRecoveryAttemptDisposition", + "PermissionRecoveryAttemptReason", + "PermissionRecoveryAttemptRelation", + "PermissionRecoveryData", + "PermissionRecoveryOnBlocked", + "PermissionRecoveryReason", + "PermissionRecoveryStatus", "PermissionRequest", "PermissionRequestCustomTool", "PermissionRequestExtensionEnvAccess", @@ -13917,9 +14938,24 @@ def session_event_to_dict(x: SessionEvent) -> Any: "ReasoningSummary", "RecommendedAutoTier", "RemediationAction", + "ResponsesReasoning", "SamplingCompletedData", "SamplingRequestedData", + "SandboxAttestation", + "SandboxBackend", + "SandboxBypassSource", + "SandboxControl", "SandboxDecisionData", + "SandboxDecisionDataKind", + "SandboxDegradationReason", + "SandboxDenialClass", + "SandboxDenialConfidence", + "SandboxEnforcementPoint", + "SandboxFilesystemPolicyDetails", + "SandboxOutcome", + "SandboxPlatform", + "SandboxPolicySource", + "SandboxProxyMode", "ScheduleOrigin", "SessionAutoModeResolvedData", "SessionAutoTierRecommendationData", @@ -13952,6 +14988,8 @@ def session_event_to_dict(x: SessionEvent) -> Any: "SessionFusionRouteStartedData", "SessionHandoffData", "SessionIdleData", + "SessionIndexedSearchData", + "SessionIndexedSearchDataKind", "SessionInfoData", "SessionLimitsConfig", "SessionLimitsExhaustedCompletedData", @@ -13968,6 +15006,7 @@ def session_event_to_dict(x: SessionEvent) -> Any: "SessionModeChangedData", "SessionModeNoticeDeliveredData", "SessionModelChangeData", + "SessionPermissionRecoveryData", "SessionPermissionsChangedData", "SessionPlanChangedData", "SessionRemoteSteerableChangedData", @@ -14029,6 +15068,8 @@ def session_event_to_dict(x: SessionEvent) -> Any: "SystemNotificationShellCompleted", "SystemNotificationShellDetachedCompleted", "SystemNotificationUnclassified", + "TaskBlocker", + "TaskBlockerKind", "TaskCompletionOutcome", "ToolExecutionCompleteContent", "ToolExecutionCompleteContentAudio", diff --git a/python/test_event_forward_compatibility.py b/python/test_event_forward_compatibility.py index 4d60d63b87..101b8ab797 100644 --- a/python/test_event_forward_compatibility.py +++ b/python/test_event_forward_compatibility.py @@ -39,6 +39,130 @@ class TestEventForwardCompatibility: """Test forward compatibility for unknown event types.""" + @pytest.mark.parametrize( + ("event_type", "data"), [("session.idle", {}), ("user.message", {"content": "hello"})] + ) + def test_object_event_preserves_complete_envelope(self, event_type, data): + wire = { + "id": "11111111-1111-1111-1111-111111111111", + "timestamp": "2026-09-18T22:00:00+00:00", + "parentId": "22222222-2222-2222-2222-222222222222", + "type": event_type, + "data": data, + } + assert session_event_to_dict(session_event_from_dict(wire)) == wire + + @pytest.mark.parametrize( + ("event_type", "kind", "fields"), + [ + ("session.indexed_search", "status", {"state": "ready"}), + ( + "session.indexed_search", + "startup", + { + "outcome": "started", + "startupDurationMs": 1.5, + "forcedByEnv": False, + "warmStart": False, + "fileCount": 0, + "eligible": False, + "errorMessage": "diagnostic", + }, + ), + ( + "session.indexed_search", + "server_error", + {"errorType": "unexpected_exit", "exitCode": 0, "errorMessage": "diagnostic"}, + ), + ( + "session.indexed_search", + "incremental", + { + "phase": "updated", + "changedFileCount": 0, + "addedFileCount": 1, + "deletedFileCount": 0, + "totalChangeCount": 1, + "walkDurationMs": 0.5, + "updateDurationMs": 1.25, + "totalDurationMs": 1.75, + }, + ), + ( + "sandbox.decision", + "policy_resolved", + { + "backend": "seatbelt", + "policySource": "default_policy", + "readwritePathsCount": 0, + "readonlyPathsCount": 1, + "deniedPathsCount": 0, + "addCurrentWorkingDirectory": False, + "allowOutbound": False, + "allowLocalNetwork": False, + "proxyMode": "none", + "allowBypass": False, + "gitAuth": False, + "ghAuth": False, + "keychainAccess": False, + }, + ), + ("sandbox.decision", "spawn_completed", {"backend": "seatbelt", "durationMs": 1.5}), + ( + "sandbox.decision", + "enforcement_state", + {"backend": "seatbelt", "command": "echo test", "attestation": "spawn_succeeded"}, + ), + ( + "sandbox.decision", + "access_denied", + { + "denialClass": "filesystem_read", + "attestation": "builtin_policy_checked", + "deniedResource": "/example", + "command": "cat example", + }, + ), + ( + "sandbox.decision", + "bypass_decided", + {"source": "user_prompted", "deniedResource": "/example"}, + ), + ( + "sandbox.decision", + "permissive_retry_decided", + {"source": "model_requested", "command": "echo test"}, + ), + ( + "sandbox.decision", + "permissive_retry_completed", + {"processName": "example", "command": "echo test"}, + ), + ], + ) + def test_union_event_preserves_complete_envelope(self, event_type, kind, fields): + data = {"kind": kind, **fields} + if event_type == "sandbox.decision": + data.update( + control="process", + outcome="resolved", + platform="macos", + enforcementPoint="shell", + toolCallId="tool-1", + ) + wire = { + "id": "11111111-1111-1111-1111-111111111111", + "timestamp": "2026-09-18T22:00:00+00:00", + "parentId": "22222222-2222-2222-2222-222222222222", + "ephemeral": True, + "agentId": "agent-1", + "type": event_type, + "data": data, + } + event = session_event_from_dict(wire) + assert event.type.value == event_type + assert session_event_to_dict(event) == wire + @pytest.mark.parametrize("event_type", ["session.start", "session.resume"]) @pytest.mark.parametrize("tier", ["efficiency", "balance", "intelligence", "fast", None]) def test_auto_tier_lifecycle_events_round_trip(self, event_type, tier): diff --git a/rust/src/embeddedcli.rs b/rust/src/embeddedcli.rs index 59dddd0ed2..039b20d0d2 100644 --- a/rust/src/embeddedcli.rs +++ b/rust/src/embeddedcli.rs @@ -964,7 +964,7 @@ fn extract_cli_binary(archive: &[u8]) -> Result, EmbeddedCliError> { Err(EmbeddedCliErrorKind::BinaryNotFoundInArchive.into()) } -#[cfg(has_bundled_cli)] +#[cfg(all(has_bundled_cli, any(not(windows), test)))] fn extract_binary(archive: &[u8], binary_name: &str) -> Result, EmbeddedCliError> { let gz = flate2::read::GzDecoder::new(archive); let mut tar = tar::Archive::new(gz); diff --git a/rust/src/generated/api_types.rs b/rust/src/generated/api_types.rs index 3e8b45a72b..bff7ace112 100644 --- a/rust/src/generated/api_types.rs +++ b/rust/src/generated/api_types.rs @@ -10,12 +10,13 @@ use std::collections::HashMap; use serde::{Deserialize, Serialize}; pub use super::session_events::{ - AbortReason, AgentModelPolicy, AutoTier, ContextTier, McpOauthHttpResponse, - McpOauthWWWAuthenticateParams, McpServerMetadata, McpServerSource, McpServerStatus, - ModelChangeSource, OmittedBinaryOmittedReason, PermissionDecisionSource, PermissionMode, - PermissionPromptRequest, PermissionRule, ReasoningSummary, RemediationAction, - SessionLimitsConfig, SessionMode, ShutdownType, SkillSource, TaskCompletionOutcome, - UserToolSessionApproval, Verbosity, + AbortReason, AgentModelPolicy, AutoTier, ContextTier, IndexedSearchState, + ManagedSettingsResolvedSource, McpOauthHttpResponse, McpOauthWWWAuthenticateParams, + McpServerMetadata, McpServerSource, McpServerStatus, ModelChangeSource, + OmittedBinaryOmittedReason, PermissionDecisionSource, PermissionMode, PermissionPromptRequest, + PermissionRule, ReasoningSummary, RemediationAction, SessionLimitsConfig, SessionMode, + ShutdownType, SkillSource, TaskBlocker, TaskCompletionOutcome, UserToolSessionApproval, + Verbosity, }; use crate::types::{RequestId, SessionEvent, SessionId}; @@ -73,6 +74,8 @@ pub mod rpc_methods { pub const REGISTEREXTENSIONLAUNCHPROVIDER: &str = "registerExtensionLaunchProvider"; /// `catalog.search` pub const CATALOG_SEARCH: &str = "catalog.search"; + /// `catalog.select` + pub const CATALOG_SELECT: &str = "catalog.select"; /// `plugins.list` pub const PLUGINS_LIST: &str = "plugins.list"; /// `plugins.install` @@ -290,6 +293,36 @@ pub mod rpc_methods { pub const SESSION_FACTORY_JOURNAL_GET: &str = "session.factory.journal.get"; /// `session.factory.journal.put` pub const SESSION_FACTORY_JOURNAL_PUT: &str = "session.factory.journal.put"; + /// `session.workflow.run` + pub const SESSION_WORKFLOW_RUN: &str = "session.workflow.run"; + /// `session.workflow.resume` + pub const SESSION_WORKFLOW_RESUME: &str = "session.workflow.resume"; + /// `session.workflow.runFromTool` + pub const SESSION_WORKFLOW_RUNFROMTOOL: &str = "session.workflow.runFromTool"; + /// `session.workflow.resumeFromTool` + pub const SESSION_WORKFLOW_RESUMEFROMTOOL: &str = "session.workflow.resumeFromTool"; + /// `session.workflow.getRun` + pub const SESSION_WORKFLOW_GETRUN: &str = "session.workflow.getRun"; + /// `session.workflow.listRuns` + pub const SESSION_WORKFLOW_LISTRUNS: &str = "session.workflow.listRuns"; + /// `session.workflow.getRunDetail` + pub const SESSION_WORKFLOW_GETRUNDETAIL: &str = "session.workflow.getRunDetail"; + /// `session.workflow.getRunProgress` + pub const SESSION_WORKFLOW_GETRUNPROGRESS: &str = "session.workflow.getRunProgress"; + /// `session.workflow.cancel` + pub const SESSION_WORKFLOW_CANCEL: &str = "session.workflow.cancel"; + /// `session.workflow.pause` + pub const SESSION_WORKFLOW_PAUSE: &str = "session.workflow.pause"; + /// `session.workflow.pauseAtCheckpoint` + pub const SESSION_WORKFLOW_PAUSEATCHECKPOINT: &str = "session.workflow.pauseAtCheckpoint"; + /// `session.workflow.log` + pub const SESSION_WORKFLOW_LOG: &str = "session.workflow.log"; + /// `session.workflow.agent` + pub const SESSION_WORKFLOW_AGENT: &str = "session.workflow.agent"; + /// `session.workflow.journal.get` + pub const SESSION_WORKFLOW_JOURNAL_GET: &str = "session.workflow.journal.get"; + /// `session.workflow.journal.put` + pub const SESSION_WORKFLOW_JOURNAL_PUT: &str = "session.workflow.journal.put"; /// `session.model.getCurrent` pub const SESSION_MODEL_GETCURRENT: &str = "session.model.getCurrent"; /// `session.model.switchTo` @@ -500,8 +533,30 @@ pub mod rpc_methods { pub const SESSION_MCP_RESOURCES_LIST: &str = "session.mcp.resources.list"; /// `session.mcp.resources.listTemplates` pub const SESSION_MCP_RESOURCES_LISTTEMPLATES: &str = "session.mcp.resources.listTemplates"; + /// `session.managedSettings.get` + pub const SESSION_MANAGEDSETTINGS_GET: &str = "session.managedSettings.get"; /// `session.plugins.list` pub const SESSION_PLUGINS_LIST: &str = "session.plugins.list"; + /// `session.plugins.install` + pub const SESSION_PLUGINS_INSTALL: &str = "session.plugins.install"; + /// `session.plugins.uninstall` + pub const SESSION_PLUGINS_UNINSTALL: &str = "session.plugins.uninstall"; + /// `session.plugins.update` + pub const SESSION_PLUGINS_UPDATE: &str = "session.plugins.update"; + /// `session.plugins.enable` + pub const SESSION_PLUGINS_ENABLE: &str = "session.plugins.enable"; + /// `session.plugins.disable` + pub const SESSION_PLUGINS_DISABLE: &str = "session.plugins.disable"; + /// `session.plugins.marketplaces.list` + pub const SESSION_PLUGINS_MARKETPLACES_LIST: &str = "session.plugins.marketplaces.list"; + /// `session.plugins.marketplaces.add` + pub const SESSION_PLUGINS_MARKETPLACES_ADD: &str = "session.plugins.marketplaces.add"; + /// `session.plugins.marketplaces.remove` + pub const SESSION_PLUGINS_MARKETPLACES_REMOVE: &str = "session.plugins.marketplaces.remove"; + /// `session.plugins.marketplaces.browse` + pub const SESSION_PLUGINS_MARKETPLACES_BROWSE: &str = "session.plugins.marketplaces.browse"; + /// `session.plugins.marketplaces.refresh` + pub const SESSION_PLUGINS_MARKETPLACES_REFRESH: &str = "session.plugins.marketplaces.refresh"; /// `session.plugins.reload` pub const SESSION_PLUGINS_RELOAD: &str = "session.plugins.reload"; /// `session.provider.getEndpoint` @@ -706,6 +761,10 @@ pub mod rpc_methods { pub const SESSION_QUEUE_REMOVEAT: &str = "session.queue.removeAt"; /// `session.queue.updateText` pub const SESSION_QUEUE_UPDATETEXT: &str = "session.queue.updateText"; + /// `session.queue.withdrawMessage` + pub const SESSION_QUEUE_WITHDRAWMESSAGE: &str = "session.queue.withdrawMessage"; + /// `session.queue.appendSteering` + pub const SESSION_QUEUE_APPENDSTEERING: &str = "session.queue.appendSteering"; /// `session.queue.duplicateAt` pub const SESSION_QUEUE_DUPLICATEAT: &str = "session.queue.duplicateAt"; /// `session.queue.setDrainPaused` @@ -781,6 +840,10 @@ pub mod rpc_methods { pub const FACTORY_EXECUTE: &str = "factory.execute"; /// `factory.abort` pub const FACTORY_ABORT: &str = "factory.abort"; + /// `workflow.execute` + pub const WORKFLOW_EXECUTE: &str = "workflow.execute"; + /// `workflow.abort` + pub const WORKFLOW_ABORT: &str = "workflow.abort"; /// `tasks.cancel` pub const TASKS_CANCEL: &str = "tasks.cancel"; /// `sessionFs.readFile` @@ -879,6 +942,13 @@ pub struct CopilotUserResponseEndpoints { pub telemetry: Option, } +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CopilotUserResponseEnterpriseListItem { + /// Numeric database ID of the enterprise. + pub id: i64, +} + /// Chat quota snapshot from the raw Copilot user-response passthrough, with entitlement, overage, remaining quota, reset, and billing fields. /// ///

@@ -1125,6 +1195,9 @@ pub struct CopilotUserResponse { /// Endpoint URLs from the raw Copilot `/copilot_internal/v2/token` user-response passthrough. #[serde(skip_serializing_if = "Option::is_none")] pub endpoints: Option, + /// Enterprises that provide the user's Copilot license, each with a stable numeric ID. + #[serde(rename = "enterprise_list", skip_serializing_if = "Option::is_none")] + pub enterprise_list: Option>, /// Whether MCP (Model Context Protocol) support is enabled for the user. #[serde(rename = "is_mcp_enabled", skip_serializing_if = "Option::is_none")] pub is_mcp_enabled: Option, @@ -3158,11 +3231,123 @@ pub struct CapiSessionOptions { #[serde(rename_all = "camelCase")] pub struct CardDigest { /// Digest algorithm and canonical representation + #[serde(deserialize_with = "CardDigest::deserialize_algorithm")] pub algorithm: CardDigestAlgorithm, /// SHA-256 digest of the RFC 8785 canonical UTF-8 bytes, encoded as exactly 64 lowercase hexadecimal characters. pub value: String, } +impl CardDigest { + fn deserialize_algorithm<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "sha256-rfc8785" { + return Err(serde::de::Error::unknown_variant( + &value, + &["sha256-rfc8785"], + )); + } + ::deserialize(serde::de::value::StringDeserializer::::new( + value, + )) + } +} + +/// Where and when an Agent Plugin catalog reference was observed. Discovery provenance deliberately carries no descriptor URL, raw data, candidate handle, or content digest. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogAgentPluginCandidateProvenance { + /// Host of the catalog authority that advertised the reference, without path, query, or credentials. Inert untrusted data. + pub authority: String, + /// Canonical Agent Plugin media type. + pub media_type: CatalogAgentPluginMediaType, + /// ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a retrieval or validation timestamp. + pub observed_at: String, +} + +/// Syntactically validated GitHub repository provenance declared by catalog metadata. This is a source claim rather than proof that the descriptor URL resolves to the repository. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogPluginRepositorySource { + /// Case-preserving safe relative POSIX path derived from metadata.repoPath. + pub path: String, + /// Canonical lowercase owner/repository name derived from metadata.sourceSet. + pub repository: String, +} + +/// An inert Agent Plugin catalog result. Its canonical catalog identity, declared version, repository source claim, and explicit compatibility tags are safe to correlate, while its descriptor, URL, raw data, and installed-plugin state remain runtime-private. This contract-only variant does not mint or expose a candidate handle. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogAgentPluginCandidate { + /// Explicit validated compatibility tags, in canonical order. An empty list means the source declared no recognised compatibility; clients must not infer compatibility from other fields. `canvas-only` requires both `canvas` and `github-copilot`. + pub compatibility_tags: Vec, + /// Description taken verbatim from the card. Inert untrusted text. + #[serde(skip_serializing_if = "Option::is_none")] + pub description: Option, + /// Display name taken verbatim from the card. Inert untrusted text. + pub display_name: String, + /// Validated, normalised catalogue resource URN. This identity comes only from the catalog identifier and is never inferred from display text or installed-plugin state. + pub identity: String, + /// Discriminator: this candidate describes an Agent Plugin. + #[serde(deserialize_with = "CatalogAgentPluginCandidate::deserialize_kind")] + pub kind: CatalogAgentPluginCandidateKind, + /// Canonical Agent Plugin media type. + pub media_type: CatalogAgentPluginMediaType, + /// Where the Agent Plugin catalog reference was observed, without its descriptor, URL, raw data, or content digest. + pub provenance: CatalogAgentPluginCandidateProvenance, + /// Publisher taken verbatim from the card. Inert untrusted text. + #[serde(skip_serializing_if = "Option::is_none")] + pub publisher: Option, + /// Bounded repository provenance declared through the catalog's sourceSet and repoPath metadata. It contains no descriptor URL. + pub source: CatalogPluginRepositorySource, + /// Versioned trust metadata observed from the catalog authority. Optional for protocol-3 compatibility and emitted only when the caller also requires the trust-snapshot capability. + #[serde(skip_serializing_if = "Option::is_none")] + pub trust: Option, + /// Optional version declared by the catalog source. Omitted rather than guessed when the source supplies no version. + #[serde(skip_serializing_if = "Option::is_none")] + pub version: Option, +} + +impl CatalogAgentPluginCandidate { + fn deserialize_kind<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "plugin" { + return Err(serde::de::Error::unknown_variant(&value, &["plugin"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// Where and when an AI skill catalog reference was observed. Discovery provenance deliberately carries no content digest because search does not establish the exact validated content a later plan will bind. /// ///
@@ -3177,11 +3362,30 @@ pub struct CatalogAiSkillCandidateProvenance { /// Host of the catalog authority that advertised the reference, without path, query, or credentials. Inert untrusted data. pub authority: String, /// Media type advertised for the referenced AI skill card - pub media_type: CatalogAiSkillCandidateProvenanceMediaType, + #[serde(deserialize_with = "CatalogAiSkillCandidateProvenance::deserialize_media_type")] + pub media_type: CatalogAiSkillMediaType, /// ISO 8601 timestamp at which the runtime observed the catalog reference. This is not a retrieval or validation timestamp. pub observed_at: String, } +impl CatalogAiSkillCandidateProvenance { + fn deserialize_media_type<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "application/ai-skill" { + return Err(serde::de::Error::unknown_variant( + &value, + &["application/ai-skill"], + )); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } +} + /// Candidate whose card is retrieved from a URL through the runtime's hardened fetch boundary. /// ///
@@ -3235,11 +3439,14 @@ pub struct CatalogAiSkillCandidate { /// ISO 8601 timestamp after which the handle is stale and will be rejected. pub handle_expires_at: String, /// AI skills are discovery-only and cannot be installed through this surface - pub installability: CatalogAiSkillCandidateInstallability, + #[serde(deserialize_with = "CatalogAiSkillCandidate::deserialize_installability")] + pub installability: CatalogAiSkillInstallability, /// Discriminator: this candidate describes an AI skill + #[serde(deserialize_with = "CatalogAiSkillCandidate::deserialize_kind")] pub kind: CatalogAiSkillCandidateKind, /// Media type of the underlying AI skill card - pub media_type: CatalogAiSkillCandidateMediaType, + #[serde(deserialize_with = "CatalogAiSkillCandidate::deserialize_media_type")] + pub media_type: CatalogAiSkillMediaType, /// Where the catalog reference was observed, without the card itself or any content digest. pub provenance: CatalogAiSkillCandidateProvenance, /// Publisher taken verbatim from the card. Inert untrusted text. @@ -3252,6 +3459,55 @@ pub struct CatalogAiSkillCandidate { pub trust: Option, } +impl CatalogAiSkillCandidate { + fn deserialize_installability<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "not-installable-kind" { + return Err(serde::de::Error::unknown_variant( + &value, + &["not-installable-kind"], + )); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } + + fn deserialize_kind<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "ai-skill" { + return Err(serde::de::Error::unknown_variant(&value, &["ai-skill"])); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } + + fn deserialize_media_type<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "application/ai-skill" { + return Err(serde::de::Error::unknown_variant( + &value, + &["application/ai-skill"], + )); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } +} + /// An optional catalog authentication exchange did not establish the caller's identity. Anonymous search remains supported; this refusal is reserved for an operation that cannot continue after the attempted exchange. It is distinct from `policy-rejected` and from a network failure, and the reason identifies the recovery action. /// ///
@@ -3313,6 +3569,7 @@ pub struct CatalogMcpServerCandidate { /// Whether this MCP server can be planned for installation, and if policy prevents it. pub installability: CatalogMcpServerInstallability, /// Discriminator: this candidate describes an MCP server + #[serde(deserialize_with = "CatalogMcpServerCandidate::deserialize_kind")] pub kind: CatalogMcpServerCandidateKind, /// JSON MCP media type of the underlying card. pub media_type: McpServerCardMediaType, @@ -3328,6 +3585,21 @@ pub struct CatalogMcpServerCandidate { pub trust: Option, } +impl CatalogMcpServerCandidate { + fn deserialize_kind<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "mcp-server" { + return Err(serde::de::Error::unknown_variant(&value, &["mcp-server"])); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } +} + /// The protocol version and capability set a caller requires, supplied on every catalog request so negotiation cannot be skipped by omission. /// ///
@@ -3385,7 +3657,7 @@ pub struct CatalogHandleRejectedError { pub reason: CatalogHandleRejectionReason, } -/// The request was rejected before any work was done, because a bounded field fell outside its permitted range or a required field was unusable. +/// The request was rejected because a bounded field fell outside its permitted range or a required field was unusable. Pagination may also be rejected by the authority after a continuation request; repeat the search without page. /// ///
/// @@ -3437,7 +3709,7 @@ pub struct CatalogMalformedCardError { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct CatalogNegotiatedContract { - /// Wire features the runtime understood for this operation. Always a superset of the caller's required features, because any shortfall is a refusal instead. Operation availability remains a separate typed result. + /// Wire features the runtime understood for this operation. Includes the five original catalog capabilities and only explicitly requested supported additions, in supported order without duplicates. Capabilities that introduce new success-union variants or operations are therefore included only when explicitly required, preserving older protocol-v3 clients. Always a superset of the caller's required features, because any shortfall is a refusal instead. Operation availability remains a separate typed result. pub granted_capabilities: Vec, /// Protocol version of the runtime that served the request. pub runtime_protocol_version: i64, @@ -3533,6 +3805,52 @@ pub struct CatalogPolicyRejectedError { pub source: McpPlanPolicySource, } +/// An explicit numbered-page request. The SDK treats the token as opaque; only the runtime decodes it and changes its targetPage. Authority validation binds navigation to the original search. No snapshot stability or token TTL is promised. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSearchPage { + /// Requested one-based page. Must not exceed either the token's signed pageCount or the navigation window ceil(1000 / pageSize). Repeat the search without page to discover newly available pages beyond that signed pageCount. + pub number: i32, + /// Opaque authority-issued pagination token from an earlier response. Never decode, modify or log it in an SDK consumer. + pub token: String, +} + +/// Authority-reported navigation metadata, returned only to callers requiring catalog-search-pagination and only when a supported token is present. Tokenless first-page and continuation responses omit this object; no counts are inferred from candidates. The opaque token may be retained for previous or numbered navigation even when hasNextPage is false. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSearchPagination { + /// One-based page returned by the authority. + pub current_page: i32, + /// Whether the authority token advertises a valid next target within the navigation window. Not inferred from token presence, truncated, or currentPage being less than pageCount. + pub has_next_page: bool, + /// Navigation window ceiling ceil(1000 / pageSize), not the number of existing pages. Legal targets must not exceed this ceiling or the token's signed pageCount. + pub max_page: i32, + /// Backend-reported page count, which may exceed maxPage. Present pagination metadata always describes a multi-page result; zero- and single-page responses omit pagination. Navigation targets must also be within the signed pageCount carried by the supplied token. + pub page_count: i64, + /// Page size bound to the search, equal to the effective request limit. + pub page_size: i32, + /// Opaque authority-issued pagination token. Only the runtime decodes it or changes targetPage; SDK consumers must not decode, modify or log it. It has no runtime-created expiry or cache. + pub token: String, + /// Backend-reported count for this response, not the number of returned candidates. Its relationship to the full query result set is unknown. + pub total_count: i64, + /// The relationship of totalCount to the complete query result set is unknown; neither exactness nor a lower-bound guarantee is implied. + pub total_count_relation: CatalogSearchTotalCountRelation, +} + /// A bounded catalog search. Both the query length and the result count are capped by the schema so a caller cannot request an unbounded scan. /// ///
@@ -3546,17 +3864,20 @@ pub struct CatalogPolicyRejectedError { pub struct CatalogSearchRequest { /// Protocol version and capabilities the caller requires. pub contract: CatalogClientContract, - /// Restrict results to these candidate kinds. When omitted, every kind the runtime supports is searched. + /// Restrict results to these candidate kinds. Agent Plugins are opt-in and require the `agent-plugin-discovery` capability so protocol-v3 clients generated before that variant cannot receive an unknown result; when omitted, the backwards-compatible MCP server and AI skill kinds are searched. #[serde(skip_serializing_if = "Option::is_none")] pub kinds: Option>, /// Maximum number of candidates to return. Defaults to 10 when omitted. #[serde(skip_serializing_if = "Option::is_none")] pub limit: Option, + /// Numbered navigation using metadata from an earlier response. Requires catalog-search-pagination and the same query, kinds and effective limit. Omit for a fresh first-page search. + #[serde(skip_serializing_if = "Option::is_none")] + pub page: Option, /// Free-text search query. Persisted as tool input for session continuity, but omitted from telemetry. pub query: String, } -/// A completed catalog search: inert candidate summaries, each carrying a single-use handle. +/// A completed catalog search containing inert candidate summaries. MCP server and AI skill variants carry a single-use handle; the Agent Plugin variant is handleless. /// ///
/// @@ -3573,9 +3894,12 @@ pub struct CatalogSearchSucceeded { pub kind: CatalogSearchSucceededKind, /// Protocol version and capabilities the runtime honoured. pub negotiated: CatalogNegotiatedContract, + /// Navigation metadata for callers explicitly requiring catalog-search-pagination. Omitted when the authority returns no token, including tokenless first-page and continuation responses. Counts are never substituted from candidates.length. + #[serde(skip_serializing_if = "Option::is_none")] + pub pagination: Option, /// Pseudonymous identifier for this search, issued by the runtime or by the catalog authority it queried and never by the caller, so it cannot be forged or replayed to attribute an install to a search that never happened. Always present on a success, so a result set can be tied to the installs it leads to. It identifies a search rather than a person: it is derived from no user, account, device, or query data, and must never be joined with user identity to re-identify anyone. pub search_id: String, - /// Whether further matches existed beyond the requested limit. + /// Legacy indication that the authority returned a page token. Preserved for compatibility; this is not a has-next-page indicator. Use pagination.hasNextPage when pagination metadata is present. pub truncated: bool, } @@ -3638,6 +3962,182 @@ pub struct CatalogUnavailableError { pub reason: CatalogUnavailableReason, } +/// The caller cancelled the selection interaction and the retained search state was released. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionCancelled { + /// Discriminator: selection was cancelled + pub kind: CatalogSelectionCancelledKind, + /// The search identifier privately bound to the released selection group. + pub search_id: String, +} + +/// The caller explicitly declined every candidate and the retained search state was released. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionDeclined { + /// Discriminator: the candidates were declined + pub kind: CatalogSelectionDeclinedKind, + /// The search identifier privately bound to the released selection group. + pub search_id: String, +} + +/// The selection reference belongs to another runtime instance or session. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionForeign { + /// Discriminator for this typed selection rejection + pub kind: CatalogSelectionForeignKind, + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + pub message: String, +} + +/// The selection reference was malformed or unknown. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionInvalid { + /// Discriminator for this typed selection rejection + pub kind: CatalogSelectionInvalidKind, + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + pub message: String, +} + +/// The selection group was already terminated or its pending host hand-off was already claimed. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionReplayed { + /// Discriminator for this typed selection rejection + pub kind: CatalogSelectionReplayedKind, + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + pub message: String, +} + +/// Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionRequest { + /// Protocol version and capabilities the caller requires. + pub contract: CatalogClientContract, + /// The terminal outcome declared by the caller. Timed-out means the host's live interaction deadline elapsed; a reference whose runtime TTL elapsed is rejected separately as stale. + pub outcome: CatalogSelectionDecision, + /// Opaque runtime-instance scoped reference to one visible candidate. For a non-selected outcome, any candidate reference from the same search closes that search's retained group. + pub selection_ref: String, + /// Locally owned root session whose retained search state is being resolved. + pub session_id: SessionId, +} + +/// The chosen candidate was transferred into a fresh bounded single-use handle for a later explicit planning request. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionSelected { + /// Fresh single-use candidate handle accepted by mcp.planInstall. Returned only to the native host and never included in model-tool output. + pub candidate_handle: String, + /// Discriminator: one candidate was selected + pub kind: CatalogSelectionSelectedKind, + /// The exact search identifier privately bound to the selected candidate. + pub search_id: String, +} + +/// The host declared that its live selection interaction timed out, and the retained search state was released. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionTimedOut { + /// Discriminator: the host's live interaction timed out + pub kind: CatalogSelectionTimedOutKind, + /// The search identifier privately bound to the released selection group. + pub search_id: String, +} + +/// The runtime-enforced selection reference lifetime elapsed before the request arrived. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionStale { + /// Discriminator for this typed selection rejection + pub kind: CatalogSelectionStaleKind, + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + pub message: String, +} + +/// The presented opaque handle was issued for another catalog operation. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct CatalogSelectionWrongKind { + /// Discriminator for this typed selection rejection + pub kind: CatalogSelectionWrongKindKind, + /// Human-readable explanation safe to surface. Never contains the presented reference or private candidate state. + pub message: String, +} + /// Where and when the runtime observed the trust metadata. Observation time is not the authority's evaluation time and must not be used to infer staleness. /// ///
@@ -3673,9 +4173,27 @@ pub struct CatalogTrustSnapshotAbsent { /// Schema version of this runtime-owned snapshot envelope. pub schema_version: CatalogTrustSnapshotSchemaVersion, /// Discriminator: the authority omitted trust metadata. + #[serde(deserialize_with = "CatalogTrustSnapshotAbsent::deserialize_status")] pub status: CatalogTrustSnapshotAbsentStatus, } +impl CatalogTrustSnapshotAbsent { + fn deserialize_status<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "absent" { + return Err(serde::de::Error::unknown_variant(&value, &["absent"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// A recognised current Agent Finder T1 or T2 trust tier. /// ///
@@ -3694,11 +4212,29 @@ pub struct CatalogTrustSnapshotCurrent { /// Schema version of this runtime-owned snapshot envelope. pub schema_version: CatalogTrustSnapshotSchemaVersion, /// Discriminator: a recognised current trust tier was observed. + #[serde(deserialize_with = "CatalogTrustSnapshotCurrent::deserialize_status")] pub status: CatalogTrustSnapshotCurrentStatus, /// Service-computed T1 or T2 trust tier. pub tier: CatalogTrustTier, } +impl CatalogTrustSnapshotCurrent { + fn deserialize_status<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "current" { + return Err(serde::de::Error::unknown_variant(&value, &["current"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// Discriminator: the authority explicitly reported a downgraded assessment. /// ///
@@ -3717,9 +4253,27 @@ pub struct CatalogTrustSnapshotDowngraded { /// Schema version of this runtime-owned snapshot envelope. pub schema_version: CatalogTrustSnapshotSchemaVersion, /// Discriminator: the authority explicitly reported a downgraded assessment. + #[serde(deserialize_with = "CatalogTrustSnapshotDowngraded::deserialize_status")] pub status: CatalogTrustSnapshotDowngradedStatus, } +impl CatalogTrustSnapshotDowngraded { + fn deserialize_status<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "downgraded" { + return Err(serde::de::Error::unknown_variant(&value, &["downgraded"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// Discriminator: the trust field was empty, unbounded, or had the wrong JSON type. /// ///
@@ -3738,9 +4292,27 @@ pub struct CatalogTrustSnapshotMalformed { /// Schema version of this runtime-owned snapshot envelope. pub schema_version: CatalogTrustSnapshotSchemaVersion, /// Discriminator: the trust field was empty, unbounded, or had the wrong JSON type. + #[serde(deserialize_with = "CatalogTrustSnapshotMalformed::deserialize_status")] pub status: CatalogTrustSnapshotMalformedStatus, } +impl CatalogTrustSnapshotMalformed { + fn deserialize_status<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "malformed" { + return Err(serde::de::Error::unknown_variant(&value, &["malformed"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// Discriminator: the authority explicitly revoked the assessment. /// ///
@@ -3759,9 +4331,27 @@ pub struct CatalogTrustSnapshotRevoked { /// Schema version of this runtime-owned snapshot envelope. pub schema_version: CatalogTrustSnapshotSchemaVersion, /// Discriminator: the authority explicitly revoked the assessment. + #[serde(deserialize_with = "CatalogTrustSnapshotRevoked::deserialize_status")] pub status: CatalogTrustSnapshotRevokedStatus, } +impl CatalogTrustSnapshotRevoked { + fn deserialize_status<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "revoked" { + return Err(serde::de::Error::unknown_variant(&value, &["revoked"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// Discriminator: the authority explicitly marked the assessment stale. /// ///
@@ -3780,9 +4370,27 @@ pub struct CatalogTrustSnapshotStale { /// Schema version of this runtime-owned snapshot envelope. pub schema_version: CatalogTrustSnapshotSchemaVersion, /// Discriminator: the authority explicitly marked the assessment stale. + #[serde(deserialize_with = "CatalogTrustSnapshotStale::deserialize_status")] pub status: CatalogTrustSnapshotStaleStatus, } +impl CatalogTrustSnapshotStale { + fn deserialize_status<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "stale" { + return Err(serde::de::Error::unknown_variant(&value, &["stale"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// Discriminator: the authority supplied a bounded trust value this runtime does not understand. /// ///
@@ -3801,9 +4409,27 @@ pub struct CatalogTrustSnapshotUnsupported { /// Schema version of this runtime-owned snapshot envelope. pub schema_version: CatalogTrustSnapshotSchemaVersion, /// Discriminator: the authority supplied a bounded trust value this runtime does not understand. + #[serde(deserialize_with = "CatalogTrustSnapshotUnsupported::deserialize_status")] pub status: CatalogTrustSnapshotUnsupportedStatus, } +impl CatalogTrustSnapshotUnsupported { + fn deserialize_status<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "unsupported" { + return Err(serde::de::Error::unknown_variant(&value, &["unsupported"])); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } +} + /// No transport this runtime can use is available for the requested server. /// ///
@@ -7070,9 +7696,18 @@ pub struct InstalledPluginInfo { pub direct_source_id: Option, /// Whether the plugin is currently enabled for new sessions pub enabled: bool, + /// Whether the managed desired plugin currently has an installed or live record. Set to false for a managed desired entry retained in the listing after installation or reconciliation failed. + #[serde(skip_serializing_if = "Option::is_none")] + pub installed: Option, /// Absolute path of the marketplace directory a live plugin was resolved from. Present only on live, never-persisted records — a plugin belonging to a directory/local marketplace, which is loaded from its real directory on every pass instead of a copy under the installed-plugins cache. Its presence is what marks a listed plugin as live: such a plugin is always present on disk, so `enabled` is its only meaningful state and it is never "not installed". #[serde(skip_serializing_if = "Option::is_none")] pub installed_from: Option, + /// Whether enterprise managed settings control this plugin's enabled state. + #[serde(skip_serializing_if = "Option::is_none")] + pub managed: Option, + /// The enabled state required by enterprise managed settings, when this plugin spec is managed. + #[serde(skip_serializing_if = "Option::is_none")] + pub managed_desired_enabled: Option, /// Marketplace the plugin came from. Empty string ("") for direct repo / URL / local installs. pub marketplace: String, /// Plugin name @@ -7693,6 +8328,46 @@ pub struct ManagedSettingsReadResult { pub settings_json: Option, } +/// Enterprise managed-settings resolution: the effective managed settings the session applied and which channels contributed, so SDK clients can show users what is enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on resume, and on account switch. This is an ephemeral live snapshot (delivered to subscribers but not persisted to the session event log), because at session start it resolves before `session.start` is emitted. Device values take precedence over server values, then the policy helper, per ordinary key, while permissions compose restrictively across device, server, policy-helper, and SDK-client layers. The account-scoped `getManagedSettings()` API does not include session-local client injection. Marked experimental while the managed-settings surface stabilizes. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct ManagedSettingsResolvedData { + /// Whether enterprise policy disables bypass-permissions ("yolo") mode for this session. Deny-wins across layers, and forced on when `failClosed` is true. + pub bypass_permissions_disabled: bool, + /// Whether a session-local permissions layer injected by the SDK host was present + #[serde(skip_serializing_if = "Option::is_none")] + pub client_managed: Option, + /// Whether an actual device MDM/plist/registry/file managed-settings layer was present + pub device_managed: bool, + /// Whether managed policy could not be determined (e.g. a failed server fetch) and the session fell back to the fail-closed restriction. When true, restrictions such as disabling bypass-permissions are enforced even though `settings` may be absent. + pub fail_closed: bool, + /// The setting keys under enterprise management in the effective managed settings (e.g. `model`, `enabledPlugins`, `permissions`). Empty when no managed settings are in force. + pub managed_keys: Vec, + /// Whether at least two managed sources supplied permission allowlists, so enforcement intersects them and the flattened settings payload omits `permissions.allow`. + #[serde(skip_serializing_if = "Option::is_none")] + pub permissions_allow_intersected: Option, + /// Whether the policy-helper managed-settings layer was present. The policy helper is the weakest channel: it fills keys no enterprise source set and can never replace one. + #[serde(skip_serializing_if = "Option::is_none")] + pub policy_helper_managed: Option, + /// Whether the effective sandbox policy forces the sandbox on *only* because managed policy could not be determined, rather than because the policy requires it. Lets clients tell a user whose `--no-sandbox` was overridden that the sandbox stayed on as a fail-closed fallback, instead of attributing it to an administrator who set no such policy. + #[serde(skip_serializing_if = "Option::is_none")] + pub sandbox_enabled_by_undetermined_policy: Option, + /// Whether the server (account/org) managed-settings layer was present + pub server_managed: bool, + /// The effective (resolved) managed settings values, so clients can render exactly what is enforced. Absent when no managed policy is in force. + #[serde(skip_serializing_if = "Option::is_none")] + pub settings: Option, + /// Channel summary: `server`, `device`, `client`, or `policyHelper` when exactly one channel contributed; `mixed` when multiple channels contributed; otherwise `none`. Consult the per-channel booleans for exact provenance. + pub source: ManagedSettingsResolvedSource, +} + /// Result of registering a new marketplace. /// ///
@@ -7752,9 +8427,15 @@ pub struct MarketplaceBrowseResult { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct MarketplaceInfo { + /// Whether the managed marketplace currently resolved into the runtime marketplace registry. Set to false when the desired managed entry is retained for governance visibility after loading or reconciliation failed. + #[serde(skip_serializing_if = "Option::is_none")] + pub available: Option, /// True when this is a default marketplace shipped with the runtime. Defaults are not removable. #[serde(skip_serializing_if = "Option::is_none")] pub is_default: Option, + /// Whether enterprise managed settings provide and control this marketplace entry. + #[serde(skip_serializing_if = "Option::is_none")] + pub managed: Option, /// Marketplace name (matches the @marketplace suffix in plugin specs) pub name: String, /// Human-readable description of where the marketplace data is fetched from (e.g. "GitHub: owner/repo"). @@ -8547,7 +9228,7 @@ pub struct McpHostState { pub pending_connections: Vec, } -/// One change applying the plan would make, described rather than serialised so the configuration payload stays behind the runtime boundary. +/// The configuration-change alternative for the transportChoices entry at the same index. Only the selected alternative is applied; entries are not cumulative. The payload stays behind the runtime boundary. /// ///
/// @@ -8662,7 +9343,7 @@ pub struct McpPlanTarget { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct McpInstallPlan { - /// The configuration changes installing would make, described rather than serialised, so the mutable configuration payload stays behind the runtime boundary. + /// Alternative configuration changes, with exactly one entry for each transportChoices entry in the same order. Only the entry for the subsequently selected transport applies; these are not cumulative writes. Payloads remain behind the runtime boundary. pub configuration_changes: Vec, /// Normalised identity of the server the plan would install. pub identity: McpPlanResourceIdentity, @@ -8679,7 +9360,7 @@ pub struct McpInstallPlan { pub recommended_transport_choice_id: Option, /// Whether applying this plan would require an MCP reload to take effect. Planning itself never reloads. pub reload_required: bool, - /// Whether the plan cannot be applied without further input, because a required value has no default or a secret must be supplied. + /// True only when every eligible transport choice needs additional values or secrets. False means at least one choice needs no additional configuration, not that every choice is ready. A later apply operation must validate the selected choice's own inputs, secrets and policy after explicit confirmation. pub requires_interactive_configuration: bool, /// Configuration scope and key the plan would write to. pub target: McpPlanTarget, @@ -9034,11 +9715,29 @@ pub struct McpPlanInstallSourceCandidate { /// Single-use candidate handle. Consumed by this call, so a replay of the same handle is rejected. pub candidate_handle: String, /// Discriminator: plan from a previously returned candidate + #[serde(deserialize_with = "McpPlanInstallSourceCandidate::deserialize_kind")] pub kind: McpPlanInstallSourceCandidateKind, - /// The runtime- or authority-minted `searchId` returned with the search that produced this candidate. A search implementation binds it to private candidate-handle context; a planning implementation must verify that context before returning a plan. The unavailable planning implementation in this contract layer validates presence but does not claim the verification has occurred. It identifies a search rather than a person and must never be joined with user identity to re-identify anyone. + /// The runtime- or authority-minted `searchId` returned with the search that produced this candidate. Planning verifies the private correlation and atomically consumes a matching candidate before downstream work, including attempts that subsequently fail or report unavailable. A mismatched search does not consume the candidate. It identifies a search rather than a person and must never be joined with user identity to re-identify anyone. pub search_id: String, } +impl McpPlanInstallSourceCandidate { + fn deserialize_kind<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "candidate" { + return Err(serde::de::Error::unknown_variant(&value, &["candidate"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// An MCP server card to be retrieved from a URL through the runtime's hardened fetch boundary. /// ///
@@ -9051,6 +9750,7 @@ pub struct McpPlanInstallSourceCandidate { #[serde(rename_all = "camelCase")] pub struct McpServerCardUrl { /// Discriminator: the card is URL-backed, and carries no embedded data + #[serde(deserialize_with = "McpServerCardUrl::deserialize_kind")] pub kind: McpServerCardUrlKind, /// Media type the card is expected to conform to. pub media_type: McpServerCardMediaType, @@ -9058,6 +9758,21 @@ pub struct McpServerCardUrl { pub url: String, } +impl McpServerCardUrl { + fn deserialize_kind<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "url" { + return Err(serde::de::Error::unknown_variant(&value, &["url"])); + } + ::deserialize(serde::de::value::StringDeserializer::::new( + value, + )) + } +} + /// An MCP server card supplied inline as an inert document. /// ///
@@ -9072,11 +9787,27 @@ pub struct McpServerCardEmbedded { /// The card document verbatim, treated as inert untrusted bytes. The runtime parses and validates it; the host is not expected to interpret it. Never logged. pub data: String, /// Discriminator: the card is embedded, and carries no URL + #[serde(deserialize_with = "McpServerCardEmbedded::deserialize_kind")] pub kind: McpServerCardEmbeddedKind, /// Media type the card is expected to conform to. pub media_type: McpServerCardMediaType, } +impl McpServerCardEmbedded { + fn deserialize_kind<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "embedded" { + return Err(serde::de::Error::unknown_variant(&value, &["embedded"])); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } +} + /// Plan from a card supplied directly by the caller, without a preceding search. /// ///
@@ -9091,9 +9822,25 @@ pub struct McpPlanInstallSourceCard { /// The card to plan from: exactly one of a URL or embedded data. pub card: McpServerCardReference, /// Discriminator: plan from a caller-supplied card + #[serde(deserialize_with = "McpPlanInstallSourceCard::deserialize_kind")] pub kind: McpPlanInstallSourceCardKind, } +impl McpPlanInstallSourceCard { + fn deserialize_kind<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "card" { + return Err(serde::de::Error::unknown_variant(&value, &["card"])); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } +} + /// A side-effect-free request for an MCP install plan. Computing a plan never writes configuration, stores a secret, or reloads MCP servers. /// ///
@@ -9138,6 +9885,7 @@ pub struct McpPlanRequiredValueScalar { /// Key the value is supplied under. Inert untrusted data. pub key: String, /// Discriminator: this required value uses a scalar type. + #[serde(deserialize_with = "McpPlanRequiredValueScalar::deserialize_kind")] pub kind: McpPlanRequiredValueScalarKind, /// Whether the value must be present for the plan to be applicable. pub required: bool, @@ -9148,6 +9896,21 @@ pub struct McpPlanRequiredValueScalar { pub value_type: McpPlanScalarValueType, } +impl McpPlanRequiredValueScalar { + fn deserialize_kind<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "scalar" { + return Err(serde::de::Error::unknown_variant(&value, &["scalar"])); + } + ::deserialize(serde::de::value::StringDeserializer::< + D::Error, + >::new(value)) + } +} + /// One enumerated non-secret value a transport choice needs before it can be applied. The permitted values are structurally required. /// ///
@@ -9174,6 +9937,7 @@ pub struct McpPlanRequiredValueEnum { /// Key the value is supplied under. Inert untrusted data. pub key: String, /// Discriminator: this required value uses a fixed enumeration. + #[serde(deserialize_with = "McpPlanRequiredValueEnum::deserialize_kind")] pub kind: McpPlanRequiredValueEnumKind, /// Whether the value must be present for the plan to be applicable. pub required: bool, @@ -9181,9 +9945,38 @@ pub struct McpPlanRequiredValueEnum { #[serde(skip_serializing_if = "Option::is_none")] pub title: Option, /// Discriminator: the value must be one of `enumValues`. + #[serde(deserialize_with = "McpPlanRequiredValueEnum::deserialize_value_type")] pub value_type: McpPlanEnumValueType, } +impl McpPlanRequiredValueEnum { + fn deserialize_kind<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "enum" { + return Err(serde::de::Error::unknown_variant(&value, &["enum"])); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } + + fn deserialize_value_type<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "enum" { + return Err(serde::de::Error::unknown_variant(&value, &["enum"])); + } + ::deserialize(serde::de::value::StringDeserializer::::new( + value, + )) + } +} + /// A secret a transport choice needs, referenced by placeholder. No secret value ever appears in a plan, and the placeholder resolves against the keychain only when a plan is applied. /// ///
@@ -9218,6 +10011,7 @@ pub struct McpPlanTransportChoicePackage { /// Stable identifier for this choice within the plan, used to select it when the plan is applied. pub choice_id: String, /// Discriminator: this choice runs a local package + #[serde(deserialize_with = "McpPlanTransportChoicePackage::deserialize_install_method")] pub install_method: McpPlanPackageInstallMethod, /// Package identifier. Inert untrusted data. pub package_identifier: String, @@ -9231,6 +10025,23 @@ pub struct McpPlanTransportChoicePackage { pub transport: McpPlanPackageTransport, } +impl McpPlanTransportChoicePackage { + fn deserialize_install_method<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "package" { + return Err(serde::de::Error::unknown_variant(&value, &["package"])); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } +} + /// An eligible remote-endpoint transport choice. The endpoint is required and package identity cannot be represented. /// ///
@@ -9247,6 +10058,7 @@ pub struct McpPlanTransportChoiceRemote { /// Endpoint URL. Inert untrusted data. pub endpoint: String, /// Discriminator: this choice connects to a remote endpoint + #[serde(deserialize_with = "McpPlanTransportChoiceRemote::deserialize_install_method")] pub install_method: McpPlanRemoteInstallMethod, /// Typed values this choice requires, excluding secrets. pub required_values: Vec, @@ -9256,6 +10068,23 @@ pub struct McpPlanTransportChoiceRemote { pub transport: McpPlanRemoteTransport, } +impl McpPlanTransportChoiceRemote { + fn deserialize_install_method<'de, D>( + deserializer: D, + ) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "remote" { + return Err(serde::de::Error::unknown_variant(&value, &["remote"])); + } + ::deserialize( + serde::de::value::StringDeserializer::::new(value), + ) + } +} + /// Registration parameters for an external MCP client. /// ///
@@ -9784,6 +10613,9 @@ pub struct McpServerConfigHttp { /// Telemetry-obfuscation policy for this server's tools. #[serde(skip_serializing_if = "Option::is_none")] pub safe_for_telemetry: Option, + /// Milliseconds this server may spend connecting before the CLI warns that it is taking longer than expected. Presentation only: it does not change how long the connection is allowed to take. + #[serde(skip_serializing_if = "Option::is_none")] + pub slow_connection_threshold_ms: Option, /// The origin of this server configuration. #[serde(skip_serializing_if = "Option::is_none")] pub source: Option, @@ -9862,6 +10694,9 @@ pub(crate) struct McpServerConfigMemory { /// In-process MCP server instance. This value cannot cross a JSON-RPC boundary. #[doc(hidden)] pub(crate) server_instance: serde_json::Value, + /// Milliseconds this server may spend connecting before the CLI warns that it is taking longer than expected. Presentation only: it does not change how long the connection is allowed to take. + #[serde(skip_serializing_if = "Option::is_none")] + pub slow_connection_threshold_ms: Option, /// The origin of this server configuration. #[serde(skip_serializing_if = "Option::is_none")] pub source: Option, @@ -9948,6 +10783,9 @@ pub struct McpServerConfigStdio { /// Telemetry-obfuscation policy for this server's tools. #[serde(skip_serializing_if = "Option::is_none")] pub safe_for_telemetry: Option, + /// Milliseconds this server may spend connecting before the CLI warns that it is taking longer than expected. Presentation only: it does not change how long the connection is allowed to take. + #[serde(skip_serializing_if = "Option::is_none")] + pub slow_connection_threshold_ms: Option, /// The origin of this server configuration. #[serde(skip_serializing_if = "Option::is_none")] pub source: Option, @@ -10857,6 +11695,9 @@ pub struct Model { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct ModelApplyStartupOverlayRequest { + /// Effective default Auto routing preference from user and managed settings. Applies only to fresh sessions and never replaces a per-session selection. + #[serde(skip_serializing_if = "Option::is_none")] + pub auto_tier: Option, /// Model explicitly selected by the CLI, when provided. #[serde(skip_serializing_if = "Option::is_none")] pub cli_model: Option, @@ -11296,6 +12137,9 @@ pub struct ModelSwitchToResult { /// Persistence failure encountered after applying the model switch. #[serde(skip_serializing_if = "Option::is_none")] pub persistence_error: Option, + /// Stable queue item identifier when this request was enqueued. Remains present if the item drains before the response is returned. + #[serde(skip_serializing_if = "Option::is_none")] + pub queue_id: Option, /// Lifecycle result for the requested switch #[serde(skip_serializing_if = "Option::is_none")] pub status: Option, @@ -11593,6 +12437,9 @@ pub struct OptionsUpdateAdditionalContentExclusionPolicy { #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct PendingPermissionRequest { + /// Permission-recovery episode that authorized this request to surface for interactive attention + #[serde(skip_serializing_if = "Option::is_none")] + pub recovery_episode_id: Option, /// The user-facing permission prompt details (commands, write, read, mcp, url, memory, custom-tool, path, hook) pub request: PermissionPromptRequest, /// Unique identifier for the pending permission request @@ -13365,12 +14212,30 @@ pub struct PlanUpdateRequest { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct Plugin { + /// Opaque stable identity for a direct plugin source. + #[serde(skip_serializing_if = "Option::is_none")] + pub direct_source_id: Option, /// Whether the plugin is currently enabled pub enabled: bool, + /// Whether this managed desired plugin has an installed or live record. + #[serde(skip_serializing_if = "Option::is_none")] + pub installed: Option, + /// Absolute marketplace directory for a live plugin. + #[serde(skip_serializing_if = "Option::is_none")] + pub installed_from: Option, + /// Whether enterprise managed settings control this plugin. + #[serde(skip_serializing_if = "Option::is_none")] + pub managed: Option, + /// Enabled state required by enterprise managed settings. + #[serde(skip_serializing_if = "Option::is_none")] + pub managed_desired_enabled: Option, /// Marketplace the plugin came from pub marketplace: String, /// Plugin name pub name: String, + /// Runtime plugin provenance, such as "builtin". + #[serde(skip_serializing_if = "Option::is_none")] + pub source: Option, /// Installed version #[serde(skip_serializing_if = "Option::is_none")] pub version: Option, @@ -14505,6 +15370,31 @@ pub struct PushAttachmentSelection { pub r#type: PushAttachmentSelectionType, } +/// Append to one pending steering message without changing its identity or delivery position. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct QueueAppendSteeringRequest { + /// Mode captured at submission. Only steering messages in the same mode may be combined. + pub agent_mode: SendAgentMode, + /// Attachments to add after the message's existing attachments. An empty list preserves the existing attachments. + pub attachments: Vec, + /// Display text to append to the existing preview after a blank line. + pub display_prompt: String, + /// Expected current prompt, including any previous appends. The runtime applies plan-mode normalization before comparing and refuses a changed message. + pub expected_prompt: String, + /// Message identity returned by send, not the queue item id. Only unclaimed user steering messages are eligible. + pub message_id: String, + /// Text to append after a blank line. + pub prompt: String, +} + /// Inputs for starting a deferred-idle drain. /// ///
@@ -14949,6 +15839,9 @@ pub struct QueueSetDrainPausedRequest { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct QueueSnapshotResult { + /// Queue item identifier of a model switch that has been dequeued but not yet applied. + #[serde(skip_serializing_if = "Option::is_none")] + pub in_flight_model_change_id: Option, /// Insertion orders for queued items, aligned with `items`. #[serde(skip_serializing_if = "Option::is_none")] pub item_orders: Option>, @@ -14996,6 +15889,23 @@ pub struct QueueUpdateTextResult { pub updated: bool, } +/// Conditional withdrawal of a single user message, before the runtime claims it for delivery. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct QueueWithdrawMessageRequest { + /// The prompt originally sent. A message edited since submission is not withdrawn, so an obsolete draft cannot replace the edit. + pub expected_prompt: String, + /// Message identity returned by send, not the queue item id. Batch messages are not eligible. + pub message_id: String, +} + /// Event type to register consumer interest for, used by runtime gating logic. /// ///
@@ -15525,7 +16435,7 @@ pub struct SandboxConfigUserPolicyNetwork { /// Hosts denied by the built-in sandbox proxy. Deny rules take precedence over allowedHosts. A domain also denies all its subdomains. IP addresses match exactly; *.example.com matches strict subdomains, and * denies every host. #[serde(skip_serializing_if = "Option::is_none")] pub blocked_hosts: Option>, - /// HTTP(S) proxy for sandboxed traffic. With host rules, this is the built-in local proxy's upstream; credentials stay in the runtime, and Linux and macOS restrict the child to the local listener. Without host rules, Linux restricts egress to this endpoint but rejects credentials, and macOS proxying is cooperative. Windows enforcement depends on the application's networking stack. Configure credentials in the separate username/password fields. The transient local listener URL is never persisted. + /// HTTP(S) proxy for sandboxed traffic. This is the built-in local proxy's upstream: every sandboxed command reaches it through a loopback listener, so credentials stay in the runtime and never reach the child. On Windows the sandbox also needs local network access, because it reaches that listener over host loopback. Configure credentials in the separate username/password fields. The transient local listener URL is never persisted. #[serde(skip_serializing_if = "Option::is_none")] pub proxy: Option, } @@ -16771,7 +17681,7 @@ pub struct SessionFsSetProviderCapabilities { pub sqlite: Option, } -/// Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. +/// Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots. /// ///
/// @@ -16787,7 +17697,7 @@ pub struct SessionFsSetProviderRequest { pub capabilities: Option, /// Path conventions used by this filesystem pub conventions: SessionFsSetProviderConventions, - /// Initial working directory for sessions + /// Absolute initial working directory for sessions. Registering the provider establishes this path as the root of its virtual namespace; the runtime does not require the provider to materialize or stat it before creating a session. pub initial_cwd: String, /// Path within each session's SessionFs where the runtime stores files for that session pub session_state_path: String, @@ -17293,7 +18203,7 @@ pub struct SessionManagedPermissions { /// Permission rules that block matching operations. Deny has highest precedence. #[serde(skip_serializing_if = "Option::is_none")] pub deny: Option>, - /// When set to `disable`, prevents bypass/allow-all permission modes. `allow-auto-only` blocks full allow-all but permits advisory auto-approval. Any other value is accepted rather than failing the session, but is enforced as `disable`: the key is only present to restrict something, so a mode this runtime cannot interpret fails closed to the most restrictive one it knows. Omit the key entirely to impose no restriction. + /// When set to `disable`, prevents bypass/allow-all permission modes. Advisory auto-approval remains available because normal prompt paths stay active. Any other value is accepted rather than failing the session, but is enforced as `disable`: the key is only present to restrict something, so a mode this runtime cannot interpret fails closed to the most restrictive one it knows. Omit the key entirely to impose no restriction. #[serde(skip_serializing_if = "Option::is_none")] pub disable_bypass_permissions_mode: Option, } @@ -17367,6 +18277,9 @@ pub struct SessionMetadataSnapshot { pub client_name: Option, /// The current agent mode for this session (e.g., 'interactive', 'plan', 'autopilot') pub current_mode: MetadataSnapshotCurrentMode, + /// Live indexed-search state for this session activation. Omitted by runtimes that do not expose indexed-search status; absence does not indicate enablement. + #[serde(skip_serializing_if = "Option::is_none")] + pub indexed_search: Option, /// User-provided name supplied at session construction (via `--name`), if any. Immutable after construction. #[serde(skip_serializing_if = "Option::is_none")] pub initial_name: Option, @@ -18101,6 +19014,51 @@ pub struct SessionOpenResult { pub status: SessionsOpenStatus, } +/// Plugin names (or specs) to disable in the session's authoritative working directory. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsDisableRequest { + /// Plugin names or "plugin@marketplace" specs to disable. Unknown names are ignored. Non-marketplace direct installs cannot be disabled via this API; uninstall them instead. Plugin-owned MCP servers are stopped in active sessions immediately; other plugin contributions remain available until each session reloads plugins. + pub names: Vec, +} + +/// Plugin names (or specs) to enable in the session's authoritative working directory. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsEnableRequest { + /// Plugin names or "plugin@marketplace" specs to enable. Unknown names are ignored. Non-marketplace direct installs are always enabled and cannot be toggled via this API. + pub names: Vec, +} + +/// Plugin source resolved relative to the session's authoritative working directory. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsInstallRequest { + /// Plugin install spec. Accepts the same forms as the CLI: "plugin@marketplace" (marketplace install), "owner/repo" or "owner/repo:subpath" (GitHub direct), an http/https/ssh URL, or a local path. Direct (non-marketplace) installs are deprecated and will produce a deprecationWarning in the result. + pub source: String, +} + /// Outcome of the prune operation: deleted IDs, dry-run candidates, skipped IDs, total bytes freed, and the dry-run flag. /// ///
@@ -20312,11 +21270,25 @@ pub struct TaskClientInfo { /// Client task lifecycle status pub status: TaskClientStatus, /// Task kind + #[serde(deserialize_with = "TaskClientInfo::deserialize_type")] pub r#type: TaskClientType, /// ISO 8601 timestamp of the latest accepted lifecycle change pub updated_at: String, } +impl TaskClientInfo { + fn deserialize_type<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "client" { + return Err(serde::de::Error::unknown_variant(&value, &["client"])); + } + ::deserialize(serde::de::value::StringDeserializer::::new(value)) + } +} + /// Generic progress for a client-owned task. /// ///
@@ -20344,11 +21316,25 @@ pub struct TaskClientProgress { /// Current client task lifecycle status pub status: TaskClientStatus, /// Progress kind + #[serde(deserialize_with = "TaskClientProgress::deserialize_type")] pub r#type: TaskClientType, /// ISO 8601 timestamp of the latest accepted lifecycle change pub updated_at: String, } +impl TaskClientProgress { + fn deserialize_type<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "client" { + return Err(serde::de::Error::unknown_variant(&value, &["client"])); + } + ::deserialize(serde::de::value::StringDeserializer::::new(value)) + } +} + /// Publishes nonterminal progress for a running or idle client task. #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] @@ -20424,6 +21410,9 @@ pub struct TaskClientUpdateCancelled { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct TaskCompleteData { + /// Structured blocker details when outcome is blocked + #[serde(skip_serializing_if = "Option::is_none")] + pub blocker: Option, /// Active autopilot objective ID evaluated by the completion reviewer #[serde(skip_serializing_if = "Option::is_none")] pub objective_id: Option, @@ -20708,9 +21697,23 @@ pub struct TasksRegisterRequest { #[serde(skip_serializing_if = "Option::is_none")] pub expected_sequence: Option, /// Task kind + #[serde(deserialize_with = "TasksRegisterRequest::deserialize_type")] pub r#type: TaskClientType, } +impl TasksRegisterRequest { + fn deserialize_type<'de, D>(deserializer: D) -> Result + where + D: serde::Deserializer<'de>, + { + let value = String::deserialize(deserializer)?; + if value != "client" { + return Err(serde::de::Error::unknown_variant(&value, &["client"])); + } + ::deserialize(serde::de::value::StringDeserializer::::new(value)) + } +} + /// Result of registering or reclaiming a client-owned task. /// ///
@@ -22213,7 +23216,7 @@ pub struct VisibilitySetResult { pub synced: bool, } -/// A single changed file and its unified diff. +/// Parameters for cooperatively aborting a workflow body. /// ///
/// @@ -22223,22 +23226,16 @@ pub struct VisibilitySetResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspaceDiffFileChange { - /// Type of change represented by this file diff. - pub change_type: WorkspaceDiffFileChangeType, - /// Unified diff content for the file. Empty when the diff was truncated. - pub diff: String, - /// Whether the diff content was omitted because it exceeded the per-file size limit. - #[serde(skip_serializing_if = "Option::is_none")] - pub is_truncated: Option, - /// Original file path for renamed files. - #[serde(skip_serializing_if = "Option::is_none")] - pub old_path: Option, - /// Path to the changed file, relative to the workspace root when the file lives under it. A file changed outside the workspace root keeps a `../`-relative path, or an absolute path when no relative path exists (for example a different Windows drive). - pub path: String, +pub struct WorkflowAbortRequest { + /// Target session identifier + pub session_id: SessionId, + /// Workflow run identifier. + pub run_id: String, + /// Opaque token identifying the execution attempt to abort. + pub execution_token: String, } -/// Workspace diff result for the requested mode. +/// Acknowledgement that a workflow request was accepted. /// ///
/// @@ -22248,24 +23245,9 @@ pub struct WorkspaceDiffFileChange { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspaceDiffResult { - /// Default branch used for a branch diff, when branch mode was requested. - #[serde(skip_serializing_if = "Option::is_none")] - pub base_branch: Option, - /// Changed files and their unified diffs. - pub changes: Vec, - /// Whether the requested diff fell back to unstaged changes, either because branch diff failed or session diff was unavailable. - pub is_fallback: bool, - /// Effective mode used for the returned changes. - pub mode: WorkspaceDiffMode, - /// Diff mode requested by the client. - pub requested_mode: WorkspaceDiffMode, - /// Why the session diff could not be produced, when applicable. Set only when `session` mode was requested and `isFallback` is true, so a client can tell the permanent `file-change-tracking-disabled` apart from the transient `session-busy`, which the same request answers once the session settles. Never set for `unstaged` or `branch` mode, and never `unsupported-remote-session`: a remote session's captures live on its own host, so a `session`-mode diff is rejected for one rather than answered with a controller-side fallback. - #[serde(skip_serializing_if = "Option::is_none")] - pub unavailable_reason: Option, -} +pub struct WorkflowAckResult {} -/// Compaction summary checkpoint to persist. +/// Options for one workflow-scoped subagent call. /// ///
/// @@ -22275,14 +23257,28 @@ pub struct WorkspaceDiffResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesAddSummaryRequest { - /// Markdown summary content to persist. - pub content: String, - /// Summary title shown in checkpoint listings. - pub title: String, +pub struct WorkflowAgentOptions { + /// Optional built-in or custom agent name whose definition configures the subagent. + #[serde(skip_serializing_if = "Option::is_none")] + pub agent: Option, + /// Optional context tier override for the subagent. + #[serde(skip_serializing_if = "Option::is_none")] + pub context_tier: Option, + /// Optional label distinguishing otherwise identical memoized agent calls. + #[serde(skip_serializing_if = "Option::is_none")] + pub label: Option, + /// Optional model identifier for the subagent. + #[serde(skip_serializing_if = "Option::is_none")] + pub model: Option, + /// Optional reasoning effort override for the subagent. + #[serde(skip_serializing_if = "Option::is_none")] + pub reasoning_effort: Option, + /// Optional JSON Schema for structured agent output. + #[serde(skip_serializing_if = "Option::is_none")] + pub schema: Option, } -/// Persisted summary metadata and refreshed workspace metadata. +/// Parameters for one workflow-scoped subagent call. /// ///
/// @@ -22292,16 +23288,18 @@ pub struct WorkspacesAddSummaryRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesAddSummaryResult { - /// Metadata for the persisted summary. - #[serde(skip_serializing_if = "Option::is_none")] - pub summary: Option, - /// Refreshed metadata for the containing workspace. - #[serde(skip_serializing_if = "Option::is_none")] - pub workspace: Option, +pub struct WorkflowAgentRequest { + /// Opaque token identifying the current workflow execution attempt. + pub execution_token: String, + /// Subagent execution options. + pub opts: WorkflowAgentOptions, + /// Prompt to send to the subagent. + pub prompt: String, + /// Workflow run identifier that owns the subagent. + pub workflow_run_id: String, } -/// Whether the autopilot objective file exists. +/// Result of one workflow-scoped subagent call. /// ///
/// @@ -22311,12 +23309,13 @@ pub struct WorkspacesAddSummaryResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesAutopilotObjectiveExistsResult { - /// True when the objective file exists. - pub exists: bool, +pub struct WorkflowAgentResult { + /// Agent result, omitted when the agent produced no result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result: Option, } -/// Workspace checkpoint metadata with assigned number, human-readable title, and checkpoint filename. +/// Prompt-safe durable identity and live status for a direct workflow agent. /// ///
/// @@ -22326,16 +23325,44 @@ pub struct WorkspacesAutopilotObjectiveExistsResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesCheckpoints { - /// Filename of the checkpoint within the workspace checkpoints directory - pub filename: String, - /// Checkpoint number assigned by the workspace manager - pub number: i64, - /// Human-readable checkpoint title - pub title: String, +pub struct WorkflowAgentSummary { + /// Accumulated active agent time in milliseconds. + pub active_ms: i64, + /// Prompt-safe live activity text. + #[serde(skip_serializing_if = "Option::is_none")] + pub activity: Option, + /// Stable direct-agent identifier. + pub agent_id: String, + /// Registered agent type. + pub agent_type: String, + /// Epoch milliseconds when the agent completed. + #[serde(skip_serializing_if = "Option::is_none")] + pub completed_at: Option, + /// Friendly, non-unique name intended for display + #[serde(skip_serializing_if = "Option::is_none")] + pub display_name: Option, + /// Friendly, non-unique name intended for display + pub label: String, + /// Phase identifier active when the agent was launched, or null. + pub phase_id: Option, + /// Model requested when the agent was launched. + #[serde(skip_serializing_if = "Option::is_none")] + pub requested_model: Option, + /// Concrete model resolved for the agent. + #[serde(skip_serializing_if = "Option::is_none")] + pub resolved_model: Option, + /// Owning workflow run identifier. + pub run_id: String, + /// Epoch milliseconds when the agent started. + #[serde(skip_serializing_if = "Option::is_none")] + pub started_at: Option, + /// Current durable or live agent status. + pub status: String, + /// Tool-call identifier that launched the agent. + pub tool_call_id: String, } -/// Directory to create within the session workspace files directory. +/// Parameters for cancelling a workflow run. /// ///
/// @@ -22345,15 +23372,12 @@ pub struct WorkspacesCheckpoints { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesCreateDirectoryRequest { - /// Slash-separated relative path within the workspace files directory - pub path: String, - /// Whether to create missing parent directories. Defaults to false. - #[serde(skip_serializing_if = "Option::is_none")] - pub recursive: Option, +pub struct WorkflowCancelRequest { + /// Workflow run identifier. + pub run_id: String, } -/// Relative path and UTF-8 content for the workspace file to create or overwrite. +/// Current workflow phase identity. /// ///
/// @@ -22363,14 +23387,14 @@ pub struct WorkspacesCreateDirectoryRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesCreateFileRequest { - /// File content to write as a UTF-8 string - pub content: String, - /// Slash-separated relative path within the workspace files directory - pub path: String, +pub struct WorkflowCurrentPhase { + /// Current phase identifier. + pub id: String, + /// Zero-based declared phase ordinal, or null for an undeclared phase. + pub ordinal: Option, } -/// Result of deleting the autopilot objective file. +/// Declared or approved workflow resource ceilings. /// ///
/// @@ -22380,12 +23404,22 @@ pub struct WorkspacesCreateFileRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesDeleteAutopilotObjectiveResult { - /// True when a file was deleted. - pub deleted: bool, +pub struct WorkflowDeclaredLimits { + /// Maximum AI credits consumed by subagents and descendants. + #[serde(skip_serializing_if = "Option::is_none")] + pub max_ai_credits: Option, + /// Maximum concurrently active subagents. + #[serde(skip_serializing_if = "Option::is_none")] + pub max_concurrent_subagents: Option, + /// Maximum total subagents spawned by the run. + #[serde(skip_serializing_if = "Option::is_none")] + pub max_total_subagents: Option, + /// Maximum accumulated active execution time in seconds. + #[serde(skip_serializing_if = "Option::is_none")] + pub timeout_seconds: Option, } -/// Parameters for computing a workspace diff. +/// Parameters sent to the owning extension to execute a workflow closure. /// ///
/// @@ -22395,15 +23429,20 @@ pub struct WorkspacesDeleteAutopilotObjectiveResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesDiffRequest { - /// When true, ignore whitespace-only changes (git `--ignore-all-space`). Defaults to false. - #[serde(skip_serializing_if = "Option::is_none")] - pub ignore_whitespace: Option, - /// Diff mode requested by the client. - pub mode: WorkspaceDiffMode, +pub struct WorkflowExecuteRequest { + /// Target session identifier + pub session_id: SessionId, + /// Registered workflow name. + pub name: String, + /// Workflow run identifier. + pub run_id: String, + /// Opaque token identifying this workflow execution attempt. + pub execution_token: String, + /// Workflow input value. + pub args: serde_json::Value, } -/// Optional session context used when creating a local workspace. +/// Result returned by an extension workflow closure. /// ///
/// @@ -22413,71 +23452,40 @@ pub struct WorkspacesDiffRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesEnsureRequest { - /// Opaque workspace context supplied by the session host. +pub struct WorkflowExecuteResult { + /// Workflow result value. #[serde(skip_serializing_if = "Option::is_none")] - pub context: Option, + pub result: Option, } +/// Parameters for paging workflow progress. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesGetWorkspaceResultWorkspace { - /// Current Git branch. +pub struct WorkflowGetRunProgressRequest { + /// Exclusive forward cursor. #[serde(skip_serializing_if = "Option::is_none")] - pub branch: Option, - /// Whether the per-session Chronicle upgrade prompt was dismissed for the workspace. - #[serde( - rename = "chronicle_sync_dismissed", - skip_serializing_if = "Option::is_none" - )] - pub chronicle_sync_dismissed: Option, - /// Name of the client that created the workspace. - #[serde(rename = "client_name", skip_serializing_if = "Option::is_none")] - pub client_name: Option, - /// Timestamp when the workspace was created. - #[serde(rename = "created_at", skip_serializing_if = "Option::is_none")] - pub created_at: Option, - /// Current working directory associated with the workspace. + pub after_seq: Option, + /// Exclusive backward cursor. #[serde(skip_serializing_if = "Option::is_none")] - pub cwd: Option, - /// Git repository root associated with the workspace. - #[serde(rename = "git_root", skip_serializing_if = "Option::is_none")] - pub git_root: Option, - /// Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration. - #[serde(rename = "host_type", skip_serializing_if = "Option::is_none")] - pub host_type: Option, - /// Stable workspace identifier. - pub id: String, - /// Most recent Mission Control event identifier observed for the workspace. - #[serde(rename = "mc_last_event_id", skip_serializing_if = "Option::is_none")] - pub mc_last_event_id: Option, - /// Mission Control session identifier associated with the workspace. - #[serde(rename = "mc_session_id", skip_serializing_if = "Option::is_none")] - pub mc_session_id: Option, - /// Mission Control task identifier associated with the workspace. - #[serde(rename = "mc_task_id", skip_serializing_if = "Option::is_none")] - pub mc_task_id: Option, - /// Workspace display name. + pub before_seq: Option, + /// Maximum records to return. Defaults to 200 and is capped at 500. #[serde(skip_serializing_if = "Option::is_none")] - pub name: Option, - /// Whether the workspace session can be steered remotely. - #[serde(rename = "remote_steerable", skip_serializing_if = "Option::is_none")] - pub remote_steerable: Option, - /// Repository identifier associated with the workspace. + pub limit: Option, + /// Optional phase identifier used to scope records and cursors. #[serde(skip_serializing_if = "Option::is_none")] - pub repository: Option, - /// Number of persisted summaries in the workspace. - #[serde(rename = "summary_count", skip_serializing_if = "Option::is_none")] - pub summary_count: Option, - /// Timestamp when the workspace was last updated. - #[serde(rename = "updated_at", skip_serializing_if = "Option::is_none")] - pub updated_at: Option, - /// Whether the workspace name was explicitly chosen by the user. - #[serde(rename = "user_named", skip_serializing_if = "Option::is_none")] - pub user_named: Option, + pub phase_id: Option, + /// Workflow run identifier. + pub run_id: String, } -/// Current workspace metadata for the session, including its absolute filesystem path when available. +/// Parameters for retrieving a workflow run. /// ///
/// @@ -22487,15 +23495,12 @@ pub struct WorkspacesGetWorkspaceResultWorkspace { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesGetWorkspaceResult { - /// Absolute filesystem path to the workspace directory. Omitted when the session has no workspace (e.g. remote sessions). - #[serde(skip_serializing_if = "Option::is_none")] - pub path: Option, - /// Current workspace metadata, or null if not available - pub workspace: Option, +pub struct WorkflowGetRunRequest { + /// Workflow run identifier. + pub run_id: String, } -/// Workspace checkpoints in chronological order; empty when the workspace is not enabled. +/// Parameters for reading a workflow journal entry. /// ///
/// @@ -22505,12 +23510,16 @@ pub struct WorkspacesGetWorkspaceResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesListCheckpointsResult { - /// Workspace checkpoints in chronological order. Empty when workspace is not enabled. - pub checkpoints: Vec, +pub struct WorkflowJournalGetRequest { + /// Opaque token identifying the current workflow execution attempt. + pub execution_token: String, + /// Namespaced journal key. + pub key: String, + /// Workflow run identifier. + pub run_id: String, } -/// Relative paths of files stored in the session workspace files directory. +/// Result of reading a workflow journal entry. /// ///
/// @@ -22520,12 +23529,15 @@ pub struct WorkspacesListCheckpointsResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesListFilesResult { - /// Slash-separated relative file paths in the workspace files directory - pub files: Vec, +pub struct WorkflowJournalGetResult { + /// Whether the journal contained the requested key. + pub hit: bool, + /// Cached JSON result. The hit field distinguishes a cached JSON null from a miss. + #[serde(skip_serializing_if = "Option::is_none")] + pub result_json: Option, } -/// Autopilot objective file content, or null when missing. +/// Parameters for storing a workflow journal entry. /// ///
/// @@ -22535,12 +23547,18 @@ pub struct WorkspacesListFilesResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesReadAutopilotObjectiveResult { - /// Autopilot objective file content, or null when missing. - pub content: Option, +pub struct WorkflowJournalPutRequest { + /// Opaque token identifying the current workflow execution attempt. + pub execution_token: String, + /// Namespaced journal key. + pub key: String, + /// JSON result to memoize. + pub result_json: serde_json::Value, + /// Workflow run identifier. + pub run_id: String, } -/// Checkpoint number to read. +/// Parameters for paging workflow runs. /// ///
/// @@ -22550,12 +23568,19 @@ pub struct WorkspacesReadAutopilotObjectiveResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesReadCheckpointRequest { - /// Checkpoint number to read - pub number: i64, +pub struct WorkflowListRunsRequest { + /// Exclusive forward cursor. + #[serde(skip_serializing_if = "Option::is_none")] + pub after_seq: Option, + /// Exclusive backward cursor. + #[serde(skip_serializing_if = "Option::is_none")] + pub before_seq: Option, + /// Maximum terminal runs to return. Defaults to 200 and is capped at 500. + #[serde(skip_serializing_if = "Option::is_none")] + pub limit: Option, } -/// Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing. +/// Durable workflow resource consumption. /// ///
/// @@ -22565,12 +23590,16 @@ pub struct WorkspacesReadCheckpointRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesReadCheckpointResult { - /// Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing - pub content: Option, +pub struct WorkflowRunConsumed { + /// Accumulated active execution time in milliseconds. + pub active_ms: i64, + /// AI usage consumed by the run in nano-AIU. + pub nano_aiu: i64, + /// Total subagents spawned by the run. + pub subagents: i64, } -/// Relative path of the workspace file to read. +/// Prompt-safe terminal workflow outcome. /// ///
/// @@ -22580,12 +23609,24 @@ pub struct WorkspacesReadCheckpointResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesReadFileRequest { - /// Slash-separated relative path within the workspace files directory - pub path: String, +pub struct WorkflowRunTerminal { + /// Human-readable terminal error. + #[serde(skip_serializing_if = "Option::is_none")] + pub error: Option, + /// Machine-readable terminal failure. + #[serde(skip_serializing_if = "Option::is_none")] + pub failure: Option, + /// Pause initiator metadata, or null when the run did not pause. + pub pause_info: Option, + /// Human-readable terminal reason. + #[serde(skip_serializing_if = "Option::is_none")] + pub reason: Option, + /// Prompt-safe preview of the completed result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result_preview: Option, } -/// Contents of the requested workspace file as a UTF-8 string. +/// Durable workflow run summary with read-time live overlays. /// ///
/// @@ -22595,12 +23636,50 @@ pub struct WorkspacesReadFileRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesReadFileResult { - /// File content as a UTF-8 string - pub content: String, +pub struct WorkflowRunSummary { + /// Epoch milliseconds when the current active segment started, or null while inactive. + pub active_segment_started_at: Option, + /// Approved effective resource ceilings, or null until approved. + pub approved: Option, + /// Whether the durable run state currently passes runtime resume eligibility checks. + pub can_resume: bool, + /// Epoch milliseconds when the run completed, or null while nonterminal. + pub completed_at: Option, + /// Durable resource consumption. + pub consumed: WorkflowRunConsumed, + /// Epoch milliseconds when the run was created. + pub created_at: i64, + /// Current phase identity, or null before any phase is entered. + pub current_phase: Option, + /// Resource ceilings declared by the workflow. + pub declared_limits: WorkflowDeclaredLimits, + /// Number of phases declared by the workflow. + pub declared_phase_count: i64, + /// Human-readable workflow description. + pub description: String, + /// Number of direct workflow agents currently live. + pub live_agent_count: i64, + /// Epoch milliseconds when this live-overlay snapshot was observed. + pub observed_at: i64, + /// Monotonic durable run revision. + pub revision: i64, + /// Workflow run identifier. + pub run_id: String, + /// Epoch milliseconds when execution first started, or null before start. + pub started_at: Option, + /// Current workflow run status. + pub status: WorkflowRunStatus, + /// Terminal run outcome, or null while nonterminal. + pub terminal: Option, + /// Total direct workflow agents spawned across all attempts. + pub total_spawned_agent_count: i64, + /// Epoch milliseconds when the durable run was last updated. + pub updated_at: i64, + /// Registered workflow name. + pub workflow_name: String, } -/// File or directory to remove from the session workspace files directory. +/// A page of workflow runs in durable creation order. /// ///
/// @@ -22610,18 +23689,24 @@ pub struct WorkspacesReadFileResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesRemovePathRequest { - /// Whether a missing path should be treated as success. Defaults to false. +pub struct WorkflowListRunsResult { + /// Whether terminal runs newer than this page exist. #[serde(skip_serializing_if = "Option::is_none")] - pub force: Option, - /// Slash-separated relative path within the workspace files directory - pub path: String, - /// Whether to remove directory contents recursively. Defaults to false. + pub has_more_newer: Option, + /// Newest terminal-run cursor in this page, or null when the terminal window is empty. #[serde(skip_serializing_if = "Option::is_none")] - pub recursive: Option, + pub newest_seq: Option, + /// Oldest terminal-run cursor in this page, or null when the terminal window is empty. + #[serde(skip_serializing_if = "Option::is_none")] + pub oldest_seq: Option, + /// Number of terminal runs older than this page. + #[serde(skip_serializing_if = "Option::is_none")] + pub omitted_older: Option, + /// Workflow run summaries in durable creation order. + pub runs: Vec, } -/// Source and destination paths for a rename within the session workspace files directory. +/// One ordered workflow progress line. /// ///
/// @@ -22631,14 +23716,16 @@ pub struct WorkspacesRemovePathRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesRenamePathRequest { - /// Slash-separated destination path relative to the workspace files directory - pub destination: String, - /// Slash-separated source path relative to the workspace files directory - pub source: String, +pub struct WorkflowLogLine { + /// Progress line kind. + pub kind: WorkflowLogLineKind, + /// Monotonic sequence number within the workflow run. + pub seq: i64, + /// Progress text. + pub text: String, } -/// Pasted content to save as a UTF-8 file in the session workspace. +/// Parameters for recording workflow progress. /// ///
/// @@ -22648,23 +23735,34 @@ pub struct WorkspacesRenamePathRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesSaveLargePasteRequest { - /// Pasted content to save as a UTF-8 file - pub content: String, +pub struct WorkflowLogRequest { + /// Opaque token identifying the current workflow execution attempt. + pub execution_token: String, + /// Ordered progress lines to append. + pub lines: Vec, + /// Workflow run identifier. + pub run_id: String, } +/// Parameters for an owned durable pause checkpoint. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesSaveLargePasteResultSaved { - /// Filename within the workspace files directory - pub filename: String, - /// Absolute filesystem path to the saved paste file - pub file_path: String, - /// Size of the saved file in bytes - pub size_bytes: i64, +pub struct WorkflowPauseCheckpointRequest { + /// Opaque token identifying the execution attempt that reached the checkpoint. + pub execution_token: String, + /// Stable author-defined checkpoint key. + pub key: String, + /// Workflow run identifier. + pub run_id: String, } -/// Descriptor for the saved paste file, or null when the workspace is unavailable. /// ///
/// @@ -22674,12 +23772,12 @@ pub struct WorkspacesSaveLargePasteResultSaved { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesSaveLargePasteResult { - /// Saved-paste descriptor, or null when the workspace is unavailable (e.g. CCA runtime, non-infinite sessions, remote sessions) - pub saved: Option, +pub struct WorkflowPauseCheckpointResult { + /// Whether this execution attempt must pause or may continue. + pub action: WorkflowPauseCheckpointAction, } -/// Relative path of the workspace file or directory to inspect. +/// Parameters for pausing a running workflow. /// ///
/// @@ -22689,12 +23787,12 @@ pub struct WorkspacesSaveLargePasteResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesStatFileRequest { - /// Slash-separated relative path within the workspace files directory - pub path: String, +pub struct WorkflowPauseRequest { + /// Workflow run identifier. + pub run_id: String, } -/// Filesystem metadata for a path in the session workspace files directory. +/// Durable lifecycle and timing for one workflow phase. /// ///
/// @@ -22704,8 +23802,853 @@ pub struct WorkspacesStatFileRequest { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct WorkspacesStatFileResult { - /// Creation time in Unix epoch milliseconds +pub struct WorkflowPhaseObservation { + /// Completed active time accumulated by this phase in milliseconds. + pub accumulated_active_ms: i64, + /// Epoch milliseconds when this phase completed; for a skipped phase, the synthetic skip timestamp (equal to `startedAt`). + #[serde(skip_serializing_if = "Option::is_none")] + pub completed_at: Option, + /// Current live active time for this phase in milliseconds. + pub current_active_ms: i64, + /// Optional human-readable phase detail. + #[serde(skip_serializing_if = "Option::is_none")] + pub detail: Option, + /// Number of times execution entered this phase. + pub entry_count: i64, + /// Phase identifier. + pub id: String, + /// Most recent run attempt that entered this phase, or `0` if the phase has never been entered. + pub last_entered_run_attempt: i64, + /// Direct agents in this phase that are currently live. + pub live_agent_count: i64, + /// Zero-based declared phase ordinal, or null for an undeclared phase. + pub ordinal: Option, + /// Epoch milliseconds when this phase first started; for a skipped phase, the synthetic skip timestamp (equal to `completedAt`). + #[serde(skip_serializing_if = "Option::is_none")] + pub started_at: Option, + /// Derived lifecycle state of the phase. + pub status: WorkflowPhaseStatus, + /// Human-readable phase title. + pub title: String, + /// Total direct agents associated with this phase. + pub total_agent_count: i64, +} + +/// One durable workflow progress record. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowProgressLine { + /// Resume attempt that emitted this record. + pub attempt: i64, + /// Progress record kind. + pub kind: WorkflowLogLineKind, + /// Phase active when the record was emitted, or null before any phase. + pub phase_id: Option, + /// Epoch milliseconds when the record was persisted. + pub recorded_at: i64, + /// Global monotonic sequence number within the run. + pub seq: i64, + /// Prompt-safe progress text. + pub text: String, +} + +/// A bidirectional page of workflow progress. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowProgressPage { + /// Whether progress records newer than this page exist. + pub has_more_newer: bool, + /// Whether progress records older than this page exist. + pub has_more_older: bool, + /// Newest sequence number in this page, or null when empty. + pub newest_seq: Option, + /// Oldest sequence number in this page, or null when empty. + pub oldest_seq: Option, + /// Progress records in sequence order. + pub records: Vec, + /// Run revision reflected by this page. + pub revision: i64, +} + +/// Wire-only per-invocation workflow resource ceiling overrides. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowRunLimits { + /// Maximum AI credits consumed by workflow subagents and their descendants. The post-paid ceiling is soft: parallel turns can settle beyond it before the run stops. + #[serde(skip_serializing_if = "Option::is_none")] + pub max_ai_credits: Option, + /// Maximum number of workflow subagents that may run concurrently. + #[serde(skip_serializing_if = "Option::is_none")] + pub max_concurrent_subagents: Option, + /// Maximum total number of workflow subagents that may be admitted. + #[serde(skip_serializing_if = "Option::is_none")] + pub max_total_subagents: Option, + /// Maximum accumulated active-execution time in seconds. Active execution includes the entire extension body, subprocess waits, queued-agent waits, and sleeps; time between resumed attempts is not counted. + #[serde(skip_serializing_if = "Option::is_none")] + pub timeout_seconds: Option, +} + +/// Parameters for resuming a workflow run from its persisted identity. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowResumeRequest { + /// Optional per-invocation resource ceiling overrides. + #[serde(skip_serializing_if = "Option::is_none")] + pub limits: Option, + /// Whether to emit workflow phase names to the session transcript. + #[serde(skip_serializing_if = "Option::is_none")] + pub log_phase_names: Option, + /// Whether to notify the originating session when the workflow completes. + #[serde(skip_serializing_if = "Option::is_none")] + pub notify_on_complete: Option, + /// Workflow run identifier. + pub run_id: String, +} + +/// Complete current or terminal workflow run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowRunResult { + /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. + #[serde(skip_serializing_if = "Option::is_none")] + pub attempt: Option, + /// Error message for an errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub error: Option, + /// Machine-readable failure details for a halted or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub failure: Option, + /// Structured pause initiator metadata for a paused attempt. + #[serde(skip_serializing_if = "Option::is_none")] + pub pause_info: Option, + /// Reason for a halted or cancelled run. + #[serde(skip_serializing_if = "Option::is_none")] + pub reason: Option, + /// Completed workflow result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result: Option, + /// Workflow run identifier. + pub run_id: String, + /// Partial journal and progress snapshot for a halted, cancelled, or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub snapshot: Option, + /// Current or terminal workflow run status. + pub status: WorkflowRunStatus, +} + +/// Resolved persisted workflow identity and resumed run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowResumeResult { + /// Terminal resumed run envelope. + pub run: WorkflowRunResult, + /// Persisted workflow name resolved for the resumed run. + pub workflow_name: String, +} + +/// Full workflow run observability detail. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowRunDetail { + /// Epoch milliseconds when the current active segment started, or null while inactive. + pub active_segment_started_at: Option, + /// Durable identities and live statuses for direct workflow agents. + pub agents: Vec, + /// Approved effective resource ceilings, or null until approved. + pub approved: Option, + /// Whether the durable run state currently passes runtime resume eligibility checks. + pub can_resume: bool, + /// Epoch milliseconds when the run completed, or null while nonterminal. + pub completed_at: Option, + /// Durable resource consumption. + pub consumed: WorkflowRunConsumed, + /// Epoch milliseconds when the run was created. + pub created_at: i64, + /// Current phase identity, or null before any phase is entered. + pub current_phase: Option, + /// Resource ceilings declared by the workflow. + pub declared_limits: WorkflowDeclaredLimits, + /// Number of phases declared by the workflow. + pub declared_phase_count: i64, + /// Human-readable workflow description. + pub description: String, + /// Number of direct workflow agents currently live. + pub live_agent_count: i64, + /// Epoch milliseconds when this live-overlay snapshot was observed. + pub observed_at: i64, + /// Lifecycle and timing observations for each workflow phase. + pub phases: Vec, + /// Bidirectional page of durable workflow progress. + pub progress: WorkflowProgressPage, + /// Monotonic durable run revision. + pub revision: i64, + /// Workflow run identifier. + pub run_id: String, + /// Epoch milliseconds when execution first started, or null before start. + pub started_at: Option, + /// Current workflow run status. + pub status: WorkflowRunStatus, + /// Terminal run outcome, or null while nonterminal. + pub terminal: Option, + /// Total direct workflow agents spawned across all attempts. + pub total_spawned_agent_count: i64, + /// Epoch milliseconds when the durable run was last updated. + pub updated_at: i64, + /// Registered workflow name. + pub workflow_name: String, +} + +/// Options controlling workflow invocation. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowRunOptions { + /// Per-invocation resource ceiling overrides. + #[serde(skip_serializing_if = "Option::is_none")] + pub limits: Option, + /// Whether to emit workflow phase names to the session transcript. + #[serde(skip_serializing_if = "Option::is_none")] + pub log_phase_names: Option, + /// Whether to notify the originating session when the workflow completes. + #[serde(skip_serializing_if = "Option::is_none")] + pub notify_on_complete: Option, + /// Run identifier whose journal and progress should seed this resumed run. + #[serde(skip_serializing_if = "Option::is_none")] + pub resume_from_run_id: Option, +} + +/// Parameters for invoking a registered workflow. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowRunRequest { + /// Workflow input value. + pub args: serde_json::Value, + /// Registered workflow name. + pub name: String, + /// Workflow invocation options. + #[serde(skip_serializing_if = "Option::is_none")] + pub options: Option, +} + +/// Internal parameters for resuming a workflow run from a tool. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub(crate) struct WorkflowToolResumeRequest { + /// Optional per-invocation resource ceiling overrides. + #[serde(skip_serializing_if = "Option::is_none")] + pub limits: Option, + /// Workflow run identifier. + pub run_id: String, + /// Opaque identifier of the originating tool call. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + +/// Options for an internal tool-originated workflow invocation. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub(crate) struct WorkflowToolRunOptions { + /// Per-invocation resource ceiling overrides. + #[serde(skip_serializing_if = "Option::is_none")] + pub limits: Option, + /// Run identifier whose journal and progress should seed this resumed run. + #[serde(skip_serializing_if = "Option::is_none")] + pub resume_from_run_id: Option, +} + +/// Internal parameters for invoking a registered workflow from a tool. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub(crate) struct WorkflowToolRunRequest { + /// Workflow input value. + pub args: serde_json::Value, + /// Registered workflow name. + pub name: String, + /// Tool-originated workflow invocation options. + #[doc(hidden)] + #[serde(skip_serializing_if = "Option::is_none")] + pub(crate) options: Option, + /// Opaque identifier of the originating tool call. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + +/// A single changed file and its unified diff. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspaceDiffFileChange { + /// Type of change represented by this file diff. + pub change_type: WorkspaceDiffFileChangeType, + /// Unified diff content for the file. Empty when the diff was truncated. + pub diff: String, + /// Whether the diff content was omitted because it exceeded the per-file size limit. + #[serde(skip_serializing_if = "Option::is_none")] + pub is_truncated: Option, + /// Original file path for renamed files. + #[serde(skip_serializing_if = "Option::is_none")] + pub old_path: Option, + /// Path to the changed file, relative to the workspace root when the file lives under it. A file changed outside the workspace root keeps a `../`-relative path, or an absolute path when no relative path exists (for example a different Windows drive). + pub path: String, +} + +/// Workspace diff result for the requested mode. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspaceDiffResult { + /// Default branch used for a branch diff, when branch mode was requested. + #[serde(skip_serializing_if = "Option::is_none")] + pub base_branch: Option, + /// Changed files and their unified diffs. + pub changes: Vec, + /// Whether the requested diff fell back to unstaged changes, either because branch diff failed or session diff was unavailable. + pub is_fallback: bool, + /// Effective mode used for the returned changes. + pub mode: WorkspaceDiffMode, + /// Diff mode requested by the client. + pub requested_mode: WorkspaceDiffMode, + /// Why the session diff could not be produced, when applicable. Set only when `session` mode was requested and `isFallback` is true, so a client can tell the permanent `file-change-tracking-disabled` apart from the transient `session-busy`, which the same request answers once the session settles. Never set for `unstaged` or `branch` mode, and never `unsupported-remote-session`: a remote session's captures live on its own host, so a `session`-mode diff is rejected for one rather than answered with a controller-side fallback. + #[serde(skip_serializing_if = "Option::is_none")] + pub unavailable_reason: Option, +} + +/// Compaction summary checkpoint to persist. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesAddSummaryRequest { + /// Markdown summary content to persist. + pub content: String, + /// Summary title shown in checkpoint listings. + pub title: String, +} + +/// Persisted summary metadata and refreshed workspace metadata. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesAddSummaryResult { + /// Metadata for the persisted summary. + #[serde(skip_serializing_if = "Option::is_none")] + pub summary: Option, + /// Refreshed metadata for the containing workspace. + #[serde(skip_serializing_if = "Option::is_none")] + pub workspace: Option, +} + +/// Whether the autopilot objective file exists. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesAutopilotObjectiveExistsResult { + /// True when the objective file exists. + pub exists: bool, +} + +/// Workspace checkpoint metadata with assigned number, human-readable title, and checkpoint filename. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesCheckpoints { + /// Filename of the checkpoint within the workspace checkpoints directory + pub filename: String, + /// Checkpoint number assigned by the workspace manager + pub number: i64, + /// Human-readable checkpoint title + pub title: String, +} + +/// Directory to create within the session workspace files directory. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesCreateDirectoryRequest { + /// Slash-separated relative path within the workspace files directory + pub path: String, + /// Whether to create missing parent directories. Defaults to false. + #[serde(skip_serializing_if = "Option::is_none")] + pub recursive: Option, +} + +/// Relative path and UTF-8 content for the workspace file to create or overwrite. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesCreateFileRequest { + /// File content to write as a UTF-8 string + pub content: String, + /// Slash-separated relative path within the workspace files directory + pub path: String, +} + +/// Result of deleting the autopilot objective file. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesDeleteAutopilotObjectiveResult { + /// True when a file was deleted. + pub deleted: bool, +} + +/// Parameters for computing a workspace diff. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesDiffRequest { + /// When true, ignore whitespace-only changes (git `--ignore-all-space`). Defaults to false. + #[serde(skip_serializing_if = "Option::is_none")] + pub ignore_whitespace: Option, + /// Diff mode requested by the client. + pub mode: WorkspaceDiffMode, +} + +/// Optional session context used when creating a local workspace. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesEnsureRequest { + /// Opaque workspace context supplied by the session host. + #[serde(skip_serializing_if = "Option::is_none")] + pub context: Option, +} + +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesGetWorkspaceResultWorkspace { + /// Current Git branch. + #[serde(skip_serializing_if = "Option::is_none")] + pub branch: Option, + /// Whether the per-session Chronicle upgrade prompt was dismissed for the workspace. + #[serde( + rename = "chronicle_sync_dismissed", + skip_serializing_if = "Option::is_none" + )] + pub chronicle_sync_dismissed: Option, + /// Name of the client that created the workspace. + #[serde(rename = "client_name", skip_serializing_if = "Option::is_none")] + pub client_name: Option, + /// Timestamp when the workspace was created. + #[serde(rename = "created_at", skip_serializing_if = "Option::is_none")] + pub created_at: Option, + /// Current working directory associated with the workspace. + #[serde(skip_serializing_if = "Option::is_none")] + pub cwd: Option, + /// Git repository root associated with the workspace. + #[serde(rename = "git_root", skip_serializing_if = "Option::is_none")] + pub git_root: Option, + /// Allowed values for the `WorkspacesWorkspaceDetailsHostType` enumeration. + #[serde(rename = "host_type", skip_serializing_if = "Option::is_none")] + pub host_type: Option, + /// Stable workspace identifier. + pub id: String, + /// Most recent Mission Control event identifier observed for the workspace. + #[serde(rename = "mc_last_event_id", skip_serializing_if = "Option::is_none")] + pub mc_last_event_id: Option, + /// Mission Control session identifier associated with the workspace. + #[serde(rename = "mc_session_id", skip_serializing_if = "Option::is_none")] + pub mc_session_id: Option, + /// Mission Control task identifier associated with the workspace. + #[serde(rename = "mc_task_id", skip_serializing_if = "Option::is_none")] + pub mc_task_id: Option, + /// Workspace display name. + #[serde(skip_serializing_if = "Option::is_none")] + pub name: Option, + /// Whether the workspace session can be steered remotely. + #[serde(rename = "remote_steerable", skip_serializing_if = "Option::is_none")] + pub remote_steerable: Option, + /// Repository identifier associated with the workspace. + #[serde(skip_serializing_if = "Option::is_none")] + pub repository: Option, + /// Number of persisted summaries in the workspace. + #[serde(rename = "summary_count", skip_serializing_if = "Option::is_none")] + pub summary_count: Option, + /// Timestamp when the workspace was last updated. + #[serde(rename = "updated_at", skip_serializing_if = "Option::is_none")] + pub updated_at: Option, + /// Whether the workspace name was explicitly chosen by the user. + #[serde(rename = "user_named", skip_serializing_if = "Option::is_none")] + pub user_named: Option, +} + +/// Current workspace metadata for the session, including its absolute filesystem path when available. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesGetWorkspaceResult { + /// Absolute filesystem path to the workspace directory. Omitted when the session has no workspace (e.g. remote sessions). + #[serde(skip_serializing_if = "Option::is_none")] + pub path: Option, + /// Current workspace metadata, or null if not available + pub workspace: Option, +} + +/// Workspace checkpoints in chronological order; empty when the workspace is not enabled. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesListCheckpointsResult { + /// Workspace checkpoints in chronological order. Empty when workspace is not enabled. + pub checkpoints: Vec, +} + +/// Relative paths of files stored in the session workspace files directory. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesListFilesResult { + /// Slash-separated relative file paths in the workspace files directory + pub files: Vec, +} + +/// Autopilot objective file content, or null when missing. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesReadAutopilotObjectiveResult { + /// Autopilot objective file content, or null when missing. + pub content: Option, +} + +/// Checkpoint number to read. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesReadCheckpointRequest { + /// Checkpoint number to read + pub number: i64, +} + +/// Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesReadCheckpointResult { + /// Checkpoint content as a UTF-8 string, or null when the checkpoint or workspace is missing + pub content: Option, +} + +/// Relative path of the workspace file to read. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesReadFileRequest { + /// Slash-separated relative path within the workspace files directory + pub path: String, +} + +/// Contents of the requested workspace file as a UTF-8 string. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesReadFileResult { + /// File content as a UTF-8 string + pub content: String, +} + +/// File or directory to remove from the session workspace files directory. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesRemovePathRequest { + /// Whether a missing path should be treated as success. Defaults to false. + #[serde(skip_serializing_if = "Option::is_none")] + pub force: Option, + /// Slash-separated relative path within the workspace files directory + pub path: String, + /// Whether to remove directory contents recursively. Defaults to false. + #[serde(skip_serializing_if = "Option::is_none")] + pub recursive: Option, +} + +/// Source and destination paths for a rename within the session workspace files directory. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesRenamePathRequest { + /// Slash-separated destination path relative to the workspace files directory + pub destination: String, + /// Slash-separated source path relative to the workspace files directory + pub source: String, +} + +/// Pasted content to save as a UTF-8 file in the session workspace. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesSaveLargePasteRequest { + /// Pasted content to save as a UTF-8 file + pub content: String, +} + +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesSaveLargePasteResultSaved { + /// Filename within the workspace files directory + pub filename: String, + /// Absolute filesystem path to the saved paste file + pub file_path: String, + /// Size of the saved file in bytes + pub size_bytes: i64, +} + +/// Descriptor for the saved paste file, or null when the workspace is unavailable. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesSaveLargePasteResult { + /// Saved-paste descriptor, or null when the workspace is unavailable (e.g. CCA runtime, non-infinite sessions, remote sessions) + pub saved: Option, +} + +/// Relative path of the workspace file or directory to inspect. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesStatFileRequest { + /// Slash-separated relative path within the workspace files directory + pub path: String, +} + +/// Filesystem metadata for a path in the session workspace files directory. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkspacesStatFileResult { + /// Creation time in Unix epoch milliseconds pub birthtime_ms: f64, /// Whether the path identifies a directory pub is_directory: bool, @@ -23996,7 +25939,193 @@ pub struct SessionFactoryGetRunResult { pub status: FactoryRunStatus, } -/// A page of factory runs in durable creation order. +/// A page of factory runs in durable creation order. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryListRunsResult { + /// Whether terminal runs newer than this page exist. + #[serde(skip_serializing_if = "Option::is_none")] + pub has_more_newer: Option, + /// Newest terminal-run cursor in this page, or null when the terminal window is empty. + #[serde(skip_serializing_if = "Option::is_none")] + pub newest_seq: Option, + /// Oldest terminal-run cursor in this page, or null when the terminal window is empty. + #[serde(skip_serializing_if = "Option::is_none")] + pub oldest_seq: Option, + /// Number of terminal runs older than this page. + #[serde(skip_serializing_if = "Option::is_none")] + pub omitted_older: Option, + /// Factory run summaries in durable creation order. + pub runs: Vec, +} + +/// Full factory run observability detail. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryGetRunDetailResult { + /// Epoch milliseconds when the current active segment started, or null while inactive. + pub active_segment_started_at: Option, + /// Durable identities and live statuses for direct factory agents. + pub agents: Vec, + /// Approved effective resource ceilings, or null until approved. + pub approved: Option, + /// Whether the durable run state currently passes runtime resume eligibility checks. + pub can_resume: bool, + /// Epoch milliseconds when the run completed, or null while nonterminal. + pub completed_at: Option, + /// Durable resource consumption. + pub consumed: FactoryRunConsumed, + /// Epoch milliseconds when the run was created. + pub created_at: i64, + /// Current phase identity, or null before any phase is entered. + pub current_phase: Option, + /// Resource ceilings declared by the factory. + pub declared_limits: FactoryDeclaredLimits, + /// Number of phases declared by the factory. + pub declared_phase_count: i64, + /// Human-readable factory description. + pub description: String, + /// Registered factory name. + pub factory_name: String, + /// Number of direct factory agents currently live. + pub live_agent_count: i64, + /// Epoch milliseconds when this live-overlay snapshot was observed. + pub observed_at: i64, + /// Lifecycle and timing observations for each factory phase. + pub phases: Vec, + /// Bidirectional page of durable factory progress. + pub progress: FactoryProgressPage, + /// Monotonic durable run revision. + pub revision: i64, + /// Factory run identifier. + pub run_id: String, + /// Epoch milliseconds when execution first started, or null before start. + pub started_at: Option, + /// Current factory run status. + pub status: FactoryRunStatus, + /// Terminal run outcome, or null while nonterminal. + pub terminal: Option, + /// Total direct factory agents spawned across all attempts. + pub total_spawned_agent_count: i64, + /// Epoch milliseconds when the durable run was last updated. + pub updated_at: i64, +} + +/// A bidirectional page of factory progress. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryGetRunProgressResult { + /// Whether progress records newer than this page exist. + pub has_more_newer: bool, + /// Whether progress records older than this page exist. + pub has_more_older: bool, + /// Newest sequence number in this page, or null when empty. + pub newest_seq: Option, + /// Oldest sequence number in this page, or null when empty. + pub oldest_seq: Option, + /// Progress records in sequence order. + pub records: Vec, + /// Run revision reflected by this page. + pub revision: i64, +} + +/// Complete current or terminal factory run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryCancelResult { + /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. + #[serde(skip_serializing_if = "Option::is_none")] + pub attempt: Option, + /// Error message for an errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub error: Option, + /// Machine-readable failure details for a halted or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub failure: Option, + /// Structured pause initiator metadata for a paused attempt. + #[serde(skip_serializing_if = "Option::is_none")] + pub pause_info: Option, + /// Reason for a halted or cancelled run. + #[serde(skip_serializing_if = "Option::is_none")] + pub reason: Option, + /// Completed factory result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result: Option, + /// Factory run identifier. + pub run_id: String, + /// Partial journal and progress snapshot for a halted, cancelled, or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub snapshot: Option, + /// Current or terminal factory run status. + pub status: FactoryRunStatus, +} + +/// Complete current or terminal factory run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryPauseResult { + /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. + #[serde(skip_serializing_if = "Option::is_none")] + pub attempt: Option, + /// Error message for an errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub error: Option, + /// Machine-readable failure details for a halted or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub failure: Option, + /// Structured pause initiator metadata for a paused attempt. + #[serde(skip_serializing_if = "Option::is_none")] + pub pause_info: Option, + /// Reason for a halted or cancelled run. + #[serde(skip_serializing_if = "Option::is_none")] + pub reason: Option, + /// Completed factory result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result: Option, + /// Factory run identifier. + pub run_id: String, + /// Partial journal and progress snapshot for a halted, cancelled, or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub snapshot: Option, + /// Current or terminal factory run status. + pub status: FactoryRunStatus, +} + /// ///
/// @@ -24006,7 +26135,228 @@ pub struct SessionFactoryGetRunResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryListRunsResult { +pub struct SessionFactoryPauseAtCheckpointResult { + /// Whether this execution attempt must pause or may continue. + pub action: FactoryPauseCheckpointAction, +} + +/// Acknowledgement that a factory request was accepted. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryLogResult {} + +/// Result of one factory-scoped subagent call. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryAgentResult { + /// Agent result, omitted when the agent produced no result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result: Option, +} + +/// Result of reading a factory journal entry. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryJournalGetResult { + /// Whether the journal contained the requested key. + pub hit: bool, + /// Cached JSON result. The hit field distinguishes a cached JSON null from a miss. + #[serde(skip_serializing_if = "Option::is_none")] + pub result_json: Option, +} + +/// Acknowledgement that a factory request was accepted. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionFactoryJournalPutResult {} + +/// Complete current or terminal workflow run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionWorkflowRunResult { + /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. + #[serde(skip_serializing_if = "Option::is_none")] + pub attempt: Option, + /// Error message for an errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub error: Option, + /// Machine-readable failure details for a halted or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub failure: Option, + /// Structured pause initiator metadata for a paused attempt. + #[serde(skip_serializing_if = "Option::is_none")] + pub pause_info: Option, + /// Reason for a halted or cancelled run. + #[serde(skip_serializing_if = "Option::is_none")] + pub reason: Option, + /// Completed workflow result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result: Option, + /// Workflow run identifier. + pub run_id: String, + /// Partial journal and progress snapshot for a halted, cancelled, or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub snapshot: Option, + /// Current or terminal workflow run status. + pub status: WorkflowRunStatus, +} + +/// Resolved persisted workflow identity and resumed run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionWorkflowResumeResult { + /// Terminal resumed run envelope. + pub run: WorkflowRunResult, + /// Persisted workflow name resolved for the resumed run. + pub workflow_name: String, +} + +/// Complete current or terminal workflow run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionWorkflowRunFromToolResult { + /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. + #[serde(skip_serializing_if = "Option::is_none")] + pub attempt: Option, + /// Error message for an errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub error: Option, + /// Machine-readable failure details for a halted or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub failure: Option, + /// Structured pause initiator metadata for a paused attempt. + #[serde(skip_serializing_if = "Option::is_none")] + pub pause_info: Option, + /// Reason for a halted or cancelled run. + #[serde(skip_serializing_if = "Option::is_none")] + pub reason: Option, + /// Completed workflow result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result: Option, + /// Workflow run identifier. + pub run_id: String, + /// Partial journal and progress snapshot for a halted, cancelled, or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub snapshot: Option, + /// Current or terminal workflow run status. + pub status: WorkflowRunStatus, +} + +/// Resolved persisted workflow identity and resumed run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionWorkflowResumeFromToolResult { + /// Terminal resumed run envelope. + pub run: WorkflowRunResult, + /// Persisted workflow name resolved for the resumed run. + pub workflow_name: String, +} + +/// Complete current or terminal workflow run envelope. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionWorkflowGetRunResult { + /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. + #[serde(skip_serializing_if = "Option::is_none")] + pub attempt: Option, + /// Error message for an errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub error: Option, + /// Machine-readable failure details for a halted or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub failure: Option, + /// Structured pause initiator metadata for a paused attempt. + #[serde(skip_serializing_if = "Option::is_none")] + pub pause_info: Option, + /// Reason for a halted or cancelled run. + #[serde(skip_serializing_if = "Option::is_none")] + pub reason: Option, + /// Completed workflow result. + #[serde(skip_serializing_if = "Option::is_none")] + pub result: Option, + /// Workflow run identifier. + pub run_id: String, + /// Partial journal and progress snapshot for a halted, cancelled, or errored run. + #[serde(skip_serializing_if = "Option::is_none")] + pub snapshot: Option, + /// Current or terminal workflow run status. + pub status: WorkflowRunStatus, +} + +/// A page of workflow runs in durable creation order. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionWorkflowListRunsResult { /// Whether terminal runs newer than this page exist. #[serde(skip_serializing_if = "Option::is_none")] pub has_more_newer: Option, @@ -24019,11 +26369,11 @@ pub struct SessionFactoryListRunsResult { /// Number of terminal runs older than this page. #[serde(skip_serializing_if = "Option::is_none")] pub omitted_older: Option, - /// Factory run summaries in durable creation order. - pub runs: Vec, + /// Workflow run summaries in durable creation order. + pub runs: Vec, } -/// Full factory run observability detail. +/// Full workflow run observability detail. /// ///
/// @@ -24033,56 +26383,56 @@ pub struct SessionFactoryListRunsResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryGetRunDetailResult { +pub struct SessionWorkflowGetRunDetailResult { /// Epoch milliseconds when the current active segment started, or null while inactive. pub active_segment_started_at: Option, - /// Durable identities and live statuses for direct factory agents. - pub agents: Vec, + /// Durable identities and live statuses for direct workflow agents. + pub agents: Vec, /// Approved effective resource ceilings, or null until approved. - pub approved: Option, + pub approved: Option, /// Whether the durable run state currently passes runtime resume eligibility checks. pub can_resume: bool, /// Epoch milliseconds when the run completed, or null while nonterminal. pub completed_at: Option, /// Durable resource consumption. - pub consumed: FactoryRunConsumed, + pub consumed: WorkflowRunConsumed, /// Epoch milliseconds when the run was created. pub created_at: i64, /// Current phase identity, or null before any phase is entered. - pub current_phase: Option, - /// Resource ceilings declared by the factory. - pub declared_limits: FactoryDeclaredLimits, - /// Number of phases declared by the factory. + pub current_phase: Option, + /// Resource ceilings declared by the workflow. + pub declared_limits: WorkflowDeclaredLimits, + /// Number of phases declared by the workflow. pub declared_phase_count: i64, - /// Human-readable factory description. + /// Human-readable workflow description. pub description: String, - /// Registered factory name. - pub factory_name: String, - /// Number of direct factory agents currently live. + /// Number of direct workflow agents currently live. pub live_agent_count: i64, /// Epoch milliseconds when this live-overlay snapshot was observed. pub observed_at: i64, - /// Lifecycle and timing observations for each factory phase. - pub phases: Vec, - /// Bidirectional page of durable factory progress. - pub progress: FactoryProgressPage, + /// Lifecycle and timing observations for each workflow phase. + pub phases: Vec, + /// Bidirectional page of durable workflow progress. + pub progress: WorkflowProgressPage, /// Monotonic durable run revision. pub revision: i64, - /// Factory run identifier. + /// Workflow run identifier. pub run_id: String, /// Epoch milliseconds when execution first started, or null before start. pub started_at: Option, - /// Current factory run status. - pub status: FactoryRunStatus, + /// Current workflow run status. + pub status: WorkflowRunStatus, /// Terminal run outcome, or null while nonterminal. - pub terminal: Option, - /// Total direct factory agents spawned across all attempts. + pub terminal: Option, + /// Total direct workflow agents spawned across all attempts. pub total_spawned_agent_count: i64, /// Epoch milliseconds when the durable run was last updated. pub updated_at: i64, + /// Registered workflow name. + pub workflow_name: String, } -/// A bidirectional page of factory progress. +/// A bidirectional page of workflow progress. /// ///
/// @@ -24092,7 +26442,7 @@ pub struct SessionFactoryGetRunDetailResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryGetRunProgressResult { +pub struct SessionWorkflowGetRunProgressResult { /// Whether progress records newer than this page exist. pub has_more_newer: bool, /// Whether progress records older than this page exist. @@ -24102,12 +26452,12 @@ pub struct SessionFactoryGetRunProgressResult { /// Oldest sequence number in this page, or null when empty. pub oldest_seq: Option, /// Progress records in sequence order. - pub records: Vec, + pub records: Vec, /// Run revision reflected by this page. pub revision: i64, } -/// Complete current or terminal factory run envelope. +/// Complete current or terminal workflow run envelope. /// ///
/// @@ -24117,7 +26467,7 @@ pub struct SessionFactoryGetRunProgressResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryCancelResult { +pub struct SessionWorkflowCancelResult { /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. #[serde(skip_serializing_if = "Option::is_none")] pub attempt: Option, @@ -24133,19 +26483,19 @@ pub struct SessionFactoryCancelResult { /// Reason for a halted or cancelled run. #[serde(skip_serializing_if = "Option::is_none")] pub reason: Option, - /// Completed factory result. + /// Completed workflow result. #[serde(skip_serializing_if = "Option::is_none")] pub result: Option, - /// Factory run identifier. + /// Workflow run identifier. pub run_id: String, /// Partial journal and progress snapshot for a halted, cancelled, or errored run. #[serde(skip_serializing_if = "Option::is_none")] pub snapshot: Option, - /// Current or terminal factory run status. - pub status: FactoryRunStatus, + /// Current or terminal workflow run status. + pub status: WorkflowRunStatus, } -/// Complete current or terminal factory run envelope. +/// Complete current or terminal workflow run envelope. /// ///
/// @@ -24155,7 +26505,7 @@ pub struct SessionFactoryCancelResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryPauseResult { +pub struct SessionWorkflowPauseResult { /// One-based execution attempt represented by this envelope. Absent before the first attempt starts or when returned by an older runtime. #[serde(skip_serializing_if = "Option::is_none")] pub attempt: Option, @@ -24171,16 +26521,16 @@ pub struct SessionFactoryPauseResult { /// Reason for a halted or cancelled run. #[serde(skip_serializing_if = "Option::is_none")] pub reason: Option, - /// Completed factory result. + /// Completed workflow result. #[serde(skip_serializing_if = "Option::is_none")] pub result: Option, - /// Factory run identifier. + /// Workflow run identifier. pub run_id: String, /// Partial journal and progress snapshot for a halted, cancelled, or errored run. #[serde(skip_serializing_if = "Option::is_none")] pub snapshot: Option, - /// Current or terminal factory run status. - pub status: FactoryRunStatus, + /// Current or terminal workflow run status. + pub status: WorkflowRunStatus, } /// @@ -24192,12 +26542,12 @@ pub struct SessionFactoryPauseResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryPauseAtCheckpointResult { +pub struct SessionWorkflowPauseAtCheckpointResult { /// Whether this execution attempt must pause or may continue. - pub action: FactoryPauseCheckpointAction, + pub action: WorkflowPauseCheckpointAction, } -/// Acknowledgement that a factory request was accepted. +/// Acknowledgement that a workflow request was accepted. /// ///
/// @@ -24207,9 +26557,9 @@ pub struct SessionFactoryPauseAtCheckpointResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryLogResult {} +pub struct SessionWorkflowLogResult {} -/// Result of one factory-scoped subagent call. +/// Result of one workflow-scoped subagent call. /// ///
/// @@ -24219,13 +26569,13 @@ pub struct SessionFactoryLogResult {} ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryAgentResult { +pub struct SessionWorkflowAgentResult { /// Agent result, omitted when the agent produced no result. #[serde(skip_serializing_if = "Option::is_none")] pub result: Option, } -/// Result of reading a factory journal entry. +/// Result of reading a workflow journal entry. /// ///
/// @@ -24235,7 +26585,7 @@ pub struct SessionFactoryAgentResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryJournalGetResult { +pub struct SessionWorkflowJournalGetResult { /// Whether the journal contained the requested key. pub hit: bool, /// Cached JSON result. The hit field distinguishes a cached JSON null from a miss. @@ -24243,7 +26593,7 @@ pub struct SessionFactoryJournalGetResult { pub result_json: Option, } -/// Acknowledgement that a factory request was accepted. +/// Acknowledgement that a workflow request was accepted. /// ///
/// @@ -24253,7 +26603,7 @@ pub struct SessionFactoryJournalGetResult { ///
#[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SessionFactoryJournalPutResult {} +pub struct SessionWorkflowJournalPutResult {} /// Identifies the target session. /// @@ -24333,6 +26683,9 @@ pub struct SessionModelSwitchToResult { /// Persistence failure encountered after applying the model switch. #[serde(skip_serializing_if = "Option::is_none")] pub persistence_error: Option, + /// Stable queue item identifier when this request was enqueued. Remains present if the item drains before the response is returned. + #[serde(skip_serializing_if = "Option::is_none")] + pub queue_id: Option, /// Lifecycle result for the requested switch #[serde(skip_serializing_if = "Option::is_none")] pub status: Option, @@ -24400,6 +26753,9 @@ pub struct SessionModelApplyStartupOverlayResult { /// Persistence failure encountered after applying the model switch. #[serde(skip_serializing_if = "Option::is_none")] pub persistence_error: Option, + /// Stable queue item identifier when this request was enqueued. Remains present if the item drains before the response is returned. + #[serde(skip_serializing_if = "Option::is_none")] + pub queue_id: Option, /// Lifecycle result for the requested switch #[serde(skip_serializing_if = "Option::is_none")] pub status: Option, @@ -26310,6 +28666,61 @@ pub struct SessionMcpResourcesListTemplatesResult { pub resource_templates: Vec, } +/// Identifies the target session. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionManagedSettingsGetParams { + /// Target session identifier + pub session_id: SessionId, +} + +/// Enterprise managed-settings resolution: the effective managed settings the session applied and which channels contributed, so SDK clients can show users what is enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on resume, and on account switch. This is an ephemeral live snapshot (delivered to subscribers but not persisted to the session event log), because at session start it resolves before `session.start` is emitted. Device values take precedence over server values, then the policy helper, per ordinary key, while permissions compose restrictively across device, server, policy-helper, and SDK-client layers. The account-scoped `getManagedSettings()` API does not include session-local client injection. Marked experimental while the managed-settings surface stabilizes. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionManagedSettingsGetResult { + /// Whether enterprise policy disables bypass-permissions ("yolo") mode for this session. Deny-wins across layers, and forced on when `failClosed` is true. + pub bypass_permissions_disabled: bool, + /// Whether a session-local permissions layer injected by the SDK host was present + #[serde(skip_serializing_if = "Option::is_none")] + pub client_managed: Option, + /// Whether an actual device MDM/plist/registry/file managed-settings layer was present + pub device_managed: bool, + /// Whether managed policy could not be determined (e.g. a failed server fetch) and the session fell back to the fail-closed restriction. When true, restrictions such as disabling bypass-permissions are enforced even though `settings` may be absent. + pub fail_closed: bool, + /// The setting keys under enterprise management in the effective managed settings (e.g. `model`, `enabledPlugins`, `permissions`). Empty when no managed settings are in force. + pub managed_keys: Vec, + /// Whether at least two managed sources supplied permission allowlists, so enforcement intersects them and the flattened settings payload omits `permissions.allow`. + #[serde(skip_serializing_if = "Option::is_none")] + pub permissions_allow_intersected: Option, + /// Whether the policy-helper managed-settings layer was present. The policy helper is the weakest channel: it fills keys no enterprise source set and can never replace one. + #[serde(skip_serializing_if = "Option::is_none")] + pub policy_helper_managed: Option, + /// Whether the effective sandbox policy forces the sandbox on *only* because managed policy could not be determined, rather than because the policy requires it. Lets clients tell a user whose `--no-sandbox` was overridden that the sandbox stayed on as a fail-closed fallback, instead of attributing it to an administrator who set no such policy. + #[serde(skip_serializing_if = "Option::is_none")] + pub sandbox_enabled_by_undetermined_policy: Option, + /// Whether the server (account/org) managed-settings layer was present + pub server_managed: bool, + /// The effective (resolved) managed settings values, so clients can render exactly what is enforced. Absent when no managed policy is in force. + #[serde(skip_serializing_if = "Option::is_none")] + pub settings: Option, + /// Channel summary: `server`, `device`, `client`, or `policyHelper` when exactly one channel contributed; `mixed` when multiple channels contributed; otherwise `none`. Consult the per-channel booleans for exact provenance. + pub source: ManagedSettingsResolvedSource, +} + /// Identifies the target session. /// ///
@@ -26340,6 +28751,146 @@ pub struct SessionPluginsListResult { pub plugins: Vec, } +/// Result of installing a plugin. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsInstallResult { + /// Set when the install path is deprecated (e.g. direct repo / URL / local installs). Callers should surface this to end users. + #[serde(skip_serializing_if = "Option::is_none")] + pub deprecation_warning: Option, + /// The newly installed plugin's metadata + pub plugin: InstalledPluginInfo, + /// Optional post-install message provided by the plugin (e.g. setup instructions) + #[serde(skip_serializing_if = "Option::is_none")] + pub post_install_message: Option, + /// Number of skills discovered and installed from the plugin + pub skills_installed: i64, + /// Where the completed plugin tree was staged before atomic promotion + #[serde(skip_serializing_if = "Option::is_none")] + pub staging_mode: Option, +} + +/// Result of updating a single plugin. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsUpdateResult { + /// Version after the update, when reported by the plugin manifest + #[serde(skip_serializing_if = "Option::is_none")] + pub new_version: Option, + /// Version that was previously installed, when available + #[serde(skip_serializing_if = "Option::is_none")] + pub previous_version: Option, + /// Number of skills discovered and installed after the update + pub skills_installed: i64, +} + +/// Identifies the target session. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsMarketplacesListParams { + /// Target session identifier + pub session_id: SessionId, +} + +/// All registered marketplaces, including built-in defaults. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsMarketplacesListResult { + /// Registered marketplaces + pub marketplaces: Vec, +} + +/// Result of registering a new marketplace. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsMarketplacesAddResult { + /// Final name of the marketplace as resolved from its manifest + pub name: String, +} + +/// Outcome of the remove attempt, including dependent-plugin info when applicable. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsMarketplacesRemoveResult { + /// Names of installed plugins that prevented removal. Populated only when `removed=false`. + #[serde(skip_serializing_if = "Option::is_none")] + pub dependent_plugins: Option>, + /// True when the marketplace was actually removed. False when removal was skipped because the marketplace has dependent plugins and `force` was not set. + pub removed: bool, +} + +/// Plugins advertised by the marketplace. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsMarketplacesBrowseResult { + /// Plugins advertised by the marketplace + pub plugins: Vec, +} + +/// Result of refreshing one or more marketplace catalogs. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPluginsMarketplacesRefreshResult { + /// Per-marketplace refresh results in deterministic order. + pub results: Vec, +} + /// A snapshot of the provider endpoint the session is currently configured to talk to. /// ///
@@ -26475,6 +29026,9 @@ pub struct SessionToolsGetBuiltinDescriptorsResult { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct SessionToolsTaskCompleteEventDataResult { + /// Structured blocker details when outcome is blocked + #[serde(skip_serializing_if = "Option::is_none")] + pub blocker: Option, /// Active autopilot objective ID evaluated by the completion reviewer #[serde(skip_serializing_if = "Option::is_none")] pub objective_id: Option, @@ -27298,6 +29852,9 @@ pub struct SessionMetadataSnapshotResult { pub client_name: Option, /// The current agent mode for this session (e.g., 'interactive', 'plan', 'autopilot') pub current_mode: MetadataSnapshotCurrentMode, + /// Live indexed-search state for this session activation. Omitted by runtimes that do not expose indexed-search status; absence does not indicate enablement. + #[serde(skip_serializing_if = "Option::is_none")] + pub indexed_search: Option, /// User-provided name supplied at session construction (via `--name`), if any. Immutable after construction. #[serde(skip_serializing_if = "Option::is_none")] pub initial_name: Option, @@ -28043,6 +30600,9 @@ pub struct SessionQueueSnapshotParams { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct SessionQueueSnapshotResult { + /// Queue item identifier of a model switch that has been dequeued but not yet applied. + #[serde(skip_serializing_if = "Option::is_none")] + pub in_flight_model_change_id: Option, /// Insertion orders for queued items, aligned with `items`. #[serde(skip_serializing_if = "Option::is_none")] pub item_orders: Option>, @@ -28115,6 +30675,36 @@ pub struct SessionQueueUpdateTextResult { pub updated: bool, } +/// Result of removing a queued item. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionQueueWithdrawMessageResult { + /// True when the addressed item was removed. + pub removed: bool, +} + +/// Result of editing a queued message. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionQueueAppendSteeringResult { + /// True when the stored text changed. + pub updated: bool, +} + /// Result of duplicating a queued item. /// ///
@@ -28779,6 +31369,18 @@ pub struct ProviderTokenGetTokenResult { #[serde(rename_all = "camelCase")] pub struct FactoryAbortResult {} +/// Acknowledgement that a workflow request was accepted. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct WorkflowAbortResult {} + /// Identifies the target session. /// ///
@@ -28846,6 +31448,26 @@ pub type CardDigestValue = String; ///
pub type CatalogCapabilityId = String; +/// Canonical catalogue resource identity. The runtime rewrites accepted urn:ai and urn:air identifiers to urn:air, lowercases the authority, and preserves the remaining resource components. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+pub type CatalogResourceIdentity = String; + +/// Bounded source-declared resource version, preserved exactly after validation and never inferred. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+pub type CatalogResourceVersion = String; + /// Client-owned, case-sensitive string metadata persisted with a local session. Clients should namespace keys by owner. Keys must be non-empty and at most 256 UTF-8 bytes; keys under `copilot/` and `github/` are reserved. Values may contain at most 16 KiB of UTF-8 data. A bag may contain at most 128 entries and its serialized sidecar may contain at most 64 KiB. The runtime stores but never interprets these values. /// ///
@@ -29704,36 +32326,124 @@ pub enum CardDigestAlgorithm { Unknown, } -/// AI skills are discovery-only and cannot be installed through this surface +/// Explicit Agent Plugin compatibility declared by exact catalog tags. Clients must not infer these values from display text or other metadata. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] -pub enum CatalogAiSkillCandidateInstallability { - #[serde(rename = "not-installable-kind")] +pub enum CatalogAgentPluginCompatibilityTag { + /// The plugin contributes at least one GitHub Copilot Canvas. + #[serde(rename = "canvas")] + Canvas, + /// The plugin depends on Canvas for its intended functionality. + #[serde(rename = "canvas-only")] + CanvasOnly, + /// The plugin targets GitHub Copilot. + #[serde(rename = "github-copilot")] + GitHubCopilot, + /// Unknown variant for forward compatibility. #[default] - NotInstallableKind, + #[serde(other)] + Unknown, } -/// Discriminator: this candidate describes an AI skill +/// Discriminator for an Agent Plugin candidate +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] -pub enum CatalogAiSkillCandidateKind { - #[serde(rename = "ai-skill")] +pub enum CatalogAgentPluginCandidateKind { + /// An Agent Plugin. + #[serde(rename = "plugin")] + Plugin, + /// Unknown variant for forward compatibility. #[default] - AiSkill, + #[serde(other)] + Unknown, +} + +/// Canonical Agent Plugin media type +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogAgentPluginMediaType { + /// A GitHub Copilot Agent Plugin descriptor. + #[serde(rename = "application/vnd.github.copilot-plugin")] + ApplicationVndGitHubCopilotPlugin, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, } -/// Media type of the underlying AI skill card +/// Typed non-installable state for an AI skill candidate +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] -pub enum CatalogAiSkillCandidateMediaType { - #[serde(rename = "application/ai-skill")] +pub enum CatalogAiSkillInstallability { + /// AI skills are discovery-only on this surface. + #[serde(rename = "not-installable-kind")] + NotInstallableKind, + /// Unknown variant for forward compatibility. #[default] - ApplicationAiSkill, + #[serde(other)] + Unknown, } -/// Media type advertised for the referenced AI skill card +/// Discriminator for an AI skill candidate +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] -pub enum CatalogAiSkillCandidateProvenanceMediaType { - #[serde(rename = "application/ai-skill")] +pub enum CatalogAiSkillCandidateKind { + /// An AI skill. + #[serde(rename = "ai-skill")] + AiSkill, + /// Unknown variant for forward compatibility. #[default] + #[serde(other)] + Unknown, +} + +/// Canonical AI skill media type +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogAiSkillMediaType { + /// An AI skill card. + #[serde(rename = "application/ai-skill")] ApplicationAiSkill, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, } /// Discriminator: the card is URL-backed, and carries no embedded data @@ -29822,12 +32532,23 @@ pub enum CatalogMcpServerInstallability { Unknown, } -/// Discriminator: this candidate describes an MCP server +/// Discriminator for an MCP server candidate +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] pub enum CatalogMcpServerCandidateKind { + /// An MCP server. #[serde(rename = "mcp-server")] - #[default] McpServer, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, } /// JSON MCP card media type accepted for install planning @@ -29852,7 +32573,7 @@ pub enum McpServerCardMediaType { Unknown, } -/// One inert catalog result, represented as an MCP server or discovery-only AI skill variant so kind, media type, provenance, and installability cannot contradict each other. +/// One inert catalog result, represented as an MCP server, discovery-only AI skill, or opt-in Agent Plugin variant so kind, media type, provenance, and available operations cannot contradict each other. /// ///
/// @@ -29865,6 +32586,7 @@ pub enum McpServerCardMediaType { pub enum CatalogCandidate { McpServer(CatalogMcpServerCandidate), AiSkill(CatalogAiSkillCandidate), + Plugin(CatalogAgentPluginCandidate), } /// What kind of resource a catalog candidate describes @@ -29883,6 +32605,9 @@ pub enum CatalogCandidateKind { /// An AI skill, which is discoverable but not installable through this surface. #[serde(rename = "ai-skill")] AiSkill, + /// An inert Agent Plugin candidate, available only when explicitly requested. + #[serde(rename = "plugin")] + Plugin, /// Unknown variant for forward compatibility. #[default] #[serde(other)] @@ -29908,15 +32633,24 @@ pub enum CatalogCapability { /// Understands `application/ai-skill` candidates as discovery-only and typed non-installable. #[serde(rename = "ai-skill-discovery")] AiSkillDiscovery, + /// Understands opt-in `application/vnd.github.copilot-plugin` candidates and their typed identity, version, source, and compatibility fields. + #[serde(rename = "agent-plugin-discovery")] + AgentPluginDiscovery, /// Understands side-effect-free MCP install-plan requests, results, and plan handles; `planning-unavailable` separately reports that planning is not enabled. #[serde(rename = "mcp-install-planning")] McpInstallPlanning, /// Understands plans that enumerate every eligible transport rather than a single preferred one. #[serde(rename = "multiple-transport-choice")] MultipleTransportChoice, + /// Understands explicit numbered navigation and authority-reported pagination metadata with opaque tokens. Advertised and granted only when requested. + #[serde(rename = "catalog-search-pagination")] + CatalogSearchPagination, /// Understands versioned candidate trust snapshots. Protocol-3 callers must require this capability before the runtime adds the optional snapshot field. #[serde(rename = "trust-snapshot")] TrustSnapshot, + /// Understands exact candidate selection through model-safe opaque references and host-only candidate-handle hand-off. + #[serde(rename = "catalog-selection")] + CatalogSelection, /// Unknown variant for forward compatibility. #[default] #[serde(other)] @@ -29947,7 +32681,7 @@ pub enum CatalogContractViolationReason { /// A result carried neither a URL nor embedded data, when exactly one is required. #[serde(rename = "neither-url-nor-data")] NeitherUrlNorData, - /// Two results claimed the same normalised identity. + /// Two results claimed the same collision key: normalised identity for existing kinds, or normalised identity and declared version for Agent Plugins. #[serde(rename = "duplicate-identity")] DuplicateIdentity, /// A result declared no media type, or one this contract does not model. @@ -29975,6 +32709,9 @@ pub enum CatalogHandleType { /// An install plan handle. #[serde(rename = "plan")] Plan, + /// A model-safe reference to one retained search candidate. + #[serde(rename = "selection")] + Selection, /// Unknown variant for forward compatibility. #[default] #[serde(other)] @@ -29999,7 +32736,7 @@ pub enum CatalogHandleRejectedErrorKind { ///
#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] pub enum CatalogHandleRejectionReason { - /// The handle is unparseable, unknown, or was issued for a different operation. + /// The handle is unparseable or unknown. #[serde(rename = "invalid")] Invalid, /// The handle's time to live has elapsed. @@ -30008,16 +32745,22 @@ pub enum CatalogHandleRejectionReason { /// The handle has already been used, and handles are single-use. #[serde(rename = "replayed")] Replayed, - /// The handle was issued by a different runtime instance. + /// The handle was issued by a different runtime instance or session. #[serde(rename = "foreign")] Foreign, + /// The handle was issued for another catalog operation. + #[serde(rename = "wrong-kind")] + WrongKind, + /// The supplied search identifier does not match the retained candidate. + #[serde(rename = "search-mismatch")] + SearchMismatch, /// Unknown variant for forward compatibility. #[default] #[serde(other)] Unknown, } -/// Which request field was rejected before any work was done +/// Which request field was rejected locally or by the catalog authority /// ///
/// @@ -30048,6 +32791,18 @@ pub enum CatalogInvalidRequestField { /// The requested configuration scope is not one this runtime writes. #[serde(rename = "scope")] Scope, + /// The pagination token or target was invalid, or the authority rejected the continuation. Repeat the search without page. + #[serde(rename = "page")] + Page, + /// The locally owned session identifier was missing or malformed. + #[serde(rename = "sessionId")] + SessionId, + /// The opaque selection reference was missing or malformed. + #[serde(rename = "selectionRef")] + SelectionRef, + /// The terminal selection outcome was missing or unsupported. + #[serde(rename = "outcome")] + Outcome, /// Unknown variant for forward compatibility. #[default] #[serde(other)] @@ -30089,6 +32844,9 @@ pub enum CatalogMediaType { /// An AI skill card. Representable and searchable, but typed non-installable. #[serde(rename = "application/ai-skill")] ApplicationAiSkill, + /// An inert Agent Plugin descriptor. + #[serde(rename = "application/vnd.github.copilot-plugin")] + ApplicationVndGitHubCopilotPlugin, /// Unknown variant for forward compatibility. #[default] #[serde(other)] @@ -30282,6 +33040,25 @@ pub enum McpPlanPolicySource { Unknown, } +/// Relationship of the backend-reported count to the complete query result set. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSearchTotalCountRelation { + /// No exact/full-query or lower-bound guarantee is available. + #[serde(rename = "unknown")] + UnknownValue, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + /// Discriminator: the search completed #[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] pub enum CatalogSearchSucceededKind { @@ -30364,6 +33141,9 @@ pub enum CatalogUnavailableReason { /// Install planning is not wired up on this runtime build. #[serde(rename = "planning-unavailable")] PlanningUnavailable, + /// Exact candidate selection is not available in this session or runtime. + #[serde(rename = "selection-unavailable")] + SelectionUnavailable, /// No catalog authority is configured for this runtime. #[serde(rename = "authority-not-configured")] AuthorityNotConfigured, @@ -30400,6 +33180,131 @@ pub enum CatalogSearchResult { Unavailable(CatalogUnavailableError), } +/// Discriminator: selection was cancelled +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionCancelledKind { + #[serde(rename = "cancelled")] + #[default] + Cancelled, +} + +/// Terminal outcome declared for a retained catalog selection group +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionDecision { + /// Choose the candidate named by selectionRef. + #[serde(rename = "selected")] + Selected, + /// Explicitly decline every candidate in the search. + #[serde(rename = "declined")] + Declined, + /// Cancel the selection interaction without choosing a candidate. + #[serde(rename = "cancelled")] + Cancelled, + /// Declare that the host's live interaction deadline elapsed while the reference remained valid. + #[serde(rename = "timed-out")] + TimedOut, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Discriminator: the candidates were declined +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionDeclinedKind { + #[serde(rename = "declined")] + #[default] + Declined, +} + +/// Discriminator for this typed selection rejection +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionForeignKind { + #[serde(rename = "foreign")] + #[default] + Foreign, +} + +/// Discriminator for this typed selection rejection +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionInvalidKind { + #[serde(rename = "invalid")] + #[default] + Invalid, +} + +/// Discriminator for this typed selection rejection +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionReplayedKind { + #[serde(rename = "replayed")] + #[default] + Replayed, +} + +/// Discriminator: one candidate was selected +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionSelectedKind { + #[serde(rename = "selected")] + #[default] + Selected, +} + +/// Discriminator: the host's live interaction timed out +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionTimedOutKind { + #[serde(rename = "timed-out")] + #[default] + TimedOut, +} + +/// Discriminator for this typed selection rejection +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionStaleKind { + #[serde(rename = "stale")] + #[default] + Stale, +} + +/// Discriminator for this typed selection rejection +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum CatalogSelectionWrongKindKind { + #[serde(rename = "wrong-kind")] + #[default] + WrongKind, +} + +/// Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Serialize, Deserialize)] +#[serde(untagged)] +pub enum CatalogSelectionResult { + Selected(CatalogSelectionSelected), + Declined(CatalogSelectionDeclined), + Cancelled(CatalogSelectionCancelled), + TimedOut(CatalogSelectionTimedOut), + Invalid(CatalogSelectionInvalid), + Stale(CatalogSelectionStale), + Replayed(CatalogSelectionReplayed), + Foreign(CatalogSelectionForeign), + WrongKind(CatalogSelectionWrongKind), + NegotiationRefused(CatalogNegotiationRefusedError), + InvalidRequest(CatalogInvalidRequestError), + Unavailable(CatalogUnavailableError), +} + /// Authority-computed exposure eligibility, kept separate from tier. The current tier-only Agent Finder response maps to `unknown`, never to a locally inferred eligibility. /// ///
@@ -36054,6 +38959,189 @@ pub enum UISessionLimitsExhaustedResponseAction { Unknown, } +/// Execution-critical workflow storage operation. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum WorkflowDurableOperation { + /// Creating the durable run and declared phases. + #[serde(rename = "createRun")] + CreateRun, + /// Persisting the transition to running. + #[serde(rename = "markRunStarted")] + MarkRunStarted, + /// Persisting the terminal run envelope. + #[serde(rename = "finishRun")] + FinishRun, + /// Persisting subagent admission accounting. + #[serde(rename = "reserveAgent")] + ReserveAgent, + /// Rolling back an uncommitted subagent admission. + #[serde(rename = "releaseAgent")] + ReleaseAgent, + /// Persisting an idempotent model-usage charge. + #[serde(rename = "chargeCredit")] + ChargeCredit, + /// Persisting active execution time. + #[serde(rename = "addElapsed")] + AddElapsed, + /// Reading the authoritative AI-credit total. + #[serde(rename = "reconcileCreditTotal")] + ReconcileCreditTotal, + /// Reading a journal entry without treating storage failure as a cache miss. + #[serde(rename = "journalGet")] + JournalGet, + /// Persisting a journal entry before reporting success. + #[serde(rename = "journalPut")] + JournalPut, + /// Renewing the durable owner lease that proves this process still owns the run. + #[serde(rename = "refreshLease")] + RefreshLease, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Current or terminal state of a workflow run. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum WorkflowRunStatus { + /// The run was minted and is awaiting approval. + #[serde(rename = "pending")] + Pending, + /// The run is executing. + #[serde(rename = "running")] + Running, + /// The run completed successfully. + #[serde(rename = "completed")] + Completed, + /// The run was interrupted while resource budget remained. + #[serde(rename = "halted")] + Halted, + /// The current attempt stopped intentionally and the run may be resumed. + #[serde(rename = "paused")] + Paused, + /// The run was cancelled before completion. + #[serde(rename = "cancelled")] + Cancelled, + /// The workflow body failed or reached a cumulative resource ceiling. + #[serde(rename = "error")] + Error, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Kind of workflow progress line. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum WorkflowLogLineKind { + /// A narrator log line. + #[serde(rename = "log")] + Log, + /// A named workflow phase marker. + #[serde(rename = "phase")] + Phase, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Action the runtime selected for a durable workflow pause checkpoint. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum WorkflowPauseCheckpointAction { + /// The checkpoint was committed by a prior paused attempt, so execution may continue. + #[serde(rename = "continue")] + Continue, + /// This attempt claimed the checkpoint and must cooperatively stop. + #[serde(rename = "pause")] + Pause, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Derived lifecycle state of a workflow phase. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum WorkflowPhaseStatus { + /// The phase has not been entered yet. + #[serde(rename = "pending")] + Pending, + /// The phase is currently entered and accumulating active time. + #[serde(rename = "active")] + Active, + /// The phase was entered and has since been closed. + #[serde(rename = "completed")] + Completed, + /// The phase was never entered because a later phase was entered or the run reached a terminal state. + #[serde(rename = "skipped")] + Skipped, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Cumulative resource ceiling that stopped a workflow run. +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum WorkflowRunFailureKind { + /// The run admitted the approved maximum total number of subagents. + #[serde(rename = "maxTotalSubagents")] + MaxTotalSubagents, + /// The run reached the approved accumulated active-execution time in seconds. + #[serde(rename = "timeoutSeconds")] + TimeoutSeconds, + /// The run's settled subagent model usage exceeded the approved AI-credit ceiling, or no headroom remained for another subagent. + #[serde(rename = "maxAiCredits")] + MaxAiCredits, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + /// Type of change represented by this file diff. /// ///
diff --git a/rust/src/generated/rpc.rs b/rust/src/generated/rpc.rs index bbde719b6a..449d8c7e1e 100644 --- a/rust/src/generated/rpc.rs +++ b/rust/src/generated/rpc.rs @@ -549,6 +549,37 @@ impl<'a> ClientRpcCatalog<'a> { .await?; Ok(serde_json::from_value(_value)?) } + + /// Terminates one retained catalog selection group. A selected outcome returns the native host a fresh single-use candidate handle plus the original searchId for a later explicit mcp.planInstall call; non-selected outcomes release the group without producing a planning input. Candidate state, cards, URLs, credentials and private identifiers remain inside the runtime. The model-facing catalog_select tool projects the result separately and never exposes the candidate handle or searchId. + /// + /// Wire method: `catalog.select`. + /// + /// # Parameters + /// + /// * `params` - Terminates one retained catalog selection group through an opaque reference previously returned by the model-safe search projection. + /// + /// # Returns + /// + /// Typed outcome of catalog.select. Only the selected host result carries a fresh candidate handle; the model-facing projection removes both that handle and searchId. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn select( + &self, + params: CatalogSelectionRequest, + ) -> Result { + let wire_params = serde_json::to_value(params)?; + let _value = self + .client + .call(rpc_methods::CATALOG_SELECT, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } } /// `commands.*` RPCs. @@ -1750,7 +1781,7 @@ impl<'a> ClientRpcSessionFs<'a> { /// /// # Parameters /// - /// * `params` - Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. + /// * `params` - Initial working directory, session-state path layout, and path conventions used to register the calling SDK client as the session filesystem provider. A registered provider is authoritative for path interpretation and filesystem facts used by workspace permission validation. Paths are interpreted lexically; home-relative paths (`~` and `~/...`) and Windows drive-relative paths such as `C:foo` are unsupported. Until provider-side canonicalization is supported, providers must not expose symlinks inside allowed roots that escape those roots. /// /// # Returns /// @@ -3202,6 +3233,13 @@ impl<'a> SessionRpc<'a> { } } + /// `session.managedSettings.*` sub-namespace. + pub fn managed_settings(&self) -> SessionRpcManagedSettings<'a> { + SessionRpcManagedSettings { + session: self.session, + } + } + /// `session.mcp.*` sub-namespace. pub fn mcp(&self) -> SessionRpcMcp<'a> { SessionRpcMcp { @@ -3363,6 +3401,13 @@ impl<'a> SessionRpc<'a> { } } + /// `session.workflow.*` sub-namespace. + pub fn workflow(&self) -> SessionRpcWorkflow<'a> { + SessionRpcWorkflow { + session: self.session, + } + } + /// `session.workspaces.*` sub-namespace. pub fn workspaces(&self) -> SessionRpcWorkspaces<'a> { SessionRpcWorkspaces { @@ -6104,6 +6149,39 @@ impl<'a> SessionRpcLsp<'a> { } } +/// `session.managedSettings.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcManagedSettings<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcManagedSettings<'a> { + /// Waits for the live session's in-flight managed-settings application, then returns the retained effective snapshot used by runtime enforcement and by `session.managed_settings_resolved`. It does not perform another account, device, or server resolution, and rejects when resolution has not produced a snapshot. + /// + /// Wire method: `session.managedSettings.get`. + /// + /// # Returns + /// + /// Enterprise managed-settings resolution: the effective managed settings the session applied and which channels contributed, so SDK clients can show users what is enterprise-managed. Fires whenever managed policy is (re)applied — at session start, on resume, and on account switch. This is an ephemeral live snapshot (delivered to subscribers but not persisted to the session event log), because at session start it resolves before `session.start` is emitted. Device values take precedence over server values, then the policy helper, per ordinary key, while permissions compose restrictively across device, server, policy-helper, and SDK-client layers. The account-scoped `getManagedSettings()` API does not include session-local client injection. Marked experimental while the managed-settings surface stabilizes. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn get(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_MANAGEDSETTINGS_GET, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } +} + /// `session.mcp.*` RPCs. #[derive(Clone, Copy)] pub struct SessionRpcMcp<'a> { @@ -8944,7 +9022,14 @@ pub struct SessionRpcPlugins<'a> { } impl<'a> SessionRpcPlugins<'a> { - /// Lists plugins installed for the session. + /// `session.plugins.marketplaces.*` sub-namespace. + pub fn marketplaces(&self) -> SessionRpcPluginsMarketplaces<'a> { + SessionRpcPluginsMarketplaces { + session: self.session, + } + } + + /// Lists globally installed, live, built-in, and enterprise-managed desired plugins using the live session's authoritative account, working directory, and retained managed policy. /// /// Wire method: `session.plugins.list`. /// @@ -8969,9 +9054,17 @@ impl<'a> SessionRpcPlugins<'a> { Ok(serde_json::from_value(_value)?) } - /// 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. + /// Installs a plugin using the live session's authoritative account, working directory, and retained managed policy. /// - /// Wire method: `session.plugins.reload`. + /// Wire method: `session.plugins.install`. + /// + /// # Parameters + /// + /// * `params` - Plugin source resolved relative to the session's authoritative working directory. + /// + /// # Returns + /// + /// Result of installing a plugin. /// ///
/// @@ -8980,23 +9073,27 @@ impl<'a> SessionRpcPlugins<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn reload(&self) -> Result<(), Error> { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn install( + &self, + params: SessionPluginsInstallRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_PLUGINS_RELOAD, Some(wire_params)) + .call(rpc_methods::SESSION_PLUGINS_INSTALL, Some(wire_params)) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } - /// 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. + /// Uninstalls a plugin when permitted by the live session's retained managed policy. /// - /// Wire method: `session.plugins.reload`. + /// Wire method: `session.plugins.uninstall`. /// /// # Parameters /// - /// * `params` - Optional flags controlling which side effects the reload performs. + /// * `params` - Name (or spec) of the plugin to uninstall. /// ///
/// @@ -9005,32 +9102,28 @@ impl<'a> SessionRpcPlugins<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn reload_with_params(&self, params: PluginsReloadRequest) -> Result<(), Error> { + pub async fn uninstall(&self, params: PluginsUninstallRequest) -> Result<(), Error> { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_PLUGINS_RELOAD, Some(wire_params)) + .call(rpc_methods::SESSION_PLUGINS_UNINSTALL, Some(wire_params)) .await?; Ok(()) } -} - -/// `session.provider.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcProvider<'a> { - pub(crate) session: &'a Session, -} -impl<'a> SessionRpcProvider<'a> { - /// Returns the provider endpoint and credentials the session is currently configured to talk to, so the caller can make inference calls directly against the same backend the session uses. + /// Updates an installed plugin using the live session's authoritative account, working directory, and retained managed policy. /// - /// Wire method: `session.provider.getEndpoint`. + /// Wire method: `session.plugins.update`. + /// + /// # Parameters + /// + /// * `params` - Name (or spec) of the plugin to update. /// /// # Returns /// - /// A snapshot of the provider endpoint the session is currently configured to talk to. + /// Result of updating a single plugin. /// ///
/// @@ -9039,27 +9132,24 @@ impl<'a> SessionRpcProvider<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_endpoint(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn update(&self, params: PluginsUpdateRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_PROVIDER_GETENDPOINT, Some(wire_params)) + .call(rpc_methods::SESSION_PLUGINS_UPDATE, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Returns the provider endpoint and credentials the session is currently configured to talk to, so the caller can make inference calls directly against the same backend the session uses. + /// Enables installed plugins when permitted by the live session's retained managed policy. /// - /// Wire method: `session.provider.getEndpoint`. + /// Wire method: `session.plugins.enable`. /// /// # Parameters /// - /// * `params` - Optional model identifier to scope the endpoint snapshot to. - /// - /// # Returns - /// - /// A snapshot of the provider endpoint the session is currently configured to talk to. + /// * `params` - Plugin names (or specs) to enable in the session's authoritative working directory. /// ///
/// @@ -9068,31 +9158,24 @@ impl<'a> SessionRpcProvider<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_endpoint_with_params( - &self, - params: ProviderGetEndpointRequest, - ) -> Result { + pub async fn enable(&self, params: SessionPluginsEnableRequest) -> Result<(), Error> { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_PROVIDER_GETENDPOINT, Some(wire_params)) + .call(rpc_methods::SESSION_PLUGINS_ENABLE, Some(wire_params)) .await?; - Ok(serde_json::from_value(_value)?) + Ok(()) } - /// Adds BYOK providers and/or models to the session's registry at runtime, extending the additive registry built from the session's `providers`/`models` options. Both fields are optional, so a call may add providers only, models only, or both. Within a single call providers are registered before models, so a model may reference a provider added in the same call; across calls a model may reference any provider already registered (from session creation or a prior add). A model whose referenced provider is not registered by the end of the call is rejected. Newly added models become selectable via `model.list` / `model.switchTo` and are inherited by sub-agents spawned afterwards. + /// Disables installed plugins when permitted by the live session's retained managed policy. /// - /// Wire method: `session.provider.add`. + /// Wire method: `session.plugins.disable`. /// /// # Parameters /// - /// * `params` - BYOK providers and/or models to add to the session's registry at runtime. Both fields are optional; provide providers, models, or both. - /// - /// # Returns - /// - /// The selectable model entries synthesized for the models added by this call. + /// * `params` - Plugin names (or specs) to disable in the session's authoritative working directory. /// ///
/// @@ -9101,32 +9184,20 @@ impl<'a> SessionRpcProvider<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn add(&self, params: ProviderAddRequest) -> Result { + pub async fn disable(&self, params: SessionPluginsDisableRequest) -> Result<(), Error> { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_PROVIDER_ADD, Some(wire_params)) + .call(rpc_methods::SESSION_PLUGINS_DISABLE, Some(wire_params)) .await?; - Ok(serde_json::from_value(_value)?) + Ok(()) } -} - -/// `session.queue.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcQueue<'a> { - pub(crate) session: &'a Session, -} -impl<'a> SessionRpcQueue<'a> { - /// Returns the local session's pending user-facing queued items and steering messages. - /// - /// Wire method: `session.queue.pendingItems`. - /// - /// # Returns + /// 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. /// - /// Snapshot of the session's pending queued items and immediate-steering messages. + /// Wire method: `session.plugins.reload`. /// ///
/// @@ -9135,23 +9206,23 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn pending_items(&self) -> Result { + pub async fn reload(&self) -> Result<(), Error> { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_PENDINGITEMS, Some(wire_params)) + .call(rpc_methods::SESSION_PLUGINS_RELOAD, Some(wire_params)) .await?; - Ok(serde_json::from_value(_value)?) + Ok(()) } - /// Returns the internal native queue snapshot for in-process session orchestration. + /// 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. /// - /// Wire method: `session.queue.snapshot`. + /// Wire method: `session.plugins.reload`. /// - /// # Returns + /// # Parameters /// - /// Internal snapshot of native queue state for local session orchestration. + /// * `params` - Optional flags controlling which side effects the reload performs. /// ///
/// @@ -9160,27 +9231,32 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn snapshot(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn reload_with_params(&self, params: PluginsReloadRequest) -> Result<(), Error> { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_SNAPSHOT, Some(wire_params)) + .call(rpc_methods::SESSION_PLUGINS_RELOAD, Some(wire_params)) .await?; - Ok(serde_json::from_value(_value)?) + Ok(()) } +} - /// Moves an addressable queued item to a public visible position. - /// - /// Wire method: `session.queue.moveItem`. - /// - /// # Parameters +/// `session.plugins.marketplaces.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcPluginsMarketplaces<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcPluginsMarketplaces<'a> { + /// Lists registered and enterprise-managed desired marketplaces using the live session's retained policy. /// - /// * `params` - Parameters for moving a queued item by stable id. + /// Wire method: `session.plugins.marketplaces.list`. /// /// # Returns /// - /// Result of moving a queued item. + /// All registered marketplaces, including built-in defaults. /// ///
/// @@ -9189,31 +9265,30 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn move_item( - &self, - params: QueueMoveItemRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub async fn list(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_MOVEITEM, Some(wire_params)) + .call( + rpc_methods::SESSION_PLUGINS_MARKETPLACES_LIST, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Inserts a new queued message at a public visible position. + /// Adds a marketplace when permitted by the live session's retained managed policy. /// - /// Wire method: `session.queue.insertAt`. + /// Wire method: `session.plugins.marketplaces.add`. /// /// # Parameters /// - /// * `params` - Parameters for inserting a queued message at a public visible position. + /// * `params` - Marketplace source and optional working directory for relative-path resolution. /// /// # Returns /// - /// Result of inserting a queued message. + /// Result of registering a new marketplace. /// ///
/// @@ -9222,31 +9297,34 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn insert_at( + pub async fn add( &self, - params: QueueInsertAtRequest, - ) -> Result { + params: PluginsMarketplacesAddRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_INSERTAT, Some(wire_params)) + .call( + rpc_methods::SESSION_PLUGINS_MARKETPLACES_ADD, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Removes an addressable queued item by its stable id. + /// Removes a marketplace when permitted by the live session's retained managed policy. /// - /// Wire method: `session.queue.removeAt`. + /// Wire method: `session.plugins.marketplaces.remove`. /// /// # Parameters /// - /// * `params` - Parameters for removing a queued item by stable id. + /// * `params` - Name of the marketplace to remove and an optional force flag. /// /// # Returns /// - /// Result of removing a queued item. + /// Outcome of the remove attempt, including dependent-plugin info when applicable. /// ///
/// @@ -9255,31 +9333,34 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn remove_at( + pub async fn remove( &self, - params: QueueRemoveAtRequest, - ) -> Result { + params: PluginsMarketplacesRemoveRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_REMOVEAT, Some(wire_params)) + .call( + rpc_methods::SESSION_PLUGINS_MARKETPLACES_REMOVE, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Updates the text of an addressable single-message queue item. + /// Browses a marketplace resolved through the live session's working directory and retained managed policy. /// - /// Wire method: `session.queue.updateText`. + /// Wire method: `session.plugins.marketplaces.browse`. /// /// # Parameters /// - /// * `params` - Parameters for editing a single queued message. + /// * `params` - Name of the marketplace whose plugin catalog to fetch. /// /// # Returns /// - /// Result of editing a queued message. + /// Plugins advertised by the marketplace. /// ///
/// @@ -9288,31 +9369,30 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn update_text( + pub async fn browse( &self, - params: QueueUpdateTextRequest, - ) -> Result { + params: PluginsMarketplacesBrowseRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_UPDATETEXT, Some(wire_params)) + .call( + rpc_methods::SESSION_PLUGINS_MARKETPLACES_BROWSE, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Duplicates an addressable queued item immediately after its source. - /// - /// Wire method: `session.queue.duplicateAt`. + /// Refreshes marketplaces resolved through the live session's working directory and retained managed policy. /// - /// # Parameters - /// - /// * `params` - Parameters for duplicating a queued item. + /// Wire method: `session.plugins.marketplaces.refresh`. /// /// # Returns /// - /// Result of duplicating a queued item. + /// Result of refreshing one or more marketplace catalogs. /// ///
/// @@ -9321,27 +9401,783 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn duplicate_at( - &self, - params: QueueDuplicateAtRequest, + pub async fn refresh(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_PLUGINS_MARKETPLACES_REFRESH, + Some(wire_params), + ) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Refreshes marketplaces resolved through the live session's working directory and retained managed policy. + /// + /// Wire method: `session.plugins.marketplaces.refresh`. + /// + /// # Parameters + /// + /// * `params` - Optional marketplace name; omit to refresh all. + /// + /// # Returns + /// + /// Result of refreshing one or more marketplace catalogs. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn refresh_with_params( + &self, + params: PluginsMarketplacesRefreshRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_PLUGINS_MARKETPLACES_REFRESH, + Some(wire_params), + ) + .await?; + Ok(serde_json::from_value(_value)?) + } +} + +/// `session.provider.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcProvider<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcProvider<'a> { + /// Returns the provider endpoint and credentials the session is currently configured to talk to, so the caller can make inference calls directly against the same backend the session uses. + /// + /// Wire method: `session.provider.getEndpoint`. + /// + /// # Returns + /// + /// A snapshot of the provider endpoint the session is currently configured to talk to. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn get_endpoint(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_PROVIDER_GETENDPOINT, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Returns the provider endpoint and credentials the session is currently configured to talk to, so the caller can make inference calls directly against the same backend the session uses. + /// + /// Wire method: `session.provider.getEndpoint`. + /// + /// # Parameters + /// + /// * `params` - Optional model identifier to scope the endpoint snapshot to. + /// + /// # Returns + /// + /// A snapshot of the provider endpoint the session is currently configured to talk to. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn get_endpoint_with_params( + &self, + params: ProviderGetEndpointRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_PROVIDER_GETENDPOINT, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Adds BYOK providers and/or models to the session's registry at runtime, extending the additive registry built from the session's `providers`/`models` options. Both fields are optional, so a call may add providers only, models only, or both. Within a single call providers are registered before models, so a model may reference a provider added in the same call; across calls a model may reference any provider already registered (from session creation or a prior add). A model whose referenced provider is not registered by the end of the call is rejected. Newly added models become selectable via `model.list` / `model.switchTo` and are inherited by sub-agents spawned afterwards. + /// + /// Wire method: `session.provider.add`. + /// + /// # Parameters + /// + /// * `params` - BYOK providers and/or models to add to the session's registry at runtime. Both fields are optional; provide providers, models, or both. + /// + /// # Returns + /// + /// The selectable model entries synthesized for the models added by this call. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn add(&self, params: ProviderAddRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_PROVIDER_ADD, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } +} + +/// `session.queue.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcQueue<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcQueue<'a> { + /// Returns the local session's pending user-facing queued items and steering messages. + /// + /// Wire method: `session.queue.pendingItems`. + /// + /// # Returns + /// + /// Snapshot of the session's pending queued items and immediate-steering messages. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn pending_items(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_PENDINGITEMS, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Returns the internal native queue snapshot for in-process session orchestration. + /// + /// Wire method: `session.queue.snapshot`. + /// + /// # Returns + /// + /// Internal snapshot of native queue state for local session orchestration. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn snapshot(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_SNAPSHOT, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Moves an addressable queued item to a public visible position. + /// + /// Wire method: `session.queue.moveItem`. + /// + /// # Parameters + /// + /// * `params` - Parameters for moving a queued item by stable id. + /// + /// # Returns + /// + /// Result of moving a queued item. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn move_item( + &self, + params: QueueMoveItemRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_MOVEITEM, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Inserts a new queued message at a public visible position. + /// + /// Wire method: `session.queue.insertAt`. + /// + /// # Parameters + /// + /// * `params` - Parameters for inserting a queued message at a public visible position. + /// + /// # Returns + /// + /// Result of inserting a queued message. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn insert_at( + &self, + params: QueueInsertAtRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_INSERTAT, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Removes an addressable queued item by its stable id. + /// + /// Wire method: `session.queue.removeAt`. + /// + /// # Parameters + /// + /// * `params` - Parameters for removing a queued item by stable id. + /// + /// # Returns + /// + /// Result of removing a queued item. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn remove_at( + &self, + params: QueueRemoveAtRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_REMOVEAT, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Updates the text of an addressable single-message queue item. + /// + /// Wire method: `session.queue.updateText`. + /// + /// # Parameters + /// + /// * `params` - Parameters for editing a single queued message. + /// + /// # Returns + /// + /// Result of editing a queued message. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn update_text( + &self, + params: QueueUpdateTextRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_UPDATETEXT, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Atomically withdraws an unchanged, unconsumed user message from the local queued or steering lane. A client retaining the original draft may restore it only when removed is true. Does not interrupt the running turn. + /// + /// Wire method: `session.queue.withdrawMessage`. + /// + /// # Parameters + /// + /// * `params` - Conditional withdrawal of a single user message, before the runtime claims it for delivery. + /// + /// # Returns + /// + /// Result of removing a queued item. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn withdraw_message( + &self, + params: QueueWithdrawMessageRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_QUEUE_WITHDRAWMESSAGE, + Some(wire_params), + ) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Atomically appends text and attachments to an unchanged, unconsumed local steering message. Returns updated=false if delivery or withdrawal already claimed the message. + /// + /// Wire method: `session.queue.appendSteering`. + /// + /// # Parameters + /// + /// * `params` - Append to one pending steering message without changing its identity or delivery position. + /// + /// # Returns + /// + /// Result of editing a queued message. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn append_steering( + &self, + params: QueueAppendSteeringRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_APPENDSTEERING, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Duplicates an addressable queued item immediately after its source. + /// + /// Wire method: `session.queue.duplicateAt`. + /// + /// # Parameters + /// + /// * `params` - Parameters for duplicating a queued item. + /// + /// # Returns + /// + /// Result of duplicating a queued item. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn duplicate_at( + &self, + params: QueueDuplicateAtRequest, ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_DUPLICATEAT, Some(wire_params)) + .call(rpc_methods::SESSION_QUEUE_DUPLICATEAT, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Acquires or releases the queued-lane drain pause. + /// + /// Wire method: `session.queue.setDrainPaused`. + /// + /// # Parameters + /// + /// * `params` - Parameters for acquiring or releasing the queued-lane drain pause. Acquisition is exclusive and non-idempotent: `paused: true` against an already-paused session fails with `queue_already_paused`. The pause is never released automatically — it is not tied to the caller's lifetime, so a client that exits without sending `paused: false` leaves the lane frozen. Release is unowned: `paused: false` clears the pause for any caller, including one that never acquired it. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn set_drain_paused(&self, params: QueueSetDrainPausedRequest) -> Result<(), Error> { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_SETDRAINPAUSED, Some(wire_params)) + .await?; + Ok(()) + } + + /// Moves an addressable queued message into the live turn's steering lane. + /// + /// Wire method: `session.queue.sendNow`. + /// + /// # Parameters + /// + /// * `params` - Parameters for steering a queued message into a live turn. + /// + /// # Returns + /// + /// Result of trying to steer a queued message into a live turn. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn send_now(&self, params: QueueSendNowRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_SENDNOW, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Reports whether the local session has native queued work pending. + /// + /// Wire method: `session.queue.hasPending`. + /// + /// # Returns + /// + /// Whether the native queue has pending work. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn has_pending(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_HASPENDING, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Begins a native deferred-idle drain when background work has quiesced. + /// + /// Wire method: `session.queue.beginDeferredIdleDrain`. + /// + /// # Parameters + /// + /// * `params` - Inputs for starting a deferred-idle drain. + /// + /// # Returns + /// + /// Whether a deferred-idle drain should run. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn begin_deferred_idle_drain( + &self, + params: QueueBeginDeferredIdleDrainRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_QUEUE_BEGINDEFERREDIDLEDRAIN, + Some(wire_params), + ) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Finishes a native deferred-idle drain and reports whether to drain queue work or emit idle. + /// + /// Wire method: `session.queue.finishDeferredIdleDrain`. + /// + /// # Parameters + /// + /// * `params` - Inputs for completing a deferred-idle drain. + /// + /// # Returns + /// + /// Action selected by the native deferred-idle drain. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn finish_deferred_idle_drain( + &self, + params: QueueFinishDeferredIdleDrainRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_QUEUE_FINISHDEFERREDIDLEDRAIN, + Some(wire_params), + ) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Marks session.idle as deferred by native background work state. + /// + /// Wire method: `session.queue.deferSessionIdle`. + /// + /// # Parameters + /// + /// * `params` - Inputs for marking session.idle deferred in native state. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn defer_session_idle( + &self, + params: QueueDeferSessionIdleRequest, + ) -> Result<(), Error> { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_QUEUE_DEFERSESSIONIDLE, + Some(wire_params), + ) + .await?; + Ok(()) + } + + /// Removes the most recently queued user-facing item (LIFO). + /// + /// Wire method: `session.queue.removeMostRecent`. + /// + /// # Returns + /// + /// Indicates whether a user-facing pending item was removed. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn remove_most_recent(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_QUEUE_REMOVEMOSTRECENT, + Some(wire_params), + ) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Clears all pending queued items on the local session. + /// + /// Wire method: `session.queue.clear`. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn clear(&self) -> Result<(), Error> { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_CLEAR, Some(wire_params)) + .await?; + Ok(()) + } + + /// Consumes queued native system notifications matching an internal filter. + /// + /// Wire method: `session.queue.consumeSystemNotifications`. + /// + /// # Parameters + /// + /// * `params` - Internal filter for consuming queued system notifications. + /// + /// # Returns + /// + /// Indicates whether a user-facing pending item was removed. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn consume_system_notifications( + &self, + params: QueueConsumeSystemNotificationsRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_QUEUE_CONSUMESYSTEMNOTIFICATIONS, + Some(wire_params), + ) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Enqueues the internal resume-pending wake item when orphan handling needs a follow-up turn. + /// + /// Wire method: `session.queue.enqueueResumePending`. + /// + /// # Returns + /// + /// Result of enqueueing the resume-pending wake item. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn enqueue_resume_pending( + &self, + ) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call( + rpc_methods::SESSION_QUEUE_ENQUEUERESUMEPENDING, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Acquires or releases the queued-lane drain pause. + /// Drains the native local-session work queue for in-process session orchestration. /// - /// Wire method: `session.queue.setDrainPaused`. + /// Wire method: `session.queue.process`. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn process(&self) -> Result<(), Error> { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_QUEUE_PROCESS, Some(wire_params)) + .await?; + Ok(()) + } +} + +/// `session.remote.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcRemote<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcRemote<'a> { + /// Enables remote session export or steering. + /// + /// Wire method: `session.remote.enable`. /// /// # Parameters /// - /// * `params` - Parameters for acquiring or releasing the queued-lane drain pause. Acquisition is exclusive and non-idempotent: `paused: true` against an already-paused session fails with `queue_already_paused`. The pause is never released automatically — it is not tied to the caller's lifetime, so a client that exits without sending `paused: false` leaves the lane frozen. Release is unowned: `paused: false` clears the pause for any caller, including one that never acquired it. + /// * `params` - Optional remote session mode ("off", "export", or "on"); defaults to enabling both export and remote steering. + /// + /// # Returns + /// + /// GitHub URL for the session and a flag indicating whether remote steering is enabled. /// ///
/// @@ -9350,28 +10186,49 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn set_drain_paused(&self, params: QueueSetDrainPausedRequest) -> Result<(), Error> { + pub async fn enable(&self, params: RemoteEnableRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_SETDRAINPAUSED, Some(wire_params)) + .call(rpc_methods::SESSION_REMOTE_ENABLE, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Disables remote session export and steering. + /// + /// Wire method: `session.remote.disable`. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn disable(&self) -> Result<(), Error> { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_REMOTE_DISABLE, Some(wire_params)) .await?; Ok(()) } - /// Moves an addressable queued message into the live turn's steering lane. + /// Persists a remote-steerability change emitted by the host as a session event. /// - /// Wire method: `session.queue.sendNow`. + /// Wire method: `session.remote.notifySteerableChanged`. /// /// # Parameters /// - /// * `params` - Parameters for steering a queued message into a live turn. + /// * `params` - New remote-steerability state to persist as a `session.remote_steerable_changed` event. /// /// # Returns /// - /// Result of trying to steer a queued message into a live turn. + /// Persist a steerability change as a `session.remote_steerable_changed` event. Used by the host (CLI / SDK consumer) when it has just finished enabling or disabling steering on a remote exporter that the runtime does not directly own. /// ///
/// @@ -9380,24 +10237,38 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn send_now(&self, params: QueueSendNowRequest) -> Result { + pub async fn notify_steerable_changed( + &self, + params: RemoteNotifySteerableChangedRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_SENDNOW, Some(wire_params)) + .call( + rpc_methods::SESSION_REMOTE_NOTIFYSTEERABLECHANGED, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } +} - /// Reports whether the local session has native queued work pending. +/// `session.sandbox.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcSandbox<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcSandbox<'a> { + /// Returns whether managed policy requires sandbox enforcement and whether an enforcement failure has permanently blocked the session. /// - /// Wire method: `session.queue.hasPending`. + /// Wire method: `session.sandbox.getEnforcementStatus`. /// /// # Returns /// - /// Whether the native queue has pending work. + /// Managed sandbox enforcement state for a session. /// ///
/// @@ -9406,27 +10277,30 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn has_pending(&self) -> Result { + pub async fn get_enforcement_status(&self) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_HASPENDING, Some(wire_params)) + .call( + rpc_methods::SESSION_SANDBOX_GETENFORCEMENTSTATUS, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Begins a native deferred-idle drain when background work has quiesced. + /// Disables sandboxing for the remainder of the current session and approves the referenced pending sandbox-bypass permission request. The request is rejected unless the exact request is still pending and the effective sandbox policy permits bypass. /// - /// Wire method: `session.queue.beginDeferredIdleDrain`. + /// Wire method: `session.sandbox.disableForSession`. /// /// # Parameters /// - /// * `params` - Inputs for starting a deferred-idle drain. + /// * `params` - Request to disable sandboxing for the current session while resolving an active sandbox-bypass permission prompt. /// /// # Returns /// - /// Whether a deferred-idle drain should run. + /// Result of attempting to disable sandboxing for the current session. /// ///
/// @@ -9435,34 +10309,84 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn begin_deferred_idle_drain( + pub async fn disable_for_session( &self, - params: QueueBeginDeferredIdleDrainRequest, - ) -> Result { + params: SandboxDisableForSessionRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_QUEUE_BEGINDEFERREDIDLEDRAIN, + rpc_methods::SESSION_SANDBOX_DISABLEFORSESSION, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } +} - /// Finishes a native deferred-idle drain and reports whether to drain queue work or emit idle. +/// `session.schedule.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcSchedule<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcSchedule<'a> { + /// Lists the session's currently active scheduled prompts. /// - /// Wire method: `session.queue.finishDeferredIdleDrain`. + /// Wire method: `session.schedule.list`. /// - /// # Parameters + /// # Returns /// - /// * `params` - Inputs for completing a deferred-idle drain. + /// Snapshot of the currently active recurring prompts for this session. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub async fn list(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_SCHEDULE_LIST, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Hydrates the native schedule registry from persisted session events. + /// + /// Wire method: `session.schedule.hydrate`. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn hydrate(&self) -> Result<(), Error> { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_SCHEDULE_HYDRATE, Some(wire_params)) + .await?; + Ok(()) + } + + /// Reports whether the session has an active self-paced scheduled prompt. + /// + /// Wire method: `session.schedule.hasSelfPaced`. /// /// # Returns /// - /// Action selected by the native deferred-idle drain. + /// Whether the session currently has an active self-paced schedule. /// ///
/// @@ -9471,30 +10395,60 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn finish_deferred_idle_drain( - &self, - params: QueueFinishDeferredIdleDrainRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub(crate) async fn has_self_paced(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() .call( - rpc_methods::SESSION_QUEUE_FINISHDEFERREDIDLEDRAIN, + rpc_methods::SESSION_SCHEDULE_HASSELFPACED, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Marks session.idle as deferred by native background work state. + /// Registers a relative-interval scheduled prompt. /// - /// Wire method: `session.queue.deferSessionIdle`. + /// Wire method: `session.schedule.add`. /// /// # Parameters /// - /// * `params` - Inputs for marking session.idle deferred in native state. + /// * `params` - Register a relative-interval scheduled prompt. + /// + /// # Returns + /// + /// Result of registering or re-arming a scheduled prompt. + /// + ///
+ /// + /// **Experimental.** This API is part of an experimental wire-protocol surface + /// and may change or be removed in future SDK or CLI releases. Pin both the + /// SDK and CLI versions if your code depends on it. + /// + ///
+ pub(crate) async fn add(&self, params: ScheduleAddRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + let _value = self + .session + .client() + .call(rpc_methods::SESSION_SCHEDULE_ADD, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Registers a recurring cron scheduled prompt. + /// + /// Wire method: `session.schedule.addCron`. + /// + /// # Parameters + /// + /// * `params` - Register a cron scheduled prompt. + /// + /// # Returns + /// + /// Result of registering or re-arming a scheduled prompt. /// ///
/// @@ -9503,30 +10457,31 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn defer_session_idle( + pub(crate) async fn add_cron( &self, - params: QueueDeferSessionIdleRequest, - ) -> Result<(), Error> { + params: ScheduleAddCronRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_QUEUE_DEFERSESSIONIDLE, - Some(wire_params), - ) + .call(rpc_methods::SESSION_SCHEDULE_ADDCRON, Some(wire_params)) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } - /// Removes the most recently queued user-facing item (LIFO). + /// Registers an absolute-time scheduled prompt. /// - /// Wire method: `session.queue.removeMostRecent`. + /// Wire method: `session.schedule.addAt`. + /// + /// # Parameters + /// + /// * `params` - Register an absolute-time scheduled prompt. /// /// # Returns /// - /// Indicates whether a user-facing pending item was removed. + /// Result of registering or re-arming a scheduled prompt. /// ///
/// @@ -9535,22 +10490,31 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn remove_most_recent(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub(crate) async fn add_at( + &self, + params: ScheduleAddAtRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_QUEUE_REMOVEMOSTRECENT, - Some(wire_params), - ) + .call(rpc_methods::SESSION_SCHEDULE_ADDAT, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Clears all pending queued items on the local session. + /// Registers a self-paced scheduled prompt. /// - /// Wire method: `session.queue.clear`. + /// Wire method: `session.schedule.addSelfPaced`. + /// + /// # Parameters + /// + /// * `params` - Register a self-paced scheduled prompt. + /// + /// # Returns + /// + /// Result of registering or re-arming a scheduled prompt. /// ///
/// @@ -9559,27 +10523,34 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn clear(&self) -> Result<(), Error> { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub(crate) async fn add_self_paced( + &self, + params: ScheduleAddSelfPacedRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_CLEAR, Some(wire_params)) + .call( + rpc_methods::SESSION_SCHEDULE_ADDSELFPACED, + Some(wire_params), + ) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } - /// Consumes queued native system notifications matching an internal filter. + /// Re-arms an active self-paced scheduled prompt. /// - /// Wire method: `session.queue.consumeSystemNotifications`. + /// Wire method: `session.schedule.rearmSelfPaced`. /// /// # Parameters /// - /// * `params` - Internal filter for consuming queued system notifications. + /// * `params` - Re-arm a self-paced scheduled prompt. /// /// # Returns /// - /// Indicates whether a user-facing pending item was removed. + /// Result of registering or re-arming a scheduled prompt. /// ///
/// @@ -9588,30 +10559,34 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn consume_system_notifications( + pub(crate) async fn rearm_self_paced( &self, - params: QueueConsumeSystemNotificationsRequest, - ) -> Result { + params: ScheduleRearmSelfPacedRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_QUEUE_CONSUMESYSTEMNOTIFICATIONS, + rpc_methods::SESSION_SCHEDULE_REARMSELFPACED, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Enqueues the internal resume-pending wake item when orphan handling needs a follow-up turn. + /// Removes a scheduled prompt by id. /// - /// Wire method: `session.queue.enqueueResumePending`. + /// Wire method: `session.schedule.stop`. + /// + /// # Parameters + /// + /// * `params` - Identifier of the scheduled prompt to remove. /// /// # Returns /// - /// Result of enqueueing the resume-pending wake item. + /// Remove a scheduled prompt by id. The result entry is omitted if the id was unknown. /// ///
/// @@ -9620,24 +10595,32 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn enqueue_resume_pending( - &self, - ) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn stop(&self, params: ScheduleStopRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_QUEUE_ENQUEUERESUMEPENDING, - Some(wire_params), - ) + .call(rpc_methods::SESSION_SCHEDULE_STOP, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } +} - /// Drains the native local-session work queue for in-process session orchestration. +/// `session.settings.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcSettings<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcSettings<'a> { + /// Returns a redacted snapshot of session runtime settings, with secrets and raw feature flags excluded. Internal: the runtime settings shape is a runtime-internal surface and is deliberately kept out of the public SDK, because consumers should not depend on the runtime's internal settings layout. It remains callable in-process and is expected to be reworked as the runtime internals are consolidated. /// - /// Wire method: `session.queue.process`. + /// Wire method: `session.settings.snapshot`. + /// + /// # Returns + /// + /// Redacted, serializable view of session runtime settings for SDK boundary consumers. Secrets and raw feature flags are intentionally excluded. /// ///
/// @@ -9646,35 +10629,27 @@ impl<'a> SessionRpcQueue<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn process(&self) -> Result<(), Error> { + pub(crate) async fn snapshot(&self) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_QUEUE_PROCESS, Some(wire_params)) + .call(rpc_methods::SESSION_SETTINGS_SNAPSHOT, Some(wire_params)) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } -} - -/// `session.remote.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcRemote<'a> { - pub(crate) session: &'a Session, -} -impl<'a> SessionRpcRemote<'a> { - /// Enables remote session export or steering. + /// Evaluates a named Rust-owned settings predicate without exposing raw feature flags. Internal: the raw feature-flag names and composition are runtime-internal, so this predicate-evaluation helper is kept out of the public SDK surface and is callable in-process only. /// - /// Wire method: `session.remote.enable`. + /// Wire method: `session.settings.evaluatePredicate`. /// /// # Parameters /// - /// * `params` - Optional remote session mode ("off", "export", or "on"); defaults to enabling both export and remote steering. + /// * `params` - Named Rust-owned settings predicate to evaluate for this session. /// /// # Returns /// - /// GitHub URL for the session and a flag indicating whether remote steering is enabled. + /// Result of evaluating a Rust-owned settings predicate. /// ///
/// @@ -9683,20 +10658,42 @@ impl<'a> SessionRpcRemote<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn enable(&self, params: RemoteEnableRequest) -> Result { + pub(crate) async fn evaluate_predicate( + &self, + params: SessionSettingsEvaluatePredicateRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_REMOTE_ENABLE, Some(wire_params)) + .call( + rpc_methods::SESSION_SETTINGS_EVALUATEPREDICATE, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } +} - /// Disables remote session export and steering. +/// `session.shell.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcShell<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcShell<'a> { + /// Starts a shell command and streams output through session notifications. The command runs as the leader of its own process group (POSIX) or in a dedicated job object (Windows), so a forced termination — via "shell.kill", the request timeout, or session disposal — signals that whole group/job rather than only the direct child. Two gaps are worth planning for: a command that exits on its own does not trigger that teardown, and on POSIX a descendant that moves itself into a new session or process group (for example via "setsid") leaves the signalled group, so either can leave a background process running. /// - /// Wire method: `session.remote.disable`. + /// Wire method: `session.shell.exec`. + /// + /// # Parameters + /// + /// * `params` - Shell command to run, with optional working directory and timeout in milliseconds. + /// + /// # Returns + /// + /// Identifier of the spawned process, used to correlate streamed output and exit notifications. /// ///
/// @@ -9705,27 +10702,28 @@ impl<'a> SessionRpcRemote<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn disable(&self) -> Result<(), Error> { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn exec(&self, params: ShellExecRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_REMOTE_DISABLE, Some(wire_params)) + .call(rpc_methods::SESSION_SHELL_EXEC, Some(wire_params)) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } - /// Persists a remote-steerability change emitted by the host as a session event. + /// Sends a signal to a shell process previously started via "shell.exec". The signal targets the command's whole process group (POSIX) or job object (Windows), so descendants still in that group are signalled too, not just the direct child. On POSIX a descendant that moved itself into a new session or process group (for example via "setsid") is no longer in the signalled group and survives. /// - /// Wire method: `session.remote.notifySteerableChanged`. + /// Wire method: `session.shell.kill`. /// /// # Parameters /// - /// * `params` - New remote-steerability state to persist as a `session.remote_steerable_changed` event. + /// * `params` - Identifier of a process previously returned by "shell.exec" and the signal to send. /// /// # Returns /// - /// Persist a steerability change as a `session.remote_steerable_changed` event. Used by the host (CLI / SDK consumer) when it has just finished enabling or disabling steering on a remote exporter that the runtime does not directly own. + /// Indicates whether the signal was delivered; false if the process was unknown or already exited. /// ///
/// @@ -9734,38 +10732,28 @@ impl<'a> SessionRpcRemote<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn notify_steerable_changed( - &self, - params: RemoteNotifySteerableChangedRequest, - ) -> Result { + pub async fn kill(&self, params: ShellKillRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_REMOTE_NOTIFYSTEERABLECHANGED, - Some(wire_params), - ) + .call(rpc_methods::SESSION_SHELL_KILL, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } -} - -/// `session.sandbox.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcSandbox<'a> { - pub(crate) session: &'a Session, -} -impl<'a> SessionRpcSandbox<'a> { - /// Returns whether managed policy requires sandbox enforcement and whether an enforcement failure has permanently blocked the session. + /// Executes a user-requested shell command through the session runtime. /// - /// Wire method: `session.sandbox.getEnforcementStatus`. + /// Wire method: `session.shell.executeUserRequested`. + /// + /// # Parameters + /// + /// * `params` - User-requested shell command and cancellation handle. /// /// # Returns /// - /// Managed sandbox enforcement state for a session. + /// Result of a user-requested shell command. /// ///
/// @@ -9774,30 +10762,34 @@ impl<'a> SessionRpcSandbox<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_enforcement_status(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn execute_user_requested( + &self, + params: ShellExecuteUserRequestedRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_SANDBOX_GETENFORCEMENTSTATUS, + rpc_methods::SESSION_SHELL_EXECUTEUSERREQUESTED, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Disables sandboxing for the remainder of the current session and approves the referenced pending sandbox-bypass permission request. The request is rejected unless the exact request is still pending and the effective sandbox policy permits bypass. + /// Cancels a user-requested shell command by request ID. /// - /// Wire method: `session.sandbox.disableForSession`. + /// Wire method: `session.shell.cancelUserRequested`. /// /// # Parameters /// - /// * `params` - Request to disable sandboxing for the current session while resolving an active sandbox-bypass permission prompt. + /// * `params` - User-requested shell execution cancellation handle. /// /// # Returns /// - /// Result of attempting to disable sandboxing for the current session. + /// Cancellation result for a user-requested shell command. /// ///
/// @@ -9806,17 +10798,17 @@ impl<'a> SessionRpcSandbox<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn disable_for_session( + pub async fn cancel_user_requested( &self, - params: SandboxDisableForSessionRequest, - ) -> Result { + params: ShellCancelUserRequestedRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_SANDBOX_DISABLEFORSESSION, + rpc_methods::SESSION_SHELL_CANCELUSERREQUESTED, Some(wire_params), ) .await?; @@ -9824,20 +10816,20 @@ impl<'a> SessionRpcSandbox<'a> { } } -/// `session.schedule.*` RPCs. +/// `session.skills.*` RPCs. #[derive(Clone, Copy)] -pub struct SessionRpcSchedule<'a> { +pub struct SessionRpcSkills<'a> { pub(crate) session: &'a Session, } -impl<'a> SessionRpcSchedule<'a> { - /// Lists the session's currently active scheduled prompts. +impl<'a> SessionRpcSkills<'a> { + /// Lists skills available to the session. /// - /// Wire method: `session.schedule.list`. + /// Wire method: `session.skills.list`. /// /// # Returns /// - /// Snapshot of the currently active recurring prompts for this session. + /// Skills available to the session, with their enabled state. /// ///
/// @@ -9846,19 +10838,23 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn list(&self) -> Result { + pub async fn list(&self) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_SCHEDULE_LIST, Some(wire_params)) + .call(rpc_methods::SESSION_SKILLS_LIST, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Hydrates the native schedule registry from persisted session events. + /// Returns the skills that have been invoked during this session. /// - /// Wire method: `session.schedule.hydrate`. + /// Wire method: `session.skills.getInvoked`. + /// + /// # Returns + /// + /// Skills invoked during this session, ordered by invocation time (most recent last). /// ///
/// @@ -9867,23 +10863,23 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn hydrate(&self) -> Result<(), Error> { + pub async fn get_invoked(&self) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_SCHEDULE_HYDRATE, Some(wire_params)) + .call(rpc_methods::SESSION_SKILLS_GETINVOKED, Some(wire_params)) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } - /// Reports whether the session has an active self-paced scheduled prompt. + /// Enables a skill for the session. /// - /// Wire method: `session.schedule.hasSelfPaced`. + /// Wire method: `session.skills.enable`. /// - /// # Returns + /// # Parameters /// - /// Whether the session currently has an active self-paced schedule. + /// * `params` - Name of the skill to enable for the session. /// ///
/// @@ -9892,30 +10888,24 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn has_self_paced(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn enable(&self, params: SkillsEnableRequest) -> Result<(), Error> { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_SCHEDULE_HASSELFPACED, - Some(wire_params), - ) + .call(rpc_methods::SESSION_SKILLS_ENABLE, Some(wire_params)) .await?; - Ok(serde_json::from_value(_value)?) + Ok(()) } - /// Registers a relative-interval scheduled prompt. + /// Disables a skill for the session. /// - /// Wire method: `session.schedule.add`. + /// Wire method: `session.skills.disable`. /// /// # Parameters /// - /// * `params` - Register a relative-interval scheduled prompt. - /// - /// # Returns - /// - /// Result of registering or re-arming a scheduled prompt. + /// * `params` - Name of the skill to disable for the session. /// ///
/// @@ -9924,28 +10914,24 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn add(&self, params: ScheduleAddRequest) -> Result { + pub async fn disable(&self, params: SkillsDisableRequest) -> Result<(), Error> { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_SCHEDULE_ADD, Some(wire_params)) + .call(rpc_methods::SESSION_SKILLS_DISABLE, Some(wire_params)) .await?; - Ok(serde_json::from_value(_value)?) + Ok(()) } - /// Registers a recurring cron scheduled prompt. - /// - /// Wire method: `session.schedule.addCron`. - /// - /// # Parameters + /// Reloads skill definitions for the session. /// - /// * `params` - Register a cron scheduled prompt. + /// Wire method: `session.skills.reload`. /// /// # Returns /// - /// Result of registering or re-arming a scheduled prompt. + /// Diagnostics from reloading skill definitions, with warnings and errors as separate lists. /// ///
/// @@ -9954,31 +10940,19 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn add_cron( - &self, - params: ScheduleAddCronRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub async fn reload(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_SCHEDULE_ADDCRON, Some(wire_params)) + .call(rpc_methods::SESSION_SKILLS_RELOAD, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Registers an absolute-time scheduled prompt. - /// - /// Wire method: `session.schedule.addAt`. - /// - /// # Parameters - /// - /// * `params` - Register an absolute-time scheduled prompt. - /// - /// # Returns + /// Ensures the session's skill definitions have been loaded from disk. /// - /// Result of registering or re-arming a scheduled prompt. + /// Wire method: `session.skills.ensureLoaded`. /// ///
/// @@ -9987,31 +10961,35 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn add_at( - &self, - params: ScheduleAddAtRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub async fn ensure_loaded(&self) -> Result<(), Error> { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_SCHEDULE_ADDAT, Some(wire_params)) + .call(rpc_methods::SESSION_SKILLS_ENSURELOADED, Some(wire_params)) .await?; - Ok(serde_json::from_value(_value)?) + Ok(()) } +} - /// Registers a self-paced scheduled prompt. +/// `session.tasks.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcTasks<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcTasks<'a> { + /// Starts a background agent task in the session. /// - /// Wire method: `session.schedule.addSelfPaced`. + /// Wire method: `session.tasks.startAgent`. /// /// # Parameters /// - /// * `params` - Register a self-paced scheduled prompt. + /// * `params` - Agent type, prompt, name, and optional description and model override for the new task. /// /// # Returns /// - /// Result of registering or re-arming a scheduled prompt. + /// Identifier assigned to the newly started background agent task. /// ///
/// @@ -10020,34 +10998,27 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn add_self_paced( + pub async fn start_agent( &self, - params: ScheduleAddSelfPacedRequest, - ) -> Result { + params: TasksStartAgentRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_SCHEDULE_ADDSELFPACED, - Some(wire_params), - ) + .call(rpc_methods::SESSION_TASKS_STARTAGENT, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Re-arms an active self-paced scheduled prompt. - /// - /// Wire method: `session.schedule.rearmSelfPaced`. - /// - /// # Parameters + /// Lists background tasks tracked by the session. /// - /// * `params` - Re-arm a self-paced scheduled prompt. + /// Wire method: `session.tasks.list`. /// /// # Returns /// - /// Result of registering or re-arming a scheduled prompt. + /// Background tasks currently tracked by the session. /// ///
/// @@ -10056,34 +11027,27 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn rearm_self_paced( - &self, - params: ScheduleRearmSelfPacedRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub async fn list(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call( - rpc_methods::SESSION_SCHEDULE_REARMSELFPACED, - Some(wire_params), - ) + .call(rpc_methods::SESSION_TASKS_LIST, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Removes a scheduled prompt by id. + /// Registers a client-owned task, or reclaims an orphaned task belonging to the same extension principal. /// - /// Wire method: `session.schedule.stop`. + /// Wire method: `session.tasks.register`. /// /// # Parameters /// - /// * `params` - Identifier of the scheduled prompt to remove. + /// * `params` - Registers or reclaims a client-owned task. /// /// # Returns /// - /// Remove a scheduled prompt by id. The result entry is omitted if the id was unknown. + /// Result of registering or reclaiming a client-owned task. /// ///
/// @@ -10092,32 +11056,31 @@ impl<'a> SessionRpcSchedule<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn stop(&self, params: ScheduleStopRequest) -> Result { + pub async fn register( + &self, + params: TasksRegisterRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_SCHEDULE_STOP, Some(wire_params)) + .call(rpc_methods::SESSION_TASKS_REGISTER, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } -} -/// `session.settings.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcSettings<'a> { - pub(crate) session: &'a Session, -} - -impl<'a> SessionRpcSettings<'a> { - /// Returns a redacted snapshot of session runtime settings, with secrets and raw feature flags excluded. Internal: the runtime settings shape is a runtime-internal surface and is deliberately kept out of the public SDK, because consumers should not depend on the runtime's internal settings layout. It remains callable in-process and is expected to be reworked as the runtime internals are consolidated. + /// Publishes generic progress or a terminal outcome for a client-owned task. /// - /// Wire method: `session.settings.snapshot`. + /// Wire method: `session.tasks.update`. + /// + /// # Parameters + /// + /// * `params` - Updates a client-owned task. /// /// # Returns /// - /// Redacted, serializable view of session runtime settings for SDK boundary consumers. Secrets and raw feature flags are intentionally excluded. + /// Result of publishing a client-owned task update. /// ///
/// @@ -10126,27 +11089,24 @@ impl<'a> SessionRpcSettings<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn snapshot(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn update(&self, params: TasksUpdateRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_SETTINGS_SNAPSHOT, Some(wire_params)) + .call(rpc_methods::SESSION_TASKS_UPDATE, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Evaluates a named Rust-owned settings predicate without exposing raw feature flags. Internal: the raw feature-flag names and composition are runtime-internal, so this predicate-evaluation helper is kept out of the public SDK surface and is callable in-process only. - /// - /// Wire method: `session.settings.evaluatePredicate`. - /// - /// # Parameters + /// Refreshes metadata for any detached background shells the runtime knows about. /// - /// * `params` - Named Rust-owned settings predicate to evaluate for this session. + /// Wire method: `session.tasks.refresh`. /// /// # Returns /// - /// Result of evaluating a Rust-owned settings predicate. + /// Refresh metadata for any detached background shells the runtime knows about. Use after a long pause to pick up exit/output state for shells running outside the agent loop. /// ///
/// @@ -10155,42 +11115,23 @@ impl<'a> SessionRpcSettings<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub(crate) async fn evaluate_predicate( - &self, - params: SessionSettingsEvaluatePredicateRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub async fn refresh(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call( - rpc_methods::SESSION_SETTINGS_EVALUATEPREDICATE, - Some(wire_params), - ) + .call(rpc_methods::SESSION_TASKS_REFRESH, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } -} -/// `session.shell.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcShell<'a> { - pub(crate) session: &'a Session, -} - -impl<'a> SessionRpcShell<'a> { - /// Starts a shell command and streams output through session notifications. The command runs as the leader of its own process group (POSIX) or in a dedicated job object (Windows), so a forced termination — via "shell.kill", the request timeout, or session disposal — signals that whole group/job rather than only the direct child. Two gaps are worth planning for: a command that exits on its own does not trigger that teardown, and on POSIX a descendant that moves itself into a new session or process group (for example via "setsid") leaves the signalled group, so either can leave a background process running. - /// - /// Wire method: `session.shell.exec`. - /// - /// # Parameters + /// Waits for all in-flight background tasks and any follow-up turns to settle. /// - /// * `params` - Shell command to run, with optional working directory and timeout in milliseconds. + /// Wire method: `session.tasks.waitForPending`. /// /// # Returns /// - /// Identifier of the spawned process, used to correlate streamed output and exit notifications. + /// Wait until all in-flight background tasks (agents + shells) and any follow-up turns scheduled by their completions have settled. Returns when the runtime is fully drained or after an internal timeout (default 10 minutes; configurable via COPILOT_TASK_WAIT_TIMEOUT_SECONDS). /// ///
/// @@ -10199,28 +11140,27 @@ impl<'a> SessionRpcShell<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn exec(&self, params: ShellExecRequest) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub async fn wait_for_pending(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_SHELL_EXEC, Some(wire_params)) + .call(rpc_methods::SESSION_TASKS_WAITFORPENDING, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Sends a signal to a shell process previously started via "shell.exec". The signal targets the command's whole process group (POSIX) or job object (Windows), so descendants still in that group are signalled too, not just the direct child. On POSIX a descendant that moved itself into a new session or process group (for example via "setsid") is no longer in the signalled group and survives. + /// Returns progress information for a background task by ID. /// - /// Wire method: `session.shell.kill`. + /// Wire method: `session.tasks.getProgress`. /// /// # Parameters /// - /// * `params` - Identifier of a process previously returned by "shell.exec" and the signal to send. + /// * `params` - Identifier of the background task to fetch progress for. /// /// # Returns /// - /// Indicates whether the signal was delivered; false if the process was unknown or already exited. + /// Progress information for the task, or null when no task with that ID is tracked. /// ///
/// @@ -10229,28 +11169,27 @@ impl<'a> SessionRpcShell<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn kill(&self, params: ShellKillRequest) -> Result { + pub async fn get_progress( + &self, + params: TasksGetProgressRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_SHELL_KILL, Some(wire_params)) - .await?; - Ok(serde_json::from_value(_value)?) - } - - /// Executes a user-requested shell command through the session runtime. - /// - /// Wire method: `session.shell.executeUserRequested`. - /// - /// # Parameters + .call(rpc_methods::SESSION_TASKS_GETPROGRESS, Some(wire_params)) + .await?; + Ok(serde_json::from_value(_value)?) + } + + /// Returns the first sync-waiting task that can currently be promoted to background mode. /// - /// * `params` - User-requested shell command and cancellation handle. + /// Wire method: `session.tasks.getCurrentPromotable`. /// /// # Returns /// - /// Result of a user-requested shell command. + /// The first sync-waiting task that can currently be promoted to background mode. /// ///
/// @@ -10259,34 +11198,30 @@ impl<'a> SessionRpcShell<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn execute_user_requested( - &self, - params: ShellExecuteUserRequestedRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub async fn get_current_promotable(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() .call( - rpc_methods::SESSION_SHELL_EXECUTEUSERREQUESTED, + rpc_methods::SESSION_TASKS_GETCURRENTPROMOTABLE, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Cancels a user-requested shell command by request ID. + /// Promotes an eligible synchronously-waited task so it continues running in the background. /// - /// Wire method: `session.shell.cancelUserRequested`. + /// Wire method: `session.tasks.promoteToBackground`. /// /// # Parameters /// - /// * `params` - User-requested shell execution cancellation handle. + /// * `params` - Identifier of the task to promote to background mode. /// /// # Returns /// - /// Cancellation result for a user-requested shell command. + /// Indicates whether the task was successfully promoted to background mode. /// ///
/// @@ -10295,38 +11230,30 @@ impl<'a> SessionRpcShell<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn cancel_user_requested( + pub async fn promote_to_background( &self, - params: ShellCancelUserRequestedRequest, - ) -> Result { + params: TasksPromoteToBackgroundRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_SHELL_CANCELUSERREQUESTED, + rpc_methods::SESSION_TASKS_PROMOTETOBACKGROUND, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } -} - -/// `session.skills.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcSkills<'a> { - pub(crate) session: &'a Session, -} -impl<'a> SessionRpcSkills<'a> { - /// Lists skills available to the session. + /// Atomically promotes the first promotable sync-waiting task to background mode and returns it. /// - /// Wire method: `session.skills.list`. + /// Wire method: `session.tasks.promoteCurrentToBackground`. /// /// # Returns /// - /// Skills available to the session, with their enabled state. + /// The promoted task as it now exists in background mode, omitted if no promotable task was waiting. /// ///
/// @@ -10335,23 +11262,32 @@ impl<'a> SessionRpcSkills<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn list(&self) -> Result { + pub async fn promote_current_to_background( + &self, + ) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_SKILLS_LIST, Some(wire_params)) + .call( + rpc_methods::SESSION_TASKS_PROMOTECURRENTTOBACKGROUND, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Returns the skills that have been invoked during this session. + /// Cancels a background task. /// - /// Wire method: `session.skills.getInvoked`. + /// Wire method: `session.tasks.cancel`. + /// + /// # Parameters + /// + /// * `params` - Identifier of the background task to cancel. /// /// # Returns /// - /// Skills invoked during this session, ordered by invocation time (most recent last). + /// Indicates whether the background task was successfully cancelled. /// ///
/// @@ -10360,23 +11296,28 @@ impl<'a> SessionRpcSkills<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_invoked(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn cancel(&self, params: TasksCancelRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_SKILLS_GETINVOKED, Some(wire_params)) + .call(rpc_methods::SESSION_TASKS_CANCEL, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Enables a skill for the session. + /// Removes a completed or cancelled background task from tracking. /// - /// Wire method: `session.skills.enable`. + /// Wire method: `session.tasks.remove`. /// /// # Parameters /// - /// * `params` - Name of the skill to enable for the session. + /// * `params` - Identifier of the completed or cancelled task to remove from tracking. + /// + /// # Returns + /// + /// Indicates whether the task was removed. False when the task does not exist or is still running/idle. /// ///
/// @@ -10385,24 +11326,28 @@ impl<'a> SessionRpcSkills<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn enable(&self, params: SkillsEnableRequest) -> Result<(), Error> { + pub async fn remove(&self, params: TasksRemoveRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_SKILLS_ENABLE, Some(wire_params)) + .call(rpc_methods::SESSION_TASKS_REMOVE, Some(wire_params)) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } - /// Disables a skill for the session. + /// Sends a message to a background agent task. /// - /// Wire method: `session.skills.disable`. + /// Wire method: `session.tasks.sendMessage`. /// /// # Parameters /// - /// * `params` - Name of the skill to disable for the session. + /// * `params` - Identifier of the target agent task, message content, and optional sender agent ID. + /// + /// # Returns + /// + /// Indicates whether the message was delivered, with an error message when delivery failed. /// ///
/// @@ -10411,24 +11356,35 @@ impl<'a> SessionRpcSkills<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn disable(&self, params: SkillsDisableRequest) -> Result<(), Error> { + pub async fn send_message( + &self, + params: TasksSendMessageRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_SKILLS_DISABLE, Some(wire_params)) + .call(rpc_methods::SESSION_TASKS_SENDMESSAGE, Some(wire_params)) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } +} - /// Reloads skill definitions for the session. +/// `session.telemetry.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcTelemetry<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcTelemetry<'a> { + /// Gets the telemetry engagement ID currently associated with the session, when available. /// - /// Wire method: `session.skills.reload`. + /// Wire method: `session.telemetry.getEngagementId`. /// /// # Returns /// - /// Diagnostics from reloading skill definitions, with warnings and errors as separate lists. + /// Telemetry engagement ID for the session, when available. /// ///
/// @@ -10437,19 +11393,26 @@ impl<'a> SessionRpcSkills<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn reload(&self) -> Result { + pub async fn get_engagement_id(&self) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_SKILLS_RELOAD, Some(wire_params)) + .call( + rpc_methods::SESSION_TELEMETRY_GETENGAGEMENTID, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Ensures the session's skill definitions have been loaded from disk. + /// Sets feature override key/value pairs to attach to subsequent telemetry events for the session. /// - /// Wire method: `session.skills.ensureLoaded`. + /// Wire method: `session.telemetry.setFeatureOverrides`. + /// + /// # Parameters + /// + /// * `params` - Feature override key/value pairs to attach to subsequent telemetry events from this session. /// ///
/// @@ -10458,35 +11421,42 @@ impl<'a> SessionRpcSkills<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn ensure_loaded(&self) -> Result<(), Error> { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn set_feature_overrides( + &self, + params: TelemetrySetFeatureOverridesRequest, + ) -> Result<(), Error> { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_SKILLS_ENSURELOADED, Some(wire_params)) + .call( + rpc_methods::SESSION_TELEMETRY_SETFEATUREOVERRIDES, + Some(wire_params), + ) .await?; Ok(()) } } -/// `session.tasks.*` RPCs. +/// `session.tools.*` RPCs. #[derive(Clone, Copy)] -pub struct SessionRpcTasks<'a> { +pub struct SessionRpcTools<'a> { pub(crate) session: &'a Session, } -impl<'a> SessionRpcTasks<'a> { - /// Starts a background agent task in the session. +impl<'a> SessionRpcTools<'a> { + /// Executes one tool from the session's currently offered tool set through the native invocation pipeline. /// - /// Wire method: `session.tasks.startAgent`. + /// Wire method: `session.tools.execute`. /// /// # Parameters /// - /// * `params` - Agent type, prompt, name, and optional description and model override for the new task. + /// * `params` - A tool name and arguments to execute through the session's native invocation pipeline. /// /// # Returns /// - /// Identifier assigned to the newly started background agent task. + /// Canonical result returned by a session tool. /// ///
/// @@ -10495,27 +11465,28 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn start_agent( - &self, - params: TasksStartAgentRequest, - ) -> Result { + pub async fn execute(&self, params: ToolsExecuteRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_STARTAGENT, Some(wire_params)) + .call(rpc_methods::SESSION_TOOLS_EXECUTE, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Lists background tasks tracked by the session. + /// Returns the Rust-owned built-in tool descriptors used to construct the session's offered tool set. /// - /// Wire method: `session.tasks.list`. + /// Wire method: `session.tools.getBuiltinDescriptors`. + /// + /// # Parameters + /// + /// * `params` - Options controlling how Rust-owned built-in tool descriptors are materialized. /// /// # Returns /// - /// Background tasks currently tracked by the session. + /// Rust-owned built-in tool descriptors for the session. /// ///
/// @@ -10524,27 +11495,34 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn list(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn get_builtin_descriptors( + &self, + params: ToolsGetBuiltinDescriptorsRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_LIST, Some(wire_params)) + .call( + rpc_methods::SESSION_TOOLS_GETBUILTINDESCRIPTORS, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Registers a client-owned task, or reclaims an orphaned task belonging to the same extension principal. + /// Projects a completed task_complete tool call into its label-safe session event payload. /// - /// Wire method: `session.tasks.register`. + /// Wire method: `session.tools.taskCompleteEventData`. /// /// # Parameters /// - /// * `params` - Registers or reclaims a client-owned task. + /// * `params` - Task-completion tool arguments and final result used to build a label-safe session event payload. /// /// # Returns /// - /// Result of registering or reclaiming a client-owned task. + /// Task completion notification with summary from the agent /// ///
/// @@ -10553,31 +11531,34 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn register( + pub async fn task_complete_event_data( &self, - params: TasksRegisterRequest, - ) -> Result { + params: ToolsTaskCompleteEventDataRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_REGISTER, Some(wire_params)) + .call( + rpc_methods::SESSION_TOOLS_TASKCOMPLETEEVENTDATA, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Publishes generic progress or a terminal outcome for a client-owned task. + /// Provides the result for a pending external tool call. /// - /// Wire method: `session.tasks.update`. + /// Wire method: `session.tools.handlePendingToolCall`. /// /// # Parameters /// - /// * `params` - Updates a client-owned task. + /// * `params` - Pending external tool call request ID, with the tool result or an error describing why it failed. /// /// # Returns /// - /// Result of publishing a client-owned task update. + /// Indicates whether the external tool call result was handled successfully. /// ///
/// @@ -10586,24 +11567,30 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn update(&self, params: TasksUpdateRequest) -> Result { + pub async fn handle_pending_tool_call( + &self, + params: HandlePendingToolCallRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_UPDATE, Some(wire_params)) + .call( + rpc_methods::SESSION_TOOLS_HANDLEPENDINGTOOLCALL, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Refreshes metadata for any detached background shells the runtime knows about. + /// Resolves, builds, and validates the runtime tool list for the session. /// - /// Wire method: `session.tasks.refresh`. + /// Wire method: `session.tools.initializeAndValidate`. /// /// # Returns /// - /// Refresh metadata for any detached background shells the runtime knows about. Use after a long pause to pick up exit/output state for shells running outside the agent loop. + /// Resolve, build, and validate the runtime tool list for this session. Subagent sessions and consumer flows that need an initialized tool set before `send` invoke this. Default base-class implementation is a no-op for sessions that don't support tool validation. /// ///
/// @@ -10612,23 +11599,26 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn refresh(&self) -> Result { + pub async fn initialize_and_validate(&self) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_REFRESH, Some(wire_params)) + .call( + rpc_methods::SESSION_TOOLS_INITIALIZEANDVALIDATE, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Waits for all in-flight background tasks and any follow-up turns to settle. + /// Returns lightweight metadata for the session's currently initialized tools. /// - /// Wire method: `session.tasks.waitForPending`. + /// Wire method: `session.tools.getCurrentMetadata`. /// /// # Returns /// - /// Wait until all in-flight background tasks (agents + shells) and any follow-up turns scheduled by their completions have settled. Returns when the runtime is fully drained or after an internal timeout (default 10 minutes; configurable via COPILOT_TASK_WAIT_TIMEOUT_SECONDS). + /// Current lightweight tool metadata snapshot for the session. /// ///
/// @@ -10637,27 +11627,30 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn wait_for_pending(&self) -> Result { + pub async fn get_current_metadata(&self) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_WAITFORPENDING, Some(wire_params)) + .call( + rpc_methods::SESSION_TOOLS_GETCURRENTMETADATA, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Returns progress information for a background task by ID. + /// Atomically replaces the complete externally implemented tool list supplied by the calling connection. Built-in, MCP/plugin, extension-discovered, subagent, and tools supplied by other connections remain unchanged. /// - /// Wire method: `session.tasks.getProgress`. + /// Wire method: `session.tools.set`. /// /// # Parameters /// - /// * `params` - Identifier of the background task to fetch progress for. + /// * `params` - Complete externally implemented tool list for the calling connection. An empty list removes every tool previously supplied by that connection. /// /// # Returns /// - /// Progress information for the task, or null when no task with that ID is tracked. + /// Empty result after replacing the calling connection's externally implemented tools. /// ///
/// @@ -10666,27 +11659,28 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_progress( - &self, - params: TasksGetProgressRequest, - ) -> Result { + pub async fn set(&self, params: ToolsSetRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_GETPROGRESS, Some(wire_params)) + .call(rpc_methods::SESSION_TOOLS_SET, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Returns the first sync-waiting task that can currently be promoted to background mode. + /// Sets the current session's live subagent settings override, which takes precedence over persisted user settings until cleared. Persisted user settings remain the source of truth for future sessions. /// - /// Wire method: `session.tasks.getCurrentPromotable`. + /// Wire method: `session.tools.updateSubagentSettings`. + /// + /// # Parameters + /// + /// * `params` - Subagent settings to apply to the current session /// /// # Returns /// - /// The first sync-waiting task that can currently be promoted to background mode. + /// Empty result after applying subagent settings /// ///
/// @@ -10695,30 +11689,42 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_current_promotable(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn update_subagent_settings( + &self, + params: UpdateSubagentSettingsRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_TASKS_GETCURRENTPROMOTABLE, + rpc_methods::SESSION_TOOLS_UPDATESUBAGENTSETTINGS, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } +} - /// Promotes an eligible synchronously-waited task so it continues running in the background. +/// `session.ui.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcUi<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcUi<'a> { + /// Runs a transient no-tools model query against the current conversation context. /// - /// Wire method: `session.tasks.promoteToBackground`. + /// Wire method: `session.ui.ephemeralQuery`. /// /// # Parameters /// - /// * `params` - Identifier of the task to promote to background mode. + /// * `params` - Transient question to answer without adding it to conversation history. /// /// # Returns /// - /// Indicates whether the task was successfully promoted to background mode. + /// Completed transient query. Ordered chunks and the terminal outcome are also delivered through `ui.ephemeral_query` session events while it runs. /// ///
/// @@ -10727,30 +11733,31 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn promote_to_background( + pub async fn ephemeral_query( &self, - params: TasksPromoteToBackgroundRequest, - ) -> Result { + params: UIEphemeralQueryRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_TASKS_PROMOTETOBACKGROUND, - Some(wire_params), - ) + .call(rpc_methods::SESSION_UI_EPHEMERALQUERY, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Atomically promotes the first promotable sync-waiting task to background mode and returns it. + /// Requests structured input from a UI-capable client. /// - /// Wire method: `session.tasks.promoteCurrentToBackground`. + /// Wire method: `session.ui.elicitation`. + /// + /// # Parameters + /// + /// * `params` - Prompt message and JSON schema describing the form fields to elicit from the user. /// /// # Returns /// - /// The promoted task as it now exists in background mode, omitted if no promotable task was waiting. + /// The elicitation response (accept with form values, decline, or cancel) /// ///
/// @@ -10759,32 +11766,31 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn promote_current_to_background( + pub async fn elicitation( &self, - ) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + params: UIElicitationRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_TASKS_PROMOTECURRENTTOBACKGROUND, - Some(wire_params), - ) + .call(rpc_methods::SESSION_UI_ELICITATION, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Cancels a background task. + /// Provides the user response for a pending elicitation request. /// - /// Wire method: `session.tasks.cancel`. + /// Wire method: `session.ui.handlePendingElicitation`. /// /// # Parameters /// - /// * `params` - Identifier of the background task to cancel. + /// * `params` - Pending elicitation request ID and the user's response (accept/decline/cancel + form values). /// /// # Returns /// - /// Indicates whether the background task was successfully cancelled. + /// Indicates whether the elicitation response was accepted; false if it was already resolved by another client. /// ///
/// @@ -10793,28 +11799,34 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn cancel(&self, params: TasksCancelRequest) -> Result { + pub async fn handle_pending_elicitation( + &self, + params: UIHandlePendingElicitationRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_CANCEL, Some(wire_params)) + .call( + rpc_methods::SESSION_UI_HANDLEPENDINGELICITATION, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Removes a completed or cancelled background task from tracking. + /// Resolves a pending `user_input.requested` event with the user's response. /// - /// Wire method: `session.tasks.remove`. + /// Wire method: `session.ui.handlePendingUserInput`. /// /// # Parameters /// - /// * `params` - Identifier of the completed or cancelled task to remove from tracking. + /// * `params` - Request ID of a pending `user_input.requested` event and the user's response. /// /// # Returns /// - /// Indicates whether the task was removed. False when the task does not exist or is still running/idle. + /// Indicates whether the pending UI request was resolved by this call. /// ///
/// @@ -10823,28 +11835,34 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn remove(&self, params: TasksRemoveRequest) -> Result { + pub async fn handle_pending_user_input( + &self, + params: UIHandlePendingUserInputRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_REMOVE, Some(wire_params)) + .call( + rpc_methods::SESSION_UI_HANDLEPENDINGUSERINPUT, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Sends a message to a background agent task. + /// Resolves a pending `sampling.requested` event with a sampling result, or rejects it. /// - /// Wire method: `session.tasks.sendMessage`. + /// Wire method: `session.ui.handlePendingSampling`. /// /// # Parameters /// - /// * `params` - Identifier of the target agent task, message content, and optional sender agent ID. + /// * `params` - Request ID of a pending `sampling.requested` event and an optional sampling result payload (omit to reject). /// /// # Returns /// - /// Indicates whether the message was delivered, with an error message when delivery failed. + /// Indicates whether the pending UI request was resolved by this call. /// ///
/// @@ -10853,35 +11871,34 @@ impl<'a> SessionRpcTasks<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn send_message( + pub async fn handle_pending_sampling( &self, - params: TasksSendMessageRequest, - ) -> Result { + params: UIHandlePendingSamplingRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TASKS_SENDMESSAGE, Some(wire_params)) + .call( + rpc_methods::SESSION_UI_HANDLEPENDINGSAMPLING, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } -} -/// `session.telemetry.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcTelemetry<'a> { - pub(crate) session: &'a Session, -} - -impl<'a> SessionRpcTelemetry<'a> { - /// Gets the telemetry engagement ID currently associated with the session, when available. + /// Resolves a pending `auto_mode_switch.requested` event with the user's accept/decline decision. /// - /// Wire method: `session.telemetry.getEngagementId`. + /// Wire method: `session.ui.handlePendingAutoModeSwitch`. + /// + /// # Parameters + /// + /// * `params` - Request ID of a pending `auto_mode_switch.requested` event and the user's response. /// /// # Returns /// - /// Telemetry engagement ID for the session, when available. + /// Indicates whether the pending UI request was resolved by this call. /// ///
/// @@ -10890,26 +11907,34 @@ impl<'a> SessionRpcTelemetry<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_engagement_id(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn handle_pending_auto_mode_switch( + &self, + params: UIHandlePendingAutoModeSwitchRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_TELEMETRY_GETENGAGEMENTID, + rpc_methods::SESSION_UI_HANDLEPENDINGAUTOMODESWITCH, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Sets feature override key/value pairs to attach to subsequent telemetry events for the session. + /// Resolves a pending `session_limits_exhausted.requested` event with the user's selected limit action. /// - /// Wire method: `session.telemetry.setFeatureOverrides`. + /// Wire method: `session.ui.handlePendingSessionLimitsExhausted`. /// /// # Parameters /// - /// * `params` - Feature override key/value pairs to attach to subsequent telemetry events from this session. + /// * `params` - Request ID of a pending `session_limits_exhausted.requested` event and the user's selected limit action. + /// + /// # Returns + /// + /// Indicates whether the pending UI request was resolved by this call. /// ///
/// @@ -10918,42 +11943,34 @@ impl<'a> SessionRpcTelemetry<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn set_feature_overrides( + pub async fn handle_pending_session_limits_exhausted( &self, - params: TelemetrySetFeatureOverridesRequest, - ) -> Result<(), Error> { + params: UIHandlePendingSessionLimitsExhaustedRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_TELEMETRY_SETFEATUREOVERRIDES, + rpc_methods::SESSION_UI_HANDLEPENDINGSESSIONLIMITSEXHAUSTED, Some(wire_params), ) .await?; - Ok(()) + Ok(serde_json::from_value(_value)?) } -} -/// `session.tools.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcTools<'a> { - pub(crate) session: &'a Session, -} - -impl<'a> SessionRpcTools<'a> { - /// Executes one tool from the session's currently offered tool set through the native invocation pipeline. + /// Resolves a pending `exit_plan_mode.requested` event with the user's response. /// - /// Wire method: `session.tools.execute`. + /// Wire method: `session.ui.handlePendingExitPlanMode`. /// /// # Parameters /// - /// * `params` - A tool name and arguments to execute through the session's native invocation pipeline. + /// * `params` - Request ID of a pending `exit_plan_mode.requested` event and the user's response. /// /// # Returns /// - /// Canonical result returned by a session tool. + /// Indicates whether the pending UI request was resolved by this call. /// ///
/// @@ -10962,28 +11979,30 @@ impl<'a> SessionRpcTools<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn execute(&self, params: ToolsExecuteRequest) -> Result { + pub async fn handle_pending_exit_plan_mode( + &self, + params: UIHandlePendingExitPlanModeRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TOOLS_EXECUTE, Some(wire_params)) + .call( + rpc_methods::SESSION_UI_HANDLEPENDINGEXITPLANMODE, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Returns the Rust-owned built-in tool descriptors used to construct the session's offered tool set. - /// - /// Wire method: `session.tools.getBuiltinDescriptors`. - /// - /// # Parameters + /// Registers an in-process handler for auto-mode-switch requests so the server bridge skips dispatch. /// - /// * `params` - Options controlling how Rust-owned built-in tool descriptors are materialized. + /// Wire method: `session.ui.registerDirectAutoModeSwitchHandler`. /// /// # Returns /// - /// Rust-owned built-in tool descriptors for the session. + /// Register an in-process handler for `auto_mode_switch.requested` events. The caller still attaches the actual listener via the standard event-subscription mechanism; this registration solely tells the server bridge to skip its own dispatch (so a remote client doesn't race the in-process handler for the same requestId). /// ///
/// @@ -10992,34 +12011,32 @@ impl<'a> SessionRpcTools<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_builtin_descriptors( + pub async fn register_direct_auto_mode_switch_handler( &self, - params: ToolsGetBuiltinDescriptorsRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + ) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() .call( - rpc_methods::SESSION_TOOLS_GETBUILTINDESCRIPTORS, + rpc_methods::SESSION_UI_REGISTERDIRECTAUTOMODESWITCHHANDLER, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Projects a completed task_complete tool call into its label-safe session event payload. + /// Unregisters a previously-registered in-process auto-mode-switch handler by its opaque handle. /// - /// Wire method: `session.tools.taskCompleteEventData`. + /// Wire method: `session.ui.unregisterDirectAutoModeSwitchHandler`. /// /// # Parameters /// - /// * `params` - Task-completion tool arguments and final result used to build a label-safe session event payload. + /// * `params` - Opaque handle previously returned by `registerDirectAutoModeSwitchHandler` to release. /// /// # Returns /// - /// Task completion notification with summary from the agent + /// Indicates whether the handle was active and the registration count was decremented. /// ///
/// @@ -11028,34 +12045,38 @@ impl<'a> SessionRpcTools<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn task_complete_event_data( + pub async fn unregister_direct_auto_mode_switch_handler( &self, - params: ToolsTaskCompleteEventDataRequest, - ) -> Result { + params: UIUnregisterDirectAutoModeSwitchHandlerRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_TOOLS_TASKCOMPLETEEVENTDATA, + rpc_methods::SESSION_UI_UNREGISTERDIRECTAUTOMODESWITCHHANDLER, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } +} + +/// `session.usage.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcUsage<'a> { + pub(crate) session: &'a Session, +} - /// Provides the result for a pending external tool call. - /// - /// Wire method: `session.tools.handlePendingToolCall`. - /// - /// # Parameters +impl<'a> SessionRpcUsage<'a> { + /// Gets accumulated usage metrics for the session. /// - /// * `params` - Pending external tool call request ID, with the tool result or an error describing why it failed. + /// Wire method: `session.usage.getMetrics`. /// /// # Returns /// - /// Indicates whether the external tool call result was handled successfully. + /// Accumulated session usage metrics, including premium request cost, token counts, model breakdown, and code-change totals. /// ///
/// @@ -11064,30 +12085,31 @@ impl<'a> SessionRpcTools<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn handle_pending_tool_call( - &self, - params: HandlePendingToolCallRequest, - ) -> Result { - let mut wire_params = serde_json::to_value(params)?; - wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); + pub async fn get_metrics(&self) -> Result { + let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call( - rpc_methods::SESSION_TOOLS_HANDLEPENDINGTOOLCALL, - Some(wire_params), - ) + .call(rpc_methods::SESSION_USAGE_GETMETRICS, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } +} - /// Resolves, builds, and validates the runtime tool list for the session. +/// `session.visibility.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcVisibility<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcVisibility<'a> { + /// Returns the session's current Mission Control sharing status and shareable GitHub URL. Reflects whether the synced session is visible to repository readers ("repo") or restricted to its creator and collaborators ("unshared"). /// - /// Wire method: `session.tools.initializeAndValidate`. + /// Wire method: `session.visibility.get`. /// /// # Returns /// - /// Resolve, build, and validate the runtime tool list for this session. Subagent sessions and consumer flows that need an initialized tool set before `send` invoke this. Default base-class implementation is a no-op for sessions that don't support tool validation. + /// Current sharing status and shareable GitHub URL for a session. /// ///
/// @@ -11096,26 +12118,27 @@ impl<'a> SessionRpcTools<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn initialize_and_validate(&self) -> Result { + pub async fn get(&self) -> Result { let wire_params = serde_json::json!({ "sessionId": self.session.id() }); let _value = self .session .client() - .call( - rpc_methods::SESSION_TOOLS_INITIALIZEANDVALIDATE, - Some(wire_params), - ) + .call(rpc_methods::SESSION_VISIBILITY_GET, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Returns lightweight metadata for the session's currently initialized tools. + /// Sets the session's Mission Control sharing status, controlling whether the synced session is visible to repository readers. Returns the effective status and shareable GitHub URL after the change. /// - /// Wire method: `session.tools.getCurrentMetadata`. + /// Wire method: `session.visibility.set`. + /// + /// # Parameters + /// + /// * `params` - Desired sharing status for the session. /// /// # Returns /// - /// Current lightweight tool metadata snapshot for the session. + /// Effective sharing status and shareable GitHub URL after updating session visibility. /// ///
/// @@ -11124,30 +12147,43 @@ impl<'a> SessionRpcTools<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_current_metadata(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn set(&self, params: VisibilitySetRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_TOOLS_GETCURRENTMETADATA, - Some(wire_params), - ) + .call(rpc_methods::SESSION_VISIBILITY_SET, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } +} - /// Atomically replaces the complete externally implemented tool list supplied by the calling connection. Built-in, MCP/plugin, extension-discovered, subagent, and tools supplied by other connections remain unchanged. +/// `session.workflow.*` RPCs. +#[derive(Clone, Copy)] +pub struct SessionRpcWorkflow<'a> { + pub(crate) session: &'a Session, +} + +impl<'a> SessionRpcWorkflow<'a> { + /// `session.workflow.journal.*` sub-namespace. + pub fn journal(&self) -> SessionRpcWorkflowJournal<'a> { + SessionRpcWorkflowJournal { + session: self.session, + } + } + + /// Runs a registered dynamic workflow by name at the top level. /// - /// Wire method: `session.tools.set`. + /// Wire method: `session.workflow.run`. /// /// # Parameters /// - /// * `params` - Complete externally implemented tool list for the calling connection. An empty list removes every tool previously supplied by that connection. + /// * `params` - Parameters for invoking a registered workflow. /// /// # Returns /// - /// Empty result after replacing the calling connection's externally implemented tools. + /// Complete current or terminal workflow run envelope. /// ///
/// @@ -11156,28 +12192,28 @@ impl<'a> SessionRpcTools<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn set(&self, params: ToolsSetRequest) -> Result { + pub async fn run(&self, params: WorkflowRunRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_TOOLS_SET, Some(wire_params)) + .call(rpc_methods::SESSION_WORKFLOW_RUN, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Sets the current session's live subagent settings override, which takes precedence over persisted user settings until cleared. Persisted user settings remain the source of truth for future sessions. + /// Resumes a dynamic workflow run using its persisted name, arguments, journal, and accounting. /// - /// Wire method: `session.tools.updateSubagentSettings`. + /// Wire method: `session.workflow.resume`. /// /// # Parameters /// - /// * `params` - Subagent settings to apply to the current session + /// * `params` - Parameters for resuming a workflow run from its persisted identity. /// /// # Returns /// - /// Empty result after applying subagent settings + /// Resolved persisted workflow identity and resumed run envelope. /// ///
/// @@ -11186,42 +12222,31 @@ impl<'a> SessionRpcTools<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn update_subagent_settings( + pub async fn resume( &self, - params: UpdateSubagentSettingsRequest, - ) -> Result { + params: WorkflowResumeRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_TOOLS_UPDATESUBAGENTSETTINGS, - Some(wire_params), - ) + .call(rpc_methods::SESSION_WORKFLOW_RESUME, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } -} -/// `session.ui.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcUi<'a> { - pub(crate) session: &'a Session, -} - -impl<'a> SessionRpcUi<'a> { - /// Runs a transient no-tools model query against the current conversation context. + /// Internal tool-originated dynamic workflow invocation. /// - /// Wire method: `session.ui.ephemeralQuery`. + /// Wire method: `session.workflow.runFromTool`. /// /// # Parameters /// - /// * `params` - Transient question to answer without adding it to conversation history. + /// * `params` - Internal parameters for invoking a registered workflow from a tool. /// /// # Returns /// - /// Completed transient query. Ordered chunks and the terminal outcome are also delivered through `ui.ephemeral_query` session events while it runs. + /// Complete current or terminal workflow run envelope. /// ///
/// @@ -11230,31 +12255,31 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn ephemeral_query( + pub(crate) async fn run_from_tool( &self, - params: UIEphemeralQueryRequest, - ) -> Result { + params: WorkflowToolRunRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_UI_EPHEMERALQUERY, Some(wire_params)) + .call(rpc_methods::SESSION_WORKFLOW_RUNFROMTOOL, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Requests structured input from a UI-capable client. + /// Internal tool-originated dynamic workflow resume. /// - /// Wire method: `session.ui.elicitation`. + /// Wire method: `session.workflow.resumeFromTool`. /// /// # Parameters /// - /// * `params` - Prompt message and JSON schema describing the form fields to elicit from the user. + /// * `params` - Internal parameters for resuming a workflow run from a tool. /// /// # Returns /// - /// The elicitation response (accept with form values, decline, or cancel) + /// Resolved persisted workflow identity and resumed run envelope. /// ///
/// @@ -11263,31 +12288,34 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn elicitation( + pub(crate) async fn resume_from_tool( &self, - params: UIElicitationRequest, - ) -> Result { + params: WorkflowToolResumeRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_UI_ELICITATION, Some(wire_params)) + .call( + rpc_methods::SESSION_WORKFLOW_RESUMEFROMTOOL, + Some(wire_params), + ) .await?; Ok(serde_json::from_value(_value)?) } - /// Provides the user response for a pending elicitation request. + /// Gets the current or settled envelope for a dynamic workflow run. /// - /// Wire method: `session.ui.handlePendingElicitation`. + /// Wire method: `session.workflow.getRun`. /// /// # Parameters /// - /// * `params` - Pending elicitation request ID and the user's response (accept/decline/cancel + form values). + /// * `params` - Parameters for retrieving a workflow run. /// /// # Returns /// - /// Indicates whether the elicitation response was accepted; false if it was already resolved by another client. + /// Complete current or terminal workflow run envelope. /// ///
/// @@ -11296,34 +12324,28 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn handle_pending_elicitation( - &self, - params: UIHandlePendingElicitationRequest, - ) -> Result { + pub async fn get_run(&self, params: WorkflowGetRunRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_UI_HANDLEPENDINGELICITATION, - Some(wire_params), - ) + .call(rpc_methods::SESSION_WORKFLOW_GETRUN, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Resolves a pending `user_input.requested` event with the user's response. + /// Lists durable dynamic workflow runs for this session in creation order. /// - /// Wire method: `session.ui.handlePendingUserInput`. + /// Wire method: `session.workflow.listRuns`. /// /// # Parameters /// - /// * `params` - Request ID of a pending `user_input.requested` event and the user's response. + /// * `params` - Parameters for paging workflow runs. /// /// # Returns /// - /// Indicates whether the pending UI request was resolved by this call. + /// A page of workflow runs in durable creation order. /// ///
/// @@ -11332,34 +12354,31 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn handle_pending_user_input( + pub async fn list_runs( &self, - params: UIHandlePendingUserInputRequest, - ) -> Result { + params: WorkflowListRunsRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_UI_HANDLEPENDINGUSERINPUT, - Some(wire_params), - ) + .call(rpc_methods::SESSION_WORKFLOW_LISTRUNS, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Resolves a pending `sampling.requested` event with a sampling result, or rejects it. + /// Gets durable and live observability detail for one dynamic workflow run. /// - /// Wire method: `session.ui.handlePendingSampling`. + /// Wire method: `session.workflow.getRunDetail`. /// /// # Parameters /// - /// * `params` - Request ID of a pending `sampling.requested` event and an optional sampling result payload (omit to reject). + /// * `params` - Parameters for retrieving a workflow run. /// /// # Returns /// - /// Indicates whether the pending UI request was resolved by this call. + /// Full workflow run observability detail. /// ///
/// @@ -11368,34 +12387,34 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn handle_pending_sampling( + pub async fn get_run_detail( &self, - params: UIHandlePendingSamplingRequest, - ) -> Result { + params: WorkflowGetRunRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_UI_HANDLEPENDINGSAMPLING, + rpc_methods::SESSION_WORKFLOW_GETRUNDETAIL, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Resolves a pending `auto_mode_switch.requested` event with the user's accept/decline decision. + /// Pages durable progress for one dynamic workflow run. /// - /// Wire method: `session.ui.handlePendingAutoModeSwitch`. + /// Wire method: `session.workflow.getRunProgress`. /// /// # Parameters /// - /// * `params` - Request ID of a pending `auto_mode_switch.requested` event and the user's response. + /// * `params` - Parameters for paging workflow progress. /// /// # Returns /// - /// Indicates whether the pending UI request was resolved by this call. + /// A bidirectional page of workflow progress. /// ///
/// @@ -11404,34 +12423,34 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn handle_pending_auto_mode_switch( + pub async fn get_run_progress( &self, - params: UIHandlePendingAutoModeSwitchRequest, - ) -> Result { + params: WorkflowGetRunProgressRequest, + ) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_UI_HANDLEPENDINGAUTOMODESWITCH, + rpc_methods::SESSION_WORKFLOW_GETRUNPROGRESS, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Resolves a pending `session_limits_exhausted.requested` event with the user's selected limit action. + /// Requests cancellation of a dynamic workflow run and returns its run envelope. /// - /// Wire method: `session.ui.handlePendingSessionLimitsExhausted`. + /// Wire method: `session.workflow.cancel`. /// /// # Parameters /// - /// * `params` - Request ID of a pending `session_limits_exhausted.requested` event and the user's selected limit action. + /// * `params` - Parameters for cancelling a workflow run. /// /// # Returns /// - /// Indicates whether the pending UI request was resolved by this call. + /// Complete current or terminal workflow run envelope. /// ///
/// @@ -11440,34 +12459,28 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn handle_pending_session_limits_exhausted( - &self, - params: UIHandlePendingSessionLimitsExhaustedRequest, - ) -> Result { + pub async fn cancel(&self, params: WorkflowCancelRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_UI_HANDLEPENDINGSESSIONLIMITSEXHAUSTED, - Some(wire_params), - ) + .call(rpc_methods::SESSION_WORKFLOW_CANCEL, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Resolves a pending `exit_plan_mode.requested` event with the user's response. + /// Pauses a running dynamic workflow and returns its settled run envelope. /// - /// Wire method: `session.ui.handlePendingExitPlanMode`. + /// Wire method: `session.workflow.pause`. /// /// # Parameters /// - /// * `params` - Request ID of a pending `exit_plan_mode.requested` event and the user's response. + /// * `params` - Parameters for pausing a running workflow. /// /// # Returns /// - /// Indicates whether the pending UI request was resolved by this call. + /// Complete current or terminal workflow run envelope. /// ///
/// @@ -11476,30 +12489,24 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn handle_pending_exit_plan_mode( - &self, - params: UIHandlePendingExitPlanModeRequest, - ) -> Result { + pub async fn pause(&self, params: WorkflowPauseRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_UI_HANDLEPENDINGEXITPLANMODE, - Some(wire_params), - ) + .call(rpc_methods::SESSION_WORKFLOW_PAUSE, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Registers an in-process handler for auto-mode-switch requests so the server bridge skips dispatch. + /// Atomically pauses an owned dynamic workflow attempt at a durable checkpoint. /// - /// Wire method: `session.ui.registerDirectAutoModeSwitchHandler`. + /// Wire method: `session.workflow.pauseAtCheckpoint`. /// - /// # Returns + /// # Parameters /// - /// Register an in-process handler for `auto_mode_switch.requested` events. The caller still attaches the actual listener via the standard event-subscription mechanism; this registration solely tells the server bridge to skip its own dispatch (so a remote client doesn't race the in-process handler for the same requestId). + /// * `params` - Parameters for an owned durable pause checkpoint. /// ///
/// @@ -11508,32 +12515,34 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn register_direct_auto_mode_switch_handler( + pub(crate) async fn pause_at_checkpoint( &self, - ) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + params: WorkflowPauseCheckpointRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() .call( - rpc_methods::SESSION_UI_REGISTERDIRECTAUTOMODESWITCHHANDLER, + rpc_methods::SESSION_WORKFLOW_PAUSEATCHECKPOINT, Some(wire_params), ) .await?; Ok(serde_json::from_value(_value)?) } - /// Unregisters a previously-registered in-process auto-mode-switch handler by its opaque handle. + /// Records a batch of ordered dynamic workflow progress lines. /// - /// Wire method: `session.ui.unregisterDirectAutoModeSwitchHandler`. + /// Wire method: `session.workflow.log`. /// /// # Parameters /// - /// * `params` - Opaque handle previously returned by `registerDirectAutoModeSwitchHandler` to release. + /// * `params` - Parameters for recording workflow progress. /// /// # Returns /// - /// Indicates whether the handle was active and the registration count was decremented. + /// Acknowledgement that a workflow request was accepted. /// ///
/// @@ -11542,38 +12551,28 @@ impl<'a> SessionRpcUi<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn unregister_direct_auto_mode_switch_handler( - &self, - params: UIUnregisterDirectAutoModeSwitchHandlerRequest, - ) -> Result { + pub async fn log(&self, params: WorkflowLogRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call( - rpc_methods::SESSION_UI_UNREGISTERDIRECTAUTOMODESWITCHHANDLER, - Some(wire_params), - ) + .call(rpc_methods::SESSION_WORKFLOW_LOG, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } -} -/// `session.usage.*` RPCs. -#[derive(Clone, Copy)] -pub struct SessionRpcUsage<'a> { - pub(crate) session: &'a Session, -} - -impl<'a> SessionRpcUsage<'a> { - /// Gets accumulated usage metrics for the session. + /// Runs one dynamic-workflow-scoped subagent and returns its result. /// - /// Wire method: `session.usage.getMetrics`. + /// Wire method: `session.workflow.agent`. + /// + /// # Parameters + /// + /// * `params` - Parameters for one workflow-scoped subagent call. /// /// # Returns /// - /// Accumulated session usage metrics, including premium request cost, token counts, model breakdown, and code-change totals. + /// Result of one workflow-scoped subagent call. /// ///
/// @@ -11582,31 +12581,36 @@ impl<'a> SessionRpcUsage<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get_metrics(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn agent(&self, params: WorkflowAgentRequest) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_USAGE_GETMETRICS, Some(wire_params)) + .call(rpc_methods::SESSION_WORKFLOW_AGENT, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } } -/// `session.visibility.*` RPCs. +/// `session.workflow.journal.*` RPCs. #[derive(Clone, Copy)] -pub struct SessionRpcVisibility<'a> { +pub struct SessionRpcWorkflowJournal<'a> { pub(crate) session: &'a Session, } -impl<'a> SessionRpcVisibility<'a> { - /// Returns the session's current Mission Control sharing status and shareable GitHub URL. Reflects whether the synced session is visible to repository readers ("repo") or restricted to its creator and collaborators ("unshared"). +impl<'a> SessionRpcWorkflowJournal<'a> { + /// Reads a memoized dynamic workflow journal entry. /// - /// Wire method: `session.visibility.get`. + /// Wire method: `session.workflow.journal.get`. + /// + /// # Parameters + /// + /// * `params` - Parameters for reading a workflow journal entry. /// /// # Returns /// - /// Current sharing status and shareable GitHub URL for a session. + /// Result of reading a workflow journal entry. /// ///
/// @@ -11615,27 +12619,31 @@ impl<'a> SessionRpcVisibility<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn get(&self) -> Result { - let wire_params = serde_json::json!({ "sessionId": self.session.id() }); + pub async fn get( + &self, + params: WorkflowJournalGetRequest, + ) -> Result { + let mut wire_params = serde_json::to_value(params)?; + wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_VISIBILITY_GET, Some(wire_params)) + .call(rpc_methods::SESSION_WORKFLOW_JOURNAL_GET, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } - /// Sets the session's Mission Control sharing status, controlling whether the synced session is visible to repository readers. Returns the effective status and shareable GitHub URL after the change. + /// Stores a memoized dynamic workflow journal entry. /// - /// Wire method: `session.visibility.set`. + /// Wire method: `session.workflow.journal.put`. /// /// # Parameters /// - /// * `params` - Desired sharing status for the session. + /// * `params` - Parameters for storing a workflow journal entry. /// /// # Returns /// - /// Effective sharing status and shareable GitHub URL after updating session visibility. + /// Acknowledgement that a workflow request was accepted. /// ///
/// @@ -11644,13 +12652,13 @@ impl<'a> SessionRpcVisibility<'a> { /// SDK and CLI versions if your code depends on it. /// ///
- pub async fn set(&self, params: VisibilitySetRequest) -> Result { + pub async fn put(&self, params: WorkflowJournalPutRequest) -> Result { let mut wire_params = serde_json::to_value(params)?; wire_params["sessionId"] = serde_json::Value::String(self.session.id().to_string()); let _value = self .session .client() - .call(rpc_methods::SESSION_VISIBILITY_SET, Some(wire_params)) + .call(rpc_methods::SESSION_WORKFLOW_JOURNAL_PUT, Some(wire_params)) .await?; Ok(serde_json::from_value(_value)?) } diff --git a/rust/src/generated/session_events.rs b/rust/src/generated/session_events.rs index f34ee19e7b..6fba95dd7b 100644 --- a/rust/src/generated/session_events.rs +++ b/rust/src/generated/session_events.rs @@ -33,6 +33,8 @@ pub enum SessionEventType { SessionAutopilotObjectiveChanged, #[serde(rename = "session.info")] SessionInfo, + #[serde(rename = "session.indexed_search")] + SessionIndexedSearch, #[serde(rename = "session.warning")] SessionWarning, #[serde(rename = "session.model_change")] @@ -136,6 +138,8 @@ pub enum SessionEventType { ///
#[serde(rename = "session.fusion_completed")] SessionFusionCompleted, + #[serde(rename = "session.permission_recovery")] + SessionPermissionRecovery, #[serde(rename = "user.message")] UserMessage, #[serde(rename = "pending_messages.modified")] @@ -575,6 +579,8 @@ pub enum SessionEventData { SessionAutopilotObjectiveChanged(SessionAutopilotObjectiveChangedData), #[serde(rename = "session.info")] SessionInfo(SessionInfoData), + #[serde(rename = "session.indexed_search")] + SessionIndexedSearch(SessionIndexedSearchData), #[serde(rename = "session.warning")] SessionWarning(SessionWarningData), #[serde(rename = "session.model_change")] @@ -678,6 +684,8 @@ pub enum SessionEventData { ///
#[serde(rename = "session.fusion_completed")] SessionFusionCompleted(SessionFusionCompletedData), + #[serde(rename = "session.permission_recovery")] + SessionPermissionRecovery(SessionPermissionRecoveryData), #[serde(rename = "user.message")] UserMessage(UserMessageData), #[serde(rename = "pending_messages.modified")] @@ -1388,6 +1396,87 @@ pub struct SessionInfoData { pub url: Option, } +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct IndexedSearchDataStatus { + /// Indexed-search event variant discriminator. + pub kind: IndexedSearchDataStatusKind, + /// Current indexed-search state for this session activation. + pub state: IndexedSearchState, +} + +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct IndexedSearchDataStartup { + /// Why indexed search was disabled, when applicable. + #[serde(skip_serializing_if = "Option::is_none")] + pub disabled_reason: Option, + /// Whether the repository meets the automatic indexing file-count threshold, when known. + #[serde(skip_serializing_if = "Option::is_none")] + pub eligible: Option, + /// Startup failure details. May contain sensitive user data; restricted telemetry only. + #[serde(skip_serializing_if = "Option::is_none")] + pub error_message: Option, + /// Number of text files counted in the repository. + #[serde(skip_serializing_if = "Option::is_none")] + pub file_count: Option, + /// Whether indexed search was explicitly enabled through the environment. + pub forced_by_env: bool, + /// Indexed-search event variant discriminator. + pub kind: IndexedSearchDataStartupKind, + /// Outcome of this startup attempt. + pub outcome: IndexedSearchOutcome, + /// Wall-clock duration of startup in milliseconds. + pub startup_duration_ms: f64, + /// Whether waiting for index readiness was requested, including skipped attempts. + pub warm_start: bool, +} + +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct IndexedSearchDataServerError { + /// Server failure details. May contain sensitive user data; restricted telemetry only. + #[serde(skip_serializing_if = "Option::is_none")] + pub error_message: Option, + /// Category of the server failure. + pub error_type: IndexedSearchErrorType, + /// Process exit code, when available. + #[serde(skip_serializing_if = "Option::is_none")] + pub exit_code: Option, + /// Indexed-search event variant discriminator. + pub kind: IndexedSearchDataServerErrorKind, +} + +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct IndexedSearchDataIncremental { + /// Number of added files. + #[serde(skip_serializing_if = "Option::is_none")] + pub added_file_count: Option, + /// Number of modified files. + #[serde(skip_serializing_if = "Option::is_none")] + pub changed_file_count: Option, + /// Number of deleted files. + #[serde(skip_serializing_if = "Option::is_none")] + pub deleted_file_count: Option, + /// Indexed-search event variant discriminator. + pub kind: IndexedSearchDataIncrementalKind, + /// Phase of the incremental index update. + pub phase: IndexedSearchIncrementalPhase, + /// Total number of detected changes. + #[serde(skip_serializing_if = "Option::is_none")] + pub total_change_count: Option, + /// Total incremental indexing duration in milliseconds. + #[serde(skip_serializing_if = "Option::is_none")] + pub total_duration_ms: Option, + /// Index update duration in milliseconds. + #[serde(skip_serializing_if = "Option::is_none")] + pub update_duration_ms: Option, + /// Workspace scan duration in milliseconds. + #[serde(skip_serializing_if = "Option::is_none")] + pub walk_duration_ms: Option, +} + /// Session event "session.warning". Warning message for timeline display with categorization #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] @@ -1999,6 +2088,18 @@ pub struct CompactionCompleteCompactionTokensUsed { pub output_tokens: Option, } +/// Original request-level and effective conversation reasoning effort for a Responses history boundary +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct ResponsesReasoning { + /// Effective effort selected before this message, independent of the response-level reasoning field + pub effort: String, + /// Original request-level effort, retained while replaying this conversation prefix + pub initial_effort: String, + /// Provider model whose reasoning settings this boundary records + pub model: String, +} + /// Session event "session.compaction_complete". Conversation compaction results including success status, metrics, and optional error details #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] @@ -2043,6 +2144,9 @@ pub struct SessionCompactionCompleteData { /// GitHub request tracing ID (x-github-request-id header) for the compaction LLM call #[serde(skip_serializing_if = "Option::is_none")] pub request_id: Option, + /// Reasoning baseline on the replacement summary, preserved when replay skips the compacted history + #[serde(skip_serializing_if = "Option::is_none")] + pub responses_reasoning: Option, /// Copilot service request ID (x-copilot-service-request-id header) for the compaction LLM call #[serde(skip_serializing_if = "Option::is_none")] pub service_request_id: Option, @@ -2071,10 +2175,74 @@ pub struct SessionCompactionCompleteData { pub trigger: Option, } +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct PermissionRecoveryAttempt { + /// Unique identifier for this attempt record + pub attempt_id: String, + /// How the runtime handled this attempt + pub disposition: PermissionRecoveryAttemptDisposition, + /// One-based position of this attempt in the episode + pub ordinal: i64, + /// Controlled permission request kind, such as shell, path, URL, or tool + pub permission_kind: String, + /// Controlled reason for the attempt disposition + pub reason: PermissionRecoveryAttemptReason, + /// Relationship between this attempt and earlier attempts in the episode + pub relation: PermissionRecoveryAttemptRelation, + /// SHA-256 fingerprint of normalized request data; raw permission arguments are not included + pub request_fingerprint: String, + /// Tool-call identifier associated with this attempt, when available + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + +/// Authoritative snapshot of an Autopilot permission-recovery episode +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct PermissionRecoveryData { + /// Ordered privacy-safe record of permission attempts and the successful alternative, when any + pub attempts: Vec, + /// Stable identifier shared by every transition in this recovery episode + pub episode_id: String, + /// Maximum number of distinct autonomous permission attempts allowed before escalation + pub max_attempts: i64, + /// Policy selected from the current client's response capability; mode or client changes may update it during recovery + pub on_blocked: PermissionRecoveryOnBlocked, + /// Controlled reason for the latest episode transition + pub reason: PermissionRecoveryReason, + /// Current lifecycle state of the recovery episode + pub status: PermissionRecoveryStatus, +} + +/// Structured reason that the task cannot continue without intervention +/// +///
+/// +/// **Experimental.** This type is part of an experimental wire-protocol surface +/// and may change or be removed in future SDK or CLI releases. +/// +///
+#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct TaskBlocker { + /// Category of intervention that blocked the task + pub kind: TaskBlockerKind, + /// Permission-recovery episode that produced this blocker + pub permission_recovery: PermissionRecoveryData, + /// Controlled reason for the current blocked state + pub reason: PermissionRecoveryReason, + /// Whether a later user response or steering message can resume the task + pub resumable: bool, +} + /// Session event "session.task_complete". Task completion notification with summary from the agent #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct SessionTaskCompleteData { + /// Structured blocker details when outcome is blocked + #[serde(skip_serializing_if = "Option::is_none")] + pub blocker: Option, /// Active autopilot objective ID evaluated by the completion reviewer #[serde(skip_serializing_if = "Option::is_none")] pub objective_id: Option, @@ -2382,6 +2550,24 @@ pub struct SessionFusionCompletedData { pub turn_id: String, } +/// Session event "session.permission_recovery". Authoritative snapshot of an Autopilot permission-recovery episode +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SessionPermissionRecoveryData { + /// Ordered privacy-safe record of permission attempts and the successful alternative, when any + pub attempts: Vec, + /// Stable identifier shared by every transition in this recovery episode + pub episode_id: String, + /// Maximum number of distinct autonomous permission attempts allowed before escalation + pub max_attempts: i64, + /// Policy selected from the current client's response capability; mode or client changes may update it during recovery + pub on_blocked: PermissionRecoveryOnBlocked, + /// Controlled reason for the latest episode transition + pub reason: PermissionRecoveryReason, + /// Current lifecycle state of the recovery episode + pub status: PermissionRecoveryStatus, +} + /// Session event "user.message". Payload of `user.message` with displayed and model-transformed content, attachments, source/delivery metadata, mode, and telemetry IDs. #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] @@ -2412,6 +2598,9 @@ pub struct UserMessageData { /// Parent agent task ID for background telemetry correlated to this user turn #[serde(skip_serializing_if = "Option::is_none")] pub parent_agent_task_id: Option, + /// Responses reasoning settings anchored before this model-facing message, for cache-stable history replay + #[serde(skip_serializing_if = "Option::is_none")] + pub responses_reasoning: Option, /// Origin of this message, used for timeline filtering and attribution (e.g., `skill-pdf` for hidden skill injection or `agent-` for an inter-agent prompt) #[serde(skip_serializing_if = "Option::is_none")] pub source: Option, @@ -3324,6 +3513,14 @@ pub struct AssistantUsageData { /// Copilot service request ID (x-copilot-service-request-id header) for CAPI log correlation #[serde(skip_serializing_if = "Option::is_none")] pub service_request_id: Option, + /// Number of prior thinking blocks the provider dropped while transforming the request + #[doc(hidden)] + #[serde(skip_serializing_if = "Option::is_none")] + pub(crate) thinking_dropped_blocks: Option, + /// Recognized provider-reported reasons for dropped thinking blocks, in response order + #[doc(hidden)] + #[serde(skip_serializing_if = "Option::is_none")] + pub(crate) thinking_dropped_reasons: Option>, /// Time to first token in milliseconds. Only available for streaming requests #[serde(skip_serializing_if = "Option::is_none")] pub time_to_first_token_ms: Option, @@ -4307,6 +4504,9 @@ pub struct SkillInvokedData { /// Whether model invocation is disabled for this skill #[serde(skip_serializing_if = "Option::is_none")] pub disable_model_invocation: Option, + /// Projected chat-message count when the skill was invoked. New writers persist this so replay does not need to reconstruct superseded history; readers derive it for legacy events when absent. + #[serde(skip_serializing_if = "Option::is_none")] + pub invoked_at_turn: Option, /// Model identifier active when the skill was invoked, when known #[serde(skip_serializing_if = "Option::is_none")] pub model: Option, @@ -4345,6 +4545,9 @@ pub struct SkillInvokedRefData { /// Whether model invocation is disabled for this skill #[serde(skip_serializing_if = "Option::is_none")] pub disable_model_invocation: Option, + /// Projected chat-message count when the skill was invoked. Preserved from the inline event data when the authored body is deduplicated. + #[serde(skip_serializing_if = "Option::is_none")] + pub invoked_at_turn: Option, /// Model identifier active when the skill was invoked, when known #[serde(skip_serializing_if = "Option::is_none")] pub model: Option, @@ -4398,10 +4601,259 @@ pub struct SkillContextDeliveredRefData { pub suffix: Option, } -/// Session event "sandbox.decision". Payload of `sandbox.decision`, a bounded governance record of what the process sandbox was configured to do and whether it took effect. Discriminated by `kind`. +/// Effective sandbox filesystem rules, in policy order. Only populated when content capture is enabled, since these are real host paths. +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SandboxFilesystemPolicyDetails { + /// Paths the sandboxed process may not access at all + pub denied_paths: Vec, + /// Paths the sandboxed process may read but not write + pub readonly_paths: Vec, + /// Paths the sandboxed process may read and write + pub readwrite_paths: Vec, +} + +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SandboxDecisionDataPolicyResolved { + /// Whether the current working directory was granted automatically + pub add_current_working_directory: bool, + /// Whether callers may opt an individual command out of the sandbox + pub allow_bypass: bool, + /// Whether the sandboxed process may reach loopback and private-range addresses + pub allow_local_network: bool, + /// Whether the sandboxed process may open outbound network connections + pub allow_outbound: bool, + /// Process-containment implementation backing the sandbox + pub backend: SandboxBackend, + /// Enforcement mechanism this decision describes + pub control: SandboxControl, + /// Why enforcement is weaker than configured, when it is + #[serde(skip_serializing_if = "Option::is_none")] + pub degradation_reason: Option, + /// Number of denied path rules in the effective policy + pub denied_paths_count: i64, + /// Effective filesystem rules. Populated only when content capture is enabled; the counts above are always present. + #[serde(skip_serializing_if = "Option::is_none")] + pub effective_filesystem_policy: Option, + /// Runtime subsystem that applied the policy + pub enforcement_point: SandboxEnforcementPoint, + /// Whether the sandbox policy permits GitHub CLI credentials inside the sandbox. A policy capability, not proof that a credential was injected into this spawn: injection is per-command + pub gh_auth: bool, + /// Whether the sandbox policy permits git credentials inside the sandbox. A policy capability, not proof that a credential was injected into this spawn: injection is per-command + pub git_auth: bool, + /// Whether the macOS keychain was reachable from inside the sandbox. Always false on other platforms. + pub keychain_access: bool, + /// Sandbox decision variant discriminator. + pub kind: SandboxDecisionDataPolicyResolvedKind, + /// Whether the resolved policy is fully active or degraded + pub outcome: SandboxOutcome, + /// Host platform the sandbox is running on + pub platform: SandboxPlatform, + /// Whether the policy came from built-in defaults or user configuration + pub policy_source: SandboxPolicySource, + /// Whether outbound traffic is unproxied, routed through a loopback proxy, or routed through an external proxy + pub proxy_mode: SandboxProxyMode, + /// Number of read-only path rules in the effective policy + pub readonly_paths_count: i64, + /// Number of read-write path rules in the effective policy + pub readwrite_paths_count: i64, + /// Internal tool-call ID, used only to correlate the decision with its owning span. Omitted when the decision is not attributable to a tool call. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SandboxDecisionDataSpawnCompleted { + /// Process-containment implementation backing the sandbox + pub backend: SandboxBackend, + /// Enforcement mechanism this decision describes + pub control: SandboxControl, + /// Why enforcement is weaker than configured, when it is + #[serde(skip_serializing_if = "Option::is_none")] + pub degradation_reason: Option, + /// Wall-clock time spent spawning the sandboxed process, in milliseconds + pub duration_ms: f64, + /// Runtime subsystem that applied the policy + pub enforcement_point: SandboxEnforcementPoint, + /// Sandbox decision variant discriminator. + pub kind: SandboxDecisionDataSpawnCompletedKind, + /// Whether the sandboxed process launched under the named backend. Not the exit status of the command that ran inside it. + pub outcome: SandboxOutcome, + /// Host platform the sandbox is running on + pub platform: SandboxPlatform, + /// Internal tool-call ID, used only to correlate the decision with its owning span. Omitted when the decision is not attributable to a tool call. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] -pub struct SandboxDecisionData {} +pub struct SandboxDecisionDataEnforcementState { + /// Runtime observation backing the state. Omitted for `inactive`, which has nothing to attest. + #[serde(skip_serializing_if = "Option::is_none")] + pub attestation: Option, + /// Containment backend that engaged. `unsupported` for any state other than `engaged`, since no backend is known to have run. + pub backend: SandboxBackend, + /// Command the enforcement governed. Populated only when content capture is enabled, and only for shell commands; MCP, LSP, and search command lines are runtime plumbing. + #[serde(skip_serializing_if = "Option::is_none")] + pub command: Option, + /// Enforcement mechanism this decision describes + pub control: SandboxControl, + /// Runtime subsystem whose enforcement this describes + pub enforcement_point: SandboxEnforcementPoint, + /// Sandbox decision variant discriminator. + pub kind: SandboxDecisionDataEnforcementStateKind, + /// Observed enforcement state: `engaged`, `inactive`, or `failed`. Derived from runtime evidence, never from the configured posture or the compile-time target platform. + pub outcome: SandboxOutcome, + /// Host platform the sandbox is running on + pub platform: SandboxPlatform, + /// Internal tool-call ID, used only to correlate the decision with its owning span. Omitted when the decision is not attributable to a tool call. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + +/// An enforcement check refused a specific access. Emitted per refusal with no deduplication, including when policy permits the caller to bypass the denial. Carries no backend: the built-in checks that produce this run in-process against the effective policy. +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SandboxDecisionDataAccessDenied { + /// Runtime observation backing the denial. + pub attestation: SandboxAttestation, + /// Command whose execution the denial arose from. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub command: Option, + /// How strong the evidence behind this denial is. Lets an analysis separate denials the sandbox recorded from ones inferred from output text, which otherwise look identical. + #[serde(skip_serializing_if = "Option::is_none")] + pub confidence: Option, + /// Sandbox control the denial belongs to. Follows from `denialClass`. + pub control: SandboxControl, + /// Bounded class of the refused access. + pub denial_class: SandboxDenialClass, + /// Resource the check refused, when identified and content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub denied_resource: Option, + /// Runtime subsystem that performed the check + pub enforcement_point: SandboxEnforcementPoint, + /// Sandbox decision variant discriminator. + pub kind: SandboxDecisionDataAccessDeniedKind, + /// Always `denied`. + pub outcome: SandboxOutcome, + /// Host operating-system family + pub platform: SandboxPlatform, + /// Executable image associated with the captured denial, normalized to a basename. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub process_name: Option, + /// Tool call the denial belongs to, for span correlation only. Never exported as a telemetry attribute or metric dimension. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + +/// A request to run outside the process sandbox was resolved. This is what makes an `inactive` `enforcement_state` readable: without it, a command that ran unsandboxed because a person approved a bypass looks identical to one that ran unsandboxed because the session never had a sandbox. Reported only when a sandbox was in force, since bypassing a disabled sandbox bypasses nothing. Carries neither backend nor attestation: the verdict comes from the runtime's own permission flow or the local escalation prompt, not from a containment backend and not from the built-in policy check, so `source` is what records where it came from. +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SandboxDecisionDataBypassDecided { + /// Command the verdict governs. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub command: Option, + /// How strong the evidence behind `denialClass` was. Present exactly when `denialClass` is, so a verdict that relaxed the sandbox on a guess is distinguishable from one that relaxed it on a recorded refusal. Named to match `access_denied`, which reports the same pair. + #[serde(skip_serializing_if = "Option::is_none")] + pub confidence: Option, + /// Always `bypass`. + pub control: SandboxControl, + /// Bounded class of the access whose refusal raised this escalation. Omitted for a pre-execution bypass, such as a detached command that cannot be sandboxed and therefore resolves no denial. + #[serde(skip_serializing_if = "Option::is_none")] + pub denial_class: Option, + /// Resource whose refusal raised this escalation. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub denied_resource: Option, + /// Runtime subsystem the bypass applies to + pub enforcement_point: SandboxEnforcementPoint, + /// Sandbox decision variant discriminator. + pub kind: SandboxDecisionDataBypassDecidedKind, + /// Whether the bypass was granted: `approved` or `declined`. `declined` also covers the cases where nobody answered, since the sandboxed denial stands either way. + pub outcome: SandboxOutcome, + /// Host operating-system family + pub platform: SandboxPlatform, + /// Executable image associated with the denial that raised this escalation, normalized to a basename. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub process_name: Option, + /// Where the request originated. Orthogonal to `outcome`. + pub source: SandboxBypassSource, + /// Tool call the decision belongs to, for span correlation only. Never exported as a telemetry attribute or metric dimension. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + +/// A permissive retry was resolved. Distinct from `bypass_decided` because this rung never requests a run outside the process sandbox: it relaxes the process container for one run while the sandbox, and with it the network policy, stays attached. Reported for both outcomes, so an escalation the user declined still leaves evidence that the runtime asked and that the sandboxed denial stood. +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SandboxDecisionDataPermissiveRetryDecided { + /// Command the verdict governs. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub command: Option, + /// How strong the evidence behind `denialClass` was. Present exactly when `denialClass` is. + #[serde(skip_serializing_if = "Option::is_none")] + pub confidence: Option, + /// Always `process`: the process container is what this rung relaxes, and the network control is deliberately untouched. + pub control: SandboxControl, + /// Bounded class of the access whose refusal raised this escalation. + #[serde(skip_serializing_if = "Option::is_none")] + pub denial_class: Option, + /// Resource whose refusal raised this escalation. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub denied_resource: Option, + /// Runtime subsystem the retry applies to + pub enforcement_point: SandboxEnforcementPoint, + /// Sandbox decision variant discriminator. + pub kind: SandboxDecisionDataPermissiveRetryDecidedKind, + /// Whether the permissive retry was granted: `approved` or `declined`. `declined` also covers the cases where nobody answered, since the sandboxed denial stands either way. + pub outcome: SandboxOutcome, + /// Host operating-system family + pub platform: SandboxPlatform, + /// Executable image associated with the denial that raised this escalation, normalized to a basename. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub process_name: Option, + /// Where the request originated. Orthogonal to `outcome`. + pub source: SandboxBypassSource, + /// Tool call the decision belongs to, for span correlation only. Never exported as a telemetry attribute or metric dimension. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} + +/// An approved permissive retry finished. `succeeded` means the retry exited successfully without another correlated sandbox denial; `failed` means it failed or remained blocked and may therefore be followed by a full bypass. +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct SandboxDecisionDataPermissiveRetryCompleted { + /// Command the retry executed. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub command: Option, + /// How strong the evidence behind `denialClass` was. + #[serde(skip_serializing_if = "Option::is_none")] + pub confidence: Option, + /// Always `process`: the retry changes process-container enforcement while leaving network policy attached. + pub control: SandboxControl, + /// Bounded class of the access whose refusal raised the permissive retry. + #[serde(skip_serializing_if = "Option::is_none")] + pub denial_class: Option, + /// Resource whose refusal raised the retry. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub denied_resource: Option, + /// Runtime subsystem that ran the retry + pub enforcement_point: SandboxEnforcementPoint, + /// Sandbox decision variant discriminator. + pub kind: SandboxDecisionDataPermissiveRetryCompletedKind, + /// Whether the permissive retry completed successfully: `succeeded` or `failed`. + pub outcome: SandboxOutcome, + /// Host operating-system family + pub platform: SandboxPlatform, + /// Executable image associated with the denial that raised the retry, normalized to a basename. Populated only when content capture is enabled. + #[serde(skip_serializing_if = "Option::is_none")] + pub process_name: Option, + /// Tool call the completion belongs to, for span correlation only. Never exported as a telemetry attribute or metric dimension. + #[serde(skip_serializing_if = "Option::is_none")] + pub tool_call_id: Option, +} /// Session event "subagent.started". Sub-agent startup details including parent tool call and agent information #[derive(Debug, Clone, Default, Serialize, Deserialize)] @@ -4692,6 +5144,9 @@ pub struct SystemNotificationData { pub content: String, /// Structured metadata identifying what triggered this notification pub kind: serde_json::Value, + /// Responses reasoning settings anchored before this model-facing message, for cache-stable history replay + #[serde(skip_serializing_if = "Option::is_none")] + pub responses_reasoning: Option, } /// A parsed command identifier in a shell permission request, including whether it is read-only. @@ -4922,6 +5377,21 @@ pub struct PermissionRequestUrl { pub url: String, } +/// Bounded runtime attribution, independent of free-text rationale. Telemetry revalidates this vocabulary before standard collection. +#[derive(Debug, Clone, Default, Serialize, Deserialize)] +#[serde(rename_all = "camelCase")] +pub struct PermissionApprovalEvaluation { + /// Stage that produced this attribution. + pub evaluation_stage: PermissionApprovalEvaluationEvaluationStage, + /// Whether the request invoked the judge interface. A cached recommendation retains the original attempt fact. Omitted means unknown, including inherited outcomes. + #[serde(skip_serializing_if = "Option::is_none")] + pub judge_attempted: Option, + /// Status of the local judge interface, not proof of a model network call. + pub judge_status: PermissionApprovalEvaluationJudgeStatus, + /// Machine-readable runtime gate reason, never a command, path or human rationale. + pub reason_code: PermissionApprovalEvaluationReasonCode, +} + /// Assisted-approval judge information attached to a permission request. Present only in assisted mode; its absence means the judge did not evaluate the request. The `recommendation` conveys the judge's disposition for this request. /// ///
@@ -4933,6 +5403,9 @@ pub struct PermissionRequestUrl { #[derive(Debug, Clone, Default, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct PermissionAssistedApproval { + /// Runtime reason and judge-call metadata. Absent on older events; missing metadata means unknown, not that the judge was skipped. + #[serde(skip_serializing_if = "Option::is_none")] + pub evaluation: Option, /// Classified cause of an `error` recommendation. Absent for every other recommendation. #[serde(skip_serializing_if = "Option::is_none")] pub failure_reason: Option, @@ -5625,11 +6098,17 @@ pub struct PermissionRequestedData { /// Agent mode captured from the owning turn when permission evaluation began. #[serde(skip_serializing_if = "Option::is_none")] pub agent_mode: Option, + /// Permission mode captured when evaluation began. Absent on historical events. + #[serde(skip_serializing_if = "Option::is_none")] + pub permission_mode: Option, /// Details of the permission being requested pub permission_request: PermissionRequest, /// Derived user-facing permission prompt details for UI consumers #[serde(skip_serializing_if = "Option::is_none")] pub prompt_request: Option, + /// Permission-recovery episode that authorized this request to surface for interactive attention + #[serde(skip_serializing_if = "Option::is_none")] + pub recovery_episode_id: Option, /// Unique identifier for this permission request; used to respond via session.respondToPermission() pub request_id: RequestId, /// When true, this permission was already resolved by a permissionRequest hook and requires no client action @@ -5862,6 +6341,9 @@ pub struct PermissionDeniedByPermissionRequestHook { #[derive(Debug, Clone, Serialize, Deserialize)] #[serde(rename_all = "camelCase")] pub struct PermissionCompletedData { + /// Atomic structured blocked outcome when this permission response ended an Autopilot recovery episode unsuccessfully + #[serde(skip_serializing_if = "Option::is_none")] + pub blocker: Option, /// Who decided this permission request. Absent on completions recorded before this field existed, which consumers must treat as "not a human decision" rather than assuming one. Authorization records are minted only for `human_response`; an assisted-approval verdict, a host policy, an unattended fallback, and a hook resolution all produce the same `result` a person does, so this is the only field that distinguishes them. /// ///
@@ -5872,6 +6354,9 @@ pub struct PermissionCompletedData { ///
#[serde(skip_serializing_if = "Option::is_none")] pub decision_source: Option, + /// Permission-recovery episode settled by this response, when the request was escalated by Autopilot + #[serde(skip_serializing_if = "Option::is_none")] + pub recovery_episode_id: Option, /// Request ID of the resolved permission request; clients should dismiss any UI for this request pub request_id: RequestId, /// The result of the permission request @@ -7300,6 +7785,9 @@ pub struct McpAppToolCallCompleteData { pub tool_name: String, } +/// Session event "session.indexed_search". Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. +pub type SessionIndexedSearchData = IndexedSearchData; + /// Routing preference used when the session model is `auto`. `fast` is an integrator-only latency preset and is not a first-party GitHub Copilot product preference. #[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] pub enum AutoTier { @@ -7483,6 +7971,168 @@ pub enum AutopilotObjectiveChangedStatus { Unknown, } +/// Indexed-search event variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchDataStatusKind { + #[serde(rename = "status")] + #[default] + Status, +} + +/// Live indexed-search state for this session activation, never inferred from persisted history. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchState { + /// Indexed search is not active for this session. + #[serde(rename = "disabled")] + Disabled, + /// Indexed-search startup is in progress. + #[serde(rename = "starting")] + Starting, + /// The indexed-search server started successfully; its index may still be warming. + #[serde(rename = "enabled")] + Enabled, + /// The indexed-search server and its index are ready. + #[serde(rename = "ready")] + Ready, + /// Indexed-search startup or the active server failed. + #[serde(rename = "failed")] + Failed, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Configuration, policy, or workspace condition that disabled indexed search. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchDisabledReason { + /// Indexed search was explicitly disabled by the environment. + #[serde(rename = "use_tgrep_false")] + UseTgrepFalse, + /// Search uses the external ripgrep binary instead of bundled search. + #[serde(rename = "use_builtin_ripgrep_false")] + UseBuiltinRipgrepFalse, + /// Organization policy disables indexed search. + #[serde(rename = "organization")] + Organization, + /// Authentication has not resolved organization policy. + #[serde(rename = "organization_policy_auth_pending")] + OrganizationPolicyAuthPending, + /// Organization policy could not be determined. + #[serde(rename = "organization_policy_unknown")] + OrganizationPolicyUnknown, + /// The workspace uses a virtualized or network filesystem. + #[serde(rename = "virtual_filesystem")] + VirtualFilesystem, + /// The workspace is inside a Windows cloud-sync root. + #[serde(rename = "cloud_sync_root")] + CloudSyncRoot, + /// The Windows cloud-sync safety check failed. + #[serde(rename = "cloud_sync_detection_failed")] + CloudSyncDetectionFailed, + /// The workspace is not available on the runtime's local filesystem. + #[serde(rename = "workspace_not_local")] + WorkspaceNotLocal, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Indexed-search event variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchDataStartupKind { + #[serde(rename = "startup")] + #[default] + Startup, +} + +/// Result of an indexed-search startup attempt. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchOutcome { + /// A new indexed-search server was started. + #[serde(rename = "started")] + Started, + /// The repository has too few files for automatic indexing. + #[serde(rename = "skipped_below_threshold")] + SkippedBelowThreshold, + /// No Git repository was found and indexing was not forced. + #[serde(rename = "skipped_no_gitroot")] + SkippedNoGitroot, + /// Configuration, policy, or workspace safety disabled indexing. + #[serde(rename = "skipped_disabled")] + SkippedDisabled, + /// An existing indexed-search server was reused. + #[serde(rename = "reused_existing")] + ReusedExisting, + /// The startup attempt failed. + #[serde(rename = "failed")] + Failed, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Category of an indexed-search server failure. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchErrorType { + /// The indexed-search server could not be spawned. + #[serde(rename = "spawn_error")] + SpawnError, + /// The indexed-search server exited unexpectedly. + #[serde(rename = "unexpected_exit")] + UnexpectedExit, + /// The indexed-search server was terminated by a signal. + #[serde(rename = "killed_by_signal")] + KilledBySignal, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Indexed-search event variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchDataServerErrorKind { + #[serde(rename = "server_error")] + #[default] + ServerError, +} + +/// Indexed-search event variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchDataIncrementalKind { + #[serde(rename = "incremental")] + #[default] + Incremental, +} + +/// Phase of an incremental indexed-search update. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum IndexedSearchIncrementalPhase { + /// A workspace scan found changes to index. + #[serde(rename = "changes_detected")] + ChangesDetected, + /// The incremental index update completed. + #[serde(rename = "updated")] + Updated, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Transient indexed-search status and diagnostics from the live runtime service. Never persisted or used to infer activation from session history. +#[derive(Debug, Clone, Serialize, Deserialize)] +#[serde(untagged)] +pub enum IndexedSearchData { + Status(IndexedSearchDataStatus), + Startup(IndexedSearchDataStartup), + ServerError(IndexedSearchDataServerError), + Incremental(IndexedSearchDataIncremental), +} + /// Origin of an effective session model change. #[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] pub enum ModelChangeSource { @@ -7516,6 +8166,9 @@ pub enum ModelChangeSource { /// The runtime selected the model automatically, such as rate-limit recovery or refusal fallback. #[serde(rename = "automatic")] Automatic, + /// The user selected the promoted model from the changeboarding card or its keyboard shortcut. + #[serde(rename = "changeboarding_shortcut")] + ChangeboardingShortcut, /// An SDK or RPC caller selected the model. #[serde(rename = "sdk")] Sdk, @@ -7676,6 +8329,159 @@ pub enum CompactionTrigger { Unknown, } +/// Category of structured task blocker +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum TaskBlockerKind { + /// Autopilot permission recovery requires intervention or has no safe autonomous path. + #[serde(rename = "permission_recovery")] + PermissionRecovery, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Runtime handling applied to a recovery attempt +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionRecoveryAttemptDisposition { + /// The request was denied without prompting so the agent could try an alternative. + #[serde(rename = "deferred")] + Deferred, + /// The request was surfaced to an interactive responder. + #[serde(rename = "prompted")] + Prompted, + /// The interactive responder approved the request. + #[serde(rename = "approved")] + Approved, + /// The interactive responder denied the request or became unavailable. + #[serde(rename = "denied")] + Denied, + /// The request exhausted unattended recovery and produced a blocked outcome. + #[serde(rename = "blocked")] + Blocked, + /// A tool call succeeded as an equivalent alternative. + #[serde(rename = "succeeded")] + Succeeded, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Controlled reason for an individual attempt disposition +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionRecoveryAttemptReason { + /// The attempt required permission that Assisted Permissions could not grant. + #[serde(rename = "permission_required")] + PermissionRequired, + /// The request repeated an earlier attempt. + #[serde(rename = "repeated_attempt")] + RepeatedAttempt, + /// The request exceeded the bounded number of distinct attempts. + #[serde(rename = "attempts_exhausted")] + AttemptsExhausted, + /// The interactive responder approved the request. + #[serde(rename = "permission_approved")] + PermissionApproved, + /// The interactive responder denied the request. + #[serde(rename = "permission_denied")] + PermissionDenied, + /// The interactive responder became unavailable. + #[serde(rename = "responder_unavailable")] + ResponderUnavailable, + /// The tool call succeeded without the blocked permission. + #[serde(rename = "equivalent_alternative_succeeded")] + EquivalentAlternativeSucceeded, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Relationship of an attempt to earlier permission requests +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionRecoveryAttemptRelation { + /// The first denied permission request in the episode. + #[serde(rename = "initial")] + Initial, + /// A request equivalent to an earlier attempt. + #[serde(rename = "retry")] + Retry, + /// A distinct request or a successful alternative tool call. + #[serde(rename = "alternative")] + Alternative, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Action selected when autonomous recovery cannot continue +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionRecoveryOnBlocked { + /// Surface the existing permission prompt to a response-capable client. + #[serde(rename = "ask")] + Ask, + /// Return a structured unsuccessful blocked outcome because no responder is available. + #[serde(rename = "fail")] + Fail, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Controlled reason for a permission-recovery episode transition +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionRecoveryReason { + /// An action required permission that Assisted Permissions could not grant. + #[serde(rename = "permission_required")] + PermissionRequired, + /// The agent repeated an equivalent permission request instead of making progress. + #[serde(rename = "repeated_attempt")] + RepeatedAttempt, + /// The bounded number of distinct permission attempts was exhausted. + #[serde(rename = "attempts_exhausted")] + AttemptsExhausted, + /// A responder approved the escalated permission request. + #[serde(rename = "permission_approved")] + PermissionApproved, + /// A responder denied the escalated permission request. + #[serde(rename = "permission_denied")] + PermissionDenied, + /// The response-capable client became unavailable while escalation was pending. + #[serde(rename = "responder_unavailable")] + ResponderUnavailable, + /// A later tool call succeeded without requiring the blocked permission. + #[serde(rename = "equivalent_alternative_succeeded")] + EquivalentAlternativeSucceeded, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Lifecycle state of a permission-recovery episode +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionRecoveryStatus { + /// Autopilot may try a bounded equivalent alternative. + #[serde(rename = "recovering")] + Recovering, + /// An interactive permission response is required. + #[serde(rename = "awaiting_approval")] + AwaitingApproval, + /// The episode ended through approval or a successful equivalent alternative. + #[serde(rename = "resolved")] + Resolved, + /// No autonomous path remains and the task requires intervention. + #[serde(rename = "blocked")] + Blocked, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + /// Semantic result of evaluating a task completion request #[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] pub enum TaskCompletionOutcome { @@ -8467,6 +9273,363 @@ pub enum SkillInvokedTrigger { Unknown, } +/// Process-containment backend selected for the host platform +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxBackend { + /// Apple Seatbelt process sandbox. + #[serde(rename = "seatbelt")] + Seatbelt, + /// Linux Bubblewrap process sandbox. + #[serde(rename = "bubblewrap")] + Bubblewrap, + /// Windows ProcessContainer sandbox. + #[serde(rename = "process_container")] + ProcessContainer, + /// No supported process-containment backend is available. + #[serde(rename = "unsupported")] + Unsupported, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Customer-controllable sandbox governance area +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxControl { + /// Process containment and sandbox spawn behavior. + #[serde(rename = "process")] + Process, + /// Filesystem read, write, and deny policy. + #[serde(rename = "filesystem")] + Filesystem, + /// Outbound and local-network access policy. + #[serde(rename = "network")] + Network, + /// Selection of the sandbox or built-in enforcement route. + #[serde(rename = "routing")] + Routing, + /// Decisions to run outside the process sandbox, whether requested by the model or resolved by a person. + #[serde(rename = "bypass")] + Bypass, + /// Credential and keychain capability injection. + #[serde(rename = "credentials")] + Credentials, + /// Host-platform and backend support behavior. + #[serde(rename = "platform")] + Platform, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Finite reason why sandbox enforcement is weaker than configured +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDegradationReason { + /// The selected backend cannot enforce per-path deny rules. + #[serde(rename = "denied_paths_unsupported")] + DeniedPathsUnsupported, + /// The host platform has no supported process-containment backend. + #[serde(rename = "unsupported_platform")] + UnsupportedPlatform, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Runtime boundary that enforced or routed a sandbox decision +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxEnforcementPoint { + /// Shell command process containment. + #[serde(rename = "shell")] + Shell, + /// Built-in filesystem policy enforcement. + #[serde(rename = "builtin_filesystem")] + BuiltinFilesystem, + /// Search-tool sandbox or policy enforcement. + #[serde(rename = "search")] + Search, + /// Web-fetch network policy enforcement. + #[serde(rename = "web_fetch")] + WebFetch, + /// Model Context Protocol server routing. + #[serde(rename = "mcp")] + Mcp, + /// Language server process routing. + #[serde(rename = "lsp")] + Lsp, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Sandbox decision variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDecisionDataPolicyResolvedKind { + #[serde(rename = "policy_resolved")] + #[default] + PolicyResolved, +} + +/// Finite result of a sandbox decision. Each `SandboxDecisionData` variant uses a disjoint subset: `policy_resolved` is `resolved | degraded`, `spawn_completed` and `permissive_retry_completed` are `succeeded | failed`, `enforcement_state` is `engaged | inactive | failed`, `access_denied` is `denied`, and escalation decisions are `approved | declined`. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxOutcome { + /// The sandbox policy resolved successfully. Describes configuration only and makes no claim that a backend engaged. + #[serde(rename = "resolved")] + Resolved, + /// No sandbox governed the workload. + #[serde(rename = "inactive")] + Inactive, + /// A runtime-owned containment backend accepted the workload. Evidence of engagement, not of verified containment for the workload's lifetime. + #[serde(rename = "engaged")] + Engaged, + /// The sandbox operation completed successfully. + #[serde(rename = "succeeded")] + Succeeded, + /// The sandbox operation failed. + #[serde(rename = "failed")] + Failed, + /// The sandbox is active with one or more controls weakened by platform limitations or an explicitly selected relaxed mode. + #[serde(rename = "degraded")] + Degraded, + /// An enforcement check refused the requested access. + #[serde(rename = "denied")] + Denied, + /// A request to run outside the process sandbox was granted. + #[serde(rename = "approved")] + Approved, + /// A request to run outside the process sandbox was not granted. + #[serde(rename = "declined")] + Declined, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Host operating-system family used for sandbox enforcement +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxPlatform { + /// Apple macOS host. + #[serde(rename = "macos")] + Macos, + /// Linux host. + #[serde(rename = "linux")] + Linux, + /// Microsoft Windows host. + #[serde(rename = "windows")] + Windows, + /// Host platform outside the explicitly supported families. + #[serde(rename = "other")] + Other, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Origin of the effective sandbox policy +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxPolicySource { + /// Runtime default sandbox policy. + #[serde(rename = "default_policy")] + DefaultPolicy, + /// User-configured sandbox policy merged with runtime-required grants. + #[serde(rename = "user_policy")] + UserPolicy, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Bounded classification of effective sandbox proxy routing +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxProxyMode { + /// No sandbox proxy is configured. + #[serde(rename = "none")] + None, + /// Traffic routes through a loopback proxy. + #[serde(rename = "loopback")] + Loopback, + /// Traffic routes through a non-loopback proxy endpoint. + #[serde(rename = "external")] + External, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Sandbox decision variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDecisionDataSpawnCompletedKind { + #[serde(rename = "spawn_completed")] + #[default] + SpawnCompleted, +} + +/// Runtime observation backing an enforcement-state or denial claim. Absent on `enforcement_state` when no observation backs the state. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxAttestation { + /// A containment backend accepted and applied the spawn request. + #[serde(rename = "spawn_succeeded")] + SpawnSucceeded, + /// The spawn was refused for lack of a usable containment backend. + #[serde(rename = "unsupported")] + Unsupported, + /// A runtime-owned policy check ran and returned a verdict. Attests the check, not that the caller honoured it. + #[serde(rename = "builtin_policy_checked")] + BuiltinPolicyChecked, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Sandbox decision variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDecisionDataEnforcementStateKind { + #[serde(rename = "enforcement_state")] + #[default] + EnforcementState, +} + +/// How strong the evidence behind a denial is. A denial the sandbox itself recorded is a fact; one inferred from a command's output text is a judgement, and an analysis that cannot tell them apart will treat a false positive as enforcement. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDenialConfidence { + /// The sandbox's own denial capture recorded the refused access. The strongest evidence available: the kernel observed it, not the runtime. + #[serde(rename = "captured")] + Captured, + /// The command named a path that the effective policy independently denies. No capture confirmed it, but the policy did. + #[serde(rename = "policy_corroborated")] + PolicyCorroborated, + /// The failure carried a fingerprint the sandbox itself emits, so the sandbox is known to have refused something even though the resource was not confirmed. + #[serde(rename = "sandbox_reported")] + SandboxReported, + /// Classified from the command's own output text alone. The weakest evidence: a command that merely prints sandbox-like wording reaches this level. + #[serde(rename = "output_classified")] + OutputClassified, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Bounded class of access an enforcement check refused. Raw resources, commands, and process names accompany it only when content capture is enabled; diagnostic text and matched rules are never exported. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDenialClass { + /// A read was refused because the effective policy does not grant it. + #[serde(rename = "filesystem_read")] + FilesystemRead, + /// A write was refused. Distinct from `filesystem_read` because a read-only grant denies writes to a path it otherwise permits. + #[serde(rename = "filesystem_write")] + FilesystemWrite, + /// A process could not start because the sandbox refused a required process-scoped resource. Currently emitted for the Windows MSYS `BaseNamedObjects` fork failure confirmed by learning-mode capture. + #[serde(rename = "process_startup")] + ProcessStartup, + /// Windows registry access was refused and correlated with capture evidence. + #[serde(rename = "registry_access")] + RegistryAccess, + /// Windows ALPC or RPC access was refused and correlated with capture evidence. + #[serde(rename = "ipc_access")] + IpcAccess, + /// Access to another Windows process was refused and correlated with capture evidence. + #[serde(rename = "process_access")] + ProcessAccess, + /// Windows job-object access was refused and correlated with capture evidence. + #[serde(rename = "job_access")] + JobAccess, + /// Windows UI-handle access was refused and correlated with capture evidence. + #[serde(rename = "ui_access")] + UiAccess, + /// Windows service-control-manager access was refused and correlated with capture evidence. + #[serde(rename = "service_access")] + ServiceAccess, + /// An outbound connection was refused by `network.allowOutbound`. + #[serde(rename = "network_outbound")] + NetworkOutbound, + /// A connection to a local or loopback destination was refused by `network.allowLocalNetwork`. + #[serde(rename = "network_local")] + NetworkLocal, + /// A destination was refused by the sandbox host allow/deny rules. + #[serde(rename = "network_host")] + NetworkHost, + /// The sandbox's denial capture recorded a refusal its record does not attribute to a more specific control: an unclassified resource (registry, COM, section object) or an AppContainer capability with no network meaning. Deliberately generic — the capture proves the denial happened, and naming a narrower class than the record supports would be a guess. + #[serde(rename = "other_access")] + OtherAccess, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Sandbox decision variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDecisionDataAccessDeniedKind { + #[serde(rename = "access_denied")] + #[default] + AccessDenied, +} + +/// Sandbox decision variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDecisionDataBypassDecidedKind { + #[serde(rename = "bypass_decided")] + #[default] + BypassDecided, +} + +/// Where a request to run outside the process sandbox originated. Orthogonal to the outcome: the same verdict means a different thing depending on where the request came from. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxBypassSource { + /// No longer produced. The model could once ask for a bypass in the tool call itself; no tool exposes that parameter now. Retained so historical events still deserialize. + #[serde(rename = "model_requested")] + ModelRequested, + /// The runtime raised the prompt itself — either after a sandboxed attempt looked blocked, or before a run the sandbox cannot enforce at all, such as a detached command — and a person answered it. In the second case nothing had executed when the decision was made. + #[serde(rename = "user_prompted")] + UserPrompted, + /// The runtime raised the prompt itself — after a sandboxed attempt looked blocked, or before a run it cannot enforce — but the permission flow produced no confirmed human answer. This includes unavailable or unreadable prompts, cancellation, and automated rule, hook, or content-exclusion denials. + #[serde(rename = "prompt_unavailable")] + PromptUnavailable, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Sandbox decision variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDecisionDataPermissiveRetryDecidedKind { + #[serde(rename = "permissive_retry_decided")] + #[default] + PermissiveRetryDecided, +} + +/// Sandbox decision variant discriminator. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum SandboxDecisionDataPermissiveRetryCompletedKind { + #[serde(rename = "permissive_retry_completed")] + #[default] + PermissiveRetryCompleted, +} + +/// Payload of `sandbox.decision`, a bounded governance record of what the process sandbox was configured to do and whether it took effect. Discriminated by `kind`. +#[derive(Debug, Clone, Serialize, Deserialize)] +#[serde(untagged)] +pub enum SandboxDecisionData { + PolicyResolved(SandboxDecisionDataPolicyResolved), + SpawnCompleted(SandboxDecisionDataSpawnCompleted), + EnforcementState(SandboxDecisionDataEnforcementState), + AccessDenied(SandboxDecisionDataAccessDenied), + BypassDecided(SandboxDecisionDataBypassDecided), + PermissiveRetryDecided(SandboxDecisionDataPermissiveRetryDecided), + PermissiveRetryCompleted(SandboxDecisionDataPermissiveRetryCompleted), +} + /// Authority or runtime mechanism responsible for sub-agent model selection. #[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] pub enum SubagentModelSelectionSource { @@ -8622,6 +9785,144 @@ pub enum PermissionRequestMemoryAction { Unknown, } +/// Stage that produced this attribution. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionApprovalEvaluationEvaluationStage { + /// The attribution stage is unknown. + #[serde(rename = "unknown")] + UnknownValue, + /// The request resolved before assisted-approval evaluation. + #[serde(rename = "not_reached")] + NotReached, + /// A runtime gate skipped the judge. + #[serde(rename = "pre_judge")] + PreJudge, + /// The judge interface produced the evaluation. + #[serde(rename = "judge")] + Judge, + /// A cached recommendation or another request's outcome was reused. + #[serde(rename = "reuse")] + Reuse, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Status of the local judge interface, not proof of a model network call. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionApprovalEvaluationJudgeStatus { + /// No authoritative attribution is available. + #[serde(rename = "unknown")] + UnknownValue, + /// This evaluation did not invoke the judge interface. + #[serde(rename = "not_called")] + NotCalled, + /// The judge interface returned a usable verdict. + #[serde(rename = "completed")] + Completed, + /// The judge interface returned an error. + #[serde(rename = "failed")] + Failed, + /// This evaluation reused a cached recommendation. + #[serde(rename = "cached")] + Cached, + /// This request inherited another decision without local judge attribution. + #[serde(rename = "inherited")] + Inherited, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + +/// Machine-readable runtime gate reason, never a command, path or human rationale. +#[derive(Debug, Clone, Default, PartialEq, Eq, Serialize, Deserialize)] +pub enum PermissionApprovalEvaluationReasonCode { + /// Attribution is missing or outside the supported vocabulary. + #[serde(rename = "unknown")] + UnknownValue, + /// The request resolved before assisted-approval evaluation. + #[serde(rename = "not-reached")] + NotReached, + /// Assisted approval was inactive for this request. + #[serde(rename = "inactive")] + Inactive, + /// The judge was skipped because authorization extraction could not safely establish a complete recent history. + #[serde(rename = "authorization-history-incomplete")] + AuthorizationHistoryIncomplete, + /// Managed policy required a human decision. + #[serde(rename = "managed-approval-required")] + ManagedApprovalRequired, + /// The request asked to bypass sandbox restrictions. + #[serde(rename = "sandbox-bypass")] + SandboxBypass, + /// An action field exceeded the judge input limit. + #[serde(rename = "action-too-long")] + ActionTooLong, + /// The script path was not authorized for inspection. + #[serde(rename = "path-not-authorized")] + PathNotAuthorized, + /// The script working directory was invalid. + #[serde(rename = "invalid-working-directory")] + InvalidWorkingDirectory, + /// The script snapshot could not be read. + #[serde(rename = "unreadable")] + Unreadable, + /// The script path was not a regular file. + #[serde(rename = "not-regular-file")] + NotRegularFile, + /// The script snapshot exceeded the size limit. + #[serde(rename = "too-large")] + TooLarge, + /// The script snapshot was not UTF-8. + #[serde(rename = "non-utf8")] + NonUtf8, + /// The script interpreter could not be inspected. + #[serde(rename = "interpreter-unavailable")] + InterpreterUnavailable, + /// The interpreter snapshot exceeded the size limit. + #[serde(rename = "interpreter-too-large")] + InterpreterTooLarge, + /// The shell environment could not be reviewed. + #[serde(rename = "shell-environment-unreviewable")] + ShellEnvironmentUnreviewable, + /// A script path could not be represented for review. + #[serde(rename = "unrepresentable-path")] + UnrepresentablePath, + /// An interpreter wrapped a script that could not be reviewed. + #[serde(rename = "interpreter-wrapped-script")] + InterpreterWrappedScript, + /// The script invocation could not be reviewed. + #[serde(rename = "unreviewable-script-invocation")] + UnreviewableScriptInvocation, + /// The script argument binding could not be reviewed. + #[serde(rename = "argument-binding-unreviewable")] + ArgumentBindingUnreviewable, + /// The script review metadata was malformed. + #[serde(rename = "malformed-script-action-review")] + MalformedScriptActionReview, + /// The script snapshot manifest was malformed. + #[serde(rename = "malformed-script-action-manifest")] + MalformedScriptActionManifest, + /// Script review was unavailable. + #[serde(rename = "unavailable")] + Unavailable, + /// The judge interface returned a usable verdict. + #[serde(rename = "judge-verdict")] + JudgeVerdict, + /// The judge interface returned an error. + #[serde(rename = "judge-error")] + JudgeError, + /// The request inherited an outcome from another decision. + #[serde(rename = "inherited")] + Inherited, + /// Unknown variant for forward compatibility. + #[default] + #[serde(other)] + Unknown, +} + /// Why the assisted-approval judge produced no usable recommendation. Present only alongside an `error` recommendation, where the human-readable reason is a fixed string and therefore cannot distinguish these cases. Intended to make a judge failure reportable by a consumer that has no access to the host's logs. /// ///
diff --git a/rust/tests/catalog_candidate_test.rs b/rust/tests/catalog_candidate_test.rs new file mode 100644 index 0000000000..79f6290fa7 --- /dev/null +++ b/rust/tests/catalog_candidate_test.rs @@ -0,0 +1,200 @@ +#![allow(clippy::unwrap_used)] + +use github_copilot_sdk::rpc::{ + CardDigest, CardDigestAlgorithm, CatalogAgentPluginCandidateKind, CatalogAiSkillCandidateKind, + CatalogCandidate, CatalogMcpServerCandidate, CatalogMcpServerCandidateKind, + CatalogMcpServerInstallability, CatalogSearchResult, McpServerCardMediaType, +}; +use serde_json::{Value, json}; + +fn search_result_wire() -> Value { + json!({ + "kind": "succeeded", + "candidates": [ + { + "kind": "mcp-server", + "displayName": "Postgres", + "description": "Query and inspect PostgreSQL databases.", + "publisher": "GitHub", + "handle": "opaque-mcp-handle", + "handleExpiresAt": "2026-09-02T12:00:00Z", + "mediaType": "application/mcp-server-card+json", + "installability": "installable", + "source": { + "kind": "url", + "url": "https://cards.example.test/postgres" + }, + "provenance": { + "authority": "agentfinder.github.com", + "mediaType": "application/mcp-server-card+json", + "observedAt": "2026-09-02T11:00:00Z" + } + }, + { + "kind": "ai-skill", + "displayName": "Lint", + "description": "Review code for focused lint and formatting issues.", + "publisher": "GitHub", + "handle": "opaque-skill-handle", + "handleExpiresAt": "2026-09-02T12:00:00Z", + "mediaType": "application/ai-skill", + "installability": "not-installable-kind", + "source": { + "kind": "url", + "url": "https://cards.example.test/lint" + }, + "provenance": { + "authority": "agentfinder.github.com", + "mediaType": "application/ai-skill", + "observedAt": "2026-09-02T11:00:00Z" + } + } + ], + "negotiated": { + "runtimeProtocolVersion": 3, + "grantedCapabilities": ["mcp-server-card", "ai-skill-discovery"] + }, + "searchId": "catalog-search-id", + "truncated": false + }) +} + +fn search_candidates() -> Vec { + let result: CatalogSearchResult = serde_json::from_value(search_result_wire()).unwrap(); + let CatalogSearchResult::Succeeded(result) = result else { + panic!("expected successful catalog search, got {result:?}"); + }; + result.candidates +} + +#[test] +fn mcp_candidate_retains_its_variant_and_payload() { + let candidates = search_candidates(); + let candidate = &candidates[0]; + assert!( + matches!(candidate, CatalogCandidate::McpServer(_)), + "expected McpServer, got {candidate:?}" + ); + assert_eq!( + serde_json::to_value(candidate).unwrap(), + search_result_wire()["candidates"][0] + ); +} + +#[test] +fn ai_skill_candidate_retains_its_variant_and_payload() { + let candidates = search_candidates(); + let candidate = &candidates[1]; + assert!( + matches!(candidate, CatalogCandidate::AiSkill(_)), + "expected AiSkill, got {candidate:?}" + ); + assert_eq!( + serde_json::to_value(candidate).unwrap(), + search_result_wire()["candidates"][1] + ); +} + +#[test] +fn plugin_candidate_retains_its_variant_and_payload() { + let wire = json!({ + "kind": "plugin", + "displayName": "Unrequested plugin", + "identity": "urn:github:copilot:plugin:example", + "compatibilityTags": [], + "mediaType": "application/vnd.github.copilot-plugin", + "source": { + "repository": "example/plugins", + "path": "example" + }, + "provenance": { + "authority": "agentfinder.github.com", + "mediaType": "application/vnd.github.copilot-plugin", + "observedAt": "2026-09-02T11:00:00Z" + } + }); + let candidate: CatalogCandidate = serde_json::from_value(wire.clone()).unwrap(); + assert!( + matches!(candidate, CatalogCandidate::Plugin(_)), + "expected Plugin, got {candidate:?}" + ); + assert_eq!(serde_json::to_value(candidate).unwrap(), wire); +} + +#[test] +fn unknown_null_and_missing_candidate_kinds_are_rejected() { + for kind in [Some(json!("future-kind")), Some(Value::Null), None] { + let mut wire = search_result_wire()["candidates"][0].clone(); + if let Some(kind) = kind { + wire["kind"] = kind; + } else { + wire.as_object_mut().unwrap().remove("kind"); + } + assert!( + serde_json::from_value::(wire.clone()).is_err(), + "unexpectedly accepted candidate {wire}" + ); + } +} + +#[test] +fn typed_mcp_candidate_rejects_an_ai_skill_discriminator() { + let wire = search_result_wire()["candidates"][1].clone(); + assert!(serde_json::from_value::(wire).is_err()); +} + +#[test] +fn standalone_enums_still_accept_future_values() { + assert_eq!( + serde_json::from_str::("\"future-kind\"").unwrap(), + CatalogAiSkillCandidateKind::Unknown + ); + assert_eq!( + serde_json::from_str::("\"future-kind\"").unwrap(), + CatalogMcpServerCandidateKind::Unknown + ); + assert_eq!( + serde_json::from_str::("\"future-kind\"").unwrap(), + CatalogAgentPluginCandidateKind::Unknown + ); + assert_eq!( + serde_json::from_str::("\"future-algorithm\"").unwrap(), + CardDigestAlgorithm::Unknown + ); +} + +#[test] +fn unconstrained_mcp_fields_still_accept_future_values() { + let mut wire = search_result_wire()["candidates"][0].clone(); + wire["installability"] = json!("future-installability"); + wire["mediaType"] = json!("application/future-mcp-card"); + wire["provenance"]["mediaType"] = json!("application/future-mcp-card"); + + let candidate: CatalogCandidate = serde_json::from_value(wire).unwrap(); + let CatalogCandidate::McpServer(candidate) = candidate else { + panic!("expected McpServer, got {candidate:?}"); + }; + assert_eq!( + candidate.installability, + CatalogMcpServerInstallability::Unknown + ); + assert_eq!(candidate.media_type, McpServerCardMediaType::Unknown); + assert_eq!( + candidate.provenance.media_type, + McpServerCardMediaType::Unknown + ); +} + +#[test] +fn digest_algorithm_enforces_its_field_constraint() { + let mut wire = json!({ + "algorithm": "sha256-rfc8785", + "value": "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef" + }); + let digest: CardDigest = serde_json::from_value(wire.clone()).unwrap(); + assert_eq!(serde_json::to_value(digest).unwrap(), wire); + + wire["algorithm"] = json!("future-algorithm"); + let error = serde_json::from_value::(wire).unwrap_err(); + assert!(error.to_string().contains("sha256-rfc8785")); +} diff --git a/rust/tests/session_events_test.rs b/rust/tests/session_events_test.rs index 437be9861f..aabdd7f4f4 100644 --- a/rust/tests/session_events_test.rs +++ b/rust/tests/session_events_test.rs @@ -2,7 +2,257 @@ #![allow(clippy::unwrap_used)] -use github_copilot_sdk::session_events::UserMessageData; +use github_copilot_sdk::session_events::{ + IndexedSearchData, PermissionApprovalEvaluation, PermissionApprovalEvaluationEvaluationStage, + PermissionApprovalEvaluationJudgeStatus, PermissionApprovalEvaluationReasonCode, + SandboxDecisionData, SessionEventData, TypedSessionEvent, UserMessageData, +}; + +fn event_envelope(event_type: &str, data: serde_json::Value) -> serde_json::Value { + serde_json::json!({ + "id": "10000000-0000-4000-8000-000000000001", + "timestamp": "2026-09-18T22:00:00Z", + "parentId": "10000000-0000-4000-8000-000000000000", + "ephemeral": true, + "agentId": "test-agent", + "type": event_type, + "data": data + }) +} + +#[test] +fn indexed_search_variants_round_trip_full_event_envelopes() { + let payloads = [ + serde_json::json!({ + "kind": "status", + "state": "ready" + }), + serde_json::json!({ + "kind": "startup", + "outcome": "failed", + "fileCount": 0.0, + "startupDurationMs": 1.25, + "forcedByEnv": false, + "warmStart": false, + "disabledReason": "workspace_not_local", + "errorMessage": "synthetic startup diagnostic", + "eligible": false + }), + serde_json::json!({ + "kind": "server_error", + "errorType": "unexpected_exit", + "exitCode": 0.0, + "errorMessage": "synthetic server diagnostic" + }), + serde_json::json!({ + "kind": "incremental", + "phase": "updated", + "changedFileCount": 0.0, + "addedFileCount": 2.0, + "deletedFileCount": 1.0, + "totalChangeCount": 3.0, + "walkDurationMs": 0.0, + "updateDurationMs": 2.5, + "totalDurationMs": 3.75 + }), + ]; + + for payload in payloads { + let wire = event_envelope("session.indexed_search", payload); + let event: TypedSessionEvent = serde_json::from_value(wire.clone()).unwrap(); + let SessionEventData::SessionIndexedSearch(data) = &event.payload else { + panic!("expected indexed-search event"); + }; + let kind = match data { + IndexedSearchData::Status(_) => "status", + IndexedSearchData::Startup(_) => "startup", + IndexedSearchData::ServerError(_) => "server_error", + IndexedSearchData::Incremental(_) => "incremental", + }; + + assert_eq!(kind, wire["data"]["kind"].as_str().unwrap()); + assert_eq!(serde_json::to_value(event).unwrap(), wire); + } +} + +#[test] +fn sandbox_decision_variants_round_trip_full_event_envelopes() { + let payloads = [ + serde_json::json!({ + "kind": "policy_resolved", + "control": "filesystem", + "outcome": "resolved", + "backend": "bubblewrap", + "policySource": "user_policy", + "readwritePathsCount": 0, + "readonlyPathsCount": 1, + "deniedPathsCount": 0, + "addCurrentWorkingDirectory": false, + "allowOutbound": false, + "allowLocalNetwork": false, + "proxyMode": "none", + "allowBypass": false, + "gitAuth": false, + "ghAuth": false, + "keychainAccess": false, + "effectiveFilesystemPolicy": { + "readwritePaths": [], + "readonlyPaths": ["fixtures"], + "deniedPaths": [] + }, + "degradationReason": "denied_paths_unsupported" + }), + serde_json::json!({ + "kind": "spawn_completed", + "control": "process", + "outcome": "succeeded", + "backend": "bubblewrap", + "durationMs": 0.25 + }), + serde_json::json!({ + "kind": "enforcement_state", + "control": "process", + "outcome": "engaged", + "backend": "bubblewrap", + "attestation": "spawn_succeeded", + "command": "echo synthetic" + }), + serde_json::json!({ + "kind": "access_denied", + "control": "filesystem", + "outcome": "denied", + "denialClass": "filesystem_read", + "attestation": "builtin_policy_checked", + "confidence": "captured", + "deniedResource": "fixtures/restricted.txt", + "command": "cat fixtures/restricted.txt", + "processName": "cat" + }), + serde_json::json!({ + "kind": "bypass_decided", + "control": "bypass", + "outcome": "declined", + "source": "user_prompted", + "denialClass": "network_outbound", + "confidence": "policy_corroborated", + "deniedResource": "example.invalid", + "command": "synthetic-request", + "processName": "test-client" + }), + serde_json::json!({ + "kind": "permissive_retry_decided", + "control": "bypass", + "outcome": "approved", + "source": "model_requested", + "denialClass": "filesystem_read", + "confidence": "sandbox_reported", + "deniedResource": "fixtures/retry.txt", + "command": "cat fixtures/retry.txt", + "processName": "cat" + }), + serde_json::json!({ + "kind": "permissive_retry_completed", + "control": "bypass", + "outcome": "succeeded", + "denialClass": "filesystem_read", + "confidence": "output_classified", + "deniedResource": "fixtures/retry.txt", + "command": "cat fixtures/retry.txt", + "processName": "cat" + }), + ]; + + for mut payload in payloads { + let fields = payload.as_object_mut().unwrap(); + fields.insert("platform".to_string(), serde_json::json!("linux")); + fields.insert("enforcementPoint".to_string(), serde_json::json!("shell")); + fields.insert("toolCallId".to_string(), serde_json::json!("sandbox-tool")); + let wire = event_envelope("sandbox.decision", payload); + let event: TypedSessionEvent = serde_json::from_value(wire.clone()).unwrap(); + let SessionEventData::SandboxDecision(data) = &event.payload else { + panic!("expected sandbox-decision event"); + }; + let kind = match data { + SandboxDecisionData::PolicyResolved(_) => "policy_resolved", + SandboxDecisionData::SpawnCompleted(_) => "spawn_completed", + SandboxDecisionData::EnforcementState(_) => "enforcement_state", + SandboxDecisionData::AccessDenied(_) => "access_denied", + SandboxDecisionData::BypassDecided(_) => "bypass_decided", + SandboxDecisionData::PermissiveRetryDecided(_) => "permissive_retry_decided", + SandboxDecisionData::PermissiveRetryCompleted(_) => "permissive_retry_completed", + }; + + assert_eq!(kind, wire["data"]["kind"].as_str().unwrap()); + assert_eq!(serde_json::to_value(event).unwrap(), wire); + } +} + +#[test] +fn ordinary_and_empty_payloads_round_trip_full_event_envelopes() { + for (event_type, payload) in [ + ( + "user.message", + serde_json::json!({"content": "synthetic message", "messageId": "message-123"}), + ), + ("session.idle", serde_json::json!({})), + ] { + let wire = event_envelope(event_type, payload); + let event: TypedSessionEvent = serde_json::from_value(wire.clone()).unwrap(); + match &event.payload { + SessionEventData::UserMessage(data) => assert_eq!(data.content, "synthetic message"), + SessionEventData::SessionIdle(_) => assert_eq!(event_type, "session.idle"), + _ => panic!("unexpected event variant"), + } + assert_eq!(serde_json::to_value(event).unwrap(), wire); + } +} + +#[test] +fn approval_evaluation_preserves_protocol_unknown_values() { + let wire = serde_json::json!({ + "evaluationStage": "unknown", + "judgeStatus": "unknown", + "reasonCode": "unknown" + }); + let data: PermissionApprovalEvaluation = serde_json::from_value(wire.clone()).unwrap(); + + assert_eq!( + data.evaluation_stage, + PermissionApprovalEvaluationEvaluationStage::UnknownValue + ); + assert_eq!( + data.judge_status, + PermissionApprovalEvaluationJudgeStatus::UnknownValue + ); + assert_eq!( + data.reason_code, + PermissionApprovalEvaluationReasonCode::UnknownValue + ); + assert_eq!(serde_json::to_value(data).unwrap(), wire); +} + +#[test] +fn approval_evaluation_accepts_future_values_without_confusing_them_with_protocol_unknown() { + let data: PermissionApprovalEvaluation = serde_json::from_value(serde_json::json!({ + "evaluationStage": "future-stage", + "judgeStatus": "future-status", + "reasonCode": "future-reason" + })) + .unwrap(); + + assert_eq!( + data.evaluation_stage, + PermissionApprovalEvaluationEvaluationStage::Unknown + ); + assert_eq!( + data.judge_status, + PermissionApprovalEvaluationJudgeStatus::Unknown + ); + assert_eq!( + data.reason_code, + PermissionApprovalEvaluationReasonCode::Unknown + ); +} #[test] fn user_message_id_uses_camel_case_wire_name() { diff --git a/scripts/codegen/csharp.ts b/scripts/codegen/csharp.ts index 747a67b9e5..aa7399290a 100644 --- a/scripts/codegen/csharp.ts +++ b/scripts/codegen/csharp.ts @@ -1388,6 +1388,21 @@ function resolveSessionPropertyType( } function generateDataClass(variant: EventVariant, knownTypes: Map, nestedClasses: Map, enumOutput: string[]): string { + const unionMembers = variant.dataSchema.anyOf ?? variant.dataSchema.oneOf; + if (unionMembers) { + const members = unionMembers + .filter((member): member is JSONSchema7 => typeof member === "object") + .map((member) => resolveObjectSchema(member, sessionDefinitions) ?? member) + .filter((member) => member.type !== "null"); + const discriminator = findDiscriminator(members); + if (!discriminator) { + failUnmappable(`event payload union (${variant.dataClassName})`, variant.dataSchema); + } + return generateDiscriminatedUnionClass( + variant.dataClassName, discriminator, members, knownTypes, nestedClasses, enumOutput, + variant.dataDescription, undefined, variant.dataExperimental, { sealLeafTypes: true } + ); + } const dataVisibility = isSchemaInternal(variant.dataSchema) ? "internal" : "public"; const lines: string[] = []; if (variant.dataDescription) { @@ -1580,6 +1595,7 @@ export async function generateSessionEvents(schemaPath?: string): Promise // ══════════════════════════════════════════════════════════════════════════════ let emittedRpcClassSchemas = new Map(); +const nonSessionRequestTypeNames = new Set(); let emittedRpcEnumResultTypes = new Set(); let experimentalRpcTypes = new Set(); let nonExperimentalRpcTypes = new Set(); @@ -2201,6 +2217,25 @@ function emitSessionRpcClasses(node: Record, classes: string[]) return result; } +function hasSessionRequestEnvelope(schema: JSONSchema7 | undefined): boolean { + if (!schema?.title || !schema.properties?.sessionId) return false; + if (!nonSessionRequestTypeNames.has(schema.title)) return false; + const definition = rpcDefinitions.definitions?.[schema.title] ?? rpcDefinitions.$defs?.[schema.title]; + if (!definition || typeof definition !== "object") return false; + const canonical = resolveObjectSchema(definition, rpcDefinitions); + if (!canonical?.properties || canonical.properties.sessionId) return false; + + // Runtime session params can inherit the canonical request's title while + // adding only the transport sessionId. Separate shared envelopes without + // renaming existing session-only wire types used by handwritten SDK code. + const withoutSession: JSONSchema7 = { + ...schema, + properties: Object.fromEntries(Object.entries(schema.properties).filter(([name]) => name !== "sessionId")), + required: schema.required?.filter((name) => name !== "sessionId"), + }; + return stableStringify(withoutSession) === stableStringify(canonical); +} + function emitSessionMethod(key: string, method: RpcMethod, lines: string[], classes: string[], indent: string, groupExperimental: boolean, groupDeprecated: boolean): void { const methodName = toPascalCase(key); const isInternal = method.visibility === "internal"; @@ -2230,10 +2265,12 @@ function emitSessionMethod(key: string, method: RpcMethod, lines: string[], clas }); const requestClassName = paramsTypeName(method); - const wireRequestClassName = useRequestParameter ? `${requestClassName}WithSession` : requestClassName; + const wireRequestClassName = useRequestParameter || hasSessionRequestEnvelope(effectiveParams) + ? `${requestClassName}WithSession` + : requestClassName; if (method.stability === "experimental" && !nonExperimentalRpcTypes.has(requestClassName)) { experimentalRpcTypes.add(requestClassName); - if (useRequestParameter && !nonExperimentalRpcTypes.has(wireRequestClassName)) { + if (wireRequestClassName !== requestClassName && !nonExperimentalRpcTypes.has(wireRequestClassName)) { experimentalRpcTypes.add(wireRequestClassName); } } @@ -2258,7 +2295,7 @@ function emitSessionMethod(key: string, method: RpcMethod, lines: string[], clas ); if (wireReqClass) classes.push(wireReqClass); } else { - const reqClass = emitRpcClass(requestClassName, effectiveParams, "internal", classes, requestClassName, true); + const reqClass = emitRpcClass(wireRequestClassName, effectiveParams, "internal", classes, requestClassName, true); if (reqClass) classes.push(reqClass); } } @@ -2672,6 +2709,7 @@ export function generateRpcCode( schema = cloneSchemaForCodegen(schema); omitUnrepresentableInternalProperties(schema); emittedRpcClassSchemas.clear(); + nonSessionRequestTypeNames.clear(); emittedRpcEnumResultTypes.clear(); experimentalRpcTypes.clear(); nonExperimentalRpcTypes.clear(); @@ -2681,6 +2719,13 @@ export function generateRpcCode( generatedEnums.clear(); // Clear shared enum deduplication map externalRpcValueTypes = new Set([...externalValueTypes].map(typeToClassName)); rpcDefinitions = collectDefinitionCollections(schema as Record); + for (const method of [ + ...collectRpcMethods(schema.server || {}), + ...collectRpcMethods(filterNodeByVisibility(schema.clientSession || {}, "public") || {}), + ...collectRpcMethods(filterNodeByVisibility(schema.clientGlobal || {}, "public") || {}), + ]) { + nonSessionRequestTypeNames.add(paramsTypeName(method)); + } const allMethods = [ ...collectRpcMethods(schema.server || {}), ...collectRpcMethods(schema.session || {}), diff --git a/scripts/codegen/go.ts b/scripts/codegen/go.ts index 569016cd7c..7dfc4e444c 100644 --- a/scripts/codegen/go.ts +++ b/scripts/codegen/go.ts @@ -580,10 +580,14 @@ function extractGoEventVariants(schema: JSONSchema7): GoEventVariant[] { const typeSchema = variant.properties!.type as JSONSchema7; const typeName = typeSchema?.const as string; if (!typeName) throw new Error("Variant must have type.const"); + const payloadSchema = resolveGoUnionMember( + (variant.properties!.data as JSONSchema7) || {}, + definitionCollections + ); const dataSchema = - resolveObjectSchema(variant.properties!.data as JSONSchema7, definitionCollections) ?? - resolveSchema(variant.properties!.data as JSONSchema7, definitionCollections) ?? - ((variant.properties!.data as JSONSchema7) || {}); + resolveObjectSchema(payloadSchema, definitionCollections) ?? + resolveSchema(payloadSchema, definitionCollections) ?? + payloadSchema; return { typeName, dataClassName: `${toPascalCase(typeName)}Data`, @@ -3197,6 +3201,7 @@ export function generateGoSessionEventsCode( const dataStructs: string[] = []; for (const variant of variants) { const required = new Set(variant.dataSchema.required || []); + const rawUnionPayload = goNonNullUnionMembers(variant.dataSchema).length > 1; const lines: string[] = []; if (variant.dataDescription) { @@ -3210,8 +3215,13 @@ export function generateGoSessionEventsCode( lines.push(`type ${variant.dataClassName} struct {`); const fields: GoStructField[] = []; + if (rawUnionPayload) { + lines.push(`\t// Raw preserves the complete union payload, including unrecognized variants.`); + lines.push(`\tRaw json.RawMessage \`json:"-"\``); + } + const properties = rawUnionPayload ? {} : (variant.dataSchema.properties || {}); - for (const [propName, propSchema] of sortByGoFieldName(Object.entries(variant.dataSchema.properties || {}))) { + for (const [propName, propSchema] of sortByGoFieldName(Object.entries(properties))) { if (typeof propSchema !== "object") continue; const prop = propSchema as JSONSchema7; const isReq = required.has(propName); @@ -3232,7 +3242,19 @@ export function generateGoSessionEventsCode( } lines.push(`}`); - pushGoStructUnmarshalJSON(lines, variant.dataClassName, fields, ctx); + if (rawUnionPayload) { + pushGoEncodingBlock([ + `func (r ${variant.dataClassName}) MarshalJSON() ([]byte, error) {`, + `\treturn json.Marshal(r.Raw)`, + `}`, + ``, + `func (r *${variant.dataClassName}) UnmarshalJSON(data []byte) error {`, + `\treturn json.Unmarshal(data, &r.Raw)`, + `}`, + ], ctx); + } else { + pushGoStructUnmarshalJSON(lines, variant.dataClassName, fields, ctx); + } lines.push(``); const constName = "SessionEventType" + variant.typeName .split(/[._]/) diff --git a/scripts/codegen/python.ts b/scripts/codegen/python.ts index 1941eb4a1e..ca312f3859 100644 --- a/scripts/codegen/python.ts +++ b/scripts/codegen/python.ts @@ -2628,6 +2628,26 @@ export function generatePythonSessionEventsCode(schema: JSONSchema7): string { }; for (const variant of variants) { + const unionMembers = variant.dataSchema.anyOf ?? variant.dataSchema.oneOf; + if (unionMembers) { + const members = unionMembers + .filter((member): member is JSONSchema7 => typeof member === "object") + .map((member) => resolveObjectSchema(member, ctx.definitions) ?? member) + .filter((member) => !isPyNullLikeSchema(member)); + const discriminator = findPyDiscriminator(members); + if (!discriminator) { + throw new Error(`Cannot represent event payload union "${variant.dataClassName}" without a discriminator`); + } + emitPyFlatDiscriminatedUnion( + variant.dataClassName, + discriminator.property, + discriminator.mapping, + ctx, + variant.dataDescription, + variant.dataExperimental + ); + continue; + } emitPyClass( variant.dataClassName, variant.dataSchema, diff --git a/scripts/codegen/rust.ts b/scripts/codegen/rust.ts index 714988cb05..8513b7d772 100644 --- a/scripts/codegen/rust.ts +++ b/scripts/codegen/rust.ts @@ -85,12 +85,6 @@ const STRING_NEWTYPE_OVERRIDES: Record = { requestId: "RequestId", }; -const STRING_ENUM_VARIANT_OVERRIDES: Record> = { - CatalogTrustEligibility: { - unknown: "UnknownValue", - }, -}; - // ── Naming helpers ────────────────────────────────────────────────────────── function toPascalCase(s: string): string { @@ -1020,10 +1014,50 @@ function emitRustStruct( lines.push(` #[serde(rename = "${propName}")]`); } + if (prop.$ref && typeof prop.const === "string") { + lines.push( + ` #[serde(${isReq ? "" : "default, "}deserialize_with = "${typeName}::deserialize_${snakeField}")]`, + ); + } + lines.push(` ${propIsInternal ? "pub(crate)" : "pub"} ${rustField}: ${rustType},`); } lines.push("}"); + const constrainedFields = fields.filter( + ({ prop }) => prop.$ref && typeof prop.const === "string", + ); + if (constrainedFields.length > 0) { + // A referenced enum can accept future values; its containing field must + // still enforce an explicit literal constraint before union selection. + lines.push("", `impl ${typeName} {`); + for (const { propName, prop, isReq, rustType } of constrainedFields) { + const literal = JSON.stringify(prop.const); + lines.push( + ` fn deserialize_${toRustFieldName(propName)}<'de, D>(deserializer: D) -> Result<${rustType}, D::Error>`, + " where", + " D: serde::Deserializer<'de>,", + " {", + ); + if (isReq) { + lines.push(" let value = String::deserialize(deserializer)?;"); + } else { + lines.push( + " let Some(value) = Option::::deserialize(deserializer)? else {", + " return Ok(None);", + " };", + ); + } + lines.push( + ` if value != ${literal} {`, + ` return Err(serde::de::Error::unknown_variant(&value, &[${literal}]));`, + " }", + ` <${stripOption(rustType)}>::deserialize(serde::de::value::StringDeserializer::::new(value))${isReq ? "" : ".map(Some)"}`, + " }", + ); + } + lines.push("}"); + } ctx.structs.push(lines.join("\n")); } @@ -1055,12 +1089,14 @@ function emitRustStringEnum( const usedVariantNames = new Set(); const reservedVariantNames = new Set(["Unknown"]); for (const value of values) { + // Keep the protocol's explicit "unknown" distinct from the serde fallback, + // including anonymous enums whose names depend on their containing type. const variantName = uniqueRustPascalIdentifier( value, usedVariantNames, "Value", reservedVariantNames, - STRING_ENUM_VARIANT_OVERRIDES[enumName]?.[value], + value === "unknown" ? "UnknownValue" : undefined, ); pushRustDoc(lines, enumValueDescriptions?.[value], " "); if (variantName !== value) { @@ -1195,8 +1231,30 @@ export function generateSessionEventsCode(schema: JSONSchema7): string { }, ); - // Generate per-event data structs + // Generate per-event payload types without flattening root unions into empty structs. for (const variant of variants) { + if (getUnionVariants(variant.dataSchema)) { + const payloadType = + tryEmitRustUnion( + variant.dataSchema, + variant.variantName, + "data", + ctx, + ) ?? "serde_json::Value"; + if (payloadType !== variant.dataClassName) { + emitRustTypeAlias( + variant.dataClassName, + variant.dataSchema, + payloadType, + ctx, + variant.description, + ); + if (ctx.nonDefaultableTypes.has(payloadType)) { + ctx.nonDefaultableTypes.add(variant.dataClassName); + } + } + continue; + } emitRustStruct( variant.dataClassName, variant.dataSchema, diff --git a/test/harness/subagentHooksReplay.test.ts b/test/harness/subagentHooksReplay.test.ts index 65c94731f8..f2ce348eac 100644 --- a/test/harness/subagentHooksReplay.test.ts +++ b/test/harness/subagentHooksReplay.test.ts @@ -38,6 +38,32 @@ const rawNotification: NormalizedMessage = { 'Use read_agent with agent_id "fa1ad5a2-aef9-4cd1-996d-85295154e583" to read the results, ' + "or write_agent to send follow-up messages.\n", }; +const shortIdleNotification: NormalizedMessage = { + role: "user", + content: + '\nAgent "read-file" (explore) has finished processing and is now idle.\n', +}; +const shortReadAgent: NormalizedMessage = { + role: "assistant", + tool_calls: [ + { + id: "toolcall_2", + type: "function", + function: { + name: "read_agent", + arguments: '{"agent_id":"read-file","since_turn":0}', + }, + }, + ], +}; +const notifications = [ + { wording: "verbose", notification: rawNotification, readAgent }, + { + wording: "short idle", + notification: shortIdleNotification, + readAgent: shortReadAgent, + }, +]; beforeEach(() => { vi.stubEnv("GITHUB_ACTIONS", "true"); @@ -86,117 +112,160 @@ function expectReply( for (const timing of ["before", "after"] as const) { for (const streaming of [false, true]) { - test(`replays completion ${timing} the parent reply, streaming=${streaming}`, async () => { + test.each(notifications)( + `replays $wording notification ${timing} the parent reply, streaming=${streaming}`, + async ({ notification, readAgent }) => { + const earlyReply = { ...waiting, tool_calls: readAgent.tool_calls }; + const proxy = new ReplayingCapiProxy( + "http://127.0.0.1:1", + snapshotPath, + import.meta.dirname, + ); + const url = await proxy.start(); + const messages = original.slice(0, 5); + const request = () => + fetch(`${url}/chat/completions`, { + method: "POST", + headers: { "content-type": "application/json" }, + body: JSON.stringify({ + model: stored.models[0], + messages, + stream: streaming, + }), + }); + try { + if (timing === "before") messages.push(notification); + const first = await request(); + expect(first.status, await first.clone().text()).toBe(200); + expectReply( + await readReply(first, streaming), + timing === "before" ? earlyReply : waiting, + ); + messages.push(timing === "before" ? earlyReply : waiting); + + if (timing === "after") { + messages.push(notification); + const second = await request(); + expect(second.status, await second.clone().text()).toBe(200); + expectReply(await readReply(second, streaming), readAgent); + messages.push(readAgent); + } + + messages.push(toolResult); + const final = await request(); + expect(final.status, await final.clone().text()).toBe(200); + expectReply(await readReply(final, streaming), finalAnswer); + } finally { + await proxy.stop(true); + } + }, + ); + } + + test.each(notifications)( + `rejects invalid $wording notifications and tool histories with ${timing} completion`, + async ({ notification, readAgent }) => { + const earlyReply = { ...waiting, tool_calls: readAgent.tool_calls }; const proxy = new ReplayingCapiProxy( "http://127.0.0.1:1", snapshotPath, import.meta.dirname, ); const url = await proxy.start(); - const messages = original.slice(0, 5); - const request = () => - fetch(`${url}/chat/completions`, { - method: "POST", - headers: { "content-type": "application/json" }, - body: JSON.stringify({ - model: stored.models[0], - messages, - stream: streaming, - }), - }); + const prefix = [ + ...original.slice(0, 5), + ...(timing === "after" ? [waiting] : []), + ]; + const continuation = [ + ...prefix, + notification, + timing === "before" ? earlyReply : readAgent, + ]; + const malformed = [ + [...prefix, notification, notification], + [ + ...prefix, + { + ...notification, + content: notification.content!.replace("read-file", "other-agent"), + }, + ], + [ + ...prefix.filter((message) => message.tool_call_id !== "toolcall_1"), + notification, + ], + continuation, + [ + ...continuation, + { + ...toolResult, + content: toolResult.content!.replace( + "Hello from subagent test!", + "Wrong file contents!", + ), + }, + ], + [...continuation, toolResult, notification], + ...["has failed", "was cancelled"].map((state) => [ + ...prefix, + { + ...shortIdleNotification, + content: shortIdleNotification.content!.replace( + "has finished processing and is now idle", + state, + ), + }, + ]), + ...["failed", "cancelled"].map((status) => [ + ...continuation, + { + ...toolResult, + content: toolResult.content!.replace( + "status: completed", + `status: ${status}`, + ), + }, + ]), + [ + ...prefix, + notification, + { + ...(timing === "before" ? earlyReply : readAgent), + tool_calls: shortReadAgent.tool_calls!.map((call) => ({ + ...call, + function: { + ...call.function, + arguments: '{"agent_id":"read-file","since_turn":1}', + }, + })), + }, + toolResult, + ], + ]; + const stderr = vi.spyOn(process.stderr, "write").mockReturnValue(true); + const consoleError = vi + .spyOn(console, "error") + .mockImplementation(() => {}); try { - if (timing === "before") messages.push(rawNotification); - const first = await request(); - expect(first.status, await first.clone().text()).toBe(200); - expectReply( - await readReply(first, streaming), - timing === "before" ? earlyReply : waiting, - ); - messages.push(timing === "before" ? earlyReply : waiting); - - if (timing === "after") { - messages.push(rawNotification); - const second = await request(); - expect(second.status, await second.clone().text()).toBe(200); - expectReply(await readReply(second, streaming), readAgent); - messages.push(readAgent); + for (const messages of malformed) { + const response = await fetch(`${url}/chat/completions`, { + method: "POST", + headers: { "content-type": "application/json" }, + body: JSON.stringify({ model: stored.models[0], messages }), + }); + expect(response.status, await response.text()).toBe(500); } - - messages.push(toolResult); - const final = await request(); - expect(final.status, await final.clone().text()).toBe(200); - expectReply(await readReply(final, streaming), finalAnswer); } finally { + stderr.mockRestore(); + consoleError.mockRestore(); await proxy.stop(true); } - }); - } - - test(`rejects duplicate notifications and changed tool histories with ${timing} completion`, async () => { - const proxy = new ReplayingCapiProxy( - "http://127.0.0.1:1", - snapshotPath, - import.meta.dirname, - ); - const url = await proxy.start(); - const prefix = [ - ...original.slice(0, 5), - ...(timing === "after" ? [waiting] : []), - ]; - const continuation = [ - ...prefix, - rawNotification, - timing === "before" ? earlyReply : readAgent, - ]; - const malformed = [ - [...prefix, rawNotification, rawNotification], - [ - ...prefix, - { - ...rawNotification, - content: rawNotification.content!.replace("read-file", "other-agent"), - }, - ], - [ - ...prefix.filter((message) => message.tool_call_id !== "toolcall_1"), - rawNotification, - ], - continuation, - [ - ...continuation, - { - ...toolResult, - content: toolResult.content!.replace( - "Hello from subagent test!", - "Wrong file contents!", - ), - }, - ], - [...continuation, toolResult, rawNotification], - ]; - const stderr = vi.spyOn(process.stderr, "write").mockReturnValue(true); - const consoleError = vi - .spyOn(console, "error") - .mockImplementation(() => {}); - try { - for (const messages of malformed) { - const response = await fetch(`${url}/chat/completions`, { - method: "POST", - headers: { "content-type": "application/json" }, - body: JSON.stringify({ model: stored.models[0], messages }), - }); - expect(response.status, await response.text()).toBe(500); - } - } finally { - stderr.mockRestore(); - consoleError.mockRestore(); - await proxy.stop(true); - } - }); + }, + ); } -test("the early alternative only moves one notification and retains every captured continuation", () => { - expect(stored.conversations).toHaveLength(5); +test("timing and wording alternatives retain the full result and final continuation", () => { + expect(stored.conversations).toHaveLength(7); expect(stored.conversations[4].messages).toEqual([ ...original.slice(0, 5), notification, @@ -204,4 +273,27 @@ test("the early alternative only moves one notification and retains every captur toolResult, finalAnswer, ]); + for (const [originalIndex, alternativeIndex] of [ + [3, 5], + [4, 6], + ]) { + expect(stored.conversations[alternativeIndex].messages).toEqual( + stored.conversations[originalIndex].messages.map((message) => { + if ( + message.role === "user" && + message.content === notification.content + ) { + return shortIdleNotification; + } + if ( + message.tool_calls?.some( + (call) => call.function.name === "read_agent", + ) + ) { + return { ...message, tool_calls: shortReadAgent.tool_calls }; + } + return message; + }), + ); + } }); diff --git a/test/snapshots/subagent_hooks/should_invoke_pretooluse_and_posttooluse_hooks_for_sub_agent_tool_calls.yaml b/test/snapshots/subagent_hooks/should_invoke_pretooluse_and_posttooluse_hooks_for_sub_agent_tool_calls.yaml index 0bfacd6880..7b1c6185c7 100644 --- a/test/snapshots/subagent_hooks/should_invoke_pretooluse_and_posttooluse_hooks_for_sub_agent_tool_calls.yaml +++ b/test/snapshots/subagent_hooks/should_invoke_pretooluse_and_posttooluse_hooks_for_sub_agent_tool_calls.yaml @@ -199,6 +199,145 @@ conversations: ``` + The file contains a single line with the text "Hello from subagent test!". + - role: assistant + content: |- + The explore agent successfully read the file. The contents of **subagent-test.txt** are: + + ``` + Hello from subagent test! + ``` + # CLI 1.0.87 can report idle without retrieval advice. This is not a success + # assertion: the unchanged read_agent result below still supplies the contents. + - messages: + - role: system + content: ${system} + - role: user + content: Use the task tool to spawn an explore agent that reads the file subagent-test.txt in the current directory and + reports its contents. You must use the task tool. + - role: assistant + content: I'll spawn an explore agent to read the file and report its contents. + tool_calls: + - id: toolcall_0 + type: function + function: + name: report_intent + arguments: '{"intent":"Spawning explore agent"}' + - id: toolcall_1 + type: function + function: + name: task + arguments: '{"agent_type":"explore","name":"read-file","description":"Reading subagent-test.txt","prompt":"Read the file + \"subagent-test.txt\" in the current directory (${workdir}) and report its complete contents. Use the + view tool to read the file and provide the full content in your response.","mode":"background"}' + - role: tool + tool_call_id: toolcall_0 + content: Tool 'report_intent' does not exist. + - role: tool + tool_call_id: toolcall_1 + content: "Agent started in background with agent_id: read-file. You'll be notified when it completes. Tell the user + you're waiting and end your response, or continue unrelated work until notified." + - role: assistant + content: I've launched an explore agent to read subagent-test.txt. Waiting for it to complete... + - role: user + content: >- + + + Agent "read-file" (explore) has finished processing and is now idle. + + + - role: assistant + tool_calls: + - id: toolcall_2 + type: function + function: + name: read_agent + arguments: '{"agent_id":"read-file","since_turn":0}' + - role: tool + tool_call_id: toolcall_2 + content: >- + Agent completed. agent_id: read-file, agent_type: explore, status: completed, description: Reading + subagent-test.txt, elapsed: 0s, total_turns: 0, duration: 0s + + + The complete contents of the file "subagent-test.txt" are: + + + ``` + + Hello from subagent test! + + ``` + + + The file contains a single line with the text "Hello from subagent test!". + - role: assistant + content: |- + The explore agent successfully read the file. The contents of **subagent-test.txt** are: + + ``` + Hello from subagent test! + ``` + - messages: + - role: system + content: ${system} + - role: user + content: Use the task tool to spawn an explore agent that reads the file subagent-test.txt in the current directory and + reports its contents. You must use the task tool. + - role: assistant + content: I'll spawn an explore agent to read the file and report its contents. + tool_calls: + - id: toolcall_0 + type: function + function: + name: report_intent + arguments: '{"intent":"Spawning explore agent"}' + - id: toolcall_1 + type: function + function: + name: task + arguments: '{"agent_type":"explore","name":"read-file","description":"Reading subagent-test.txt","prompt":"Read the file + \"subagent-test.txt\" in the current directory (${workdir}) and report its complete contents. Use the + view tool to read the file and provide the full content in your response.","mode":"background"}' + - role: tool + tool_call_id: toolcall_0 + content: Tool 'report_intent' does not exist. + - role: tool + tool_call_id: toolcall_1 + content: "Agent started in background with agent_id: read-file. You'll be notified when it completes. Tell the user + you're waiting and end your response, or continue unrelated work until notified." + - role: user + content: >- + + + Agent "read-file" (explore) has finished processing and is now idle. + + + - role: assistant + content: I've launched an explore agent to read subagent-test.txt. Waiting for it to complete... + tool_calls: + - id: toolcall_2 + type: function + function: + name: read_agent + arguments: '{"agent_id":"read-file","since_turn":0}' + - role: tool + tool_call_id: toolcall_2 + content: >- + Agent completed. agent_id: read-file, agent_type: explore, status: completed, description: Reading + subagent-test.txt, elapsed: 0s, total_turns: 0, duration: 0s + + + The complete contents of the file "subagent-test.txt" are: + + + ``` + + Hello from subagent test! + + ``` + + The file contains a single line with the text "Hello from subagent test!". - role: assistant content: |-