@serviceme/devtools-shared 1.0.0 → 2.0.1

package/dist/index.d.mts

@@ -903,7 +903,8 @@ interface DownloadCertificateBundleRequest {
     format: CertificateBundleFormat;
     /** Override for the export password (PFX / JKS only). When omitted, the
      * extension falls back to the `ms-devtools.certificate.exportPassword`
-     * setting (default "123456", matching `sslkit`). */
+     * setting; when that is unset, a strong random password is generated
+     * per export. */
     password?: string;
 }
 /** Response sent back to the Webview — same shape as the existing PEM bundle
@@ -924,7 +925,8 @@ interface CertificateBundleEnvironmentSupport {
     /** `true` once `keytool` was found on PATH (required only for JKS). */
     jdkAvailable: boolean;
     /** Mirror of `msDevTools.certificate.exportPassword` — surfaces the
-     * effective default so the UI doesn't have to subscribe to config
+     * effective default (the configured value, or a freshly generated
+     * random one when unset) so the UI doesn't have to subscribe to config
      * change events. */
     defaultPassword: string;
 }
@@ -947,6 +949,139 @@ declare const MEDALSOFT_PRIVATE_GATEWAY_URL = "http://10.10.10.249:3000/v1";
 /** Medalsoft 私有 NuGet 源，仅办公网可达。 */
 declare const MEDALSOFT_NUGET_PRIVATE_SOURCE = "http://192.168.20.209:10010/nuget";
 
+type CopilotCustomizationScope = "workspace" | "personal";
+type CopilotCustomizationArtifactKind = "agent" | "skill" | "prompt" | "instruction" | "mcp" | "hook";
+type CopilotCustomizationInstallIntent = "available" | "selected" | "moving" | "removing";
+type CopilotCustomizationHealth = "healthy" | "missing" | "drifted" | "conflict" | "source-unavailable" | "unsupported";
+type CopilotCustomizationGate = "ready" | "approval-required" | "configuration-required";
+type CopilotCustomizationStatus = "healthy" | "action-required" | "blocked" | "not-enabled";
+interface CopilotArtifactStatePayload {
+    intent: CopilotCustomizationInstallIntent;
+    health: CopilotCustomizationHealth;
+    gate: CopilotCustomizationGate;
+}
+interface CopilotArtifactSummaryPayload {
+    id: string;
+    packageId: string;
+    kind: CopilotCustomizationArtifactKind;
+    displayName: string;
+    description?: string;
+    installStrategy: "link" | "generated-config" | "approval-gated";
+    risk: "none" | "review-required";
+}
+interface CopilotPackageInstallationPayload {
+    packageId: string;
+    scope: CopilotCustomizationScope;
+    selectedArtifactIds: string[];
+    pinnedVersion?: string;
+}
+interface CopilotPackageDefinitionPayload {
+    id: string;
+    sourceId: string;
+    displayName: string;
+    description?: string;
+    version?: string;
+    artifacts: CopilotArtifactSummaryPayload[];
+    /** Whole-package registrar installation — the home package list shows
+     * these; per-artifact v1 manifest plugins stay in enabled-content. */
+    wholePackage?: boolean;
+}
+/**
+ * Whole-package registrar install marker: the explicit `wholePackage`
+ * flag, or (legacy shape) the synthetic `::package:` artifact. Such
+ * packages are PERSONAL-scope only — registrar-owned, so per-artifact
+ * scope actions (move to workspace) do not apply.
+ */
+declare function isWholePackageInstall(definition: Pick<CopilotPackageDefinitionPayload, "wholePackage" | "artifacts">): boolean;
+/**
+ * Registrar record id (`repo:plugin`) from a view/package payload id
+ * (`repo::plugin`). Both spellings float around the wire; the registrar
+ * and the settings keys always use the single-colon form.
+ */
+declare function registrationIdFromPackageId(packageId: string): string;
+interface CopilotArtifactViewPayload {
+    artifact: CopilotArtifactSummaryPayload;
+    state: CopilotArtifactStatePayload;
+}
+/**
+ * An installable plugin.json package found by scanning an enabled git
+ * source — NOT yet (necessarily) installed. The CLI enumerates these
+ * via the core plugin catalog and attaches them to the
+ * `copilotCustomizations.list` result; `packageId` is directly usable
+ * as the install input.
+ */
+interface CopilotAvailablePackagePayload {
+    /** `${sourceId}::${pluginId}` — directly usable as the install input. */
+    packageId: string;
+    sourceId: string;
+    displayName: string;
+    description?: string;
+    version?: string;
+    /** Full artifact summaries so the install preview can select artifacts. */
+    artifacts: CopilotArtifactSummaryPayload[];
+    /** Which scopes currently have this packageId installed (may be both). */
+    installedScopes: CopilotCustomizationScope[];
+    /** VS Code enablement (`chat.pluginLocations` value) for registered
+     * packages — overlaid extension-side; `undefined` for not-registered
+     * packages or older extension builds. */
+    enabled?: boolean;
+}
+interface CopilotPackageViewPayload {
+    definition: CopilotPackageDefinitionPayload;
+    installation: CopilotPackageInstallationPayload;
+    artifacts: CopilotArtifactViewPayload[];
+    selectedArtifactCount: number;
+    /** VS Code enablement for whole-package (registrar) rows —
+     * overlaid extension-side; `undefined` for artifact-level packages
+     * or older extension builds. */
+    enabled?: boolean;
+    status: CopilotCustomizationStatus;
+}
+interface CopilotSourceViewPayload {
+    id: string;
+    type: "marketplace" | "git" | "local";
+    displayName: string;
+    updateCapability: "pinned" | "live" | "none";
+    packages: CopilotPackageViewPayload[];
+}
+/** Task 10 — normalized source record for the source manager UI. */
+interface CopilotSourceRecordPayload {
+    id: string;
+    type: "marketplace" | "git" | "local";
+    displayName: string;
+    updateCapability: "pinned" | "live" | "none";
+    /** Whether the source content is currently materialized on disk. */
+    available: boolean;
+    /** Where this source is declared: "workspace" (manifest), "personal" (intent), or both. */
+    declaredIn: Array<"workspace" | "personal">;
+}
+/** Task 10 — deterministic, side-effect-free package update preview. */
+interface CopilotPackageUpdatePreviewPayload {
+    packageId: string;
+    fromVersion?: string;
+    toVersion: string;
+    addedArtifactIds: string[];
+    removedArtifactIds: string[];
+    changedArtifactIds: string[];
+    approvalInvalidatedArtifactIds: string[];
+}
+interface CopilotCustomizationViewPayload {
+    scope: CopilotCustomizationScope;
+    generatedAt: string;
+    sources: CopilotSourceViewPayload[];
+    packages: CopilotPackageViewPayload[];
+    attention: CopilotArtifactViewPayload[];
+    summary: {
+        packageCount: number;
+        enabledArtifactCount: number;
+        attentionCount: number;
+    };
+    legacyMigration?: {
+        count: number;
+        sourceLabel: "~/.agents";
+    };
+}
+
 /**
  * Device-auth wire contract shared by the extension (signer) and the
  * server (verifier).
@@ -1317,6 +1452,10 @@ interface BridgeSkillRepoEntry {
     frontmatter: Record<string, unknown>;
     /** ISO timestamp of the manifest's mtime. */
     modifiedAt: string;
+    /** Machine-local disable mark — true when the entry's link is removed
+     * on this machine while its installation intent stays. Overlaid by
+     * the bridge; absent on older CLIs. */
+    disabled?: boolean;
 }
 /** A single file inside an entry (SkillStore.SkillFile). */
 interface BridgeSkillRepoFile {
@@ -1493,6 +1632,7 @@ declare enum WebviewMessageType {
     InstallSkillRepoEntry = "installSkillRepoEntry",
     ConvertSkillRepoEntryToSymlink = "convertSkillRepoEntryToSymlink",
     UninstallSkillRepoEntry = "uninstallSkillRepoEntry",
+    SetSkillRepoEntryEnabled = "setSkillRepoEntryEnabled",
     ListLinkedSkills = "listLinkedSkills",
     UpdateSkillRepoCatalog = "updateSkillRepoCatalog",
     UpdateSkillRepoInstall = "updateSkillRepoInstall",
@@ -1510,12 +1650,36 @@ declare enum WebviewMessageType {
     DisableRepository = "disableRepository",
     SyncRepository = "syncRepository",
     SyncAllRepositories = "syncAllRepositories",
+    ResetParseCache = "resetParseCache",
+    ListCopilotPlugins = "listCopilotPlugins",
+    RegisterCopilotPlugin = "registerCopilotPlugin",
+    UnregisterCopilotPlugin = "unregisterCopilotPlugin",
+    SetCopilotPluginEnabled = "setCopilotPluginEnabled",
+    GetCopilotContentStatus = "getCopilotContentStatus",
+    RestoreCopilotContent = "restoreCopilotContent",
+    ApproveCopilotContent = "approveCopilotContent",
     UpdateRepositoryList = "updateRepositoryList",
     UpdateRepositoryAdd = "updateRepositoryAdd",
     UpdateRepositoryUpdate = "updateRepositoryUpdate",
     UpdateRepositoryRemove = "updateRepositoryRemove",
     UpdateRepositoryToggle = "updateRepositoryToggle",
     UpdateRepositorySyncResult = "updateRepositorySyncResult",
+    UpdateCopilotContentStatus = "updateCopilotContentStatus",
+    GetCopilotCustomizations = "getCopilotCustomizations",
+    SyncCopilotCustomizations = "syncCopilotCustomizations",
+    UpdateCopilotCustomizations = "updateCopilotCustomizations",
+    InstallCopilotPackage = "installCopilotPackage",
+    MoveCopilotPackage = "moveCopilotPackage",
+    UninstallCopilotPackage = "uninstallCopilotPackage",
+    ListCopilotSources = "listCopilotSources",
+    RemoveCopilotSource = "removeCopilotSource",
+    PreviewCopilotUpdate = "previewCopilotUpdate",
+    UpdateCopilotPackage = "updateCopilotPackage",
+    PreviewCopilotLegacy = "previewCopilotLegacy",
+    MigrateCopilotLegacy = "migrateCopilotLegacy",
+    UpdateCopilotSources = "updateCopilotSources",
+    UpdateCopilotUpdatePreview = "updateCopilotUpdatePreview",
+    UpdateCopilotLegacyPreview = "updateCopilotLegacyPreview",
     GetUtilityModels = "getUtilityModels",
     UtilityModelsResponse = "utilityModelsResponse",
     UpdateUtilityModels = "updateUtilityModels",
@@ -1779,6 +1943,23 @@ type WebviewInboundMessage = {
     type: typeof WebviewMessageType.UpdateLinkedSkills;
     links: LinkedSkillPayloadEntry[];
     kind: "skill" | "agent";
+} | {
+    type: typeof WebviewMessageType.UpdateCopilotContentStatus;
+    entries: CopilotContentStatusEntry[];
+    changed: boolean;
+    workspaceOpen?: boolean;
+} | {
+    type: typeof WebviewMessageType.UpdateCopilotCustomizations;
+    view: CopilotCustomizationViewPayload;
+    /** Installable plugin.json packages from the enabled git
+     * sources. Optional: older CLI builds omit it. */
+    availablePackages?: CopilotAvailablePackagePayload[];
+} | {
+    type: typeof WebviewMessageType.UpdateCopilotSources;
+    sources: CopilotSourceRecordPayload[];
+} | {
+    type: typeof WebviewMessageType.UpdateCopilotUpdatePreview;
+    preview: CopilotPackageUpdatePreviewPayload;
 } | {
     type: typeof WebviewMessageType.UpdateExternalTools;
     tools?: ExternalTool[];
@@ -1819,6 +2000,65 @@ interface LinkedSkillPayloadEntry {
     name: string;
     scope?: string;
 }
+/**
+ * One entry inside the `UpdateCopilotContentStatus.entries` array.
+ * Mirrors the protocol-level `CopilotContentStatusResult` entry shape
+ * (identity + status + optional message) so the webview can render the
+ * reconciliation state without importing the protocol package.
+ */
+interface CopilotContentStatusEntry {
+    identity: string;
+    status: "restored" | "adopted" | "pending_approval" | "missing_source" | "conflict" | "drifted";
+    message?: string;
+}
+/**
+ * Task 7 — webview → extension install intent. Mirrors the Task 3
+ * protocol contract (`copilotContent.package.install`) minus the
+ * private `workspaceDir` field, which the extension handler resolves
+ * itself. `localMode` is REQUIRED for workspace-local sources (the
+ * discovery preview blocks submission until the user picks one) and
+ * is omitted for git / marketplace sources.
+ */
+interface InstallCopilotPackageAction {
+    type: WebviewMessageType.InstallCopilotPackage;
+    scope: "workspace" | "personal";
+    sourceId: string;
+    packageId: string;
+    artifactIds: string[];
+    pinnedVersion?: string;
+    localMode?: "live" | "private-workspace-override";
+}
+/** Task 9 — webview → extension move intent; workspaceDir is resolved extension-side. */
+interface MoveCopilotPackageAction {
+    type: WebviewMessageType.MoveCopilotPackage;
+    packageId: string;
+    from: "workspace" | "personal";
+    to: "workspace" | "personal";
+}
+/** Task 9 — webview → extension uninstall intent; workspaceDir is resolved extension-side. */
+interface UninstallCopilotPackageAction {
+    type: WebviewMessageType.UninstallCopilotPackage;
+    scope: "workspace" | "personal";
+    packageId: string;
+}
+/** Task 10 — webview → extension source list intent; workspaceDir is resolved extension-side. */
+interface ListCopilotSourcesAction {
+    type: WebviewMessageType.ListCopilotSources;
+    scope: "workspace" | "personal";
+}
+/** Task 10 — webview → extension source removal intent; workspaceDir is resolved extension-side. */
+interface RemoveCopilotSourceAction {
+    type: WebviewMessageType.RemoveCopilotSource;
+    scope: "workspace" | "personal";
+    sourceId: string;
+}
+/** Task 10 — webview → extension update preview intent; workspaceDir is resolved extension-side. */
+interface PreviewCopilotUpdateAction {
+    type: WebviewMessageType.PreviewCopilotUpdate;
+    scope: "workspace" | "personal";
+    packageId: string;
+    revision: string;
+}
 
 /** Live execution state pushed to webview during task execution */
 interface TaskExecutionState {
@@ -1879,4 +2119,4 @@ declare function asAbortSignal(input: unknown): AbortSignal | undefined;
  */
 declare function safeJson<T>(text: string, fallback: T): T;
 
-export { type AIModelConfig, type AIModelInfo, type AgentPermissionSummary, type AgentToolPermission, type AgentToolRiskLevel, type ApiConfig, type AzureProfile, BUILTIN_PROVIDER_PRESETS, type BalanceEntry, type BridgeLinkMode, type BridgeLinkedSkill, type BridgeRepoEntry, type BridgeRepoSyncPull, type BridgeSkillKind, type BridgeSkillRepoEntry, type BridgeSkillRepoFile, type ByomProviderToggles, ByomSettingsResponse, type ByomSettingsSnapshot, type ByomTogglePayload, CERTIFICATE_BUNDLE_FORMATS, CachedServerUrlResponse, type CachedServerUrlSnapshot, type CertificateBundleEnvironmentSupport, type CertificateBundleFormat, type CertificateBundleFormatDescriptor, type CodingPlanUsage, type CommandPayload, type CuratedModelMetadata, type DeepseekBalanceEntry, type DeepseekUsage, DeviceAuthHeaders, type DeviceRequestSignatureParams, type DownloadCertificateBundleRequest, type DownloadCertificateBundleResponse, type ExternalTool, GIT_REMOTE_HOST_ALIASES, type GenericBalanceUsage, GetByomSettings, GetCachedServerUrl, GetServerProxyState, GetUtilityModels, type GitHubOrgMembershipCheckResult, type GitHubOrgMembershipStatus, type GitHubUser, type GithubCopilotCliPayload, type HttpRequestPayload, type ILogger, LISTABLE_PRESET_MODELS, type LinkedSkillPayloadEntry, LogLevel, MEDALSOFT_NUGET_PRIVATE_SOURCE, MEDALSOFT_PRIVATE_GATEWAY_URL, MODEL_METADATA, type MinimaxUsage, type ModelDetail, type ModelPriceCategory, type ModelPricing, type ModelThinkingSchema, NAMESPACE_ALIASES, NAMESPACE_ALIAS_FAMILY, PRESET_MODEL_FAMILIES, PROVIDER_BASE_URL_PRESETS, PROVIDER_CACHE_CONTROL_METADATA, type PresetModelFamilyGroup, type PresetModelListing, type ProviderBaseUrlPreset, type ProviderCacheControlMetadata, type ProviderConfig, type ProviderModel, type ProviderMutationPayload, type ProviderTestResult, type ProviderType, type ProviderUsageData, type ProviderUsageKind, type ProviderUsageResult, type ProviderVisionMode, type ProviderWireProtocol, type ProvidersResponsePayload, type PublicProvider, type ScheduledTask, type ScheduledTaskType, type ScheduledTaskV1, type ScheduledTasksConfig, type ScheduledTasksLogFile, type ServerProxyAllowOverridePayload, type ServerProxySnapshot, ServerProxyStateResponse, type ServerProxySupportMode, type ServerProxyTogglePayload, SetCacheControlEnabled, SetServerProxyAllowOverride, SetServerProxyEnabled, type ShellPayload, type TaskExecutionLog, type TaskExecutionState, type TaskExecutionStatus, type TaskPayload, type TaskRunStatus, type TaskWorkspaceRef, UpdateUtilityModels, type UpdateUtilityModelsPayload, type UsageWindow, type UtilityModelScope, type UtilityModelsEffective, UtilityModelsResponse, type UtilityModelsSnapshot, type UtilityModelsSource, type WebviewInboundMessage, WebviewMessageType, __internal, asAbortSignal, buildGitHubLocalEmail, buildPresetModel, checkGitHubOrgMembership, createConsoleLogger, createDeviceRequestSignature, currencyForBaseUrl, effectiveAdapterType, fetchGitHubUser, getBuiltinProviderPreset, getGitHubOrgMembership, getPresetModelDisplayName, getProviderBaseUrlPresets, isGitHubLocalEmail, isProviderCacheControlAware, isValidCanonicalSlug, listPresetModelGroups, lookupModelMetadata, normalizeCanonicalSlug, normalizeErrorForLog, normalizeGitUrl, parsePayload, protocolForBaseUrl, resolvePrimaryEmail, safeJson, unionProviderModelWithPreset };
+export { type AIModelConfig, type AIModelInfo, type AgentPermissionSummary, type AgentToolPermission, type AgentToolRiskLevel, type ApiConfig, type AzureProfile, BUILTIN_PROVIDER_PRESETS, type BalanceEntry, type BridgeLinkMode, type BridgeLinkedSkill, type BridgeRepoEntry, type BridgeRepoSyncPull, type BridgeSkillKind, type BridgeSkillRepoEntry, type BridgeSkillRepoFile, type ByomProviderToggles, ByomSettingsResponse, type ByomSettingsSnapshot, type ByomTogglePayload, CERTIFICATE_BUNDLE_FORMATS, CachedServerUrlResponse, type CachedServerUrlSnapshot, type CertificateBundleEnvironmentSupport, type CertificateBundleFormat, type CertificateBundleFormatDescriptor, type CodingPlanUsage, type CommandPayload, type CopilotArtifactStatePayload, type CopilotArtifactSummaryPayload, type CopilotArtifactViewPayload, type CopilotAvailablePackagePayload, type CopilotContentStatusEntry, type CopilotCustomizationArtifactKind, type CopilotCustomizationGate, type CopilotCustomizationHealth, type CopilotCustomizationInstallIntent, type CopilotCustomizationScope, type CopilotCustomizationStatus, type CopilotCustomizationViewPayload, type CopilotPackageDefinitionPayload, type CopilotPackageInstallationPayload, type CopilotPackageUpdatePreviewPayload, type CopilotPackageViewPayload, type CopilotSourceRecordPayload, type CopilotSourceViewPayload, type CuratedModelMetadata, type DeepseekBalanceEntry, type DeepseekUsage, DeviceAuthHeaders, type DeviceRequestSignatureParams, type DownloadCertificateBundleRequest, type DownloadCertificateBundleResponse, type ExternalTool, GIT_REMOTE_HOST_ALIASES, type GenericBalanceUsage, GetByomSettings, GetCachedServerUrl, GetServerProxyState, GetUtilityModels, type GitHubOrgMembershipCheckResult, type GitHubOrgMembershipStatus, type GitHubUser, type GithubCopilotCliPayload, type HttpRequestPayload, type ILogger, type InstallCopilotPackageAction, LISTABLE_PRESET_MODELS, type LinkedSkillPayloadEntry, type ListCopilotSourcesAction, LogLevel, MEDALSOFT_NUGET_PRIVATE_SOURCE, MEDALSOFT_PRIVATE_GATEWAY_URL, MODEL_METADATA, type MinimaxUsage, type ModelDetail, type ModelPriceCategory, type ModelPricing, type ModelThinkingSchema, type MoveCopilotPackageAction, NAMESPACE_ALIASES, NAMESPACE_ALIAS_FAMILY, PRESET_MODEL_FAMILIES, PROVIDER_BASE_URL_PRESETS, PROVIDER_CACHE_CONTROL_METADATA, type PresetModelFamilyGroup, type PresetModelListing, type PreviewCopilotUpdateAction, type ProviderBaseUrlPreset, type ProviderCacheControlMetadata, type ProviderConfig, type ProviderModel, type ProviderMutationPayload, type ProviderTestResult, type ProviderType, type ProviderUsageData, type ProviderUsageKind, type ProviderUsageResult, type ProviderVisionMode, type ProviderWireProtocol, type ProvidersResponsePayload, type PublicProvider, type RemoveCopilotSourceAction, type ScheduledTask, type ScheduledTaskType, type ScheduledTaskV1, type ScheduledTasksConfig, type ScheduledTasksLogFile, type ServerProxyAllowOverridePayload, type ServerProxySnapshot, ServerProxyStateResponse, type ServerProxySupportMode, type ServerProxyTogglePayload, SetCacheControlEnabled, SetServerProxyAllowOverride, SetServerProxyEnabled, type ShellPayload, type TaskExecutionLog, type TaskExecutionState, type TaskExecutionStatus, type TaskPayload, type TaskRunStatus, type TaskWorkspaceRef, type UninstallCopilotPackageAction, UpdateUtilityModels, type UpdateUtilityModelsPayload, type UsageWindow, type UtilityModelScope, type UtilityModelsEffective, UtilityModelsResponse, type UtilityModelsSnapshot, type UtilityModelsSource, type WebviewInboundMessage, WebviewMessageType, __internal, asAbortSignal, buildGitHubLocalEmail, buildPresetModel, checkGitHubOrgMembership, createConsoleLogger, createDeviceRequestSignature, currencyForBaseUrl, effectiveAdapterType, fetchGitHubUser, getBuiltinProviderPreset, getGitHubOrgMembership, getPresetModelDisplayName, getProviderBaseUrlPresets, isGitHubLocalEmail, isProviderCacheControlAware, isValidCanonicalSlug, isWholePackageInstall, listPresetModelGroups, lookupModelMetadata, normalizeCanonicalSlug, normalizeErrorForLog, normalizeGitUrl, parsePayload, protocolForBaseUrl, registrationIdFromPackageId, resolvePrimaryEmail, safeJson, unionProviderModelWithPreset };

package/dist/index.d.ts

@@ -903,7 +903,8 @@ interface DownloadCertificateBundleRequest {
     format: CertificateBundleFormat;
     /** Override for the export password (PFX / JKS only). When omitted, the
      * extension falls back to the `ms-devtools.certificate.exportPassword`
-     * setting (default "123456", matching `sslkit`). */
+     * setting; when that is unset, a strong random password is generated
+     * per export. */
     password?: string;
 }
 /** Response sent back to the Webview — same shape as the existing PEM bundle
@@ -924,7 +925,8 @@ interface CertificateBundleEnvironmentSupport {
     /** `true` once `keytool` was found on PATH (required only for JKS). */
     jdkAvailable: boolean;
     /** Mirror of `msDevTools.certificate.exportPassword` — surfaces the
-     * effective default so the UI doesn't have to subscribe to config
+     * effective default (the configured value, or a freshly generated
+     * random one when unset) so the UI doesn't have to subscribe to config
      * change events. */
     defaultPassword: string;
 }
@@ -947,6 +949,139 @@ declare const MEDALSOFT_PRIVATE_GATEWAY_URL = "http://10.10.10.249:3000/v1";
 /** Medalsoft 私有 NuGet 源，仅办公网可达。 */
 declare const MEDALSOFT_NUGET_PRIVATE_SOURCE = "http://192.168.20.209:10010/nuget";
 
+type CopilotCustomizationScope = "workspace" | "personal";
+type CopilotCustomizationArtifactKind = "agent" | "skill" | "prompt" | "instruction" | "mcp" | "hook";
+type CopilotCustomizationInstallIntent = "available" | "selected" | "moving" | "removing";
+type CopilotCustomizationHealth = "healthy" | "missing" | "drifted" | "conflict" | "source-unavailable" | "unsupported";
+type CopilotCustomizationGate = "ready" | "approval-required" | "configuration-required";
+type CopilotCustomizationStatus = "healthy" | "action-required" | "blocked" | "not-enabled";
+interface CopilotArtifactStatePayload {
+    intent: CopilotCustomizationInstallIntent;
+    health: CopilotCustomizationHealth;
+    gate: CopilotCustomizationGate;
+}
+interface CopilotArtifactSummaryPayload {
+    id: string;
+    packageId: string;
+    kind: CopilotCustomizationArtifactKind;
+    displayName: string;
+    description?: string;
+    installStrategy: "link" | "generated-config" | "approval-gated";
+    risk: "none" | "review-required";
+}
+interface CopilotPackageInstallationPayload {
+    packageId: string;
+    scope: CopilotCustomizationScope;
+    selectedArtifactIds: string[];
+    pinnedVersion?: string;
+}
+interface CopilotPackageDefinitionPayload {
+    id: string;
+    sourceId: string;
+    displayName: string;
+    description?: string;
+    version?: string;
+    artifacts: CopilotArtifactSummaryPayload[];
+    /** Whole-package registrar installation — the home package list shows
+     * these; per-artifact v1 manifest plugins stay in enabled-content. */
+    wholePackage?: boolean;
+}
+/**
+ * Whole-package registrar install marker: the explicit `wholePackage`
+ * flag, or (legacy shape) the synthetic `::package:` artifact. Such
+ * packages are PERSONAL-scope only — registrar-owned, so per-artifact
+ * scope actions (move to workspace) do not apply.
+ */
+declare function isWholePackageInstall(definition: Pick<CopilotPackageDefinitionPayload, "wholePackage" | "artifacts">): boolean;
+/**
+ * Registrar record id (`repo:plugin`) from a view/package payload id
+ * (`repo::plugin`). Both spellings float around the wire; the registrar
+ * and the settings keys always use the single-colon form.
+ */
+declare function registrationIdFromPackageId(packageId: string): string;
+interface CopilotArtifactViewPayload {
+    artifact: CopilotArtifactSummaryPayload;
+    state: CopilotArtifactStatePayload;
+}
+/**
+ * An installable plugin.json package found by scanning an enabled git
+ * source — NOT yet (necessarily) installed. The CLI enumerates these
+ * via the core plugin catalog and attaches them to the
+ * `copilotCustomizations.list` result; `packageId` is directly usable
+ * as the install input.
+ */
+interface CopilotAvailablePackagePayload {
+    /** `${sourceId}::${pluginId}` — directly usable as the install input. */
+    packageId: string;
+    sourceId: string;
+    displayName: string;
+    description?: string;
+    version?: string;
+    /** Full artifact summaries so the install preview can select artifacts. */
+    artifacts: CopilotArtifactSummaryPayload[];
+    /** Which scopes currently have this packageId installed (may be both). */
+    installedScopes: CopilotCustomizationScope[];
+    /** VS Code enablement (`chat.pluginLocations` value) for registered
+     * packages — overlaid extension-side; `undefined` for not-registered
+     * packages or older extension builds. */
+    enabled?: boolean;
+}
+interface CopilotPackageViewPayload {
+    definition: CopilotPackageDefinitionPayload;
+    installation: CopilotPackageInstallationPayload;
+    artifacts: CopilotArtifactViewPayload[];
+    selectedArtifactCount: number;
+    /** VS Code enablement for whole-package (registrar) rows —
+     * overlaid extension-side; `undefined` for artifact-level packages
+     * or older extension builds. */
+    enabled?: boolean;
+    status: CopilotCustomizationStatus;
+}
+interface CopilotSourceViewPayload {
+    id: string;
+    type: "marketplace" | "git" | "local";
+    displayName: string;
+    updateCapability: "pinned" | "live" | "none";
+    packages: CopilotPackageViewPayload[];
+}
+/** Task 10 — normalized source record for the source manager UI. */
+interface CopilotSourceRecordPayload {
+    id: string;
+    type: "marketplace" | "git" | "local";
+    displayName: string;
+    updateCapability: "pinned" | "live" | "none";
+    /** Whether the source content is currently materialized on disk. */
+    available: boolean;
+    /** Where this source is declared: "workspace" (manifest), "personal" (intent), or both. */
+    declaredIn: Array<"workspace" | "personal">;
+}
+/** Task 10 — deterministic, side-effect-free package update preview. */
+interface CopilotPackageUpdatePreviewPayload {
+    packageId: string;
+    fromVersion?: string;
+    toVersion: string;
+    addedArtifactIds: string[];
+    removedArtifactIds: string[];
+    changedArtifactIds: string[];
+    approvalInvalidatedArtifactIds: string[];
+}
+interface CopilotCustomizationViewPayload {
+    scope: CopilotCustomizationScope;
+    generatedAt: string;
+    sources: CopilotSourceViewPayload[];
+    packages: CopilotPackageViewPayload[];
+    attention: CopilotArtifactViewPayload[];
+    summary: {
+        packageCount: number;
+        enabledArtifactCount: number;
+        attentionCount: number;
+    };
+    legacyMigration?: {
+        count: number;
+        sourceLabel: "~/.agents";
+    };
+}
+
 /**
  * Device-auth wire contract shared by the extension (signer) and the
  * server (verifier).
@@ -1317,6 +1452,10 @@ interface BridgeSkillRepoEntry {
     frontmatter: Record<string, unknown>;
     /** ISO timestamp of the manifest's mtime. */
     modifiedAt: string;
+    /** Machine-local disable mark — true when the entry's link is removed
+     * on this machine while its installation intent stays. Overlaid by
+     * the bridge; absent on older CLIs. */
+    disabled?: boolean;
 }
 /** A single file inside an entry (SkillStore.SkillFile). */
 interface BridgeSkillRepoFile {
@@ -1493,6 +1632,7 @@ declare enum WebviewMessageType {
     InstallSkillRepoEntry = "installSkillRepoEntry",
     ConvertSkillRepoEntryToSymlink = "convertSkillRepoEntryToSymlink",
     UninstallSkillRepoEntry = "uninstallSkillRepoEntry",
+    SetSkillRepoEntryEnabled = "setSkillRepoEntryEnabled",
     ListLinkedSkills = "listLinkedSkills",
     UpdateSkillRepoCatalog = "updateSkillRepoCatalog",
     UpdateSkillRepoInstall = "updateSkillRepoInstall",
@@ -1510,12 +1650,36 @@ declare enum WebviewMessageType {
     DisableRepository = "disableRepository",
     SyncRepository = "syncRepository",
     SyncAllRepositories = "syncAllRepositories",
+    ResetParseCache = "resetParseCache",
+    ListCopilotPlugins = "listCopilotPlugins",
+    RegisterCopilotPlugin = "registerCopilotPlugin",
+    UnregisterCopilotPlugin = "unregisterCopilotPlugin",
+    SetCopilotPluginEnabled = "setCopilotPluginEnabled",
+    GetCopilotContentStatus = "getCopilotContentStatus",
+    RestoreCopilotContent = "restoreCopilotContent",
+    ApproveCopilotContent = "approveCopilotContent",
     UpdateRepositoryList = "updateRepositoryList",
     UpdateRepositoryAdd = "updateRepositoryAdd",
     UpdateRepositoryUpdate = "updateRepositoryUpdate",
     UpdateRepositoryRemove = "updateRepositoryRemove",
     UpdateRepositoryToggle = "updateRepositoryToggle",
     UpdateRepositorySyncResult = "updateRepositorySyncResult",
+    UpdateCopilotContentStatus = "updateCopilotContentStatus",
+    GetCopilotCustomizations = "getCopilotCustomizations",
+    SyncCopilotCustomizations = "syncCopilotCustomizations",
+    UpdateCopilotCustomizations = "updateCopilotCustomizations",
+    InstallCopilotPackage = "installCopilotPackage",
+    MoveCopilotPackage = "moveCopilotPackage",
+    UninstallCopilotPackage = "uninstallCopilotPackage",
+    ListCopilotSources = "listCopilotSources",
+    RemoveCopilotSource = "removeCopilotSource",
+    PreviewCopilotUpdate = "previewCopilotUpdate",
+    UpdateCopilotPackage = "updateCopilotPackage",
+    PreviewCopilotLegacy = "previewCopilotLegacy",
+    MigrateCopilotLegacy = "migrateCopilotLegacy",
+    UpdateCopilotSources = "updateCopilotSources",
+    UpdateCopilotUpdatePreview = "updateCopilotUpdatePreview",
+    UpdateCopilotLegacyPreview = "updateCopilotLegacyPreview",
     GetUtilityModels = "getUtilityModels",
     UtilityModelsResponse = "utilityModelsResponse",
     UpdateUtilityModels = "updateUtilityModels",
@@ -1779,6 +1943,23 @@ type WebviewInboundMessage = {
     type: typeof WebviewMessageType.UpdateLinkedSkills;
     links: LinkedSkillPayloadEntry[];
     kind: "skill" | "agent";
+} | {
+    type: typeof WebviewMessageType.UpdateCopilotContentStatus;
+    entries: CopilotContentStatusEntry[];
+    changed: boolean;
+    workspaceOpen?: boolean;
+} | {
+    type: typeof WebviewMessageType.UpdateCopilotCustomizations;
+    view: CopilotCustomizationViewPayload;
+    /** Installable plugin.json packages from the enabled git
+     * sources. Optional: older CLI builds omit it. */
+    availablePackages?: CopilotAvailablePackagePayload[];
+} | {
+    type: typeof WebviewMessageType.UpdateCopilotSources;
+    sources: CopilotSourceRecordPayload[];
+} | {
+    type: typeof WebviewMessageType.UpdateCopilotUpdatePreview;
+    preview: CopilotPackageUpdatePreviewPayload;
 } | {
     type: typeof WebviewMessageType.UpdateExternalTools;
     tools?: ExternalTool[];
@@ -1819,6 +2000,65 @@ interface LinkedSkillPayloadEntry {
     name: string;
     scope?: string;
 }
+/**
+ * One entry inside the `UpdateCopilotContentStatus.entries` array.
+ * Mirrors the protocol-level `CopilotContentStatusResult` entry shape
+ * (identity + status + optional message) so the webview can render the
+ * reconciliation state without importing the protocol package.
+ */
+interface CopilotContentStatusEntry {
+    identity: string;
+    status: "restored" | "adopted" | "pending_approval" | "missing_source" | "conflict" | "drifted";
+    message?: string;
+}
+/**
+ * Task 7 — webview → extension install intent. Mirrors the Task 3
+ * protocol contract (`copilotContent.package.install`) minus the
+ * private `workspaceDir` field, which the extension handler resolves
+ * itself. `localMode` is REQUIRED for workspace-local sources (the
+ * discovery preview blocks submission until the user picks one) and
+ * is omitted for git / marketplace sources.
+ */
+interface InstallCopilotPackageAction {
+    type: WebviewMessageType.InstallCopilotPackage;
+    scope: "workspace" | "personal";
+    sourceId: string;
+    packageId: string;
+    artifactIds: string[];
+    pinnedVersion?: string;
+    localMode?: "live" | "private-workspace-override";
+}
+/** Task 9 — webview → extension move intent; workspaceDir is resolved extension-side. */
+interface MoveCopilotPackageAction {
+    type: WebviewMessageType.MoveCopilotPackage;
+    packageId: string;
+    from: "workspace" | "personal";
+    to: "workspace" | "personal";
+}
+/** Task 9 — webview → extension uninstall intent; workspaceDir is resolved extension-side. */
+interface UninstallCopilotPackageAction {
+    type: WebviewMessageType.UninstallCopilotPackage;
+    scope: "workspace" | "personal";
+    packageId: string;
+}
+/** Task 10 — webview → extension source list intent; workspaceDir is resolved extension-side. */
+interface ListCopilotSourcesAction {
+    type: WebviewMessageType.ListCopilotSources;
+    scope: "workspace" | "personal";
+}
+/** Task 10 — webview → extension source removal intent; workspaceDir is resolved extension-side. */
+interface RemoveCopilotSourceAction {
+    type: WebviewMessageType.RemoveCopilotSource;
+    scope: "workspace" | "personal";
+    sourceId: string;
+}
+/** Task 10 — webview → extension update preview intent; workspaceDir is resolved extension-side. */
+interface PreviewCopilotUpdateAction {
+    type: WebviewMessageType.PreviewCopilotUpdate;
+    scope: "workspace" | "personal";
+    packageId: string;
+    revision: string;
+}
 
 /** Live execution state pushed to webview during task execution */
 interface TaskExecutionState {
@@ -1879,4 +2119,4 @@ declare function asAbortSignal(input: unknown): AbortSignal | undefined;
  */
 declare function safeJson<T>(text: string, fallback: T): T;
 
-export { type AIModelConfig, type AIModelInfo, type AgentPermissionSummary, type AgentToolPermission, type AgentToolRiskLevel, type ApiConfig, type AzureProfile, BUILTIN_PROVIDER_PRESETS, type BalanceEntry, type BridgeLinkMode, type BridgeLinkedSkill, type BridgeRepoEntry, type BridgeRepoSyncPull, type BridgeSkillKind, type BridgeSkillRepoEntry, type BridgeSkillRepoFile, type ByomProviderToggles, ByomSettingsResponse, type ByomSettingsSnapshot, type ByomTogglePayload, CERTIFICATE_BUNDLE_FORMATS, CachedServerUrlResponse, type CachedServerUrlSnapshot, type CertificateBundleEnvironmentSupport, type CertificateBundleFormat, type CertificateBundleFormatDescriptor, type CodingPlanUsage, type CommandPayload, type CuratedModelMetadata, type DeepseekBalanceEntry, type DeepseekUsage, DeviceAuthHeaders, type DeviceRequestSignatureParams, type DownloadCertificateBundleRequest, type DownloadCertificateBundleResponse, type ExternalTool, GIT_REMOTE_HOST_ALIASES, type GenericBalanceUsage, GetByomSettings, GetCachedServerUrl, GetServerProxyState, GetUtilityModels, type GitHubOrgMembershipCheckResult, type GitHubOrgMembershipStatus, type GitHubUser, type GithubCopilotCliPayload, type HttpRequestPayload, type ILogger, LISTABLE_PRESET_MODELS, type LinkedSkillPayloadEntry, LogLevel, MEDALSOFT_NUGET_PRIVATE_SOURCE, MEDALSOFT_PRIVATE_GATEWAY_URL, MODEL_METADATA, type MinimaxUsage, type ModelDetail, type ModelPriceCategory, type ModelPricing, type ModelThinkingSchema, NAMESPACE_ALIASES, NAMESPACE_ALIAS_FAMILY, PRESET_MODEL_FAMILIES, PROVIDER_BASE_URL_PRESETS, PROVIDER_CACHE_CONTROL_METADATA, type PresetModelFamilyGroup, type PresetModelListing, type ProviderBaseUrlPreset, type ProviderCacheControlMetadata, type ProviderConfig, type ProviderModel, type ProviderMutationPayload, type ProviderTestResult, type ProviderType, type ProviderUsageData, type ProviderUsageKind, type ProviderUsageResult, type ProviderVisionMode, type ProviderWireProtocol, type ProvidersResponsePayload, type PublicProvider, type ScheduledTask, type ScheduledTaskType, type ScheduledTaskV1, type ScheduledTasksConfig, type ScheduledTasksLogFile, type ServerProxyAllowOverridePayload, type ServerProxySnapshot, ServerProxyStateResponse, type ServerProxySupportMode, type ServerProxyTogglePayload, SetCacheControlEnabled, SetServerProxyAllowOverride, SetServerProxyEnabled, type ShellPayload, type TaskExecutionLog, type TaskExecutionState, type TaskExecutionStatus, type TaskPayload, type TaskRunStatus, type TaskWorkspaceRef, UpdateUtilityModels, type UpdateUtilityModelsPayload, type UsageWindow, type UtilityModelScope, type UtilityModelsEffective, UtilityModelsResponse, type UtilityModelsSnapshot, type UtilityModelsSource, type WebviewInboundMessage, WebviewMessageType, __internal, asAbortSignal, buildGitHubLocalEmail, buildPresetModel, checkGitHubOrgMembership, createConsoleLogger, createDeviceRequestSignature, currencyForBaseUrl, effectiveAdapterType, fetchGitHubUser, getBuiltinProviderPreset, getGitHubOrgMembership, getPresetModelDisplayName, getProviderBaseUrlPresets, isGitHubLocalEmail, isProviderCacheControlAware, isValidCanonicalSlug, listPresetModelGroups, lookupModelMetadata, normalizeCanonicalSlug, normalizeErrorForLog, normalizeGitUrl, parsePayload, protocolForBaseUrl, resolvePrimaryEmail, safeJson, unionProviderModelWithPreset };
+export { type AIModelConfig, type AIModelInfo, type AgentPermissionSummary, type AgentToolPermission, type AgentToolRiskLevel, type ApiConfig, type AzureProfile, BUILTIN_PROVIDER_PRESETS, type BalanceEntry, type BridgeLinkMode, type BridgeLinkedSkill, type BridgeRepoEntry, type BridgeRepoSyncPull, type BridgeSkillKind, type BridgeSkillRepoEntry, type BridgeSkillRepoFile, type ByomProviderToggles, ByomSettingsResponse, type ByomSettingsSnapshot, type ByomTogglePayload, CERTIFICATE_BUNDLE_FORMATS, CachedServerUrlResponse, type CachedServerUrlSnapshot, type CertificateBundleEnvironmentSupport, type CertificateBundleFormat, type CertificateBundleFormatDescriptor, type CodingPlanUsage, type CommandPayload, type CopilotArtifactStatePayload, type CopilotArtifactSummaryPayload, type CopilotArtifactViewPayload, type CopilotAvailablePackagePayload, type CopilotContentStatusEntry, type CopilotCustomizationArtifactKind, type CopilotCustomizationGate, type CopilotCustomizationHealth, type CopilotCustomizationInstallIntent, type CopilotCustomizationScope, type CopilotCustomizationStatus, type CopilotCustomizationViewPayload, type CopilotPackageDefinitionPayload, type CopilotPackageInstallationPayload, type CopilotPackageUpdatePreviewPayload, type CopilotPackageViewPayload, type CopilotSourceRecordPayload, type CopilotSourceViewPayload, type CuratedModelMetadata, type DeepseekBalanceEntry, type DeepseekUsage, DeviceAuthHeaders, type DeviceRequestSignatureParams, type DownloadCertificateBundleRequest, type DownloadCertificateBundleResponse, type ExternalTool, GIT_REMOTE_HOST_ALIASES, type GenericBalanceUsage, GetByomSettings, GetCachedServerUrl, GetServerProxyState, GetUtilityModels, type GitHubOrgMembershipCheckResult, type GitHubOrgMembershipStatus, type GitHubUser, type GithubCopilotCliPayload, type HttpRequestPayload, type ILogger, type InstallCopilotPackageAction, LISTABLE_PRESET_MODELS, type LinkedSkillPayloadEntry, type ListCopilotSourcesAction, LogLevel, MEDALSOFT_NUGET_PRIVATE_SOURCE, MEDALSOFT_PRIVATE_GATEWAY_URL, MODEL_METADATA, type MinimaxUsage, type ModelDetail, type ModelPriceCategory, type ModelPricing, type ModelThinkingSchema, type MoveCopilotPackageAction, NAMESPACE_ALIASES, NAMESPACE_ALIAS_FAMILY, PRESET_MODEL_FAMILIES, PROVIDER_BASE_URL_PRESETS, PROVIDER_CACHE_CONTROL_METADATA, type PresetModelFamilyGroup, type PresetModelListing, type PreviewCopilotUpdateAction, type ProviderBaseUrlPreset, type ProviderCacheControlMetadata, type ProviderConfig, type ProviderModel, type ProviderMutationPayload, type ProviderTestResult, type ProviderType, type ProviderUsageData, type ProviderUsageKind, type ProviderUsageResult, type ProviderVisionMode, type ProviderWireProtocol, type ProvidersResponsePayload, type PublicProvider, type RemoveCopilotSourceAction, type ScheduledTask, type ScheduledTaskType, type ScheduledTaskV1, type ScheduledTasksConfig, type ScheduledTasksLogFile, type ServerProxyAllowOverridePayload, type ServerProxySnapshot, ServerProxyStateResponse, type ServerProxySupportMode, type ServerProxyTogglePayload, SetCacheControlEnabled, SetServerProxyAllowOverride, SetServerProxyEnabled, type ShellPayload, type TaskExecutionLog, type TaskExecutionState, type TaskExecutionStatus, type TaskPayload, type TaskRunStatus, type TaskWorkspaceRef, type UninstallCopilotPackageAction, UpdateUtilityModels, type UpdateUtilityModelsPayload, type UsageWindow, type UtilityModelScope, type UtilityModelsEffective, UtilityModelsResponse, type UtilityModelsSnapshot, type UtilityModelsSource, type WebviewInboundMessage, WebviewMessageType, __internal, asAbortSignal, buildGitHubLocalEmail, buildPresetModel, checkGitHubOrgMembership, createConsoleLogger, createDeviceRequestSignature, currencyForBaseUrl, effectiveAdapterType, fetchGitHubUser, getBuiltinProviderPreset, getGitHubOrgMembership, getPresetModelDisplayName, getProviderBaseUrlPresets, isGitHubLocalEmail, isProviderCacheControlAware, isValidCanonicalSlug, isWholePackageInstall, listPresetModelGroups, lookupModelMetadata, normalizeCanonicalSlug, normalizeErrorForLog, normalizeGitUrl, parsePayload, protocolForBaseUrl, registrationIdFromPackageId, resolvePrimaryEmail, safeJson, unionProviderModelWithPreset };