dsh-mnemon-source-runtime 0.5.0-rc.1

package/lib/contracts.d.ts

@@ -0,0 +1,86 @@
+//#region src/contracts.d.ts
+type RuntimeMemoryTarget = 'memory' | 'user';
+type RuntimeMemoryImportance = 'critical' | 'normal' | 'low';
+type RuntimeMemoryAction = 'add' | 'replace' | 'remove';
+interface RuntimeMemoryEntry {
+  content: string;
+  created_at: string;
+  updated_at: string;
+  target: RuntimeMemoryTarget;
+  importance: RuntimeMemoryImportance;
+  /** Optional git branch names that limit where this entry is projected. Absent means every branch. */
+  branches?: string[];
+}
+interface RuntimeMemoryUsage {
+  used: number;
+  limit: number;
+}
+interface RuntimeMemoryTargetView extends RuntimeMemoryUsage {
+  target: RuntimeMemoryTarget;
+  entryCount: number;
+  markdownPath: string;
+}
+interface RuntimeMemorySnapshot {
+  directory: string;
+  sourcePath: string;
+  revision: string;
+  generatedAt: string;
+  entries: RuntimeMemoryEntry[];
+  targets: Record<RuntimeMemoryTarget, RuntimeMemoryTargetView>;
+}
+interface RuntimeMemoryCompactedEntry {
+  content: string;
+  importance: RuntimeMemoryImportance;
+  /** Branch scope carried through compaction; absent means the entry is visible on every branch. */
+  branches?: string[];
+}
+interface RuntimeMemoryMutation {
+  action: RuntimeMemoryAction;
+  target: RuntimeMemoryTarget;
+  content?: string;
+  oldText?: string;
+  importance?: RuntimeMemoryImportance;
+  /** Git branch names limiting where a target=memory entry is projected. Absent keeps the current scope on replace; an empty list clears it. */
+  branches?: string[];
+}
+type RuntimeMemoryMutationResult = {
+  success: true;
+  message: string;
+  target: RuntimeMemoryTarget;
+  entryCount: number;
+  usage: RuntimeMemoryUsage;
+  added?: string;
+  replaced?: {
+    from: string;
+    to: string;
+  };
+  removed?: string;
+  maintenance?: {
+    kind: 'local-compaction' | 'mnemon-archive';
+    runId: string;
+    provider: string;
+    summary: string;
+    memoryBodyIds: string[];
+  };
+};
+interface RuntimeMemoryMaintenancePlan {
+  revision: string;
+  action: RuntimeMemoryAction;
+  target: RuntimeMemoryTarget;
+  entries: RuntimeMemoryEntry[];
+  pending?: RuntimeMemoryCompactedEntry;
+  excluded?: RuntimeMemoryEntry;
+  used: number;
+  projected: number;
+  limit: number;
+  requiresMaintenance: boolean;
+}
+declare const RUNTIME_MEMORY_VERSION = 1;
+declare const RUNTIME_ENTRY_DELIMITER = "\n§\n";
+interface RuntimeMemoryLimits {
+  readonly memory: number;
+  readonly user: number;
+}
+declare const RUNTIME_MEMORY_LIMITS: RuntimeMemoryLimits;
+//#endregion
+export { RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage };

package/lib/contracts.js

@@ -0,0 +1,2 @@
+import { n as RUNTIME_MEMORY_LIMITS, r as RUNTIME_MEMORY_VERSION, t as RUNTIME_ENTRY_DELIMITER } from "./contracts-BqaPCrGD.js";
+export { RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION };

package/lib/index.d.ts

@@ -0,0 +1,24 @@
+import { RUNTIME_ENTRY_DELIMITER, RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_VERSION, RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryImportance, RuntimeMemoryLimits, RuntimeMemoryMaintenancePlan, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage } from "./contracts.js";
+import z from "schemastery";
+import { MemorySourceDefinition } from "dsh-mnemon/contracts";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/config.d.ts
+interface Config {
+  dataDir?: string;
+  userDataDir?: string;
+  memoryLimitBytes?: number;
+  userLimitBytes?: number;
+}
+declare const Config: z<Config>;
+//#endregion
+//#region src/source.d.ts
+declare function createRuntimeMemorySource(config?: Config): MemorySourceDefinition;
+declare const RUNTIME_MEMORY_SOURCE: MemorySourceDefinition;
+//#endregion
+//#region src/index.d.ts
+declare const name = "dsh-mnemon-source-runtime";
+declare const inject: string[];
+declare const memoryPlugin: import("dsh-mnemon/extension-sdk").MemoryPluginDescriptor;
+declare function apply(ctx: Context, config?: Config): void;
+//#endregion
+export { Config, type RUNTIME_ENTRY_DELIMITER, type RUNTIME_MEMORY_LIMITS, RUNTIME_MEMORY_SOURCE, type RUNTIME_MEMORY_VERSION, type RuntimeMemoryAction, type RuntimeMemoryCompactedEntry, type RuntimeMemoryEntry, type RuntimeMemoryImportance, type RuntimeMemoryLimits, type RuntimeMemoryMaintenancePlan, type RuntimeMemoryMutation, type RuntimeMemoryMutationResult, type RuntimeMemorySnapshot, type RuntimeMemoryTarget, type RuntimeMemoryTargetView, type RuntimeMemoryUsage, apply, createRuntimeMemorySource, inject, memoryPlugin, name };