Documentation
¶
Overview ¶
Package infra reserves shared non-domain infrastructure helpers.
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Placeholder ¶
type Placeholder struct{}
Placeholder reserves the infra package for future spec-driven implementation.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package authevent provides composition-root implementations of core auth event delivery, such as a structured-log github.com/matdev83/go-llm-interactive-proxy/internal/core/auth.EventSink.
|
Package authevent provides composition-root implementations of core auth event delivery, such as a structured-log github.com/matdev83/go-llm-interactive-proxy/internal/core/auth.EventSink. |
|
backendplugins
|
|
|
adapter
Package adapter is the anti-corruption layer between public backendplugin DTOs and core-consumed execbackend.Backend / lipapi streams.
|
Package adapter is the anti-corruption layer between public backendplugin DTOs and core-consumed execbackend.Backend / lipapi streams. |
|
diagnostics
Package diagnostics provides non-serving inspect and explicit doctor checks for external backend plugins (manifest/catalog without launch; selected Activate).
|
Package diagnostics provides non-serving inspect and explicit doctor checks for external backend plugins (manifest/catalog without launch; selected Activate). |
|
processhost
Package processhost owns the project-selected supervised backend-plugin process host: lazy activation, process-model ownership, peer-gated local channels, generation invalidation, and composition BuildResult cleanup.
|
Package processhost owns the project-selected supervised backend-plugin process host: lazy activation, process-model ownership, peer-gated local channels, generation invalidation, and composition BuildResult cleanup. |
|
Package billingbinding adapts one validated public billing.Binding to the existing internal runtime chokepoints: the cheap pre-route credit screen, the quote/atomic exposure admission authority, and the terminal evidence handoff.
|
Package billingbinding adapts one validated public billing.Binding to the existing internal runtime chokepoints: the cheap pre-route credit screen, the quote/atomic exposure admission authority, and the terminal evidence handoff. |
|
Package billingspool owns the process-local durable terminal handoff.
|
Package billingspool owns the process-local durable terminal handoff. |
|
Package compactiondetect implements the proxy-derived coding-agent session compaction detector: a concrete, process-owned detector that inspects the effective canonical baseline after an upstream B-leg opens and every canonical event actually released by the retry stream, and derives typed started/completed lifecycle observations for fail-open SDK observers.
|
Package compactiondetect implements the proxy-derived coding-agent session compaction detector: a concrete, process-owned detector that inspects the effective canonical baseline after an upstream B-leg opens and every canonical event actually released by the retry stream, and derives typed started/completed lifecycle observations for fail-open SDK observers. |
|
concurrencyauthority
|
|
|
leasestore
Package leasestore provides memory, SQLite, and PostgreSQL backends for the concurrency-authority LeaseStore port.
|
Package leasestore provides memory, SQLite, and PostgreSQL backends for the concurrency-authority LeaseStore port. |
|
Package configsource provides the bounded fixed-path configuration source for runtime reload (versioned-runtime-reloadable-proxy-configuration).
|
Package configsource provides the bounded fixed-path configuration source for runtime reload (versioned-runtime-reloadable-proxy-configuration). |
|
Package continuation contains the small durable continuation adapter used by the standard contract tests and local deployments.
|
Package continuation contains the small durable continuation adapter used by the standard contract tests and local deployments. |
|
controlplane
|
|
|
ledgerstore
Package ledgerstore provides control-plane event-store adapters: an in-memory store for deterministic local recording and tests, and a Bun-backed durable store for SQLite and Postgres deployments.
|
Package ledgerstore provides control-plane event-store adapters: an in-memory store for deterministic local recording and tests, and a Bun-backed durable store for SQLite and Postgres deployments. |
|
ledgerstore/contract
Package contract provides a reusable store-contract test suite for control-plane event stores (spec control-plane-persistence-query-event-ledger, tasks 2.1–2.5).
|
Package contract provides a reusable store-contract test suite for control-plane event stores (spec control-plane-persistence-query-event-ledger, tasks 2.1–2.5). |
|
ledgerstore/fields
Package fields owns the canonical filter-field string names reported by control-plane ledger stores in cp.UnsupportedFilter.Field.
|
Package fields owns the canonical filter-field string names reported by control-plane ledger stores in cp.UnsupportedFilter.Field. |
|
observers
Package observers hosts the control-plane source adapters that fan existing runtime evidence seams (auth event sink, policy/usage observers, secure- session store, B2BUA store) into the core control-plane recorder without requiring those seams to understand the query capability (design "Source Adapters"; requirements 1.1–1.6, 3.1, 5.1–5.7, 8.1–8.6, 10.7).
|
Package observers hosts the control-plane source adapters that fan existing runtime evidence seams (auth event sink, policy/usage observers, secure- session store, B2BUA store) into the core control-plane recorder without requiring those seams to understand the query capability (design "Source Adapters"; requirements 1.1–1.6, 3.1, 5.1–5.7, 8.1–8.6, 10.7). |
|
Package conversationview provides mutable steering CRUD/state, placement and anchor-missing policies, writer/registrar services, persistence and store contracts, and feature diagnostics outside the core conversation projection kernel.
|
Package conversationview provides mutable steering CRUD/state, placement and anchor-missing policies, writer/registrar services, persistence and store contracts, and feature diagnostics outside the core conversation projection kernel. |
|
sdkadapter
Package sdkadapter bridges trusted SDK contracts to the authoritative conversation-view domain ports.
|
Package sdkadapter bridges trusted SDK contracts to the authoritative conversation-view domain ports. |
|
storecontract
Package storecontract holds reusable contract tests for conversationview.Store implementations (ReferenceStore, MemoryStore, Bun).
|
Package storecontract holds reusable contract tests for conversationview.Store implementations (ReferenceStore, MemoryStore, Bun). |
|
Package db provides internal-only database infrastructure: opening managed connections, wrapping *sql.DB with Bun for supported dialects, connection pool tuning, and secret-safe DSN and error redaction.
|
Package db provides internal-only database infrastructure: opening managed connections, wrapping *sql.DB with Bun for supported dialects, connection pool tuning, and secret-safe DSN and error redaction. |
|
Package endpoint defines the immutable compatible-mode base URL contract.
|
Package endpoint defines the immutable compatible-mode base URL contract. |
|
Package extensiontrace hosts minimal OpenTelemetry helpers for internal/core/extension stages without importing the full internal/infra/tracing package (which depends on internal/core and would cycle with packages such as internal/core/diag that reference extensions).
|
Package extensiontrace hosts minimal OpenTelemetry helpers for internal/core/extension stages without importing the full internal/infra/tracing package (which depends on internal/core and would cycle with packages such as internal/core/diag that reference extensions). |
|
Package geoip contains process-owned Country MMDB infrastructure.
|
Package geoip contains process-owned Country MMDB infrastructure. |
|
Package logging builds slog handlers from validated operator logging config.
|
Package logging builds slog handlers from validated operator logging config. |
|
metering
|
|
|
journalstore
Package journalstore provides append-only metering fact journal adapters: in-memory for tests/local use, and Bun-backed SQLite/Postgres for durable deployments.
|
Package journalstore provides append-only metering fact journal adapters: in-memory for tests/local use, and Bun-backed SQLite/Postgres for durable deployments. |
|
modelcatalog
|
|
|
modelsdev
Package modelsdev implements models.dev catalog ingestion: JSON parse, normalize to modelcatalog.ModelFacts, HTTP fetch, and filesystem cache.
|
Package modelsdev implements models.dev catalog ingestion: JSON parse, normalize to modelcatalog.ModelFacts, HTTP fetch, and filesystem cache. |
|
modelregistry
|
|
|
Package osidentity resolves the current OS user (or explicit env hints) for local no-op auth.
|
Package osidentity resolves the current OS user (or explicit env hints) for local no-op auth. |
|
Package routinghealth supplies composition-root implementations of policy.CandidateHealth for the standard bundle without embedding core routing policy types at call sites.
|
Package routinghealth supplies composition-root implementations of policy.CandidateHealth for the standard bundle without embedding core routing policy types at call sites. |
|
Package runtimebundle is the standard-distribution composition root: BuildHost, inspection, ValidateDistribution, and generation compile/publish wiring.
|
Package runtimebundle is the standard-distribution composition root: BuildHost, inspection, ValidateDistribution, and generation compile/publish wiring. |
|
Package runtimehost hosts the generation manager, leases, retirement scheduling, dispatcher, and serialized reload coordinator for versioned runtime reload.
|
Package runtimehost hosts the generation manager, leases, retirement scheduling, dispatcher, and serialized reload coordinator for versioned runtime reload. |
|
terminalwork
|
|
|
workstore
Package workstore provides memory, SQLite, and PostgreSQL backends for durable terminal-work intent, claims, retry, and quarantine (requirements 8.1–8.9).
|
Package workstore provides memory, SQLite, and PostgreSQL backends for durable terminal-work intent, claims, retry, and quarantine (requirements 8.1–8.9). |
|
imageestimator
Package imageestimator provides bounded local estimates for multimodal image parts.
|
Package imageestimator provides bounded local estimates for multimodal image parts. |
|
Package tracing wires OpenTelemetry tracers, propagators, and optional OTLP export.
|
Package tracing wires OpenTelemetry tracers, propagators, and optional OTLP export. |
|
usageauthority
|
|
|
authoritystore/contract
Package contract defines the shared authority-store contract test helpers.
|
Package contract defines the shared authority-store contract test helpers. |
|
evidencesink
Package evidencesink projects usage-authority application outcomes into the policydecision observer chain and the control-plane accounting-authority event ledger.
|
Package evidencesink projects usage-authority application outcomes into the policydecision observer chain and the control-plane accounting-authority event ledger. |
Click to show internal directories.
Click to hide internal directories.