@moltos/sdk 0.7.2 → 0.10.0

package/dist/lib/clawfs.d.ts

@@ -1,277 +0,0 @@
-/**
- * ClawFS - Persistent File System for MoltOS SDK
- *
- * A content-addressed, merkle-backed storage system with tiered storage
- * and agent-native permissions. Designed to survive VM crashes and host moves.
- */
-/** Content Identifier - SHA-256 hash of file content */
-export type CID = string;
-/** Storage tier indicating access pattern and persistence level */
-export declare enum StorageTier {
-    /** Hot: Frequently accessed, memory-cached, local SSD */
-    HOT = "hot",
-    /** Warm: Occasionally accessed, local disk */
-    WARM = "warm",
-    /** Cold: Rarely accessed, replicated remote storage */
-    COLD = "cold"
-}
-/** Permission levels for file access */
-export declare enum Permission {
-    /** Read-only access */
-    READ = "read",
-    /** Write access (includes read) */
-    WRITE = "write",
-    /** Admin access (includes read, write, delete, share) */
-    ADMIN = "admin"
-}
-/** Access control entry for an agent */
-export interface AccessControl {
-    agentId: string;
-    permission: Permission;
-    grantedAt: Date;
-    grantedBy: string;
-    expiresAt?: Date;
-}
-/** Metadata for a stored file */
-export interface FileMetadata {
-    name: string;
-    mimeType: string;
-    size: number;
-    createdAt: Date;
-    modifiedAt: Date;
-    tags: string[];
-    encryptionKeyId?: string;
-    compression?: 'gzip' | 'lz4' | 'zstd';
-}
-/** Complete file entry in ClawFS */
-export interface FileEntry {
-    cid: CID;
-    owner: string;
-    metadata: FileMetadata;
-    tier: StorageTier;
-    accessControl: AccessControl[];
-    merkleRoot: string;
-    blocks: string[];
-    replicationFactor: number;
-    lastAccessedAt: Date;
-    accessCount: number;
-}
-/** Merkle tree node for integrity verification */
-export interface MerkleNode {
-    hash: string;
-    left?: MerkleNode;
-    right?: MerkleNode;
-    cid?: CID;
-}
-/** Snapshot of the file system state */
-export interface Snapshot {
-    id: string;
-    timestamp: Date;
-    merkleRoot: string;
-    fileCount: number;
-    totalSize: number;
-    previousSnapshot?: string;
-    includedFiles: CID[];
-}
-/** Search result with relevance scoring */
-export interface SearchResult {
-    cid: CID;
-    score: number;
-    highlights: string[];
-    metadata: FileMetadata;
-}
-/** Configuration for ClawFSClient */
-export interface ClawFSConfig {
-    agentId: string;
-    storagePath: string;
-    hotCacheSizeMB: number;
-    warmCacheSizeMB: number;
-    replicationFactor: number;
-    enableEncryption: boolean;
-    enableCompression: boolean;
-    snapshotIntervalHours: number;
-}
-/** Storage backend interface for pluggable backends */
-export interface StorageBackend {
-    get(cid: CID): Promise<Buffer | null>;
-    put(cid: CID, data: Buffer, tier: StorageTier): Promise<void>;
-    delete(cid: CID): Promise<void>;
-    exists(cid: CID): Promise<boolean>;
-    promote(cid: CID, toTier: StorageTier): Promise<void>;
-    demote(cid: CID, toTier: StorageTier): Promise<void>;
-}
-export declare class ClawFSError extends Error {
-    code: string;
-    constructor(message: string, code: string);
-}
-export declare class FileNotFoundError extends ClawFSError {
-    constructor(cid: CID);
-}
-export declare class PermissionDeniedError extends ClawFSError {
-    constructor(agentId: string, cid: CID, required: Permission);
-}
-export declare class StorageTierError extends ClawFSError {
-    constructor(message: string);
-}
-/** Compute SHA-256 CID for content */
-export declare function computeCID(data: Buffer): CID;
-/** Compute Merkle tree root from blocks */
-export declare function computeMerkleRoot(blocks: string[]): string;
-/** Chunk data into blocks for storage */
-export declare function chunkData(data: Buffer, blockSize?: number): Buffer[];
-declare class MemoryStorageBackend implements StorageBackend {
-    private hot;
-    private warm;
-    private cold;
-    private accessStats;
-    get(cid: CID): Promise<Buffer | null>;
-    put(cid: CID, data: Buffer, tier: StorageTier): Promise<void>;
-    delete(cid: CID): Promise<void>;
-    exists(cid: CID): Promise<boolean>;
-    promote(cid: CID, toTier: StorageTier): Promise<void>;
-    demote(cid: CID, toTier: StorageTier): Promise<void>;
-    getTier(cid: CID): StorageTier | null;
-    getStats(cid: CID): {
-        count: number;
-        lastAccessed: Date;
-    } | undefined;
-}
-declare class SearchIndex {
-    private index;
-    private metadata;
-    indexFile(cid: CID, metadata: FileMetadata, content?: string): void;
-    removeFile(cid: CID): void;
-    search(query: string, limit?: number): SearchResult[];
-}
-export declare class ClawFSClient {
-    private agentId;
-    private backend;
-    private fileIndex;
-    private snapshots;
-    private searchIndex;
-    private config;
-    constructor(config: ClawFSConfig, backend?: StorageBackend);
-    /**
-     * Store a file and return its Content Identifier (CID)
-     *
-     * @param data - File content as Buffer
-     * @param metadata - File metadata
-     * @param options - Storage options
-     * @returns The CID of the stored file
-     */
-    write(data: Buffer, metadata?: Partial<FileMetadata>, options?: {
-        tier?: StorageTier;
-        replicationFactor?: number;
-        encrypt?: boolean;
-        compress?: boolean;
-    }): Promise<CID>;
-    /**
-     * Retrieve a file by its CID
-     *
-     * @param cid - Content Identifier
-     * @param requesterAgentId - Optional agent ID for permission check (defaults to current agent)
-     * @returns File content as Buffer
-     */
-    read(cid: CID, requesterAgentId?: string): Promise<Buffer>;
-    /**
-     * Share a file with other agents
-     *
-     * @param cid - Content Identifier
-     * @param agentIds - Array of agent IDs to share with
-     * @param permission - Permission level to grant
-     * @returns The updated FileEntry
-     */
-    share(cid: CID, agentIds: string[], permission?: Permission): Promise<FileEntry>;
-    /**
-     * List files accessible to the current agent
-     *
-     * @param options - Filter options
-     * @returns Array of FileEntry objects
-     */
-    list(options?: {
-        ownedOnly?: boolean;
-        tier?: StorageTier;
-        tags?: string[];
-        limit?: number;
-        offset?: number;
-    }): Promise<FileEntry[]>;
-    /**
-     * Create a Merkle-backed snapshot of the current file system state
-     *
-     * @param options - Snapshot options
-     * @returns The created Snapshot
-     */
-    snapshot(options?: {
-        includeFiles?: CID[];
-        excludeFiles?: CID[];
-    }): Promise<Snapshot>;
-    /**
-     * Semantic search across files
-     *
-     * @param query - Search query string
-     * @param options - Search options
-     * @returns Array of SearchResult objects
-     */
-    search(query: string, options?: {
-        limit?: number;
-        includeContent?: boolean;
-        tags?: string[];
-    }): Promise<SearchResult[]>;
-    /**
-     * Change the storage tier of a file
-     *
-     * @param cid - Content Identifier
-     * @param tier - Target storage tier
-     */
-    setTier(cid: CID, tier: StorageTier): Promise<void>;
-    /**
-     * Delete a file (requires ADMIN permission)
-     *
-     * @param cid - Content Identifier
-     */
-    delete(cid: CID): Promise<void>;
-    /**
-     * Get file entry metadata without reading content
-     *
-     * @param cid - Content Identifier
-     * @returns FileEntry if found and accessible
-     */
-    stat(cid: CID): Promise<FileEntry | null>;
-    /**
-     * Get all snapshots
-     *
-     * @returns Array of snapshots
-     */
-    getSnapshots(): Promise<Snapshot[]>;
-    /**
-     * Verify file integrity using Merkle tree
-     *
-     * @param cid - Content Identifier
-     * @returns True if file is valid
-     */
-    verify(cid: CID): Promise<boolean>;
-    private inferTier;
-    private hasPermission;
-    private promoteToTier;
-    private generateKeyId;
-    /**
-     * Export file system state for persistence
-     *
-     * @returns Serialized state
-     */
-    exportState(): object;
-    /**
-     * Import file system state (for recovery after crash)
-     *
-     * @param state - Serialized state
-     */
-    importState(state: {
-        agentId: string;
-        files: [CID, FileEntry][];
-        snapshots: Snapshot[];
-        config: ClawFSConfig;
-    }): void;
-}
-export default ClawFSClient;
-export { MemoryStorageBackend, SearchIndex, };
-//# sourceMappingURL=clawfs.d.ts.map

package/dist/lib/clawfs.d.ts.map

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