Crate kindling_service 

In-process kindling orchestration.

KindlingService exposes capsule lifecycle, observation append, retrieval, and pin management over the already-ported store, provider, and filter crates. Consumed in-process by the daemon (kindling-server), by the CLI, and directly by Rust integrators (e.g. anvil headless flows).

Ports KindlingService from packages/kindling-core/src/service/kindling-service.ts. Two deliberate deviations from the TS service:

1. Result-typed errors. Every method returns ServiceResult instead of throwing; validation failures and lifecycle violations are structured ServiceError variants.
2. Service-boundary secret masking. KindlingService::append_observation runs observation content through kindling_filter::mask_secrets before storing, so non-Rust consumers cannot bypass secret filtering. (Masking only — content truncation stays a hook-layer concern.)

Export/import/bundle methods (deferred from PORT-006) are implemented here by PORT-012; see [export]. They are byte-compatible with the TS bundle format so exports round-trip across the two implementations.

Modules

filter

Content filtering for kindling observations.

Structs

AppendObservationOptions

Options for KindlingService::append_observation.

AppendOutcome

Outcome of KindlingService::append_observation.

CloseCapsuleOptions

Options for KindlingService::close_capsule.

CreatePinOptions

Options for KindlingService::pin.

ExportBundle

A portable export bundle. JSON-compatible with the TS ExportBundle.

ExportBundleOptions

Options for KindlingService::export.

ExportDataset

The entity dataset inside an ExportBundle. Mirrors the TS ExportDataset shape returned by exportDatabase.

ExportStats

Summary statistics for an ExportBundle. Mirrors the TS ExportStats.

ImportOptions

Options for KindlingService::import. Mirrors the TS ImportOptions.

ImportResult

Result of an import. Mirrors the TS ImportResult, including the dryRun flag echoed back.

KindlingService

In-process kindling orchestration service.

OpenCapsuleOptions

Options for KindlingService::open_capsule.

PreCompactContext

Structured data backing the PreCompact injection.

ResolvedPin

A pin resolved to its target’s content, for injection previews.

SessionStartContext

Structured data backing the SessionStart injection.

Enums

ServiceError

Errors produced by KindlingService.

Constants

BUNDLE_VERSION

Bundle format version. Mirrors the TS bundleVersion/version literals.

Type Aliases

ServiceResult

Result alias for service operations.