@klarkxy/dsh-memory 0.1.0

package/lib/contracts.d.ts

@@ -0,0 +1,122 @@
+import { AiFeatureScope, AiServices, AuxiliaryRequest, AuxiliaryResult, EvidenceRef, KnowledgeKind, KnowledgeScope, MemoryQuery, MemoryRecord, MemoryService, NewMemoryRecord, ProducerMessageSource, PurposeSpec, RpcResult, UsageReceipt, projectIdFromCwd as projectIdFromCwd$1 } from "@klarkxy/dsh-ai-services/contracts";
+//#region src/contracts.d.ts
+/** Frozen shared chat-events seat. Must stay equal to @klarkxy/dsh-ai-services CHAT_EVENTS_SLOT. */
+declare const CHAT_EVENTS_SLOT = "dsh-editor.chat.events";
+/** Shared untruncated cwd identity. Drive roots (`/` / `C:/`) stay intact. */
+declare const projectIdFromCwd: typeof projectIdFromCwd$1;
+declare const MEMORY_PLUGIN = "@klarkxy/dsh-memory";
+declare const MEMORY_SOURCE_KIND: "plugin:@klarkxy/dsh-memory";
+declare const MEMORY_RPC_CHANNEL = "/dsh-memory";
+declare const MEMORY_DREAM_PURPOSE = "memory.dream";
+declare const MEMORY_INJECTION_SECTION = "dsh-memory:recall";
+/** Frozen pluginName now accepts scoped ids. */
+declare const MEMORY_ACTIVATE_ID = "@klarkxy/dsh-memory";
+declare const DEFAULT_IDLE_MS: number;
+declare const MIN_IDLE_MS = 60000;
+declare const MAX_IDLE_MS: number;
+declare const DREAM_MIN_INTERVAL_MS: number;
+declare const DREAM_MIN_MATERIAL = 3;
+declare const MIN_RECALL_RECORDS = 1;
+declare const MAX_RECALL_RECORDS = 5;
+declare const MAX_RECALL_TOKENS = 800;
+declare const MAX_PROJECT_ID_CHARS = 32768;
+declare const INJECT_KINDS: readonly KnowledgeKind[];
+declare const RECALL_EXCLUDED_STATUSES: readonly MemoryRecord['status'][];
+interface MemorySettings {
+  revision: number;
+  injectEnabled: boolean;
+  dreamIdleEnabled: boolean;
+  idleMs: number;
+}
+declare const defaultSettings: () => MemorySettings;
+type DreamPlanStatus = 'preview' | 'applied' | 'cancelled' | 'stale' | 'failed' | 'noop';
+interface DreamSnapshotEntry {
+  id: string;
+  revision: number;
+  status: MemoryRecord['status'];
+  scope: KnowledgeScope;
+  expiresAt?: number;
+}
+interface DreamProposal {
+  title: string;
+  content: string;
+  kind: Exclude<KnowledgeKind, 'lesson'>;
+  tags: string[];
+  exceptions: string[];
+  evidence: EvidenceRef[];
+  sourceIds: string[];
+  scope: KnowledgeScope;
+}
+interface DreamPlan {
+  id: string;
+  revision: number;
+  sessionId: string;
+  projectId?: string;
+  status: DreamPlanStatus;
+  sourceVersion: string;
+  snapshot: DreamSnapshotEntry[];
+  proposals: DreamProposal[];
+  generation: number;
+  createdAt: number;
+  updatedAt: number;
+  error?: string;
+}
+interface MemoryTombstone {
+  id: string;
+  deletedAt: number;
+  lastRevision: number;
+}
+interface MemoryPersistedState {
+  settings: MemorySettings;
+  records: MemoryRecord[];
+  tombstones: MemoryTombstone[];
+  dreams: DreamPlan[];
+  lastAttemptAt?: number;
+}
+interface MemoryStatus {
+  runningDreams?: string[];
+  settings: MemorySettings;
+  records: MemoryRecord[];
+  dreams: DreamPlan[];
+  projectId?: string;
+  storageFailed: boolean;
+  aiAvailable: boolean;
+}
+/** Matches frozen MemoryService optional mutation identity/lifetime guards. */
+interface MemoryMutationOptions {
+  signal?: AbortSignal;
+  isCurrent?: () => boolean;
+}
+interface PreStepEnter {
+  kind: 'enter';
+  messages: unknown[];
+  startsRequestSeries?: true;
+}
+type PreStepDecision = {
+  kind: 'reject';
+} | PreStepEnter;
+interface InjectedMemoryMessage {
+  content: Array<{
+    type: 'text';
+    text: string;
+  }>;
+  source: ProducerMessageSource & {
+    kind: typeof MEMORY_SOURCE_KIND;
+    plugin: typeof MEMORY_PLUGIN;
+    form: 'snapshot';
+    sections: Array<{
+      name: string;
+      text: string;
+    }>;
+  };
+}
+declare function fail<T = never>(code: string, message: string): RpcResult<T>;
+declare function ok<T>(value: T): RpcResult<T>;
+declare function parseSessionId(payload: unknown): string | undefined;
+declare function sessionCwd(session: unknown): string | undefined;
+declare function scopesEqual(left: KnowledgeScope, right: KnowledgeScope): boolean;
+declare function scopeKey(scope: KnowledgeScope): string;
+declare function cloneRecord(record: MemoryRecord): MemoryRecord;
+//#endregion
+export { type AiFeatureScope, type AiServices, type AuxiliaryRequest, type AuxiliaryResult, CHAT_EVENTS_SLOT, DEFAULT_IDLE_MS, DREAM_MIN_INTERVAL_MS, DREAM_MIN_MATERIAL, DreamPlan, DreamPlanStatus, DreamProposal, DreamSnapshotEntry, type EvidenceRef, INJECT_KINDS, InjectedMemoryMessage, type KnowledgeKind, type KnowledgeScope, MAX_IDLE_MS, MAX_PROJECT_ID_CHARS, MAX_RECALL_RECORDS, MAX_RECALL_TOKENS, MEMORY_ACTIVATE_ID, MEMORY_DREAM_PURPOSE, MEMORY_INJECTION_SECTION, MEMORY_PLUGIN, MEMORY_RPC_CHANNEL, MEMORY_SOURCE_KIND, MIN_IDLE_MS, MIN_RECALL_RECORDS, MemoryMutationOptions, MemoryPersistedState, type MemoryQuery, type MemoryRecord, type MemoryService, MemorySettings, MemoryStatus, MemoryTombstone, type NewMemoryRecord, PreStepDecision, PreStepEnter, type ProducerMessageSource, type PurposeSpec, RECALL_EXCLUDED_STATUSES, type RpcResult, type UsageReceipt, cloneRecord, defaultSettings, fail, ok, parseSessionId, projectIdFromCwd, scopeKey, scopesEqual, sessionCwd };
+//# sourceMappingURL=contracts.d.ts.map

package/lib/contracts.js

@@ -0,0 +1,81 @@
+import { CHAT_EVENTS_SLOT as CHAT_EVENTS_SLOT$1, projectIdFromCwd as projectIdFromCwd$1 } from "@klarkxy/dsh-ai-services/contracts";
+//#region src/contracts.ts
+/** Browser-safe contracts. MemoryRecord / MemoryService match frozen @klarkxy/dsh-ai-services. */
+/** Frozen shared chat-events seat. Must stay equal to @klarkxy/dsh-ai-services CHAT_EVENTS_SLOT. */
+const CHAT_EVENTS_SLOT = CHAT_EVENTS_SLOT$1;
+/** Shared untruncated cwd identity. Drive roots (`/` / `C:/`) stay intact. */
+const projectIdFromCwd = projectIdFromCwd$1;
+const MEMORY_PLUGIN = "@klarkxy/dsh-memory";
+const MEMORY_SOURCE_KIND = "plugin:@klarkxy/dsh-memory";
+const MEMORY_RPC_CHANNEL = "/dsh-memory";
+const MEMORY_DREAM_PURPOSE = "memory.dream";
+const MEMORY_INJECTION_SECTION = "dsh-memory:recall";
+/** Frozen pluginName now accepts scoped ids. */
+const MEMORY_ACTIVATE_ID = MEMORY_PLUGIN;
+const DEFAULT_IDLE_MS = 9e5;
+const MIN_IDLE_MS = 6e4;
+const MAX_IDLE_MS = 108e5;
+const DREAM_MIN_INTERVAL_MS = 864e5;
+const DREAM_MIN_MATERIAL = 3;
+const MIN_RECALL_RECORDS = 1;
+const MAX_RECALL_RECORDS = 5;
+const MAX_RECALL_TOKENS = 800;
+const MAX_PROJECT_ID_CHARS = 32768;
+const INJECT_KINDS = [
+	"preference",
+	"project-fact",
+	"decision"
+];
+const RECALL_EXCLUDED_STATUSES = [
+	"candidate",
+	"rejected",
+	"revoked",
+	"deleted",
+	"superseded"
+];
+const defaultSettings = () => ({
+	revision: 0,
+	injectEnabled: true,
+	dreamIdleEnabled: true,
+	idleMs: DEFAULT_IDLE_MS
+});
+function fail(code, message) {
+	return {
+		ok: false,
+		error: {
+			code,
+			message
+		}
+	};
+}
+function ok(value) {
+	return {
+		ok: true,
+		value
+	};
+}
+function parseSessionId(payload) {
+	if (!payload || typeof payload !== "object" || Array.isArray(payload)) return void 0;
+	const sessionId = payload.sessionId;
+	return typeof sessionId === "string" && sessionId.length > 0 && sessionId.length <= 200 ? sessionId : void 0;
+}
+function sessionCwd(session) {
+	if (!session || typeof session !== "object") return void 0;
+	const row = session;
+	const cwd = row.meta?.cwd ?? row.header?.cwd;
+	return typeof cwd === "string" ? cwd : void 0;
+}
+function scopesEqual(left, right) {
+	if (left.kind === "global") return right.kind === "global";
+	return right.kind === "project" && left.projectId === right.projectId;
+}
+function scopeKey(scope) {
+	return scope.kind === "global" ? "global" : `project:${scope.projectId}`;
+}
+function cloneRecord(record) {
+	return structuredClone(record);
+}
+//#endregion
+export { CHAT_EVENTS_SLOT, DEFAULT_IDLE_MS, DREAM_MIN_INTERVAL_MS, DREAM_MIN_MATERIAL, INJECT_KINDS, MAX_IDLE_MS, MAX_PROJECT_ID_CHARS, MAX_RECALL_RECORDS, MAX_RECALL_TOKENS, MEMORY_ACTIVATE_ID, MEMORY_DREAM_PURPOSE, MEMORY_INJECTION_SECTION, MEMORY_PLUGIN, MEMORY_RPC_CHANNEL, MEMORY_SOURCE_KIND, MIN_IDLE_MS, MIN_RECALL_RECORDS, RECALL_EXCLUDED_STATUSES, cloneRecord, defaultSettings, fail, ok, parseSessionId, projectIdFromCwd, scopeKey, scopesEqual, sessionCwd };
+
+//# sourceMappingURL=contracts.js.map

package/lib/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","names":["FROZEN_CHAT_EVENTS_SLOT","frozenProjectIdFromCwd"],"sources":["../src/contracts.ts"],"sourcesContent":["/** Browser-safe contracts. MemoryRecord / MemoryService match frozen @klarkxy/dsh-ai-services. */\nimport {\n  CHAT_EVENTS_SLOT as FROZEN_CHAT_EVENTS_SLOT,\n  projectIdFromCwd as frozenProjectIdFromCwd,\n} from '@klarkxy/dsh-ai-services/contracts'\nimport type {\n  AiFeatureScope,\n  AiServices,\n  AuxiliaryRequest,\n  AuxiliaryResult,\n  EvidenceRef,\n  KnowledgeKind,\n  KnowledgeScope,\n  MemoryQuery,\n  MemoryRecord,\n  MemoryService,\n  NewMemoryRecord,\n  PurposeSpec,\n  ProducerMessageSource,\n  RpcResult,\n  UsageReceipt,\n} from '@klarkxy/dsh-ai-services/contracts'\n\nexport type {\n  AiFeatureScope,\n  AiServices,\n  AuxiliaryRequest,\n  AuxiliaryResult,\n  EvidenceRef,\n  KnowledgeKind,\n  KnowledgeScope,\n  MemoryQuery,\n  MemoryRecord,\n  MemoryService,\n  NewMemoryRecord,\n  PurposeSpec,\n  ProducerMessageSource,\n  RpcResult,\n  UsageReceipt,\n}\n\n/** Frozen shared chat-events seat. Must stay equal to @klarkxy/dsh-ai-services CHAT_EVENTS_SLOT. */\nexport const CHAT_EVENTS_SLOT = FROZEN_CHAT_EVENTS_SLOT\n/** Shared untruncated cwd identity. Drive roots (`/` / `C:/`) stay intact. */\nexport const projectIdFromCwd = frozenProjectIdFromCwd\nexport const MEMORY_PLUGIN = '@klarkxy/dsh-memory'\nexport const MEMORY_SOURCE_KIND = 'plugin:@klarkxy/dsh-memory' as const\nexport const MEMORY_RPC_CHANNEL = '/dsh-memory'\nexport const MEMORY_DREAM_PURPOSE = 'memory.dream'\nexport const MEMORY_INJECTION_SECTION = 'dsh-memory:recall'\n/** Frozen pluginName now accepts scoped ids. */\nexport const MEMORY_ACTIVATE_ID = MEMORY_PLUGIN\n\nexport const DEFAULT_IDLE_MS = 15 * 60 * 1000\nexport const MIN_IDLE_MS = 60_000\nexport const MAX_IDLE_MS = 180 * 60_000\nexport const DREAM_MIN_INTERVAL_MS = 24 * 60 * 60 * 1000\nexport const DREAM_MIN_MATERIAL = 3\nexport const MIN_RECALL_RECORDS = 1\nexport const MAX_RECALL_RECORDS = 5\nexport const MAX_RECALL_TOKENS = 800\nexport const MAX_PROJECT_ID_CHARS = 32_768\nexport const INJECT_KINDS: readonly KnowledgeKind[] = ['preference', 'project-fact', 'decision']\nexport const RECALL_EXCLUDED_STATUSES: readonly MemoryRecord['status'][] = [\n  'candidate', 'rejected', 'revoked', 'deleted', 'superseded',\n]\n\nexport interface MemorySettings {\n  revision: number\n  injectEnabled: boolean\n  dreamIdleEnabled: boolean\n  idleMs: number\n}\n\nexport const defaultSettings = (): MemorySettings => ({\n  revision: 0,\n  injectEnabled: true,\n  dreamIdleEnabled: true,\n  idleMs: DEFAULT_IDLE_MS,\n})\n\nexport type DreamPlanStatus = 'preview' | 'applied' | 'cancelled' | 'stale' | 'failed' | 'noop'\n\nexport interface DreamSnapshotEntry {\n  id: string\n  revision: number\n  status: MemoryRecord['status']\n  scope: KnowledgeScope\n  expiresAt?: number\n}\n\nexport interface DreamProposal {\n  title: string\n  content: string\n  kind: Exclude<KnowledgeKind, 'lesson'>\n  tags: string[]\n  exceptions: string[]\n  evidence: EvidenceRef[]\n  sourceIds: string[]\n  scope: KnowledgeScope\n}\n\nexport interface DreamPlan {\n  id: string\n  revision: number\n  sessionId: string\n  projectId?: string\n  status: DreamPlanStatus\n  sourceVersion: string\n  snapshot: DreamSnapshotEntry[]\n  proposals: DreamProposal[]\n  generation: number\n  createdAt: number\n  updatedAt: number\n  error?: string\n}\n\nexport interface MemoryTombstone {\n  id: string\n  deletedAt: number\n  lastRevision: number\n}\n\nexport interface MemoryPersistedState {\n  settings: MemorySettings\n  records: MemoryRecord[]\n  tombstones: MemoryTombstone[]\n  dreams: DreamPlan[]\n  lastAttemptAt?: number\n}\n\nexport interface MemoryStatus {\n  runningDreams?: string[]\n  settings: MemorySettings\n  records: MemoryRecord[]\n  dreams: DreamPlan[]\n  projectId?: string\n  storageFailed: boolean\n  aiAvailable: boolean\n}\n\n/** Matches frozen MemoryService optional mutation identity/lifetime guards. */\nexport interface MemoryMutationOptions { signal?: AbortSignal; isCurrent?: () => boolean }\n\nexport interface PreStepEnter {\n  kind: 'enter'\n  messages: unknown[]\n  startsRequestSeries?: true\n}\nexport type PreStepDecision = { kind: 'reject' } | PreStepEnter\n\nexport interface InjectedMemoryMessage {\n  content: Array<{ type: 'text'; text: string }>\n  source: ProducerMessageSource & {\n    kind: typeof MEMORY_SOURCE_KIND\n    plugin: typeof MEMORY_PLUGIN\n    form: 'snapshot'\n    sections: Array<{ name: string; text: string }>\n  }\n}\n\nexport function fail<T = never>(code: string, message: string): RpcResult<T> {\n  return { ok: false, error: { code, message } }\n}\n\nexport function ok<T>(value: T): RpcResult<T> {\n  return { ok: true, value }\n}\n\nexport function parseSessionId(payload: unknown): string | undefined {\n  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return undefined\n  const sessionId = (payload as { sessionId?: unknown }).sessionId\n  return typeof sessionId === 'string' && sessionId.length > 0 && sessionId.length <= 200 ? sessionId : undefined\n}\n\nexport function sessionCwd(session: unknown): string | undefined {\n  if (!session || typeof session !== 'object') return undefined\n  const row = session as { meta?: { cwd?: unknown }; header?: { cwd?: unknown } }\n  const cwd = row.meta?.cwd ?? row.header?.cwd\n  return typeof cwd === 'string' ? cwd : undefined\n}\n\nexport function scopesEqual(left: KnowledgeScope, right: KnowledgeScope): boolean {\n  if (left.kind === 'global') return right.kind === 'global'\n  return right.kind === 'project' && left.projectId === right.projectId\n}\n\nexport function scopeKey(scope: KnowledgeScope): string {\n  return scope.kind === 'global' ? 'global' : `project:${scope.projectId}`\n}\n\nexport function cloneRecord(record: MemoryRecord): MemoryRecord {\n  return structuredClone(record)\n}\n"],"mappings":";;;;AA0CA,MAAa,mBAAmBA;;AAEhC,MAAa,mBAAmBC;AAChC,MAAa,gBAAgB;AAC7B,MAAa,qBAAqB;AAClC,MAAa,qBAAqB;AAClC,MAAa,uBAAuB;AACpC,MAAa,2BAA2B;;AAExC,MAAa,qBAAqB;AAElC,MAAa,kBAAkB;AAC/B,MAAa,cAAc;AAC3B,MAAa,cAAc;AAC3B,MAAa,wBAAwB;AACrC,MAAa,qBAAqB;AAClC,MAAa,qBAAqB;AAClC,MAAa,qBAAqB;AAClC,MAAa,oBAAoB;AACjC,MAAa,uBAAuB;AACpC,MAAa,eAAyC;CAAC;CAAc;CAAgB;AAAU;AAC/F,MAAa,2BAA8D;CACzE;CAAa;CAAY;CAAW;CAAW;AACjD;AASA,MAAa,yBAAyC;CACpD,UAAU;CACV,eAAe;CACf,kBAAkB;CAClB,QAAQ;AACV;AAkFA,SAAgB,KAAgB,MAAc,SAA+B;CAC3E,OAAO;EAAE,IAAI;EAAO,OAAO;GAAE;GAAM;EAAQ;CAAE;AAC/C;AAEA,SAAgB,GAAM,OAAwB;CAC5C,OAAO;EAAE,IAAI;EAAM;CAAM;AAC3B;AAEA,SAAgB,eAAe,SAAsC;CACnE,IAAI,CAAC,WAAW,OAAO,YAAY,YAAY,MAAM,QAAQ,OAAO,GAAG,OAAO,KAAA;CAC9E,MAAM,YAAa,QAAoC;CACvD,OAAO,OAAO,cAAc,YAAY,UAAU,SAAS,KAAK,UAAU,UAAU,MAAM,YAAY,KAAA;AACxG;AAEA,SAAgB,WAAW,SAAsC;CAC/D,IAAI,CAAC,WAAW,OAAO,YAAY,UAAU,OAAO,KAAA;CACpD,MAAM,MAAM;CACZ,MAAM,MAAM,IAAI,MAAM,OAAO,IAAI,QAAQ;CACzC,OAAO,OAAO,QAAQ,WAAW,MAAM,KAAA;AACzC;AAEA,SAAgB,YAAY,MAAsB,OAAgC;CAChF,IAAI,KAAK,SAAS,UAAU,OAAO,MAAM,SAAS;CAClD,OAAO,MAAM,SAAS,aAAa,KAAK,cAAc,MAAM;AAC9D;AAEA,SAAgB,SAAS,OAA+B;CACtD,OAAO,MAAM,SAAS,WAAW,WAAW,WAAW,MAAM;AAC/D;AAEA,SAAgB,YAAY,QAAoC;CAC9D,OAAO,gBAAgB,MAAM;AAC/B"}

package/lib/index.d.ts

@@ -0,0 +1,110 @@
+import { AiFeatureScope, CHAT_EVENTS_SLOT, DreamPlan, InjectedMemoryMessage, MEMORY_RPC_CHANNEL, MemoryMutationOptions, MemoryPersistedState, MemoryQuery, MemoryRecord, MemoryService, MemorySettings, MemoryStatus, NewMemoryRecord, PreStepDecision, defaultSettings, projectIdFromCwd } from "./contracts.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/store.d.ts
+interface MemoryStore {
+  load(): MemoryPersistedState;
+  save(state: MemoryPersistedState): Promise<void>;
+}
+//#endregion
+//#region src/service.d.ts
+interface MemoryRuntimeOptions {
+  store: MemoryStore;
+  now?: () => number;
+  id?: () => string;
+  activateAi?: () => AiFeatureScope | undefined;
+  createInjectMessage?: (payload: InjectedMemoryMessage) => unknown;
+}
+declare class MemoryRuntime implements MemoryService {
+  private readonly options;
+  private live;
+  private generation;
+  private disposed;
+  private storageFailed;
+  private pending;
+  private ai?;
+  private unregisterPurpose?;
+  private readonly jobs;
+  private readonly now;
+  private readonly customId?;
+  constructor(options: MemoryRuntimeOptions);
+  get pluginActive(): boolean;
+  status(sessionId?: string, projectId?: string): MemoryStatus;
+  /** Wait for durable state writes, never for model generation. */
+  readStatus(sessionId?: string, projectId?: string): Promise<MemoryStatus>;
+  dispose(): Promise<void>;
+  updateSettings(next: Omit<MemorySettings, 'revision'>, expectedRevision: number): Promise<MemorySettings>;
+  list(query: MemoryQuery): Promise<MemoryRecord[]>;
+  recall(query: MemoryQuery): Promise<MemoryRecord[]>;
+  create(record: NewMemoryRecord, options?: MemoryMutationOptions): Promise<MemoryRecord>;
+  update(id: string, patch: Partial<Pick<MemoryRecord, 'title' | 'content' | 'tags' | 'exceptions' | 'status' | 'expiresAt'>>, expectedRevision: number, options?: MemoryMutationOptions): Promise<MemoryRecord>;
+  remove(id: string, expectedRevision: number, options?: MemoryMutationOptions): Promise<void>;
+  accept(id: string, expectedRevision: number): Promise<MemoryRecord>;
+  reject(id: string, expectedRevision: number): Promise<MemoryRecord>;
+  revoke(id: string, expectedRevision: number): Promise<MemoryRecord>;
+  promoteToGlobal(id: string, expectedRevision: number, options?: MemoryMutationOptions): Promise<MemoryRecord>;
+  handlePreStep(input: {
+    sessionId: string;
+    session?: unknown;
+    signal: AbortSignal;
+    next: () => Promise<PreStepDecision>;
+  }): Promise<PreStepDecision>;
+  previewDream(sessionId: string, projectId: string | undefined, trigger?: 'manual' | 'idle'): Promise<DreamPlan>;
+  runIdleDream(sessionId: string, projectId: string | undefined, trigger?: 'manual' | 'idle'): Promise<DreamPlan>;
+  get dreamLastAttemptAt(): number | undefined;
+  dreamMaterialCount(): number;
+  applyDream(planId: string, expectedRevision: number): Promise<DreamPlan>;
+  cancelDream(planId: string, expectedRevision: number): Promise<DreamPlan>;
+  createManualRecord(input: {
+    sessionId: string;
+    projectId?: string;
+    explicitGlobal: boolean;
+    title: string;
+    content: string;
+    kind: NewMemoryRecord['kind'];
+    tags?: string[];
+    exceptions?: string[];
+    evidence?: NewMemoryRecord['evidence'];
+    expiresAt?: number;
+  }): Promise<MemoryRecord>;
+  abortDreams(): void;
+  hasActiveDream(sessionId?: string): boolean;
+  private updateIn;
+  private mintId;
+  private idTaken;
+  private tombstoned;
+  private tombstonedIn;
+  private requireIn;
+  private requireDreamIn;
+  private markDream;
+  private currentDream;
+  private markDreamQuietly;
+  private stampDreamAttempt;
+  private recordFailedDreamAttempt;
+  private staleDreamsTouching;
+  private visibleInSession;
+  private canInject;
+  private isDreamCurrent;
+  private requireAi;
+  private syncAi;
+  private detachAi;
+  private assertOpen;
+  private snapshot;
+  private commit;
+  private assertMutationCurrent;
+  private persistProposed;
+  private serialize;
+}
+//#endregion
+//#region src/index.d.ts
+declare const name = "@klarkxy/dsh-memory";
+declare const inject: readonly ["storageDomain", "connection", "webServer", "aiServices", "sessions"];
+declare module '@deepseek-ai/cordis' {
+  interface Context {
+    aiMemory: MemoryRuntime;
+  }
+}
+declare function apply(ctx: Context): Promise<void>;
+declare function createPluginUserMessage(payload: InjectedMemoryMessage): unknown;
+//#endregion
+export { CHAT_EVENTS_SLOT, MEMORY_RPC_CHANNEL, MemoryRuntime, apply, createPluginUserMessage, defaultSettings, inject, name, projectIdFromCwd };
+//# sourceMappingURL=index.d.ts.map