@hasna/mementos 0.14.86 → 0.14.88

package/dist/types/index.d.ts

@@ -0,0 +1,482 @@
+export declare const MEMORY_SCOPES: readonly ["global", "shared", "private", "working"];
+export type MemoryScope = (typeof MEMORY_SCOPES)[number];
+export declare const MEMORY_CATEGORIES: readonly ["preference", "fact", "knowledge", "history", "procedural", "resource"];
+export type MemoryCategory = (typeof MEMORY_CATEGORIES)[number];
+export declare const MEMORY_SOURCES: readonly ["user", "agent", "system", "auto", "imported"];
+export type MemorySource = (typeof MEMORY_SOURCES)[number];
+export declare const MEMORY_STATUSES: readonly ["active", "archived", "expired"];
+export type MemoryStatus = (typeof MEMORY_STATUSES)[number];
+export interface Memory {
+    id: string;
+    key: string;
+    value: string;
+    category: MemoryCategory;
+    scope: MemoryScope;
+    summary: string | null;
+    tags: string[];
+    importance: number;
+    source: MemorySource;
+    status: MemoryStatus;
+    pinned: boolean;
+    agent_id: string | null;
+    project_id: string | null;
+    session_id: string | null;
+    machine_id?: string | null;
+    flag?: string | null;
+    when_to_use?: string | null;
+    sequence_group?: string | null;
+    sequence_order?: number | null;
+    content_type?: "text" | "code" | "image" | "resource";
+    namespace?: string | null;
+    created_by_agent?: string | null;
+    updated_by_agent?: string | null;
+    trust_score?: number | null;
+    metadata: Record<string, unknown>;
+    access_count: number;
+    version: number;
+    expires_at: string | null;
+    valid_from: string | null;
+    valid_until: string | null;
+    ingested_at: string | null;
+    created_at: string;
+    updated_at: string;
+    accessed_at: string | null;
+}
+export interface MemoryWithRelations extends Memory {
+    agent: Agent | null;
+    project: Project | null;
+}
+export interface CreateMemoryInput {
+    key: string;
+    value: string;
+    category?: MemoryCategory;
+    scope?: MemoryScope;
+    summary?: string;
+    tags?: string[];
+    importance?: number;
+    source?: MemorySource;
+    agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    metadata?: Record<string, unknown>;
+    expires_at?: string;
+    ttl_ms?: number;
+    machine_id?: string;
+    flag?: string;
+    when_to_use?: string;
+    sequence_group?: string;
+    sequence_order?: number;
+    namespace?: string;
+    content_type?: "text" | "code" | "image" | "resource";
+}
+export interface UpdateMemoryInput {
+    value?: string;
+    category?: MemoryCategory;
+    scope?: MemoryScope;
+    summary?: string | null;
+    tags?: string[];
+    importance?: number;
+    pinned?: boolean;
+    status?: MemoryStatus;
+    metadata?: Record<string, unknown>;
+    expires_at?: string | null;
+    flag?: string | null;
+    when_to_use?: string | null;
+    /** Writing agent identity, recorded for attribution. Null explicitly clears it. */
+    updated_by_agent?: string | null;
+    version: number;
+}
+export interface MemoryFilter {
+    key?: string;
+    scope?: MemoryScope | MemoryScope[];
+    category?: MemoryCategory | MemoryCategory[];
+    source?: MemorySource | MemorySource[];
+    status?: MemoryStatus | MemoryStatus[];
+    project_id?: string;
+    agent_id?: string;
+    session_id?: string;
+    machine_id?: string | null;
+    visible_to_machine_id?: string | null;
+    tags?: string[];
+    min_importance?: number;
+    pinned?: boolean;
+    search?: string;
+    /** Annotation flag (e.g. needs-review, outdated, verify) — the local branch
+     *  already filters on it via the memory row's `flag` column. */
+    flag?: string;
+    namespace?: string;
+    as_of?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface MemorySearchResult {
+    memory: Memory;
+    score: number;
+    match_type: "exact" | "fuzzy" | "tag";
+    highlights?: {
+        field: string;
+        snippet: string;
+    }[];
+    /**
+     * Confidence margin 0.0–1.0 (borrowed from nuggets).
+     * High (>0.7) = top result clearly best. Low (<0.3) = several similar matches.
+     * Derived from FTS5 rank spread: (score_rank1 - score_rank2) / score_rank1.
+     * Only present on the first result.
+     */
+    confidence?: number;
+}
+export interface Agent {
+    id: string;
+    name: string;
+    session_id: string | null;
+    description: string | null;
+    role: string | null;
+    metadata: Record<string, unknown>;
+    active_project_id: string | null;
+    created_at: string;
+    last_seen_at: string;
+}
+export declare class AgentConflictError extends Error {
+    readonly conflict: true;
+    readonly existing_id: string;
+    readonly existing_name: string;
+    readonly last_seen_at: string;
+    readonly session_hint: string | null;
+    readonly working_dir: string | null;
+    constructor(opts: {
+        existing_id: string;
+        existing_name: string;
+        last_seen_at: string;
+        session_hint: string | null;
+        working_dir?: string | null;
+    });
+}
+export declare function isAgentConflict(result: unknown): result is AgentConflictError;
+export interface Project {
+    id: string;
+    name: string;
+    path: string;
+    description: string | null;
+    memory_prefix: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface UpdateProjectInput {
+    name?: string;
+    path?: string;
+    description?: string | null;
+    memory_prefix?: string | null;
+}
+export interface ProjectAuthorityIdentity {
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+}
+export interface ProjectGuardedUpdateRequest extends ProjectAuthorityIdentity {
+    operation_id: string;
+    step_id: string;
+    idempotency_key: string;
+    expected_revision: string;
+    updates: UpdateProjectInput;
+}
+export interface ProjectGuardedRollbackRequest extends ProjectAuthorityIdentity {
+    operation_id: string;
+    step_id: string;
+    idempotency_key: string;
+    expected_revision: string;
+    accepted_receipt_id: string;
+}
+export interface ProjectUpdateReceipt {
+    receipt_id: string;
+    authority: "mementos";
+    route: "mementos.project-guarded-update.v1";
+    package_version: string;
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+    operation_id: string;
+    step_id: string;
+    direction: "forward" | "rollback";
+    idempotency_key: string;
+    request_digest: string;
+    outcome: "accepted";
+    target_id: string;
+    expected_revision: string;
+    result_revision: string;
+    result_digest: string;
+    accepted_receipt_id: string | null;
+    before_project: Project;
+    after_project: Project;
+    created_at: string;
+}
+export interface ProjectGuardedUpdateResult {
+    dry_run: boolean;
+    applied: boolean;
+    project: Project;
+    receipt: ProjectUpdateReceipt | null;
+}
+export interface MemoryProjectLinkSnapshot {
+    memory_id: string;
+    project_id: string | null;
+    memory_version: number;
+    memory_revision: string;
+    memory_digest: string;
+}
+export interface MemoryProjectLinkRequest extends ProjectAuthorityIdentity {
+    operation_id: string;
+    step_id: string;
+    idempotency_key: string;
+    expected_memory_version: number;
+    expected_memory_revision: string;
+    target_project_id: string;
+    expected_project_revision: string;
+}
+export interface MemoryProjectLinkRollbackRequest extends ProjectAuthorityIdentity {
+    operation_id: string;
+    step_id: string;
+    idempotency_key: string;
+    expected_memory_version: number;
+    expected_memory_revision: string;
+    accepted_receipt_id: string;
+}
+export interface MemoryProjectLinkReceipt {
+    receipt_id: string;
+    authority: "mementos";
+    route: "mementos.memory-project-link.v1";
+    package_version: string;
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+    operation_id: string;
+    step_id: string;
+    direction: "forward" | "rollback";
+    idempotency_key: string;
+    request_digest: string;
+    outcome: "accepted" | "no_change";
+    target_memory_id: string;
+    requested_project_id: string;
+    expected_memory_version: number;
+    expected_memory_revision: string;
+    expected_project_revision: string | null;
+    result_memory_version: number;
+    result_memory_revision: string;
+    result_memory_digest: string;
+    result_project_revision: string | null;
+    result_project_digest: string | null;
+    accepted_receipt_id: string | null;
+    before_link: MemoryProjectLinkSnapshot;
+    after_link: MemoryProjectLinkSnapshot;
+    before_project_revision: string | null;
+    before_project_digest: string | null;
+    after_project_revision: string | null;
+    after_project_digest: string | null;
+    created_at: string;
+}
+export interface MemoryProjectLinkResult {
+    dry_run: boolean;
+    applied: boolean;
+    no_change: boolean;
+    memory: Memory;
+    project: Project | null;
+    receipt: MemoryProjectLinkReceipt | null;
+}
+export interface MemoryStats {
+    total: number;
+    by_scope: Record<MemoryScope, number>;
+    by_category: Record<MemoryCategory, number>;
+    by_status: Record<MemoryStatus, number>;
+    by_agent: Record<string, number>;
+    pinned_count: number;
+    /** Rows with status = 'expired' — exactly what `--status expired` returns. */
+    expired_count: number;
+    /** Rows carrying any expires_at date (future or past). */
+    expires_at_count: number;
+    /** Retention backlog: status = 'expired' OR expires_at in the past. */
+    expired_due_count: number;
+}
+export interface MementosConfig {
+    default_scope: MemoryScope;
+    default_category: MemoryCategory;
+    default_importance: number;
+    max_entries: number;
+    max_entries_per_scope: Record<MemoryScope, number>;
+    injection: {
+        max_tokens: number;
+        min_importance: number;
+        categories: MemoryCategory[];
+        refresh_interval: number;
+    };
+    extraction: {
+        enabled: boolean;
+        min_confidence: number;
+    };
+    sync_agents: string[];
+    auto_cleanup: {
+        enabled: boolean;
+        expired_check_interval: number;
+        unused_archive_days: number;
+        stale_deprioritize_days: number;
+    };
+}
+export type DedupeMode = "merge" | "create" | "overwrite" | "error" | "version-fork";
+export type SyncDirection = "push" | "pull" | "both";
+export type ConflictResolution = "prefer-local" | "prefer-remote" | "prefer-newer";
+export interface SyncOptions {
+    direction: SyncDirection;
+    conflict_resolution?: ConflictResolution;
+    agent_id?: string;
+    project_id?: string;
+}
+export interface SyncResult {
+    pushed: number;
+    pulled: number;
+    conflicts: number;
+    errors: string[];
+}
+export type EntityType = 'person' | 'project' | 'tool' | 'concept' | 'file' | 'api' | 'pattern' | 'organization';
+export type RelationType = 'uses' | 'knows' | 'depends_on' | 'created_by' | 'related_to' | 'contradicts' | 'part_of' | 'implements' | 'happened_before' | 'happened_after' | 'caused_by' | 'resulted_in' | 'supersedes' | 'version_of';
+export type EntityRole = 'subject' | 'object' | 'context';
+export interface Entity {
+    id: string;
+    name: string;
+    type: EntityType;
+    description: string | null;
+    metadata: Record<string, unknown>;
+    project_id: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface Relation {
+    id: string;
+    source_entity_id: string;
+    target_entity_id: string;
+    relation_type: RelationType;
+    weight: number;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export interface EntityMemory {
+    entity_id: string;
+    memory_id: string;
+    role: EntityRole;
+    created_at: string;
+}
+export interface EntityWithRelations extends Entity {
+    relations: Relation[];
+    memories: Memory[];
+}
+export interface CreateEntityInput {
+    name: string;
+    type: EntityType;
+    description?: string;
+    metadata?: Record<string, unknown>;
+    project_id?: string;
+}
+export interface UpdateEntityInput {
+    name?: string;
+    type?: EntityType;
+    description?: string | null;
+    metadata?: Record<string, unknown>;
+}
+export interface CreateRelationInput {
+    source_entity_id: string;
+    target_entity_id: string;
+    relation_type: RelationType;
+    weight?: number;
+    metadata?: Record<string, unknown>;
+}
+export declare class EntityNotFoundError extends Error {
+    constructor(id: string);
+}
+export interface MemoryVersion {
+    id: string;
+    memory_id: string;
+    version: number;
+    value: string;
+    importance: number;
+    scope: MemoryScope;
+    category: MemoryCategory;
+    tags: string[];
+    summary: string | null;
+    pinned: boolean;
+    status: MemoryStatus;
+    when_to_use?: string | null;
+    created_at: string;
+}
+export declare class MemoryNotFoundError extends Error {
+    constructor(id: string);
+}
+export declare class DuplicateMemoryError extends Error {
+    constructor(key: string, scope: MemoryScope);
+}
+export declare class MemoryExpiredError extends Error {
+    constructor(id: string);
+}
+export declare class InvalidScopeError extends Error {
+    constructor(message: string);
+}
+export declare class VersionConflictError extends Error {
+    expected: number;
+    actual: number;
+    constructor(id: string, expected: number, actual: number);
+}
+export declare class MemoryConflictError extends Error {
+    existingId: string;
+    existingAgentId: string | null;
+    existingUpdatedAt: string;
+    constructor(key: string, existing: {
+        id: string;
+        agent_id: string | null;
+        updated_at: string;
+    });
+}
+export type ToolErrorType = 'timeout' | 'permission' | 'not_found' | 'syntax' | 'rate_limit' | 'other';
+export interface ToolEvent {
+    id: string;
+    tool_name: string;
+    action: string | null;
+    success: boolean;
+    error_type: ToolErrorType | null;
+    error_message: string | null;
+    tokens_used: number | null;
+    latency_ms: number | null;
+    context: string | null;
+    lesson: string | null;
+    when_to_use: string | null;
+    agent_id: string | null;
+    project_id: string | null;
+    session_id: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export interface CreateToolEventInput {
+    tool_name: string;
+    action?: string;
+    success: boolean;
+    error_type?: ToolErrorType;
+    error_message?: string;
+    tokens_used?: number;
+    latency_ms?: number;
+    context?: string;
+    lesson?: string;
+    when_to_use?: string;
+    agent_id?: string;
+    project_id?: string;
+    session_id?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ToolStats {
+    tool_name: string;
+    total_calls: number;
+    success_count: number;
+    failure_count: number;
+    success_rate: number;
+    avg_tokens: number | null;
+    avg_latency_ms: number | null;
+    common_errors: {
+        error_type: string;
+        count: number;
+    }[];
+    last_used: string;
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.14.86",
+  "version": "0.14.88",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",
@@ -36,7 +36,8 @@
     "bun.lock",
     "hasna.contract.json",
     "LICENSE",
-    "README.md"
+    "README.md",
+    "postinstall.mjs"
   ],
   "scripts": {
     "clean": "rm -rf dist",
@@ -54,8 +55,8 @@
     "dev:cli": "bun run src/cli/index.tsx",
     "dev:mcp": "bun run src/mcp/index.ts",
     "dev:serve": "bun run src/server/index.ts",
-    "postinstall": "mkdir -p $HOME/.hasna/mementos $HOME/.hasna/mementos/profiles $HOME/.hasna/mementos/agents $HOME/.hasna/mementos/training 2>/dev/null || true",
-    "build:js": "bun run clean && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external @hasna/contracts --external @hasna/contracts/schemas --external @hasna/contracts/auth --external pg && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external @hasna/contracts --external @hasna/contracts/schemas --external @hasna/contracts/auth --external pg && bun build src/server/index.ts --outdir dist/server --target bun --external @hasna/contracts --external @hasna/contracts/schemas --external @hasna/contracts/auth --external pg && bun build src/index.ts src/storage.ts src/pg-sync-worker.ts src/project-registration.ts --outdir dist --target bun --external @hasna/contracts --external @hasna/contracts/schemas --external @hasna/contracts/auth --external pg && bun build src/diagnostics/historical-project-registration-receipt.ts --outdir dist/diagnostics --target bun --external pg && bun build src/sdk/index.ts --outdir dist/sdk --target bun"
+    "postinstall": "node postinstall.mjs",
+    "build:js": "bun run clean && bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk --external @hasna/contracts --external @hasna/contracts/schemas --external @hasna/contracts/auth --external pg && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk --external @hasna/contracts --external @hasna/contracts/schemas --external @hasna/contracts/auth --external pg && bun build src/server/index.ts --outdir dist/server --target bun --external @hasna/contracts --external @hasna/contracts/schemas --external @hasna/contracts/auth --external pg && bun build src/index.ts src/storage.ts src/pg-sync-worker.ts src/project-registration.ts --outdir dist --target bun --external @hasna/contracts --external @hasna/contracts/schemas --external @hasna/contracts/auth --external pg && bun build src/diagnostics/historical-project-registration-receipt.ts --outdir dist/diagnostics --target bun --external pg && bun build src/sdk/index.ts --outdir dist/sdk --target bun && tsc --emitDeclarationOnly --outDir dist"
   },
   "keywords": [
     "memory",
@@ -92,6 +93,7 @@
     "@ai-sdk/openai-compatible": "^2.0.48",
     "@hasna/contracts": "0.10.6",
     "@hasna/events": "0.1.6",
+    "@hasna/paths": "0.1.0",
     "@modelcontextprotocol/sdk": "^1.12.1",
     "ai": "^6.0.199",
     "chalk": "^5.4.1",

package/postinstall.mjs

@@ -0,0 +1,34 @@
+// Best-effort install-time creation of the mementos data home, resolving the
+// SAME effective data root the runtime uses (src/lib/paths.ts getDataRoot): an
+// exact-app override (HASNA_MEMENTOS_HOME / MEMENTOS_HOME) wins; otherwise the
+// @hasna/paths XDG data home once adopted (HASNA_DATA_HOME set, or mementos.db
+// already migrated there); otherwise the legacy ~/.hasna/mementos default.
+// Failures are non-fatal: the runtime creates the same directories on first use.
+import { existsSync, mkdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+
+const EXACT_OVERRIDES = [
+  (process.env["HASNA_MEMENTOS_HOME"] || "").trim(),
+  (process.env["MEMENTOS_HOME"] || "").trim(),
+].filter(Boolean);
+const DATA_HOME_OVERRIDE = (process.env["HASNA_DATA_HOME"] || "").trim();
+
+try {
+  const { dataDir } = await import("@hasna/paths");
+  const home = process.env["HOME"] || process.env["USERPROFILE"] || homedir();
+  const resolved = dataDir({ app: "mementos", home });
+  let root;
+  if (EXACT_OVERRIDES.length > 0) {
+    root = EXACT_OVERRIDES[0];
+  } else if (DATA_HOME_OVERRIDE || existsSync(join(resolved, "mementos.db"))) {
+    root = resolved;
+  } else {
+    root = join(home, ".hasna", "mementos");
+  }
+  for (const sub of ["", "profiles", "agents", "training", "backups", "storage"]) {
+    mkdirSync(join(root, sub), { recursive: true });
+  }
+} catch {
+  // never fail an install over pre-created directories
+}