@dsh-cove/dsh-web-all 0.0.0-stage → 0.4.3

package/lib/types/host/services/lark-inbox/wizard.js

@@ -0,0 +1,211 @@
+/** Host-side lark-cli credential wizard. */
+import { spawn as nodeSpawn } from 'node:child_process';
+import { mkdir } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+export class WizardSettingsUnavailableError extends Error {
+    code = 'WIZARD_SETTINGS_UNAVAILABLE';
+    constructor() {
+        super('dsh-lark-inbox: settings 服务不可用，无法写入飞书凭据');
+        this.name = 'WizardSettingsUnavailableError';
+    }
+}
+const INSTALL_HINT = '未找到 lark-cli，请先安装：npm i -g @larksuite/cli';
+function extractVerificationUrl(text) {
+    const field = /["'](?:verification_uri_complete|verification_url)["']\s*[:=]\s*["']([^"']+)["']/i.exec(text);
+    if (field)
+        return field[1];
+    const bare = /https:\/\/open\.feishu\.cn\/[^\s"'<>]+/i.exec(text);
+    return bare && !bare[0].includes('wss:') && !bare[0].includes('console') ? bare[0] : undefined;
+}
+function extractOneTimeSecret(text) {
+    const context = /(?:app[_-]?secret|secret)["'\s:=]+/gi;
+    let match;
+    while ((match = context.exec(text)) !== null) {
+        const value = /^["']?([A-Za-z0-9._~\-]{8,})["']?/.exec(text.slice(match.index + match[0].length))?.[1];
+        if (value && !/^\*+$/.test(value))
+            return value;
+    }
+    return undefined;
+}
+function redactSecrets(text) {
+    return text.replace(/((?:app[_-]?secret|secret)["'\s:=]+)([A-Za-z0-9._~\-]{8,}|"?\*+"?)/gi, '$1[redacted]');
+}
+export async function writeWithConflictRetry(write) {
+    try {
+        await write();
+    }
+    catch (error) {
+        if (error?.code !== 'SETTINGS_CONFLICT')
+            throw error;
+        await write();
+    }
+}
+export class LarkWizard {
+    options;
+    cli;
+    qrDir;
+    spawn;
+    log;
+    current = { phase: 'idle' };
+    child;
+    constructor(options) {
+        this.options = options;
+        this.cli = options.larkCli ?? 'lark-cli';
+        this.qrDir = options.qrDir ?? join(process.env.TMPDIR ?? tmpdir(), 'dsh-lark-inbox-wizard');
+        this.spawn = options.spawn ?? ((command, args, spawnOptions) => nodeSpawn(command, args, spawnOptions));
+        this.log = options.log ?? (() => undefined);
+    }
+    state() { return this.current; }
+    async startNew() {
+        await this.cancel();
+        await mkdir(this.qrDir, { recursive: true });
+        let resolveUrl;
+        let rejectUrl;
+        const urlSeen = new Promise((resolve, reject) => { resolveUrl = resolve; rejectUrl = reject; });
+        const child = this.spawn(this.cli, ['config', 'init', '--new'], { stdio: ['ignore', 'pipe', 'pipe'], cwd: this.qrDir, shell: false });
+        this.child = child;
+        let stdout = '';
+        let stderr = '';
+        let settled = false;
+        child.stdout?.on('data', chunk => {
+            stdout += String(chunk);
+            const url = extractVerificationUrl(stdout);
+            if (url !== undefined && !settled) {
+                settled = true;
+                resolveUrl(url);
+            }
+        });
+        child.stderr?.on('data', chunk => { stderr += String(chunk); });
+        child.on('error', (error) => {
+            if (this.child === child)
+                this.child = undefined;
+            const message = error.code === 'ENOENT' ? INSTALL_HINT : `lark-cli 启动失败：${redactSecrets(error.message)}`;
+            this.current = { phase: 'failed', error: message };
+            if (!settled) {
+                settled = true;
+                rejectUrl(new Error(message));
+            }
+        });
+        child.on('exit', (code, signal) => {
+            if (this.child === child)
+                this.child = undefined;
+            if (!settled) {
+                settled = true;
+                rejectUrl(new Error('lark-cli 未输出授权链接即退出'));
+                return;
+            }
+            void this.completeInit(code, signal, stdout, stderr);
+        });
+        const verificationUrl = await urlSeen;
+        let qrFilePath = null;
+        try {
+            if (await this.generateQr(verificationUrl))
+                qrFilePath = join(this.qrDir, 'qr.png');
+        }
+        catch {
+            qrFilePath = null;
+        }
+        if (this.child === child)
+            this.current = { phase: 'awaiting-browser', mode: 'new', verificationUrl, qrFilePath };
+        return { verificationUrl, qrFilePath };
+    }
+    startBind(appId) {
+        const consoleUrl = `https://open.feishu.cn/app/${appId}`;
+        this.current = { phase: 'awaiting-secret', mode: 'bind', appId, consoleUrl };
+        return { consoleUrl };
+    }
+    async finishBind(appSecret) {
+        const secret = appSecret.trim();
+        if (secret === '') {
+            const error = new Error('appSecret 不能为空');
+            this.current = { phase: 'failed', error: error.message };
+            throw error;
+        }
+        const current = this.current;
+        if (current.phase !== 'awaiting-secret') {
+            const error = new Error('当前不在绑定流程，请先调用 startBind');
+            this.current = { phase: 'failed', error: error.message };
+            throw error;
+        }
+        try {
+            await this.options.settingsWrite({ appId: current.appId, appSecret: secret });
+            this.current = { phase: 'done', appId: current.appId, needsSecretPaste: false };
+            this.log('info', 'dsh-lark-inbox: 已绑定飞书应用并写入凭据');
+        }
+        catch (error) {
+            this.current = { phase: 'failed', error: redactSecrets(error instanceof Error ? error.message : String(error)) };
+            throw error;
+        }
+    }
+    async cancel() {
+        const child = this.child;
+        this.child = undefined;
+        if (child) {
+            try {
+                child.kill('SIGTERM');
+            }
+            catch { /* already exited */ }
+        }
+        this.current = { phase: 'idle' };
+    }
+    generateQr(url) {
+        return new Promise(resolve => {
+            const child = this.spawn(this.cli, ['auth', 'qrcode', url, '--output', 'qr.png'], { stdio: ['ignore', 'ignore', 'ignore'], cwd: this.qrDir, shell: false });
+            child.on('error', () => resolve(false));
+            child.on('exit', code => resolve(code === 0));
+        });
+    }
+    async completeInit(code, signal, stdout, stderr) {
+        if (signal)
+            return;
+        if (code !== 0) {
+            const tail = stderr.trim() === '' ? `lark-cli config init 退出码 ${code ?? 'null'}` : stderr.slice(-400);
+            this.current = { phase: 'failed', error: redactSecrets(tail) };
+            return;
+        }
+        try {
+            const appId = await this.configShowAppId();
+            const secret = extractOneTimeSecret(stdout);
+            if (secret !== undefined) {
+                await this.options.settingsWrite({ appId, appSecret: secret });
+                this.current = { phase: 'done', appId, needsSecretPaste: false };
+                this.log('info', 'dsh-lark-inbox: 已创建飞书应用并写入凭据');
+            }
+            else {
+                await this.options.settingsWrite({ appId });
+                this.current = { phase: 'done', appId, needsSecretPaste: true };
+                this.log('info', 'dsh-lark-inbox: 已写入 appId，仍需粘贴 appSecret');
+            }
+        }
+        catch (error) {
+            this.current = { phase: 'failed', error: redactSecrets(error instanceof Error ? error.message : String(error)) };
+        }
+    }
+    configShowAppId() {
+        return new Promise((resolve, reject) => {
+            const child = this.spawn(this.cli, ['config', 'show'], { stdio: ['ignore', 'pipe', 'pipe'], cwd: this.qrDir, shell: false });
+            let stdout = '';
+            let stderr = '';
+            child.stdout?.on('data', chunk => { stdout += String(chunk); });
+            child.stderr?.on('data', chunk => { stderr += String(chunk); });
+            child.on('error', (error) => reject(new Error(redactSecrets(error.code === 'ENOENT' ? INSTALL_HINT : error.message))));
+            child.on('exit', code => {
+                if (code !== 0) {
+                    reject(new Error(redactSecrets(stderr.trim() === '' ? `lark-cli config show 退出码 ${code ?? 'null'}` : stderr.slice(-400))));
+                    return;
+                }
+                try {
+                    const parsed = JSON.parse(stdout);
+                    if (typeof parsed.appId === 'string' && parsed.appId !== '') {
+                        resolve(parsed.appId);
+                        return;
+                    }
+                }
+                catch { /* regex fallback */ }
+                const match = /"appId"\s*:\s*"([^"]+)"/.exec(stdout);
+                match ? resolve(match[1]) : reject(new Error('lark-cli config show 未返回 appId'));
+            });
+        });
+    }
+}

package/lib/types/host/services/lifecycle.d.ts

@@ -0,0 +1,29 @@
+/** Lifecycle owner for all host service-domain registrations in the web-all entity. */
+export type ServiceDisposer = () => void | Promise<void>;
+export interface ServiceRegistrationDiagnostic {
+    service: string;
+    phase: 'register' | 'dispose';
+    message: string;
+    error: unknown;
+    at: number;
+}
+export interface ServiceLifecycleOptions {
+    onDiagnostic?: (diagnostic: ServiceRegistrationDiagnostic) => void;
+    now?: () => number;
+}
+export interface ServiceLifecycleOwner {
+    readonly signal: AbortSignal;
+    readonly diagnostics: readonly ServiceRegistrationDiagnostic[];
+    mount(service: string, register: () => ServiceDisposer): void;
+    track(service: string, registration: Promise<ServiceDisposer>): void;
+    dispose(): Promise<void>;
+}
+/**
+ * Own sync and async service registrations under one deterministic lifetime.
+ * Async registrations that settle after disposal are torn down immediately;
+ * owner disposal aborts and awaits every tracked registration before returning.
+ */
+export declare function createServiceLifecycleOwner(options?: ServiceLifecycleOptions): ServiceLifecycleOwner;
+/** Reject promptly on owner abort without allowing the underlying task to register late resources. */
+export declare function abortable<T>(operation: Promise<T>, signal?: AbortSignal): Promise<T>;
+//# sourceMappingURL=lifecycle.d.ts.map

package/lib/types/host/services/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../../src/host/services/lifecycle.ts"],"names":[],"mappings":"AAAA,uFAAuF;AAEvF,MAAM,MAAM,eAAe,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAExD,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,UAAU,GAAG,SAAS,CAAA;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,uBAAuB;IACtC,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,6BAA6B,KAAK,IAAI,CAAA;IAClE,GAAG,CAAC,EAAE,MAAM,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,SAAS,6BAA6B,EAAE,CAAA;IAC9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,eAAe,GAAG,IAAI,CAAA;IAC7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI,CAAA;IACpE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAUD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,uBAA4B,GAAG,qBAAqB,CAyDxG;AAED,sGAAsG;AACtG,wBAAsB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAQ1F"}

package/lib/types/host/services/lifecycle.js

@@ -0,0 +1,93 @@
+/** Lifecycle owner for all host service-domain registrations in the web-all entity. */
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function isAbort(error) {
+    return error instanceof Error && (error.name === 'AbortError' || /aborted/i.test(error.message));
+}
+/**
+ * Own sync and async service registrations under one deterministic lifetime.
+ * Async registrations that settle after disposal are torn down immediately;
+ * owner disposal aborts and awaits every tracked registration before returning.
+ */
+export function createServiceLifecycleOwner(options = {}) {
+    const controller = new AbortController();
+    const diagnostics = [];
+    const disposers = [];
+    const pending = new Set();
+    let disposed = false;
+    let disposing;
+    const report = (service, phase, error) => {
+        const diagnostic = { service, phase, message: errorMessage(error), error, at: (options.now ?? Date.now)() };
+        diagnostics.push(diagnostic);
+        // Observability must never become a second failure that interrupts rollback.
+        try {
+            options.onDiagnostic?.(diagnostic);
+        }
+        catch { /* retained in diagnostics */ }
+    };
+    const runDisposer = async (service, dispose) => {
+        try {
+            await dispose();
+        }
+        catch (error) {
+            report(service, 'dispose', error);
+        }
+    };
+    const add = (service, dispose) => {
+        if (disposed) {
+            const late = runDisposer(service, dispose);
+            pending.add(late);
+            void late.finally(() => pending.delete(late));
+            return;
+        }
+        disposers.push({ service, dispose });
+    };
+    const owner = {
+        signal: controller.signal,
+        get diagnostics() { return diagnostics; },
+        mount(service, register) {
+            if (disposed)
+                return;
+            try {
+                add(service, register());
+            }
+            catch (error) {
+                report(service, 'register', error);
+            }
+        },
+        track(service, registration) {
+            const tracked = registration.then(dispose => { add(service, dispose); }, error => { if (!(disposed && isAbort(error)))
+                report(service, 'register', error); });
+            pending.add(tracked);
+            void tracked.finally(() => pending.delete(tracked));
+        },
+        dispose() {
+            if (disposing !== undefined)
+                return disposing;
+            disposed = true;
+            controller.abort(new DOMException('web-all service owner disposed', 'AbortError'));
+            disposing = (async () => {
+                while (pending.size > 0)
+                    await Promise.allSettled([...pending]);
+                for (const entry of disposers.splice(0).reverse())
+                    await runDisposer(entry.service, entry.dispose);
+                while (pending.size > 0)
+                    await Promise.allSettled([...pending]);
+            })();
+            return disposing;
+        },
+    };
+    return owner;
+}
+/** Reject promptly on owner abort without allowing the underlying task to register late resources. */
+export async function abortable(operation, signal) {
+    if (signal === undefined)
+        return operation;
+    signal.throwIfAborted();
+    return await new Promise((resolve, reject) => {
+        const abort = () => reject(signal.reason ?? new DOMException('aborted', 'AbortError'));
+        signal.addEventListener('abort', abort, { once: true });
+        void operation.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort));
+    });
+}

package/lib/types/host/services/memoir/index.d.ts

@@ -0,0 +1,40 @@
+/**
+ * memoir host 服务域（全新实现；行为契约参考旧包）。
+ *
+ * 记忆系统：store（按项目路径分键的条目存储）+ settings +
+ * /api/dsh-memoir/* 路由族 + agent 工具（memoir_record/read/update）。
+ * 注册入口 register(ctx, deps)，由 host 装配器统一调用。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { MemoirStore } from './store.ts';
+export { MemoirStore, type MemoirEntry, type SectionKey } from './store.ts';
+export { MemoirSettingsStore, type MemoirSettings } from './settings.ts';
+export declare const MEMOIR_GUIDANCE = "dsh-memoir \u63D0\u4F9B\u9879\u76EE\u6301\u4E45\u8BB0\u5FC6\u3002\u4E0B\u65B9\u4EC5\u6CE8\u5165\u672C\u9879\u76EE\u9AD8\u4F18\u5148\u7EA7\u8BB0\u5FC6\uFF1B\u9700\u8981\u5386\u53F2\u7EC6\u8282\u65F6\u8C03\u7528 memoir_read\uFF1B\u4EA7\u751F\u53EF\u590D\u7528\u7684\u5DE5\u4F5C\u7ED3\u8BBA\u3001\u7ECF\u9A8C\u6216\u540E\u7EED\u884C\u52A8\u65F6\u8C03\u7528 memoir_record\u3002";
+export declare const MEMOIR_SECTION_HEADING = "## \u9879\u76EE\u6301\u4E45\u8BB0\u5FC6\uFF08\u81EA\u52A8\u6CE8\u5165\uFF09";
+export declare const PROMPT_MEMORY_VARIABLE = "project_memory";
+export declare const PROMPT_MEMORY_REFERENCE = "{{project_memory}}";
+interface MemoirAssembleContext {
+    agent?: {
+        session?: {
+            header?: {
+                cwd?: string;
+            };
+        };
+    };
+}
+/** Build the variable value; raw memory never enters section text. */
+export declare function memoirVariableText(store: MemoirStore, context: MemoirAssembleContext, maxTokens: number): string;
+/** 服务域依赖。 */
+export interface MemoirServiceDeps {
+    /** 存储路径（默认 ~/.dsh/dsh-memoir.json）。 */
+    storePath?: string;
+    /** 设置路径（默认 ~/.dsh/dsh-memoir.settings.json）。 */
+    settingsPath?: string;
+    /** 日志。 */
+    logger?: {
+        warn(error: unknown): void;
+    };
+}
+/** 服务域注册入口；返回统一 disposer。 */
+export declare function register(ctx: Context, deps?: MemoirServiceDeps): () => void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/host/services/memoir/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/memoir/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAA;AAMzD,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AAC3E,OAAO,EAAE,mBAAmB,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAGxE,eAAO,MAAM,eAAe,0XAAkG,CAAA;AAC9H,eAAO,MAAM,sBAAsB,gFAAoB,CAAA;AACvD,eAAO,MAAM,sBAAsB,mBAAmB,CAAA;AACtD,eAAO,MAAM,uBAAuB,uBAAuB,CAAA;AAE3D,UAAU,qBAAqB;IAC7B,KAAK,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE;gBAAE,GAAG,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAA;CACpD;AAED,sEAAsE;AACtE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKhH;AAED,aAAa;AACb,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU;IACV,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;CACxC;AAED,6BAA6B;AAC7B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,IAAI,CA+B/E"}

package/lib/types/host/services/memoir/index.js

@@ -0,0 +1,52 @@
+import { MemoirStore, renderHotMemory } from "./store.js";
+import { MemoirSettingsStore } from "./settings.js";
+import { registerRoutes } from "./routes.js";
+import { makeMemoirTools } from "./tools.js";
+import { registerResources } from "../resources.js";
+export { MemoirStore } from "./store.js";
+export { MemoirSettingsStore } from "./settings.js";
+const SECTION_ORDER = 150;
+export const MEMOIR_GUIDANCE = 'dsh-memoir 提供项目持久记忆。下方仅注入本项目高优先级记忆；需要历史细节时调用 memoir_read；产生可复用的工作结论、经验或后续行动时调用 memoir_record。';
+export const MEMOIR_SECTION_HEADING = '## 项目持久记忆（自动注入）';
+export const PROMPT_MEMORY_VARIABLE = 'project_memory';
+export const PROMPT_MEMORY_REFERENCE = '{{project_memory}}';
+/** Build the variable value; raw memory never enters section text. */
+export function memoirVariableText(store, context, maxTokens) {
+    const cwd = context.agent?.session?.header?.cwd;
+    if (typeof cwd !== 'string' || cwd === '')
+        return MEMOIR_GUIDANCE;
+    const hot = renderHotMemory(store.project(cwd), maxTokens);
+    return hot === '' ? MEMOIR_GUIDANCE : `${MEMOIR_GUIDANCE}\n\n${MEMOIR_SECTION_HEADING}\n${hot}`;
+}
+/** 服务域注册入口；返回统一 disposer。 */
+export function register(ctx, deps = {}) {
+    const logger = deps.logger ?? { warn: (error) => { console.warn('[web-all:memoir]', error); } };
+    const store = new MemoirStore(deps.storePath);
+    const settingsStore = new MemoirSettingsStore(deps.settingsPath);
+    const settings = () => settingsStore.load();
+    const saveSettings = (value) => { settingsStore.save(value); };
+    return registerResources(own => {
+        own(registerRoutes(ctx, { store, settings, saveSettings, logger }));
+        for (const tool of makeMemoirTools(store, settings))
+            own(ctx.tools.register(tool));
+        let disposePrompt;
+        const syncPrompt = () => {
+            disposePrompt?.();
+            disposePrompt = undefined;
+            const current = settings();
+            if (!current.enabled || !current.announceToAgent)
+                return;
+            disposePrompt = registerResources(ownPrompt => {
+                ownPrompt(ctx.systemPrompt.variable(PROMPT_MEMORY_VARIABLE, context => memoirVariableText(store, context, settings().hotMemoryMaxTokens)));
+                ownPrompt(ctx.systemPrompt.section({
+                    name: 'plugin:dsh-memoir',
+                    order: SECTION_ORDER,
+                    text: PROMPT_MEMORY_REFERENCE,
+                }));
+            });
+        };
+        own(() => { disposePrompt?.(); });
+        own(settingsStore.subscribe(() => syncPrompt()));
+        syncPrompt();
+    });
+}

package/lib/types/host/services/memoir/routes.d.ts

@@ -0,0 +1,30 @@
+/**
+ * memoir host 服务域 —— 路由层（全新实现；行为契约参考旧包）。
+ *
+ * /api/dsh-memoir/* 前缀路由族（JSON envelope：{ok,value} / {ok,error}，
+ * 老 dsh-memoir 契约）：project / global / entries / search / hot-memory /
+ * diagnostics / settings。信任围栏为共享的宿主访问围栏（loopback，或部署声明的
+ * trusted authority + 已登录浏览器会话）。
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { WebRoute } from '@deepseek-ai/dsh-host-webserver';
+import type { IncomingMessage } from 'node:http';
+import { MemoirStore } from './store.ts';
+import type { MemoirSettings } from './settings.ts';
+export declare const MEMOIR_API_PREFIX = "/api/dsh-memoir";
+interface MemoirRoutesDeps {
+    store: MemoirStore;
+    settings(): MemoirSettings;
+    saveSettings(settings: MemoirSettings): void;
+    logger: {
+        warn(error: unknown): void;
+    };
+    /** Host access fence; defaults to the strict loopback rule. */
+    isTrusted?(req: IncomingMessage): boolean;
+}
+/** 构建 /api/dsh-memoir 前缀路由。 */
+export declare function makeMemoirRoutes(deps: MemoirRoutesDeps): WebRoute[];
+/** 服务域注册入口（路由）。 */
+export declare function registerRoutes(ctx: Context, deps: MemoirRoutesDeps): () => void;
+export {};
+//# sourceMappingURL=routes.d.ts.map

package/lib/types/host/services/memoir/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../../../src/host/services/memoir/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAA;AAChE,OAAO,EAAE,WAAW,EAA2G,MAAM,YAAY,CAAA;AAEjJ,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAKnD,eAAO,MAAM,iBAAiB,oBAAoB,CAAA;AAElD,UAAU,gBAAgB;IACxB,KAAK,EAAE,WAAW,CAAA;IAClB,QAAQ,IAAI,cAAc,CAAA;IAC1B,YAAY,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IAC5C,MAAM,EAAE;QAAE,IAAI,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAA;IACtC,+DAA+D;IAC/D,SAAS,CAAC,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAA;CAC1C;AAuFD,+BAA+B;AAC/B,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,QAAQ,EAAE,CA4NnE;AAED,mBAAmB;AACnB,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,IAAI,CAK/E"}