@recallkit/core 0.1.0

package/README.md

@@ -0,0 +1,69 @@
+# `@recallkit/core`
+
+Core domain logic for RecallKit. This package is intentionally framework-free so it can be used by the web signer, daemon, CLI, skill scripts.
+
+## Domain Map
+
+```txt
+src/
+  constants.ts       Project constants, entity type names, default expirations
+  types.ts           Cross-domain payload and Arkiv-facing types
+  memory/            Memory candidate and MemoryRecord lifecycle
+  retrieval/         Query understanding, ranking, context packs
+  crypto/            Passphrase encryption and hashing helpers
+  arkiv/             Arkiv client loading, entity attributes, queries, writes
+  storage/           Local .recallkit paths, config, pending store, cache store
+```
+
+## Public Import Surface
+
+Prefer these imports from apps and packages:
+
+```ts
+import { buildContextPack } from "@recallkit/core";
+import { readPendingMemories } from "@recallkit/core/storage";
+import { encryptJson } from "@recallkit/core/crypto";
+import { createMemoryPack } from "@recallkit/core/arkiv";
+import type { MemoryRecord } from "@recallkit/core/schemas";
+```
+
+Subpath exports are grouped by domain:
+
+| Export | Purpose |
+| --- | --- |
+| `@recallkit/core` | Main public API. |
+| `@recallkit/core/memory` | Candidate compilation, scoring, conflict, consolidation. |
+| `@recallkit/core/retrieval` | Search, ranking, context packs. |
+| `@recallkit/core/crypto` | Encryption and key helpers. |
+| `@recallkit/core/arkiv` | Arkiv clients, attributes, queries, write helpers. |
+| `@recallkit/core/storage` | Local config, pending memory, and cache stores. |
+| `@recallkit/core/schemas` | Memory schema types. |
+
+Browser code should prefer the focused `crypto`, `arkiv`, `keys`, `constants`, and type-only imports. `storage` uses Node filesystem APIs and is intended for the signer API, daemon, CLI.
+
+## Architectural Boundaries
+
+- `memory/` has no Arkiv dependency. It turns user/agent text into structured memory records and index metadata.
+- `retrieval/` consumes committed memory/index data. It does not write local files or Arkiv entities.
+- `crypto/` only handles encryption, decryption, hashing, and byte conversion.
+- `arkiv/` knows about Arkiv entity attributes, SDK loading, queries, and write calls.
+- `storage/` owns local `.recallkit` JSON files.
+
+The durable write path remains wallet-native: the approval app encrypts payloads and signs Arkiv writes with the connected browser wallet. Server-side Arkiv reads can use the `ARKIV_RPC_URL` override; do not expose keyed RPC URLs with `NEXT_PUBLIC_*`.
+
+## Local Files
+
+RecallKit local state is rooted at `RECALLKIT_DATA_DIR` when set, otherwise the current working directory:
+
+```txt
+.recallkit/
+```
+
+Files:
+
+```txt
+.recallkit/config.json
+.recallkit/pending.json
+.recallkit/cache/latest-index.json
+.recallkit/cache/latest-packs.json
+```

package/dist/arkiv/client.d.ts

@@ -0,0 +1,17 @@
+export type ArkivSdk = {
+    createPublicClient: (config: unknown) => unknown;
+    createWalletClient?: (config: unknown) => unknown;
+    http: (url?: string) => unknown;
+};
+export type ArkivChainModule = {
+    braga: unknown;
+};
+export declare function loadArkivSdk(): Promise<ArkivSdk>;
+export declare function loadArkivChains(): Promise<ArkivChainModule>;
+export declare function loadArkivUtils(): Promise<{
+    jsonToPayload?: (value: unknown) => unknown;
+    stringToPayload?: (value: string) => unknown;
+}>;
+export declare function createArkivPublicClient(rpcUrl?: string): Promise<unknown>;
+export declare function entityToJson<T>(entity: unknown): T;
+//# sourceMappingURL=client.d.ts.map

package/dist/arkiv/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/arkiv/client.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,kBAAkB,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IACjD,kBAAkB,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAClD,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAGF,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAEtD;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAEjE;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC;IAC9C,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAC5C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAC9C,CAAC,CAKD;AAED,wBAAsB,uBAAuB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/E;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,GAAG,CAAC,CAWlD"}

package/dist/arkiv/client.js

@@ -0,0 +1,29 @@
+// Lazy load Arkiv SDK imports so local-only core flows do not load Arkiv code until retrieval or writes need it.
+export async function loadArkivSdk() {
+    return import("@arkiv-network/sdk");
+}
+export async function loadArkivChains() {
+    return import("@arkiv-network/sdk/chains");
+}
+export async function loadArkivUtils() {
+    return import("@arkiv-network/sdk/utils");
+}
+export async function createArkivPublicClient(rpcUrl) {
+    const [{ createPublicClient, http }, { braga }] = await Promise.all([loadArkivSdk(), loadArkivChains()]);
+    const serverRpcUrl = typeof process !== "undefined" ? process.env.ARKIV_RPC_URL : undefined;
+    return createPublicClient({
+        chain: braga,
+        transport: http(rpcUrl ?? serverRpcUrl),
+    });
+}
+export function entityToJson(entity) {
+    const candidate = entity;
+    if (typeof candidate.toJson === "function")
+        return candidate.toJson();
+    if (candidate.payload !== undefined)
+        return candidate.payload;
+    if (candidate.value !== undefined)
+        return candidate.value;
+    throw new Error("Arkiv entity did not include a JSON payload.");
+}
+//# sourceMappingURL=client.js.map

package/dist/arkiv/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/arkiv/client.ts"],"names":[],"mappings":"AAUA,iHAAiH;AACjH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,OAAO,MAAM,CAAC,oBAAoB,CAAsB,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,OAAO,MAAM,CAAC,2BAA2B,CAA8B,CAAC;AAC1E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc;IAIlC,OAAO,MAAM,CAAC,0BAA0B,CAGtC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,MAAe;IAC3D,MAAM,CAAC,EAAE,kBAAkB,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC;IACzG,MAAM,YAAY,GAAG,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,OAAO,kBAAkB,CAAC;QACxB,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,IAAI,CAAC,MAAM,IAAI,YAAY,CAAC;KACxC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,MAAe;IAC7C,MAAM,SAAS,GAAG,MAIjB,CAAC;IAEF,IAAI,OAAO,SAAS,CAAC,MAAM,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC,MAAM,EAAE,CAAC;IACtE,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,OAAO,CAAC;IAC9D,IAAI,SAAS,CAAC,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC;IAC1D,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;AAClE,CAAC"}

package/dist/arkiv/entities.d.ts

@@ -0,0 +1,11 @@
+import type { Attribute } from "../types.js";
+export declare function baseAttributes(entityType: string, ownerWallet: string): Attribute[];
+export declare function memoryManifestAttributes(ownerWallet: string): Attribute[];
+export declare function memoryPackAttributes(params: {
+    ownerWallet: string;
+    scopeHash: string;
+}): Attribute[];
+export declare function memoryIndexCheckpointAttributes(ownerWallet: string): Attribute[];
+export declare function memoryCommitAttributes(ownerWallet: string): Attribute[];
+export declare const memoryEntityContentType = "application/vnd.recallkit.encrypted+json";
+//# sourceMappingURL=entities.d.ts.map

package/dist/arkiv/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/arkiv/entities.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAQnF;AAED,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAEzE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,SAAS,EAAE,CAKd;AAED,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAEhF;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,CAEvE;AAED,eAAO,MAAM,uBAAuB,6CAA6C,CAAC"}

package/dist/arkiv/entities.js

@@ -0,0 +1,27 @@
+import { ENTITY_TYPES, PROJECT_ATTRIBUTE } from "../constants.js";
+export function baseAttributes(entityType, ownerWallet) {
+    return [
+        { key: PROJECT_ATTRIBUTE.key, value: PROJECT_ATTRIBUTE.value },
+        { key: "entityType", value: entityType },
+        { key: "owner", value: ownerWallet },
+        { key: "createdAt", value: Date.now() },
+        { key: "schemaVersion", value: 1 },
+    ];
+}
+export function memoryManifestAttributes(ownerWallet) {
+    return baseAttributes(ENTITY_TYPES.MANIFEST, ownerWallet);
+}
+export function memoryPackAttributes(params) {
+    return [
+        ...baseAttributes(ENTITY_TYPES.PACK, params.ownerWallet),
+        { key: "scopeHash", value: params.scopeHash },
+    ];
+}
+export function memoryIndexCheckpointAttributes(ownerWallet) {
+    return baseAttributes(ENTITY_TYPES.INDEX_CHECKPOINT, ownerWallet);
+}
+export function memoryCommitAttributes(ownerWallet) {
+    return baseAttributes(ENTITY_TYPES.COMMIT, ownerWallet);
+}
+export const memoryEntityContentType = "application/vnd.recallkit.encrypted+json";
+//# sourceMappingURL=entities.js.map

package/dist/arkiv/entities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.js","sourceRoot":"","sources":["../../src/arkiv/entities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGlE,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,WAAmB;IACpE,OAAO;QACL,EAAE,GAAG,EAAE,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE;QAC9D,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE;QACxC,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE;QACpC,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE;QACvC,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,CAAC,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC1D,OAAO,cAAc,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAGpC;IACC,OAAO;QACL,GAAG,cAAc,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC;QACxD,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,+BAA+B,CAAC,WAAmB;IACjE,OAAO,cAAc,CAAC,YAAY,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,OAAO,cAAc,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,0CAA0C,CAAC"}

package/dist/arkiv/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./client.js";
+export * from "./entities.js";
+export * from "./queries.js";
+export * from "./writes.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/arkiv/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/arkiv/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/arkiv/index.js

@@ -0,0 +1,5 @@
+export * from "./client.js";
+export * from "./entities.js";
+export * from "./queries.js";
+export * from "./writes.js";
+//# sourceMappingURL=index.js.map

package/dist/arkiv/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/arkiv/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC"}

package/dist/arkiv/queries.d.ts

@@ -0,0 +1,7 @@
+import type { ArkivEntity, ArkivPublicClient } from "../types.js";
+export declare function getLatestManifest(publicClient: ArkivPublicClient, ownerWallet: string): Promise<ArkivEntity | undefined>;
+export declare function getEntityByKey<T = unknown>(publicClient: ArkivPublicClient, entityKey: string): Promise<{
+    entity: ArkivEntity;
+    payload: T;
+}>;
+//# sourceMappingURL=queries.d.ts.map

package/dist/arkiv/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../src/arkiv/queries.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAOlE,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,iBAAiB,EAC/B,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAOlC;AAED,wBAAsB,cAAc,CAAC,CAAC,GAAG,OAAO,EAC9C,YAAY,EAAE,iBAAiB,EAC/B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,CAc9C"}

package/dist/arkiv/queries.js

@@ -0,0 +1,56 @@
+import { ENTITY_TYPES, PROJECT_ATTRIBUTE } from "../constants.js";
+import { entityToJson } from "./client.js";
+export async function getLatestManifest(publicClient, ownerWallet) {
+    const result = await buildProjectQuery(publicClient, ownerWallet, ENTITY_TYPES.MANIFEST, true);
+    const entities = (result.entities ?? []).map(normalizeEntity);
+    return entities.sort((left, right) => Number(readAttribute(right, "createdAt")) - Number(readAttribute(left, "createdAt")))[0];
+}
+export async function getEntityByKey(publicClient, entityKey) {
+    const client = publicClient;
+    if (typeof client.getEntity !== "function") {
+        throw new Error("Arkiv public client does not expose getEntity().");
+    }
+    const rawEntity = await client.getEntity(entityKey);
+    return {
+        entity: normalizeEntity(rawEntity),
+        payload: entityToJson(rawEntity),
+    };
+}
+async function buildProjectQuery(publicClient, ownerWallet, entityType, withPayload) {
+    const { eq, desc } = (await import("@arkiv-network/sdk/query"));
+    const client = publicClient;
+    if (typeof client.buildQuery !== "function") {
+        throw new Error("Arkiv public client does not expose buildQuery().");
+    }
+    let query = client.buildQuery();
+    query = query.where(eq(PROJECT_ATTRIBUTE.key, PROJECT_ATTRIBUTE.value));
+    query = query.where(eq("entityType", entityType));
+    query = query.where(eq("owner", ownerWallet));
+    if (typeof query.ownedBy === "function")
+        query = query.ownedBy(ownerWallet);
+    if (typeof query.orderBy === "function")
+        query = query.orderBy(desc("createdAt", "number"));
+    if (typeof query.withPayload === "function")
+        query = query.withPayload(withPayload);
+    if (typeof query.withAttributes === "function")
+        query = query.withAttributes(true);
+    if (typeof query.limit === "function")
+        query = query.limit(50);
+    if (typeof query.fetch !== "function") {
+        throw new Error("Arkiv query builder does not expose fetch().");
+    }
+    return query.fetch();
+}
+function normalizeEntity(raw) {
+    const entity = raw;
+    return {
+        key: entity.key ?? "",
+        attributes: entity.attributes ?? entity.stringAttributes ?? [],
+        payload: entity.payload ?? entity.value,
+        ...(entity.createdAt !== undefined ? { createdAt: entity.createdAt } : {}),
+    };
+}
+function readAttribute(entity, key) {
+    return entity.attributes?.find((attribute) => attribute.key === key)?.value;
+}
+//# sourceMappingURL=queries.js.map

package/dist/arkiv/queries.js.map

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

package/dist/arkiv/writes.d.ts

@@ -0,0 +1,19 @@
+import type { ArkivWalletClient, EncryptedPayload } from "../types.js";
+type CreateEntityResult = {
+    entityKey: string;
+    txHash?: string;
+};
+type EncryptedEntityParams = {
+    walletClient: ArkivWalletClient;
+    ownerWallet: string;
+    encryptedPayload: EncryptedPayload;
+    expiresIn: number;
+};
+export declare function createMemoryPack(params: EncryptedEntityParams & {
+    scopeHash: string;
+}): Promise<CreateEntityResult>;
+export declare function createIndexCheckpoint(params: EncryptedEntityParams): Promise<CreateEntityResult>;
+export declare function createMemoryCommit(params: EncryptedEntityParams): Promise<CreateEntityResult>;
+export declare function createMemoryManifest(params: EncryptedEntityParams): Promise<CreateEntityResult>;
+export {};
+//# sourceMappingURL=writes.d.ts.map

package/dist/arkiv/writes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes.d.ts","sourceRoot":"","sources":["../../src/arkiv/writes.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,iBAAiB,EAAa,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASlF,KAAK,kBAAkB,GAAG;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,YAAY,EAAE,iBAAiB,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,qBAAqB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,kBAAkB,CAAC,CAQ7B;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAEhG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE7F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAE/F"}

package/dist/arkiv/writes.js

@@ -0,0 +1,37 @@
+import { memoryCommitAttributes, memoryEntityContentType, memoryIndexCheckpointAttributes, memoryManifestAttributes, memoryPackAttributes, } from "./entities.js";
+import { loadArkivUtils } from "./client.js";
+export function createMemoryPack(params) {
+    return createRecallKitEntity(params, memoryPackAttributes({
+        ownerWallet: params.ownerWallet,
+        scopeHash: params.scopeHash,
+    }));
+}
+export function createIndexCheckpoint(params) {
+    return createRecallKitEntity(params, memoryIndexCheckpointAttributes(params.ownerWallet));
+}
+export function createMemoryCommit(params) {
+    return createRecallKitEntity(params, memoryCommitAttributes(params.ownerWallet));
+}
+export function createMemoryManifest(params) {
+    return createRecallKitEntity(params, memoryManifestAttributes(params.ownerWallet));
+}
+function createRecallKitEntity(params, attributes) {
+    return createEncryptedEntity(params.walletClient, {
+        payload: params.encryptedPayload,
+        contentType: memoryEntityContentType,
+        attributes,
+        expiresIn: params.expiresIn,
+    });
+}
+async function createEncryptedEntity(walletClient, input) {
+    const client = walletClient;
+    if (typeof client.createEntity !== "function") {
+        throw new Error("Arkiv wallet client does not expose createEntity().");
+    }
+    const { jsonToPayload } = await loadArkivUtils();
+    return client.createEntity({
+        ...input,
+        payload: jsonToPayload ? jsonToPayload(input.payload) : input.payload,
+    });
+}
+//# sourceMappingURL=writes.js.map

package/dist/arkiv/writes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writes.js","sourceRoot":"","sources":["../../src/arkiv/writes.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,+BAA+B,EAC/B,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAsB7C,MAAM,UAAU,gBAAgB,CAC9B,MAAqD;IAErD,OAAO,qBAAqB,CAC1B,MAAM,EACN,oBAAoB,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAA6B;IACjE,OAAO,qBAAqB,CAAC,MAAM,EAAE,+BAA+B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAA6B;IAC9D,OAAO,qBAAqB,CAAC,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAA6B;IAChE,OAAO,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,qBAAqB,CAC5B,MAA6B,EAC7B,UAAuB;IAEvB,OAAO,qBAAqB,CAAC,MAAM,CAAC,YAAY,EAAE;QAChD,OAAO,EAAE,MAAM,CAAC,gBAAgB;QAChC,WAAW,EAAE,uBAAuB;QACpC,UAAU;QACV,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,YAA+B,EAC/B,KAAwB;IAExB,MAAM,MAAM,GAAG,YAEd,CAAC;IAEF,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,cAAc,EAAE,CAAC;IACjD,OAAO,MAAM,CAAC,YAAY,CAAC;QACzB,GAAG,KAAK;QACR,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO;KACtE,CAAC,CAAC;AACL,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,19 @@
+export declare const PROJECT_ATTRIBUTE: {
+    readonly key: "project";
+    readonly value: "recallkit-v1";
+};
+export declare const ENTITY_TYPES: {
+    readonly MANIFEST: "memory_manifest";
+    readonly PACK: "memory_pack";
+    readonly INDEX_CHECKPOINT: "memory_index_checkpoint";
+    readonly COMMIT: "memory_commit";
+};
+export declare const DEFAULT_EXPIRES_IN: {
+    readonly SESSION_MEMORY: number;
+    readonly PROJECT_MEMORY: number;
+    readonly LONG_TERM_MEMORY: number;
+};
+export declare const DEFAULT_APPROVAL_APP_URL: string;
+export declare const DEFAULT_DAEMON_URL: string;
+export declare const DEFAULT_RECALLKIT_DIR = ".recallkit";
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX,eAAO,MAAM,YAAY;;;;;CAKf,CAAC;AAEX,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX,eAAO,MAAM,wBAAwB,QAA6D,CAAC;AAEnG,eAAO,MAAM,kBAAkB,QAA8D,CAAC;AAE9F,eAAO,MAAM,qBAAqB,eAAe,CAAC"}

package/dist/constants.js

@@ -0,0 +1,19 @@
+export const PROJECT_ATTRIBUTE = {
+    key: "project",
+    value: "recallkit-v1",
+};
+export const ENTITY_TYPES = {
+    MANIFEST: "memory_manifest",
+    PACK: "memory_pack",
+    INDEX_CHECKPOINT: "memory_index_checkpoint",
+    COMMIT: "memory_commit",
+};
+export const DEFAULT_EXPIRES_IN = {
+    SESSION_MEMORY: 60 * 60 * 24 * 30,
+    PROJECT_MEMORY: 60 * 60 * 24 * 180,
+    LONG_TERM_MEMORY: 60 * 60 * 24 * 365,
+};
+export const DEFAULT_APPROVAL_APP_URL = process.env.RECALLKIT_LOCAL_URL ?? "http://localhost:4317";
+export const DEFAULT_DAEMON_URL = process.env.RECALLKIT_DAEMON_URL ?? "http://localhost:4318";
+export const DEFAULT_RECALLKIT_DIR = ".recallkit";
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,cAAc;CACb,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,QAAQ,EAAE,iBAAiB;IAC3B,IAAI,EAAE,aAAa;IACnB,gBAAgB,EAAE,yBAAyB;IAC3C,MAAM,EAAE,eAAe;CACf,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE;IACjC,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG;IAClC,gBAAgB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,GAAG;CAC5B,CAAC;AAEX,MAAM,CAAC,MAAM,wBAAwB,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,uBAAuB,CAAC;AAEnG,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,uBAAuB,CAAC;AAE9F,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC"}

package/dist/crypto/encryption.d.ts

@@ -0,0 +1,4 @@
+import type { EncryptedPayload } from "../types.js";
+export declare function encryptJson(payload: unknown, passphrase: string): Promise<EncryptedPayload>;
+export declare function decryptJson<T>(encryptedPayload: EncryptedPayload, passphrase: string): Promise<T>;
+//# sourceMappingURL=encryption.d.ts.map

package/dist/crypto/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/crypto/encryption.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAGpD,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiBjG;AAED,wBAAsB,WAAW,CAAC,CAAC,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBvG"}

package/dist/crypto/encryption.js

@@ -0,0 +1,34 @@
+import { base64ToBytes, bytesToBase64, deriveAesGcmKey, getCrypto, toArrayBuffer } from "./keys.js";
+export async function encryptJson(payload, passphrase) {
+    const crypto = getCrypto();
+    const salt = crypto.getRandomValues(new Uint8Array(16));
+    const iv = crypto.getRandomValues(new Uint8Array(12));
+    const key = await deriveAesGcmKey(passphrase, salt);
+    const plaintext = new TextEncoder().encode(JSON.stringify(payload));
+    const encrypted = await crypto.subtle.encrypt({ name: "AES-GCM", iv }, key, plaintext);
+    return {
+        version: 1,
+        encrypted: true,
+        algorithm: "AES-GCM",
+        kdf: "PBKDF2",
+        salt: bytesToBase64(salt),
+        iv: bytesToBase64(iv),
+        ciphertext: bytesToBase64(new Uint8Array(encrypted)),
+    };
+}
+export async function decryptJson(encryptedPayload, passphrase) {
+    if (encryptedPayload.version !== 1 ||
+        encryptedPayload.encrypted !== true ||
+        encryptedPayload.algorithm !== "AES-GCM" ||
+        encryptedPayload.kdf !== "PBKDF2") {
+        throw new Error("Unsupported RecallKit encrypted payload format.");
+    }
+    const salt = base64ToBytes(encryptedPayload.salt);
+    const iv = base64ToBytes(encryptedPayload.iv);
+    const ciphertext = base64ToBytes(encryptedPayload.ciphertext);
+    const key = await deriveAesGcmKey(passphrase, salt);
+    const plaintext = await getCrypto().subtle.decrypt({ name: "AES-GCM", iv: toArrayBuffer(iv) }, key, toArrayBuffer(ciphertext));
+    const decoded = new TextDecoder().decode(plaintext);
+    return JSON.parse(decoded);
+}
+//# sourceMappingURL=encryption.js.map

package/dist/crypto/encryption.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.js","sourceRoot":"","sources":["../../src/crypto/encryption.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAEpG,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAgB,EAAE,UAAkB;IACpE,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,EAAE,GAAG,MAAM,CAAC,eAAe,CAAC,IAAI,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACtD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC;IAEvF,OAAO;QACL,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,IAAI;QACf,SAAS,EAAE,SAAS;QACpB,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,aAAa,CAAC,IAAI,CAAC;QACzB,EAAE,EAAE,aAAa,CAAC,EAAE,CAAC;QACrB,UAAU,EAAE,aAAa,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,gBAAkC,EAAE,UAAkB;IACzF,IACE,gBAAgB,CAAC,OAAO,KAAK,CAAC;QAC9B,gBAAgB,CAAC,SAAS,KAAK,IAAI;QACnC,gBAAgB,CAAC,SAAS,KAAK,SAAS;QACxC,gBAAgB,CAAC,GAAG,KAAK,QAAQ,EACjC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAClD,MAAM,EAAE,GAAG,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,aAAa,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC9D,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,MAAM,SAAS,EAAE,CAAC,MAAM,CAAC,OAAO,CAChD,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,aAAa,CAAC,EAAE,CAAC,EAAE,EAC1C,GAAG,EACH,aAAa,CAAC,UAAU,CAAC,CAC1B,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAM,CAAC;AAClC,CAAC"}

package/dist/crypto/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./encryption.js";
+export * from "./keys.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/crypto/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/crypto/index.js

@@ -0,0 +1,3 @@
+export * from "./encryption.js";
+export * from "./keys.js";
+//# sourceMappingURL=index.js.map

package/dist/crypto/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,WAAW,CAAC"}

package/dist/crypto/keys.d.ts

@@ -0,0 +1,8 @@
+export declare function bytesToBase64(bytes: Uint8Array): string;
+export declare function base64ToBytes(value: string): Uint8Array;
+export declare function getCrypto(): Crypto;
+export declare function deriveAesGcmKey(passphrase: string, salt: Uint8Array): Promise<CryptoKey>;
+export declare function toArrayBuffer(bytes: Uint8Array): ArrayBuffer;
+export declare function sha256Hex(value: string): Promise<string>;
+export declare function hashScope(scope: string): Promise<string>;
+//# sourceMappingURL=keys.d.ts.map

package/dist/crypto/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../src/crypto/keys.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAQvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAWvD;AAED,wBAAgB,SAAS,IAAI,MAAM,CAMlC;AAED,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC,CAuB9F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAE5D;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG9D;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE9D"}

package/dist/crypto/keys.js

@@ -0,0 +1,54 @@
+export function bytesToBase64(bytes) {
+    if (typeof Buffer !== "undefined") {
+        return Buffer.from(bytes).toString("base64");
+    }
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary);
+}
+export function base64ToBytes(value) {
+    if (typeof Buffer !== "undefined") {
+        return new Uint8Array(Buffer.from(value, "base64"));
+    }
+    const binary = atob(value);
+    const bytes = new Uint8Array(binary.length);
+    for (let index = 0; index < binary.length; index += 1) {
+        bytes[index] = binary.charCodeAt(index);
+    }
+    return bytes;
+}
+export function getCrypto() {
+    const cryptoImpl = globalThis.crypto;
+    if (!cryptoImpl?.subtle) {
+        throw new Error("Web Crypto API is required for RecallKit encryption.");
+    }
+    return cryptoImpl;
+}
+export async function deriveAesGcmKey(passphrase, salt) {
+    if (passphrase.trim().length < 8) {
+        throw new Error("Encryption passphrase must be at least 8 characters.");
+    }
+    const crypto = getCrypto();
+    const passphraseBytes = new TextEncoder().encode(passphrase);
+    const baseKey = await crypto.subtle.importKey("raw", passphraseBytes, "PBKDF2", false, [
+        "deriveKey",
+    ]);
+    return crypto.subtle.deriveKey({
+        name: "PBKDF2",
+        salt: toArrayBuffer(salt),
+        iterations: 250_000,
+        hash: "SHA-256",
+    }, baseKey, { name: "AES-GCM", length: 256 }, false, ["encrypt", "decrypt"]);
+}
+export function toArrayBuffer(bytes) {
+    return bytes.buffer.slice(bytes.byteOffset, bytes.byteOffset + bytes.byteLength);
+}
+export async function sha256Hex(value) {
+    const hash = await getCrypto().subtle.digest("SHA-256", new TextEncoder().encode(value));
+    return [...new Uint8Array(hash)].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+export async function hashScope(scope) {
+    return sha256Hex(scope);
+}
+//# sourceMappingURL=keys.js.map

package/dist/crypto/keys.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./constants.js";
+export * from "./types.js";
+export * from "./crypto/index.js";
+export * from "./memory/index.js";
+export * from "./retrieval/index.js";
+export * from "./arkiv/index.js";
+export * from "./storage/index.js";
+//# 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,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export * from "./constants.js";
+export * from "./types.js";
+export * from "./crypto/index.js";
+export * from "./memory/index.js";
+export * from "./retrieval/index.js";
+export * from "./arkiv/index.js";
+export * from "./storage/index.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,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/dist/memory/compiler.d.ts

@@ -0,0 +1,7 @@
+import type { MemoryKind, MemoryRecord, PendingMemoryCandidate, SuggestMemoryInput } from "./schemas.js";
+export declare function classifyMemoryKind(text: string, provided?: MemoryKind): MemoryKind;
+export declare function extractKeywords(text: string, tags?: string[]): string[];
+export declare function summarizeText(text: string): string;
+export declare function compileMemoryCandidate(input: SuggestMemoryInput, createdByAgent?: string): PendingMemoryCandidate;
+export declare function pendingToMemoryRecord(pending: PendingMemoryCandidate, ownerWallet: string): MemoryRecord;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/memory/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/memory/compiler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EAEZ,sBAAsB,EACtB,kBAAkB,EACnB,MAAM,cAAc,CAAC;AAuBtB,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,CAUlF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,MAAM,EAAE,CAQ3E;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIlD;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,EACzB,cAAc,SAAU,GACvB,sBAAsB,CA6BxB;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,sBAAsB,EAC/B,WAAW,EAAE,MAAM,GAClB,YAAY,CAsCd"}