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

package/lib/types/client/api.d.ts

@@ -0,0 +1,13 @@
+import type { RuntimeMemoryImportance, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget } from '../contracts.ts';
+/** Source-owned structural page API; the default bundle may supply agent-assisted callbacks. */
+export interface RuntimePageClient {
+    runtimeMemory(): Promise<RuntimeMemorySnapshot>;
+    mutateRuntimeMemory(request: {
+        action: 'add' | 'replace' | 'remove';
+        target: RuntimeMemoryTarget;
+        content?: string;
+        old_text?: string;
+        importance?: RuntimeMemoryImportance;
+        branches?: string[];
+    }): Promise<RuntimeMemoryMutationResult>;
+}

package/lib/types/client/pages.d.ts

@@ -0,0 +1,8 @@
+import type { JSX } from 'react';
+import type { RuntimePageClient } from './api.ts';
+export declare function RuntimePage(props: {
+    client: RuntimePageClient;
+    revision: number;
+    writeEnabled: boolean;
+    onMutate: () => void;
+}): JSX.Element;

package/lib/types/client/ui.d.ts

@@ -0,0 +1,8 @@
+import { type ReactNode } from 'react';
+import { installMemorySourceUI, type MemorySourcePageProps, type MnemonSourceManagementClient, type MnemonTranslate } from 'dsh-mnemon/client';
+import type { RuntimePageClient } from './api.ts';
+export declare function runtimePageClient(management: MnemonSourceManagementClient): RuntimePageClient;
+export declare function RuntimeSourcePage(props: MemorySourcePageProps): ReactNode;
+export declare function installRuntimeMemoryUI(ctx: Parameters<typeof installMemorySourceUI>[0], t?: MnemonTranslate): () => void;
+export declare const inject: string[];
+export declare function apply(ctx: Parameters<typeof installMemorySourceUI>[0]): void;

package/lib/types/client.d.ts

@@ -0,0 +1,3 @@
+export * from './client/pages.tsx';
+export type * from './client/api.ts';
+export * from './client/ui.tsx';

package/lib/types/contracts.d.ts

@@ -0,0 +1,83 @@
+export type RuntimeMemoryTarget = 'memory' | 'user';
+export type RuntimeMemoryImportance = 'critical' | 'normal' | 'low';
+export type RuntimeMemoryAction = 'add' | 'replace' | 'remove';
+export 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[];
+}
+export interface RuntimeMemoryUsage {
+    used: number;
+    limit: number;
+}
+export interface RuntimeMemoryTargetView extends RuntimeMemoryUsage {
+    target: RuntimeMemoryTarget;
+    entryCount: number;
+    markdownPath: string;
+}
+export interface RuntimeMemorySnapshot {
+    directory: string;
+    sourcePath: string;
+    revision: string;
+    generatedAt: string;
+    entries: RuntimeMemoryEntry[];
+    targets: Record<RuntimeMemoryTarget, RuntimeMemoryTargetView>;
+}
+export interface RuntimeMemoryCompactedEntry {
+    content: string;
+    importance: RuntimeMemoryImportance;
+    /** Branch scope carried through compaction; absent means the entry is visible on every branch. */
+    branches?: string[];
+}
+export 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[];
+}
+export 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[];
+    };
+};
+export interface RuntimeMemoryMaintenancePlan {
+    revision: string;
+    action: RuntimeMemoryAction;
+    target: RuntimeMemoryTarget;
+    entries: RuntimeMemoryEntry[];
+    pending?: RuntimeMemoryCompactedEntry;
+    excluded?: RuntimeMemoryEntry;
+    used: number;
+    projected: number;
+    limit: number;
+    requiresMaintenance: boolean;
+}
+export declare const RUNTIME_MEMORY_VERSION = 1;
+export declare const RUNTIME_ENTRY_DELIMITER = "\n\u00A7\n";
+export interface RuntimeMemoryLimits {
+    readonly memory: number;
+    readonly user: number;
+}
+export declare const RUNTIME_MEMORY_LIMITS: RuntimeMemoryLimits;

package/lib/types/defaults.d.ts

@@ -0,0 +1,3 @@
+export declare const DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES: number;
+export declare const DEFAULT_RUNTIME_USER_LIMIT_BYTES: number;
+export declare const MAX_RUNTIME_MEMORY_LIMIT_BYTES: number;

package/package.json

@@ -0,0 +1,86 @@
+{
+  "name": "dsh-mnemon-source-runtime",
+  "version": "0.5.0-rc.1",
+  "description": "Self-contained runtime Source for Composable View Memory.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./package.json": "./package.json",
+    "./client": {
+      "types": "./lib/types/client.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./contracts": {
+      "types": "./lib/contracts.d.ts",
+      "default": "./lib/contracts.js"
+    }
+  },
+  "files": [
+    "lib",
+    "README.md"
+  ],
+  "dsh": {
+    "client": {
+      "inject": [
+        "slots"
+      ],
+      "platform": "web",
+      "external": [
+        "dsh-mnemon/client"
+      ]
+    }
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "build": "tsdown && tsc -p tsconfig.client-types.json",
+    "test": "vitest run",
+    "verify": "pnpm typecheck && pnpm test && pnpm build"
+  },
+  "dependencies": {
+    "schemastery": "^3.18.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "dsh-mnemon": "0.5.0-rc.1",
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-client-ui-primitives": "0.1.2-rc.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "dsh-mnemon": "0.5.0-rc.1",
+    "jsdom": "^26.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsdown": "^0.22.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "rc"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/omdsh-dev/dsh-mnemon.git",
+    "directory": "plugins/dsh-mnemon-source-runtime"
+  },
+  "homepage": "https://github.com/omdsh-dev/dsh-mnemon/tree/main/plugins/dsh-mnemon-source-runtime#readme",
+  "bugs": {
+    "url": "https://github.com/omdsh-dev/dsh-mnemon/issues"
+  }
+}