@autorag/librarian 2.3.0 → 2.4.0

package/dist/datasource/types.d.ts

@@ -14,8 +14,9 @@
  *    `undefined`-as-deny.
  *  - Model/tool arguments never grant access. Only the trusted server-supplied
  *    {@link DatasourceAccessContext} can authorize a datasource.
- *  - Datasource sources are slash-hierarchical opaque paths such as
- *    `/kakao/<instance-id>/chunks/<chunk-id>`; `#` fragments are rejected.
+ *  - Datasource sources are slash-hierarchical opaque paths when the skill
+ *    supports the `scoped` capability; skills without that capability may
+ *    expose another opaque identity format.
  */
 import type { RetrievalMethod } from "../retrieval/types.js";
 export type { RetrievalMethod } from "../retrieval/types.js";
@@ -62,6 +63,8 @@ export interface DatasourceSkillDescriptor {
 export interface DatasourceAccessible {
     readonly datasourceId?: string;
     readonly tags?: readonly string[];
+    /** Capability names such as `scoped`; absent means no source-scope support. */
+    readonly capabilities?: readonly string[];
 }
 /**
  * A pluggable datasource skill. Skills are server-bound: they are constructed

package/dist/filesystem/cloud-placeholder.d.ts

@@ -0,0 +1,26 @@
+/** Darwin st_flags bit used by iCloud/File Provider data-less placeholders. */
+export declare const UF_DATALESS = 32768;
+export declare const FILE_PROVIDER_XATTR = "com.apple.file-provider-domain-id";
+/** Windows FILE_ATTRIBUTE_* bits commonly used by Cloud Files placeholders. */
+export declare const WINDOWS_FILE_ATTRIBUTE_OFFLINE = 4096;
+export declare const WINDOWS_FILE_ATTRIBUTE_RECALL_ON_OPEN = 262144;
+export declare const WINDOWS_FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS = 4194304;
+export type FilesystemKind = "local" | "file-provider";
+export interface FilesystemClassification {
+    readonly kind: FilesystemKind;
+    readonly provider?: string;
+    readonly reason: "path-marker" | "file-provider-xattr" | "cloud-volume" | "placeholder-attribute" | "local";
+}
+export declare function pathLooksLikeCloudRoot(target: string): boolean;
+export declare function homeCloudRoots(home?: string): readonly string[];
+export declare function classifyFilesystemRoot(target: string): Promise<FilesystemClassification>;
+export declare function isDatalessPlaceholder(target: string): Promise<boolean>;
+export interface MaterializedWalk {
+    readonly materialized: readonly string[];
+    readonly skippedDataless: number;
+}
+export declare function listMaterializedFiles(root: string, options?: {
+    readonly limit?: number;
+    readonly timeoutMs?: number;
+}): Promise<MaterializedWalk>;
+export declare function relativeCloudHint(root: string, filePath: string): string;