dsh-mnemon 0.3.3 → 0.3.5

package/lib/types/src/client/MnemonTurnTail.d.ts

@@ -1,5 +1,4 @@
 import type { ClientConnectionHandle } from '../shared/contracts.ts';
-import type { TurnTailOwnerProps } from '@deepseek-ai/dsh-client-ui-conversation/client';
 import { type MnemonAnchorPage } from './anchor.ts';
 import type { MnemonKey } from './locales.ts';
 export interface MnemonTurnTailProps {
@@ -15,6 +14,8 @@ export interface MnemonTurnTailProps {
 /** Route a settled tool name to the workbench page that explains its effect. */
 export declare function memoryPageForTool(name: string): MnemonAnchorPage;
 /** Whether this entry renders for the owner; chain selectors decline quietly. */
-export declare function selectMnemonTurnTail(owner: TurnTailOwnerProps): Record<string, never> | null;
+export declare function selectMnemonTurnTail(owner: {
+    turn: unknown;
+}): Record<string, never> | null;
 /** One-line memory-activity bar under a completed turn; hides when the turn touched no memory. */
 export declare const MnemonTurnTail: import("react").NamedExoticComponent<MnemonTurnTailProps>;

package/lib/types/src/client/MnemonView.d.ts

@@ -9,7 +9,7 @@ export interface MnemonViewProps {
     workspaceSelection?: MnemonWorkspaceSelection;
     surface?: MnemonViewSurface;
     t?: MnemonTranslate;
-    locale?: 'zh' | 'en';
+    locale?: string;
     onClose?: () => void;
 }
 export interface MnemonWorkspaceSelection {

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

@@ -36,6 +36,7 @@ export declare class MnemonClient {
         content?: string;
         old_text?: string;
         importance?: RuntimeMemoryImportance;
+        branches?: string[];
     }): Promise<RuntimeMemoryMutationResult>;
     documents(): Promise<DocumentSnapshot>;
     document(id: string): Promise<DocumentView>;

package/lib/types/src/client/dsh-compat.d.ts

@@ -6,15 +6,46 @@
  */
 import type { ConnectionHandle } from '@deepseek-ai/dsh-client-connection/client';
 import type { LocaleRuntime } from '@deepseek-ai/dsh-client-locale/client';
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import type { Context } from '@deepseek-ai/cordis';
 import type { MnemonKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
         mnemon: MnemonKey;
     }
 }
-/** DSH 0.1.1-rc.2 client context plus the two injected feature services. */
-export type MnemonClientContext = ClientContext & {
+export interface MnemonSessionSummary {
+    cwd?: string;
+    origin?: string;
+    projectionValues?: Readonly<Record<string, unknown>>;
+    [key: string]: unknown;
+}
+export interface MnemonSessionListState {
+    current?: string;
+    byId: Record<string, MnemonSessionSummary>;
+    [key: string]: unknown;
+}
+export interface MnemonWorkspaceSummary {
+    workspaceId: unknown;
+    title: string;
+    path: string;
+}
+export interface MnemonWorkspaceListState {
+    items: MnemonWorkspaceSummary[];
+    [key: string]: unknown;
+}
+interface SnapshotStore<State> {
+    getSnapshot(): State;
+    subscribe(listener: () => void): () => void;
+}
+/** Context shared by the released client runtime and the 0.1.2 controller split. */
+export type MnemonClientContext = Context & {
     connection: ConnectionHandle;
     locale: LocaleRuntime;
+    sessions: {
+        list: SnapshotStore<MnemonSessionListState>;
+    };
+    workspaces: {
+        list: SnapshotStore<MnemonWorkspaceListState>;
+    };
 };
+export {};

package/lib/types/src/client/locales.d.ts

@@ -333,6 +333,10 @@ export declare const zh: {
     'runtime.importance.critical': string;
     'runtime.importance.normal': string;
     'runtime.importance.low': string;
+    'runtime.branches': string;
+    'runtime.branchesPlaceholder': string;
+    'runtime.branchesHint': string;
+    'runtime.branchBadge': string;
     'runtime.empty': string;
     'runtime.editContent': string;
     'runtime.editAction': string;
@@ -706,6 +710,13 @@ export declare const zh: {
     'config.customHintShort': string;
     'config.customSelected': string;
     'config.globalScopeHint': string;
+    'config.runtimeUserScopeTitle': string;
+    'config.runtimeUserScopeDescription': string;
+    'config.runtimeUserScopeAria': string;
+    'config.runtimeUserScopeStorage': string;
+    'config.runtimeUserScopeStorageHint': string;
+    'config.runtimeUserScopeGlobal': string;
+    'config.runtimeUserScopeGlobalHint': string;
     'config.topologyTitle': string;
     'config.topologyDescription': string;
     'config.topologyLoading': string;
@@ -826,6 +837,7 @@ export declare const zh: {
     'config.customDirectoryHint': string;
     'config.customPlaceholder': string;
     'config.invalidScope': string;
+    'config.invalidRuntimeUserScope': string;
     'config.customRequired': string;
     'config.customAbsolute': string;
     'config.saveFailed': string;
@@ -1228,6 +1240,10 @@ export declare const en: {
     'runtime.importance.critical': string;
     'runtime.importance.normal': string;
     'runtime.importance.low': string;
+    'runtime.branches': string;
+    'runtime.branchesPlaceholder': string;
+    'runtime.branchesHint': string;
+    'runtime.branchBadge': string;
     'runtime.empty': string;
     'runtime.editContent': string;
     'runtime.editAction': string;
@@ -1601,6 +1617,13 @@ export declare const en: {
     'config.customHintShort': string;
     'config.customSelected': string;
     'config.globalScopeHint': string;
+    'config.runtimeUserScopeTitle': string;
+    'config.runtimeUserScopeDescription': string;
+    'config.runtimeUserScopeAria': string;
+    'config.runtimeUserScopeStorage': string;
+    'config.runtimeUserScopeStorageHint': string;
+    'config.runtimeUserScopeGlobal': string;
+    'config.runtimeUserScopeGlobalHint': string;
     'config.topologyTitle': string;
     'config.topologyDescription': string;
     'config.topologyLoading': string;
@@ -1721,6 +1744,7 @@ export declare const en: {
     'config.customDirectoryHint': string;
     'config.customPlaceholder': string;
     'config.invalidScope': string;
+    'config.invalidRuntimeUserScope': string;
     'config.customRequired': string;
     'config.customAbsolute': string;
     'config.saveFailed': string;

package/lib/types/src/client/subagent-token-usage.d.ts

@@ -1,6 +1,5 @@
-import type { SessionListState } from '@deepseek-ai/dsh-client-runtime/client';
 import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
-import type { MnemonClientContext } from './dsh-compat.ts';
+import type { MnemonClientContext, MnemonSessionListState } from './dsh-compat.ts';
 export declare const MNEMON_SUBAGENT_TOKEN_USAGE_KEY = "mnemonSubagentTokenUsage";
 export interface MnemonTokenUsageProjection {
     uncachedInputTokens: number;
@@ -13,9 +12,9 @@ export interface MnemonTokenUsageProjection {
  * released official catalog component. All other consumers continue seeing
  * DSH's complete-log `tokenUsage` value.
  */
-export declare function scopeSubagentTokenUsage(state: SessionListState): SessionListState;
+export declare function scopeSubagentTokenUsage(state: MnemonSessionListState): MnemonSessionListState;
 /** Wrap the framework hook while preserving its selector/equality contract. */
-export declare function createScopedUseSessions(useSessions: SnapshotSelectorHook<SessionListState>): SnapshotSelectorHook<SessionListState>;
+export declare function createScopedUseSessions(useSessions: SnapshotSelectorHook<MnemonSessionListState>): SnapshotSelectorHook<MnemonSessionListState>;
 /**
  * Shadow the released official single-slot entry at a lower priority. The
  * component and action factory are captured from the public slot ledger, so

package/lib/types/src/config-values.d.ts

@@ -7,4 +7,9 @@ export declare const DEFAULT_RECALL_HIGH_SCORE_THRESHOLD = 0.6;
 export declare const DEFAULT_RECALL_CANDIDATE_MULTIPLIER = 3;
 export declare const DEFAULT_RECALL_MAX_MEDIUM_RESULTS = 4;
 export declare const DEFAULT_RECALL_MAX_UNKNOWN_RESULTS = 2;
+export declare const DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES: number;
+export declare const DEFAULT_RUNTIME_USER_LIMIT_BYTES: number;
+export declare const DEFAULT_RUNTIME_MAINTENANCE_MAX_TOKENS = 8192;
+export declare const MAX_RUNTIME_MEMORY_LIMIT_BYTES: number;
+export declare const MAX_RUNTIME_MAINTENANCE_MAX_TOKENS = 1000000;
 export { DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL } from './shared/contracts.ts';

package/lib/types/src/config.d.ts

@@ -1,6 +1,6 @@
 import z from 'schemastery';
 import type { Config as SharedConfig, CustomPackConfig as SharedCustomPackConfig, InteractionConfig as SharedInteractionConfig, ResolvedConfig as SharedResolvedConfig, ResolvedInteractionConfig as SharedResolvedInteractionConfig } from './shared/contracts.ts';
-export { DEFAULT_IDLE_REVIEW_MS, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_RECALL_CANDIDATE_MULTIPLIER, DEFAULT_RECALL_HIGH_SCORE_THRESHOLD, DEFAULT_RECALL_LIMIT, DEFAULT_RECALL_LOW_SCORE_THRESHOLD, DEFAULT_RECALL_MAX_MEDIUM_RESULTS, DEFAULT_RECALL_MAX_UNKNOWN_RESULTS, DEFAULT_RECALL_QUALITY_POLICY, DEFAULT_TIMEOUT_MS, } from './config-values.ts';
+export { DEFAULT_IDLE_REVIEW_MS, DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_RECALL_CANDIDATE_MULTIPLIER, DEFAULT_RECALL_HIGH_SCORE_THRESHOLD, DEFAULT_RECALL_LIMIT, DEFAULT_RECALL_LOW_SCORE_THRESHOLD, DEFAULT_RECALL_MAX_MEDIUM_RESULTS, DEFAULT_RECALL_MAX_UNKNOWN_RESULTS, DEFAULT_RECALL_QUALITY_POLICY, DEFAULT_RUNTIME_MAINTENANCE_MAX_TOKENS, DEFAULT_RUNTIME_MEMORY_LIMIT_BYTES, DEFAULT_RUNTIME_USER_LIMIT_BYTES, DEFAULT_TIMEOUT_MS, MAX_RUNTIME_MAINTENANCE_MAX_TOKENS, MAX_RUNTIME_MEMORY_LIMIT_BYTES, } from './config-values.ts';
 export type Config = SharedConfig;
 export type CustomPackConfig = SharedCustomPackConfig;
 export type InteractionConfig = SharedInteractionConfig;

package/lib/types/src/contracts.d.ts

@@ -1,12 +1,18 @@
 import type { RpcResult, SettingsOperation } from './shared/contracts.ts';
 export type { ClientConnectionHandle, ClientSettingsScope, ClientSettingsSnapshot, JsonPrimitive, JsonValue, RpcError, RpcResult, SettingsOperation, } from './shared/contracts.ts';
-export type HostRpcHandler = (endpoint: string, payload: unknown) => Promise<RpcResult<unknown>>;
+export type HostRpcHandler = (endpoint: string, payload: unknown, signal?: AbortSignal) => Promise<RpcResult<unknown>>;
 export type HostRpcAuthority = 'trusted-host' | 'loopback';
+/**
+ * DSH rc.2 requires this registration policy. DSH 0.1.2-alpha.1 accepts only
+ * the first two JavaScript arguments and safely ignores this trailing value.
+ * Keeping one unconditional call shape avoids runtime version detection.
+ */
+export interface HostRpcRegistrationOptions {
+    readonly authority: HostRpcAuthority;
+}
 export interface HostConnectionHandle {
     rpc: {
-        handle(channel: string, handler: HostRpcHandler, options: {
-            authority: HostRpcAuthority;
-        }): unknown;
+        handle(channel: string, handler: HostRpcHandler, options: HostRpcRegistrationOptions): unknown;
     };
 }
 export interface HostSettingsScope<T> {
@@ -151,6 +157,14 @@ export interface HostAgent {
             agentPreset?: string;
         };
         events: readonly HostSessionEvent[];
+        /**
+         * Model-visible event sequences, in order. Optional because not every host
+         * publishes a surface projection; when absent, callers fall back to
+         * session-scoped state.
+         */
+        surface?: {
+            readonly nodes: readonly number[];
+        };
     };
     ctx: HostAgentContext;
     followup(message: HostUserMessage): void;

package/lib/types/src/git-branch.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Resolve the current git branch of a workspace root. Returns undefined when
+ * the directory is not a git working tree, HEAD is detached, or the probe
+ * fails or times out, so callers fall back to the unfiltered view.
+ */
+export declare function resolveGitBranch(cwd?: string): string | undefined;

package/lib/types/src/memory-view.d.ts

@@ -1,4 +1,4 @@
-import { MemoryTurnViewManager } from '../packages/kernel/src/index.ts';
+import { MemoryTurnViewManager, type MemorySource } from '../packages/kernel/src/index.ts';
 import type { DocumentManager } from './documents.ts';
 import type { MemoryKernel } from './memory-system/kernel.ts';
 import type { RuntimeMemoryController } from './runtime-memory.ts';
@@ -10,6 +10,12 @@ export interface DefaultMemorySources {
 }
 /** Compatibility name for the v0.3 pre-release API. */
 export type DefaultMemoryViewSources = DefaultMemorySources;
-export declare function createDefaultMemoryTurnViewManager(kernel: MemoryKernel, sources: DefaultMemorySources): MemoryTurnViewManager;
+export type BranchResolver = (cwd?: string) => string | undefined;
+export interface DefaultMemoryTurnViewManagerOptions {
+    /** Override the git branch probe used for runtime branch scoping. Defaults to resolveGitBranch. */
+    resolveBranch?: BranchResolver;
+}
+export declare function createRuntimeMemorySource(runtimeMemory: RuntimeMemoryController, resolveBranch?: BranchResolver): MemorySource;
+export declare function createDefaultMemoryTurnViewManager(kernel: MemoryKernel, sources: DefaultMemorySources, options?: DefaultMemoryTurnViewManagerOptions): MemoryTurnViewManager;
 /** Compatibility name for the v0.3 pre-release API. */
 export declare const createDefaultMemoryViewManager: typeof createDefaultMemoryTurnViewManager;

package/lib/types/src/pack.d.ts

@@ -14,7 +14,8 @@ export declare class MnemonPackManager {
     private readonly afterImport;
     private readonly now;
     private readonly root;
-    constructor(runner: MnemonRunner, config: Pick<ResolvedConfig, 'storageScope'>, afterImport?: (components: MnemonPackComponent[]) => void, now?: () => Date);
+    private readonly runtimeLimits;
+    constructor(runner: MnemonRunner, config: Pick<ResolvedConfig, 'storageScope' | 'runtimeMemory'>, afterImport?: (components: MnemonPackComponent[]) => void, now?: () => Date);
     target(): {
         root: string;
         scope: ResolvedConfig['storageScope'];

package/lib/types/src/rpc.d.ts

@@ -9,14 +9,14 @@ import { VersionUpdateManager } from './version-updates.ts';
 export { MNEMON_ACTIVATION_CHANNEL, MNEMON_PACK_CHANNEL, MNEMON_READ_CHANNEL, MNEMON_WRITE_CHANNEL } from './channels.ts';
 type RuntimeInput = MnemonService | LiveMnemonRuntime;
 export declare function createReadHandler(input: RuntimeInput, lifecycle?: MnemonLifecycle, runtimeMemory?: RuntimeMemoryController, storage?: StorageScopeInspector, versions?: VersionUpdateManager): HostRpcHandler;
-/**
- * Expose only DSH read-routing activation to trusted Web hosts. Metadata,
- * provider connections, credentials, and durable memory writes stay on the
- * loopback-only write channel.
- */
+/** Keep activation on a narrow, independently validated control endpoint. */
 export declare function createActivationHandler(input: RuntimeInput): HostRpcHandler;
 export declare function createWriteHandler(input: RuntimeInput, lifecycle?: MnemonLifecycle, runtimeMemory?: RuntimeMemoryController, versions?: VersionUpdateManager): HostRpcHandler;
-/** Backup payloads contain private memory and use the deployment's management authority. */
+/** Backup payloads contain private memory and stay behind DSH browser authentication. */
 export declare function createPackHandler(input: MnemonPackManager | LiveMnemonRuntime, writeEnabled?: boolean | (() => boolean)): HostRpcHandler;
-/** Reads and activation use trusted hosts; other privileged channels require explicit promotion. */
+/**
+ * Register one call shape across DSH rc.2 and 0.1.2-alpha.1. The former
+ * enforces channel authority; the latter ignores the trailing options object
+ * after applying its uniform browser-session authentication boundary.
+ */
 export declare function registerRpc(connection: HostConnectionHandle, input: RuntimeInput, lifecycle?: MnemonLifecycle, runtimeMemory?: RuntimeMemoryController, storage?: StorageScopeInspector, packs?: MnemonPackManager, versions?: VersionUpdateManager, managementAuthority?: HostRpcAuthority): void;

package/lib/types/src/runtime-memory.d.ts

@@ -5,10 +5,11 @@ import type { RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEnt
 export type { RuntimeMemoryAction, RuntimeMemoryCompactedEntry, RuntimeMemoryEntry, RuntimeMemoryImportance, RuntimeMemoryMutation, RuntimeMemoryMutationResult, RuntimeMemorySnapshot, RuntimeMemoryTarget, RuntimeMemoryTargetView, RuntimeMemoryUsage, } from './shared/contracts.ts';
 export declare const RUNTIME_MEMORY_VERSION = 1;
 export declare const RUNTIME_ENTRY_DELIMITER = "\n\u00A7\n";
-export declare const RUNTIME_MEMORY_LIMITS: {
+export interface RuntimeMemoryLimits {
     readonly memory: number;
     readonly user: number;
-};
+}
+export declare const RUNTIME_MEMORY_LIMITS: RuntimeMemoryLimits;
 export declare const RUNTIME_MEMORY_PROTOCOL: string;
 export interface RuntimeMemoryContextProjection {
     revision: string;
@@ -37,6 +38,10 @@ export declare class RuntimeMemoryCapacityError extends Error {
 export declare class RuntimeMemoryConflictError extends Error {
     constructor();
 }
+export declare const RUNTIME_BRANCH_NAME_MAX = 128;
+export declare const RUNTIME_BRANCHES_PER_ENTRY_MAX = 16;
+/** Validate a model-supplied branch scope. Returns the normalized list; an empty list means "no scope". */
+export declare function normalizeRuntimeBranches(value: unknown, field?: string): string[];
 /**
  * Single authority for hot memory. JSON is the durable source of truth;
  * Markdown files are deterministic projections consumed by prompt assembly.
@@ -46,15 +51,26 @@ export declare class RuntimeMemoryController {
     private readonly recordCommit?;
     readonly directory: string;
     readonly sourcePath: string;
+    readonly userSourcePath: string;
     readonly memoryPath: string;
     readonly userPath: string;
     readonly lockPath: string;
+    readonly limits: RuntimeMemoryLimits;
     private queue;
-    constructor(runner: Pick<MnemonRunner, 'effectiveDataDir'>, now?: () => Date, recordCommit?: AuthorityCommitRecorder | undefined);
+    private readonly localUserPath;
+    private readonly userController;
+    constructor(runner: Pick<MnemonRunner, 'effectiveDataDir'>, now?: () => Date, recordCommit?: AuthorityCommitRecorder | undefined, limits?: RuntimeMemoryLimits, userRunner?: Pick<MnemonRunner, 'effectiveDataDir'>);
     snapshot(): RuntimeMemorySnapshot;
-    contextText(): string;
-    /** Read the exact Runtime revision and its prompt projection under one lock. */
-    contextProjection(): RuntimeMemoryContextProjection;
+    contextText(branch?: string): string;
+    /**
+     * Read the exact Runtime revision and its prompt projection from each
+     * configured authority root.
+     * When a git branch is supplied, target=memory entries scoped to other
+     * branches are hidden from the projection; the on-disk Markdown files and
+     * the source JSON always remain complete.
+     */
+    contextProjection(branch?: string): RuntimeMemoryContextProjection;
+    private localContextProjection;
     mutate(request: RuntimeMemoryMutation): Promise<RuntimeMemoryMutationResult>;
     /** Resolve exactly which committed entries survive a blocked mutation and are safe to compact. */
     planMaintenance(request: RuntimeMemoryMutation): Promise<RuntimeMemoryMaintenancePlan>;

package/lib/types/src/shared/contracts.d.ts

@@ -104,6 +104,19 @@ export interface RecallQualityConfig {
     /** Maximum unknown-scale or unscored rows admitted by the strict policy. */
     maxUnknownResults?: number;
 }
+export interface RuntimeMemoryConfig {
+    /** Maximum UTF-8 bytes projected into MEMORY.md. */
+    memoryLimitBytes?: number;
+    /** Maximum UTF-8 bytes projected into USER.md. */
+    userLimitBytes?: number;
+    /** Completion-token budget for Runtime migration and compaction workers. */
+    maintenanceMaxTokens?: number;
+}
+export interface ResolvedRuntimeMemoryConfig {
+    memoryLimitBytes: number;
+    userLimitBytes: number;
+    maintenanceMaxTokens: number;
+}
 export interface ResolvedRecallQualityConfig {
     policy: string;
     lowScoreThreshold: number;
@@ -114,6 +127,8 @@ export interface ResolvedRecallQualityConfig {
 }
 export interface Config {
     storageScope?: StorageScopeKind;
+    /** Whether USER.md follows the selected storage root or stays in the global root. */
+    runtimeUserScope?: 'storage' | 'global';
     cliPath?: string;
     dataDir?: string;
     customPackId?: string;
@@ -121,6 +136,7 @@ export interface Config {
     store?: string;
     timeoutMs?: number;
     defaultRecallLimit?: number;
+    runtimeMemory?: RuntimeMemoryConfig;
     /** Optional DSH-owned overrides injected into every Mnemon CLI process. */
     embedding?: MnemonEmbeddingConfig;
     memoryTopology?: MemoryTopologyConfig;
@@ -129,7 +145,7 @@ export interface Config {
     displayMode?: 'sidebar' | 'buildin';
     tabEnabled?: boolean;
     writeEnabled?: boolean;
-    /** Remote Web policy for privileged Mnemon RPC. This boundary is sampled at Host startup. */
+    /** DSH rc.2 management-channel authority; ignored by DSH 0.1.2-alpha.1. */
     remoteAccess?: 'read-only' | 'trusted-host';
     lifecycleEnabled?: boolean;
     recallMode?: 'guided' | 'off';
@@ -202,11 +218,13 @@ export interface InteractionConfig {
 }
 export interface ResolvedConfig {
     storageScope: StorageScopeKind;
+    runtimeUserScope: 'storage' | 'global';
     cliPath?: string;
     dataDir?: string;
     store?: string;
     timeoutMs: number;
     defaultRecallLimit: number;
+    runtimeMemory: ResolvedRuntimeMemoryConfig;
     embedding: ResolvedMnemonEmbeddingConfig;
     memoryTopology: ResolvedMemoryTopologyConfig;
     recallQuality: ResolvedRecallQualityConfig;
@@ -214,6 +232,7 @@ export interface ResolvedConfig {
     displayMode: 'sidebar' | 'buildin';
     tabEnabled: boolean;
     writeEnabled: boolean;
+    /** DSH rc.2 management-channel authority; ignored by DSH 0.1.2-alpha.1. */
     remoteAccess: 'read-only' | 'trusted-host';
     lifecycleEnabled: boolean;
     recallMode: 'guided' | 'off';
@@ -683,6 +702,8 @@ export interface RuntimeMemoryEntry {
     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;
@@ -704,6 +725,8 @@ export interface RuntimeMemorySnapshot {
 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;
@@ -711,6 +734,8 @@ export interface RuntimeMemoryMutation {
     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;

package/lib/types/src/subagent.d.ts

@@ -66,6 +66,7 @@ export declare class MnemonSubagentCoordinator {
     private readonly documents?;
     private readonly resultRuntime?;
     private readonly taskAgentModelResolver?;
+    private readonly runtimeMaintenanceMaxTokensResolver?;
     private readonly counters;
     private runtimeQueue;
     private documentQueue;
@@ -73,7 +74,7 @@ export declare class MnemonSubagentCoordinator {
     constructor(subagents: HostSubagentsService, runtimeMemoryOrSource?: (RuntimeMemoryController | AgentRuntimeSource) | undefined, documents?: DocumentManager | undefined, resultRuntime?: HostResultToolRuntime | undefined, taskAgentModelResolver?: (() => {
         provider: string;
         model: string;
-    } | undefined) | undefined);
+    } | undefined) | undefined, runtimeMaintenanceMaxTokensResolver?: (() => number) | undefined);
     snapshot(): SubagentCounters;
     documentsSnapshot(parent: HostAgent): import("./documents.ts").DocumentSnapshot;
     documentGet(parent: HostAgent, id: string): DocumentView;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "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",
@@ -114,9 +114,9 @@
     },
     "client": {
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-locale"
       ],
@@ -133,7 +133,9 @@
     "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": "pnpm run typecheck && pnpm run test && pnpm run verify:build && 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"
   },
   "dependencies": {
     "fflate": "^0.8.3",
@@ -142,7 +144,7 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.0-rc.6 || ^0.1.1-rc.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"
   },
@@ -152,9 +154,9 @@
     "@deepseek-ai/dsh": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-connection": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-locale": "0.1.1-rc.2",
-    "@deepseek-ai/dsh-client-runtime": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-conversation": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-primitives": "0.1.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-settings": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-slots": "0.1.1-rc.2",
     "@deepseek-ai/dsh-client-ui-tool": "0.1.1-rc.2",