@pyxmate/memory 0.17.7 → 0.18.1

package/dist/{chunk-PUDKYGQI.mjs → chunk-HV6A2WTS.mjs}

@@ -1,6 +1,6 @@
 import {
   MemoryClient
-} from "./chunk-55E3V44T.mjs";
+} from "./chunk-SHT5FPV6.mjs";
 
 // ../dashboard/src/aggregations/consolidation-analytics.ts
 function analyzeConsolidationLog(entries) {

package/dist/{chunk-55E3V44T.mjs → chunk-SHT5FPV6.mjs}

@@ -513,6 +513,10 @@ var MemoryClient = class {
       throw error;
     }
   }
+  async lint(options) {
+    const qs = options?.limit ? `?limit=${encodeURIComponent(String(options.limit))}` : "";
+    return this.fetchApi(`/api/memory/lint${qs}`, { method: "GET" });
+  }
   async runDecay() {
     const result = await this.fetchApi("/api/memory/decay", {
       method: "POST"
@@ -546,6 +550,19 @@ var MemoryClient = class {
     );
     return result.entries;
   }
+  async log(filters = {}) {
+    const params = new URLSearchParams();
+    if (filters.since) params.set("since", filters.since);
+    if (filters.limit) params.set("limit", String(filters.limit));
+    if (filters.type) params.set("type", filters.type);
+    if (filters.agentId) params.set("agentId", filters.agentId);
+    if (filters.source) params.set("source", filters.source);
+    const qs = params.toString();
+    const result = await this.fetchApi(
+      `/api/memory/log${qs ? `?${qs}` : ""}`
+    );
+    return result.entries;
+  }
   async queryByEventTime(startTime, endTime, filters = {}) {
     const params = new URLSearchParams({ startTime, endTime });
     if (filters.type) params.set("type", filters.type);

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-PUDKYGQI.mjs";
-import "./chunk-55E3V44T.mjs";
+} from "./chunk-HV6A2WTS.mjs";
+import "./chunk-SHT5FPV6.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, MemoryStats as MemoryStats$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, IngestEvent as IngestEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1 } from '@pyx-memory/shared';
+import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, MemoryStats as MemoryStats$1, WikiLintReport as WikiLintReport$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, IngestEvent as IngestEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1 } from '@pyx-memory/shared';
 
 /** Parameters for paginated entry listing. */
 interface MemoryListParams {
@@ -34,6 +34,16 @@ interface TemporalQueryFilters {
     source?: string;
     limit?: number;
 }
+/** Filters for the chronological feed (`log`, Karpathy `log.md` primitive). */
+interface MemoryLogFilters {
+    /** Inclusive lower bound on `created_at` (ISO 8601). Cursor for "what's new since X". */
+    since?: string;
+    /** Maximum entries to return. The HTTP layer clamps to [1, 100]. */
+    limit?: number;
+    type?: MemoryType$1;
+    agentId?: string;
+    source?: string;
+}
 /** Options for scoping operations to a specific tenant. */
 interface TenantScopeOptions {
     tenantId?: string;
@@ -78,12 +88,25 @@ interface ExtendedMemoryInterface extends MemoryInterface {
     forget(id: string, reason?: string): Promise<boolean>;
     /** Summarize a session's memories into a long-term entry. */
     summarizeSession(sessionId: string): Promise<MemoryEntry$1 | null>;
+    /**
+     * Read-only memory-wide lint report (v0.18.0 Karpathy-wiki Item B):
+     * orphans, decay candidates, stale entries, dedup candidates. Pure
+     * projection — no writes.
+     */
+    lint(options?: {
+        limit?: number;
+    }): Promise<WikiLintReport$1>;
     /** Run decay on all entries, archiving those below threshold. */
     runDecay(): Promise<number>;
     /** Reindex the FTS5 full-text search index. */
     reindex(): Promise<void>;
     /** Delete all entries matching a source, cleaning up all stores. */
     deleteBySource(source: string): Promise<number>;
+    /**
+     * Chronological feed of memory entries (Karpathy `log.md` primitive).
+     * Cursor-based via `since` (created_at lower bound). No totalCount.
+     */
+    log(filters?: MemoryLogFilters): Promise<MemoryEntry$1[]>;
 }
 
 /**
@@ -245,11 +268,15 @@ declare class MemoryClient implements ExtendedMemoryInterface {
     consolidate(): Promise<ConsolidationRunResult>;
     forget(id: string, reason?: string): Promise<boolean>;
     summarizeSession(sessionId: string): Promise<MemoryEntry$1 | null>;
+    lint(options?: {
+        limit?: number;
+    }): Promise<WikiLintReport$1>;
     runDecay(): Promise<number>;
     reindex(): Promise<void>;
     clearGraph(): Promise<number>;
     deleteBySource(source: string): Promise<number>;
     queryAsOf(asOfDate: string, filters?: TemporalQueryFilters): Promise<MemoryEntry$1[]>;
+    log(filters?: MemoryLogFilters): Promise<MemoryEntry$1[]>;
     queryByEventTime(startTime: string, endTime: string, filters?: TemporalQueryFilters): Promise<MemoryEntry$1[]>;
     protected fetchApi<T>(path: string, options?: RequestInit): Promise<T>;
     /**
@@ -579,6 +606,24 @@ interface GraphTraversalResult {
         relationshipIds: string[];
     }>;
 }
+/**
+ * Memory.lint() report shape — Karpathy-wiki Item B (v0.18.0).
+ * Read-only projection composed from signals every owning module
+ * already exposes. Lives in shared so the HTTP client can hold the
+ * same type as core without re-declaring it.
+ */
+interface WikiLintReport {
+    orphans: GraphNode[];
+    decayCandidates: MemoryEntry[];
+    staleSyntheses: Array<{
+        entry: MemoryEntry;
+        reason: string;
+    }>;
+    dedupCandidates: Array<{
+        hash: string;
+        entryIds: string[];
+    }>;
+}
 
 /** Metadata for a single image extracted from a PDF. */
 interface ExtractedImageMeta {
@@ -845,4 +890,4 @@ interface PrincipalContext {
 /** Sentinel tenant ID used in single-tenant deployments. */
 declare const SINGLE_TENANT_ID = "_single";
 
-export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, EmbeddingProviderName, type EnrichmentCallbacks, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, SINGLE_TENANT_ID, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, VectorProvider };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, EmbeddingProviderName, type EnrichmentCallbacks, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemoryLogFilters, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, SINGLE_TENANT_ID, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, VectorProvider, type WikiLintReport };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   MemoryClient,
   MemoryServerError
-} from "./chunk-55E3V44T.mjs";
+} from "./chunk-SHT5FPV6.mjs";
 
 // ../shared/src/constants/defaults.ts
 var DEFAULTS = {

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-PUDKYGQI.mjs";
-import "./chunk-55E3V44T.mjs";
+} from "./chunk-HV6A2WTS.mjs";
+import "./chunk-SHT5FPV6.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts
 import { useCallback as useCallback2, useMemo } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyxmate/memory",
-  "version": "0.17.7",
+  "version": "0.18.1",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",