dsh-mnemon 0.5.31 → 0.5.33

package/lib/{runtime-Bk6lFgxd.js → runtime-zuuBe8x1.js}

@@ -1,5 +1,5 @@
 import { DEFAULT_MEMORY_VIEW_BUDGET } from "./contracts.js";
-import { a as defineMemoryStrategy, c as jsonClone, d as uniqueIds, f as validateCapabilities, i as defineMemorySource, l as positiveInteger, n as deepFreeze, o as defineMemoryStrategyExtension, p as validateProvenance, r as defineMemoryPlugin, s as id, t as canonicalMemoryJson, u as requiredText } from "./definitions-j9QPbrXb.js";
+import { a as defineMemoryStrategy, c as jsonClone, d as uniqueIds, f as validateCapabilities, i as defineMemorySource, l as positiveInteger, n as deepFreeze, o as defineMemoryStrategyExtension, p as validateProvenance, r as defineMemoryPlugin, s as id, t as canonicalMemoryJson, u as requiredText } from "./definitions-DU7MLBhu.js";
 import { createHash } from "node:crypto";
 import { setMaxListeners } from "node:events";
 //#region src/core/contributions.ts

package/lib/{starter-resolution-DXcN5HsU.js → starter-resolution-DoFp9FLr.js}

@@ -14,13 +14,13 @@ var dependencies = {
 	"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.21",
-	"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",

package/lib/starter.js

@@ -1,4 +1,4 @@
-import { t as prepareStarterResolution } from "./starter-resolution-DXcN5HsU.js";
+import { t as prepareStarterResolution } from "./starter-resolution-DoFp9FLr.js";
 //#region src/starter.ts
 const name = "dsh-mnemon-starter";
 const provide = ["mnemonStarterReady"];

package/lib/{strategy-configuration-sVkKToSW.js → strategy-configuration-CLHxaPOb.js}

@@ -1,4 +1,4 @@
-import { n as deepFreeze, t as canonicalMemoryJson } from "./definitions-j9QPbrXb.js";
+import { n as deepFreeze, t as canonicalMemoryJson } from "./definitions-DU7MLBhu.js";
 import { resolve } from "node:path";
 import { createHash, randomUUID } from "node:crypto";
 //#region src/sdk/storage-lock.ts

package/lib/testing.js

@@ -1,6 +1,6 @@
-import { t as provideMemoryRuntime } from "./runtime-Bk6lFgxd.js";
+import { t as provideMemoryRuntime } from "./runtime-zuuBe8x1.js";
 import { DEFAULT_MEMORY_VIEW_BUDGET } from "./contracts.js";
-import { c as jsonClone } from "./definitions-j9QPbrXb.js";
+import { c as jsonClone } from "./definitions-DU7MLBhu.js";
 import { Context } from "@deepseek-ai/cordis";
 import { readFileSync } from "node:fs";
 //#region src/sdk/testing.ts

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

@@ -0,0 +1,19 @@
+import type { JSX, ReactNode } from 'react';
+interface GlobalLocationSettingProps {
+    name: string;
+    ariaLabel: string;
+    label: string;
+    hint: ReactNode;
+    defaultLabel: string;
+    customLabel: string;
+    custom: boolean;
+    workspace: boolean;
+    disabled: boolean;
+    className?: string | undefined;
+    children?: ReactNode;
+    onChange: (custom: boolean) => void;
+    onInteract?: (() => void) | undefined;
+}
+/** The default or custom location control: the storage directory, Native and workspace-aware providers. */
+export declare function GlobalLocationSetting(props: GlobalLocationSettingProps): JSX.Element;
+export {};

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

@@ -1,9 +1,23 @@
 import { type ReactNode } from 'react';
+import type { MemoryJsonValue } from "../core/contracts/index.js";
 /**
  * A component's own settings, on its page: keyed by the component's package
  * name, rendered after the page's generated state, relations and options.
  */
 export declare const MNEMON_COMPONENT_SETTINGS_SLOT: "mnemon.component.settings";
+/**
+ * The priority at which dsh-mnemon keeps the settings of a shipped component
+ * that once had no settings of its own (today Memory Spaces). DSH renders, for
+ * each key, the registration with the lowest priority, so the component's own
+ * registration, at the default 0, replaces dsh-mnemon's while it lasts.
+ *
+ * Exporting this is a promise to those components, and a component may rely on
+ * it alone: dsh-mnemon keeps their settings at this priority, so registering
+ * their own does not collide with it, and lends their settings `host` (see
+ * {@link MemoryComponentSettingsProps.host}). dsh-mnemon 0.5.31 and earlier
+ * export neither and draw those settings at the default priority.
+ */
+export declare const MNEMON_COMPONENT_FALLBACK_PRIORITY = 100;
 /**
  * What a component's card on the Memory System's Status page says while it
  * runs, keyed by the component's package name. A card that is not running
@@ -30,6 +44,53 @@ export interface MemoryComponentSettingsProps {
         id: string;
         label?: string;
     };
+    /**
+     * What the page lends the settings registered under the key of a shipped
+     * component whose settings dsh-mnemon used to draw (today Memory Spaces):
+     * the configuration keys and Host operations dsh-mnemon serves it. It goes
+     * with the key, not with who registered: settings under any other key
+     * receive none.
+     */
+    host?: MemoryComponentHost;
+}
+/** dsh-mnemon's configuration as a component's settings read it. */
+export interface MemoryComponentConfigurationSnapshot {
+    status: 'loading' | 'ready' | 'unavailable';
+    /** The configuration keys the page shares with this component. */
+    value?: Readonly<Record<string, unknown>>;
+    /** Moves with every saved change, made on this page or anywhere else. */
+    revision?: number;
+    /** Whether the Host takes a write now. */
+    writable: boolean;
+}
+/**
+ * dsh-mnemon's configuration and Host operations, bound to one component and
+ * to the page's conversation and workspace, as Source pages get a scoped
+ * management client: never the settings service or the transport itself.
+ */
+export interface MemoryComponentHost {
+    configuration: {
+        getSnapshot(): MemoryComponentConfigurationSnapshot;
+        subscribe(listener: () => void): () => void;
+        /** Save one key the component owns, fenced by the revision the page read like every settings write. */
+        set(key: string, value: MemoryJsonValue): Promise<void>;
+    };
+    /** The Host operations dsh-mnemon serves this component; absent while the page has no Host connection. */
+    operations?: {
+        read(operation: string, input?: MemoryJsonValue): Promise<unknown>;
+        write(operation: string, input: MemoryJsonValue): Promise<unknown>;
+    };
+    /** The component changed its data here, so the Memory System reads its pages again. */
+    changed(): void;
+    /**
+     * What the settings keep for as long as the page's client runs, one store per
+     * component, conversation and workspace like the host itself. The settings
+     * can mount again under an open page: dsh-mnemon draws a shipped component's
+     * settings until the component's own client registers them, so turning the
+     * component on swaps one for the other. What the first mount kept here lets
+     * the next start where it was.
+     */
+    readonly retained: Map<string, unknown>;
 }
 export type MemoryComponentSettingsComponent = (props: MemoryComponentSettingsProps) => ReactNode;
 /** What the Status page tells a component's card: the component it is about. */
@@ -78,6 +139,13 @@ export interface MemoryComponentUIContext {
  * is released by the returned function.
  */
 export declare function installMemoryComponentUI(ctx: MemoryComponentUIContext, contribution: MemoryComponentUIContribution): () => void;
+/**
+ * dsh-mnemon's own registration of a shipped component's interface, kept for
+ * that component's versions that register none: at
+ * MNEMON_COMPONENT_FALLBACK_PRIORITY, so the component's own replaces it. Not
+ * part of `dsh-mnemon/client`.
+ */
+export declare function installMemoryComponentFallbackUI(ctx: MemoryComponentUIContext, contribution: MemoryComponentUIContribution): () => void;
 interface ComponentRegionDirectoryContext {
     slots: {
         getVersion(name: ComponentRegion): number;

package/lib/types/src/client/extension-sdk.d.ts

@@ -1,6 +1,10 @@
 export { installMemorySourceUI, memorySourcePageEntryId, MNEMON_SOURCE_PAGE_SLOT, MNEMON_SOURCE_CONFIGURATION_MUTATE, MNEMON_SOURCE_CONFIGURATION_READ, type MemorySourcePageComponent, type MemorySourcePageDefinition, type MemorySourcePageProps, type MemorySourceUIContribution, type MemorySourceUIContext, type MemorySourcePageNavigation, } from './source-pages.tsx';
 export type { MnemonSourceManagementClient, MemorySourcePageInstance } from './source-contracts.ts';
-export { installMemoryComponentUI, MNEMON_COMPONENT_SETTINGS_SLOT, MNEMON_COMPONENT_STATUS_SLOT, type MemoryComponentSettingsComponent, type MemoryComponentSettingsProps, type MemoryComponentStatusComponent, type MemoryComponentStatusProps, type MemoryComponentUIContext, type MemoryComponentUIContribution, } from './component-ui.tsx';
+export { installMemoryComponentUI, MNEMON_COMPONENT_FALLBACK_PRIORITY, MNEMON_COMPONENT_SETTINGS_SLOT, MNEMON_COMPONENT_STATUS_SLOT, type MemoryComponentConfigurationSnapshot, type MemoryComponentHost, type MemoryComponentSettingsComponent, type MemoryComponentSettingsProps, type MemoryComponentStatusComponent, type MemoryComponentStatusProps, type MemoryComponentUIContext, type MemoryComponentUIContribution, } from './component-ui.tsx';
+export { memorySettingsStyles, ToggleRow } from './settings-controls.tsx';
+export { PanelActions, useLive, useStaged, WriteFailure } from './settings-panel.tsx';
+export { Callout, Reveal } from './feedback.tsx';
+export { GlobalLocationSetting } from './GlobalLocationSetting.tsx';
 export * from './page-kit.tsx';
 export * from './page-controls.tsx';
 export * from './page-client.tsx';

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

@@ -0,0 +1,65 @@
+import { type JSX, type ReactNode } from 'react';
+import { type StateDotState } from '@deepseek-ai/dsh-client-ui-primitives';
+/** One transient announcement, shown as DSH's own toast. */
+export interface MnemonToast {
+    text: string;
+    /** `success` carries DSH's check, `warning` a warning glyph, `info` no glyph. */
+    tone: 'success' | 'warning' | 'info';
+    /** Inline actions continuing the sentence, such as Undo or Show. */
+    actions?: ReadonlyArray<{
+        label: string;
+        run: () => void;
+    }>;
+}
+/** One toast at a time: a newer announcement replaces the one on screen. */
+export declare function useToast(): {
+    show: (toast: MnemonToast) => void;
+    element: ReactNode;
+};
+/**
+ * Content that slides open when it appears and closed when it goes, so a note
+ * never pushes the page at once. Closing content stays readable while it
+ * leaves but is hidden from assistive technology and the pointer.
+ */
+export declare function Reveal({ children, className }: {
+    children: ReactNode;
+    className?: string | undefined;
+}): JSX.Element | null;
+/** The attribute marking what a change touched, so the page can point at it. */
+export declare const TARGET = "data-mnemon-target";
+/**
+ * Point at what a change touched: briefly tint the matching elements, and
+ * scroll the first into view when asked to.
+ * @param root the element to search within.
+ * @param targets values of {@link TARGET}.
+ */
+export declare function locate(root: HTMLElement | null, targets: readonly string[], options?: {
+    scroll?: boolean;
+}): void;
+/** How a state reads at a glance: DSH's state dots. */
+export type MnemonTone = StateDotState;
+/**
+ * A state the user should notice, with the actions that resolve it: a state
+ * dot, a short title, one line of detail and the buttons.
+ */
+export declare function Callout(props: {
+    tone: MnemonTone;
+    title: ReactNode;
+    children?: ReactNode;
+    actions?: ReactNode;
+    className?: string | undefined;
+    live?: boolean;
+}): JSX.Element;
+/**
+ * A button whose own label says when its write is running, so the result of
+ * a press shows where the press happened.
+ */
+export declare function ActionButton(props: {
+    label: string;
+    pendingLabel?: string;
+    pending?: boolean;
+    disabled?: boolean;
+    primary?: boolean;
+    ariaLabel?: string;
+    onClick: () => void;
+}): JSX.Element;

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

@@ -8,18 +8,6 @@ export declare const zh: {
     'common.loading': string;
     'common.cancel': string;
     'common.close': string;
-    'common.copyId': string;
-    'common.readOnly': string;
-    'common.activationOnly': string;
-    'common.active': string;
-    'common.inactive': string;
-    'common.category': string;
-    'common.importanceLabel': string;
-    'common.importance': string;
-    'common.hops': string;
-    'common.allCategories': string;
-    'common.memories': string;
-    'common.edges': string;
     'common.showing': string;
     'common.showMore': string;
     'header.backToConversation': string;
@@ -60,15 +48,6 @@ export declare const zh: {
     'sourcePage.secretPlaceholder': string;
     'sourcePage.unavailable': string;
     'sourcePage.unavailableDescription': string;
-    'config.providerSecretShow': string;
-    'config.providerSecretHide': string;
-    'config.providerSecretStoredValue': string;
-    'card.confirmText': string;
-    'card.processing': string;
-    'card.confirmForget': string;
-    'card.related': string;
-    'card.clone': string;
-    'card.forget': string;
     'turnTail.label': string;
     'turnTail.recall': string;
     'turnTail.write': string;
@@ -104,6 +83,7 @@ export declare const zh: {
     'receipt.view': string;
     'receipt.viewRuntime': string;
     'receipt.unembedded': string;
+    'receipt.unembeddedNoService': string;
     'taskAgent.ready': string;
     'taskAgent.unavailable': string;
     'saveAction.button': string;
@@ -143,29 +123,6 @@ export declare const zh: {
     'saveAction.place.userTooLong': string;
     'saveAction.place.userFull': string;
     'saveAction.noPlace': string;
-    'readSources.all': string;
-    'readSources.mode.search': string;
-    'readSources.mode.graph': string;
-    'readSources.mode.projection': string;
-    'readSources.mode.enumerable': string;
-    'readSources.mode.query-only': string;
-    'readSources.mode.entities': string;
-    'readSources.mode.unsupported': string;
-    'readSources.status.ready': string;
-    'readSources.status.empty': string;
-    'readSources.status.query-required': string;
-    'readSources.status.unsupported': string;
-    'readSources.status.unavailable': string;
-    'readSources.edges': string;
-    'readSources.model.mnemon-native': string;
-    'readSources.model.openviking': string;
-    'readSources.model.honcho': string;
-    'readSources.model.mem0': string;
-    'readSources.model.hindsight': string;
-    'readSources.model.holographic': string;
-    'readSources.model.retaindb': string;
-    'readSources.model.byterover': string;
-    'readSources.model.supermemory': string;
     'status.title': string;
     'status.description': string;
     'status.nominal': string;
@@ -396,11 +353,6 @@ export declare const zh: {
     'config.useStrategy': string;
     'config.stopStrategies': string;
     'config.enableComponentNamed': string;
-    'config.providersSpacesOffTitle': string;
-    'config.providersSpacesOffDetail': string;
-    'config.providersSpacesOn': string;
-    'config.providersReadOnlyTitle': string;
-    'config.providersReadOnlyDetail': string;
     'board.title': string;
     'board.description': string;
     'board.loading': string;
@@ -450,7 +402,6 @@ export declare const zh: {
     'details.currentMain': string;
     'details.useMain': string;
     'details.back': string;
-    'spaces.offNote': string;
     'threeTier.offNote': string;
     'board.otherEnhancements': string;
     'board.more': string;
@@ -516,80 +467,9 @@ export declare const zh: {
     'layers.memoryOffTitle': string;
     'layers.memoryOffDescription': string;
     'layers.memoryOffText': string;
-    'config.providersTitle': string;
-    'config.providersDescription': string;
     'config.nativeName': string;
-    'config.nativeSummary': string;
-    'config.officialNative': string;
-    'config.nativeCliMissing': string;
-    'config.embeddingTitle': string;
-    'config.embeddingDescription': string;
-    'config.embeddingManaged': string;
-    'config.embeddingManagedHint': string;
-    'config.embeddingEndpoint': string;
-    'config.embeddingModel': string;
-    'config.embeddingApiKey': string;
-    'config.embeddingApiKeyInvalid': string;
-    'config.embeddingProtocol': string;
-    'config.embeddingProtocolAuto': string;
-    'config.embeddingProtocolOllama': string;
-    'config.embeddingProtocolOpenai': string;
-    'config.embeddingProtocolInvalid': string;
-    'config.embeddingEndpointInvalid': string;
-    'config.embeddingModelInvalid': string;
-    'config.embeddingSecurity': string;
-    'config.embeddingTest': string;
-    'config.embeddingNotTested': string;
-    'config.embeddingTesting': string;
-    'config.embeddingSaveBeforeTest': string;
-    'config.embeddingTestUnavailable': string;
-    'config.embeddingCliMissing': string;
-    'config.embeddingStatusAvailable': string;
-    'config.embeddingStatusAvailableWithProtocol': string;
-    'config.embeddingStatusUnavailable': string;
-    'config.embeddingStatusUnavailableWithProtocol': string;
-    'config.embeddingStatusFailed': string;
-    'config.embeddingSpaces': string;
-    'config.embeddingSpaceCounts': string;
-    'config.embeddingSpaceFailed': string;
-    'config.embeddingMissing': string;
-    'config.embeddingMissingFill': string;
-    'config.embeddingMissingOffline': string;
-    'config.embeddingSpacesUnread': string;
-    'config.embeddingFill': string;
-    'config.embeddingFilling': string;
-    'config.embeddingFillLabel': string;
-    'config.embeddingFillingLabel': string;
-    'config.embeddingFillDone': string;
-    'config.embeddingFillMore': string;
-    'config.embeddingFillPartly': string;
-    'config.embeddingFillRefused': string;
-    'config.embeddingFillFailed': string;
-    'config.providerGlobalLocation': string;
-    'config.providerGlobalLocationHint': string;
-    'config.providerGlobalLocationWorkspaceHint': string;
-    'config.providerDefaultLocation': string;
-    'config.providerSaveFailed': string;
-    'config.providerServiceTitle': string;
-    'config.providerServiceHint': string;
-    'config.providerEnableHint': string;
-    'config.providerEnabled': string;
-    'config.providerDisabled': string;
-    'config.providerDisabledConfigured': string;
-    'config.providerNeedsConfiguration': string;
-    'config.providerToggleAria': string;
-    'config.providerToggleFailed': string;
-    'config.enableProvider': string;
-    'config.providerServiceSaved': string;
-    'config.saveProviderService': string;
-    'config.providerUnavailable': string;
-    'config.saveScopeBeforeProviders': string;
     'config.backgroundTitle': string;
     'config.backgroundDescription': string;
-    'config.providerTargetWorkspace': string;
-    'config.loadingProviders': string;
-    'config.providerLoadFailed': string;
-    'config.retryProviders': string;
     'config.taskAgentTitle': string;
     'config.taskAgentInherit': string;
     'config.taskAgentInheritHint': string;
@@ -616,7 +496,6 @@ export declare const zh: {
     'config.remoteReadOnly': string;
     'config.unavailable': string;
     'config.discard': string;
-    'config.saving': string;
     'config.interactionTurnBar': string;
     'config.interactionTurnBarHint': string;
     'config.interactionSaveAction': string;
@@ -658,6 +537,11 @@ export declare const zh: {
     'config.syncNoCredentialToken': string;
     'config.syncIssueAuthHttps': string;
     'config.syncIssueAuthToken': string;
+    'config.syncIssueRejectedGitHub': string;
+    'config.syncIssueRejectedGitHubToken': string;
+    'config.syncIssueRejectedGitHubEnvironment': string;
+    'config.syncIssueRejected': string;
+    'config.syncIssueRejectedEnvironment': string;
     'config.syncIssueAuthSsh': string;
     'config.syncIssueAuth': string;
     'config.syncIssueNotFound': string;
@@ -1235,6 +1119,128 @@ export declare const zh: {
     "overview.rediscoveryTimedOut": string;
     "overview.rediscoveryDismiss": string;
     "overview.newSpace": string;
+    "common.copyId": string;
+    "common.readOnly": string;
+    "common.activationOnly": string;
+    "common.active": string;
+    "common.category": string;
+    "common.importanceLabel": string;
+    "common.importance": string;
+    "common.hops": string;
+    "common.allCategories": string;
+    "common.memories": string;
+    "common.edges": string;
+    "card.confirmText": string;
+    "card.processing": string;
+    "card.confirmForget": string;
+    "card.related": string;
+    "card.clone": string;
+    "card.forget": string;
+    "readSources.all": string;
+    "readSources.mode.search": string;
+    "readSources.mode.graph": string;
+    "readSources.mode.projection": string;
+    "readSources.mode.enumerable": string;
+    "readSources.mode.query-only": string;
+    "readSources.mode.entities": string;
+    "readSources.mode.unsupported": string;
+    "readSources.status.ready": string;
+    "readSources.status.empty": string;
+    "readSources.status.query-required": string;
+    "readSources.status.unsupported": string;
+    "readSources.status.unavailable": string;
+    "readSources.edges": string;
+    "readSources.model.mnemon-native": string;
+    "readSources.model.openviking": string;
+    "readSources.model.honcho": string;
+    "readSources.model.mem0": string;
+    "readSources.model.hindsight": string;
+    "readSources.model.holographic": string;
+    "readSources.model.retaindb": string;
+    "readSources.model.byterover": string;
+    "readSources.model.supermemory": string;
+    "common.inactive": string;
+    "config.providerSecretShow": string;
+    "config.providerSecretHide": string;
+    "config.providerSecretStoredValue": string;
+    "config.providersSpacesOffTitle": string;
+    "config.providersSpacesOffDetail": string;
+    "config.providersSpacesOn": string;
+    "config.providersReadOnlyTitle": string;
+    "config.providersReadOnlyDetail": string;
+    "spaces.offNote": string;
+    "config.providersTitle": string;
+    "config.providersDescription": string;
+    "config.nativeSummary": string;
+    "config.officialNative": string;
+    "config.nativeCliMissing": string;
+    "config.embeddingTitle": string;
+    "config.embeddingDescription": string;
+    "config.embeddingManaged": string;
+    "config.embeddingManagedHint": string;
+    "config.embeddingEndpoint": string;
+    "config.embeddingModel": string;
+    "config.embeddingApiKey": string;
+    "config.embeddingApiKeyInvalid": string;
+    "config.embeddingProtocol": string;
+    "config.embeddingProtocolAuto": string;
+    "config.embeddingProtocolOllama": string;
+    "config.embeddingProtocolOpenai": string;
+    "config.embeddingProtocolInvalid": string;
+    "config.embeddingEndpointInvalid": string;
+    "config.embeddingModelInvalid": string;
+    "config.embeddingSecurity": string;
+    "config.embeddingTest": string;
+    "config.embeddingNotTested": string;
+    "config.embeddingTesting": string;
+    "config.embeddingSaveBeforeTest": string;
+    "config.embeddingTestUnavailable": string;
+    "config.embeddingCliMissing": string;
+    "config.embeddingStatusAvailable": string;
+    "config.embeddingStatusAvailableWithProtocol": string;
+    "config.embeddingStatusUnavailable": string;
+    "config.embeddingStatusUnavailableWithProtocol": string;
+    "config.embeddingStatusFailed": string;
+    "config.embeddingSpaces": string;
+    "config.embeddingSpaceCounts": string;
+    "config.embeddingSpaceFailed": string;
+    "config.embeddingMissing": string;
+    "config.embeddingMissingFill": string;
+    "config.embeddingMissingOffline": string;
+    "config.embeddingSpacesUnread": string;
+    "config.embeddingFill": string;
+    "config.embeddingFilling": string;
+    "config.embeddingFillLabel": string;
+    "config.embeddingFillingLabel": string;
+    "config.embeddingFillDone": string;
+    "config.embeddingFillMore": string;
+    "config.embeddingFillPartly": string;
+    "config.embeddingFillRefused": string;
+    "config.embeddingFillFailed": string;
+    "config.providerGlobalLocation": string;
+    "config.providerGlobalLocationHint": string;
+    "config.providerGlobalLocationWorkspaceHint": string;
+    "config.providerDefaultLocation": string;
+    "config.providerSaveFailed": string;
+    "config.providerServiceTitle": string;
+    "config.providerServiceHint": string;
+    "config.providerEnableHint": string;
+    "config.providerEnabled": string;
+    "config.providerDisabled": string;
+    "config.providerDisabledConfigured": string;
+    "config.providerNeedsConfiguration": string;
+    "config.providerToggleAria": string;
+    "config.providerToggleFailed": string;
+    "config.enableProvider": string;
+    "config.providerServiceSaved": string;
+    "config.saveProviderService": string;
+    "config.providerUnavailable": string;
+    "config.saveScopeBeforeProviders": string;
+    "config.providerTargetWorkspace": string;
+    "config.loadingProviders": string;
+    "config.providerLoadFailed": string;
+    "config.retryProviders": string;
+    "config.saving": string;
     "nav.documents": string;
     "documents.title": string;
     "documents.description": string;

package/lib/types/src/client/page-controls.d.ts

@@ -48,6 +48,13 @@ export declare function WriteReceipt(props: {
     summary?: string | undefined;
     error?: string | undefined;
     unembedded?: boolean | undefined;
+    /**
+     * Whether DSH manages the Mnemon Native embedding settings. Left at their
+     * default (`false`), they set up no embedding service, so a memory without a
+     * vector gets a neutral note; managed, or when this is omitted, it gets the
+     * caution that embedding did not succeed.
+     */
+    embeddingManaged?: boolean | undefined;
     t?: MnemonTranslate | undefined;
     onView?: (() => void) | undefined;
     viewLabel?: string | undefined;

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

@@ -0,0 +1,66 @@
+import { type JSX, type ReactNode } from 'react';
+/**
+ * The configuration's class names that Memory Spaces' own settings use, so they
+ * draw as the shipped settings do. They are API: an installed Memory Spaces,
+ * older or newer than this Starter, looks its classes up by these names, so
+ * renaming or removing one unstyles it.
+ */
+export declare const MEMORY_SETTINGS_CLASS_NAMES: readonly ["configFeedback", "editor", "editorHeading", "editorNote", "embeddingFillOutcome", "embeddingSpaceCount", "embeddingSpaceName", "embeddingSpaceState", "embeddingSpaces", "embeddingTest", "error", "fieldGrid", "groupCallout", "memoryConfigFooter", "packSuccess", "panelHeading", "panelNote", "panelSection", "providerBoolean", "providerChevron", "providerDisclosure", "providerEnableControl", "providerFieldControl", "providerIdentity", "providerInlineBody", "providerList", "providerLoadError", "providerLocationField", "providerMark", "providerRow", "providerRowHeader", "providerScopeTag", "providerSecretInput", "providerSecretVisibility", "providerServiceFooter", "providerServiceForm", "providerServiceLocation", "providerServicePrompt", "providerSettingsGrid", "providerState", "providerTarget", "providerToggle", "providerToggleError", "scopeChanging", "visuallyHidden"];
+export type MemorySettingsClass = typeof MEMORY_SETTINGS_CLASS_NAMES[number];
+/** The configuration's class map, by the names in MEMORY_SETTINGS_CLASS_NAMES. */
+export declare const memorySettingsStyles: Readonly<Record<MemorySettingsClass, string>>;
+/** One option of a settings selector; the detail explains it in the menu and under the row title. */
+export interface SettingOption<T extends string> {
+    value: T;
+    label: string;
+    detail?: string;
+    disabled?: boolean;
+}
+/**
+ * A DSH preference row: title and hint on the left, one control on the right.
+ * Shared by Mnemon Settings and the Plugins page composition.
+ */
+export declare function SettingRow(props: {
+    title: string;
+    titleId?: string | undefined;
+    hint?: ReactNode;
+    htmlFor?: string | undefined;
+    children?: ReactNode;
+    stacked?: boolean | undefined;
+    target?: string | undefined;
+}): JSX.Element;
+/** The DSH settings selector: a gray button that opens a Menu of the options. */
+export declare function SettingSelect<T extends string>(props: {
+    labelledBy: string;
+    value: T;
+    options: readonly SettingOption<T>[];
+    disabled?: boolean | undefined;
+    onChange: (value: T) => void;
+}): JSX.Element;
+/** A row whose control is a selector; the chosen option's detail doubles as the hint. */
+export declare function SelectRow<T extends string>(props: {
+    id: string;
+    label: string;
+    hint?: string | undefined;
+    value: T;
+    options: readonly SettingOption<T>[];
+    disabled?: boolean | undefined;
+    target?: string | undefined;
+    onChange: (value: T) => void;
+}): JSX.Element;
+/**
+ * A row whose control is the DSH Switch. A note under the hint states what the
+ * switch depends on and offers what resolves it; it slides in and out.
+ */
+export declare function ToggleRow(props: {
+    id: string;
+    label: string;
+    titleId?: string | undefined;
+    hint: string;
+    checked: boolean;
+    disabled: boolean;
+    ariaLabel?: string | undefined;
+    note?: ReactNode;
+    target?: string | undefined;
+    onChange: (value: boolean) => void;
+}): JSX.Element;