@hraness/oh 0.2.3

package/dist/sqlite/migrations.d.ts

@@ -0,0 +1,10 @@
+import type { OhSqliteDatabase } from "./driver";
+export declare const OH_SQLITE_SCHEMA_VERSION: 2;
+export type OhSqliteMigration = Readonly<{
+    name: string;
+    sql: string;
+    version: number;
+}>;
+export declare const OH_SQLITE_MIGRATIONS: readonly OhSqliteMigration[];
+export declare function applyOhSqliteMigrations(database: OhSqliteDatabase): void;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/sqlite/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/sqlite/migrations.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAC;AAEnD,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAEzF,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EAwI3D,CAAC;AAEH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAgCxE"}

package/dist/sqlite/port.d.ts

@@ -0,0 +1,40 @@
+import { type OhChangesPageV1, type OhCommitInputV1, type OhDependencyClosureV1, type OhHeadRefV1, type OhHeadV1, type OhSnapshotV1, type OhStoreAuthorityV1, type OhStoreBindingV1, type OhStoreProfileV1, type OhStoreV1, type OhStoreVerificationV1 } from "../store";
+import type { OhOperationV1 } from "../operation";
+import type { OhSqliteDatabase } from "./driver";
+import { OhSqliteStore } from "./store";
+export type OhSqliteStoreAuthorityOptionsV1 = Readonly<{
+    database?: OhSqliteDatabase;
+    path?: string;
+    profile?: OhStoreProfileV1;
+    realmId?: string;
+    spaceId?: string;
+}>;
+export declare class OhSqliteStorePortV1 implements OhStoreV1 {
+    #private;
+    readonly binding: OhStoreBindingV1;
+    constructor(authority: OhSqliteStore, binding: OhStoreBindingV1);
+    head(): Promise<OhHeadV1>;
+    snapshot(options?: Readonly<{
+        head?: OhHeadRefV1;
+        maximumRecords?: number;
+    }>): Promise<OhSnapshotV1>;
+    changesSince(from: OhHeadRefV1, options?: Readonly<{
+        limit?: number;
+        through?: OhHeadRefV1;
+    }>): Promise<OhChangesPageV1>;
+    commit(input: OhCommitInputV1): Promise<OhOperationV1>;
+    exportDependencyClosure(input: Readonly<{
+        head?: OhHeadRefV1;
+        maximumRecords?: number;
+        roots: readonly string[];
+    }>): Promise<OhDependencyClosureV1>;
+    verify(): Promise<OhStoreVerificationV1>;
+    close(): Promise<void>;
+}
+/**
+ * Binds a Bun SQLite authority to the promise-based store port. Retain the
+ * returned `host` object in trusted control-plane code; pass only `store` to
+ * ordinary consumers.
+ */
+export declare function createOhSqliteStoreAuthorityV1(options?: OhSqliteStoreAuthorityOptionsV1): OhStoreAuthorityV1;
+//# sourceMappingURL=port.d.ts.map

package/dist/sqlite/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/sqlite/port.ts"],"names":[],"mappings":"AACA,OAAO,EAKL,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,YAAY,EAEjB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EAErB,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC3B,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,+BAA+B,GAAG,QAAQ,CAAC;IACrD,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAAC;AAEH,qBAAa,mBAAoB,YAAW,SAAS;;IACnD,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;gBAGvB,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB;IASzD,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC;IAIzB,QAAQ,CAAC,OAAO,GAAE,QAAQ,CAAC;QAC/B,IAAI,CAAC,EAAE,WAAW,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAIzB,YAAY,CAChB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,QAAQ,CAAC;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,WAAW,CAAA;KAAE,CAAM,GAChE,OAAO,CAAC,eAAe,CAAC;IAIrB,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;IAItD,uBAAuB,CAAC,KAAK,EAAE,QAAQ,CAAC;QAC5C,IAAI,CAAC,EAAE,WAAW,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;KAC1B,CAAC,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAI7B,MAAM,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAMxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,kBAAkB,CA0BpB"}

package/dist/sqlite/runtime.d.ts

@@ -0,0 +1,23 @@
+type SqliteOpenOptions = Readonly<{
+    create: true;
+    strict: true;
+}>;
+export type OhSqliteRuntimeDependencies<TDatabase> = Readonly<{
+    exists: (path: string) => boolean;
+    open: (path: string, options: SqliteOpenOptions) => TDatabase;
+    platform: NodeJS.Platform;
+    setCustomSQLite: (path: string) => boolean;
+}>;
+export type OhSqliteRuntime<TDatabase> = Readonly<{
+    customLibrary: string | null;
+    open: (path: string) => TDatabase;
+}>;
+/**
+ * Bun can replace macOS' extension-disabled system SQLite only before the first
+ * Database is constructed. Creating the opener here makes that ordering an
+ * invariant rather than leaving optional semantic backends to configure it
+ * after the authoritative store is already open.
+ */
+export declare function createOhSqliteRuntime<TDatabase>(dependencies: OhSqliteRuntimeDependencies<TDatabase>): OhSqliteRuntime<TDatabase>;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/sqlite/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/sqlite/runtime.ts"],"names":[],"mappings":"AAAA,KAAK,iBAAiB,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,IAAI,CAAA;CAAE,CAAC,CAAC;AAOlE,MAAM,MAAM,2BAA2B,CAAC,SAAS,IAAI,QAAQ,CAAC;IAC5D,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,KAAK,SAAS,CAAC;IAC9D,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;CAC5C,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,CAAC,SAAS,IAAI,QAAQ,CAAC;IAChD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC;CACnC,CAAC,CAAC;AAMH;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAC7C,YAAY,EAAE,2BAA2B,CAAC,SAAS,CAAC,GACnD,eAAe,CAAC,SAAS,CAAC,CAqB5B"}

package/dist/sqlite/store.d.ts

@@ -0,0 +1,85 @@
+import { type Sha256Hex } from "../canonical";
+import { OH_CONTRACT_MANIFEST_V1 } from "../contract";
+import { type KnowledgeGraphRecordKindV1, type KnowledgeGraphRecordV1 } from "../graph";
+import { type OhOperationV1 } from "../operation";
+import { OhConflictError, OhDependencyError, OhIntegrityError, OhProfileError, OhPurgedSpaceError, type OhChangesPageV1, type OhCommitInputV1, type OhDependencyClosureV1, type OhHeadRefV1, type OhHeadV1, type OhSnapshotV1, type OhSpacePurgeReceiptV1, type OhStoreBindingV1 } from "../store";
+import { type OhSqliteDatabase } from "./driver";
+export { OhConflictError, OhDependencyError, OhIntegrityError, OhProfileError, OhPurgedSpaceError, };
+export type { OhCommitInputV1, OhHeadV1 };
+export type OhRecordListOptions = Readonly<{
+    kind?: KnowledgeGraphRecordKindV1;
+    limit?: number;
+}>;
+export type OhKeywordSearchResultV1 = Readonly<{
+    key: string;
+    kind: KnowledgeGraphRecordKindV1;
+    recordSha256: Sha256Hex;
+    score: number;
+    snippet: string;
+    v: 1;
+}>;
+export type OhReplayVerificationV1 = Readonly<{
+    head: OhHeadV1;
+    operations: number;
+    records: number;
+    sqliteIntegrity: "ok";
+    v: 1;
+}>;
+export declare class OhSqliteStore {
+    #private;
+    readonly database: OhSqliteDatabase;
+    readonly spaceId: string;
+    constructor(options?: Readonly<{
+        database?: OhSqliteDatabase;
+        path?: string;
+        spaceId?: string;
+    }>);
+    ensureSpace(): OhHeadV1;
+    bind(bindingValue: OhStoreBindingV1): OhStoreBindingV1;
+    binding(): OhStoreBindingV1 | null;
+    head(): OhHeadV1;
+    commit(input: OhCommitInputV1): OhOperationV1;
+    importOperation(value: unknown): Readonly<{
+        imported: boolean;
+        operation: OhOperationV1;
+    }>;
+    exportOperations(afterSequence?: number, limit?: number): readonly OhOperationV1[];
+    snapshotAtHead(options?: Readonly<{
+        head?: OhHeadRefV1;
+        maximumRecords?: number;
+    }>): OhSnapshotV1;
+    changesSince(fromValue: OhHeadRefV1, options?: Readonly<{
+        limit?: number;
+        through?: OhHeadRefV1;
+    }>): OhChangesPageV1;
+    exportDependencyClosure(input: Readonly<{
+        binding: OhStoreBindingV1;
+        head?: OhHeadRefV1;
+        maximumRecords?: number;
+        roots: readonly string[];
+    }>): OhDependencyClosureV1;
+    get(key: string): KnowledgeGraphRecordV1 | null;
+    list(options?: OhRecordListOptions): readonly KnowledgeGraphRecordV1[];
+    snapshotRecords(maximum?: number): readonly KnowledgeGraphRecordV1[];
+    log(limit?: number): readonly OhOperationV1[];
+    searchKeyword(query: string, limit?: number): readonly OhKeywordSearchResultV1[];
+    syncState(remoteId: string): Readonly<{
+        pulledSequence: number;
+        pushedSequence: number;
+        remoteHeadSha256: Sha256Hex | null;
+    }>;
+    updateSyncState(remoteId: string, state: Readonly<{
+        pulledSequence: number;
+        pushedSequence: number;
+        remoteHeadSha256: Sha256Hex | null;
+    }>): void;
+    verifyReplay(): OhReplayVerificationV1;
+    contract(): Readonly<{
+        manifest: typeof OH_CONTRACT_MANIFEST_V1;
+        sqliteSchemaVersion: number;
+    }>;
+    /** Host control-plane primitive. Do not expose this method through agent tools. */
+    purgeWorkingSpace(bindingValue: OhStoreBindingV1, purgedAt?: string): OhSpacePurgeReceiptV1;
+    close(): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/sqlite/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/sqlite/store.ts"],"names":[],"mappings":"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"}

package/dist/store.d.ts

@@ -0,0 +1,236 @@
+import { type Sha256Hex } from "./canonical";
+import { OhRecordCodecRegistry } from "./contract";
+export { OhRecordCodecRegistry } from "./contract";
+import { type KnowledgeGraphChangeV1, type KnowledgeGraphRecordKindV1, type KnowledgeGraphRecordV1 } from "./graph";
+import { type OhOperationV1 } from "./operation";
+export declare class OhConflictError extends Error {
+    constructor(message: string);
+}
+export declare class OhIntegrityError extends Error {
+    constructor(message: string);
+}
+export declare class OhDependencyError extends Error {
+    constructor(message: string);
+}
+export declare class OhProfileError extends Error {
+    constructor(message: string);
+}
+export type OhHeadV1 = Readonly<{
+    generation: number;
+    graphRevisionSha256: Sha256Hex | null;
+    operationSha256: Sha256Hex | null;
+    recordsSha256: Sha256Hex;
+    sequence: number;
+    v: 1;
+}>;
+export type OhHeadRefV1 = Pick<OhHeadV1, "operationSha256" | "sequence">;
+export type OhCommitInputV1 = Readonly<{
+    actorId: string;
+    changes: readonly KnowledgeGraphChangeV1[];
+    expectedHead: Pick<OhHeadV1, "generation" | "operationSha256">;
+    instant?: string;
+    operationId: string;
+}>;
+export type OhSnapshotV1 = Readonly<{
+    head: OhHeadV1;
+    records: readonly KnowledgeGraphRecordV1[];
+    v: 1;
+}>;
+export type OhChangesPageV1 = Readonly<{
+    from: OhHeadRefV1;
+    hasMore: boolean;
+    operations: readonly OhOperationV1[];
+    through: OhHeadV1;
+    to: OhHeadRefV1;
+    v: 1;
+}>;
+export type OhStoreVerificationV1 = Readonly<{
+    head: OhHeadV1;
+    integrity: "verified";
+    operations: number;
+    records: number;
+    v: 1;
+}>;
+export type OhStoreCapabilitiesV1 = Readonly<{
+    changesSince: true;
+    dependencyClosureExport: true;
+    exactSnapshots: true;
+    operationReplication: boolean;
+    semanticBundleCommit: true;
+    v: 1;
+    wholeSpacePurge: boolean;
+}>;
+export type OhStoreProfileV1 = Readonly<{
+    applicationProfileSha256: Sha256Hex | null;
+    capabilities: OhStoreCapabilitiesV1;
+    profileId: string;
+    profileKind: "canonical" | "working";
+    profileSha256: Sha256Hex;
+    v: 1;
+}>;
+export type OhStoreBindingV1 = Readonly<{
+    bindingSha256: Sha256Hex;
+    contractSha256: Sha256Hex;
+    profile: OhStoreProfileV1;
+    realmId: string;
+    spaceId: string;
+    v: 1;
+}>;
+export declare const OH_CANONICAL_STORE_PROFILE_V1: Readonly<{
+    applicationProfileSha256: Sha256Hex | null;
+    capabilities: OhStoreCapabilitiesV1;
+    profileId: string;
+    profileKind: "canonical" | "working";
+    profileSha256: Sha256Hex;
+    v: 1;
+}>;
+export declare const OH_WORKING_STORE_PROFILE_V1: Readonly<{
+    applicationProfileSha256: Sha256Hex | null;
+    capabilities: OhStoreCapabilitiesV1;
+    profileId: string;
+    profileKind: "canonical" | "working";
+    profileSha256: Sha256Hex;
+    v: 1;
+}>;
+export type OhDependencyClosureV1 = Readonly<{
+    binding: OhStoreBindingV1;
+    closureSha256: Sha256Hex;
+    head: OhHeadV1;
+    records: readonly KnowledgeGraphRecordV1[];
+    roots: readonly string[];
+    v: 1;
+}>;
+export declare const OH_DEPENDENCY_CLOSURE_LIMITS_V1: Readonly<{
+    bytes: number;
+    records: 8192;
+    roots: 1024;
+}>;
+export type OhSpacePurgeReceiptV1 = Readonly<{
+    bindingSha256: Sha256Hex;
+    priorHead: OhHeadV1;
+    purgedAt: string;
+    receiptSha256: Sha256Hex;
+    spaceId: string;
+    v: 1;
+}>;
+export declare class OhPurgedSpaceError extends Error {
+    readonly receipt: OhSpacePurgeReceiptV1;
+    constructor(receipt: OhSpacePurgeReceiptV1);
+}
+export interface OhStoreV1 {
+    readonly binding: OhStoreBindingV1;
+    changesSince(from: OhHeadRefV1, options?: Readonly<{
+        limit?: number;
+        through?: OhHeadRefV1;
+    }>): Promise<OhChangesPageV1>;
+    close(): Promise<void>;
+    commit(input: OhCommitInputV1): Promise<OhOperationV1>;
+    exportDependencyClosure(input: Readonly<{
+        head?: OhHeadRefV1;
+        maximumRecords?: number;
+        roots: readonly string[];
+    }>): Promise<OhDependencyClosureV1>;
+    head(): Promise<OhHeadV1>;
+    snapshot(options?: Readonly<{
+        head?: OhHeadRefV1;
+        maximumRecords?: number;
+    }>): Promise<OhSnapshotV1>;
+    verify(): Promise<OhStoreVerificationV1>;
+}
+/** Kept separate so an agent-facing store object never carries deletion authority. */
+export interface OhStoreHostControlV1 {
+    readonly binding: OhStoreBindingV1;
+    purgeWorkingSpace(input: Readonly<{
+        purgedAt?: string;
+    }>): Promise<OhSpacePurgeReceiptV1>;
+}
+export type OhStoreAuthorityV1 = Readonly<{
+    host: OhStoreHostControlV1;
+    store: OhStoreV1;
+}>;
+export declare function emptyOhHeadV1(): OhHeadV1;
+export declare function parseOhHeadV1(value: unknown): OhHeadV1 | null;
+export declare function parseOhHeadRefV1(value: unknown): OhHeadRefV1 | null;
+type OhStoreProfileInputV1 = Omit<OhStoreProfileV1, "profileSha256">;
+export declare function createOhStoreProfileV1(input: OhStoreProfileInputV1): OhStoreProfileV1;
+export declare function parseOhStoreProfileV1(value: unknown): OhStoreProfileV1 | null;
+export declare function createOhStoreBindingV1(input: Readonly<{
+    profile: OhStoreProfileV1;
+    realmId: string;
+    spaceId: string;
+    v: 1;
+}>): OhStoreBindingV1;
+export declare function parseOhStoreBindingV1(value: unknown): OhStoreBindingV1 | null;
+export declare function replayOhOperationsV1(spaceId: string, values: readonly OhOperationV1[], maximumRecords?: number): OhSnapshotV1;
+export declare function transitionOhSnapshotV1(input: Readonly<{
+    actorId: string;
+    changes: readonly KnowledgeGraphChangeV1[];
+    instant: string;
+    operationId: string;
+    snapshot: OhSnapshotV1;
+    spaceId: string;
+}>): Readonly<{
+    operation: OhOperationV1;
+    snapshot: OhSnapshotV1;
+}>;
+export declare function createOhDependencyClosureV1(input: Readonly<{
+    binding: OhStoreBindingV1;
+    maximumRecords?: number;
+    roots: readonly string[];
+    snapshot: OhSnapshotV1;
+}>): OhDependencyClosureV1;
+export declare function parseOhDependencyClosureV1(value: unknown): OhDependencyClosureV1 | null;
+export declare function verifyOhDependencyClosureV1(value: unknown): Readonly<{
+    closure: OhDependencyClosureV1;
+    ok: true;
+}> | Readonly<{
+    ok: false;
+    reason: "invalid-closure";
+}>;
+/**
+ * Strong adoption check. Unlike structural self-verification, this also binds
+ * the capsule to the exact store binding and head selected by trusted host code.
+ */
+export declare function verifyOhDependencyClosureAgainstV1(value: unknown, expected: Readonly<{
+    binding: OhStoreBindingV1;
+    head: OhHeadV1;
+}>): Readonly<{
+    closure: OhDependencyClosureV1;
+    ok: true;
+    verification: "expected-authority-and-head";
+}> | Readonly<{
+    ok: false;
+    reason: "binding-mismatch" | "head-mismatch" | "invalid-closure" | "invalid-expectation";
+}>;
+export declare function createOhSpacePurgeReceiptV1(input: Readonly<{
+    binding: OhStoreBindingV1;
+    priorHead: OhHeadV1;
+    purgedAt: string;
+}>): OhSpacePurgeReceiptV1;
+export declare function parseOhSpacePurgeReceiptV1(value: unknown): OhSpacePurgeReceiptV1 | null;
+export type OhSemanticBundleV1 = Readonly<{
+    actorId: string;
+    expectedHead: Pick<OhHeadV1, "generation" | "operationSha256">;
+    instant: string | null;
+    operationId: string;
+    puts: readonly Readonly<{
+        dependencies: readonly string[];
+        key: string;
+        kind: KnowledgeGraphRecordKindV1;
+        v: 1;
+        value: unknown;
+    }>[];
+    tombstones: readonly Readonly<{
+        key: string;
+        priorSha256: Sha256Hex;
+        v: 1;
+    }>[];
+    v: 1;
+}>;
+/** A strict model-facing ingress: every put must have a registered codec. */
+export declare class OhSemanticBundleIngressV1 {
+    #private;
+    constructor(store: OhStoreV1, codecs: OhRecordCodecRegistry);
+    commit(value: unknown): Promise<OhOperationV1>;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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