aismemory 0.2.0 → 0.3.0

package/dist/sources/types.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Source Adapter interface — the plug-in contract for each memory provider.
+ *
+ * Each memory source (Claude local files, Claude.ai paste, ChatGPT paste, etc.)
+ * implements this interface in a self-contained file. Adapters PARSE and NORMALIZE;
+ * they never write to AIS directly. The ingestion pipeline does all writes.
+ */
+import type { SyncScope, AisMemoryDraft } from '../pipeline/types.js';
+export type SourceKind = 'filesystem' | 'paste' | 'api';
+export interface SourceAdapter {
+    readonly id: string;
+    readonly displayName: string;
+    readonly kind: SourceKind;
+    readonly icon?: string;
+    /**
+     * Return the prompt the human should paste into the source provider, or an
+     * empty string for filesystem-kind adapters.
+     */
+    extractionPrompt(scope: SyncScope): string;
+    /**
+     * Parse whatever the provider returned. MUST NOT throw on partial/malformed
+     * data — return what can be parsed in `memories`, surface problems in
+     * `warnings`. `raw` is string for paste, FilesystemResult for filesystem.
+     */
+    parseResponse(raw: string | FilesystemResult): ParseResult;
+    /**
+     * Map a SourceMemory to an AIS memory draft. Applies provider-specific
+     * category→type mapping. Does NOT set trust/provenance — the trust-tagger
+     * stage does that.
+     */
+    mapToAis(src: SourceMemory, scope: SyncScope, agentId: string): AisMemoryDraft;
+    /**
+     * Deterministic dedupe key for this memory. Default: sha256(content + source + sourceCategory).
+     */
+    dedupeKey(src: SourceMemory): string;
+}
+export interface SourceMemory {
+    content: string;
+    sourceCategory?: string;
+    sourceDate?: string | null;
+    sourceMetadata?: Record<string, unknown>;
+}
+export interface ParseResult {
+    memories: SourceMemory[];
+    warnings: string[];
+}
+export interface FilesystemResult {
+    rootPath: string;
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+}

package/dist/sources/types.js

@@ -0,0 +1,9 @@
+/**
+ * Source Adapter interface — the plug-in contract for each memory provider.
+ *
+ * Each memory source (Claude local files, Claude.ai paste, ChatGPT paste, etc.)
+ * implements this interface in a self-contained file. Adapters PARSE and NORMALIZE;
+ * they never write to AIS directly. The ingestion pipeline does all writes.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sources/types.js.map

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

package/dist/trust-ledger.d.ts

@@ -0,0 +1,8 @@
+export declare class TrustLedger {
+    private readonly filePath;
+    private data;
+    constructor(home?: string);
+    isTrusted(agentId: string, sourceId: string, scopeKey: string): boolean;
+    recordSync(agentId: string, sourceId: string, scopeKey: string): void;
+    private persist;
+}

package/dist/trust-ledger.js

@@ -0,0 +1,61 @@
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const TRUST_AFTER_SYNCS = 2;
+export class TrustLedger {
+    filePath;
+    data;
+    constructor(home = homedir()) {
+        const dir = join(home, '.aismemory');
+        this.filePath = join(dir, 'trust-ledger.json');
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true, mode: 0o700 });
+        }
+        if (existsSync(this.filePath)) {
+            try {
+                this.data = JSON.parse(readFileSync(this.filePath, 'utf8'));
+            }
+            catch {
+                const backup = `${this.filePath}.corrupt-${Date.now()}`;
+                try {
+                    renameSync(this.filePath, backup);
+                    console.warn(`[TrustLedger] Corrupt ledger file renamed to ${backup}; starting fresh.`);
+                }
+                catch {
+                    console.warn(`[TrustLedger] Corrupt ledger file could not be backed up; starting fresh.`);
+                }
+                this.data = {};
+            }
+        }
+        else {
+            this.data = {};
+        }
+    }
+    isTrusted(agentId, sourceId, scopeKey) {
+        return this.data[agentId]?.[sourceId]?.[scopeKey]?.trusted === true;
+    }
+    recordSync(agentId, sourceId, scopeKey) {
+        const now = new Date().toISOString();
+        const agent = this.data[agentId] ?? {};
+        const source = agent[sourceId] ?? {};
+        const existing = source[scopeKey];
+        const entry = existing
+            ? {
+                firstSyncAt: existing.firstSyncAt,
+                lastSyncAt: now,
+                syncCount: existing.syncCount + 1,
+                trusted: existing.syncCount + 1 >= TRUST_AFTER_SYNCS,
+            }
+            : { firstSyncAt: now, lastSyncAt: now, syncCount: 1, trusted: false };
+        source[scopeKey] = entry;
+        agent[sourceId] = source;
+        this.data[agentId] = agent;
+        this.persist();
+    }
+    persist() {
+        const tmp = `${this.filePath}.tmp`;
+        writeFileSync(tmp, JSON.stringify(this.data, null, 2), { mode: 0o600 });
+        renameSync(tmp, this.filePath);
+    }
+}
+//# sourceMappingURL=trust-ledger.js.map

package/dist/trust-ledger.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aismemory",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Persistent memory for AI agents. MCP server that connects to Agent Identity Service.",
   "type": "module",
   "bin": "dist/index.js",