dsh-hypatia-auto-memory 0.1.0

package/src/client/locales.ts

@@ -0,0 +1,111 @@
+/** `hypatia-auto-memory` namespace dictionaries. */
+
+/** Dictionary namespace owned by this plugin. */
+export const NS = 'hypatia-auto-memory'
+
+/** Simplified Chinese dictionary and key source of truth. */
+export const zh = {
+  loading: '正在加载 {ns} 设置…',
+  unavailable: '当前上下文不可用 {ns} 设置。',
+  title: 'Hypatia Auto Memory',
+  description:
+    '自动将对话轮次记录到 Hypatia，并在新内容足够多时通过独立模型路由进行后台整合。',
+  enable: '启用自动记忆',
+  autoApprove: '自动批准模型发起的 hypatia 命令',
+  autoApproveHint: '仅限不含管道、重定向、命令串联的纯 hypatia 调用；插件自身的写入不经过此路径。关闭后模型每次检索都会弹出批准框。修改后需重载配置档生效。',
+  shelf: '记忆写入的 shelf',
+  shelfHint: '插件的记录、整合与会话开始时的规则预加载都读写这个 shelf；不是 default 时，会话开头会提示模型为 hypatia 命令加上 --shelf。修改后需重载配置档生效。每个 shelf 的记录进度单独保存，切回原来的 shelf 会从上次的位置继续；切到新的 shelf 后，每个有活动的会话会把完整历史重新记录进去并整合一遍（会消耗模型调用）。列表来自 hypatia list，约每分钟刷新一次。',
+  shelfLoading: '正在读取 hypatia list…',
+  shelfLoadFailed: '无法读取 shelf 列表。',
+  shelfListingFailed: 'hypatia list 执行失败，列表可能已过时：{message}',
+  shelfDisconnected: '未连接',
+  shelfOptionStatus: '（{status}）',
+  shelfNotListed: '不在 hypatia list 中',
+  shelfDisconnectedWarning: 'shelf {shelf} 已注册但未连接，写入会失败。',
+  shelfNotListedWarning: 'hypatia 没有注册 shelf {shelf}，写入会失败；请先执行 hypatia connect <目录> --name {shelf}。',
+  consolidationTitle: '整合候选模型',
+  modelSelectionHint: '选择一个或多个模型。每次整合尝试（含重试）会按所选顺序轮转；未选择时只记录对话，不执行整合。',
+  modelCatalogLoading: '正在读取可用模型…',
+  modelCatalogFailed: '无法读取可用模型。',
+  modelCatalogPartial: '部分提供方未能返回模型目录。',
+  modelCatalogEmpty: '当前没有可选择的模型。',
+  selectedModels: '用于轮转的模型',
+  unavailableModels: '不可用或未再声明的模型',
+  modelUnavailable: '当前不可用',
+  retry: '重试',
+  checkEveryTurns: '两次整合至少间隔 N 轮',
+  minNewTokens: '最小新增 token 数',
+  cascadeBatchSize: '归档批量',
+  dedupMaxDistance: '关联距离上限',
+  cascadeHint: '每积累这么多同层摘要，就归档为上一层的一条；关联距离上限决定新记忆要多接近既有条目才值得判定关系。',
+  limitsTitle: '单次整合体量',
+  limitsHint: '输入预算决定送入模型的对话长度（超出部分截断保留最近内容）；输出预算需容纳摘要与全部工作单元，过小会导致整合失败。',
+  maxInputTokens: '输入预算（token）',
+  maxOutputTokens: '输出预算（token）',
+  maxWorkUnitsPerRun: '每次最多提取工作单元数',
+  recallPreload: '召回：会话开始时预加载规则与禁忌',
+  advancedHint:
+    '高级字段（二进制、收集器上限、队列调优）可直接在 settings.yaml 的 {ns} 键下编辑。',
+  reset: '重置',
+  discard: '放弃',
+  save: '保存',
+  saving: '保存中…',
+  saveFailed: '保存失败：{message}',
+  readOnly: '只读：当前上下文不可写入设置文档。',
+  unsaved: '未保存',
+} as const satisfies Record<string, string>
+
+/** Key domain of the `hypatia-auto-memory` namespace. */
+export type AutoMemoryLocaleKey = keyof typeof zh
+
+/** English dictionary checked against the Chinese key set. */
+export const en = {
+  loading: 'Loading {ns} settings…',
+  unavailable: '{ns} settings are not available in this context.',
+  title: 'Hypatia Auto Memory',
+  description:
+    'Auto-memory logs conversation turns into Hypatia and runs background consolidation on a dedicated model route.',
+  enable: 'Enable auto-memory',
+  autoApprove: "Auto-approve the agent's own hypatia commands",
+  autoApproveHint: 'Only plain hypatia calls with no pipe, redirect or chaining; this plugin\'s own writes never take that path. With it off, every retrieval raises an approval prompt. Takes effect after a profile reload.',
+  shelf: 'Memory shelf',
+  shelfHint: 'Logging, consolidation and the session-start rules preload all read and write this shelf; when it is not default, each session is told to pass --shelf to its hypatia commands. Takes effect after a profile reload. Progress is kept per shelf, so switching back resumes where that shelf left off; on a new shelf, each session is logged from its start the next time it is active, and consolidated again (model calls). Choices come from hypatia list, refreshed about once a minute.',
+  shelfLoading: 'Reading hypatia list…',
+  shelfLoadFailed: 'Unable to load the shelf list.',
+  shelfListingFailed: 'hypatia list failed; the list may be stale: {message}',
+  shelfDisconnected: 'not connected',
+  shelfOptionStatus: ' ({status})',
+  shelfNotListed: 'not in hypatia list',
+  shelfDisconnectedWarning: 'Shelf {shelf} is registered but not connected; writes will fail.',
+  shelfNotListedWarning: 'hypatia has no shelf named {shelf}; writes will fail until you run hypatia connect <dir> --name {shelf}.',
+  consolidationTitle: 'Consolidation candidate models',
+  modelSelectionHint: 'Choose one or more models. Every consolidation attempt, including a retry, rotates through this order; without a selection, conversations continue logging but consolidation stays idle.',
+  modelCatalogLoading: 'Loading available models…',
+  modelCatalogFailed: 'Unable to load available models.',
+  modelCatalogPartial: 'Some providers did not return a model catalog.',
+  modelCatalogEmpty: 'No models are currently available.',
+  selectedModels: 'Models used for rotation',
+  unavailableModels: 'Unavailable or no longer advertised',
+  modelUnavailable: 'Unavailable',
+  retry: 'Retry',
+  checkEveryTurns: 'Minimum turns between consolidations',
+  minNewTokens: 'Min new tokens',
+  cascadeBatchSize: 'Archive batch',
+  dedupMaxDistance: 'Relation distance',
+  cascadeHint: 'Every batch of same-tier summaries is archived into one entry a tier up. Relation distance is how near a new memory must be to an existing one to be worth judging a relationship.',
+  limitsTitle: 'Per-run consolidation size',
+  limitsHint: 'The input budget caps how much conversation is sent to the model (overflow keeps the most recent content); the output budget must fit the summary plus every work unit — too small and consolidation fails.',
+  maxInputTokens: 'Input budget (tokens)',
+  maxOutputTokens: 'Output budget (tokens)',
+  maxWorkUnitsPerRun: 'Max work units per run',
+  recallPreload: 'Recall: preload rules & taboos at session start',
+  advancedHint:
+    'Advanced fields (binaries, collector caps, queue tuning) can be edited directly in settings.yaml under the {ns} key.',
+  reset: 'Reset',
+  discard: 'Discard',
+  save: 'Save',
+  saving: 'Saving…',
+  saveFailed: 'Save failed: {message}',
+  readOnly: 'Read-only: settings document is not writable in this context.',
+  unsaved: 'Unsaved',
+} satisfies Record<AutoMemoryLocaleKey, string>

package/src/client/shelves.ts

@@ -0,0 +1,88 @@
+/**
+ * Shelf choices for the settings card.
+ *
+ * The Host publishes `hypatia list` as the read-only `hypatia-auto-memory-shelves`
+ * settings namespace (see `src/config.js`); the card reads it through the
+ * settings descriptor. Zero runtime imports, so it is unit-tested under
+ * `node:test` like `card-form.ts`.
+ */
+
+/** Namespace the Host publishes the shelf listing under. */
+export const INVENTORY_NAMESPACE = 'hypatia-auto-memory-shelves'
+
+/** Shelf hypatia uses when none is named. */
+export const DEFAULT_SHELF = 'default'
+
+/** One shelf as `hypatia list` reports it. */
+export interface ShelfInfo {
+  name: string
+  path: string
+  connected: boolean
+}
+
+/** The Host's latest listing; `error` is non-empty when it could not list. */
+export interface ShelfInventory {
+  shelves: ShelfInfo[]
+  error: string
+}
+
+/** Load the Host's latest listing for the settings card. */
+export type LoadShelfInventory = () => Promise<ShelfInventory>
+
+/** One dropdown option. */
+export interface ShelfChoice {
+  name: string
+  path: string
+  /** False for a shelf that is registered but not connected. */
+  connected: boolean
+  /** False for a stored value the listing no longer reports. */
+  listed: boolean
+}
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null && !Array.isArray(value)
+}
+
+/**
+ * Pick the inventory namespace out of a settings descriptor.
+ *
+ * Reads the composition layer (`base`), which only the Host sets, rather than
+ * the resolved value: a stray user-layer section for this namespace would
+ * otherwise freeze the list.
+ * @param described - the `namespaces` array a settings `describe()` returns.
+ * @returns the listing, or undefined when the Host does not serve one.
+ */
+export function readShelfInventory(described: readonly unknown[]): ShelfInventory | undefined {
+  const view = described.find(entry => isRecord(entry) && entry.ns === INVENTORY_NAMESPACE)
+  if (!isRecord(view) || !isRecord(view.base)) return undefined
+  const { shelves, error } = view.base
+  return {
+    shelves: Array.isArray(shelves)
+      ? shelves.flatMap((shelf): ShelfInfo[] => isRecord(shelf) && typeof shelf.name === 'string'
+        ? [{
+            name: shelf.name,
+            path: typeof shelf.path === 'string' ? shelf.path : '',
+            connected: shelf.connected === true,
+          }]
+        : [])
+      : [],
+    error: typeof error === 'string' ? error : '',
+  }
+}
+
+/**
+ * Every shelf the dropdown offers: the listing, plus the stored and composed
+ * values when the listing does not carry them, so the current choice always
+ * renders and never silently changes to the first option.
+ * @param shelves - the Host's listing.
+ * @param keep - values that must stay selectable (current draft, stored, composed).
+ * @returns options, listed shelves first in listing order.
+ */
+export function shelfChoices(shelves: readonly ShelfInfo[], keep: readonly string[]): ShelfChoice[] {
+  const choices: ShelfChoice[] = shelves.map(shelf => ({ ...shelf, listed: true }))
+  for (const name of keep) {
+    if (name === '' || choices.some(choice => choice.name === name)) continue
+    choices.push({ name, path: '', connected: false, listed: false })
+  }
+  return choices
+}

package/src/client/slot-contract.ts

@@ -0,0 +1,17 @@
+/**
+ * Type-only slot contract: this plugin contributes one card under
+ * `settings.plugin.item`, keyed by its settings namespace.
+ *
+ * The slot itself is declared by `@deepseek-ai/dsh-client-ui-settings-plugins`;
+ * we only need the type merges so TypeScript knows what `ctx.slots.register`
+ * expects here and what locale namespace the card consumes.
+ */
+import type {} from '@deepseek-ai/dsh-client-ui-slots'
+import type { AutoMemoryLocaleKey } from './locales'
+
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+  interface LocaleNamespaceMap {
+    /** Settings card copy for dsh-hypatia-auto-memory. */
+    'hypatia-auto-memory': AutoMemoryLocaleKey
+  }
+}