API Reference

This is the auto-generated reference for the Bowire SDK + every first-party package that ships from this repo. It is built by DocFX from the XML doc-comments emitted by each project's Kuestenlogik.Bowire*.xml file at release time — every public type, property, method, and event lands here verbatim.

Looking for prose docs? The conceptual guides — what Bowire is, how the workbench is laid out, how the protocols behave, how to embed the SDK — live under Features, the User Guide, the Protocol Guides, and the Architecture section. This page is the index for the reference surface specifically.

How to use this reference

  • Browse by namespace. Every namespace is listed below — pick the package you're working in, jump to the namespace page, drill into types.
  • Search. The standalone HTML build wires the _enableSearch flag, so the search box across the top hits both the prose docs and this generated reference. The bowire.io build defers search to Pagefind across the whole site instead.
  • Cross-references. Type names rendered as links resolve through DocFX's xref index — <xref:Kuestenlogik.Bowire.IBowireProtocol> in any doc page becomes a direct link to the interface page.

Core

The flagship package every Bowire host references — workbench shell, plugin registries, options, the MapBowire() extension, and the public extension points sibling packages plug into.

  • Kuestenlogik.Bowire — host SDK entry point: IBowireProtocol contract, BowireOptions, MapBowire(), BowireProtocolRegistry, the plugin-loading host, the rail / module / endpoint / service contribution interfaces.
  • Kuestenlogik.Bowire.Plugins — rail / module / endpoint / service contribution registries (BowireRailRegistry, BowireModuleRegistry) and the auto-update check service.
  • Kuestenlogik.Bowire.Auth — cookie jar, mTLS handler, AWS Sig v4 signer, the auth-provider registry, the user-store SPI.
  • Kuestenlogik.Bowire.Mocking — recording / step / frame contracts shared across plugins; HAR import, schema snapshots, the mock-emitter / mock-hosting extension SPIs.
  • Kuestenlogik.Bowire.Models — service / method / message / field info DTOs the dispatcher sees (used by every protocol plugin).
  • Kuestenlogik.Bowire.PluginLoading — AssemblyLoadContext plumbing for bowire plugin install (.NET + sidecar manifests).
  • Kuestenlogik.Bowire.Semantics — semantic annotation store + the detectors that infer kinds (coordinates, timestamps, image bytes, audio bytes, …).
  • Kuestenlogik.Bowire.Semantics.Extensions — the workbench's UI-extension contract (IBowireUiExtension) + the embedded-asset serving helpers.
  • Kuestenlogik.Bowire.Sources — catalogue / discovery provider contract (IBowireCatalogueProvider) and the built-in local / http / consul providers.
  • Kuestenlogik.Bowire.Recording — recording-session state machine + event stream.
  • Kuestenlogik.Bowire.Security — fuzzing executor + the attack-predicate DSL the security scanner evaluates against.
  • Kuestenlogik.Bowire.Projects — where Bowire decides to put things: BowirePaths, the storage-scope resolver, and the .bowire/ project manifest loader.
  • Kuestenlogik.Bowire.Environments — provisioned environments (BowireProvisionedEnvironment) the host seeds rather than the operator typing them.
  • Kuestenlogik.Bowire.Linting — the design-time linter behind the Lint rail: BowireSchemaLinter, the .bowire/rules.json config loader, and the IBowireLintRule seam.
  • Kuestenlogik.Bowire.Linting.Rules — the shipped rules (PII and sensitive response fields, missing pagination, missing versioning, string timestamps).
  • Kuestenlogik.Bowire.Reporting — the rollup shape shared by GET /api/report/rollup, bowire report rollup --json and the bowire.report.rollup MCP tool.
  • Kuestenlogik.Bowire.Endpoints — the rollup's HTTP surface, a thin adapter over BowireReportReader.
  • Kuestenlogik.Bowire.Schemas — the delta between two discovery snapshots: which services and methods were added, removed or changed.
  • Kuestenlogik.Bowire.Semantics.Detectors — the field detectors that infer semantic kinds (WGS84 coordinates, GeoJSON points, timestamps, image and audio bytes) plus the IBowireFieldDetector seam.
  • Kuestenlogik.Bowire.Proxy — the intercepting proxy behind bowire proxy: the self-signed CA that mints leaf certificates, the server, and the captured-flow store.
  • Kuestenlogik.Bowire.Plugins.Sidecar — the sidecar.json manifest shape and the JSON-RPC bridge that lets a non-.NET plugin implement a protocol.
  • Kuestenlogik.Bowire.Net — BowireHttpClientFactory, whose certificate validation consults the localhost-certificate trust list on every request.
  • Kuestenlogik.Bowire.Helpers — SelfOriginCheck, which tells "this serverUrl is the workbench host itself" apart from an external target.

Workbench rails (Welle 2 layout)

After the v2.1 #325 cleanup each workbench rail ships as its own NuGet package and registers itself via IBowireRailContribution. Embedded hosts opt out by simply not referencing the package — the rail disappears from the strip.

First-party protocol plugins

Every protocol Bowire speaks lives in its own Kuestenlogik.Bowire.Protocol.<Name> package, implementing IBowireProtocol plus any protocol-specific extension points (mock hosting, schema sources, transport adapters).

Optional infrastructure packages

These ship from the same repo but are reference-only — hosts pull them in when they need the feature, otherwise the surface stays absent.

Public extension points

These are the seams sibling packages (and customer packages) implement to contribute behaviour into a Bowire host. Each one is auto-discovered via assembly scan at host startup — drop the package on the load path and the contribution wires itself.

  • IBowireProtocol — wire protocol plugins. Implement to add support for a new protocol (discovery, invoke, streaming, channel open). See Protocol Guides for behavioural conventions.
  • IBowireRailContribution — workbench rails. Implement to add a left-strip activity icon + its sidebar / main-pane view. See Plugin Architecture for the rail / module split.
  • IBowireModuleContribution — cross-cutting modules (no rail icon — hooks across the shell, e.g. the AI chat pane or variable resolver).
  • IBowireServiceContribution — DI service registration at AddBowire() time. Sibling packages register their own services through this so Core never references them at compile time.
  • IBowireEndpointContribution — ASP.NET endpoint registration at MapBowire() time. Sibling packages mount their admin / data endpoints under Core's auth-gated route group.
  • IBowireHelpProvider — in-app documentation provider. Implement to back the F1 / Help drawer / /api/help/* endpoint stack.
  • IBowireCatalogueProvider — where the URL/service list comes from (local file, HTTP, Consul, k8s, agent hub).
  • IBowireUiExtension — UI extensions that mount against semantic kinds (coordinate.wgs84, image.bytes, …) as viewers or editors.
  • IBowireOpenApiAdapter — version-decoupled OpenAPI parser seam so the REST plugin doesn't pin a specific Microsoft.OpenApi version.

Per-extension-point how-to guides land under docs/extending/ in a follow-up stream. Until they ship, the XML-doc remarks blocks on each interface above carry the contract (what to implement, what gets called when, what failure modes the host swallows).

Polyglot sidecar plugins

Bowire also accepts non-.NET plugins via a JSON-RPC 2.0 sidecar bridge (stdio or HTTP/SSE) — no .NET assembly, no IBowireProtocol implementation needed. The wire contract, manifest schema, and packaging / install flow (zip, http(s)://, oci://) are documented in Sidecar Plugins. The Python SDK lives in its own repo: Kuestenlogik/Bowire.Sdk.Python (pip install bowire-plugin).

Sibling protocol plugins (out-of-repo)

These ship from their own NuGet packages with independent release cadences — see the Protocol Guides for install snippets. Their API surface is not part of this DocFX scope; refer to the sibling repo for its own reference build.

  • Kuestenlogik.Bowire.Protocol.Surgewave
  • Kuestenlogik.Bowire.Protocol.Kafka
  • Kuestenlogik.Bowire.Protocol.Amqp
  • Kuestenlogik.Bowire.Protocol.Dis
  • Kuestenlogik.Bowire.Protocol.Udp
  • Kuestenlogik.Bowire.Protocol.Akka

TacticalAPI — Kuestenlogik.Bowire.Protocol.TacticalApi ships from https://github.com/Kuestenlogik/Bowire.Protocol.TacticalApi on its own release cadence (currently v1.0.0 stable); its API surface is not part of this DocFX scope. See the TacticalAPI protocol guide for install + usage, and the sibling repo's README for the proto-fetch licensing rationale.

Edit this page