@lemoncat7/dsh-knowledge 0.6.0-alpha.6

package/lib/config.js

@@ -0,0 +1,84 @@
+import Schema from '@deepseek-ai/schemastery';
+export const Config = Schema.object({
+    backend: Schema.union(['local', 'remote']).default('local'),
+    databasePath: Schema.string(),
+    remoteUrl: Schema.string(),
+    remoteToken: Schema.string().role('secret'),
+    remoteTimeoutMs: Schema.number().min(100).max(120_000).default(10_000),
+    connectionPath: Schema.string(),
+    exposeApi: Schema.boolean().default(false),
+    apiToken: Schema.string().role('secret'),
+    apiPrefix: Schema.string().default('/knowledge-api/v1'),
+    exposeWeb: Schema.boolean().default(false),
+    webPath: Schema.string().default('/knowledge'),
+    extractionEnabled: Schema.boolean().default(true),
+    extractionProvider: Schema.string(),
+    extractionModel: Schema.string(),
+    extractionMaxTokens: Schema.number().min(128).max(8192).default(4096),
+    extractionTimeoutMs: Schema.number().min(1000).max(300_000).default(90_000),
+    extractionMaxInputChars: Schema.number().min(1000).max(200_000).default(30_000),
+    defaultScope: Schema.union(['project', 'global']).default('project'),
+    autoRecallLimit: Schema.number().min(0).max(20).default(3),
+    recallMaxChars: Schema.number().min(500).max(50_000).default(6000),
+});
+export function resolveConfig(config) {
+    const connectionPath = config.connectionPath ?? deriveConnectionPath(config.databasePath);
+    const resolved = {
+        ...config,
+        remoteTimeoutMs: config.remoteTimeoutMs ?? 10_000,
+        ...connectionPath === undefined ? {} : { connectionPath },
+        apiPrefix: normalizePrefix(config.apiPrefix ?? '/knowledge-api/v1'),
+        exposeWeb: config.exposeWeb ?? false,
+        webPath: normalizePrefix(config.webPath ?? '/knowledge'),
+        extractionMaxTokens: config.extractionMaxTokens ?? 4096,
+        extractionTimeoutMs: config.extractionTimeoutMs ?? 90_000,
+        extractionMaxInputChars: config.extractionMaxInputChars ?? 30_000,
+        defaultScope: config.defaultScope ?? 'project',
+        autoRecallLimit: config.autoRecallLimit ?? 3,
+        recallMaxChars: config.recallMaxChars ?? 6000,
+    };
+    if (resolved.backend === 'local' && (resolved.databasePath === undefined || resolved.databasePath.trim().length === 0)) {
+        throw new Error('local knowledge backend requires databasePath');
+    }
+    if (resolved.backend === 'remote') {
+        if (resolved.remoteUrl === undefined || resolved.remoteToken === undefined) {
+            throw new Error('remote knowledge backend requires remoteUrl and remoteToken');
+        }
+        const url = new URL(resolved.remoteUrl);
+        const loopback = url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '::1';
+        if (url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) {
+            throw new Error('remote knowledge backend requires HTTPS (HTTP is allowed only for loopback testing)');
+        }
+        if (resolved.remoteToken.trim().length < 24)
+            throw new Error('remoteToken must contain at least 24 characters');
+        if (resolved.exposeApi)
+            throw new Error('remote knowledge backend cannot expose the local API');
+    }
+    const hasExtractionProvider = resolved.extractionProvider !== undefined;
+    const hasExtractionModel = resolved.extractionModel !== undefined;
+    if (hasExtractionProvider !== hasExtractionModel) {
+        throw new Error('extractionProvider and extractionModel must be configured together');
+    }
+    if (resolved.exposeApi && (resolved.apiToken === undefined || resolved.apiToken.trim().length < 24)) {
+        throw new Error('exposeApi requires apiToken with at least 24 characters');
+    }
+    if (resolved.exposeWeb && !resolved.exposeApi) {
+        throw new Error('exposeWeb requires exposeApi so the management console has an authenticated API');
+    }
+    if (resolved.webPath === resolved.apiPrefix || resolved.webPath.startsWith(`${resolved.apiPrefix}/`) || resolved.apiPrefix.startsWith(`${resolved.webPath}/`)) {
+        throw new Error('webPath and apiPrefix must not overlap');
+    }
+    return resolved;
+}
+function deriveConnectionPath(databasePath) {
+    return databasePath === undefined || databasePath.trim().length === 0 ? undefined : `${databasePath}.connection.json`;
+}
+function normalizePrefix(value) {
+    const trimmed = value.trim();
+    const withSlash = trimmed.startsWith('/') ? trimmed : `/${trimmed}`;
+    const prefix = withSlash.endsWith('/') ? withSlash.slice(0, -1) : withSlash;
+    if (!/^\/[a-zA-Z0-9/_-]+$/.test(prefix))
+        throw new Error('apiPrefix must be an absolute URL path');
+    return prefix;
+}
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/lib/connection.d.ts

@@ -0,0 +1,15 @@
+import type { ResolvedConfig } from './config.js';
+import type { KnowledgeProvider } from './provider.js';
+export interface KnowledgeConnectionSettings {
+    backend: 'local' | 'remote';
+    remoteUrl?: string;
+    remoteToken?: string;
+    remoteTimeoutMs: number;
+}
+export declare function connectionSettingsBase(config: ResolvedConfig): KnowledgeConnectionSettings;
+export declare function validateConnectionSettings(settings: KnowledgeConnectionSettings, exposeApi: boolean, localDatabaseAvailable?: boolean): void;
+export declare function createConnectionProvider(config: ResolvedConfig, settings: KnowledgeConnectionSettings): KnowledgeProvider;
+export declare function sameConnection(left: KnowledgeConnectionSettings, right: KnowledgeConnectionSettings): boolean;
+export declare function loadStoredConnection(path: string | undefined): KnowledgeConnectionSettings | undefined;
+export declare function storeConnection(path: string, settings: KnowledgeConnectionSettings): Promise<void>;
+//# sourceMappingURL=connection.d.ts.map

package/lib/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAGtD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,cAAc,GAAG,2BAA2B,CAO1F;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,2BAA2B,EACrC,SAAS,EAAE,OAAO,EAClB,sBAAsB,UAAO,GAC5B,IAAI,CAkBN;AAED,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,2BAA2B,GACpC,iBAAiB,CASnB;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,2BAA2B,EAAE,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAK7G;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,2BAA2B,GAAG,SAAS,CAqBtG;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CASxG"}

package/lib/connection.js

@@ -0,0 +1,95 @@
+import { readFileSync } from 'node:fs';
+import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { LocalKnowledgeProvider } from './local-provider.js';
+import { RemoteKnowledgeProvider } from './remote-provider.js';
+export function connectionSettingsBase(config) {
+    return {
+        backend: config.backend,
+        remoteTimeoutMs: config.remoteTimeoutMs,
+        ...config.remoteUrl === undefined ? {} : { remoteUrl: config.remoteUrl },
+        ...config.remoteToken === undefined ? {} : { remoteToken: config.remoteToken },
+    };
+}
+export function validateConnectionSettings(settings, exposeApi, localDatabaseAvailable = true) {
+    if (!Number.isInteger(settings.remoteTimeoutMs) || settings.remoteTimeoutMs < 100 || settings.remoteTimeoutMs > 120_000) {
+        throw new Error('remote timeout must be an integer from 100 to 120000 milliseconds');
+    }
+    if (settings.backend === 'local') {
+        if (!localDatabaseAvailable)
+            throw new Error('local knowledge backend is unavailable because databasePath is not configured');
+        return;
+    }
+    if (exposeApi)
+        throw new Error('a central knowledge server cannot switch its own provider to remote mode');
+    if (settings.remoteUrl === undefined || settings.remoteToken === undefined) {
+        throw new Error('remote knowledge backend requires a server URL and client token');
+    }
+    const url = new URL(settings.remoteUrl);
+    const loopback = url.hostname === '127.0.0.1' || url.hostname === 'localhost' || url.hostname === '::1';
+    if (url.protocol !== 'https:' && !(url.protocol === 'http:' && loopback)) {
+        throw new Error('remote knowledge backend requires HTTPS (HTTP is allowed only for loopback testing)');
+    }
+    if (settings.remoteToken.trim().length < 24)
+        throw new Error('remote client token must contain at least 24 characters');
+}
+export function createConnectionProvider(config, settings) {
+    validateConnectionSettings(settings, config.exposeApi, config.databasePath !== undefined && config.databasePath.trim().length > 0);
+    return settings.backend === 'local'
+        ? new LocalKnowledgeProvider(config.databasePath)
+        : new RemoteKnowledgeProvider({
+            url: settings.remoteUrl,
+            token: settings.remoteToken,
+            timeoutMs: settings.remoteTimeoutMs,
+        });
+}
+export function sameConnection(left, right) {
+    return left.backend === right.backend
+        && left.remoteUrl === right.remoteUrl
+        && left.remoteToken === right.remoteToken
+        && left.remoteTimeoutMs === right.remoteTimeoutMs;
+}
+export function loadStoredConnection(path) {
+    if (path === undefined)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return undefined;
+        throw new Error(`failed to read knowledge connection settings: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!isRecord(parsed))
+        throw new Error('stored knowledge connection settings must be a JSON object');
+    if (parsed.backend !== 'local' && parsed.backend !== 'remote') {
+        throw new Error('stored knowledge connection backend must be local or remote');
+    }
+    if (!Number.isInteger(parsed.remoteTimeoutMs)) {
+        throw new Error('stored knowledge connection timeout must be an integer');
+    }
+    const settings = {
+        backend: parsed.backend,
+        remoteTimeoutMs: parsed.remoteTimeoutMs,
+        ...typeof parsed.remoteUrl === 'string' ? { remoteUrl: parsed.remoteUrl } : {},
+        ...typeof parsed.remoteToken === 'string' ? { remoteToken: parsed.remoteToken } : {},
+    };
+    return settings;
+}
+export async function storeConnection(path, settings) {
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    const temporary = `${path}.${randomUUID()}.tmp`;
+    try {
+        await writeFile(temporary, `${JSON.stringify(settings, null, 2)}\n`, { encoding: 'utf8', mode: 0o600, flag: 'wx' });
+        await rename(temporary, path);
+    }
+    finally {
+        await rm(temporary, { force: true }).catch(() => { });
+    }
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=connection.js.map

package/lib/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"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"}

package/lib/control.d.ts

@@ -0,0 +1,26 @@
+import type { KnowledgeConnectionSettings } from './connection.js';
+import type { RuntimeContextLike } from './runtime.js';
+export declare const KNOWLEDGE_CONTROL_PATH = "/knowledge-control/v1/connection";
+export interface KnowledgeConnectionView {
+    backend: 'local' | 'remote';
+    remoteUrl?: string;
+    remoteTimeoutMs: number;
+    tokenConfigured: boolean;
+    canSwitchRemote: boolean;
+    writable: boolean;
+}
+export interface KnowledgeConnectionUpdate {
+    backend: 'local' | 'remote';
+    remoteUrl?: string;
+    remoteToken?: string;
+    remoteTimeoutMs: number;
+}
+export interface KnowledgeControlOptions {
+    current(): KnowledgeConnectionSettings;
+    canSwitchRemote: boolean;
+    writable: boolean;
+    update(value: KnowledgeConnectionUpdate): Promise<KnowledgeConnectionSettings>;
+}
+/** Register the same-origin control surface used by the plugin settings card. */
+export declare function registerKnowledgeControl(ctx: RuntimeContextLike, options: KnowledgeControlOptions): () => void;
+//# sourceMappingURL=control.d.ts.map

package/lib/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEtD,eAAO,MAAM,sBAAsB,qCAAqC,CAAA;AAIxE,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,eAAe,EAAE,OAAO,CAAA;IACxB,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,IAAI,2BAA2B,CAAA;IACtC,eAAe,EAAE,OAAO,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,CAAC,KAAK,EAAE,yBAAyB,GAAG,OAAO,CAAC,2BAA2B,CAAC,CAAA;CAC/E;AAED,iFAAiF;AACjF,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,kBAAkB,EACvB,OAAO,EAAE,uBAAuB,GAC/B,MAAM,IAAI,CAcZ"}

package/lib/control.js

@@ -0,0 +1,149 @@
+export const KNOWLEDGE_CONTROL_PATH = '/knowledge-control/v1/connection';
+const MAX_BODY_BYTES = 16_384;
+/** Register the same-origin control surface used by the plugin settings card. */
+export function registerKnowledgeControl(ctx, options) {
+    const webServer = ctx.webServer ?? ctx.get('webServer');
+    if (webServer === undefined)
+        throw new Error('knowledge connection control requires the DSH webServer service');
+    return webServer.register({
+        kind: 'exact',
+        path: KNOWLEDGE_CONTROL_PATH,
+        handler: async (req, res) => {
+            try {
+                await dispatch(req, res, options);
+            }
+            catch (error) {
+                sendControlError(res, error);
+            }
+        },
+    });
+}
+async function dispatch(req, res, options) {
+    const method = req.method ?? 'GET';
+    if (method === 'GET') {
+        return sendJson(res, 200, connectionView(options.current(), options));
+    }
+    if (method !== 'PUT') {
+        res.setHeader('allow', 'GET, PUT');
+        throw controlError(405, '此接口仅支持读取或保存连接配置。');
+    }
+    assertSameOrigin(req);
+    if (!isJsonContentType(req.headers['content-type'])) {
+        throw controlError(415, '保存连接配置时必须使用 application/json。');
+    }
+    if (!options.writable)
+        throw controlError(409, '当前插件没有配置持久化路径，无法保存连接。');
+    const update = parseUpdate(await readObject(req));
+    if (update.backend === 'remote' && !options.canSwitchRemote) {
+        throw controlError(409, '中央知识库服务不能再连接另一台远程知识库。');
+    }
+    const active = await options.update(update);
+    sendJson(res, 200, connectionView(active, options));
+}
+function connectionView(settings, options) {
+    return {
+        backend: settings.backend,
+        remoteTimeoutMs: settings.remoteTimeoutMs,
+        tokenConfigured: typeof settings.remoteToken === 'string' && settings.remoteToken.trim().length >= 24,
+        canSwitchRemote: options.canSwitchRemote,
+        writable: options.writable,
+        ...settings.remoteUrl === undefined ? {} : { remoteUrl: settings.remoteUrl },
+    };
+}
+function parseUpdate(body) {
+    if (body.backend !== 'local' && body.backend !== 'remote') {
+        throw controlError(400, '知识库来源必须是本地或远程。');
+    }
+    if (!Number.isInteger(body.remoteTimeoutMs) || body.remoteTimeoutMs < 100 || body.remoteTimeoutMs > 120_000) {
+        throw controlError(400, '请求超时必须是 100 到 120000 毫秒之间的整数。');
+    }
+    if (body.remoteUrl !== undefined && typeof body.remoteUrl !== 'string') {
+        throw controlError(400, '远程知识库地址格式不正确。');
+    }
+    if (body.remoteToken !== undefined && typeof body.remoteToken !== 'string') {
+        throw controlError(400, '客户端令牌格式不正确。');
+    }
+    return {
+        backend: body.backend,
+        remoteTimeoutMs: body.remoteTimeoutMs,
+        ...typeof body.remoteUrl === 'string' ? { remoteUrl: body.remoteUrl.trim() } : {},
+        ...typeof body.remoteToken === 'string' && body.remoteToken.trim().length > 0
+            ? { remoteToken: body.remoteToken.trim() }
+            : {},
+    };
+}
+function assertSameOrigin(req) {
+    const fetchSite = req.headers['sec-fetch-site'];
+    if (fetchSite !== undefined && fetchSite !== 'same-origin' && fetchSite !== 'none') {
+        throw controlError(403, '已拒绝跨站连接配置请求。');
+    }
+    const origin = req.headers.origin;
+    if (origin === undefined)
+        return;
+    let originHost;
+    try {
+        originHost = new URL(origin).host;
+    }
+    catch {
+        throw controlError(403, '请求来源无效。');
+    }
+    const forwardedHost = firstHeader(req.headers['x-forwarded-host']);
+    const expectedHost = forwardedHost ?? req.headers.host;
+    if (expectedHost === undefined || originHost.toLowerCase() !== expectedHost.toLowerCase()) {
+        throw controlError(403, '已拒绝跨站连接配置请求。');
+    }
+}
+function firstHeader(value) {
+    const raw = Array.isArray(value) ? value[0] : value;
+    return raw?.split(',')[0]?.trim();
+}
+function isJsonContentType(value) {
+    return value?.split(';', 1)[0]?.trim().toLowerCase() === 'application/json';
+}
+async function readObject(req) {
+    const declared = Number(req.headers['content-length'] ?? 0);
+    if (Number.isFinite(declared) && declared > MAX_BODY_BYTES)
+        throw controlError(413, '连接配置内容过大。');
+    const chunks = [];
+    let size = 0;
+    for await (const chunk of req) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        size += buffer.length;
+        if (size > MAX_BODY_BYTES)
+            throw controlError(413, '连接配置内容过大。');
+        chunks.push(buffer);
+    }
+    try {
+        const value = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+        if (!isRecord(value))
+            throw new Error();
+        return value;
+    }
+    catch {
+        throw controlError(400, '请求正文必须是 JSON 对象。');
+    }
+}
+function sendControlError(res, error) {
+    const status = isRecord(error) && typeof error.status === 'number' ? error.status : 500;
+    const message = status >= 500
+        ? '连接配置操作失败，请稍后重试或查看 DSH 日志。'
+        : error instanceof Error ? error.message : '连接配置请求无效。';
+    sendJson(res, status, { error: message, code: status >= 500 ? 'INTERNAL' : `HTTP_${status}` });
+}
+function sendJson(res, status, body) {
+    const payload = JSON.stringify(body);
+    res.writeHead(status, {
+        'content-type': 'application/json; charset=utf-8',
+        'content-length': Buffer.byteLength(payload),
+        'cache-control': 'no-store',
+        'x-content-type-options': 'nosniff',
+    });
+    res.end(payload);
+}
+function controlError(status, message) {
+    return Object.assign(new Error(message), { status });
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+//# sourceMappingURL=control.js.map

package/lib/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","sourceRoot":"","sources":["../src/control.ts"],"names":[],"mappings":"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"}

package/lib/domain.d.ts

@@ -0,0 +1,207 @@
+export declare const KNOWLEDGE_TYPES: readonly ["preference", "fact", "decision", "procedure", "lesson"];
+export type KnowledgeType = typeof KNOWLEDGE_TYPES[number];
+export declare const DEFAULT_KNOWLEDGE_BASE_ID = "default";
+export type KnowledgeScope = {
+    kind: 'global';
+} | {
+    kind: 'project';
+    id: string;
+};
+export type KnowledgeStatus = 'active' | 'archived';
+export type CandidateAction = 'create' | 'update' | 'conflict';
+export type CandidateStatus = 'pending' | 'approved' | 'rejected';
+export type KnowledgeBaseStatus = 'active' | 'archived';
+export type KnowledgeMountTargetKind = 'project' | 'session';
+export type KnowledgeWriteMode = 'none' | 'audit' | 'direct';
+export interface KnowledgeBaseDraft {
+    name: string;
+    description: string;
+    defaultTags: string[];
+    extractionInstructions: string;
+    /** Empty means use the model route from the current assistant turn. */
+    writebackProvider?: string;
+    writebackModel?: string;
+}
+export interface KnowledgeBasePatch {
+    name?: string;
+    description?: string;
+    defaultTags?: string[];
+    extractionInstructions?: string;
+    writebackProvider?: string | null;
+    writebackModel?: string | null;
+}
+export interface KnowledgeBase extends KnowledgeBaseDraft {
+    id: string;
+    status: KnowledgeBaseStatus;
+    createdAt: string;
+    updatedAt: string;
+}
+/** User-facing Markdown projection of approved knowledge entries. */
+export interface KnowledgeDocument {
+    id: string;
+    knowledgeBaseId: string;
+    relPath: string;
+    title: string;
+    content: string;
+    entryCount: number;
+    contentHash: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KnowledgeMountDraft {
+    targetKind: KnowledgeMountTargetKind;
+    targetId: string;
+    knowledgeBaseId: string;
+    enabled: boolean;
+    recallEnabled: boolean;
+    writeMode: KnowledgeWriteMode;
+    includeTags: string[];
+    excludeTags: string[];
+    extractionInstructions: string;
+}
+export interface KnowledgeMount extends KnowledgeMountDraft {
+    id: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KnowledgeMountBatch {
+    upserts: KnowledgeMountDraft[];
+    deleteIds: string[];
+}
+export interface KnowledgeMountBatchResult {
+    mounts: KnowledgeMount[];
+    deletedIds: string[];
+}
+export interface ResolvedKnowledgeMount extends KnowledgeMount {
+    base: KnowledgeBase;
+    inheritedFrom?: 'project';
+}
+export interface KnowledgeSource {
+    sessionId?: string;
+    messageId?: string;
+    turn?: number;
+    clientId?: string;
+}
+export interface KnowledgeDraft {
+    knowledgeBaseId: string;
+    title: string;
+    body: string;
+    type: KnowledgeType;
+    tags: string[];
+    scope: KnowledgeScope;
+    confidence: number;
+    source?: KnowledgeSource;
+}
+export interface KnowledgeEntry extends KnowledgeDraft {
+    id: string;
+    status: KnowledgeStatus;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface KnowledgeVersion {
+    id: string;
+    knowledgeId: string;
+    version: number;
+    snapshot: KnowledgeDraft & {
+        status: KnowledgeStatus;
+    };
+    changeKind: 'create' | 'update' | 'archive' | 'restore';
+    createdAt: string;
+}
+export interface CandidateProposal {
+    action: CandidateAction;
+    targetId?: string;
+    draft: KnowledgeDraft;
+    reason: string;
+}
+export interface KnowledgeCandidate extends CandidateProposal {
+    id: string;
+    status: CandidateStatus;
+    sourceKey?: string;
+    createdAt: string;
+    reviewedAt?: string;
+    reviewNote?: string;
+}
+export interface SearchRequest {
+    text: string;
+    projectId?: string;
+    knowledgeBaseIds?: string[];
+    includeTags?: string[];
+    excludeTags?: string[];
+    types?: KnowledgeType[];
+    limit: number;
+}
+export interface SearchHit {
+    entry: KnowledgeEntry;
+    score: number;
+}
+export interface ListRequest {
+    status?: KnowledgeStatus;
+    projectId?: string;
+    knowledgeBaseId?: string;
+    type?: KnowledgeType;
+    limit: number;
+    cursor?: string;
+}
+export interface ListResult<T> {
+    items: T[];
+    nextCursor?: string;
+}
+export interface ReviewDecision {
+    decision: 'approve' | 'reject';
+    note?: string;
+    draft?: KnowledgeDraft;
+}
+export interface ExtractionJobRecord {
+    sourceKey: string;
+    status: 'running' | 'completed' | 'failed';
+    attempts: number;
+    candidateCount: number;
+    lastError?: string;
+    updatedAt: string;
+}
+export interface KnowledgeStats {
+    knowledgeBases: {
+        total: number;
+        active: number;
+        archived: number;
+    };
+    entries: {
+        total: number;
+        active: number;
+        archived: number;
+        byType: Record<KnowledgeType, number>;
+    };
+    candidates: {
+        total: number;
+        pending: number;
+        approved: number;
+        rejected: number;
+    };
+    extractionJobs: {
+        total: number;
+        running: number;
+        completed: number;
+        failed: number;
+    };
+}
+export declare const TOKEN_PERMISSIONS: readonly ["read", "propose", "write", "admin"];
+export type TokenPermission = typeof TOKEN_PERMISSIONS[number];
+export interface ApiTokenRecord {
+    id: string;
+    name: string;
+    permissions: TokenPermission[];
+    createdAt: string;
+    lastUsedAt?: string;
+    revokedAt?: string;
+}
+export declare function newId(): string;
+export declare function nowIso(): string;
+export declare function normalizeTags(tags: readonly string[]): string[];
+export declare function normalizeDraft(input: KnowledgeDraft): KnowledgeDraft;
+export declare function contentHash(draft: KnowledgeDraft): string;
+export declare function normalizeKnowledgeBaseDraft(input: KnowledgeBaseDraft): KnowledgeBaseDraft;
+export declare function normalizeKnowledgeMountDraft(input: KnowledgeMountDraft): KnowledgeMountDraft;
+export declare function isKnowledgeType(value: unknown): value is KnowledgeType;
+//# sourceMappingURL=domain.d.ts.map

package/lib/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../src/domain.ts"],"names":[],"mappings":"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"}