import { NappletMessage, FsChange, FsInfo, FsError, FsPickResult, FsMetadata, FsDirectoryEntry, FsReadResult, FsWriteResult, FsMkdirOptions, FsPickOptions, FsReadOptions, FsWriteOptions, FsWatchOptions } from '@napplet/core';
export { FsAcceptRule, FsChange, FsChangeKind, FsDirectoryEntry, FsEntryKind, FsError, FsInfo, FsLimits, FsMetadata, FsMkdirOptions, FsPermission, FsPickOptions, FsPickResult, FsPickedEntry, FsReadOptions, FsReadResult, FsRoot, FsWatchOptions, FsWriteMode, FsWriteOptions, FsWriteResult } from '@napplet/core';

/**
 * Napplet NAP fs types entrypoint.
 *
 * @module
 */
/**
 * @napplet/nap/fs -- Shell-mediated virtual filesystem message types for the JSON envelope wire protocol.
 *
 * NAP-FS gives a napplet access to a runtime-owned virtual filesystem. The
 * napplet sees only virtual paths, directory entries, coarse metadata, and
 * advisory change events. The runtime owns host paths, mounts, backing store,
 * normalization, policy, and authorization of every operation.
 *
 * Defines the message types exchanged between napplet and shell:
 * - Napplet -> Shell: info, pickFile, pickFiles, pickDirectory, pickSaveFile,
 *   stat, list, read, write, mkdir, remove, move, watch, unwatch
 * - Shell -> Napplet: the matching results plus runtime-pushed changed
 *
 * All types form a discriminated union on the `type` field.
 */

/** The NAP domain name for fs messages. */
declare const DOMAIN: "fs";

/**
 * Base interface for all fs NAP messages.
 * Concrete message types narrow the `type` field to specific literals.
 */
interface FsMessage extends NappletMessage {
    /** Message type in "fs.<action>" format. */
    type: `fs.${string}`;
}
/** Discover visible roots, coarse permissions, and runtime limits. */
interface FsInfoMessage extends FsMessage {
    type: 'fs.info';
    /** Correlation ID for this request. */
    id: string;
}
/** Result of a `fs.info` request. */
interface FsInfoResultMessage extends FsMessage {
    type: 'fs.info.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Advisory discovery data. Absent when `error` is present. */
    info?: FsInfo;
    /** Error reason when the runtime could not answer. */
    error?: FsError;
}
/** Ask the runtime to let the user select one file. */
interface FsPickFileMessage extends FsMessage {
    type: 'fs.pickFile';
    /** Correlation ID for this request. */
    id: string;
    /** Optional picker hints. */
    options?: FsPickOptions;
}
/** Result of a `fs.pickFile` request. */
interface FsPickFileResultMessage extends FsMessage {
    type: 'fs.pickFile.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Picked virtual path. Absent when `error` is present. */
    result?: FsPickResult;
    /** Error reason, including `cancelled` when the user cancels. */
    error?: FsError;
}
/** Ask the runtime to let the user select one or more files. */
interface FsPickFilesMessage extends FsMessage {
    type: 'fs.pickFiles';
    /** Correlation ID for this request. */
    id: string;
    /** Optional picker hints. */
    options?: FsPickOptions;
}
/** Result of a `fs.pickFiles` request. */
interface FsPickFilesResultMessage extends FsMessage {
    type: 'fs.pickFiles.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Picked virtual paths. Absent when `error` is present. */
    result?: FsPickResult;
    /** Error reason, including `cancelled` when the user cancels. */
    error?: FsError;
}
/** Ask the runtime to let the user select one directory. */
interface FsPickDirectoryMessage extends FsMessage {
    type: 'fs.pickDirectory';
    /** Correlation ID for this request. */
    id: string;
    /** Optional picker hints. */
    options?: FsPickOptions;
}
/** Result of a `fs.pickDirectory` request. */
interface FsPickDirectoryResultMessage extends FsMessage {
    type: 'fs.pickDirectory.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Picked virtual path. Absent when `error` is present. */
    result?: FsPickResult;
    /** Error reason, including `cancelled` when the user cancels. */
    error?: FsError;
}
/** Ask the runtime to let the user select or name one file destination. */
interface FsPickSaveFileMessage extends FsMessage {
    type: 'fs.pickSaveFile';
    /** Correlation ID for this request. */
    id: string;
    /** Optional picker hints. */
    options?: FsPickOptions;
}
/** Result of a `fs.pickSaveFile` request. */
interface FsPickSaveFileResultMessage extends FsMessage {
    type: 'fs.pickSaveFile.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Picked virtual path. Absent when `error` is present. */
    result?: FsPickResult;
    /** Error reason, including `cancelled` when the user cancels. */
    error?: FsError;
}
/** Read coarse metadata for a visible entry. */
interface FsStatMessage extends FsMessage {
    type: 'fs.stat';
    /** Correlation ID for this request. */
    id: string;
    /** Virtual absolute path of the entry. */
    path: string;
}
/** Result of a `fs.stat` request. */
interface FsStatResultMessage extends FsMessage {
    type: 'fs.stat.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Entry metadata. Absent when `error` is present. */
    metadata?: FsMetadata;
    /** Error reason when the runtime could not stat the entry. */
    error?: FsError;
}
/** List the direct children of a visible directory. */
interface FsListMessage extends FsMessage {
    type: 'fs.list';
    /** Correlation ID for this request. */
    id: string;
    /** Virtual absolute path of the directory. */
    path: string;
}
/** Result of a `fs.list` request. */
interface FsListResultMessage extends FsMessage {
    type: 'fs.list.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Directory entries in unspecified order. Absent when `error` is present. */
    entries?: FsDirectoryEntry[];
    /** Error reason when the runtime could not list the directory. */
    error?: FsError;
}
/** Read bytes from a visible file. */
interface FsReadMessage extends FsMessage {
    type: 'fs.read';
    /** Correlation ID for this request. */
    id: string;
    /** Virtual absolute path of the file. */
    path: string;
    /** Optional range read controls. */
    options?: FsReadOptions;
}
/** Result of a `fs.read` request. */
interface FsReadResultMessage extends FsMessage {
    type: 'fs.read.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Read result. `data` is RFC 4648 standard padded base64 text. Absent when `error` is present. */
    result?: FsReadResult;
    /** Error reason when the runtime could not read the file. */
    error?: FsError;
}
/** Write bytes to a visible file. */
interface FsWriteMessage extends FsMessage {
    type: 'fs.write';
    /** Correlation ID for this request. */
    id: string;
    /** Virtual absolute path of the file. */
    path: string;
    /** Decoded bytes encoded as RFC 4648 standard padded base64 text. */
    data: string;
    /** Optional write mode and preconditions. */
    options?: FsWriteOptions;
}
/** Result of a `fs.write` request. */
interface FsWriteResultMessage extends FsMessage {
    type: 'fs.write.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Write result. Absent when `error` is present. */
    result?: FsWriteResult;
    /** Error reason when the runtime could not write the file. */
    error?: FsError;
}
/** Create a directory. */
interface FsMkdirMessage extends FsMessage {
    type: 'fs.mkdir';
    /** Correlation ID for this request. */
    id: string;
    /** Virtual absolute path of the directory to create. */
    path: string;
    /** Optional recursive parent creation. */
    options?: FsMkdirOptions;
}
/** Result of a `fs.mkdir` request. */
interface FsMkdirResultMessage extends FsMessage {
    type: 'fs.mkdir.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Error reason when the runtime could not create the directory. */
    error?: FsError;
}
/** Remove a file or directory. */
interface FsRemoveMessage extends FsMessage {
    type: 'fs.remove';
    /** Correlation ID for this request. */
    id: string;
    /** Virtual absolute path of the entry to remove. */
    path: string;
    /** Remove a non-empty directory and its authorized descendants. Top-level, not nested in options. */
    recursive?: boolean;
}
/** Result of a `fs.remove` request. */
interface FsRemoveResultMessage extends FsMessage {
    type: 'fs.remove.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Error reason when the runtime could not remove the entry. */
    error?: FsError;
}
/** Move or rename a file or directory. */
interface FsMoveMessage extends FsMessage {
    type: 'fs.move';
    /** Correlation ID for this request. */
    id: string;
    /** Virtual absolute source path. */
    fromPath: string;
    /** Virtual absolute destination path. */
    toPath: string;
}
/** Result of a `fs.move` request. */
interface FsMoveResultMessage extends FsMessage {
    type: 'fs.move.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Error reason when the runtime could not move the entry. */
    error?: FsError;
}
/** Start an advisory watch on a visible path. */
interface FsWatchMessage extends FsMessage {
    type: 'fs.watch';
    /** Correlation ID for this request. */
    id: string;
    /** Virtual absolute path to watch. */
    path: string;
    /** Optional recursive descendant coverage. */
    options?: FsWatchOptions;
}
/** Result of a `fs.watch` request. */
interface FsWatchResultMessage extends FsMessage {
    type: 'fs.watch.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Runtime-generated watch id. Absent when `error` is present. */
    watchId?: string;
    /** Error reason when the runtime could not start the watch. */
    error?: FsError;
}
/** Stop a watch. */
interface FsUnwatchMessage extends FsMessage {
    type: 'fs.unwatch';
    /** Correlation ID for this request. */
    id: string;
    /** Runtime-generated watch id. */
    watchId: string;
}
/** Result of a `fs.unwatch` request. */
interface FsUnwatchResultMessage extends FsMessage {
    type: 'fs.unwatch.result';
    /** Correlation ID matching the original request. */
    id: string;
    /** Error reason when the runtime could not stop the watch. */
    error?: FsError;
}
/** Runtime-pushed advisory change event. Carries no correlation id. */
interface FsChangedMessage extends FsMessage {
    type: 'fs.changed';
    /** The change signal. Advisory only -- re-read after receiving it. */
    change: FsChange;
}
/** Napplet -> Shell fs messages. */
type FsOutboundMessage = FsInfoMessage | FsPickFileMessage | FsPickFilesMessage | FsPickDirectoryMessage | FsPickSaveFileMessage | FsStatMessage | FsListMessage | FsReadMessage | FsWriteMessage | FsMkdirMessage | FsRemoveMessage | FsMoveMessage | FsWatchMessage | FsUnwatchMessage;
/** Shell -> Napplet fs messages. */
type FsInboundMessage = FsInfoResultMessage | FsPickFileResultMessage | FsPickFilesResultMessage | FsPickDirectoryResultMessage | FsPickSaveFileResultMessage | FsStatResultMessage | FsListResultMessage | FsReadResultMessage | FsWriteResultMessage | FsMkdirResultMessage | FsRemoveResultMessage | FsMoveResultMessage | FsWatchResultMessage | FsUnwatchResultMessage | FsChangedMessage;
/** All fs NAP message types (discriminated union on `type` field). */
type FsNapMessage = FsOutboundMessage | FsInboundMessage;

export { DOMAIN, type FsChangedMessage, type FsInboundMessage, type FsInfoMessage, type FsInfoResultMessage, type FsListMessage, type FsListResultMessage, type FsMessage, type FsMkdirMessage, type FsMkdirResultMessage, type FsMoveMessage, type FsMoveResultMessage, type FsNapMessage, type FsOutboundMessage, type FsPickDirectoryMessage, type FsPickDirectoryResultMessage, type FsPickFileMessage, type FsPickFileResultMessage, type FsPickFilesMessage, type FsPickFilesResultMessage, type FsPickSaveFileMessage, type FsPickSaveFileResultMessage, type FsReadMessage, type FsReadResultMessage, type FsRemoveMessage, type FsRemoveResultMessage, type FsStatMessage, type FsStatResultMessage, type FsUnwatchMessage, type FsUnwatchResultMessage, type FsWatchMessage, type FsWatchResultMessage, type FsWriteMessage, type FsWriteResultMessage };