@bjornpagen/bumbledb 1.3.0 → 2.0.0-rc.1

package/src/query/parse-ir.ts

@@ -1,291 +0,0 @@
-import { AuthoringError } from "#errors.ts"
-import type {
-	AtomIr,
-	CmpOpIr,
-	ConditionTreeIr,
-	FindTermIr,
-	HeadTermIr,
-	ParsedQuery,
-	QueryIr,
-	RuleIr,
-	ScalarExprIr,
-	TermIr
-} from "#native.ts"
-import { roundingMode } from "#scalar.ts"
-import { arrayValue as array, recordValue, valueDescriptor } from "#values.ts"
-
-function fail(context: string, expected: string): never {
-	throw new AuthoringError({
-		message: `${context}: ${expected}`,
-		diagnostic: { code: "InvalidQuery", context, expected }
-	})
-}
-
-function tagged(context: string, input: unknown): Readonly<Record<string, unknown>> {
-	if (typeof input !== "object" || input === null) return fail(context, "expected a descriptor record")
-	return recordValue(context, input, Object.keys(input))
-}
-
-function ordinal(context: string, input: unknown, maximum = 0xffff): number {
-	if (typeof input !== "number" || !Number.isInteger(input) || input < 0 || input > maximum)
-		return fail(context, `expected an ordinal from 0 through ${maximum}`)
-	return input
-}
-
-function term(context: string, input: unknown): TermIr {
-	const raw = tagged(context, input)
-	switch (raw.kind) {
-		case "var":
-			recordValue(context, raw, ["kind", "var"])
-			return Object.freeze({ kind: raw.kind, var: ordinal(context, raw.var) })
-		case "param":
-		case "paramSet":
-			recordValue(context, raw, ["kind", "param"])
-			return Object.freeze({ kind: raw.kind, param: ordinal(context, raw.param) })
-		case "literal":
-			recordValue(context, raw, ["kind", "value"])
-			return Object.freeze({ kind: raw.kind, value: valueDescriptor(`${context}.value`, raw.value) })
-		default:
-			return fail(context, "unknown term kind")
-	}
-}
-
-function scalar(context: string, input: unknown, depth = 1): ScalarExprIr {
-	if (depth > 128) return fail(context, "scalar expression deeper than 128")
-	const raw = tagged(context, input)
-	switch (raw.kind) {
-		case "var":
-			recordValue(context, raw, ["kind", "var"])
-			return Object.freeze({ kind: raw.kind, var: ordinal(context, raw.var) })
-		case "literal":
-			recordValue(context, raw, ["kind", "value"])
-			return Object.freeze({ kind: raw.kind, value: valueDescriptor(`${context}.value`, raw.value) })
-		case "measure":
-		case "negate":
-		case "isNaN":
-		case "isFinite":
-			recordValue(context, raw, ["kind", "expr"])
-			return Object.freeze({ kind: raw.kind, expr: scalar(`${context}.expr`, raw.expr, depth + 1) })
-		case "add":
-		case "subtract":
-		case "multiply":
-		case "divide":
-			recordValue(context, raw, ["kind", "left", "right"])
-			return Object.freeze({
-				kind: raw.kind,
-				left: scalar(`${context}.left`, raw.left, depth + 1),
-				right: scalar(`${context}.right`, raw.right, depth + 1)
-			})
-		case "mulDiv":
-			recordValue(context, raw, ["kind", "a", "b", "divisor", "rounding"])
-			return Object.freeze({
-				kind: raw.kind,
-				a: scalar(`${context}.a`, raw.a, depth + 1),
-				b: scalar(`${context}.b`, raw.b, depth + 1),
-				divisor: scalar(`${context}.divisor`, raw.divisor, depth + 1),
-				rounding: roundingMode(raw.rounding)
-			})
-		case "cast": {
-			recordValue(context, raw, ["kind", "cast", "expr"])
-			const cast = raw.cast
-			if (cast !== "toF64" && cast !== "toF64Exact" && cast !== "toI64Exact" && cast !== "toU64Exact")
-				return fail(context, "unknown numeric cast")
-			return Object.freeze({ kind: raw.kind, cast, expr: scalar(`${context}.expr`, raw.expr, depth + 1) })
-		}
-		default:
-			return fail(context, "unknown scalar expression kind")
-	}
-}
-
-function headTerm(context: string, input: unknown): HeadTermIr {
-	const raw = tagged(context, input)
-	if (raw.kind === "var" || raw.kind === "compute") {
-		recordValue(context, raw, ["kind"])
-		return Object.freeze({ kind: raw.kind })
-	}
-	recordValue(context, raw, ["kind", "op"])
-	if (raw.kind !== "aggregate") return fail(context, "unknown head kind")
-	const op = raw.op
-	if (op !== "sum" && op !== "mean" && op !== "min" && op !== "max" && op !== "count" && op !== "pack")
-		return fail(context, "unknown head aggregate")
-	return Object.freeze({ kind: raw.kind, op })
-}
-
-function find(context: string, input: unknown): FindTermIr {
-	const raw = tagged(context, input)
-	if (raw.kind === "segments") {
-		recordValue(context, raw, ["kind", "op", "left", "right"])
-		if (raw.op !== "intersection" && raw.op !== "difference") return fail(context, "unknown segment operator")
-		return Object.freeze({
-			kind: raw.kind,
-			op: raw.op,
-			left: ordinal(context, raw.left),
-			right: ordinal(context, raw.right)
-		})
-	}
-	switch (raw.kind) {
-		case "var":
-			recordValue(context, raw, ["kind", "var"])
-			return Object.freeze({ kind: raw.kind, var: ordinal(context, raw.var) })
-		case "count":
-			if (Object.hasOwn(raw, "over")) return fail(context, "Count carries no over")
-			recordValue(context, raw, ["kind"])
-			return Object.freeze({ kind: raw.kind })
-		case "compute":
-			if (!Object.hasOwn(raw, "expr")) return fail(context, "compute requires expr")
-			recordValue(context, raw, ["kind", "expr"])
-			return Object.freeze({ kind: raw.kind, expr: scalar(`${context}.expr`, raw.expr) })
-		case "pack":
-			recordValue(context, raw, ["kind", "over"])
-			return Object.freeze({ kind: raw.kind, over: ordinal(context, raw.over) })
-		case "aggregate": {
-			recordValue(context, raw, ["kind", "op", "over"])
-			const op = recordValue(`${context}.op`, raw.op, ["kind"]).kind
-			if (op !== "sum" && op !== "mean" && op !== "min" && op !== "max") return fail(context, "unknown fold operator")
-			return Object.freeze({ kind: raw.kind, op: Object.freeze({ kind: op }), over: ordinal(context, raw.over) })
-		}
-		default:
-			return fail(context, "unknown find kind")
-	}
-}
-
-function atom(context: string, input: unknown): AtomIr {
-	const raw = recordValue(context, input, ["source", "bindings"])
-	const source = tagged(`${context}.source`, raw.source)
-	let owned: AtomIr["source"]
-	if (source.kind === "edb") {
-		recordValue(context, source, ["kind", "relation"])
-		owned = { kind: source.kind, relation: ordinal(`${context}.source.relation`, source.relation, 0xffffffff) }
-	} else if (source.kind === "interior") {
-		recordValue(context, source, ["kind", "interior"])
-		owned = { kind: source.kind, interior: ordinal(`${context}.source.interior`, source.interior, 0xffffffff) }
-	} else return fail(context, "unknown atom source")
-	const seen = new Set<number>()
-	const bindings = array(`${context}.bindings`, raw.bindings, (path, pair): readonly [number, TermIr] => {
-		const cells = array(path, pair, (_, value) => value)
-		if (cells.length !== 2) return fail(path, "a binding has exactly two elements")
-		const field = ordinal(`${path}[0]`, cells[0])
-		if (seen.has(field)) return fail(path, "duplicate field binding")
-		seen.add(field)
-		return Object.freeze([field, term(`${path}[1]`, cells[1])])
-	})
-	return Object.freeze({ source: Object.freeze(owned), bindings })
-}
-
-function comparisonOp(context: string, input: unknown): CmpOpIr {
-	const raw = tagged(context, input)
-	if (raw.kind === "allen") {
-		recordValue(context, raw, ["kind", "mask"])
-		return Object.freeze({ kind: raw.kind, mask: ordinal(`${context}.mask`, raw.mask, 0x1fff) })
-	}
-	recordValue(context, raw, ["kind"])
-	const kind = raw.kind
-	if (
-		kind !== "eq" &&
-		kind !== "ne" &&
-		kind !== "lt" &&
-		kind !== "le" &&
-		kind !== "gt" &&
-		kind !== "ge" &&
-		kind !== "pointIn"
-	)
-		return fail(context, "unknown comparison operator")
-	return Object.freeze({ kind })
-}
-
-function condition(context: string, input: unknown, depth = 1): ConditionTreeIr {
-	if (depth > 64) return fail(context, "condition tree deeper than 64")
-	const raw = tagged(context, input)
-	if (raw.kind === "leaf") {
-		recordValue(context, raw, ["kind", "cmp"])
-		const cmp = recordValue(`${context}.cmp`, raw.cmp, ["op", "lhs", "rhs"])
-		return Object.freeze({
-			kind: raw.kind,
-			cmp: Object.freeze({
-				op: comparisonOp(`${context}.cmp.op`, cmp.op),
-				lhs: term(`${context}.cmp.lhs`, cmp.lhs),
-				rhs: term(`${context}.cmp.rhs`, cmp.rhs)
-			})
-		})
-	}
-	if (raw.kind !== "and" && raw.kind !== "or") return fail(context, "unknown condition kind")
-	recordValue(context, raw, ["kind", "children"])
-	return Object.freeze({
-		kind: raw.kind,
-		children: array(`${context}.children`, raw.children, (path, value) => condition(path, value, depth + 1))
-	})
-}
-
-function rule(context: string, input: unknown): RuleIr {
-	const raw = recordValue(context, input, ["finds", "atoms", "negated", "conditions"])
-	return Object.freeze({
-		finds: array(`${context}.finds`, raw.finds, find),
-		atoms: array(`${context}.atoms`, raw.atoms, atom),
-		negated: array(`${context}.negated`, raw.negated, atom),
-		conditions: array(`${context}.conditions`, raw.conditions, condition)
-	})
-}
-
-function align(context: string, head: readonly HeadTermIr[], rules: readonly RuleIr[]): void {
-	for (const [index, rule] of rules.entries()) {
-		if (rule.finds.length !== head.length) fail(`${context}.rules[${index}]`, "finds width does not match head width")
-		for (const [position, find] of rule.finds.entries()) {
-			const term = head[position]
-			const plainFamily = find.kind === "var" || find.kind === "compute" ? find.kind : "aggregate"
-			const family = find.kind === "segments" ? "compute" : plainFamily
-			if (term?.kind !== family)
-				fail(`${context}.rules[${index}].finds[${position}]`, "find family does not match head")
-			if (term.kind === "aggregate") {
-				const op = find.kind === "aggregate" ? find.op.kind : find.kind
-				if (op !== term.op)
-					fail(`${context}.rules[${index}].finds[${position}]`, "aggregate operator does not match head")
-			}
-		}
-	}
-}
-
-/**
- * Own and validate the complete wire grammar. The native compiler then
- * checks schema membership, binding types, safety and recursion semantics;
- * parsing alone does not assert that a query is admitted by a schema.
- */
-function parseQueryIr(input: unknown): ParsedQuery {
-	const raw = tagged("query", input)
-	if (raw.kind !== "cq" && raw.kind !== "reach") return fail("query", "unknown query kind")
-	recordValue(
-		"query",
-		raw,
-		raw.kind === "cq" ? ["kind", "interiors", "head", "rules"] : ["kind", "interiors", "rec", "head", "rules"]
-	)
-	const rules = array("query.rules", raw.rules, rule)
-	if (rules.length === 0) return fail("parseQueryIr", "main rules are empty")
-	const head = array("query.head", raw.head, headTerm)
-	align("query", head, rules)
-	const interiors = array("query.interiors", raw.interiors, (path, input) => {
-		const raw = recordValue(path, input, ["head", "rules"])
-		const head = array(`${path}.head`, raw.head, headTerm)
-		const rules = array(`${path}.rules`, raw.rules, rule)
-		if (rules.length === 0) return fail(path, "interior rules are empty")
-		align(path, head, rules)
-		return Object.freeze({ head, rules })
-	})
-	let owned: QueryIr
-	if (raw.kind === "cq") owned = { kind: raw.kind, interiors, head, rules }
-	else {
-		const rawRec = recordValue("query.rec", raw.rec, ["head", "base", "rec"])
-		const headRec = array("query.rec.head", rawRec.head, headTerm)
-		const base = array("query.rec.base", rawRec.base, rule)
-		if (base.length === 0) return fail("parseQueryIr", "rec base is empty")
-		const rec = array("query.rec.rec", rawRec.rec, rule)
-		if (rec.length === 0) return fail("parseQueryIr", "rec step is empty")
-		align("rec base", headRec, base)
-		align("rec step", headRec, rec)
-		if (headRec.some((term) => term.kind !== "var") || [...base, ...rec].some((rule) => rule.negated.length !== 0))
-			return fail("query.rec", "recursion requires projection-only heads and no negation")
-		owned = { kind: raw.kind, interiors, head, rules, rec: Object.freeze({ head: headRec, base, rec }) }
-	}
-	return Object.freeze(owned) as ParsedQuery
-}
-
-export type { ParsedQuery }
-export { parseQueryIr }

package/src/runtime-codes.ts

@@ -1,17 +0,0 @@
-// Generated from the exact native runtimeErrorCodes export; do not edit.
-export const runtimeErrorCodes = [
-	"RuntimeAlreadyLive",
-	"ForeignRuntime",
-	"ClosedHandle",
-	"SpentHandle",
-	"QueueFull",
-	"InvalidArgument",
-	"Internal",
-	"DirectoryBusy",
-	"WriterBusy",
-	"InvalidPath",
-	"Io",
-	"ResourceLimit",
-	"Engine",
-	"Cancelled"
-] as const

package/src/runtime-errors.ts

@@ -1,109 +0,0 @@
-import { Schema } from "effect"
-import { AuthoringDiagnostic, AuthoringError } from "#errors.ts"
-import { runtimeErrorCodes } from "#runtime-codes.ts"
-
-export { runtimeErrorCodes } from "#runtime-codes.ts"
-
-const ResourceLimit = Schema.Struct({
-	_tag: Schema.Literal("ResourceLimit"),
-	dimension: Schema.String,
-	used: Schema.BigInt,
-	requested: Schema.BigInt,
-	limit: Schema.BigInt
-})
-const PlainReason = Schema.Struct({
-	_tag: Schema.Literals(
-		runtimeErrorCodes.filter(
-			(code) => code !== "ResourceLimit" && code !== "Io" && code !== "Engine" && code !== "InvalidArgument"
-		)
-	)
-})
-const InvalidArgument = Schema.Struct({
-	_tag: Schema.Literal("InvalidArgument"),
-	detail: Schema.optional(
-		Schema.Struct({
-			message: Schema.String,
-			diagnostic: Schema.optional(AuthoringDiagnostic)
-		})
-	)
-})
-const Io = Schema.Struct({
-	_tag: Schema.Literal("Io"),
-	kind: Schema.String,
-	osCode: Schema.optional(Schema.Number)
-})
-/** A typed engine refusal crossing the executor: core family tag + message. */
-const Engine = Schema.Struct({
-	_tag: Schema.Literal("Engine"),
-	kind: Schema.String,
-	message: Schema.String
-})
-export const DbReason = Schema.Union([ResourceLimit, Io, Engine, InvalidArgument, PlainReason])
-export class DbError extends Schema.TaggedError<DbError>()("DbError", {
-	operation: Schema.String,
-	reason: DbReason
-}) {
-	get code() {
-		return this.reason._tag
-	}
-	/** Safe default display; callers explicitly inspect structured detail. */
-	override get message(): string {
-		return `${this.operation}: ${this.code}`
-	}
-}
-
-const decodeReason = Schema.decodeUnknownOption(DbReason)
-export function dbError(operation: string, cause: unknown): DbError {
-	if (cause instanceof DbError) return cause
-	if (cause instanceof AuthoringError) return argumentError(operation, cause)
-	const decoded = decodeReason(cause)
-	if (decoded._tag === "Some") return new DbError({ operation, reason: decoded.value })
-	// Synchronous native schema/marshalling refusals precede the executor's
-	// tagged error wire. Preserve their engine family instead of losing it.
-	if (
-		typeof cause === "object" &&
-		cause !== null &&
-		"kind" in cause &&
-		typeof cause.kind === "string" &&
-		"message" in cause &&
-		typeof cause.message === "string"
-	) {
-		return new DbError({ operation, reason: { _tag: "Engine", kind: cause.kind, message: cause.message } })
-	}
-	return new DbError({ operation, reason: { _tag: "Internal" } })
-}
-
-/** Host input failures retain authoring details without displaying values. */
-export function argumentError(operation: string, cause: unknown): DbError {
-	if (cause instanceof DbError) return cause
-	if (cause instanceof AuthoringError) {
-		const detail =
-			cause.diagnostic === undefined
-				? { message: cause.message }
-				: { message: cause.message, diagnostic: cause.diagnostic }
-		return new DbError({ operation, reason: { _tag: "InvalidArgument", detail } })
-	}
-	return new DbError({ operation, reason: { _tag: "InvalidArgument" } })
-}
-
-const Outstanding = Schema.Struct({
-	phase: Schema.Literals(["open", "closing", "closed"]),
-	queued: Schema.BigInt,
-	active: Schema.BigInt,
-	retained: Schema.BigInt,
-	owners: Schema.BigInt,
-	databases: Schema.BigInt,
-	natives: Schema.BigInt
-})
-export type OutstandingWork = typeof Outstanding.Type
-const Close = Schema.Union([
-	Schema.Struct({ kind: Schema.Literal("closed") }),
-	Schema.Struct({ kind: Schema.Literal("incomplete"), outstanding: Outstanding }),
-	Schema.Struct({ kind: Schema.Literal("failed"), error: DbError })
-])
-export type CloseReport = typeof Close.Type
-
-export class CloseFailure extends Schema.TaggedError<CloseFailure>()("CloseFailure", {
-	operation: Schema.String,
-	report: Close
-}) {}

package/src/runtime-native.ts

@@ -1,189 +0,0 @@
-/** Exact-version internal bridge, shared by core and log. Not a public API. */
-
-import type {
-	DbHandle,
-	LogChainKind,
-	LogCommandKind,
-	LogCommandMetadata,
-	LogCommandRef,
-	LogCondition,
-	LogDecisionStamp,
-	LogIdentity,
-	LogLimits,
-	LogOutcomeWire,
-	LogSchemaHandle,
-	LogStateStamp,
-	Violation
-} from "#native.ts"
-import { native } from "#native.ts"
-import type { SchemaSpec } from "#spec.ts"
-
-export interface RuntimeHandle {
-	readonly __runtime: unique symbol
-}
-export interface OperationHandle {
-	readonly __operation: unique symbol
-}
-export interface DirectoryHandle {
-	readonly __directory: unique symbol
-}
-
-/** Stamped `NativeKind::RepositoryLock` mint — not a directory-owner twin. */
-export interface RepositoryLockHandle {
-	readonly __repositoryLock: unique symbol
-}
-
-/** Resource kinds installed in native worker tables. */
-export type NativeKind = "snapshot" | "prepared" | "result" | "cursor" | "draft" | "changes" | "repository-lock"
-
-/**
- * Checked capability into the native registry. JS tokens validate
- * these five fields; native re-judges kind/generation/owner on every verb.
- */
-export interface Capability {
-	readonly runtime: bigint
-	readonly worker: number
-	readonly kind: NativeKind
-	readonly id: bigint
-	readonly generation: bigint
-}
-
-export type ManagedDbOutcome =
-	| { readonly tag: "accepted"; readonly db: DbHandle }
-	| { readonly tag: "rejected"; readonly violations: readonly Violation[] }
-	| {
-			readonly tag: "refused"
-			readonly kind: "schemaError" | "newtypeMismatch" | "fingerprintMismatch" | "destinationExists"
-			readonly message: string
-	  }
-
-export type LogTakeWire =
-	| { readonly ok: false; readonly kind: LogCommandKind | LogChainKind; readonly message: string }
-	| {
-			/** Command sealed: envelope bytes + reference. */
-			readonly ok: true
-			readonly bytes: Uint8Array
-			readonly ref: LogCommandRef
-	  }
-	| {
-			/** Command parsed. */
-			readonly ok: true
-			readonly identity: LogIdentity
-			readonly receiptEpoch: bigint
-			readonly requestId: string
-			readonly condition: LogCondition
-			readonly changes: Uint8Array
-			readonly result: Uint8Array
-			readonly ref: LogCommandRef
-	  }
-	| {
-			/** Decision framed. */
-			readonly ok: true
-			readonly bytes: Uint8Array
-			readonly digest: Uint8Array
-	  }
-	| {
-			/** Decision decoded (and chain-verified when a parent was given). */
-			readonly ok: true
-			readonly identity: LogIdentity
-			readonly seq: bigint
-			readonly parent: LogDecisionStamp
-			readonly beforeState: LogStateStamp
-			readonly afterState: LogStateStamp
-			readonly commandBytes: Uint8Array
-			readonly command: LogCommandRef
-			readonly outcome: LogOutcomeWire
-			readonly digest: Uint8Array
-	  }
-
-export interface OptionsWire {
-	readonly workers?: number | undefined
-	readonly queueCapacity?: number | undefined
-	readonly cleanupCapacity?: number | undefined
-	readonly ownerCapacity?: number | undefined
-	readonly nativeHandleCapacity?: number | undefined
-	readonly cleanupTimeoutMs?: number | undefined
-}
-
-export interface InspectionWire {
-	readonly phase: "open" | "closing" | "closed"
-	readonly queued: bigint
-	readonly active: bigint
-	readonly retained: bigint
-	readonly owners: bigint
-	readonly databases: bigint
-	readonly natives: bigint
-}
-
-export type CloseWire =
-	| { readonly kind: "closed" }
-	| { readonly kind: "incomplete"; readonly outstanding: InspectionWire }
-	| { readonly kind: "failed" }
-
-interface RuntimeNative {
-	runtimeErrorCodes(): readonly string[]
-	runtimeOpen(options: OptionsWire): RuntimeHandle
-	runtimeReady(runtime: RuntimeHandle, callback: () => void): OperationHandle
-	runtimeHash(runtime: RuntimeHandle, bytes: Uint8Array, callback: () => void): OperationHandle
-	runtimeTake(operation: OperationHandle): Uint8Array | null
-	runtimeCancel(operation: OperationHandle, callback: (report: CloseWire) => void): void
-	runtimeClose(runtime: RuntimeHandle, callback: (report: CloseWire) => void): void
-	runtimeInspect(runtime: RuntimeHandle): InspectionWire
-	/**
-	 * L12 request (D12/D25): one-shot arm. Next `dispatch_payload_message`
-	 * must cancel after `work()` returns and the post-work `checkpoint()`
-	 * (`runtime.rs` ~860–862), before `complete_operation` writes
-	 * `operation.output`. A local `QueuedOutput` is not registration.
-	 * Predelivery: no JS take; cursor stays on row1 so retry does not skip.
-	 */
-	runtimeArmPublicationCancel(runtime: RuntimeHandle): void
-	runtimeDirectoryAcquire(runtime: RuntimeHandle, path: string, callback: () => void): OperationHandle
-	runtimeDirectoryTake(operation: OperationHandle): DirectoryHandle
-	runtimeDirectoryBegin(owner: DirectoryHandle): OperationHandle
-	runtimeDirectoryCheck(operation: OperationHandle): void
-	runtimeDirectoryEnd(operation: OperationHandle): void
-	runtimeDirectoryClose(owner: DirectoryHandle, remove: boolean, callback: (report: CloseWire) => void): void
-	runtimeDirectoryDbOpen(
-		owner: DirectoryHandle,
-		childName: string,
-		spec: SchemaSpec,
-		create: boolean,
-		callback: () => void
-	): OperationHandle
-	runtimeDbTake(operation: OperationHandle): ManagedDbOutcome
-	runtimeManagedDbClose(db: DbHandle, callback: (report: CloseWire) => void): void
-
-	// --- successor log grammar on the executor (hashing over
-	// whole canonical change payloads; C06 through C09) ---
-	runtimeLogCommandSeal(
-		runtime: RuntimeHandle,
-		schema: LogSchemaHandle,
-		metadata: LogCommandMetadata,
-		changes: Uint8Array,
-		result: Uint8Array | null,
-		limits: LogLimits,
-		callback: () => void
-	): OperationHandle
-	runtimeLogCommandParse(
-		runtime: RuntimeHandle,
-		schema: LogSchemaHandle,
-		bytes: Uint8Array,
-		limits: LogLimits,
-		callback: () => void
-	): OperationHandle
-	runtimeLogDecisionDecode(
-		runtime: RuntimeHandle,
-		bytes: Uint8Array,
-		parent: LogDecisionStamp | null,
-		limits: LogLimits,
-		callback: () => void
-	): OperationHandle
-	runtimeLogTake(operation: OperationHandle): LogTakeWire
-	/** L14 mint: `Runtime::mint_repository_lock` stamps `NativeKind::RepositoryLock` at take. */
-	logRepositoryLockAcquire(runtime: RuntimeHandle, directory: string, callback: () => void): OperationHandle
-	logRepositoryLockTake(operation: OperationHandle): RepositoryLockHandle
-	logRepositoryLockRelease(owner: RepositoryLockHandle, callback: (report: CloseWire) => void): void
-}
-
-// The checked source/fresh-addon roster test pins this private declaration.
-export const runtimeNative = native as typeof native & RuntimeNative