@remnic/core 9.3.518 → 9.3.520

package/dist/access-schema.d.ts

@@ -104,9 +104,9 @@ declare const recallRequestSchema: z.ZodObject<{
     includeLowConfidence: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     query: string;
+    namespace?: string | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
-    namespace?: string | undefined;
     topK?: number | undefined;
     mode?: "no_recall" | "minimal" | "full" | "graph_mode" | "auto" | undefined;
     cwd?: string | undefined;
@@ -125,9 +125,9 @@ declare const recallRequestSchema: z.ZodObject<{
     tagMatch?: "all" | "any" | undefined;
 }, {
     query: string;
+    namespace?: string | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
-    namespace?: string | undefined;
     topK?: number | undefined;
     mode?: "no_recall" | "minimal" | "full" | "graph_mode" | "auto" | undefined;
     cwd?: string | undefined;
@@ -149,11 +149,11 @@ declare const recallExplainRequestSchema: z.ZodObject<{
     sessionKey: z.ZodOptional<z.ZodString>;
     namespace: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
-}, {
     sessionKey?: string | undefined;
+}, {
     namespace?: string | undefined;
+    sessionKey?: string | undefined;
 }>;
 /**
  * Standalone "set coding context" request. Used by the HTTP endpoint
@@ -363,28 +363,28 @@ declare const memoryStoreRequestSchema: z.ZodObject<{
     sourceReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
     schemaVersion?: number | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
-    confidence?: number | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
     sourceReason?: string | undefined;
     idempotencyKey?: string | undefined;
 }, {
     content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
     schemaVersion?: number | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
-    confidence?: number | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
     sourceReason?: string | undefined;
     idempotencyKey?: string | undefined;
 }>;
@@ -403,28 +403,28 @@ declare const suggestionSubmitRequestSchema: z.ZodObject<{
     sourceReason: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
     schemaVersion?: number | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
-    confidence?: number | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
     sourceReason?: string | undefined;
     idempotencyKey?: string | undefined;
 }, {
     content: string;
+    namespace?: string | undefined;
+    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
+    confidence?: number | undefined;
+    ttl?: string | undefined;
     schemaVersion?: number | undefined;
     sessionKey?: string | undefined;
     tags?: string[] | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
-    category?: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace" | undefined;
-    confidence?: number | undefined;
     entityRef?: string | undefined;
-    ttl?: string | undefined;
     sourceReason?: string | undefined;
     idempotencyKey?: string | undefined;
 }>;
@@ -456,18 +456,18 @@ declare const trustZonePromoteRequestSchema: z.ZodObject<{
     recordId: string;
     targetZone: "working" | "trusted";
     promotionReason: string;
+    namespace?: string | undefined;
     recordedAt?: string | undefined;
     summary?: string | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
 }, {
     recordId: string;
     targetZone: "working" | "trusted";
     promotionReason: string;
+    namespace?: string | undefined;
     recordedAt?: string | undefined;
     summary?: string | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
 }>;
 declare const trustZoneDemoSeedRequestSchema: z.ZodObject<{
     scenario: z.ZodOptional<z.ZodString>;
@@ -475,14 +475,14 @@ declare const trustZoneDemoSeedRequestSchema: z.ZodObject<{
     dryRun: z.ZodOptional<z.ZodBoolean>;
     namespace: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
+    namespace?: string | undefined;
     recordedAt?: string | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
     scenario?: string | undefined;
 }, {
+    namespace?: string | undefined;
     recordedAt?: string | undefined;
     dryRun?: boolean | undefined;
-    namespace?: string | undefined;
     scenario?: string | undefined;
 }>;
 declare const lcmSearchRequestSchema: z.ZodObject<{
@@ -493,15 +493,15 @@ declare const lcmSearchRequestSchema: z.ZodObject<{
     limit: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     query: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     limit?: number | undefined;
+    sessionKey?: string | undefined;
     sessionPrefix?: string | undefined;
 }, {
     query: string;
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
     limit?: number | undefined;
+    sessionKey?: string | undefined;
     sessionPrefix?: string | undefined;
 }>;
 declare const lcmCompactionFlushRequestSchema: z.ZodObject<{
@@ -535,12 +535,12 @@ declare const daySummaryRequestSchema: z.ZodObject<{
     sessionKey: z.ZodOptional<z.ZodString>;
     namespace: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
+    sessionKey?: string | undefined;
     memories?: string | undefined;
 }, {
-    sessionKey?: string | undefined;
     namespace?: string | undefined;
+    sessionKey?: string | undefined;
     memories?: string | undefined;
 }>;
 declare const capsuleExportRequestSchema: z.ZodObject<{
@@ -730,11 +730,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         safety: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodEnum<["safe", "requires-review", "blocked"]>>>, NonNullable<"safe" | "requires-review" | "blocked"> | undefined, "safe" | "requires-review" | "blocked" | null | undefined>;
         safetyReasons: z.ZodEffects<z.ZodNullable<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>, string[] | undefined, string[] | null | undefined>;
     }, "strict", z.ZodTypeAny, {
+        confidence?: number | undefined;
         source?: string | undefined;
         stale?: boolean | undefined;
         created?: string | undefined;
         updated?: string | undefined;
-        confidence?: number | undefined;
         scope?: string | undefined;
         retrievalReason?: string | undefined;
         safety?: NonNullable<"safe" | "requires-review" | "blocked"> | undefined;
@@ -744,11 +744,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         safetyReasons?: string[] | undefined;
         userContextScopes?: string[] | undefined;
     }, {
+        confidence?: number | null | undefined;
         source?: string | null | undefined;
         stale?: boolean | null | undefined;
         created?: string | null | undefined;
         updated?: string | null | undefined;
-        confidence?: number | null | undefined;
         scope?: string | null | undefined;
         retrievalReason?: string | null | undefined;
         safety?: "safe" | "requires-review" | "blocked" | null | undefined;
@@ -758,11 +758,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         safetyReasons?: string[] | null | undefined;
         userContextScopes?: string[] | null | undefined;
     }>, "many">>>, {
+        confidence?: number | undefined;
         source?: string | undefined;
         stale?: boolean | undefined;
         created?: string | undefined;
         updated?: string | undefined;
-        confidence?: number | undefined;
         scope?: string | undefined;
         retrievalReason?: string | undefined;
         safety?: NonNullable<"safe" | "requires-review" | "blocked"> | undefined;
@@ -772,11 +772,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         safetyReasons?: string[] | undefined;
         userContextScopes?: string[] | undefined;
     }[] | undefined, {
+        confidence?: number | null | undefined;
         source?: string | null | undefined;
         stale?: boolean | null | undefined;
         created?: string | null | undefined;
         updated?: string | null | undefined;
-        confidence?: number | null | undefined;
         scope?: string | null | undefined;
         retrievalReason?: string | null | undefined;
         safety?: "safe" | "requires-review" | "blocked" | null | undefined;
@@ -798,11 +798,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         matched?: boolean | undefined;
     }[] | undefined;
     retrievedMemories?: {
+        confidence?: number | undefined;
         source?: string | undefined;
         stale?: boolean | undefined;
         created?: string | undefined;
         updated?: string | undefined;
-        confidence?: number | undefined;
         scope?: string | undefined;
         retrievalReason?: string | undefined;
         safety?: NonNullable<"safe" | "requires-review" | "blocked"> | undefined;
@@ -824,11 +824,11 @@ declare const actionConfidenceRequestSchema: z.ZodObject<{
         matched?: boolean | null | undefined;
     }[] | null | undefined;
     retrievedMemories?: {
+        confidence?: number | null | undefined;
         source?: string | null | undefined;
         stale?: boolean | null | undefined;
         created?: string | null | undefined;
         updated?: string | null | undefined;
-        confidence?: number | null | undefined;
         scope?: string | null | undefined;
         retrievalReason?: string | null | undefined;
         safety?: "safe" | "requires-review" | "blocked" | null | undefined;

package/dist/index.d.ts

@@ -924,6 +924,8 @@ interface BinaryAssetRecord {
     originalPath: string;
     /** Path (or URL) in the backend storage. */
     mirroredPath: string;
+    /** Optional user-resolvable target to write into markdown links. */
+    redirectPath?: string;
     /** SHA-256 hex digest of file content. */
     contentHash: string;
     /** File size in bytes. */
@@ -976,15 +978,23 @@ interface BinaryStorageBackend {
     exists(remotePath: string): Promise<boolean>;
     /** Delete a file from the backend. */
     delete(remotePath: string): Promise<void>;
+    /** Return the user-resolvable markdown target for a stored backend path. */
+    getRedirectTarget?(remotePath: string): string;
 }
 declare class FilesystemBackend implements BinaryStorageBackend {
     readonly type = "filesystem";
     private readonly basePath;
     constructor(basePath: string);
     private resolveRemotePath;
+    private isInsideBase;
+    private realBasePathIfExists;
+    private ensureBaseDirectory;
+    private ensureSafeParentDirectory;
+    private resolveExistingRemotePath;
     upload(localPath: string, remotePath: string): Promise<string>;
     exists(remotePath: string): Promise<boolean>;
     delete(remotePath: string): Promise<void>;
+    getRedirectTarget(remotePath: string): string;
 }
 declare class NoneBackend implements BinaryStorageBackend {
     readonly type = "none";
@@ -1026,7 +1036,8 @@ declare function manifestDir(memoryDir: string): string;
 declare function manifestPath(memoryDir: string): string;
 /**
  * Read the manifest from disk. Returns a fresh empty manifest if the file
- * does not exist or contains invalid JSON (CLAUDE.md #18).
+ * does not exist. Existing invalid manifests fail closed so the pipeline does
+ * not overwrite state needed for safe cleanup.
  */
 declare function readManifest(memoryDir: string): Promise<BinaryLifecycleManifest>;
 /**
@@ -1051,10 +1062,16 @@ interface PipelineLogger {
     warn(msg: string): void;
     error(msg: string): void;
 }
+type ReadMarkdownFile = (filePath: string) => Promise<string>;
+type WriteMarkdownFile = (filePath: string, content: string) => Promise<void>;
 interface PipelineOptions {
     dryRun?: boolean;
     /** Force-clean all files past grace period, ignoring redirect status. */
     forceClean?: boolean;
+    /** Test hook for deterministic markdown read failures. */
+    readMarkdownFile?: ReadMarkdownFile;
+    /** Test hook for deterministic markdown write failures. */
+    writeMarkdownFile?: WriteMarkdownFile;
 }
 /**
  * Run the binary lifecycle pipeline: scan, mirror, redirect, clean.