@spec create(
  ArchAstro.Client.t(),
  String.t(),
  ArchAstro.Types.Operations.PostApiV1AgentInstallationsInstallationInstallationSources.Input.t()
) ::
  {:ok, ArchAstro.Types.InstallationSource.t()}
  | {:error, ArchAstro.Error.reason()}

Add a source to an installation

Attaches a new source to an existing installation, making its content available to the installation's agent as context. The source type and payload must be valid for the installation's kind; invalid combinations return 422.

This endpoint requires an app-scoped token. The installation must belong to an agent accessible by the authenticated caller. Once created, the source begins processing asynchronously — its state will transition from "pending" as ingestion progresses.

The newly created installation source.

@spec list(ArchAstro.Client.t(), String.t()) ::
  {:ok, ArchAstro.Types.InstallationSourceListResponse.t()}
  | {:error, ArchAstro.Error.reason()}

List sources for an installation

Returns all sources attached to the specified installation. Sources represent the content units (documents, links, and other typed payloads) that the installation's agent can access as context.

This endpoint requires an app-scoped token. Results include sources in all states, including those still being ingested. Inspect each source's state field to determine whether its content is ready.

Object containing the list of sources attached to the installation.