@hraness/oh 0.4.1 → 0.4.2

package/dist/memory-authority-platform.d.ts

@@ -0,0 +1,210 @@
+import { Context, Effect, Layer } from "effect";
+import { type OhHeadV1, type OhStoreV1 } from "./store";
+import { type OhMemoryAuthorityOptionsV1 } from "./memory-core";
+export type MemoryFailure = Readonly<{
+    _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+    cause: unknown;
+}>;
+export declare function memoryFailure(cause: unknown): MemoryFailure;
+/** Validation may reject hostile values; unrelated generator defects are not caught. */
+export declare function memoryValue<A>(evaluate: () => A): Effect.Effect<A, MemoryFailure>;
+declare const CanonicalMemoryStore_base: Context.TagClass<CanonicalMemoryStore, "@hraness/oh/CanonicalMemoryStore", {
+    commit: (input: Parameters<OhStoreV1["commit"]>[0]) => Effect.Effect<import("./operation").OhOperationV1, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+    binding: Readonly<{
+        bindingSha256: import("./canonical").Sha256Hex;
+        contractSha256: import("./canonical").Sha256Hex;
+        profile: import("./store").OhStoreProfileV1;
+        realmId: string;
+        spaceId: string;
+        v: 1;
+    }>;
+    head: Effect.Effect<Readonly<{
+        generation: number;
+        graphRevisionSha256: import("./canonical").Sha256Hex | null;
+        operationSha256: import("./canonical").Sha256Hex | null;
+        recordsSha256: import("./canonical").Sha256Hex;
+        sequence: number;
+        v: 1;
+    }>, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+    snapshot: (options: Parameters<OhStoreV1["snapshot"]>[0]) => Effect.Effect<Readonly<{
+        head: OhHeadV1;
+        records: readonly import("./graph").KnowledgeGraphRecordV1[];
+        v: 1;
+    }>, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+    changesSince: (from: Parameters<OhStoreV1["changesSince"]>[0], options: Parameters<OhStoreV1["changesSince"]>[1]) => Effect.Effect<Readonly<{
+        from: import("./store").OhHeadRefV1;
+        hasMore: boolean;
+        operations: readonly import("./operation").OhOperationV1[];
+        through: OhHeadV1;
+        to: import("./store").OhHeadRefV1;
+        v: 1;
+    }>, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+}>;
+/** Canonical commit is provided only to the trusted host authority composition. */
+export declare class CanonicalMemoryStore extends CanonicalMemoryStore_base {
+}
+declare function canonicalStorePort(store: OhStoreV1): {
+    commit: (input: Parameters<OhStoreV1["commit"]>[0]) => Effect.Effect<import("./operation").OhOperationV1, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+    binding: Readonly<{
+        bindingSha256: import("./canonical").Sha256Hex;
+        contractSha256: import("./canonical").Sha256Hex;
+        profile: import("./store").OhStoreProfileV1;
+        realmId: string;
+        spaceId: string;
+        v: 1;
+    }>;
+    head: Effect.Effect<Readonly<{
+        generation: number;
+        graphRevisionSha256: import("./canonical").Sha256Hex | null;
+        operationSha256: import("./canonical").Sha256Hex | null;
+        recordsSha256: import("./canonical").Sha256Hex;
+        sequence: number;
+        v: 1;
+    }>, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+    snapshot: (options: Parameters<OhStoreV1["snapshot"]>[0]) => Effect.Effect<Readonly<{
+        head: OhHeadV1;
+        records: readonly import("./graph").KnowledgeGraphRecordV1[];
+        v: 1;
+    }>, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+    changesSince: (from: Parameters<OhStoreV1["changesSince"]>[0], options: Parameters<OhStoreV1["changesSince"]>[1]) => Effect.Effect<Readonly<{
+        from: import("./store").OhHeadRefV1;
+        hasMore: boolean;
+        operations: readonly import("./operation").OhOperationV1[];
+        through: OhHeadV1;
+        to: import("./store").OhHeadRefV1;
+        v: 1;
+    }>, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+};
+export type CanonicalMemoryStoreService = ReturnType<typeof canonicalStorePort>;
+declare const WorkingMemorySource_base: Context.TagClass<WorkingMemorySource, "@hraness/oh/WorkingMemorySource", {
+    readonly exportDependencyClosure: (input: Parameters<OhStoreV1["exportDependencyClosure"]>[0]) => Effect.Effect<Awaited<ReturnType<OhStoreV1["exportDependencyClosure"]>>, MemoryFailure>;
+}>;
+/** The host adoption program borrows only the working closure read capability. */
+export declare class WorkingMemorySource extends WorkingMemorySource_base {
+}
+declare const MemoryAuthorityConfig_base: Context.TagClass<MemoryAuthorityConfig, "@hraness/oh/MemoryAuthorityConfig", Omit<{
+    adoptionActorId: string;
+    canonicalAuthorityId: string;
+    workingAuthorityId: string;
+    canonicalBinding: Readonly<{
+        bindingSha256: import("./canonical").Sha256Hex;
+        contractSha256: import("./canonical").Sha256Hex;
+        profile: import("./store").OhStoreProfileV1;
+        realmId: string;
+        spaceId: string;
+        v: 1;
+    }>;
+    workingBinding: Readonly<{
+        bindingSha256: import("./canonical").Sha256Hex;
+        contractSha256: import("./canonical").Sha256Hex;
+        profile: import("./store").OhStoreProfileV1;
+        realmId: string;
+        spaceId: string;
+        v: 1;
+    }>;
+    initialCanonicalHead: Readonly<{
+        generation: number;
+        graphRevisionSha256: import("./canonical").Sha256Hex | null;
+        operationSha256: import("./canonical").Sha256Hex | null;
+        recordsSha256: import("./canonical").Sha256Hex;
+        sequence: number;
+        v: 1;
+    }>;
+    maximumCanonicalOperationBytes: number;
+    createAgentAt: (expectedHead: OhHeadV1) => Effect.Effect<import("./memory-core").OhMemoryAgentV2, Readonly<{
+        _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+        cause: unknown;
+    }>, never>;
+    routesById: Map<string, Readonly<{
+        destinationPurpose: string;
+        nominationId: string;
+    }>>;
+    canonical: {
+        commit: (input: Parameters<OhStoreV1["commit"]>[0]) => Effect.Effect<import("./operation").OhOperationV1, Readonly<{
+            _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+            cause: unknown;
+        }>, never>;
+        binding: Readonly<{
+            bindingSha256: import("./canonical").Sha256Hex;
+            contractSha256: import("./canonical").Sha256Hex;
+            profile: import("./store").OhStoreProfileV1;
+            realmId: string;
+            spaceId: string;
+            v: 1;
+        }>;
+        head: Effect.Effect<Readonly<{
+            generation: number;
+            graphRevisionSha256: import("./canonical").Sha256Hex | null;
+            operationSha256: import("./canonical").Sha256Hex | null;
+            recordsSha256: import("./canonical").Sha256Hex;
+            sequence: number;
+            v: 1;
+        }>, Readonly<{
+            _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+            cause: unknown;
+        }>, never>;
+        snapshot: (options: Parameters<OhStoreV1["snapshot"]>[0]) => Effect.Effect<Readonly<{
+            head: OhHeadV1;
+            records: readonly import("./graph").KnowledgeGraphRecordV1[];
+            v: 1;
+        }>, Readonly<{
+            _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+            cause: unknown;
+        }>, never>;
+        changesSince: (from: Parameters<OhStoreV1["changesSince"]>[0], options: Parameters<OhStoreV1["changesSince"]>[1]) => Effect.Effect<Readonly<{
+            from: import("./store").OhHeadRefV1;
+            hasMore: boolean;
+            operations: readonly import("./operation").OhOperationV1[];
+            through: OhHeadV1;
+            to: import("./store").OhHeadRefV1;
+            v: 1;
+        }>, Readonly<{
+            _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+            cause: unknown;
+        }>, never>;
+    };
+    working: {
+        exportDependencyClosure: (input: Parameters<OhStoreV1["exportDependencyClosure"]>[0]) => Effect.Effect<Readonly<{
+            binding: import("./store").OhStoreBindingV1;
+            closureSha256: import("./canonical").Sha256Hex;
+            head: OhHeadV1;
+            records: readonly import("./graph").KnowledgeGraphRecordV1[];
+            roots: readonly string[];
+            v: 1;
+        }>, Readonly<{
+            _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+            cause: unknown;
+        }>, never>;
+    };
+}, "canonical" | "working">>;
+export declare class MemoryAuthorityConfig extends MemoryAuthorityConfig_base {
+}
+/** Preparation captures caller-owned options before the first foreign wait. Stores
+ * are borrowed; these Layers cannot close or purge either physical authority. */
+export declare function memoryAuthorityLive(options: OhMemoryAuthorityOptionsV1): Layer.Layer<MemoryAuthorityConfig | CanonicalMemoryStore | WorkingMemorySource, MemoryFailure>;
+export {};
+//# sourceMappingURL=memory-authority-platform.d.ts.map

package/dist/memory-authority-platform.d.ts.map

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

package/dist/memory-authority-program.d.ts

@@ -0,0 +1,15 @@
+import { Effect } from "effect";
+import { parseCanonicalAdvanceRequest, parseAdoptionRequest, type OhMemoryCanonicalAdvanceReceiptV1, type OhMemoryAdoptionReceiptV1 } from "./memory-core";
+import { CanonicalMemoryStore, WorkingMemorySource, MemoryAuthorityConfig, type MemoryFailure } from "./memory-authority-platform";
+/** One FIFO for trusted host changes; agent calls retain their captured immutable pin.
+ * After admission the operation retains its permit through actual foreign settlement
+ * and pin publication. Native commit/CAS remains authoritative; there is no retry. */
+export declare const makeMemoryAuthority: Effect.Effect<{
+    readonly agent: import("./memory-core").OhMemoryAgentV2;
+    advanceCanonical: (request: ReturnType<typeof parseCanonicalAdvanceRequest>) => Effect.Effect<OhMemoryCanonicalAdvanceReceiptV1, MemoryFailure>;
+    adoptNomination: (request: ReturnType<typeof parseAdoptionRequest>) => Effect.Effect<OhMemoryAdoptionReceiptV1, MemoryFailure>;
+}, Readonly<{
+    _tag: "MemoryConflict" | "MemoryIntegrity" | "MemoryProfile" | "MemoryValidation" | "MemoryCapacity" | "MemoryForeign";
+    cause: unknown;
+}>, CanonicalMemoryStore | WorkingMemorySource | MemoryAuthorityConfig>;
+//# sourceMappingURL=memory-authority-program.d.ts.map

package/dist/memory-authority-program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-authority-program.d.ts","sourceRoot":"","sources":["../src/memory-authority-program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,MAAM,EAAgB,MAAM,QAAQ,CAAC;AAMrD,OAAO,EAEL,4BAA4B,EAAE,oBAAoB,EAE/B,KAAK,iCAAiC,EAAE,KAAK,yBAAyB,EACnD,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,qBAAqB,EACvE,KAAK,aAAa,EAAE,MAAM,6BAA6B,CAAC;AA2G1D;;sFAEsF;AACtF,eAAO,MAAM,mBAAmB;;gCAiBK,UAAU,CAAC,OAAO,4BAA4B,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,iCAAiC,EAAE,aAAa,CAAC;+BAgBlH,UAAU,CAAC,OAAO,oBAAoB,CAAC,KAAG,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,aAAa,CAAC;;;;uEAwJnI,CAAC"}

package/dist/memory-authority-runtime.d.ts

@@ -0,0 +1,4 @@
+import { type OhMemoryAuthorityOptionsV1, type OhMemoryAuthorityV1 } from "./memory-core";
+/** Existing Promise surface; stores and agent capability lifetimes remain borrowed. */
+export declare function createOhMemoryAuthorityV1(options: OhMemoryAuthorityOptionsV1): Promise<OhMemoryAuthorityV1>;
+//# sourceMappingURL=memory-authority-runtime.d.ts.map

package/dist/memory-authority-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-authority-runtime.d.ts","sourceRoot":"","sources":["../src/memory-authority-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,0BAA0B,EAAE,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAenF,uFAAuF;AACvF,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqBjH"}