dsh-mnemon 0.4.7 → 0.5.0

package/lib/types/src/sdk/index.d.ts

@@ -0,0 +1,9 @@
+export { installMemory } from './install.ts';
+export type { MnemonMemoryService, InstallMemoryOptions, MemoryInstallContribution } from './service.ts';
+export { defineMemoryPlugin, defineMemorySource, defineMemoryStrategy, defineMemoryStrategyExtension } from '../core/definitions.ts';
+export { record as memoryInputRecord, text as memoryInputText, integer as memoryInputInteger, stringArray as memoryInputStringArray, truncate as truncateMemoryText, receipt as createMemoryMutationReceipt, migrationLineage as memoryInputMigrationLineage } from './input.ts';
+export { memoryConfigurationDigest } from './input.ts';
+export { defineMemoryStrategyConfiguration } from './strategy-configuration.ts';
+export type { MemoryStrategyConfiguration, MemoryStrategyConfigurationField, MemoryLocalizedText } from './strategy-configuration.ts';
+export { withMemoryStorageLock } from './storage-lock.ts';
+export type { ComposableMemoryView, MemoryActionOffer, MemoryCompositionEvaluationReport, MemoryEvidence, MemoryMutationReceipt, MemoryPluginDescriptor, MemoryPluginLocalizedText, MemoryPluginProvidedCapability, MemoryPluginRole, MemoryMutationCompletion, MemoryReadGrant, MemorySourceDefinition, MemorySourceFacts, MemoryAvailableSource, MemorySourceManifest, MemorySourcePresentation, MemorySourcePresentationItem, MemorySourceRuntime, MemorySourceViewContext, MemoryStrategyDefinition, MemoryStrategyExtensionDefinition, MemoryStrategyExtensionManifest, MemoryStrategyContribution, MemoryStrategyTurn, MemoryStrategyReadRequest, MemoryStrategyRead, MemoryStrategyManifest, MemoryViewRequest, MemoryViewSourcePresentation, MemoryViewSpec, MemoryViewGuidance, } from "../core/contracts/index.ts";

package/lib/types/src/sdk/input.d.ts

@@ -0,0 +1,11 @@
+import type { MemoryJsonValue, MemoryMutationReceipt, MemoryMigrationLineage, MemoryMutationCompletion } from "../core/contracts/index.ts";
+/** Stable digest of validated configuration; raw values never enter diagnostics. */
+export declare function memoryConfigurationDigest(value: unknown): string;
+export declare function record(value: MemoryJsonValue, label: string): Record<string, MemoryJsonValue>;
+export declare function text(value: MemoryJsonValue | undefined, label: string, maximum: number, required?: boolean): string | undefined;
+export declare function integer(value: MemoryJsonValue | undefined, fallback: number, minimum: number, maximum: number): number;
+export declare function stringArray(value: MemoryJsonValue | undefined, label: string, maximum?: number): string[] | undefined;
+export declare function truncate(value: string, maximum: number): string;
+export declare function receipt(viewId: string, offerId: string, sourceInstanceKey: string, revision: string | undefined, details: MemoryJsonValue, completion?: MemoryMutationCompletion): MemoryMutationReceipt;
+/** Validate migration proof supplied by an authorized Source management caller. */
+export declare function migrationLineage(value: MemoryJsonValue | undefined): MemoryMigrationLineage[];

package/lib/types/src/sdk/install.d.ts

@@ -0,0 +1,7 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { InstallMemoryOptions, MemoryInstallContribution } from './service.ts';
+/**
+ * Register a plugin's Source and/or Strategy definitions as one Fiber-owned batch.
+ * Contribution roles do not dictate package or repository boundaries.
+ */
+export declare function installMemory(ctx: Context, contribution: MemoryInstallContribution, options?: InstallMemoryOptions): void;

package/lib/types/src/sdk/service.d.ts

@@ -0,0 +1,31 @@
+import type { MemoryPluginDescriptor, MemorySourceDefinition, MemoryStrategyDefinition, MemoryStrategyExtensionDefinition } from '../core/contracts/index.ts';
+export interface MemoryInstallContribution {
+    /** Optional peer-plugin identity and dependency metadata, available to Core. */
+    plugin?: MemoryPluginDescriptor;
+    /** One package may supply any contribution roles; installation/disposal is atomic. */
+    sources?: readonly MemorySourceDefinition[];
+    strategies?: readonly MemoryStrategyDefinition[];
+    strategyExtensions?: readonly MemoryStrategyExtensionDefinition[];
+}
+export interface InstallMemoryOptions {
+    /** Required for a direct ctx.plugin() mount that has no stable Loader Entry. */
+    instanceId?: string;
+    artifactDigest?: string;
+    /** Source-private dependency digest, opaque to Mnemon core. */
+    effectiveDigest?: string;
+}
+/**
+ * The only Mnemon-wide Cordis service: accept plugin definitions, not engine
+ * objects. Use installMemory(ctx, ...) to resolve the calling Entry identity
+ * and bind the returned registration disposer to its Fiber.
+ */
+export interface MnemonMemoryService {
+    installContributions(contribution: MemoryInstallContribution, options: InstallMemoryOptions & {
+        instanceId: string;
+    }): () => void;
+}
+declare module '@deepseek-ai/cordis' {
+    interface Context {
+        mnemonMemory: MnemonMemoryService;
+    }
+}

package/lib/types/src/sdk/storage-lock.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Serialize in-process work on one local storage root, including work from
+ * independently loaded plugins. File locks still own cross-process safety.
+ * Callers must not acquire the same root recursively.
+ */
+export declare function withMemoryStorageLock<T>(directory: string, operation: () => T | Promise<T>): Promise<T>;

package/lib/types/src/sdk/strategy-configuration.d.ts

@@ -0,0 +1,31 @@
+import type { MemoryInstallContribution } from './service.ts';
+import type { MemoryJsonValue, MemoryPluginLocalizedText } from '../core/contracts/index.ts';
+/** Human-facing metadata only. It is never added to a model View. */
+export type MemoryLocalizedText = MemoryPluginLocalizedText;
+export interface MemoryStrategyConfigurationField {
+    key: string;
+    label: MemoryLocalizedText;
+    description?: MemoryLocalizedText;
+    input: 'number' | 'text' | 'textarea' | 'string-list' | 'source-list';
+    defaultValue?: MemoryJsonValue;
+    minimum?: number;
+    maximum?: number;
+    sourceRoles?: string[];
+}
+/**
+ * Optional module export named `memoryStrategyConfiguration`.
+ * An installed, trusted Cordis Entry owns its fields and its pure factory.
+ * The Host may preview that factory, but mounting/disposal still belongs to
+ * Cordis. Configuration here must be public; credentials belong to Sources.
+ */
+export interface MemoryStrategyConfiguration {
+    apiVersion: 'dsh-mnemon/strategy-configuration/v1';
+    kind: 'strategy' | 'strategy-extension';
+    typeId: string;
+    label: MemoryLocalizedText;
+    description: MemoryLocalizedText;
+    fields: readonly MemoryStrategyConfigurationField[];
+    /** Same factory used by apply(); must not perform I/O or register a Fiber. */
+    create(config: Record<string, MemoryJsonValue>): MemoryInstallContribution;
+}
+export declare function defineMemoryStrategyConfiguration(value: Omit<MemoryStrategyConfiguration, 'apiVersion'>): MemoryStrategyConfiguration;

package/lib/types/src/sdk/testing.d.ts

@@ -0,0 +1,70 @@
+import { Context, type Plugin } from '@deepseek-ai/cordis';
+import { DEFAULT_MEMORY_VIEW_BUDGET } from '../core/contracts/index.ts';
+import type { ComposableMemoryView, MemoryActionOffer, MemoryCapability, MemoryCompositionEvaluationReport, MemoryEvidence, MemoryJsonValue, MemoryMutationReceipt, MemoryOperationScope, MemoryPackageProvenance, MemorySourceManagementCatalog, MemorySourceManagementRequest, MemorySourceManagementResult, MemorySourceManifest, MemoryViewRequest } from '../core/contracts/index.ts';
+export interface MemoryTestEntry<C> {
+    instanceId: string;
+    config?: C;
+}
+export interface MemoryTestTurn {
+    readonly view: ComposableMemoryView;
+    executeRoute(routeId: string, input: MemoryJsonValue, signal?: AbortSignal): Promise<MemoryEvidence>;
+    executeAction(offerId: string, input: MemoryJsonValue, authorize: (offer: MemoryActionOffer) => boolean | Promise<boolean>, signal?: AbortSignal): Promise<MemoryMutationReceipt>;
+    release(): void;
+}
+/** Read-only identity/manifest, never an installed definition or Source handle. */
+export interface MemoryTestSource {
+    readonly sourceInstanceKey: string;
+    readonly manifest: MemorySourceManifest;
+    readonly provenance: MemoryPackageProvenance;
+}
+export interface MemoryTestOptions {
+    strategyInstanceKey?: string;
+    strategyTypeId?: string;
+    sourceConfiguration?: (source: MemoryTestSource) => Readonly<Record<string, MemoryJsonValue>>;
+    sourceCapabilities?: (source: MemoryTestSource) => readonly MemoryCapability[];
+    now?: () => Date;
+    sourceTimeoutMs?: number;
+}
+/** JSON-only observations for composition/replacement tests, not engine access. */
+export interface MemoryTestDiagnostics {
+    servingGenerationId?: string;
+    drainingGenerationIds: string[];
+    evaluation: MemoryCompositionEvaluationReport;
+}
+export interface MemoryTestManagementClient {
+    readonly sourceInstanceKey: string;
+    readonly revision: string;
+    read(operation: string, input?: MemoryJsonValue): Promise<MemorySourceManagementResult>;
+    mutate(operation: string, input: MemoryJsonValue, options: {
+        confirmed: true;
+        expectedRevision?: string;
+    }): Promise<MemorySourceManagementResult>;
+}
+/**
+ * A test fixture, not a production service or a second Loader. It mounts real
+ * Cordis Fibers against the same Runtime/compiler used by the Host. The small
+ * Loader identity adapter supplies only stable Entry ids for installMemory.
+ * No built-in Source, Provider, database, browser, or private binding is needed.
+ */
+export declare class MemoryCompositionRunner {
+    #private;
+    readonly context: Context;
+    constructor(options?: MemoryTestOptions);
+    mount<C>(plugin: Plugin.Object<C>, entry: MemoryTestEntry<C>): Promise<() => Promise<void>>;
+    beginTurn(request?: Partial<MemoryViewRequest>, signal?: AbortSignal): Promise<MemoryTestTurn>;
+    inspect(): MemoryTestDiagnostics;
+    managementCatalog(scope?: MemoryOperationScope): Promise<MemorySourceManagementCatalog>;
+    /** Exercise the public protocol, including rejected confirmation/revision cases. */
+    executeManagement(request: MemorySourceManagementRequest): Promise<MemorySourceManagementResult>;
+    /** Same scoped management contract a Source page receives, backed by real generations. */
+    managementClient(sourceInstanceKey: string, scopeValue?: MemoryViewRequest['scope']): Promise<MemoryTestManagementClient>;
+    dispose(): Promise<void>;
+}
+export { DEFAULT_MEMORY_VIEW_BUDGET };
+/**
+ * Evaluate a trusted, already-built DSH Client artifact in a test. Dependencies
+ * are explicit (normally the test's React and UI primitives), so no production
+ * Loader, global registry, source alias, or second copy of React is required.
+ * This is a test fixture, not another Client Loader implementation.
+ */
+export declare function loadMemoryClientArtifact<T extends object = Record<string, unknown>>(path: string | URL, dependencies: Readonly<Record<string, unknown>>): T;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.4.7",
+  "version": "0.5.0",
   "description": "Composable three-tier memory control plane for DeepSeek Harness: persistent runtime context, searchable project documents, pluggable long-term memory, guarded strategies, WebUI, and headless tools.",
   "keywords": [
     "deepseek-harness",
@@ -44,7 +44,8 @@
   },
   "license": "MIT",
   "publishConfig": {
-    "access": "public"
+    "access": "public",
+    "tag": "latest"
   },
   "engines": {
     "node": ">=20"
@@ -52,50 +53,40 @@
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/types/src/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "contracts": [
+        "lib/types/src/core/contracts/index.d.ts"
+      ],
+      "extension-sdk": [
+        "lib/types/src/sdk/index.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
       "types": "./lib/types/src/index.d.ts",
       "default": "./lib/index.js"
     },
+    "./core": {
+      "types": "./lib/types/src/core/plugin.d.ts",
+      "default": "./lib/core.js"
+    },
     "./client": {
       "types": "./lib/types/src/client/index.d.ts",
       "default": "./lib/client.js"
     },
     "./contracts": {
-      "types": "./lib/types/packages/contracts/src/index.d.ts",
+      "types": "./lib/types/src/core/contracts/index.d.ts",
       "default": "./lib/contracts.js"
     },
-    "./kernel": {
-      "types": "./lib/types/packages/kernel/src/index.d.ts",
-      "default": "./lib/kernel.js"
-    },
     "./extension-sdk": {
-      "types": "./lib/types/packages/extension-sdk/src/index.d.ts",
+      "types": "./lib/types/src/sdk/index.d.ts",
       "default": "./lib/extension-sdk.js"
     },
-    "./provider-sdk": {
-      "types": "./lib/types/src/provider-sdk.d.ts",
-      "default": "./lib/provider-sdk.js"
-    },
-    "./strategy-sdk": {
-      "types": "./lib/types/packages/strategy-sdk/src/index.d.ts",
-      "default": "./lib/strategy-sdk.js"
-    },
-    "./strategy-default-three-tier": {
-      "types": "./lib/types/packages/strategy-default-three-tier/src/index.d.ts",
-      "default": "./lib/strategy-default-three-tier.js"
-    },
-    "./layers/runtime": {
-      "types": "./lib/types/packages/layer-runtime/src/index.d.ts",
-      "default": "./lib/layers/runtime.js"
-    },
-    "./layers/documents": {
-      "types": "./lib/types/packages/layer-documents/src/index.d.ts",
-      "default": "./lib/layers/documents.js"
-    },
-    "./layers/memory-spaces": {
-      "types": "./lib/types/packages/layer-memory-spaces/src/index.d.ts",
-      "default": "./lib/layers/memory-spaces.js"
+    "./testing": {
+      "types": "./lib/types/src/sdk/testing.d.ts",
+      "default": "./lib/testing.js"
     },
     "./package.json": "./package.json"
   },
@@ -124,7 +115,7 @@
     }
   },
   "scripts": {
-    "build": "tsdown && tsc -p tsconfig.types.json",
+    "build": "tsdown && tsc -p tsconfig.types.json && node scripts/link-bundle-declarations.mjs",
     "bundle": "tsdown",
     "prepublishOnly": "pnpm run verify",
     "lint:package": "publint --strict && attw --pack . --profile esm-only --quiet",
@@ -133,17 +124,36 @@
     "verify:build": "node scripts/verify-deterministic-build.mjs",
     "verify:headless": "node scripts/verify-headless-profile.mjs",
     "verify:package": "node scripts/verify-package-contents.mjs && node scripts/verify-public-entries.mjs && pnpm run lint:package",
-    "verify": "pnpm run typecheck && pnpm run test && pnpm run verify:build && pnpm run verify:headless && pnpm run verify:package",
+    "verify:plugins": "node scripts/verify-plugin-artifacts.mjs",
+    "e2e:serve": "node scripts/serve-e2e.mjs",
+    "verify": "pnpm run typecheck && pnpm run verify:build && pnpm --workspace-concurrency=1 -r build && pnpm -r typecheck && pnpm -r test && pnpm run test && pnpm run verify:headless && pnpm run verify:package",
     "dsh:link-source": "node scripts/link-dsh-source.mjs",
-    "dsh:restore-registry": "node scripts/link-dsh-source.mjs --restore"
+    "dsh:restore-registry": "node scripts/link-dsh-source.mjs --restore",
+    "release:check": "node scripts/release.mjs --check"
   },
   "dependencies": {
+    "dsh-mnemon-provider-byterover": "0.5.0",
+    "dsh-mnemon-provider-hindsight": "0.5.0",
+    "dsh-mnemon-provider-holographic": "0.5.0",
+    "dsh-mnemon-provider-honcho": "0.5.0",
+    "dsh-mnemon-provider-mem0": "0.5.0",
+    "dsh-mnemon-provider-mnemon-native": "0.5.0",
+    "dsh-mnemon-provider-openviking": "0.5.0",
+    "dsh-mnemon-provider-retaindb": "0.5.0",
+    "dsh-mnemon-provider-supermemory": "0.5.0",
+    "dsh-mnemon-source-documents": "0.5.0",
+    "dsh-mnemon-source-memory-spaces": "0.5.0",
+    "dsh-mnemon-source-runtime": "0.5.0",
+    "dsh-mnemon-strategy-auto-capture": "0.5.0",
+    "dsh-mnemon-strategy-default-three-tier": "0.5.0",
+    "dsh-mnemon-strategy-light-context": "0.5.0",
+    "dsh-mnemon-strategy-scoped": "0.5.0",
     "fflate": "^0.8.3",
-    "markdown-to-jsx": "^7.7.17",
     "schemastery": "^3.18.0",
     "zod": "^4.4.3"
   },
   "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
     "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-rc.1 || ^0.1.2-alpha.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
@@ -158,6 +168,7 @@
     "@deepseek-ai/dsh-client-locale": "0.1.2-rc.1",
     "@deepseek-ai/dsh-client-store": "0.1.2-rc.1",
     "@deepseek-ai/dsh-client-ui-conversation": "0.1.2-rc.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.1.2-rc.1",
     "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
     "@deepseek-ai/dsh-client-ui-renderer": "0.1.2-rc.1",
     "@deepseek-ai/dsh-client-ui-settings": "0.1.2-rc.1",