dsh-mnemon 0.5.30 → 0.5.32

package/lib/types/src/client/settings-panel.d.ts

@@ -0,0 +1,58 @@
+import { type JSX } from 'react';
+import type { MnemonTranslate } from './locales.ts';
+/**
+ * The two ways a group of settings saves. A choice (switch or selector)
+ * applies when it is made; edits that need checking, or that move data, wait
+ * for their group's Apply. No group joins another group's save.
+ */
+export declare function useScope<S>(scope: {
+    getSnapshot(): S;
+    subscribe(listener: () => void): () => void;
+}): S;
+/**
+ * One group's staged edits, applied together with its own button. Edits that
+ * come back to the saved values leave nothing to apply.
+ */
+export declare function useStaged<D>(value: D, write: (draft: D) => Promise<void>): {
+    draft: D;
+    dirty: boolean;
+    saving: boolean;
+    failed: string | null;
+    applied: boolean;
+    edit: (next: Partial<D>) => void;
+    discard: () => void;
+    apply: () => Promise<void>;
+};
+/**
+ * A choice that saves when it is made: it shows the chosen value at once, and
+ * the saved one again if the write fails.
+ */
+export declare function useLive<T>(saved: T, write: (value: T) => Promise<void>): {
+    value: T;
+    failed: string | null;
+    set: (value: T) => void;
+};
+/**
+ * A failed write, beside the controls that made it. `t` is the translation the
+ * settings use: the configuration page sets none around a component's settings.
+ */
+export declare function WriteFailure(props: {
+    error: string | null;
+    t: MnemonTranslate;
+}): JSX.Element | null;
+/**
+ * Discard and Apply for one group, shown while it has edits; `note` says what
+ * applying does. `t` is the translation the settings use, as for WriteFailure.
+ */
+export declare function PanelActions(props: {
+    dirty: boolean;
+    saving: boolean;
+    invalid: string | null;
+    failed: string | null;
+    applied: boolean;
+    disabled: boolean;
+    note?: string;
+    t: MnemonTranslate;
+    onDiscard: () => void;
+    onApply: () => void;
+}): JSX.Element | null;

package/lib/types/src/client/ui-icons.d.ts

@@ -1,3 +1,2 @@
 export { IconCloseOutlineRegular, IconRefreshOutlineRegular, IconSettingsOutlineRegular } from '@deepseek-ai/dsh-client-ui-primitives';
 export declare const IconChevronLeftOutline14: (props: import("@deepseek-ai/dsh-client-ui-primitives").IconProps) => import("react").JSX.Element;
-export declare const IconDataOutline16: (props: import("@deepseek-ai/dsh-client-ui-primitives").IconProps) => import("react").JSX.Element;

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

@@ -110,6 +110,9 @@ export interface MemorySourceManifest {
     actions?: MemorySourceActionManifest[];
     management?: MemoryManagementDescriptor;
 }
+/** Background work a Host runs for the turns of a Strategy that declares it. */
+export declare const MEMORY_STRATEGY_WORKFLOWS: readonly ["idle-review", "runtime-capacity"];
+export type MemoryStrategyWorkflow = typeof MEMORY_STRATEGY_WORKFLOWS[number];
 export interface MemoryStrategyManifest {
     apiVersion: typeof COMPOSABLE_MEMORY_API_VERSION;
     kind: 'strategy';
@@ -123,6 +126,12 @@ export interface MemoryStrategyManifest {
     maxActions: number;
     /** Exclusive contribution slots this Strategy accepts; standard slots follow Core's value contracts. */
     extensionSlots?: string[];
+    /**
+     * Background work the Host runs for the turns this Strategy composes: `idle-review` reviews an idle
+     * conversation, `runtime-capacity` archives older Runtime entries before a write would overflow it.
+     * A Host ignores workflows it does not know.
+     */
+    workflows?: MemoryStrategyWorkflow[];
 }
 /** Extension target for every selected Strategy that declares the extension's standard slot. */
 export declare const ANY_MEMORY_STRATEGY: "*";

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

@@ -4,7 +4,7 @@ export declare const DEFAULT_RUNTIME_USER_LIMIT_BYTES: number;
 export declare const MAX_RUNTIME_MEMORY_LIMIT_BYTES: number;
 export declare const DEFAULT_RUNTIME_MAINTENANCE_MAX_TOKENS = 8192;
 export declare const MAX_RUNTIME_MAINTENANCE_MAX_TOKENS = 1000000;
-export { DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, MNEMON_EMBEDDING_PROTOCOLS } from "./protocol.ts";
+export { DEFAULT_EMBEDDING_ENDPOINT, DEFAULT_EMBEDDING_MODEL, DEFAULT_EMBEDDING_PROTOCOL, MNEMON_EMBEDDING_PROTOCOLS } from 'dsh-mnemon-source-memory-spaces/contracts';
 export declare const DEFAULT_TIMEOUT_MS = 10000;
 export declare const DEFAULT_RECALL_LIMIT = 10;
 export declare const DEFAULT_RECALL_QUALITY_POLICY: string;

package/lib/types/src/host/memory-tools.d.ts

@@ -0,0 +1,139 @@
+/**
+ * One row for each memory tool the Host registers: the Source Route or Action a named tool runs,
+ * whether it reads, inspects or writes, and how the turn memory bar shows it. The result tool that
+ * delegated children finish with runs no Source operation and has no row. Host modules and the
+ * browser client read this table; each tool's model-visible description and schemas stay with its
+ * registration in tools.ts. The two generic View tools run whichever Route or Action of the turn's
+ * View a call names, so their rows name no Source and no page.
+ */
+/** A Memory System page the turn memory bar opens: Status, or a Source page id. */
+export type MemoryToolPage = 'status' | `${string}/${string}`;
+export interface MemoryToolEntry {
+    /** The Source type whose Route or Action the tool runs. */
+    readonly sourceTypeId?: string;
+    /** The id of that Route or Action. */
+    readonly operation?: string;
+    /** `read` returns evidence, `inspect` health or a catalog, and `write` changes memory. */
+    readonly kind: 'read' | 'inspect' | 'write';
+    /** The page the tool's chip in the turn memory bar opens. */
+    readonly page?: MemoryToolPage;
+    /** The locale key that says what the tool did. */
+    readonly label: `turnTail.tool.${string}`;
+}
+/** In registration order, which is also the order the View lists tools that share an operation. */
+export declare const MEMORY_TOOLS: {
+    readonly mnemon_view_route: {
+        readonly kind: "read";
+        readonly label: "turnTail.tool.viewRoute";
+    };
+    readonly mnemon_view_action: {
+        readonly kind: "write";
+        readonly label: "turnTail.tool.viewAction";
+    };
+    readonly mnemon_memory_bodies: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "inspect";
+        readonly kind: "inspect";
+        readonly page: "memory-spaces/spaces";
+        readonly label: "turnTail.tool.spaces";
+    };
+    readonly mnemon_recall: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "recall";
+        readonly kind: "read";
+        readonly page: "memory-spaces/explore";
+        readonly label: "turnTail.tool.recall";
+    };
+    readonly mnemon_related: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "related";
+        readonly kind: "read";
+        readonly page: "memory-spaces/explore";
+        readonly label: "turnTail.tool.related";
+    };
+    readonly mnemon_status: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "inspect";
+        readonly kind: "inspect";
+        readonly page: "status";
+        readonly label: "turnTail.tool.status";
+    };
+    readonly mnemon_document_search: {
+        readonly sourceTypeId: "documents";
+        readonly operation: "search";
+        readonly kind: "read";
+        readonly page: "documents/library";
+        readonly label: "turnTail.tool.documentSearch";
+    };
+    readonly mnemon_document_create: {
+        readonly sourceTypeId: "documents";
+        readonly operation: "create";
+        readonly kind: "write";
+        readonly page: "documents/library";
+        readonly label: "turnTail.tool.documentCreate";
+    };
+    readonly mnemon_document_manage: {
+        readonly sourceTypeId: "documents";
+        readonly operation: "manage";
+        readonly kind: "write";
+        readonly page: "documents/library";
+        readonly label: "turnTail.tool.documentManage";
+    };
+    readonly mnemon_runtime_memory: {
+        readonly sourceTypeId: "runtime";
+        readonly operation: "mutate";
+        readonly kind: "write";
+        readonly page: "runtime/entries";
+        readonly label: "turnTail.tool.runtime";
+    };
+    readonly mnemon_remember: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "remember";
+        readonly kind: "write";
+        readonly page: "memory-spaces/spaces";
+        readonly label: "turnTail.tool.remember";
+    };
+    readonly mnemon_link: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "link";
+        readonly kind: "write";
+        readonly page: "memory-spaces/spaces";
+        readonly label: "turnTail.tool.link";
+    };
+    readonly mnemon_forget: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "forget";
+        readonly kind: "write";
+        readonly page: "memory-spaces/spaces";
+        readonly label: "turnTail.tool.forget";
+    };
+    readonly mnemon_memory_body_create: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "manage-spaces";
+        readonly kind: "write";
+        readonly page: "memory-spaces/spaces";
+        readonly label: "turnTail.tool.spaceCreate";
+    };
+    readonly mnemon_memory_body_update: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "manage-spaces";
+        readonly kind: "write";
+        readonly page: "memory-spaces/spaces";
+        readonly label: "turnTail.tool.spaceUpdate";
+    };
+    readonly mnemon_memory_body_merge: {
+        readonly sourceTypeId: "memory-spaces";
+        readonly operation: "manage-spaces";
+        readonly kind: "write";
+        readonly page: "memory-spaces/spaces";
+        readonly label: "turnTail.tool.spaceMerge";
+    };
+};
+export type MemoryToolName = keyof typeof MEMORY_TOOLS;
+export type MemoryToolLabel = (typeof MEMORY_TOOLS)[MemoryToolName]['label'];
+/** The row of one memory tool, or undefined for any other tool name. */
+export declare function memoryTool(name: string): (MemoryToolEntry & {
+    readonly label: MemoryToolLabel;
+}) | undefined;
+/** Every memory tool name with its row, in table order. */
+export declare function memoryTools(): Array<[MemoryToolName, MemoryToolEntry]>;

package/lib/types/src/host/protocol.d.ts

@@ -11,13 +11,6 @@ export declare function namedToolInstance<T extends {
 export type MemoryParticipationMode = 'off' | 'manual' | 'automatic';
 export type MemoryParticipationChannel = 'recall' | 'write' | 'projection' | 'maintenance';
 export type MemoryLayerParticipation = Record<MemoryParticipationChannel, MemoryParticipationMode>;
-export interface MemoryTopologyDefinition {
-    id: string;
-    strategyId: string;
-    layers: Array<ResolvedMemoryLayerConfig & {
-        id: string;
-    }>;
-}
 export interface MemoryCompositionStatus {
     /** Whether a composition serves new turns. A rejected change can leave the previous one serving. */
     serving: boolean;
@@ -28,9 +21,11 @@ export interface MemoryCompositionStatus {
     configuration: ResolvedMemoryTopologyConfig;
 }
 import type { RecallQualityConfig, ResolvedRecallQualityConfig, MnemonEmbeddingConfig, ResolvedMnemonEmbeddingConfig } from 'dsh-mnemon-source-memory-spaces/contracts';
-import type { MemoryPersistenceStrategy, ResolvedMemoryPersistenceStrategy, MemoryProviderRuntimeStatus, MemoryBodyStats as MemorySpaceStats, MemoryBodyView as MemorySpaceView } from 'dsh-mnemon-source-memory-spaces/contracts';
+import type { MemoryPersistenceStrategy, ResolvedMemoryPersistenceStrategy, MemoryProviderRuntimeStatus, MemorySpaceStats, MemorySpaceView } from 'dsh-mnemon-source-memory-spaces/contracts';
 import type { ConnectionHandle as DshClientConnectionHandle } from '@deepseek-ai/dsh-client-connection/client';
-import type { DocumentSnapshot } from 'dsh-mnemon-source-documents/contracts';
+import type { DocumentMutationResult, DocumentSnapshot } from 'dsh-mnemon-source-documents/contracts';
+import type { RuntimeMemoryMutationResult } from 'dsh-mnemon-source-runtime/contracts';
+import type { MemoryMigrationLineage, MemoryMutationReceipt } from '../core/contracts/index.ts';
 export declare const MNEMON_READ_CHANNEL = "/dsh-mnemon-read";
 export declare const MNEMON_ACTIVATION_CHANNEL = "/dsh-mnemon-activation";
 export declare const MNEMON_WRITE_CHANNEL = "/dsh-mnemon-write";
@@ -74,6 +69,28 @@ export declare const MNEMON_REMOTE_REVIEW_ENDPOINT = "dshMnemon/review";
 export declare const MNEMON_SETTINGS_NAMESPACE = "mnemon";
 export declare const MNEMON_UI_SETTINGS_NAMESPACE = "mnemon-ui";
 export * from './view-protocol.ts';
+export * from './memory-tools.ts';
+export * from './sync-rules.ts';
+/**
+ * Every endpoint the Host serves on each channel, by the names both sides use: the client's calls
+ * are typed against this list, and tests/rpc-endpoints.spec.ts checks that each Host handler serves
+ * exactly these names.
+ */
+export declare const MNEMON_RPC_ENDPOINTS: {
+    readonly "/dsh-mnemon-read": readonly ["status", "status-summary", "memory-system", "versions", "task-agent-models", "runtime-memory", "documents", "document", "document-search", "graph", "bodies", "body-directory", "body-reconnect", "provider-services", "embedding-status", "list", "entities", "search", "agent-search", "related", "turn-activities", "turn-activity", "assistant-message", "source-management-catalog", "source-management-read", "source-assistance"];
+    readonly "/dsh-mnemon-activation": readonly ["body", "source-assistance"];
+    readonly "/dsh-mnemon-write": readonly ["runtime-memory", "document", "supervise", "remember", "link", "forget", "body-create", "body-update", "body-delete", "body-merge", "body-metadata-maintain", "provider-service-update", "embedding-fill", "source-management-mutate", "source-assistance", "version-update"];
+    readonly "/dsh-mnemon-pack": readonly ["target", "export", "inspect", "import"];
+    readonly "/dsh-mnemon-sync": readonly ["status", "configure", "push", "preview", "backups", "diff", "pull", "github-status", "github-start", "github-poll", "github-cancel", "github-signout", "github-repositories", "github-create"];
+    readonly "/dsh-mnemon-review": readonly ["view", "opinion", "decide", "reopen", "reconcile", "apply"];
+    readonly "/dsh-mnemon-settings": readonly ["get", "mutate"];
+    readonly "/dsh-mnemon-view": readonly ["dashboard", "preview", "inspect-plugin"];
+    readonly "/dsh-mnemon-view-settings": readonly ["apply", "install-plugin"];
+};
+/** A channel the Host serves. */
+export type MnemonRpcChannel = keyof typeof MNEMON_RPC_ENDPOINTS;
+/** An endpoint the Host serves on a channel, or on any of several. */
+export type MnemonRpcEndpoint<Channel extends MnemonRpcChannel = MnemonRpcChannel> = (typeof MNEMON_RPC_ENDPOINTS)[Channel][number];
 export type JsonPrimitive = string | number | boolean | null;
 export type JsonValue = JsonPrimitive | JsonValue[] | {
     [key: string]: JsonValue;
@@ -208,6 +225,7 @@ export interface ResolvedRuntimeMemoryConfig {
     userLimitBytes: number;
     maintenanceMaxTokens: number;
 }
+export { STARTER_COMPONENT_ROWS } from './starter-components.ts';
 export { normalizeDisplayMode } from './display-mode.ts';
 export type MnemonDisplayMode = 'sidebar' | 'builtin';
 export declare const DEFAULT_IDLE_REVIEW: {
@@ -250,7 +268,7 @@ export interface Config {
     /** Optional DSH-owned overrides injected into every Mnemon CLI process. */
     embedding?: MnemonEmbeddingConfig;
     memoryTopology?: MemoryTopologyConfig;
-    /** Profile-owned plugin choices on DSH 0.1.7 and newer. */
+    /** Profile-owned plugin choices. */
     memoryView?: import('./view-protocol.ts').MemoryViewPreferences;
     /** Successful import of this profile's removed settings namespaces. */
     legacySettingsImported?: boolean;
@@ -268,6 +286,7 @@ export interface Config {
     idleReviewMs?: number;
     idleReview?: Partial<ResolvedIdleReviewConfig>;
     conversationInteraction?: {
+        /** @deprecated Switches nothing. Stored profiles may still hold it; the resolved config leaves it out. */
         toolviews?: boolean;
         turnBar?: boolean;
         saveAction?: boolean;
@@ -287,11 +306,20 @@ export interface TaskAgentModelConfig {
     mode?: 'inherit' | 'fixed';
     provider?: string;
     model?: string;
+    /**
+     * With `inherit`, run on the model the conversation that asked for the work
+     * last used, while that conversation is open. Off by default; a switch
+     * rather than a third mode, so a release that does not know it keeps
+     * reading `inherit` as before.
+     */
+    followConversation?: boolean;
 }
 export interface ResolvedTaskAgentModelConfig {
     mode: 'inherit' | 'fixed';
     provider?: string;
     model?: string;
+    /** Present, and true, only on an inherited route that follows its conversation. */
+    followConversation?: true;
 }
 export interface TaskAgentModelCatalogModel {
     id: string;
@@ -314,12 +342,31 @@ export interface TaskAgentModelCatalog {
     effective?: {
         provider: string;
         model: string;
-        source: 'fixed' | 'dsh-default' | 'active-agent';
+        source: 'fixed' | 'session' | 'dsh-default' | 'active-agent';
     };
     defaultSelection?: {
         provider: string;
         model: string;
     };
+    /**
+     * The route the asking conversation's own delegated work takes while it is
+     * open: the model of its last request, or the one it was created with before
+     * its first. An inherited setting that follows its conversation takes it too;
+     * it is reported whether or not that switch is on.
+     */
+    session?: {
+        provider: string;
+        model: string;
+    };
+    /**
+     * The route an inherited setting takes without following a conversation: the
+     * DSH new-session default, else an open Agent's creation route.
+     */
+    inherited?: {
+        provider: string;
+        model: string;
+        source: 'dsh-default' | 'active-agent';
+    };
     groups: TaskAgentModelCatalogGroup[];
     failures: TaskAgentModelCatalogFailure[];
 }
@@ -351,7 +398,6 @@ export interface ResolvedConfig {
     idleReviewMs: number;
     idleReview: ResolvedIdleReviewConfig;
     conversationInteraction: {
-        toolviews: boolean;
         turnBar: boolean;
         saveAction: boolean;
     };
@@ -471,6 +517,60 @@ export interface SubagentCounters {
     lastOperation?: 'recall' | 'write' | 'review' | 'placement' | 'migration' | 'compaction' | 'document-archive' | 'metadata-maintenance' | 'reconcile';
     lastAt?: string;
 }
+/** What a delegated memory write did, as the write task Agent's receipts show it. */
+export interface DelegatedWriteResult {
+    delegated: true;
+    runId: string;
+    provider: string;
+    summary: string;
+    action: string;
+    /** Where the memory went: the spaces its receipts name, else what the writer reported. */
+    memoryBodyIds: string[];
+    /** Spaces that were inactive and that this write switched on. */
+    activatedMemoryBodyIds?: string[];
+    documentIds?: string[];
+    /** Memories saved without a vector, as the Provider's receipt says (#388). */
+    unembedded?: Array<{
+        memoryBodyId?: string;
+        id?: string;
+    }>;
+    hint?: string;
+}
+/** The `supervise` RPC result: a delegated write for the conversation that asked for it. */
+export interface SupervisedWritebackResult extends DelegatedWriteResult {
+    sessionId: string;
+}
+/** What a task Agent answered from the evidence a search recalled, as `agent-search` adds it to the results. */
+export interface DelegatedAnswerResult {
+    answer: string;
+    citations: string[];
+    delegation: {
+        runId: string;
+        provider: string;
+    };
+}
+/** A Document write or archive the Host ran: the Documents Source's result, and the archival it ran, for the archive or to make room for the write. */
+export type CoordinatedDocumentResult = DocumentMutationResult & {
+    lineage?: MemoryMigrationLineage[];
+    maintenance?: {
+        runId: string;
+        provider: string;
+        summary: string;
+        memoryBodyIds: string[];
+        archivedDocumentIds: string[];
+    };
+};
+/** A runtime memory write the Host ran: the Runtime Source's result, and the capacity maintenance that ran with it. */
+export type CoordinatedRuntimeMemoryResult = RuntimeMemoryMutationResult & {
+    revision?: string;
+    maintenance?: {
+        runId: string;
+        provider: string;
+        summary: string;
+        memoryBodyIds: string[];
+    };
+    memoryReceipt?: Pick<MemoryMutationReceipt, 'status' | 'completion' | 'committedAt'>;
+};
 export type LifecyclePhase = 'idle' | 'prime' | 'recall' | 'writeback' | 'review' | 'supervised' | 'error';
 export interface LifecycleCounters {
     primes: number;
@@ -654,8 +754,6 @@ export interface MnemonMachineIdentity {
  * which the name then follows, or a name a person typed, which stays as given.
  */
 export type MnemonMachineLabelSource = 'hostname' | 'custom';
-/** The longest name an installation carries; a host name past it is shortened. */
-export declare const MNEMON_MACHINE_LABEL_MAX = 120;
 /** Which machine wrote one runtime entry, so a merge can tell two installations apart. */
 export interface MnemonEntryOrigin {
     machine: string;
@@ -806,8 +904,6 @@ export interface MnemonSyncConfigView {
  * when neither is set: the order here is the order of resolution.
  */
 export type MnemonSyncCredentialSource = 'environment' | 'token' | 'github' | 'none';
-/** How far the browser step of a GitHub sign-in has come. */
-export type MnemonSyncGitHubFlowStatus = 'pending' | 'expired' | 'denied' | 'error';
 export interface MnemonSyncGitHubFlow {
     userCode: string;
     verificationUri: string;
@@ -1185,11 +1281,3 @@ export interface VersionUpdateResult {
     restartRequired: boolean;
     output?: string;
 }
-export declare const CATEGORIES: readonly ["preference", "decision", "fact", "insight", "context", "general"];
-export declare const SOURCES: readonly ["user", "agent", "external"];
-export declare const EDGE_TYPES: readonly ["temporal", "semantic", "causal", "entity"];
-export declare const INTENTS: readonly ["WHY", "WHEN", "ENTITY", "GENERAL"];
-export declare const DEFAULT_EMBEDDING_ENDPOINT = "http://localhost:11434";
-export declare const DEFAULT_EMBEDDING_MODEL = "nomic-embed-text";
-export declare const DEFAULT_EMBEDDING_PROTOCOL = "auto";
-export declare const MNEMON_EMBEDDING_PROTOCOLS: readonly ["auto", "ollama", "openai"];

package/lib/types/src/host/starter-components.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The component rows the Starter's bundle patch (cordis.patch.yml) declares,
+ * in its order: each row's id and the package it names. DSH lists them under
+ * the bundle's page. Tests keep this list equal to that patch and to the
+ * versions package.json pins.
+ */
+export declare const STARTER_COMPONENT_ROWS: ReadonlyArray<{
+    rowId: string;
+    packageName: string;
+}>;
+/** The three enhancements the Starter ships switched off, in the order the Host suggests them for installation. */
+export declare const STARTER_ENHANCEMENT_PACKAGES: readonly string[];
+/**
+ * The shipped packages that carry a bundle patch of their own, so that one
+ * installed alone registers its row itself: the enhancements and the General
+ * strategy. Under the Starter its rows own them, so a profile that also linked
+ * them as separate bundles would declare those ids twice. A literal, not a
+ * spread of the list above, so that a bundle that does not use it drops it.
+ */
+export declare const STARTER_SELF_REGISTERING_PACKAGES: readonly string[];

package/lib/types/src/host/sync-rules.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The rules a Git sync setting meets, shared by the settings form, which checks a field as the user
+ * types it, and the Host, which checks what it saves and what it reads back. They import nothing,
+ * so the browser bundle takes them too; each side keeps its own messages.
+ */
+/** The longest name an installation carries; a host name past it is shortened. */
+export declare const MNEMON_MACHINE_LABEL_MAX = 120;
+/** A Git branch name: no revision syntax, no empty path segment, no trailing dot or lock suffix. */
+export declare function syncBranchValid(name: string): boolean;
+/** The parts of a directory inside the branch, or undefined when it is not one: relative, with no `.`, `..` or drive. */
+export declare function syncDirectoryParts(value: string): string[] | undefined;
+/** What is wrong with a repository address. */
+export type MnemonSyncRepositoryProblem = 'format' | 'credentials';
+/**
+ * What is wrong with a repository address, or nothing for an https:// or ssh:// URL without
+ * credentials in it, a git@host:path address, or a local path that `localPath` takes.
+ */
+export declare function syncRepositoryProblem(url: string, localPath: (path: string) => boolean): MnemonSyncRepositoryProblem | undefined;
+/**
+ * A local path that is absolute on POSIX or on Windows, for the browser, which cannot tell which
+ * platform the Host runs on: a POSIX path, a Windows path on a drive, or a UNC share. The Host
+ * checks a path by its own platform's rule instead.
+ */
+export declare function portableAbsolutePath(path: string): boolean;
+/** A commit author's address. */
+export declare function syncEmailValid(email: string): boolean;
+/** A name for this machine, as it is stored and shown: one line of at most MNEMON_MACHINE_LABEL_MAX characters. */
+export declare function machineLabelValid(label: string): boolean;
+/** A GitHub repository name, as GitHub accepts one. */
+export declare function githubRepositoryNameValid(name: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mnemon",
-  "version": "0.5.30",
+  "version": "0.5.32",
   "description": "Composable, view-based memory for DeepSeek Harness. Pluggable sources and strategies, with layered memory out of the box.",
   "keywords": [
     "deepseek-harness",
@@ -48,7 +48,8 @@
     "tag": "latest"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=20",
+    "dsh": ">=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-rc.1 <0.3.0-0"
   },
   "type": "module",
   "main": "lib/index.js",
@@ -135,6 +136,7 @@
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "test:root": "vitest run --dir tests",
+    "test:installed-dsh": "vitest run --config scripts/installed-dsh.config.ts",
     "bench:algorithms": "vitest run --config scripts/benchmark-algorithms.config.ts",
     "verify:build": "node scripts/verify-deterministic-build.mjs",
     "verify:headless": "node scripts/verify-headless-profile.mjs",
@@ -162,13 +164,13 @@
     "dsh-mnemon-provider-openviking": "0.5.8",
     "dsh-mnemon-provider-retaindb": "0.5.6",
     "dsh-mnemon-provider-supermemory": "0.5.5",
-    "dsh-mnemon-source-documents": "0.5.10",
-    "dsh-mnemon-source-memory-spaces": "0.5.20",
-    "dsh-mnemon-source-runtime": "0.5.14",
+    "dsh-mnemon-source-documents": "0.5.11",
+    "dsh-mnemon-source-memory-spaces": "0.5.22",
+    "dsh-mnemon-source-runtime": "0.5.15",
     "dsh-mnemon-strategy-auto-capture": "0.5.5",
-    "dsh-mnemon-strategy-default-three-tier": "0.5.9",
+    "dsh-mnemon-strategy-default-three-tier": "0.5.10",
     "dsh-mnemon-strategy-general": "0.5.1",
-    "dsh-mnemon-strategy-light-context": "0.5.5",
+    "dsh-mnemon-strategy-light-context": "0.5.6",
     "dsh-mnemon-strategy-scoped": "0.5.5",
     "fflate": "^0.8.3",
     "yaml": "^2.9.0",
@@ -176,50 +178,48 @@
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-app-boot": "^0.1.7-rc.2 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.2 || ^0.2.0-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-rc.2 || ^0.2.0-rc.1",
+    "@deepseek-ai/dsh-app-boot": ">=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-rc.1 <0.3.0-0",
+    "@deepseek-ai/dsh-typert-protocol": ">=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-rc.1 <0.3.0-0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
     "@changesets/cli": "^2.31.1",
-    "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-agent-loop": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-api-gateway": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-app-boot": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-store": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-chat": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-sidebar": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-tool": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-invariants": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-llm": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session-format-v0-to-v1": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session-projection": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-session-query": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-subagent": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-typert-registry": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-code-language": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-util-workspace-path": "0.1.7-rc.2",
+    "@deepseek-ai/cordis": "^4.0.5",
+    "@deepseek-ai/dsh": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-api-gateway": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-connection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-store": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-chat": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-sidebar": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-tool": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-format-v0-to-v1": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-session-query": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-subagent": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-subagent-spawn-in-process": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-tools": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-typert-registry": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-util-code-language": "0.2.1-rc.2",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-rc.2",
     "@shikijs/langs": "^4.3.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^22.0.0",