acp

type AdapterConn struct {
	// contains filtered or unexported fields
}

type AdapterProc struct {
	Conn *AdapterConn
	// Stop terminates the process: graceful first, then forceful after
	// stopGrace. Must be safe to call more than once.
	Stop func()
	// contains filtered or unexported fields
}

type AdapterProfile struct {
	// ID is a stable identifier used in logs and the software manifest.
	ID string
	// Backend is the clank backend type this profile serves.
	Backend agent.BackendType
	Scope   AdapterScope
	// Prepare provisions whatever Command/Env need for scopeDir (e.g.
	// installing the adapter package, materializing guidance) before each
	// spawn attempt. Must be idempotent and cheap once satisfied; it owns
	// its own timeout budget. nil = ready.
	Prepare func(ctx context.Context, scopeDir string) error
	// Command returns the argv that launches the adapter for scopeDir
	// (empty for ScopeHost profiles). Called after Prepare succeeded.
	Command func(scopeDir string) (bin string, args []string)
	// Env returns credential/config env vars for scopeDir, merged over
	// the parent environment at spawn. A change in the returned map
	// restarts that scope's adapter on the next reconcile (fingerprint).
	Env func(scopeDir string) map[string]string
	// SessionNewMeta builds session/new's _meta payload; guidance is the
	// assembled system prompt for fresh sessions ("" on resume). nil =
	// no meta (the adapter has no session-level injection channel).
	SessionNewMeta func(guidance string) map[string]any
	// ModelOption maps a model override onto a session config option
	// (option id + value). nil = overrides are ignored for this adapter.
	//
	// Session modes need no profile hook: the agent owns its mode
	// vocabulary — clank passes mode ids through to session/set_mode and
	// surfaces the advertised list untranslated.
	ModelOption func(o agent.ModelOverride) (id, value string, ok bool)
}

type AdapterScope int

type AdapterSupervisor struct {
	// contains filtered or unexported fields
}

type Backend struct {
	// contains filtered or unexported fields
}

type ConnResolver func(ctx context.Context) (*AdapterConn, error)

type SessionHandler interface {
	HandleSessionUpdate(ctx context.Context, n sdk.SessionNotification)
	HandleRequestPermission(ctx context.Context, req sdk.RequestPermissionRequest) (sdk.RequestPermissionResponse, error)
}

type SpawnFunc func(ctx context.Context, scopeDir string) (*AdapterProc, error)