@pyxmate/memory 0.27.0 → 0.28.0

package/dist/{chunk-5X2HOMDQ.mjs → chunk-C5HKNVI5.mjs}

@@ -663,6 +663,31 @@ var MemoryClient = class {
       throw error;
     }
   }
+  /**
+   * v0.28 correction-memory — record an explicit correction. POSTs to
+   * `/api/memory/corrections`; tenant is header-derived (server-side), so
+   * the body carries only the correction fields. Returns `{ id, createdAt }`.
+   */
+  async recordCorrection(input) {
+    return this.fetchApi("/api/memory/corrections", {
+      method: "POST",
+      body: JSON.stringify(input)
+    });
+  }
+  /**
+   * v0.28 correction-memory — fetch the corrections applicable to a task
+   * shape. GETs `/api/memory/corrections`; returns `[]` when none have
+   * positive overlap. pyx never auto-prepends — the agent owns inclusion.
+   */
+  async fetchApplicableCorrections(input) {
+    const params = new URLSearchParams({
+      namespaceId: input.namespaceId,
+      taskShape: input.taskShape
+    });
+    if (input.project) params.set("project", input.project);
+    if (input.limit !== void 0) params.set("limit", String(input.limit));
+    return this.fetchApi(`/api/memory/corrections?${params}`);
+  }
   async fetchApi(path, options) {
     const signal = options?.signal ?? AbortSignal.timeout(this._requestTimeoutMs);
     let res;

package/dist/{chunk-4BJCSQOO.mjs → chunk-XPZ4DUON.mjs}

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

package/dist/cli/pyx-mem.mjs

@@ -15169,6 +15169,80 @@ var scopeShape = {
   callerAccessLevel: external_exports.enum(["public", "internal", "secret"]).optional().describe("Sent as X-Caller-Access-Level for sensitivity filtering.")
 };
 
+// src/mcp/tools/corrections.ts
+var recordInputShape = {
+  namespaceId: external_exports.string().min(1).describe("Namespace id to record the correction into."),
+  whatWasWrong: external_exports.string().min(1).describe("What the agent did wrong."),
+  whatToDoInstead: external_exports.string().min(1).describe("The corrective instruction to follow instead."),
+  appliesWhen: external_exports.string().min(1).describe("When this correction applies \u2014 the task context future tasks are matched against."),
+  project: external_exports.string().optional().describe("Optional project scope; omit to apply to all projects."),
+  taskShape: external_exports.string().optional().describe("Optional task-shape hint stored for provenance."),
+  ...scopeShape
+};
+var recordCorrectionTool = {
+  name: "record_correction",
+  config: {
+    title: "Record a pyx-memory correction",
+    description: 'Record an explicit user correction so the same mistake can be avoided next time. Call this when the user explicitly corrects the agent ("you did X wrong; do Y instead"). HTTP proxy to POST /api/memory/corrections \u2014 returns `{id, createdAt}`.',
+    inputSchema: recordInputShape,
+    annotations: { readOnlyHint: false, openWorldHint: true }
+  },
+  handler: (deps) => async (raw) => {
+    const args = raw;
+    const creds = await deps.readCredentials();
+    if (!creds.ok) return creds.result;
+    const http = createHttpClient(creds.credentials, deps.fetchImpl);
+    const res = await http.requestJson({
+      method: "POST",
+      path: "/api/memory/corrections",
+      body: {
+        namespaceId: args.namespaceId,
+        whatWasWrong: args.whatWasWrong,
+        whatToDoInstead: args.whatToDoInstead,
+        appliesWhen: args.appliesWhen,
+        ...args.project !== void 0 ? { project: args.project } : {},
+        ...args.taskShape !== void 0 ? { taskShape: args.taskShape } : {}
+      },
+      scope: args
+    });
+    return res.ok ? mcpJson(res.data) : res.result;
+  }
+};
+var fetchInputShape = {
+  namespaceId: external_exports.string().min(1).describe("Namespace id whose corrections to fetch."),
+  taskShape: external_exports.string().min(1).describe("Shape of the task about to run \u2014 scored against each correction."),
+  project: external_exports.string().optional().describe("Optional project filter."),
+  limit: external_exports.number().int().positive().optional().describe("Max corrections to return (cap 5)."),
+  ...scopeShape
+};
+var fetchApplicableCorrectionsTool = {
+  name: "fetch_applicable_corrections",
+  config: {
+    title: "Fetch applicable pyx-memory corrections",
+    description: "Fetch the corrections applicable to a task shape (\u22645, ranked by overlap then recency). pyx never auto-prepends \u2014 you decide whether to follow them. HTTP proxy to GET /api/memory/corrections \u2014 returns a `CorrectionRecord[]` (`[]` when none apply).",
+    inputSchema: fetchInputShape,
+    annotations: { readOnlyHint: true, openWorldHint: true }
+  },
+  handler: (deps) => async (raw) => {
+    const args = raw;
+    const creds = await deps.readCredentials();
+    if (!creds.ok) return creds.result;
+    const http = createHttpClient(creds.credentials, deps.fetchImpl);
+    const res = await http.requestJson({
+      method: "GET",
+      path: "/api/memory/corrections",
+      query: {
+        namespaceId: args.namespaceId,
+        taskShape: args.taskShape,
+        project: args.project,
+        limit: args.limit
+      },
+      scope: args
+    });
+    return res.ok ? mcpJson(res.data) : res.result;
+  }
+};
+
 // src/mcp/tools/delete.ts
 var inputShape = {
   id: external_exports.string().min(1).describe("Required memory entry id to delete."),
@@ -15679,14 +15753,16 @@ var ALL_TOOLS = [
   summarizeMemoryEntityTool,
   statusTool,
   getUserProfileTool,
-  upsertUserProfileTool
+  upsertUserProfileTool,
+  recordCorrectionTool,
+  fetchApplicableCorrectionsTool
 ];
 var ALL_TOOL_NAMES = ALL_TOOLS.map((t) => t.name);
 
 // src/mcp/server.ts
 async function runMcpServer(opts) {
   const fetchImpl = opts.fetchImpl ?? fetch;
-  const version2 = opts.version ?? (true ? "0.27.0" : "0.0.0-dev");
+  const version2 = opts.version ?? (true ? "0.28.0" : "0.0.0-dev");
   const server = new McpServer(
     { name: "pyx-memory", version: version2 },
     { instructions: PYX_MEMORY_INSTRUCTIONS, capabilities: { tools: {} } }

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-4BJCSQOO.mjs";
-import "./chunk-5X2HOMDQ.mjs";
+} from "./chunk-XPZ4DUON.mjs";
+import "./chunk-C5HKNVI5.mjs";
 import "./chunk-SSUYQJUI.mjs";
 export {
   DashboardClient,

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, WikiLintReport as WikiLintReport$1, GraphRepairResult as GraphRepairResult$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, EntityExtractionResult as EntityExtractionResult$1, Topology as Topology$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, GraphRepairResult as GraphRepairResult$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, EntityExtractionResult as EntityExtractionResult$1, Topology as Topology$1, IngestEvent as IngestEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1, CorrectionRecord as CorrectionRecord$1 } from '@pyx-memory/shared';
 
 /** Parameters for paginated entry listing. */
 interface MemoryListParams {
@@ -374,6 +374,33 @@ declare class MemoryClient implements ExtendedMemoryInterface {
         updatedAt: string;
         contentSize: number;
     } | null>;
+    /**
+     * v0.28 correction-memory — record an explicit correction. POSTs to
+     * `/api/memory/corrections`; tenant is header-derived (server-side), so
+     * the body carries only the correction fields. Returns `{ id, createdAt }`.
+     */
+    recordCorrection(input: {
+        namespaceId: string;
+        whatWasWrong: string;
+        whatToDoInstead: string;
+        appliesWhen: string;
+        project?: string;
+        taskShape?: string;
+    }): Promise<{
+        id: string;
+        createdAt: string;
+    }>;
+    /**
+     * v0.28 correction-memory — fetch the corrections applicable to a task
+     * shape. GETs `/api/memory/corrections`; returns `[]` when none have
+     * positive overlap. pyx never auto-prepends — the agent owns inclusion.
+     */
+    fetchApplicableCorrections(input: {
+        namespaceId: string;
+        taskShape: string;
+        project?: string;
+        limit?: number;
+    }): Promise<CorrectionRecord$1[]>;
     protected fetchApi<T>(path: string, options?: RequestInit): Promise<T>;
     /**
      * Map fetch-layer rejections into a typed `MemoryServerError` so callers
@@ -675,6 +702,51 @@ interface MemoryIngestRequest {
      */
     pinned?: boolean;
 }
+/**
+ * Agent-recorded explicit correction ("you did X wrong; do Y instead").
+ * `Memory.recordCorrection` writes one pinned, sqlite-only entry; pyx does
+ * pure structural retrieval with zero LLM / embedding on this path. Scope is
+ * `(tenantId, namespaceId)` + optional `project` — NOT per-user, because a
+ * correction about how to do X in this project is namespace-shared. No
+ * `confidence` field by design: ranking is overlap-then-recency only.
+ */
+interface CorrectionInput {
+    tenantId: string;
+    namespaceId: string;
+    /** What the agent did wrong (required free text). */
+    whatWasWrong: string;
+    /** The corrective instruction (required free text) — stored as `entry.content`. */
+    whatToDoInstead: string;
+    /** Applicability context the matcher scores task shapes against (required free text). */
+    appliesWhen: string;
+    /** Optional project scope — when set, the correction applies only to that project. */
+    project?: string;
+    /** Optional task-shape hint, stored for provenance; matching uses `appliesWhen`. */
+    taskShape?: string;
+    /** Optional agent id; defaults to the Memory instance's `agentId`. */
+    agentId?: string;
+}
+/** Input to `Memory.fetchApplicableCorrections`. */
+interface FetchCorrectionsInput {
+    tenantId: string;
+    namespaceId: string;
+    /** Shape of the task about to run — scored against each correction's `appliesWhen`. */
+    taskShape: string;
+    /** Optional project filter — keeps only project-matching or project-absent rows. */
+    project?: string;
+    /** Max corrections to return. Default 5, hard cap 5. */
+    limit?: number;
+}
+/** One applicable correction returned by `fetchApplicableCorrections`. */
+interface CorrectionRecord {
+    id: string;
+    whatWasWrong: string;
+    whatToDoInstead: string;
+    appliesWhen: string;
+    createdAt: string;
+    /** Overlap-coefficient score between the query `taskShape` and this row's `appliesWhen`. */
+    score: number;
+}
 interface MemoryStats {
     totalEntries: number;
     storageUsedBytes: number;
@@ -1093,4 +1165,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, DEPRECATED_RAG_STRATEGIES, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, 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, type Topology, type TopologyServiceVariant, VectorProvider, type WikiLintReport, mergeExtractedEntities };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, type CorrectionInput, type CorrectionRecord, DEFAULTS, DEPRECATED_RAG_STRATEGIES, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, 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, type Topology, type TopologyServiceVariant, VectorProvider, type WikiLintReport, mergeExtractedEntities };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   MemoryClient,
   MemoryServerError
-} from "./chunk-5X2HOMDQ.mjs";
+} from "./chunk-C5HKNVI5.mjs";
 import {
   DEFAULTS,
   DEPRECATED_RAG_STRATEGIES,

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-4BJCSQOO.mjs";
-import "./chunk-5X2HOMDQ.mjs";
+} from "./chunk-XPZ4DUON.mjs";
+import "./chunk-C5HKNVI5.mjs";
 import "./chunk-SSUYQJUI.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts

package/package.json

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