@struktoai/mirage-core/dist/core/qdrant/naming.d.ts

A Unified Virtual Filesystem For AI Agents

import type { resolveQdrantConfig } from '../../vfs/qdrant/config.ts';
import type { QdrantRow } from './types.ts';
/**
 * Render one payload value as a VFS directory segment.
 *
 * A non-string value spells the way the point's `.json` spells it, so
 * TypeScript and Python render one tree. Every level then renders through
 * `PATH_SAFE`, so the scope table decodes a segment back to the exact value it
 * stands for. A basename level first drops the value's URL or path parents,
 * which is lossy, so the lister resolves such a segment against the payload
 * instead of decoding it. A leaf longer than NAME_MAX, which ext4 and APFS
 * refuse, is cut to fit and keeps the md5 of the whole segment as its id,
 * the `<label>__<id>` shape every long name takes, so two leaves the cut
 * would merge stay two directories.
 */
export declare function groupName(value: unknown, basename?: boolean): string;
/** Return the stable, human-readable stem for a point's files. */
export declare function rowStem(row: QdrantRow, config: ReturnType<typeof resolveQdrantConfig>): string;
/** Recover the opaque Qdrant point id from a VFS file stem. */
export declare function pointIdFromStem(stem: string, config: ReturnType<typeof resolveQdrantConfig>): string;
//# sourceMappingURL=naming.d.ts.map