@relkit/observability-local 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 rel-kit
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,5 @@
-# Temporary Holding Version
+# @relkit/observability-local
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Explicit local diagnostic history and worker storage for RELKIT inspection.
+
+See [@relkit/app](https://github.com/rel-kit/relkit) for supported application APIs.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/** Optional native history API; importing this package explicitly selects local storage. */
+export * from "./local/worker-client.js";
+export * from "./local/duckdb-database-effect.js";
+export * from "./local/duckdb-database.js";
+export * from "./local/duckdb-driver.js";
+export * from "./local/duckdb-error.js";
+export * from "./local/duckdb-worker-effect.js";
+export type * from "@relkit/observability/local/record";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC;AAChD,mBAAmB,oCAAoC,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+/** Optional native history API; importing this package explicitly selects local storage. */
+export * from "./local/worker-client.js";
+export * from "./local/duckdb-database-effect.js";
+export * from "./local/duckdb-database.js";
+export * from "./local/duckdb-driver.js";
+export * from "./local/duckdb-error.js";
+export * from "./local/duckdb-worker-effect.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,cAAc,0BAA0B,CAAC;AACzC,cAAc,mCAAmC,CAAC;AAClD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/local/duckdb-batch-cursors.d.ts

@@ -0,0 +1,10 @@
+/** Assigns explicit monotonically ordered cursors without relying on native sequence row order. */
+import { Effect } from "effect";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+import type { PreparedDuckdbRecord } from "./duckdb-batch.types.js";
+/** @param connection - Transaction-owned connection. @param admitted - Newly receipted records. @returns A proven one-to-one cursor assignment. */
+export declare const assignDuckdbCursors: (connection: DuckdbConnectionPort, admitted: PreparedDuckdbRecord[]) => Effect.Effect<{
+    prepared: PreparedDuckdbRecord;
+    cursor: string;
+}[], import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-batch-cursors.d.ts.map

package/dist/local/duckdb-batch-cursors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch-cursors.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-batch-cursors.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,yBAAyB,CAAC;AAC1F,mJAAmJ;AACnJ,eAAO,MAAM,mBAAmB;;;oDA8B9B,CAAC"}

package/dist/local/duckdb-batch-cursors.js

@@ -0,0 +1,30 @@
+/** Assigns explicit monotonically ordered cursors without relying on native sequence row order. */
+import { Effect } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+import { readDuckdbSql } from "./duckdb-sql.js";
+/** @param connection - Transaction-owned connection. @param admitted - Newly receipted records. @returns A proven one-to-one cursor assignment. */
+export const assignDuckdbCursors = Effect.fn("ObservabilityDuckdb.batch.cursors")(function* (connection, admitted) {
+    const allocated = yield* readDuckdbSql(connection, "append", "SELECT nextval('record_ids')::VARCHAR AS id FROM range(?)", [admitted.length]);
+    return yield* Effect.try({
+        try: () => {
+            const values = [];
+            for (const row of allocated.getRowObjectsJson()) {
+                const value = row["id"];
+                if (typeof value !== "string" || !/^[1-9][0-9]*$/.test(value))
+                    throw new Error("Unexpected cursor allocation result");
+                values.push(value);
+            }
+            if (values.length !== admitted.length || new Set(values).size !== values.length)
+                throw new Error("Unexpected cursor allocation result");
+            values.sort((left, right) => (BigInt(left) < BigInt(right) ? -1 : 1));
+            return admitted.map((prepared, index) => {
+                const cursor = values[index];
+                if (cursor === undefined)
+                    throw new Error("Unexpected cursor allocation result");
+                return { prepared, cursor };
+            });
+        },
+        catch: (cause) => duckdbError("append", cause),
+    });
+});
+//# sourceMappingURL=duckdb-batch-cursors.js.map

package/dist/local/duckdb-batch-cursors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch-cursors.js","sourceRoot":"","sources":["../../src/local/duckdb-batch-cursors.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,mJAAmJ;AACnJ,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,mCAAmC,CAAC,CAAC,QAAQ,CAAC,EACzF,UAAgC,EAChC,QAAgC;IAEhC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,aAAa,CACpC,UAAU,EACV,QAAQ,EACR,2DAA2D,EAC3D,CAAC,QAAQ,CAAC,MAAM,CAAC,CAClB,CAAC;IACF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE;YACR,MAAM,MAAM,GAAa,EAAE,CAAC;YAC5B,KAAK,MAAM,GAAG,IAAI,SAAS,CAAC,iBAAiB,EAAE,EAAE,CAAC;gBAChD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;gBACxB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;oBAC3D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;gBACzD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM;gBAC7E,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;YACzD,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;gBACtC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,MAAM,KAAK,SAAS;oBAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;gBACjF,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YAC9B,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/local/duckdb-batch-insert.d.ts

@@ -0,0 +1,8 @@
+/** Writes explicitly assigned cursor/payload rows inside the caller's atomic batch transaction. */
+import { Effect } from "effect";
+import type { StoredLocalRecord } from "@relkit/observability/local/record";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+import type { AssignedDuckdbRecord } from "./duckdb-batch.types.js";
+/** @param connection - Transaction-owned connection. @param assigned - Explicit record/cursor pairs. @param receivedAt - Batch epoch milliseconds. @returns Stored envelopes after the native insert. */
+export declare const insertDuckdbBatch: (connection: DuckdbConnectionPort, assigned: readonly AssignedDuckdbRecord[], receivedAt: number) => Effect.Effect<StoredLocalRecord[], import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-batch-insert.d.ts.map

package/dist/local/duckdb-batch-insert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch-insert.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-batch-insert.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AACpE,yMAAyM;AACzM,eAAO,MAAM,iBAAiB,yLA+B5B,CAAC"}

package/dist/local/duckdb-batch-insert.js

@@ -0,0 +1,29 @@
+/** Writes explicitly assigned cursor/payload rows inside the caller's atomic batch transaction. */
+import { Effect } from "effect";
+import { recordTime } from "@relkit/observability/local/record";
+import { runDuckdbSql } from "./duckdb-sql.js";
+/** @param connection - Transaction-owned connection. @param assigned - Explicit record/cursor pairs. @param receivedAt - Batch epoch milliseconds. @returns Stored envelopes after the native insert. */
+export const insertDuckdbBatch = Effect.fn("ObservabilityDuckdb.batch.insert")(function* (connection, assigned, receivedAt) {
+    const parameters = assigned.flatMap(({ prepared: { item, safe, payload }, cursor }) => [
+        BigInt(cursor),
+        item.origin,
+        safe.signal,
+        recordTime(safe),
+        receivedAt,
+        safe.requestId ?? null,
+        safe.originRequestId ?? null,
+        safe.traceId ?? null,
+        "spanId" in safe ? (safe.spanId ?? null) : null,
+        Buffer.byteLength(payload),
+        payload,
+    ]);
+    yield* runDuckdbSql(connection, "append", "INSERT INTO records (id, origin, signal, recorded_at, received_at, request_id, " +
+        "origin_request_id, trace_id, span_id, bytes, payload) VALUES " +
+        Array(assigned.length).fill("(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)").join(", "), parameters);
+    return assigned.map(({ prepared: { item, safe }, cursor }) => ({
+        ...safe,
+        cursor,
+        origin: item.origin,
+    }));
+});
+//# sourceMappingURL=duckdb-batch-insert.js.map

package/dist/local/duckdb-batch-insert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch-insert.js","sourceRoot":"","sources":["../../src/local/duckdb-batch-insert.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAG/C,yMAAyM;AACzM,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,EAAE,CAAC,kCAAkC,CAAC,CAAC,QAAQ,CAAC,EACtF,UAAgC,EAChC,QAAyC,EACzC,UAAkB;IAElB,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACrF,MAAM,CAAC,MAAM,CAAC;QACd,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,MAAM;QACX,UAAU,CAAC,IAAI,CAAC;QAChB,UAAU;QACV,IAAI,CAAC,SAAS,IAAI,IAAI;QACtB,IAAI,CAAC,eAAe,IAAI,IAAI;QAC5B,IAAI,CAAC,OAAO,IAAI,IAAI;QACpB,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QAC/C,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;QAC1B,OAAO;KACR,CAAC,CAAC;IACH,KAAK,CAAC,CAAC,YAAY,CACjB,UAAU,EACV,QAAQ,EACR,iFAAiF;QAC/E,+DAA+D;QAC/D,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAC7E,UAAU,CACX,CAAC;IACF,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,EAAqB,EAAE,CAAC,CAAC;QAChF,GAAG,IAAI;QACP,MAAM;QACN,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC,CAAC;AACN,CAAC,CAAC,CAAC"}

package/dist/local/duckdb-batch-prepare.d.ts

@@ -0,0 +1,7 @@
+import type { RedactionPolicy } from "@relkit/observability";
+import type { LocalRecord } from "@relkit/observability/local/record";
+import { Effect } from "effect";
+import type { PreparedDuckdbRecord } from "./duckdb-batch.types.js";
+/** @param records - Input envelopes, including repeated keys. @param redaction - Current admission policy. @returns First envelope per key after all validation. */
+export declare const prepareDuckdbBatch: (records: readonly LocalRecord[], redaction?: RedactionPolicy | undefined) => Effect.Effect<Map<string, PreparedDuckdbRecord>, import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-batch-prepare.d.ts.map

package/dist/local/duckdb-batch-prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch-prepare.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-batch-prepare.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,yBAAyB,CAAC;AAC1F,oKAAoK;AACpK,eAAO,MAAM,kBAAkB,gLAoB7B,CAAC"}

package/dist/local/duckdb-batch-prepare.js

@@ -0,0 +1,29 @@
+/** Validates every envelope before receipt deduplication and encodes only admitted redacted payloads. */
+import { canonicalJson } from "@relkit/contracts";
+import { admitObservabilityRecord } from "@relkit/observability";
+import { validateLocalRecord } from "@relkit/observability/local/record";
+import { Effect } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+import { readDuckdbSql } from "./duckdb-sql.js";
+/** @param records - Input envelopes, including repeated keys. @param redaction - Current admission policy. @returns First envelope per key after all validation. */
+export const prepareDuckdbBatch = Effect.fn("ObservabilityDuckdb.batch.prepare")(function* (records, redaction) {
+    return yield* Effect.try({
+        try: () => {
+            if (records.length > 256)
+                throw new RangeError("Telemetry batches contain at most 256 records");
+            const values = new Map();
+            for (const item of records) {
+                validateLocalRecord(item);
+                const safe = admitObservabilityRecord(item.record, redaction);
+                if (!safe)
+                    throw new TypeError("Telemetry record could not be admitted");
+                const payload = canonicalJson(safe);
+                if (!values.has(item.key))
+                    values.set(item.key, { item, safe, payload });
+            }
+            return values;
+        },
+        catch: (cause) => duckdbError("append", cause),
+    });
+});
+//# sourceMappingURL=duckdb-batch-prepare.js.map

package/dist/local/duckdb-batch-prepare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch-prepare.js","sourceRoot":"","sources":["../../src/local/duckdb-batch-prepare.ts"],"names":[],"mappings":"AAAA,yGAAyG;AACzG,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,oKAAoK;AACpK,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,EAAE,CAAC,mCAAmC,CAAC,CAAC,QAAQ,CAAC,EACxF,OAA+B,EAC/B,SAA2B;IAE3B,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,OAAO,CAAC,MAAM,GAAG,GAAG;gBACtB,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgC,CAAC;YACvD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;gBAC3B,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAC1B,MAAM,IAAI,GAAG,wBAAwB,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAC9D,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,SAAS,CAAC,wCAAwC,CAAC,CAAC;gBACzE,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;oBAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/local/duckdb-batch-receipts.d.ts

@@ -0,0 +1,7 @@
+/** Inserts stable transport receipts transactionally and recovers first-input ordering from returned keys. */
+import { Effect } from "effect";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+import type { PreparedDuckdbRecord } from "./duckdb-batch.types.js";
+/** @param connection - Transaction-owned connection. @param first - Validated first envelopes. @param receivedAt - Receipt epoch milliseconds. @returns Newly admitted records in input order. */
+export declare const admitDuckdbReceipts: (connection: DuckdbConnectionPort, first: Map<string, PreparedDuckdbRecord>, receivedAt: number) => Effect.Effect<PreparedDuckdbRecord[], import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-batch-receipts.d.ts.map

package/dist/local/duckdb-batch-receipts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch-receipts.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-batch-receipts.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,KAAK,EAAE,oBAAoB,EAAwB,MAAM,yBAAyB,CAAC;AAC1F,kMAAkM;AAClM,eAAO,MAAM,mBAAmB,2LA0B9B,CAAC"}

package/dist/local/duckdb-batch-receipts.js

@@ -0,0 +1,24 @@
+/** Inserts stable transport receipts transactionally and recovers first-input ordering from returned keys. */
+import { Effect } from "effect";
+import { duckdbError } from "./duckdb-error.js";
+import { readDuckdbSql } from "./duckdb-sql.js";
+/** @param connection - Transaction-owned connection. @param first - Validated first envelopes. @param receivedAt - Receipt epoch milliseconds. @returns Newly admitted records in input order. */
+export const admitDuckdbReceipts = Effect.fn("ObservabilityDuckdb.batch.receipts")(function* (connection, first, receivedAt) {
+    const receipts = yield* readDuckdbSql(connection, "append", "INSERT INTO receipts VALUES " +
+        Array(first.size).fill("(?, ?)").join(", ") +
+        " ON CONFLICT DO NOTHING RETURNING key", [...first.keys()].flatMap((key) => [key, receivedAt]));
+    return yield* Effect.try({
+        try: () => {
+            const keys = new Set();
+            for (const row of receipts.getRowObjectsJson()) {
+                const key = row["key"];
+                if (typeof key !== "string" || !first.has(key) || keys.has(key))
+                    throw new Error("Unexpected receipt admission result");
+                keys.add(key);
+            }
+            return [...first.values()].filter(({ item }) => keys.has(item.key));
+        },
+        catch: (cause) => duckdbError("append", cause),
+    });
+});
+//# sourceMappingURL=duckdb-batch-receipts.js.map

package/dist/local/duckdb-batch-receipts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch-receipts.js","sourceRoot":"","sources":["../../src/local/duckdb-batch-receipts.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,kMAAkM;AAClM,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,EAAE,CAAC,oCAAoC,CAAC,CAAC,QAAQ,CAAC,EAC1F,UAAgC,EAChC,KAAwC,EACxC,UAAkB;IAElB,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,aAAa,CACnC,UAAU,EACV,QAAQ,EACR,8BAA8B;QAC5B,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3C,uCAAuC,EACzC,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CACtD,CAAC;IACF,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE;YACR,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;YAC/B,KAAK,MAAM,GAAG,IAAI,QAAQ,CAAC,iBAAiB,EAAE,EAAE,CAAC;gBAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC;gBACvB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;oBAC7D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;gBACzD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAChB,CAAC;YACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/local/duckdb-batch.d.ts

@@ -0,0 +1,8 @@
+/** Composes validated receipt admission, explicit cursor allocation and insertion within one borrowed transaction. */
+import { Effect } from "effect";
+import type { RedactionPolicy } from "@relkit/observability";
+import type { LocalRecord } from "@relkit/observability/local/record";
+import type { DuckdbConnectionPort } from "./duckdb-driver.types.js";
+/** @param connection - Transaction-owned connection. @param records - At most 256 envelopes. @param receivedAt - Batch epoch milliseconds. @param redaction - Admission policy. @returns Explicitly cursored stored records; caller commits or rolls back. */
+export declare const appendDuckdbBatchEffect: (connection: DuckdbConnectionPort, records: readonly LocalRecord[], receivedAt: number, redaction?: RedactionPolicy | undefined) => Effect.Effect<import("@relkit/observability/local/record").StoredLocalRecord[], import("./duckdb-error.js").DuckdbError, never>;
+//# sourceMappingURL=duckdb-batch.d.ts.map

package/dist/local/duckdb-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-batch.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACtE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAMrE,8PAA8P;AAC9P,eAAO,MAAM,uBAAuB,qQAenC,CAAC"}

package/dist/local/duckdb-batch.js

@@ -0,0 +1,19 @@
+/** Composes validated receipt admission, explicit cursor allocation and insertion within one borrowed transaction. */
+import { Effect } from "effect";
+import { prepareDuckdbBatch } from "./duckdb-batch-prepare.js";
+import { admitDuckdbReceipts } from "./duckdb-batch-receipts.js";
+import { assignDuckdbCursors } from "./duckdb-batch-cursors.js";
+import { insertDuckdbBatch } from "./duckdb-batch-insert.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+/** @param connection - Transaction-owned connection. @param records - At most 256 envelopes. @param receivedAt - Batch epoch milliseconds. @param redaction - Admission policy. @returns Explicitly cursored stored records; caller commits or rolls back. */
+export const appendDuckdbBatchEffect = Effect.fn("ObservabilityDuckdb.appendBatch")(function* (connection, records, receivedAt, redaction) {
+    const first = yield* prepareDuckdbBatch(records, redaction);
+    if (first.size === 0)
+        return [];
+    const admitted = yield* admitDuckdbReceipts(connection, first, receivedAt);
+    if (admitted.length === 0)
+        return [];
+    const assigned = yield* assignDuckdbCursors(connection, admitted);
+    return yield* insertDuckdbBatch(connection, assigned, receivedAt);
+}, (effect) => observeDuckdb("append-batch", effect));
+//# sourceMappingURL=duckdb-batch.js.map

package/dist/local/duckdb-batch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch.js","sourceRoot":"","sources":["../../src/local/duckdb-batch.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAIhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,8PAA8P;AAC9P,MAAM,CAAC,MAAM,uBAAuB,GAAG,MAAM,CAAC,EAAE,CAAC,iCAAiC,CAAC,CACjF,QAAQ,CAAC,EACP,UAAgC,EAChC,OAA+B,EAC/B,UAAkB,EAClB,SAA2B;IAE3B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,kBAAkB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAC3E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,mBAAmB,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAClE,OAAO,KAAK,CAAC,CAAC,iBAAiB,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;AACpE,CAAC,EACD,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,MAAM,CAAC,CAClD,CAAC"}

package/dist/local/duckdb-batch.types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Owns duckdb batch.types for the optional local history store.
+ * Shared records and query contracts come from lightweight observability; native
+ * handles and worker lifetimes remain owned by this storage package.
+ */
+import type { ObservabilityRecord } from "@relkit/observability";
+import type { LocalRecord } from "@relkit/observability/local/record";
+/** Validated and redacted envelope retained until its transaction commits. */
+export interface PreparedDuckdbRecord {
+    readonly item: LocalRecord;
+    readonly safe: ObservabilityRecord;
+    readonly payload: string;
+}
+/** Cursor assignment validated before inserting the record payload. */
+export interface AssignedDuckdbRecord {
+    readonly prepared: PreparedDuckdbRecord;
+    readonly cursor: string;
+}
+//# sourceMappingURL=duckdb-batch.types.d.ts.map

package/dist/local/duckdb-batch.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch.types.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-batch.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEtE,8EAA8E;AAC9E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/local/duckdb-batch.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=duckdb-batch.types.js.map

package/dist/local/duckdb-batch.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-batch.types.js","sourceRoot":"","sources":["../../src/local/duckdb-batch.types.ts"],"names":[],"mappings":""}

package/dist/local/duckdb-database-effect.d.ts

@@ -0,0 +1,88 @@
+import { Context, Effect, Layer } from "effect";
+import type { RedactionPolicy } from "@relkit/observability";
+import type { TelemetryLocalRetentionPolicy } from "@relkit/observability";
+import type { DuckdbDatabaseEffects } from "./duckdb-database.types.js";
+import { DuckdbDriverService } from "./duckdb-driver.js";
+declare const DuckdbDatabaseService_base: Context.ServiceClass<DuckdbDatabaseService, "@relkit/observability/DuckdbDatabase", DuckdbDatabaseEffects> & {
+    readonly make: (root: string, configured?: TelemetryLocalRetentionPolicy | undefined, redaction?: RedactionPolicy | undefined) => Effect.Effect<DuckdbDatabaseEffects, import("./duckdb-error.js").DuckdbError, import("effect/Scope").Scope | DuckdbDriverService>;
+};
+/**
+ * Database operations provided for one owned Effect Scope.
+ *
+ * @example
+ * const database = yield* DuckdbDatabaseService;
+ * yield* database.flush();
+ */
+export declare class DuckdbDatabaseService extends DuckdbDatabaseService_base {
+}
+/**
+ * Acquires an instance and connection in the caller's Scope, initializes schema,
+ * and returns Effect operations. Scope finalizers close the connection first,
+ * then the instance, including on setup failure or interruption.
+ *
+ * @param root - Private local storage directory.
+ * @param configured - Initial retention policy.
+ * @param redaction - Initial redaction policy.
+ * @returns A scoped database service or a tagged DuckdbError.
+ * @example
+ * const database = yield* openDuckdbDatabaseEffect(root);
+ * yield* database.flush();
+ */
+export declare const openDuckdbDatabaseEffect: (root: string, configured?: TelemetryLocalRetentionPolicy | undefined, redaction?: RedactionPolicy | undefined) => Effect.Effect<{
+    imported: {
+        records: number;
+        malformed: number;
+    };
+    append: (records: readonly import("@relkit/observability/local/record").LocalRecord[]) => Effect.Effect<import("@relkit/observability/local/record").StoredLocalRecord[], import("./duckdb-error.js").DuckdbError>;
+    configure: (retention: TelemetryLocalRetentionPolicy, redaction?: RedactionPolicy) => Effect.Effect<void, import("./duckdb-error.js").DuckdbError>;
+    flush: () => Effect.Effect<void, import("./duckdb-error.js").DuckdbError>;
+    list: (kind: "logs" | "requests" | "traces", input?: import("@relkit/observability").ObservabilityQueryRequest | undefined) => Effect.Effect<import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord>, import("./duckdb-query-error.js").DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>;
+    detail: (kind: "trace" | "request" | "log", id: string) => Effect.Effect<{
+        log: import("@relkit/observability/local/record").StoredLocalRecord;
+        items: readonly never[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | {
+        request: import("@relkit/observability").RequestRecord;
+        spans: readonly import("@relkit/observability").SpanRecord[];
+        roots: readonly import("@relkit/observability").SpanNode[];
+        continuations: readonly {
+            readonly traceId: string;
+            readonly active: boolean;
+        }[];
+        records: readonly import("@relkit/observability").ObservabilityRecord[];
+        counts: {
+            readonly records: number;
+            readonly spans: number;
+            readonly continuations: number;
+        };
+        incomplete: readonly string[];
+        items: readonly never[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | {
+        trace: import("@relkit/observability/local/record").StoredLocalRecord | undefined;
+        spans: import("@relkit/observability").SpanRecord[];
+        records: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+        items: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | undefined, import("./duckdb-query-error.js").DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>;
+}, import("./duckdb-error.js").DuckdbError, import("effect/Scope").Scope | DuckdbDriverService>;
+/**
+ * Provides a scoped database service using an injectable DuckdbDriverService.
+ *
+ * @param root - Private local storage directory.
+ * @param configured - Initial retention policy.
+ * @param redaction - Initial redaction policy.
+ * @returns A Layer whose scope owns both native DuckDB handles.
+ * @example
+ * const program = Effect.gen(function* () { return yield* DuckdbDatabaseService; });
+ * const layer = duckdbDatabaseLayer(root);
+ */
+export declare function duckdbDatabaseLayer(root: string, configured?: TelemetryLocalRetentionPolicy, redaction?: RedactionPolicy): Layer.Layer<DuckdbDatabaseService, import("./duckdb-error.js").DuckdbError, DuckdbDriverService>;
+export {};
+//# sourceMappingURL=duckdb-database-effect.d.ts.map

package/dist/local/duckdb-database-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-database-effect.d.ts","sourceRoot":"","sources":["../../src/local/duckdb-database-effect.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAa,MAAM,QAAQ,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;;;;AAOzD;;;;;;GAMG;AAEH,qBAAa,qBAAsB,SAAQ,0BAKzC;CAAG;AACL;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,wBAAwB;;;;;;mEAZO,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+FAiD3C,CAAC;AACH;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,6BAAkC,EAC9C,SAAS,CAAC,EAAE,eAAe,oGAM5B"}

package/dist/local/duckdb-database-effect.js

@@ -0,0 +1,81 @@
+/**
+ * Owns duckdb database effect for the optional local history store.
+ * Shared records and query contracts come from lightweight observability; native
+ * handles and worker lifetimes remain owned by this storage package.
+ */
+import { chmod, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { Context, Effect, Layer, Semaphore } from "effect";
+import { DuckdbDriverService } from "./duckdb-driver.js";
+import { duckdbError } from "./duckdb-error.js";
+import { observeDuckdb } from "./duckdb-metrics.js";
+import { makeDuckdbQueryEffect } from "./duckdb-query-effect.js";
+import { initializeDuckdbSchema } from "./duckdb-schema.js";
+import { makeDuckdbStorage } from "./duckdb-storage.js";
+import { importLocalHistoryEffect } from "./import-history-effect.js";
+/**
+ * Database operations provided for one owned Effect Scope.
+ *
+ * @example
+ * const database = yield* DuckdbDatabaseService;
+ * yield* database.flush();
+ */
+// prettier-ignore
+export class DuckdbDatabaseService extends Context.Service()("@relkit/observability/DuckdbDatabase", {
+    make: (root, configured = {}, redaction) => openDuckdbDatabaseEffect(root, configured, redaction),
+}) {
+}
+/**
+ * Acquires an instance and connection in the caller's Scope, initializes schema,
+ * and returns Effect operations. Scope finalizers close the connection first,
+ * then the instance, including on setup failure or interruption.
+ *
+ * @param root - Private local storage directory.
+ * @param configured - Initial retention policy.
+ * @param redaction - Initial redaction policy.
+ * @returns A scoped database service or a tagged DuckdbError.
+ * @example
+ * const database = yield* openDuckdbDatabaseEffect(root);
+ * yield* database.flush();
+ */
+export const openDuckdbDatabaseEffect = Effect.fn("ObservabilityDuckdb.open")(function* (root, configured = {}, redaction) {
+    return yield* observeDuckdb("open", Effect.gen(function* () {
+        const driver = yield* DuckdbDriverService;
+        yield* Effect.tryPromise({
+            try: () => mkdir(root, { recursive: true, mode: 0o700 }),
+            catch: (cause) => duckdbError("mkdir", cause),
+        });
+        const path = join(root, "observability.duckdb");
+        const instance = yield* Effect.acquireRelease(driver.create(path), (owned) => Effect.sync(() => owned.closeSync()));
+        const connection = yield* Effect.acquireRelease(Effect.tryPromise({
+            try: () => instance.connect(),
+            catch: (cause) => duckdbError("connect", cause),
+        }), (owned) => Effect.sync(() => owned.closeSync()));
+        yield* Effect.tryPromise({
+            try: () => chmod(path, 0o600),
+            catch: (cause) => duckdbError("chmod", cause),
+        });
+        yield* initializeDuckdbSchema(connection);
+        const permit = yield* Semaphore.make(1);
+        const storage = makeDuckdbStorage(connection, permit, configured, redaction);
+        const query = makeDuckdbQueryEffect(connection, permit);
+        const imported = yield* importLocalHistoryEffect(root, connection, storage.append);
+        yield* storage.flush();
+        return { ...query, ...storage, imported };
+    }));
+});
+/**
+ * Provides a scoped database service using an injectable DuckdbDriverService.
+ *
+ * @param root - Private local storage directory.
+ * @param configured - Initial retention policy.
+ * @param redaction - Initial redaction policy.
+ * @returns A Layer whose scope owns both native DuckDB handles.
+ * @example
+ * const program = Effect.gen(function* () { return yield* DuckdbDatabaseService; });
+ * const layer = duckdbDatabaseLayer(root);
+ */
+export function duckdbDatabaseLayer(root, configured = {}, redaction) {
+    return Layer.effect(DuckdbDatabaseService, DuckdbDatabaseService.make(root, configured, redaction));
+}
+//# sourceMappingURL=duckdb-database-effect.js.map

package/dist/local/duckdb-database-effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duckdb-database-effect.js","sourceRoot":"","sources":["../../src/local/duckdb-database-effect.ts"],"names":[],"mappings":"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"}

package/dist/local/duckdb-database.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Owns duckdb database for the optional local history store.
+ * Shared records and query contracts come from lightweight observability; native
+ * handles and worker lifetimes remain owned by this storage package.
+ */
+import { Effect } from "effect";
+import type { RedactionPolicy } from "@relkit/observability";
+import type { TelemetryLocalRetentionPolicy } from "@relkit/observability";
+import { DuckdbQueryError } from "./duckdb-query-error.js";
+/**
+ * Opens a private DuckDB database and owns its Effect Scope until close.
+ * The scoped Effect implementation contains acquisition and operation logic.
+ *
+ * @param root - Directory containing the local database file.
+ * @param configured - Initial retention policy.
+ * @param redaction - Initial redaction policy.
+ * @returns A live Promise API with append, query, configure, flush, and close.
+ * @throws {DuckdbError} If acquisition, storage, or import fails.
+ * @example
+ * const database = await openDuckdbDatabase(root);
+ * await database.close();
+ */
+export declare function openDuckdbDatabase(root: string, configured?: TelemetryLocalRetentionPolicy, redaction?: RedactionPolicy): Promise<{
+    imported: {
+        records: number;
+        malformed: number;
+    };
+    append: (records: Parameters<(records: readonly import("@relkit/observability/local/record").LocalRecord[]) => Effect.Effect<import("@relkit/observability/local/record").StoredLocalRecord[], import("./duckdb-error.js").DuckdbError>>[0]) => Promise<import("@relkit/observability/local/record").StoredLocalRecord[]>;
+    list: (kind: Parameters<(kind: "logs" | "requests" | "traces", input?: import("@relkit/observability").ObservabilityQueryRequest | undefined) => Effect.Effect<import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord>, DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>>[0], input?: Parameters<(kind: "logs" | "requests" | "traces", input?: import("@relkit/observability").ObservabilityQueryRequest | undefined) => Effect.Effect<import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord>, DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>>[1]) => Promise<import("@relkit/observability").ObservabilityQueryPage<import("@relkit/observability/local/record").StoredLocalRecord>>;
+    detail: (kind: Parameters<(kind: "trace" | "request" | "log", id: string) => Effect.Effect<{
+        log: import("@relkit/observability/local/record").StoredLocalRecord;
+        items: readonly never[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | {
+        request: import("@relkit/observability").RequestRecord;
+        spans: readonly import("@relkit/observability").SpanRecord[];
+        roots: readonly import("@relkit/observability").SpanNode[];
+        continuations: readonly {
+            readonly traceId: string;
+            readonly active: boolean;
+        }[];
+        records: readonly import("@relkit/observability").ObservabilityRecord[];
+        counts: {
+            readonly records: number;
+            readonly spans: number;
+            readonly continuations: number;
+        };
+        incomplete: readonly string[];
+        items: readonly never[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | {
+        trace: import("@relkit/observability/local/record").StoredLocalRecord | undefined;
+        spans: import("@relkit/observability").SpanRecord[];
+        records: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+        items: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | undefined, DuckdbQueryError | import("./duckdb-error.js").DuckdbError, never>>[0], id: string) => Promise<{
+        log: import("@relkit/observability/local/record").StoredLocalRecord;
+        items: readonly never[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | {
+        request: import("@relkit/observability").RequestRecord;
+        spans: readonly import("@relkit/observability").SpanRecord[];
+        roots: readonly import("@relkit/observability").SpanNode[];
+        continuations: readonly {
+            readonly traceId: string;
+            readonly active: boolean;
+        }[];
+        records: readonly import("@relkit/observability").ObservabilityRecord[];
+        counts: {
+            readonly records: number;
+            readonly spans: number;
+            readonly continuations: number;
+        };
+        incomplete: readonly string[];
+        items: readonly never[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | {
+        trace: import("@relkit/observability/local/record").StoredLocalRecord | undefined;
+        spans: import("@relkit/observability").SpanRecord[];
+        records: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+        items: readonly import("@relkit/observability/local/record").StoredLocalRecord[];
+        nextCursor?: string;
+        protocol: typeof import("@relkit/observability").OBSERVABILITY_QUERY_PROTOCOL;
+        version: typeof import("@relkit/observability").OBSERVABILITY_QUERY_VERSION;
+    } | undefined>;
+    configure: (value: TelemetryLocalRetentionPolicy, nextRedaction?: RedactionPolicy) => Promise<void>;
+    flush: () => Promise<void>;
+    close: () => Promise<void>;
+}>;
+//# sourceMappingURL=duckdb-database.d.ts.map