@jingyi0605/codingns 0.8.5 → 0.9.5

package/dist/server/modules/workspace/affairs-library-preview-link-service.js

@@ -0,0 +1,167 @@
+import crypto from "node:crypto";
+import { AppError } from "../../shared/errors/app-error.js";
+import { detectPreviewKind, resolvePreviewContentType } from "../file/file-preview-types.js";
+const AFFAIRS_LIBRARY_PREVIEW_TOKEN_TTL_MS = 2 * 60 * 60 * 1000;
+export class AffairsLibraryPreviewLinkService {
+    affairsLibraryService;
+    signingSecret;
+    constructor(affairsLibraryService, signingSecret) {
+        this.affairsLibraryService = affairsLibraryService;
+        this.signingSecret = signingSecret;
+    }
+    createLink(workspaceId, userId, requestedPath) {
+        const resolved = this.affairsLibraryService.resolvePreviewFile(workspaceId, userId, requestedPath, {
+            mustExist: true,
+            kind: "file"
+        });
+        const previewKind = detectPreviewKind(resolved.relativePath);
+        if (previewKind !== "html" && previewKind !== "image" && previewKind !== "pdf") {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "FILE_PREVIEW_NOT_SUPPORTED",
+                detail: "当前只支持为 HTML、图片和 PDF 生成受控预览链接",
+                field: "path"
+            });
+        }
+        const expiresAt = Date.now() + AFFAIRS_LIBRARY_PREVIEW_TOKEN_TTL_MS;
+        const token = this.createToken({
+            workspaceId,
+            userId,
+            expiresAt,
+            previewPath: resolved.relativePath
+        });
+        return {
+            previewPath: buildAffairsPublicPreviewPath(token, resolved.relativePath),
+            previewUrl: "",
+            expiresAt: new Date(expiresAt).toISOString()
+        };
+    }
+    createOnlyOfficeLink(workspaceId, userId, requestedPath) {
+        const resolved = this.affairsLibraryService.resolvePreviewFile(workspaceId, userId, requestedPath, {
+            mustExist: true,
+            kind: "file"
+        });
+        const previewKind = detectPreviewKind(resolved.relativePath);
+        if (previewKind !== "office") {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "FILE_PREVIEW_NOT_SUPPORTED",
+                detail: "当前只支持为 Office 文件生成 ONLYOFFICE 受控链接",
+                field: "path"
+            });
+        }
+        const expiresAt = Date.now() + AFFAIRS_LIBRARY_PREVIEW_TOKEN_TTL_MS;
+        const token = this.createToken({
+            workspaceId,
+            userId,
+            expiresAt,
+            previewPath: resolved.relativePath
+        });
+        return {
+            previewPath: buildAffairsPublicPreviewPath(token, resolved.relativePath),
+            previewUrl: "",
+            expiresAt: new Date(expiresAt).toISOString()
+        };
+    }
+    resolveTokenContext(token) {
+        const payload = this.verifyToken(token);
+        return {
+            workspaceId: payload.workspaceId,
+            userId: payload.userId,
+            previewPath: payload.previewPath ?? ""
+        };
+    }
+    resolvePublicFile(token, requestedPath) {
+        const payload = this.verifyToken(token);
+        const resolved = this.affairsLibraryService.resolvePreviewFile(payload.workspaceId, payload.userId, requestedPath, {
+            mustExist: true,
+            kind: "file"
+        });
+        const contentType = resolvePreviewContentType(resolved.relativePath);
+        if (!contentType) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "FILE_PREVIEW_ASSET_NOT_SUPPORTED",
+                detail: "当前预览链接不支持加载这种文件类型",
+                field: "path"
+            });
+        }
+        return {
+            workspaceId: payload.workspaceId,
+            absolutePath: resolved.absolutePath,
+            relativePath: resolved.relativePath,
+            contentType
+        };
+    }
+    createToken(payload) {
+        const encodedPayload = encodeBase64Url(JSON.stringify(payload));
+        const signature = this.sign(encodedPayload);
+        return `${encodedPayload}.${signature}`;
+    }
+    verifyToken(token) {
+        const [encodedPayload, signature] = token.split(".");
+        if (!encodedPayload || !signature) {
+            throw buildInvalidPreviewTokenError();
+        }
+        const expectedSignature = this.sign(encodedPayload);
+        if (!safeCompare(signature, expectedSignature)) {
+            throw buildInvalidPreviewTokenError();
+        }
+        let payload;
+        try {
+            payload = JSON.parse(decodeBase64Url(encodedPayload));
+        }
+        catch {
+            throw buildInvalidPreviewTokenError();
+        }
+        if (!payload.workspaceId || !payload.userId || typeof payload.expiresAt !== "number") {
+            throw buildInvalidPreviewTokenError();
+        }
+        if (payload.expiresAt <= Date.now()) {
+            throw new AppError({
+                statusCode: 401,
+                errorCode: "FILE_PREVIEW_TOKEN_EXPIRED",
+                detail: "预览链接已经过期，请重新打开文件预览"
+            });
+        }
+        return payload;
+    }
+    sign(encodedPayload) {
+        return crypto
+            .createHmac("sha256", this.signingSecret)
+            .update(encodedPayload)
+            .digest("base64url");
+    }
+}
+export function buildAffairsPublicPreviewPath(token, relativePath) {
+    return `/preview/affairs-files/${encodeURIComponent(token)}/${encodeRelativePath(relativePath)}`;
+}
+function encodeRelativePath(relativePath) {
+    return relativePath
+        .replace(/\\/g, "/")
+        .split("/")
+        .map((segment) => encodeURIComponent(segment))
+        .join("/");
+}
+function encodeBase64Url(input) {
+    return Buffer.from(input, "utf8").toString("base64url");
+}
+function decodeBase64Url(input) {
+    return Buffer.from(input, "base64url").toString("utf8");
+}
+function safeCompare(left, right) {
+    const leftBuffer = Buffer.from(left);
+    const rightBuffer = Buffer.from(right);
+    if (leftBuffer.byteLength !== rightBuffer.byteLength) {
+        return false;
+    }
+    return crypto.timingSafeEqual(leftBuffer, rightBuffer);
+}
+function buildInvalidPreviewTokenError() {
+    return new AppError({
+        statusCode: 401,
+        errorCode: "FILE_PREVIEW_TOKEN_INVALID",
+        detail: "预览链接无效，请重新打开文件预览"
+    });
+}
+//# sourceMappingURL=affairs-library-preview-link-service.js.map

package/dist/server/modules/workspace/affairs-library-preview-link-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"affairs-library-preview-link-service.js","sourceRoot":"","sources":["../../../../src/modules/workspace/affairs-library-preview-link-service.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/workspace/affairs-library-refresh-contract.d.ts

@@ -0,0 +1,56 @@
+export declare const AFFAIRS_LIBRARY_INDEX_DIRTY_REASONS: {
+    readonly refreshRequested: "refresh_requested";
+    readonly refreshFailed: "refresh_failed";
+    readonly bindingRequired: "binding_required";
+    readonly libraryDisabled: "library_disabled";
+    readonly missingIndexArtifact: "missing_index_artifact";
+    readonly missingExportDir: "missing_export_dir";
+    readonly missingExportStatus: "missing_export_status";
+    readonly missingExportManifest: "missing_export_manifest";
+    readonly commandLockMissing: "command_lock_missing";
+    readonly commandLockOwnerDead: "command_lock_owner_dead";
+    readonly commandLockHeartbeatStale: "command_lock_heartbeat_stale";
+    readonly queueTimeout: "queue_timeout";
+    readonly staleFallback: "stale_fallback";
+    readonly driftDetected: "drift_detected";
+    readonly rebuildRequired: "rebuild_required";
+};
+export declare const AFFAIRS_LIBRARY_RECONCILE_SCOPES: {
+    readonly lightweight: "lightweight";
+    readonly periodicAudit: "periodic_audit";
+};
+export declare const AFFAIRS_LIBRARY_RECONCILE_STATUSES: {
+    readonly healthy: "healthy";
+    readonly driftDetected: "drift_detected";
+    readonly rebuildRequired: "rebuild_required";
+};
+export declare const AFFAIRS_LIBRARY_RECONCILE_REASONS: {
+    readonly timer: "lightweight_reconcile:timer";
+    readonly pendingDirtySignal: "lightweight_reconcile:pending_dirty_signal";
+    readonly runtimeStatusAhead: "lightweight_reconcile:runtime_status_ahead";
+    readonly recentDirectoryMtime: "lightweight_reconcile:recent_directory_mtime";
+    readonly periodicAuditTimer: "periodic_audit:timer";
+    readonly periodicAuditPendingDirtySignal: "periodic_audit:pending_dirty_signal";
+    readonly periodicAuditRuntimeStatusAhead: "periodic_audit:runtime_status_ahead";
+    readonly periodicAuditLightweightDriftStreak: "periodic_audit:lightweight_drift_streak";
+    readonly periodicAuditRootDirMtime: "periodic_audit:root_dir_mtime";
+};
+export declare const AFFAIRS_LIBRARY_DEBUG_EVENTS: {
+    readonly lightweightReconcileTick: "lightweight_reconcile_tick";
+    readonly lightweightReconcileSkipped: "lightweight_reconcile_skipped";
+    readonly lightweightReconcileDriftDetected: "lightweight_reconcile_drift_detected";
+    readonly lightweightReconcileScheduledRefresh: "lightweight_reconcile_scheduled_refresh";
+    readonly periodicAuditTick: "periodic_audit_tick";
+    readonly periodicAuditSkipped: "periodic_audit_skipped";
+    readonly periodicAuditDriftDetected: "periodic_audit_drift_detected";
+    readonly periodicAuditScheduledRefresh: "periodic_audit_scheduled_refresh";
+};
+export type AffairsLibraryReconcileScope = (typeof AFFAIRS_LIBRARY_RECONCILE_SCOPES)[keyof typeof AFFAIRS_LIBRARY_RECONCILE_SCOPES];
+export type AffairsLibraryReconcileStatus = (typeof AFFAIRS_LIBRARY_RECONCILE_STATUSES)[keyof typeof AFFAIRS_LIBRARY_RECONCILE_STATUSES];
+export interface AffairsLibraryReconcileResult {
+    scope: AffairsLibraryReconcileScope;
+    status: AffairsLibraryReconcileStatus;
+    reason: string;
+    targetPaths: string[];
+    observedAt: string;
+}

package/dist/server/modules/workspace/affairs-library-refresh-contract.js

@@ -0,0 +1,48 @@
+export const AFFAIRS_LIBRARY_INDEX_DIRTY_REASONS = {
+    refreshRequested: "refresh_requested",
+    refreshFailed: "refresh_failed",
+    bindingRequired: "binding_required",
+    libraryDisabled: "library_disabled",
+    missingIndexArtifact: "missing_index_artifact",
+    missingExportDir: "missing_export_dir",
+    missingExportStatus: "missing_export_status",
+    missingExportManifest: "missing_export_manifest",
+    commandLockMissing: "command_lock_missing",
+    commandLockOwnerDead: "command_lock_owner_dead",
+    commandLockHeartbeatStale: "command_lock_heartbeat_stale",
+    queueTimeout: "queue_timeout",
+    staleFallback: "stale_fallback",
+    driftDetected: "drift_detected",
+    rebuildRequired: "rebuild_required"
+};
+export const AFFAIRS_LIBRARY_RECONCILE_SCOPES = {
+    lightweight: "lightweight",
+    periodicAudit: "periodic_audit"
+};
+export const AFFAIRS_LIBRARY_RECONCILE_STATUSES = {
+    healthy: "healthy",
+    driftDetected: "drift_detected",
+    rebuildRequired: "rebuild_required"
+};
+export const AFFAIRS_LIBRARY_RECONCILE_REASONS = {
+    timer: "lightweight_reconcile:timer",
+    pendingDirtySignal: "lightweight_reconcile:pending_dirty_signal",
+    runtimeStatusAhead: "lightweight_reconcile:runtime_status_ahead",
+    recentDirectoryMtime: "lightweight_reconcile:recent_directory_mtime",
+    periodicAuditTimer: "periodic_audit:timer",
+    periodicAuditPendingDirtySignal: "periodic_audit:pending_dirty_signal",
+    periodicAuditRuntimeStatusAhead: "periodic_audit:runtime_status_ahead",
+    periodicAuditLightweightDriftStreak: "periodic_audit:lightweight_drift_streak",
+    periodicAuditRootDirMtime: "periodic_audit:root_dir_mtime"
+};
+export const AFFAIRS_LIBRARY_DEBUG_EVENTS = {
+    lightweightReconcileTick: "lightweight_reconcile_tick",
+    lightweightReconcileSkipped: "lightweight_reconcile_skipped",
+    lightweightReconcileDriftDetected: "lightweight_reconcile_drift_detected",
+    lightweightReconcileScheduledRefresh: "lightweight_reconcile_scheduled_refresh",
+    periodicAuditTick: "periodic_audit_tick",
+    periodicAuditSkipped: "periodic_audit_skipped",
+    periodicAuditDriftDetected: "periodic_audit_drift_detected",
+    periodicAuditScheduledRefresh: "periodic_audit_scheduled_refresh"
+};
+//# sourceMappingURL=affairs-library-refresh-contract.js.map

package/dist/server/modules/workspace/affairs-library-refresh-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"affairs-library-refresh-contract.js","sourceRoot":"","sources":["../../../../src/modules/workspace/affairs-library-refresh-contract.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mCAAmC,GAAG;IACjD,gBAAgB,EAAE,mBAAmB;IACrC,aAAa,EAAE,gBAAgB;IAC/B,eAAe,EAAE,kBAAkB;IACnC,eAAe,EAAE,kBAAkB;IACnC,oBAAoB,EAAE,wBAAwB;IAC9C,gBAAgB,EAAE,oBAAoB;IACtC,mBAAmB,EAAE,uBAAuB;IAC5C,qBAAqB,EAAE,yBAAyB;IAChD,kBAAkB,EAAE,sBAAsB;IAC1C,oBAAoB,EAAE,yBAAyB;IAC/C,yBAAyB,EAAE,8BAA8B;IACzD,YAAY,EAAE,eAAe;IAC7B,aAAa,EAAE,gBAAgB;IAC/B,aAAa,EAAE,gBAAgB;IAC/B,eAAe,EAAE,kBAAkB;CAC3B,CAAC;AAEX,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,gBAAgB;CACvB,CAAC;AAEX,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,gBAAgB;IAC/B,eAAe,EAAE,kBAAkB;CAC3B,CAAC;AAEX,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAC/C,KAAK,EAAE,6BAA6B;IACpC,kBAAkB,EAAE,4CAA4C;IAChE,kBAAkB,EAAE,4CAA4C;IAChE,oBAAoB,EAAE,8CAA8C;IACpE,kBAAkB,EAAE,sBAAsB;IAC1C,+BAA+B,EAAE,qCAAqC;IACtE,+BAA+B,EAAE,qCAAqC;IACtE,mCAAmC,EAAE,yCAAyC;IAC9E,yBAAyB,EAAE,+BAA+B;CAClD,CAAC;AAEX,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,wBAAwB,EAAE,4BAA4B;IACtD,2BAA2B,EAAE,+BAA+B;IAC5D,iCAAiC,EAAE,sCAAsC;IACzE,oCAAoC,EAAE,yCAAyC;IAC/E,iBAAiB,EAAE,qBAAqB;IACxC,oBAAoB,EAAE,wBAAwB;IAC9C,0BAA0B,EAAE,+BAA+B;IAC3D,6BAA6B,EAAE,kCAAkC;CACzD,CAAC"}

package/dist/server/modules/workspace/affairs-library-service.d.ts

@@ -0,0 +1,353 @@
+import fs from "node:fs";
+import type { WorkspaceNavigationStateRepository } from "../../storage/repositories/workspace-navigation-state-repository.js";
+import type { UserAffairsLibrarySettingRepository } from "../../storage/repositories/user-affairs-library-setting-repository.js";
+import type { FileNode } from "../../types/domain.js";
+import { type FilePreviewResult } from "../file/file-preview-types.js";
+import type { TaskManager } from "../tasks/task-manager.js";
+import { type TaskSnapshot } from "../tasks/task-types.js";
+import type { WorkspaceService } from "./workspace-service.js";
+export declare const AFFAIRS_GLOBAL_WORKSPACE_ID = "affairs-global";
+export type AffairsLibraryDirectoryStateDto = "idle" | "queued" | "running" | "queue_timeout" | "fresh" | "failed";
+export type AffairsLibraryDirectorySourceDto = "live" | "snapshot" | "mixed" | "stale_fallback";
+export type AffairsLibraryFavoriteKind = "folder" | "tag";
+export interface AffairsLibraryFavoriteRecord {
+    kind: AffairsLibraryFavoriteKind;
+    path: string;
+    label: string;
+}
+export interface AffairsLibraryBindingDto {
+    workspaceId: string | null;
+    rootDir: string;
+    enabled: boolean;
+    mirrorRoot: string | null;
+    allowedExtensions: string[];
+    includedHiddenPaths?: string[];
+    folderOpenBehavior?: "single_click" | "double_click";
+    configRelativePath: string;
+    exportMode: "v2";
+    updatedAt: string;
+}
+export interface AffairsLibraryIndexStatusDto {
+    state: "fresh" | "stale" | "queued" | "running" | "queue_timeout" | "cooldown" | "failed";
+    dirtyReasons: string[];
+    lastRequestedAt: string | null;
+    lastStartedAt: string | null;
+    lastCompletedAt: string | null;
+    lastFailedAt: string | null;
+    nextAllowedAt: string | null;
+    runningTaskId: string | null;
+    runningStage: string | null;
+    errorSummary: string | null;
+    workerHealth?: AffairsLibraryWorkerHealthDto | null;
+    progress?: AffairsLibraryIndexProgressDto | null;
+}
+export interface AffairsLibraryWorkerHealthDto {
+    workerKey: string;
+    rootDir: string | null;
+    state: "idle" | "running" | "terminating" | "recycled";
+    pid: number | null;
+    inflightLocalCount: number;
+    inflightRemoteRequestCount: number;
+    startedAt: string | null;
+    lastHeartbeatAt: string | null;
+    lastStartedAt: string | null;
+    lastCompletedAt: string | null;
+    lastFailedAt: string | null;
+    lastSoftCancelRequestedAt: string | null;
+    lastHardKillAt: string | null;
+    lastExitAt: string | null;
+    lastTerminationReason: string | null;
+}
+export interface AffairsLibraryIndexProgressDto {
+    scannedCount: number;
+    indexedCount: number;
+    skippedCount: number;
+    failedCount: number;
+    unchangedCount: number;
+    totalCount: number | null;
+    maxConcurrency: number | null;
+}
+export interface AffairsLibraryDirectoryStatusDto {
+    path: string;
+    state: AffairsLibraryDirectoryStateDto;
+    source: AffairsLibraryDirectorySourceDto;
+    lastRequestedAt: string | null;
+    lastCompletedAt: string | null;
+    lastFailedAt: string | null;
+    runningTaskId: string | null;
+    errorSummary: string | null;
+    generatedAt?: string | null;
+    filesystemObservedAt?: string | null;
+    staleReason?: string | null;
+}
+export interface AffairsLibraryDocumentRecordDto {
+    documentId: string;
+    path: string;
+    title: string;
+    summary: string;
+    updatedAt: string;
+    createdAt?: string | null;
+    sizeBytes?: number | null;
+    tags: string[];
+    derivedTags: string[];
+    isFavorite: boolean;
+}
+export interface AffairsLibraryTagNodeDto {
+    path: string;
+    name: string;
+    rootType: string;
+    parentPath: string | null;
+    depth: number;
+    documentCount: number;
+}
+export interface AffairsLibraryFolderNodeDto {
+    path: string;
+    name: string;
+    parentPath: string | null;
+    directDocumentCount: number;
+    documentCount: number;
+    createdAt?: string | null;
+    updatedAt?: string | null;
+}
+export interface AffairsLibrarySnapshotDto {
+    binding: AffairsLibraryBindingDto | null;
+    status: AffairsLibraryIndexStatusDto;
+    tags: AffairsLibraryTagNodeDto[];
+    favorites: AffairsLibraryFavoriteRecord[];
+    folders: AffairsLibraryFolderNodeDto[];
+    documentCount: number;
+    lastError: string | null;
+}
+export interface ListAffairsLibraryDocumentsInput {
+    browseMode: "folder" | "tag";
+    selectedFolderPath?: string | null;
+    selectedTagPath?: string | null;
+    selectedTagPaths?: string[] | null;
+    selectedFavoriteId?: string | null;
+    keyword?: string | null;
+    offset?: number;
+    limit?: number;
+}
+export interface AffairsLibraryDocumentListDto {
+    total: number;
+    visibleEntryTotal?: number;
+    offset: number;
+    limit: number;
+    items: AffairsLibraryDocumentRecordDto[];
+    tagFacetCounts?: Record<string, number>;
+    directoryStatus?: AffairsLibraryDirectoryStatusDto | null;
+}
+export type AffairsLibraryOperationType = "delete" | "move" | "copy" | "create_directory" | "create_file" | "write";
+export interface AffairsLibraryDownloadDto {
+    workspaceId: string;
+    path: string;
+    fileName: string;
+    contentBase64: string;
+    size: number;
+    updatedAt: string;
+}
+export interface AffairsLibraryOperationResultDto {
+    success: true;
+    opType: AffairsLibraryOperationType;
+    sourcePath: string;
+    targetPath: string | null;
+}
+export interface AffairsLibraryResolvedPreviewFile {
+    workspaceId: string;
+    userId: string;
+    rootDir: string;
+    rootRealPath: string;
+    relativePath: string;
+    absolutePath: string;
+    exists: boolean;
+    stats: fs.Stats | null;
+}
+interface AffairsLibraryLogger {
+    info(bindings: Record<string, unknown>, message: string): void;
+    warn?(bindings: Record<string, unknown>, message: string): void;
+}
+interface UserAffairsLibrarySettingLike {
+    userId: string;
+    rootDir: string | null;
+    enabled: boolean;
+    favoritesJson: string | null;
+    lastWorkspaceId: string | null;
+    dashboardStateJson?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AffairsLibraryDirectoryHintTaskResult {
+    directoryPath: string;
+    refreshedAt: string;
+    source: AffairsLibraryDirectorySourceDto;
+    itemCount: number;
+    childDirectoryCount: number;
+    changedPaths: string[];
+    items: AffairsLibraryDocumentRecordDto[];
+    generatedAt: string | null;
+    filesystemObservedAt: string | null;
+}
+export declare class AffairsLibraryService {
+    private readonly workspaceService;
+    private readonly workspaceNavigationStateRepository;
+    private readonly userAffairsLibrarySettingRepository;
+    private readonly taskManager;
+    private readonly logger;
+    private readonly exportCache;
+    private readonly autoTaskStateByWorkspace;
+    private readonly hotDirectoryCache;
+    private readonly lightweightReconcileTimers;
+    private readonly reconcileObservationStateByWorkspace;
+    constructor(workspaceService: WorkspaceService, workspaceNavigationStateRepository: WorkspaceNavigationStateRepository, userAffairsLibrarySettingRepository: UserAffairsLibrarySettingRepository, taskManager: TaskManager, logger: AffairsLibraryLogger);
+    getGlobalBinding(userId: string): AffairsLibraryBindingDto | null;
+    getBinding(workspaceId: string, userId: string): AffairsLibraryBindingDto | null;
+    saveGlobalBinding(userId: string, rootDir: string): AffairsLibraryBindingDto;
+    setGlobalEnabled(userId: string, enabled: boolean): AffairsLibraryBindingDto;
+    updateGlobalFavorites(userId: string, favorites: AffairsLibraryFavoriteRecord[]): AffairsLibraryFavoriteRecord[];
+    getGlobalDashboardState(userId: string): Record<string, unknown>;
+    updateGlobalDashboardState(userId: string, dashboardState: unknown): Record<string, unknown>;
+    saveBinding(workspaceId: string, userId: string, rootDir: string): AffairsLibraryBindingDto;
+    setEnabled(workspaceId: string, userId: string, enabled: boolean): AffairsLibraryBindingDto;
+    getConfig(workspaceId: string, userId: string): {
+        binding: AffairsLibraryBindingDto | null;
+        mirrorRoot: string | null;
+        allowedExtensions: string[];
+        includedHiddenPaths?: string[];
+        folderOpenBehavior: "single_click" | "double_click";
+        configRelativePath: string;
+        canWrite: boolean;
+    };
+    saveConfig(workspaceId: string, userId: string, input: {
+        mirrorRoot?: string | null;
+        allowedExtensions?: string[];
+        includedHiddenPaths?: string[];
+        folderOpenBehavior?: "single_click" | "double_click";
+    }): Promise<{
+        binding: AffairsLibraryBindingDto;
+        mirrorRoot: string | null;
+        allowedExtensions: string[];
+        includedHiddenPaths?: string[];
+        folderOpenBehavior: "single_click" | "double_click";
+        configRelativePath: string;
+        canWrite: boolean;
+        applyConfigTaskId: string;
+        applyConfigStatus: AffairsLibraryIndexStatusDto;
+    }>;
+    getSnapshot(workspaceId: string, userId: string): AffairsLibrarySnapshotDto;
+    listDocuments(workspaceId: string, userId: string, input: ListAffairsLibraryDocumentsInput): AffairsLibraryDocumentListDto;
+    private listLiveFolderDocuments;
+    listFiles(workspaceId: string, userId: string, requestedPath: string | null | undefined, limit?: number): FileNode[];
+    private decideLiveDirectoryScan;
+    private buildCachedFolderDocuments;
+    private buildSnapshotFolderDocuments;
+    private buildFreshFolderDocuments;
+    private buildLiveDirectoryDocuments;
+    private writeDirectoryFallbackDebugLog;
+    updateFavorites(workspaceId: string, userId: string, favorites: AffairsLibraryFavoriteRecord[]): AffairsLibraryFavoriteRecord[];
+    previewDocument(workspaceId: string, userId: string, requestedPath: string): FilePreviewResult;
+    downloadFile(workspaceId: string, userId: string, requestedPath: string): AffairsLibraryDownloadDto;
+    operateFile(workspaceId: string, userId: string, input: {
+        opType: AffairsLibraryOperationType;
+        srcPath?: string;
+        dstPath?: string | null;
+        content?: string | null;
+        expectedVersion?: string | null;
+    }): AffairsLibraryOperationResultDto;
+    resolvePreviewFile(workspaceId: string, userId: string, requestedPath: string, options?: {
+        mustExist?: boolean;
+        kind?: "file" | "directory" | "any";
+        allowRoot?: boolean;
+    }): AffairsLibraryResolvedPreviewFile;
+    private ensureUserContentPath;
+    private afterFileMutation;
+    requestRefresh(workspaceId: string, userId: string, reason: string): {
+        taskId: string;
+        deduped: boolean;
+        status: AffairsLibraryIndexStatusDto;
+    };
+    requestRefreshHint(workspaceId: string, userId: string, reason: string, targetPath?: string | null): {
+        scheduled: boolean;
+        status: AffairsLibraryIndexStatusDto;
+        directoryStatus: AffairsLibraryDirectoryStatusDto | null;
+    };
+    notifyWorkspaceFileMutation(workspaceId: string, input: {
+        absolutePath: string;
+        kind: "upsert" | "delete";
+    }): void;
+    scheduleAutoRefresh(workspaceId: string, reason: string, targetPath?: string): void;
+    scheduleAutoApplyConfig(workspaceId: string, reason: string): void;
+    private syncLightweightReconcileTimers;
+    private ensureLightweightReconcileTimer;
+    private clearLightweightReconcileTimer;
+    private scheduleLightweightReconcile;
+    schedulePeriodicAudit(workspaceId: string, triggerReason: string): void;
+    private evaluateLightweightReconcile;
+    private evaluatePeriodicAudit;
+    private recordLightweightReconcileObservation;
+    private findRecentDirectoryDrift;
+    dispose(): void;
+    getRefreshTaskSnapshot(workspaceId: string): TaskSnapshot | null;
+    private readDirectoryStatus;
+    private getOrCreateHotDirectoryEntry;
+    private updateHotDirectoryCache;
+    private markHotDirectoryCacheDirty;
+    private ensureDirectoryWindow;
+    private scheduleDirectoryHintRefresh;
+    private runDirectoryHintTask;
+    private attachDirectoryHintTaskFollowUp;
+    private readFavorites;
+    private readIndexStatus;
+    private registerBackgroundTasks;
+    private runInternalCommand;
+    private resumeEnabledBindings;
+    private flushAutoTasks;
+    private getOrCreateAutoTaskState;
+    private armAutoTaskTimer;
+    private reconcileOrphanedRunningTasks;
+    private findActiveLibraryTaskSnapshots;
+    private findBlockingAutoTask;
+    private findRelevantIndexTaskSnapshot;
+    private attachAutoTaskFollowUp;
+    private readExportData;
+    private parseExportData;
+    private buildExportSignature;
+    private invalidateExportCache;
+    private readExportCacheFile;
+    private writeExportCacheFile;
+    private buildPreviewResult;
+    private readAvailableExportData;
+    private readLastUsableExportData;
+    private readConfig;
+    private readRawConfigFile;
+    getGlobalSetting(userId: string): UserAffairsLibrarySettingLike | null;
+    getEnabledBindingForWorkspace(workspaceId: string): UserAffairsLibrarySettingLike | null;
+    listEnabledBindingsForWatch(): Array<{
+        workspaceId: string | null;
+        rootDir: string | null;
+        enabled: boolean;
+    }>;
+    getBindingForWatch(workspaceId: string): {
+        workspaceId: string | null;
+        rootDir: string | null;
+        enabled: boolean;
+    } | null;
+    private buildBindingFromSetting;
+    private requireBinding;
+    private resolveLibrarySetting;
+    private upsertLibrarySetting;
+    private listEnabledSettingsWithWorkspace;
+    private findEnabledBindingByWorkspaceId;
+    private normalizeAffairsWorkspaceId;
+    private assertWorkspaceIdCanUseLegacyAffairsRoute;
+    private normalizeAndValidateBindingRootDir;
+    private normalizeFavorites;
+    private resolvePreferredWorkspaceId;
+    private ensureLibraryEnabled;
+    private assertLibraryRootDir;
+}
+export declare function runAffairsLibraryDirectoryHintInHelper(input: {
+    rootDir: string;
+    directoryPath: string;
+    signal?: AbortSignal;
+}): Promise<AffairsLibraryDirectoryHintTaskResult>;
+export {};