@dsh-libing/knowledge-base 0.1.0

package/lib/client-types/client/common.d.ts

@@ -0,0 +1,11 @@
+import type { Translate } from '@deepseek-ai/dsh-client-ui-slots';
+import type { LocaleKey } from './locales.ts';
+export type T = Translate<LocaleKey>;
+export interface Actions {
+    t: T;
+    busy: boolean;
+    operationError?: string;
+    act: <V>(operation: () => Promise<V>) => Promise<V | undefined>;
+    dirty: (value: boolean) => void;
+}
+export declare function copy(value: string): Promise<void>;

package/lib/client-types/client/index.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from '@deepseek-ai/cordis';
+import type { LocaleKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        libingKnowledgeBase: LocaleKey;
+    }
+}
+declare module '@deepseek-ai/dsh-api-session-controller/client' {
+    interface SessionReferenceSourceMap {
+        libingKnowledgeBase: unknown;
+    }
+}
+export declare const inject: string[];
+export declare function apply(ctx: Context): void;

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

@@ -0,0 +1,284 @@
+export declare const zh: {
+    reviewOriginal: string;
+    reviewFullImage: string;
+    reviewPreviewHelp: string;
+    reviewImageFailed: string;
+    reviewDescription: string;
+    reviewDescriptionHelp: string;
+    reviewLabels: string;
+    reviewLabelsHelp: string;
+    reviewMoreFields: string;
+    reviewTypes: string;
+    reviewUncertainties: string;
+    reviewUncertaintiesHelp: string;
+    reviewStructured: string;
+    reviewStructuredHelp: string;
+    reviewOtherActions: string;
+    reviewOtherHelp: string;
+    reviewModelDefault: string;
+    reviewReidentifyHelp: string;
+    reviewDecorationHelp: string;
+    reviewIgnoreHelp: string;
+    reviewRestoreHelp: string;
+    reviewStale: string;
+    typeArchitecture: string;
+    typePinout: string;
+    typeSchematic: string;
+    typeTiming: string;
+    typeFlowchart: string;
+    typeTable: string;
+    typeCurve: string;
+    typeOther: string;
+    typeDecoration: string;
+    exampleLibrary: string;
+    examplePath: string;
+    guideToolsTitle: string;
+    guideToolsHelp: string;
+    guideExample: string;
+    guideCommandsTitle: string;
+    guideCommandsHelp: string;
+    guideBuildCommandHelp: string;
+    toolCatalogTitle: string;
+    toolCatalogHelp: string;
+    toolCatalogExample: string;
+    toolSearchTitle: string;
+    toolSearchHelp: string;
+    toolSearchExample: string;
+    toolReadTitle: string;
+    toolReadHelp: string;
+    toolReadExample: string;
+    toolImageTitle: string;
+    toolImageHelp: string;
+    toolImageExample: string;
+    toolBuildTitle: string;
+    toolBuildHelp: string;
+    toolBuildExample: string;
+    toolJobTitle: string;
+    toolJobHelp: string;
+    toolJobExample: string;
+    usage: string;
+    libraryId: string;
+    libraryIdHelp: string;
+    createdAt: string;
+    createdAtHelp: string;
+    publishedRevision: string;
+    publishedRevisionHelp: string;
+    noPublishedRevision: string;
+    notProvided: string;
+    notStarted: string;
+    publishDraft: string;
+    publishConfirm: string;
+    publishHelp: string;
+    publishAccept: string;
+    publishRisk: string;
+    publishPending: string;
+    jobAutoPublish: string;
+    jobReadyHelp: string;
+    jobReviewHelp: string;
+    jobBudgetHelp: string;
+    jobActiveHelp: string;
+    jobStoppedHelp: string;
+    jobId: string;
+    jobIdHelp: string;
+    jobDocId: string;
+    jobDocIdHelp: string;
+    jobFilename: string;
+    jobFilenameHelp: string;
+    jobSourceVersion: string;
+    jobSourceVersionHelp: string;
+    jobSourceHash: string;
+    jobSourceHashHelp: string;
+    jobRevision: string;
+    jobRevisionHelp: string;
+    jobCreatedHelp: string;
+    jobFinished: string;
+    jobFinishedHelp: string;
+    jobOutput: string;
+    jobOutputHelp: string;
+    callsHelp: string;
+    tokensHelp: string;
+    progressHelp: string;
+    pages: string;
+    images: string;
+    jobBlocks: string;
+    jobBlocksHelp: string;
+    events: string;
+    eventsHelp: string;
+    failures: string;
+    failuresHelp: string;
+    usageRecords: string;
+    usageRecordsHelp: string;
+    reportSummary: string;
+    blockingIssue: string;
+    noticeIssue: string;
+    reportHelp: string;
+    noIssues: string;
+    reportChunks: string;
+    reportChunksHelp: string;
+    withinTarget: string;
+    withinTargetHelp: string;
+    reportDocuments: string;
+    reportDocumentsHelp: string;
+    targetCharsHelp: string;
+    reportFiguresHelp: string;
+    ignoredFigures: string;
+    ignoredFiguresHelp: string;
+    unreviewedFigures: string;
+    unreviewedFiguresHelp: string;
+    oversized: string;
+    oversizedHelp: string;
+    pdfAudit: string;
+    pdfAuditHelp: string;
+    pageAt: string;
+    guideBuildTitle: string;
+    guideCreate: string;
+    guideBuild: string;
+    guidePublish: string;
+    guideQueryTitle: string;
+    guideQuery: string;
+    question: string;
+    exampleQuery: string;
+    commandHelp: string;
+    copyCommand: string;
+    copyFailed: string;
+    naturalQueryHelp: string;
+    naturalQuery: string;
+    guideUnpublished: string;
+    guideChoose: string;
+    guidePrerequisites: string;
+    guidePageSearch: string;
+    sendHelp: string;
+    nav: string;
+    title: string;
+    subtitle: string;
+    refresh: string;
+    loading: string;
+    create: string;
+    name: string;
+    empty: string;
+    open: string;
+    back: string;
+    documents: string;
+    chunks: string;
+    unpublished: string;
+    partial: string;
+    published: string;
+    latest: string;
+    latestOpen: string;
+    revision: string;
+    import: string;
+    browse: string;
+    jobs: string;
+    settings: string;
+    trash: string;
+    activity: string;
+    details: string;
+    remove: string;
+    restore: string;
+    purge: string;
+    close: string;
+    cancel: string;
+    confirm: string;
+    save: string;
+    saved: string;
+    failed: string;
+    syncFailed: string;
+    file: string;
+    titleField: string;
+    sourceVersion: string;
+    docId: string;
+    importHelp: string;
+    advanced: string;
+    vision: string;
+    summary: string;
+    defaultModel: string;
+    noModels: string;
+    skipImages: string;
+    acceptPartial: string;
+    acceptHelp: string;
+    chunkTarget: string;
+    inspect: string;
+    inspectHelp: string;
+    pageStart: string;
+    pageEnd: string;
+    rangeHelp: string;
+    rangeConfirm: string;
+    submit: string;
+    uploading: string;
+    calls: string;
+    tokens: string;
+    progress: string;
+    report: string;
+    retry: string;
+    retryHelp: string;
+    maxCalls: string;
+    maxTokens: string;
+    preview: string;
+    draft: string;
+    cancelJob: string;
+    query: string;
+    search: string;
+    noResults: string;
+    read: string;
+    next: string;
+    copyCitation: string;
+    copied: string;
+    source: string;
+    related: string;
+    review: string;
+    reviewHelp: string;
+    figure: string;
+    manual: string;
+    reidentify: string;
+    ignore: string;
+    decoration: string;
+    reviewRestore: string;
+    reviewSave: string;
+    dirty: string;
+    discard: string;
+    continueEdit: string;
+    schema: string;
+    schemaHelp: string;
+    location: string;
+    copyPath: string;
+    openFolder: string;
+    openUnavailable: string;
+    confirmName: string;
+    deleteHelp: string;
+    purgeHelp: string;
+    irreversible: string;
+    emptyTrash: string;
+    send: string;
+    session: string;
+    noSession: string;
+    sent: string;
+    noSkill: string;
+    untitled: string;
+    error: string;
+    scope: string;
+    warnings: string;
+    overLimit: string;
+    missingFile: string;
+    selectLibrary: string;
+    ready: string;
+    queued: string;
+    preflight: string;
+    converting: string;
+    describing: string;
+    splitting: string;
+    indexing: string;
+    validating: string;
+    publishing: string;
+    'needs-review': string;
+    'paused-budget': string;
+    cancelled: string;
+    failedState: string;
+    noJobs: string;
+    human: string;
+    restoreState: string;
+    trashState: string;
+    createState: string;
+    purgeState: string;
+};
+export type LocaleKey = keyof typeof zh;
+export declare const en: Record<LocaleKey, string>;

package/lib/client-types/client/searchCommand.d.ts

@@ -0,0 +1,2 @@
+/** User-facing skill instructions use library names. Reader sends can pin their selected revision. */
+export declare function searchCommand(name: string, revision: string | null | undefined, query: string, pinRevision?: boolean): string | null;

package/lib/client-types/client/useKnowledge.d.ts

@@ -0,0 +1,251 @@
+import * as React from 'react';
+/** One mutation at a time. A successful write followed by a failed refresh is never repeated. */
+export declare function useKnowledge(): {
+    state: {
+        hostVersion: string;
+        kbs: {
+            kbId: string;
+            name: string;
+            createdAt: string;
+            location: {
+                kbPath: string;
+                revision: string | null;
+                wikiPath: string | null;
+                indexPath: string | null;
+            };
+            summary: {
+                revision: string | null;
+                documentCount: number;
+                chunkCount: number;
+                coverageIncomplete: boolean;
+            };
+            deletedAt?: string | undefined;
+            purge?: {
+                startedAt: string;
+                jobIds: string[];
+                error?: string | undefined;
+            } | undefined;
+        }[];
+        deletedKbs: {
+            kbId: string;
+            name: string;
+            createdAt: string;
+            deletedAt?: string | undefined;
+            purge?: {
+                startedAt: string;
+                jobIds: string[];
+                error?: string | undefined;
+            } | undefined;
+        }[];
+        activities: {
+            eventId: string;
+            at: string;
+            action: "purge" | "create" | "trash" | "restore";
+            kbId: string;
+            name: string;
+        }[];
+        jobs: {
+            kbId: string;
+            title: string;
+            sourceVersion: string;
+            docId: string;
+            jobId: string;
+            sourceFormat: "docx" | "pdf";
+            filename: string;
+            usage: {
+                calls: number;
+                tokens: number;
+                reportedCalls: number;
+                records: import("zod").JSONType[];
+            };
+            buildKey: string;
+            createdAt: string;
+            config: {
+                dataRoot: string;
+                chunkTargetChars: number;
+                evidenceMaxChars: number;
+                catalogMaxChars: number;
+                candidateLimit: number;
+                maxInputBytes: number;
+                maxUncompressedBytes: number;
+                maxArchiveEntries: number;
+                modelTimeoutMs: number;
+                modelAttempts: number;
+                visionConcurrency: number;
+                maxModelCalls: number;
+                maxModelTokens: number;
+                visionMaxEdge: number;
+                visionTileSize: number;
+                visionMaxTiles: number;
+                modelMaxOutputTokens: number;
+                summaryMaxChars: number;
+                figureMaxChars: number;
+                pdfMaxPages: number;
+                pdfMaxPagePixels: number;
+                pdfPageTimeoutMs: number;
+                libreOfficePath: string;
+                visionProvider: string;
+                visionModel: string;
+                summaryProvider: string;
+                summaryModel: string;
+                skipImages: boolean;
+                acceptPartial: boolean;
+            };
+            state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            sourceOriginalHash: string;
+            routes: {
+                vision: {
+                    provider: string;
+                    model: string;
+                } | null;
+                summary: {
+                    provider: string;
+                    model: string;
+                } | null;
+            };
+            schemaHash: string;
+            sessionId: string | null;
+            progress: {
+                totalPages?: number | undefined;
+                parsedPages?: number | undefined;
+                ocrPages?: number | undefined;
+                tables?: number | undefined;
+                blocks?: number | undefined;
+                currentPage?: number | undefined;
+                totalFigures?: number | undefined;
+                completedFigures?: number | undefined;
+                inflightFigures?: {
+                    occurrenceId: string;
+                    caption: string;
+                }[] | undefined;
+                totalChunks?: number | undefined;
+                indexedChunks?: number | undefined;
+                currentChunk?: {
+                    title: string;
+                    headingPath: string[];
+                    chunkId: string;
+                } | undefined;
+            };
+            failures: {
+                at: string;
+                stage: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+                error: string;
+            }[];
+            outputPath: string | null;
+            error?: string | null | undefined;
+            pageStart?: number | undefined;
+            pageEnd?: number | undefined;
+            revision?: string | undefined;
+            updatedAt?: string | undefined;
+            pdf?: {
+                pageCount: number;
+                selectedPages: {
+                    start: number;
+                    end: number;
+                    count: number;
+                    total: number;
+                    partial: boolean;
+                };
+                outlineCount?: number | undefined;
+            } | undefined;
+            parserVersion?: string | undefined;
+            sourceHash?: string | undefined;
+            report?: {
+                revision: string;
+                sourceHash: string;
+                issues: {
+                    code: string;
+                    message: string;
+                    blocking: boolean;
+                    page?: number | undefined;
+                    kind?: string | undefined;
+                    snippet?: string | undefined;
+                    reason?: string | undefined;
+                }[];
+                documents: number;
+                blocks: number;
+                figures: number;
+                ignoredFigures: number;
+                unreviewedFigures: number;
+                chunks: number;
+                withinTarget: number;
+                oversized: {
+                    chunkId: string;
+                    chars: number;
+                    reason: string;
+                }[];
+                usage: {
+                    calls: number;
+                    tokens: number;
+                    reportedCalls: number;
+                    records: import("zod").JSONType[];
+                };
+                targetChars: number;
+                pdf?: {
+                    pageCount: number;
+                    selectedPages: {
+                        start: number;
+                        end: number;
+                        count: number;
+                        total: number;
+                        partial: boolean;
+                    };
+                    outlineCount: number;
+                    matchedBookmarks: number;
+                    ocrPages: number;
+                    pages: {
+                        page: number;
+                        status: "failed" | "needs-review" | "navigation" | "parsed";
+                        ocr: boolean;
+                        tables: number;
+                        figures: number;
+                        headings: {
+                            text: string;
+                            level: number;
+                            basis?: string | undefined;
+                        }[];
+                        width?: number | undefined;
+                        height?: number | undefined;
+                        pageLabel?: string | null | undefined;
+                        spanCount?: number | undefined;
+                        artifactCount?: number | undefined;
+                        excluded?: {
+                            kind: string;
+                            bbox: [number, number, number, number] | null;
+                            text?: string | undefined;
+                        }[] | undefined;
+                        previewAssetId?: string | null | undefined;
+                        error?: string | undefined;
+                    }[];
+                } | undefined;
+            } | undefined;
+            events?: {
+                at: string;
+                state: "failed" | "needs-review" | "queued" | "preflight" | "converting" | "describing" | "splitting" | "indexing" | "validating" | "publishing" | "paused-budget" | "cancelled" | "ready";
+            }[] | undefined;
+            figureRefresh?: {
+                occurrenceId: string;
+                token: string;
+            } | null | undefined;
+            visionCapability?: string | undefined;
+            recoveredAt?: string | undefined;
+            finishedAt?: string | undefined;
+            cancelRequested?: boolean | undefined;
+            reused?: boolean | undefined;
+        }[];
+        dataRoot: string;
+        config: {
+            chunkTargetChars: number;
+            visionProvider: string;
+            visionModel: string;
+            maxInputBytes: number;
+        };
+    } | undefined;
+    error: string;
+    notice: "" | "saved" | "syncFailed";
+    busy: boolean;
+    loading: boolean;
+    load: () => Promise<boolean>;
+    act: <T>(operation: () => Promise<T>) => Promise<T | undefined>;
+    setError: React.Dispatch<React.SetStateAction<string>>;
+};