copilot

Documentation

Overview

Package copilot turns a GitHub Copilot subscription into a memcode backend: it finds the GitHub token the machine already has (an env var or `gh auth token`), exchanges it for a short-lived Copilot API token, and returns the endpoint + identity headers the Copilot API requires. No vendor SDK — raw HTTP and one subprocess — so it composes into provider selection without a dependency cycle (it returns a plain Backend; the provider package adapts it to an Endpoint).

This is consent-gated upstream: it activates only when the user explicitly selects the copilot source (the first-run wizard, or MEMCODE_CREDENTIAL_SOURCE =copilot). It never reads `gh` behind the user's back.

Index

• func Available() bool
• type Backend
  • func Resolve(ctx context.Context) (Backend, error)

Functions

func Available

func Available() bool

Available reports whether a GitHub token the exchange could use is present — an env var or a gh install — without exchanging. For the wizard's menu.

Types

type Backend

type Backend struct {
	BaseURL string
	Token   string
	Headers map[string]string
}

Backend is the resolved Copilot endpoint: a Bearer token plus the identity headers every turn must carry. Consumed by the provider package.

func Resolve

func Resolve(ctx context.Context) (Backend, error)

Resolve finds the GitHub token, exchanges it (using a cached Copilot token while fresh), and returns the backend. An error explains the fix (sign in with gh, or the token type Copilot won't accept).