Class SessionExtensionsApi

java.lang.Object
com.github.copilot.generated.rpc.SessionExtensionsApi
@Generated("copilot-sdk-codegen") public final class SessionExtensionsApi extends Object
API methods for the extensions namespace.
Since:
1.0.0

  • Method Details

    • list

      @CopilotExperimental public CompletableFuture<SessionExtensionsListResult> list()
      Lists extensions discovered for the session and their current status.
      Since:
      1.0.0

    • enable

      @CopilotExperimental public CompletableFuture<Void> enable(SessionExtensionsEnableParams params)
      Enables an extension for the session and persists the preference when the session has a settings store. Hosts synchronizing effective membership should use extensions.reconcile instead.

      Note: the sessionId field in the params record is overridden by the session-scoped wrapper; any value provided is ignored.

      Since:
      1.0.0

    • disable

      @CopilotExperimental public CompletableFuture<Void> disable(SessionExtensionsDisableParams params)
      Disables an extension for the session and persists the preference when the session has a settings store. Hosts synchronizing effective membership should use extensions.reconcile instead.

      Note: the sessionId field in the params record is overridden by the session-scoped wrapper; any value provided is ignored.

      Since:
      1.0.0

    • reload

      @CopilotExperimental public CompletableFuture<Void> reload()
      Reloads extension definitions and processes for the session.
      Since:
      1.0.0

    • reconcile

      @CopilotExperimental public CompletableFuture<SessionExtensionsReconcileResult> reconcile()
      Host-only reconciliation of authoritative session-effective extension membership and enablement. Refreshes runtime-owned discovery and preferences without persisting settings, installing plugins, or restarting unchanged activations. Returns ExtensionList only after required starts and process/contribution cleanup settle. Takes no caller inventory or overrides. Missing controllers, unready/incomplete discovery, unavailable workspaces, superseded inputs, and lifecycle failures are errors, not empty membership. Independently proven revocations may be applied before an error; retry converges without restarting healthy activations. Error data contains lifecycleChangesApplied and code: extension_reconciliation_host_required, extension_reconciliation_unavailable, extension_reconciliation_not_ready, extension_reconciliation_discovery_failed, extension_reconciliation_workspace_unavailable, extension_reconciliation_superseded, or extension_reconciliation_lifecycle_failed. Mark host reconciliation state applied only on success. On older runtimes, method-not-found must not fall back to global discovery and persistent extension disables.
      Since:
      1.0.0

    • sendAttachmentsToMessage

      @CopilotExperimental public CompletableFuture<Void> sendAttachmentsToMessage(SessionExtensionsSendAttachmentsToMessageParams params)
      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.

      Note: the sessionId field in the params record is overridden by the session-scoped wrapper; any value provided is ignored.

      Since:
      1.0.0