@lemoncat7/dsh-knowledge 0.6.0-alpha.6

package/lib/index.js

@@ -0,0 +1,198 @@
+import { randomBytes } from 'node:crypto';
+import { registerKnowledgeApi } from './api.js';
+import { connectionSettingsBase, createConnectionProvider, loadStoredConnection, sameConnection, storeConnection, validateConnectionSettings, } from './connection.js';
+import { Config as ConfigSchema, resolveConfig } from './config.js';
+import { registerKnowledgeControl } from './control.js';
+import { ExtractionCoordinator } from './extraction.js';
+import { LocalKnowledgeProvider } from './local-provider.js';
+import { KnowledgeProviderRouter } from './provider-router.js';
+import { registerKnowledgeCatalog, registerRecall } from './recall.js';
+import { KnowledgeHandleCodec } from './retrieval.js';
+import { RemoteProviderError } from './remote-provider.js';
+import { createWritebackMessage } from './runtime.js';
+import { registerKnowledgeTools } from './tools.js';
+import { registerKnowledgeWeb } from './web.js';
+export const Config = ConfigSchema;
+export * from './domain.js';
+export * from './provider.js';
+export { LocalKnowledgeProvider } from './local-provider.js';
+export { RemoteKnowledgeProvider, RemoteProviderError } from './remote-provider.js';
+/** Human-readable Cordis plugin name. */
+export const name = 'dsh-knowledge';
+/** Extraction, native retrieval tools, and mounted-base context require the corresponding DSH host services. */
+export const inject = ['llm', 'tools', 'systemPrompt'];
+/** Mount storage, hybrid retrieval, extraction, and the optional authenticated HTTP API. */
+export function apply(ctx, config) {
+    const runtime = ctx;
+    const resolved = resolveConfig(config);
+    const baseConnection = connectionSettingsBase(resolved);
+    let initialConnection = baseConnection;
+    try {
+        const stored = loadStoredConnection(resolved.connectionPath);
+        if (stored !== undefined) {
+            validateConnectionSettings(stored, resolved.exposeApi, resolved.databasePath !== undefined && resolved.databasePath.trim().length > 0);
+            initialConnection = stored;
+        }
+    }
+    catch (error) {
+        runtime.logger.warn(`dsh-knowledge: ignored invalid stored connection: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const initialProvider = createConnectionProvider(resolved, initialConnection);
+    const providerRouter = new KnowledgeProviderRouter(initialProvider);
+    const provider = providerRouter.provider;
+    let activeConnection = initialConnection;
+    const coordinator = new ExtractionCoordinator(runtime, provider, resolved);
+    const handleCodec = new KnowledgeHandleCodec(randomBytes(32));
+    registerKnowledgeCatalog(runtime, provider, resolved);
+    registerRecall(runtime, provider, resolved, handleCodec);
+    registerKnowledgeTools(runtime, provider, handleCodec);
+    let switching = Promise.resolve();
+    const updateConnection = (input) => {
+        const pending = switching.then(async () => {
+            const next = {
+                backend: input.backend,
+                remoteTimeoutMs: input.remoteTimeoutMs,
+                ...input.remoteUrl !== undefined ? { remoteUrl: input.remoteUrl } : activeConnection.remoteUrl !== undefined ? { remoteUrl: activeConnection.remoteUrl } : {},
+                ...input.remoteToken !== undefined ? { remoteToken: input.remoteToken } : activeConnection.remoteToken !== undefined ? { remoteToken: activeConnection.remoteToken } : {},
+            };
+            validateConnectionSettings(next, resolved.exposeApi, resolved.databasePath !== undefined && resolved.databasePath.trim().length > 0);
+            if (sameConnection(next, activeConnection))
+                return activeConnection;
+            if (resolved.connectionPath === undefined)
+                throw connectionError(409, '当前插件没有配置持久化路径，无法保存连接。');
+            const candidate = createConnectionProvider(resolved, next);
+            let persisted = false;
+            try {
+                if (next.backend === 'remote')
+                    await candidate.stats();
+                await storeConnection(resolved.connectionPath, next);
+                persisted = true;
+                await providerRouter.replace(candidate);
+                activeConnection = next;
+                runtime.logger.info(`dsh-knowledge: verified and switched to ${next.backend} provider`);
+                return activeConnection;
+            }
+            catch (error) {
+                await candidate.close().catch(() => { });
+                if (persisted) {
+                    await storeConnection(resolved.connectionPath, activeConnection).catch(rollbackError => {
+                        runtime.logger.error(`dsh-knowledge: failed to restore connection settings: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`);
+                    });
+                }
+                throw error;
+            }
+        });
+        const operation = pending.catch(error => {
+            runtime.logger.warn(`dsh-knowledge: connection switch rejected: ${error instanceof Error ? error.message : String(error)}`);
+            throw publicConnectionError(error);
+        });
+        switching = operation.catch(() => { });
+        return operation;
+    };
+    if (runtime.inject !== undefined) {
+        runtime.inject(['webServer'], httpRuntime => {
+            const disposeControl = registerKnowledgeControl(httpRuntime, {
+                current: () => activeConnection,
+                canSwitchRemote: !resolved.exposeApi,
+                writable: resolved.connectionPath !== undefined,
+                update: updateConnection,
+            });
+            httpRuntime.effect(() => disposeControl, 'dsh-knowledge.connection-control');
+        });
+    }
+    else if (runtime.webServer !== undefined) {
+        const disposeControl = registerKnowledgeControl(runtime, {
+            current: () => activeConnection,
+            canSwitchRemote: !resolved.exposeApi,
+            writable: resolved.connectionPath !== undefined,
+            update: updateConnection,
+        });
+        runtime.effect(() => disposeControl, 'dsh-knowledge.connection-control');
+    }
+    else {
+        runtime.logger.warn('dsh-knowledge: webServer is unavailable; the connection settings entry is disabled');
+    }
+    if (resolved.extractionEnabled) {
+        runtime.on('agent/turn-stopping', async ({ agent, turn, signal }) => {
+            if (agent.session.append === undefined)
+                throw new Error('synchronous knowledge writeback requires Session.append');
+            let summary;
+            try {
+                const result = await coordinator.run(agent.session, turn, signal);
+                if (result.status === 'duplicate')
+                    return;
+                if (result.status === 'unmounted')
+                    summary = '知识库回写 · 未挂载可写知识库';
+                else if (result.status === 'skipped')
+                    summary = '知识库回写 · 当前回答无可提取内容';
+                else if (result.candidateCount === 0)
+                    summary = '知识库回写 · 无需收录';
+                else
+                    summary = `知识库回写 · ${result.bases.map(base => {
+                        const parts = [base.directCount > 0 ? `直写 ${base.directCount}` : '', base.auditCount > 0 ? `待审 ${base.auditCount}` : ''].filter(Boolean);
+                        return `${base.name}：${parts.join('、')}`;
+                    }).join('；')}`;
+            }
+            catch (error) {
+                if (signal.aborted)
+                    return;
+                const message = error instanceof Error ? error.message : String(error);
+                runtime.logger.warn(`dsh-knowledge: synchronous writeback failed: ${message}`);
+                summary = message.includes('max-tokens')
+                    ? '知识库回写 · 失败：提取结果超过模型输出上限'
+                    : '知识库回写 · 失败，可稍后重试';
+            }
+            agent.session.append('user/message', createWritebackMessage(summary), { surfaceOp: 'append' });
+        });
+    }
+    if (resolved.exposeApi) {
+        if (!(initialProvider instanceof LocalKnowledgeProvider))
+            throw new Error('exposeApi is supported only by the local backend');
+        initialProvider.ensureBootstrapToken(resolved.apiToken);
+        if (runtime.inject === undefined)
+            throw new Error('exposeApi requires Cordis dynamic service injection');
+        runtime.inject(['webServer'], (httpRuntime) => {
+            const disposeApi = registerKnowledgeApi(httpRuntime, initialProvider, resolved.apiPrefix);
+            httpRuntime.effect(() => disposeApi, 'dsh-knowledge.api');
+            if (resolved.exposeWeb) {
+                const disposeWeb = registerKnowledgeWeb(httpRuntime, resolved.webPath, resolved.apiPrefix);
+                httpRuntime.effect(() => disposeWeb, 'dsh-knowledge.web');
+            }
+        });
+    }
+    runtime.effect(() => async () => {
+        await coordinator.close();
+        await providerRouter.close();
+    }, 'dsh-knowledge.close');
+    runtime.logger.info(`dsh-knowledge: ${provider.mode} provider ready`);
+}
+function publicConnectionError(error) {
+    if (error instanceof RemoteProviderError) {
+        if (error.status === 401)
+            return connectionError(400, '客户端令牌无效或已被撤销。');
+        if (error.status === 403)
+            return connectionError(400, '客户端令牌没有读取该知识库的权限。');
+        if (error.status === 404)
+            return connectionError(400, '服务器地址不是有效的知识库 API 地址。');
+        if (error.status === 0)
+            return connectionError(400, '无法连接远程知识库，请检查地址、网络和证书。');
+        return connectionError(400, `远程知识库验证失败（HTTP ${error.status}）。`);
+    }
+    if (error instanceof Error && typeof error.status === 'number')
+        return error;
+    if (error instanceof Error) {
+        if (/server URL and client token|24 characters/i.test(error.message))
+            return connectionError(400, '首次连接需要填写至少 24 个字符的客户端令牌。');
+        if (/HTTPS/i.test(error.message))
+            return connectionError(400, '远程知识库必须使用 HTTPS。');
+        if (/timeout/i.test(error.message))
+            return connectionError(400, '请求超时时间不正确。');
+        if (/databasePath/i.test(error.message))
+            return connectionError(409, '当前 DSH 没有可用的本地知识库。');
+    }
+    return error instanceof Error ? error : new Error(String(error));
+}
+function connectionError(status, message) {
+    return Object.assign(new Error(message), { status });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/local-provider.d.ts

@@ -0,0 +1,60 @@
+import { type CandidateProposal, type ApiTokenRecord, type ExtractionJobRecord, type KnowledgeCandidate, type KnowledgeBase, type KnowledgeBaseDraft, type KnowledgeBasePatch, type KnowledgeDraft, type KnowledgeEntry, type KnowledgeDocument, type KnowledgeStats, type KnowledgeVersion, type KnowledgeMount, type KnowledgeMountBatch, type KnowledgeMountBatchResult, type KnowledgeMountDraft, type KnowledgeMountTargetKind, type ResolvedKnowledgeMount, type ListRequest, type ListResult, type ReviewDecision, type SearchHit, type SearchRequest, type TokenPermission } from './domain.js';
+import type { KnowledgeProvider } from './provider.js';
+export declare class LocalKnowledgeProvider implements KnowledgeProvider {
+    readonly mode: "local";
+    private readonly db;
+    private closed;
+    constructor(path: string);
+    private migrate;
+    private assertOpen;
+    listKnowledgeBases(): Promise<KnowledgeBase[]>;
+    getKnowledgeBase(id: string): Promise<KnowledgeBase | undefined>;
+    createKnowledgeBase(input: KnowledgeBaseDraft): Promise<KnowledgeBase>;
+    updateKnowledgeBase(id: string, input: KnowledgeBaseDraft): Promise<KnowledgeBase>;
+    patchKnowledgeBase(id: string, patch: KnowledgeBasePatch): Promise<KnowledgeBase>;
+    archiveKnowledgeBase(id: string): Promise<KnowledgeBase>;
+    restoreKnowledgeBase(id: string): Promise<KnowledgeBase>;
+    deleteKnowledgeBase(id: string): Promise<void>;
+    listDocuments(knowledgeBaseId?: string, query?: string): Promise<KnowledgeDocument[]>;
+    getDocument(id: string): Promise<KnowledgeDocument | undefined>;
+    listMounts(targetKind?: KnowledgeMountTargetKind, targetId?: string): Promise<KnowledgeMount[]>;
+    upsertMount(input: KnowledgeMountDraft): Promise<KnowledgeMount>;
+    applyMountBatch(batch: KnowledgeMountBatch): Promise<KnowledgeMountBatchResult>;
+    private upsertMountRow;
+    deleteMount(id: string): Promise<void>;
+    resolveMounts(sessionId: string, projectId?: string): Promise<ResolvedKnowledgeMount[]>;
+    stats(): Promise<KnowledgeStats>;
+    private transaction;
+    search(request: SearchRequest): Promise<SearchHit[]>;
+    private searchByTerms;
+    list(request: ListRequest): Promise<ListResult<KnowledgeEntry>>;
+    get(id: string): Promise<KnowledgeEntry | undefined>;
+    versions(id: string): Promise<KnowledgeVersion[]>;
+    create(draft: KnowledgeDraft): Promise<KnowledgeEntry>;
+    private insertEntry;
+    update(id: string, draft: KnowledgeDraft): Promise<KnowledgeEntry>;
+    private updateEntry;
+    archive(id: string): Promise<KnowledgeEntry>;
+    delete(id: string): Promise<void>;
+    propose(input: CandidateProposal, sourceKey?: string): Promise<KnowledgeCandidate>;
+    listCandidates(status: 'pending' | 'approved' | 'rejected', limit: number): Promise<KnowledgeCandidate[]>;
+    review(id: string, decision: ReviewDecision): Promise<KnowledgeCandidate>;
+    claimExtraction(sourceKey: string): Promise<boolean>;
+    completeExtraction(sourceKey: string, candidateCount: number): Promise<void>;
+    failExtraction(sourceKey: string, error: string): Promise<void>;
+    extractionJob(sourceKey: string): Promise<ExtractionJobRecord | undefined>;
+    ensureBootstrapToken(token: string): void;
+    authenticate(token: string): ApiTokenRecord | undefined;
+    createApiToken(name: string, permissions: TokenPermission[]): {
+        record: ApiTokenRecord;
+        token: string;
+    };
+    listApiTokens(): ApiTokenRecord[];
+    revokeApiToken(id: string): void;
+    close(): Promise<void>;
+    private writeVersion;
+    private upsertFts;
+    private syncAllDocuments;
+    private syncKnowledgeDocuments;
+}
+//# sourceMappingURL=local-provider.d.ts.map

package/lib/local-provider.d.ts.map

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