tglfs 0.1.0

package/dist/shared/upload.d.ts

@@ -0,0 +1,44 @@
+import type { FileCardRecord } from "./file-cards.js";
+type UploadApiLike = {
+    messages: {
+        EditMessage: new (args: any) => any;
+    };
+    upload: {
+        SaveBigFilePart: new (args: any) => any;
+    };
+    InputFileBig: new (args: any) => any;
+};
+type UploadClient = {
+    sendMessage(peer: string, options: {
+        message: string;
+    }): Promise<any>;
+    sendFile(peer: string, options: {
+        file: any;
+    }): Promise<any>;
+    invoke(request: any): Promise<any>;
+    getMessages(peer: string, options: unknown): Promise<any[]>;
+};
+export type UploadSource = {
+    name: string;
+    size: number;
+    stream(): ReadableStream<Uint8Array> | Promise<ReadableStream<Uint8Array>>;
+};
+export type UploadProgress = {
+    bytesProcessed: number;
+    totalBytes: number;
+};
+export type UploadCurrentFormatOptions = {
+    Api: UploadApiLike;
+    peer?: string;
+    chunkSize: number;
+    password: string;
+    source: UploadSource;
+    onUfidProgress?: (progress: UploadProgress) => void;
+    onUploadProgress?: (progress: UploadProgress) => void;
+};
+export declare class DuplicateUfidError extends Error {
+    readonly ufid: string;
+    constructor(ufid: string);
+}
+export declare function uploadCurrentFormatSource(client: UploadClient, options: UploadCurrentFormatOptions): Promise<FileCardRecord>;
+export {};

package/dist/shared/upload.js

@@ -0,0 +1,181 @@
+import { Buffer } from "buffer";
+import { deriveAESKeyFromPassword, ENCRYPTION_CHUNK_SIZE, incrementCounter64By } from "../crypto.js";
+import { computeUfidFromStream } from "../ufid.js";
+import { UPLOAD_PART_SIZE } from "./constants.js";
+import { serializeFileCardMessage } from "./file-cards.js";
+import { lookupFileCardByUfid } from "./telegram-files.js";
+export class DuplicateUfidError extends Error {
+    ufid;
+    constructor(ufid) {
+        super(`A file with UFID ${ufid} already exists.`);
+        this.name = "DuplicateUfidError";
+        this.ufid = ufid;
+    }
+}
+function createUploadFileId() {
+    const random = globalThis.crypto.getRandomValues(new Uint32Array(2));
+    return (BigInt(random[0] & 0x001fffff) << 32n) | BigInt(random[1]);
+}
+function createIvBytes(salt, counter) {
+    const bytes = new Uint8Array(salt.length + counter.length);
+    bytes.set(salt, 0);
+    bytes.set(counter, salt.length);
+    return bytes;
+}
+function resolvePeer(peer) {
+    return peer?.trim() ? peer.trim() : "me";
+}
+export async function uploadCurrentFormatSource(client, options) {
+    if (options.chunkSize < UPLOAD_PART_SIZE) {
+        throw new Error(`chunkSize (${options.chunkSize}) must be at least UPLOAD_PART_SIZE (${UPLOAD_PART_SIZE}).`);
+    }
+    const peer = resolvePeer(options.peer);
+    const totalBytes = options.source.size;
+    const ufid = await computeUfidFromStream(await options.source.stream(), (bytesProcessed, streamTotalBytes) => options.onUfidProgress?.({ bytesProcessed, totalBytes: streamTotalBytes }), totalBytes);
+    const duplicate = await lookupFileCardByUfid(client, ufid, { peer });
+    if (duplicate) {
+        throw new DuplicateUfidError(ufid);
+    }
+    const salt = globalThis.crypto.getRandomValues(new Uint8Array(16));
+    const initialCounter = globalThis.crypto.getRandomValues(new Uint8Array(16));
+    const aesKey = await deriveAESKeyFromPassword(options.password, salt);
+    let encryptionCounter = new Uint8Array(initialCounter);
+    let fileCardData = {
+        name: options.source.name,
+        ufid,
+        size: totalBytes,
+        uploadComplete: false,
+        chunks: [],
+        IV: Buffer.from(createIvBytes(salt, initialCounter)).toString("base64"),
+    };
+    const fileCardMessage = await client.sendMessage(peer, {
+        message: serializeFileCardMessage(fileCardData),
+    });
+    let uploadBytesProcessed = 0;
+    const byteCounterStream = new TransformStream({
+        transform(chunk, controller) {
+            uploadBytesProcessed += chunk.length;
+            options.onUploadProgress?.({ bytesProcessed: uploadBytesProcessed, totalBytes });
+            controller.enqueue(chunk);
+        },
+    });
+    const sourceStream = await options.source.stream();
+    const reader = sourceStream.pipeThrough(byteCounterStream).pipeThrough(new CompressionStream("gzip")).getReader();
+    let chunkIndex = 0;
+    let chunkBytesWritten = 0;
+    let chunkFileId = createUploadFileId();
+    let nextPartIndex = 0;
+    const partBuffer = new Uint8Array(UPLOAD_PART_SIZE);
+    let partBufferLength = 0;
+    const encryptionBuffer = new Uint8Array(ENCRYPTION_CHUNK_SIZE);
+    let encryptionBufferLength = 0;
+    const uploadPart = async (fileTotalParts) => {
+        const bytes = partBuffer.subarray(0, partBufferLength);
+        const result = await client.invoke(new options.Api.upload.SaveBigFilePart({
+            fileId: chunkFileId,
+            filePart: nextPartIndex,
+            fileTotalParts,
+            bytes: Buffer.from(bytes),
+        }));
+        if (!result) {
+            throw new Error(`Failed to upload chunk ${chunkIndex + 1} part ${nextPartIndex + 1}.`);
+        }
+        nextPartIndex += 1;
+        partBufferLength = 0;
+    };
+    const finalizeChunk = async (uploadComplete) => {
+        if (nextPartIndex === 0) {
+            return;
+        }
+        const uploadedChunk = new options.Api.InputFileBig({
+            id: chunkFileId,
+            parts: nextPartIndex,
+            name: `${ufid}.chunk${chunkIndex + 1}`,
+        });
+        const chunkMessage = await client.sendFile(peer, { file: uploadedChunk });
+        fileCardData = {
+            ...fileCardData,
+            uploadComplete,
+            chunks: [...fileCardData.chunks, chunkMessage.id],
+        };
+        await client.invoke(new options.Api.messages.EditMessage({
+            peer: fileCardMessage.peerId,
+            id: fileCardMessage.id,
+            message: serializeFileCardMessage(fileCardData),
+        }));
+        chunkIndex += 1;
+        chunkBytesWritten = 0;
+        chunkFileId = createUploadFileId();
+        nextPartIndex = 0;
+    };
+    const appendEncryptedBytes = async (bytes) => {
+        let offset = 0;
+        while (offset < bytes.length) {
+            const remainingChunkSpace = options.chunkSize - chunkBytesWritten;
+            const bytesToCopy = Math.min(bytes.length - offset, UPLOAD_PART_SIZE - partBufferLength, remainingChunkSpace);
+            partBuffer.set(bytes.subarray(offset, offset + bytesToCopy), partBufferLength);
+            offset += bytesToCopy;
+            partBufferLength += bytesToCopy;
+            chunkBytesWritten += bytesToCopy;
+            const partFull = partBufferLength === UPLOAD_PART_SIZE;
+            const chunkFull = chunkBytesWritten === options.chunkSize;
+            if (chunkFull) {
+                await uploadPart(nextPartIndex + 1);
+                await finalizeChunk(false);
+                continue;
+            }
+            if (partFull) {
+                await uploadPart(-1);
+            }
+        }
+    };
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        if (!value || value.length === 0) {
+            continue;
+        }
+        let valueOffset = 0;
+        while (valueOffset < value.length) {
+            const bytesToCopy = Math.min(value.length - valueOffset, encryptionBuffer.length - encryptionBufferLength);
+            encryptionBuffer.set(value.subarray(valueOffset, valueOffset + bytesToCopy), encryptionBufferLength);
+            encryptionBufferLength += bytesToCopy;
+            valueOffset += bytesToCopy;
+            if (encryptionBufferLength === encryptionBuffer.length) {
+                const encrypted = new Uint8Array(await globalThis.crypto.subtle.encrypt({ name: "AES-CTR", counter: encryptionCounter, length: 64 }, aesKey, encryptionBuffer));
+                encryptionCounter = incrementCounter64By(encryptionCounter, Math.ceil(encryptionBuffer.length / 16));
+                encryptionBufferLength = 0;
+                await appendEncryptedBytes(encrypted);
+            }
+        }
+    }
+    if (encryptionBufferLength > 0) {
+        const encryptedTail = new Uint8Array(await globalThis.crypto.subtle.encrypt({ name: "AES-CTR", counter: encryptionCounter, length: 64 }, aesKey, encryptionBuffer.subarray(0, encryptionBufferLength)));
+        encryptionCounter = incrementCounter64By(encryptionCounter, Math.ceil(encryptionBufferLength / 16));
+        encryptionBufferLength = 0;
+        await appendEncryptedBytes(encryptedTail);
+    }
+    if (partBufferLength > 0) {
+        await uploadPart(nextPartIndex + 1);
+    }
+    await finalizeChunk(true);
+    if (!fileCardData.uploadComplete) {
+        fileCardData = {
+            ...fileCardData,
+            uploadComplete: true,
+        };
+        await client.invoke(new options.Api.messages.EditMessage({
+            peer: fileCardMessage.peerId,
+            id: fileCardMessage.id,
+            message: serializeFileCardMessage(fileCardData),
+        }));
+    }
+    return {
+        msgId: fileCardMessage.id,
+        date: fileCardMessage.date,
+        data: fileCardData,
+    };
+}
+//# sourceMappingURL=upload.js.map

package/dist/shared/upload.js.map

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

package/dist/store.d.ts

@@ -0,0 +1,15 @@
+import type { PersistedConfig } from "./types.js";
+export declare const storePaths: {
+    configDir: string;
+    dataDir: string;
+    configFile: string;
+    sessionFile: string;
+};
+export declare function loadConfig(): Promise<PersistedConfig | null>;
+export declare function saveConfig(config: PersistedConfig): Promise<void>;
+export declare function deleteConfig(): Promise<void>;
+export declare function loadSessionString(): Promise<string | null>;
+export declare function saveSessionString(session: string): Promise<void>;
+export declare function deleteSessionString(): Promise<void>;
+export declare function clearPersistedState(removeConfig?: boolean): Promise<void>;
+export declare function sessionExists(): Promise<boolean>;

package/dist/store.js

@@ -0,0 +1,97 @@
+import envPaths from "env-paths";
+import { mkdir, readFile, rm, stat, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { CliError, EXIT_CODES } from "./errors.js";
+import { BUNDLED_CHUNK_SIZE } from "./shared/constants.js";
+const appPaths = envPaths("tglfs", { suffix: "" });
+export const storePaths = {
+    configDir: appPaths.config,
+    dataDir: appPaths.data,
+    configFile: join(appPaths.config, "config.json"),
+    sessionFile: join(appPaths.data, "session.txt"),
+};
+function validateConfig(value) {
+    if (!value || typeof value !== "object") {
+        throw new CliError("invalid_config", "Stored config is invalid.", EXIT_CODES.MISSING_AUTH);
+    }
+    const record = value;
+    if (typeof record.apiId !== "number" ||
+        !Number.isFinite(record.apiId) ||
+        typeof record.apiHash !== "string" ||
+        record.apiHash.trim() === "" ||
+        (record.chunkSize !== undefined &&
+            (typeof record.chunkSize !== "number" || !Number.isFinite(record.chunkSize) || record.chunkSize <= 0)) ||
+        typeof record.phone !== "string" ||
+        record.phone.trim() === "") {
+        throw new CliError("invalid_config", "Stored config is invalid.", EXIT_CODES.MISSING_AUTH);
+    }
+    return {
+        apiId: record.apiId,
+        apiHash: record.apiHash,
+        chunkSize: record.chunkSize ?? BUNDLED_CHUNK_SIZE,
+        phone: record.phone,
+    };
+}
+async function ensureParentDir(filePath) {
+    await mkdir(dirname(filePath), { recursive: true });
+}
+async function writePrivateFile(filePath, content) {
+    await ensureParentDir(filePath);
+    await writeFile(filePath, content, { encoding: "utf8", mode: 0o600 });
+}
+export async function loadConfig() {
+    try {
+        const raw = await readFile(storePaths.configFile, "utf8");
+        return validateConfig(JSON.parse(raw));
+    }
+    catch (error) {
+        if (error?.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function saveConfig(config) {
+    await writePrivateFile(storePaths.configFile, JSON.stringify(config, null, 2) + "\n");
+}
+export async function deleteConfig() {
+    await rm(storePaths.configFile, { force: true });
+}
+export async function loadSessionString() {
+    try {
+        const raw = await readFile(storePaths.sessionFile, "utf8");
+        const session = raw.trim();
+        return session === "" ? null : session;
+    }
+    catch (error) {
+        if (error?.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+export async function saveSessionString(session) {
+    await writePrivateFile(storePaths.sessionFile, session.trim() + "\n");
+}
+export async function deleteSessionString() {
+    await rm(storePaths.sessionFile, { force: true });
+}
+export async function clearPersistedState(removeConfig = false) {
+    await deleteSessionString();
+    if (removeConfig) {
+        await deleteConfig();
+    }
+}
+export async function sessionExists() {
+    try {
+        await stat(storePaths.sessionFile);
+        return true;
+    }
+    catch (error) {
+        if (error?.code === "ENOENT") {
+            return false;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+export type PersistedConfig = {
+    apiId: number;
+    apiHash: string;
+    chunkSize: number;
+    phone: string;
+};
+export type { FileCardData, FileCardRecord } from "./shared/file-cards.js";
+export type JsonEnvelope<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        details?: unknown;
+    };
+};

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/ufid.d.ts

@@ -0,0 +1,8 @@
+export declare class UfidAccumulator {
+    private rolling;
+    private pending;
+    update(chunk: Uint8Array): Promise<void>;
+    digest(): Promise<string>;
+}
+export declare function computeUfidFromStream(stream: ReadableStream<Uint8Array>, onProgress?: (bytesProcessed: number, totalBytes: number) => void, totalBytes?: number): Promise<string>;
+export declare function computeUfidFromBytes(bytes: Uint8Array): Promise<string>;

package/dist/ufid.js

@@ -0,0 +1,65 @@
+const UFID_CHUNK_SIZE = 64 * 1024;
+function toHex(bytes) {
+    return Array.from(bytes)
+        .map((byte) => byte.toString(16).padStart(2, "0"))
+        .join("");
+}
+async function digestChunk(rolling, chunk) {
+    const toHash = new Uint8Array(rolling.length + chunk.length);
+    toHash.set(rolling, 0);
+    toHash.set(chunk, rolling.length);
+    const digest = await globalThis.crypto.subtle.digest("SHA-256", toHash.buffer);
+    return new Uint8Array(digest);
+}
+export class UfidAccumulator {
+    rolling = new Uint8Array(0);
+    pending = new Uint8Array(0);
+    async update(chunk) {
+        if (chunk.length === 0) {
+            return;
+        }
+        const combined = new Uint8Array(this.pending.length + chunk.length);
+        combined.set(this.pending, 0);
+        combined.set(chunk, this.pending.length);
+        let offset = 0;
+        while (offset + UFID_CHUNK_SIZE <= combined.length) {
+            const piece = combined.subarray(offset, offset + UFID_CHUNK_SIZE);
+            this.rolling = await digestChunk(this.rolling, piece);
+            offset += UFID_CHUNK_SIZE;
+        }
+        this.pending = combined.slice(offset);
+    }
+    async digest() {
+        if (this.pending.length > 0) {
+            const padded = new Uint8Array(UFID_CHUNK_SIZE);
+            padded.set(this.pending, 0);
+            this.rolling = await digestChunk(this.rolling, padded);
+            this.pending = new Uint8Array(0);
+        }
+        return toHex(this.rolling);
+    }
+}
+export async function computeUfidFromStream(stream, onProgress, totalBytes = 0) {
+    const reader = stream.getReader();
+    const accumulator = new UfidAccumulator();
+    let bytesProcessed = 0;
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        if (!value || value.length === 0) {
+            continue;
+        }
+        bytesProcessed += value.length;
+        onProgress?.(bytesProcessed, totalBytes);
+        await accumulator.update(value);
+    }
+    return accumulator.digest();
+}
+export async function computeUfidFromBytes(bytes) {
+    const accumulator = new UfidAccumulator();
+    await accumulator.update(bytes);
+    return accumulator.digest();
+}
+//# sourceMappingURL=ufid.js.map

package/dist/ufid.js.map

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

package/dist/upload.d.ts

@@ -0,0 +1,19 @@
+import type { TelegramClient } from "telegram/client/TelegramClient.js";
+import type { UploadProgress } from "./shared/upload.js";
+export type UploadPathsResult = {
+    name: string;
+    ufid: string;
+    size: number;
+    msgId: number;
+    date: number;
+    chunks: number[];
+    sourcePaths: string[];
+    archived: boolean;
+};
+export declare function uploadPaths(client: TelegramClient, options: {
+    paths: string[];
+    chunkSize: number;
+    password: string;
+    onUfidProgress?: (progress: UploadProgress) => void;
+    onUploadProgress?: (progress: UploadProgress) => void;
+}): Promise<UploadPathsResult>;

package/dist/upload.js

@@ -0,0 +1,101 @@
+import { openAsBlob } from "node:fs";
+import { stat } from "node:fs/promises";
+import { basename, resolve } from "node:path";
+import { CliError, EXIT_CODES } from "./errors.js";
+import { getGramJs } from "./gramjs.js";
+import { computeTarSize, createTarStream, defaultArchiveName } from "./shared/archive.js";
+import { DuplicateUfidError, uploadCurrentFormatSource } from "./shared/upload.js";
+async function resolveLocalArchiveEntry(inputPath) {
+    const absolutePath = resolve(inputPath);
+    let stats;
+    try {
+        stats = await stat(absolutePath);
+    }
+    catch (error) {
+        throw new CliError("invalid_input", `Upload path does not exist: ${absolutePath}.`, EXIT_CODES.GENERAL_ERROR, { path: absolutePath, cause: error instanceof Error ? error.message : String(error) });
+    }
+    if (!stats.isFile()) {
+        throw new CliError("invalid_input", `Upload path must be a file: ${absolutePath}.`, EXIT_CODES.GENERAL_ERROR, { path: absolutePath });
+    }
+    const blob = await openAsBlob(absolutePath);
+    return {
+        path: absolutePath,
+        name: basename(absolutePath),
+        size: stats.size,
+        lastModified: Math.floor(stats.mtimeMs),
+        stream() {
+            return blob.stream();
+        },
+    };
+}
+async function resolveUploadSource(paths) {
+    if (paths.length === 0) {
+        throw new CliError("invalid_input", "At least one file path is required.", EXIT_CODES.GENERAL_ERROR);
+    }
+    const entries = await Promise.all(paths.map((path) => resolveLocalArchiveEntry(path)));
+    if (entries.length === 1) {
+        const [entry] = entries;
+        return {
+            source: {
+                name: entry.name,
+                size: entry.size,
+                stream() {
+                    return entry.stream();
+                },
+            },
+            sourcePaths: [entry.path],
+            archived: false,
+        };
+    }
+    return {
+        source: {
+            name: defaultArchiveName(),
+            size: computeTarSize(entries),
+            stream() {
+                return createTarStream(entries);
+            },
+        },
+        sourcePaths: entries.map((entry) => entry.path),
+        archived: true,
+    };
+}
+function normalizeUploadError(error) {
+    if (error instanceof CliError) {
+        return error;
+    }
+    if (error instanceof DuplicateUfidError) {
+        return new CliError("duplicate_ufid", `A file with UFID ${error.ufid} already exists in Saved Messages.`, EXIT_CODES.GENERAL_ERROR, { ufid: error.ufid });
+    }
+    if (error instanceof Error) {
+        return new CliError("upload_failed", error.message, EXIT_CODES.GENERAL_ERROR);
+    }
+    return new CliError("upload_failed", String(error), EXIT_CODES.GENERAL_ERROR);
+}
+export async function uploadPaths(client, options) {
+    const { Api } = getGramJs();
+    const resolved = await resolveUploadSource(options.paths);
+    try {
+        const record = await uploadCurrentFormatSource(client, {
+            Api,
+            chunkSize: options.chunkSize,
+            password: options.password,
+            source: resolved.source,
+            onUfidProgress: options.onUfidProgress,
+            onUploadProgress: options.onUploadProgress,
+        });
+        return {
+            name: record.data.name,
+            ufid: record.data.ufid,
+            size: record.data.size,
+            msgId: record.msgId,
+            date: record.date,
+            chunks: record.data.chunks,
+            sourcePaths: resolved.sourcePaths,
+            archived: resolved.archived,
+        };
+    }
+    catch (error) {
+        throw normalizeUploadError(error);
+    }
+}
+//# sourceMappingURL=upload.js.map

package/dist/upload.js.map

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

package/man/tglfs-delete.1

@@ -0,0 +1,19 @@
+.TH TGLFS-DELETE 1 "March 2026" "tglfs 0.1.0" "User Commands"
+.SH NAME
+tglfs-delete \- delete one or more owned TGLFS files from Saved Messages
+.SH SYNOPSIS
+.B tglfs delete
+[\fB--yes\fR] [\fB--json\fR] \fIufids...\fR
+.SH DESCRIPTION
+Deletes the Saved Messages file card plus all referenced chunk messages for each UFID.
+.SH OPTIONS
+.TP
+.B --yes
+Skip the confirmation prompt.
+.TP
+.B --json
+Emit machine-readable JSON.
+.SH AI AGENT NOTES
+Agents should pass
+.B --yes
+in non-interactive sessions.

package/man/tglfs-download.1

@@ -0,0 +1,42 @@
+.TH TGLFS-DOWNLOAD 1 "March 2026" "tglfs 0.1.0" "User Commands"
+.SH NAME
+tglfs-download \- download a current-format or legacy TGLFS file by UFID
+.SH SYNOPSIS
+.B tglfs download
+[\fIOPTIONS\fR] \fIufid\fR
+.SH DESCRIPTION
+Looks up a TGLFS file card in Telegram Saved Messages by UFID, downloads the encrypted chunks, decrypts and gunzips them, verifies the UFID, and writes the plaintext to disk.
+.PP
+Use
+.B --legacy
+for files that still require the older counter-advance behavior.
+.SH OPTIONS
+.TP
+.B --output <path>
+Destination path for the restored plaintext file.
+.TP
+.B --force
+Overwrite an existing output file.
+.TP
+.B --legacy
+Use the legacy decryption pipeline.
+.TP
+.B --password <password>
+Decryption password.
+.TP
+.B --password-env [name]
+Read the decryption password from an environment variable. If no name is provided, the command uses
+.B TGLFS_DOWNLOAD_PASSWORD.
+.TP
+.B --password-stdin
+Read the decryption password from standard input.
+.TP
+.B --json
+Emit machine-readable JSON.
+.SH ENVIRONMENT
+.TP
+.B TGLFS_DOWNLOAD_PASSWORD
+Default environment variable for the decryption password.
+.SH AI AGENT NOTES
+If the download password is missing and the command is attached to a TTY, the CLI prompts for it. In a non-interactive session, the agent must provide the password via flags, environment variables, or standard input.
+Interactive TTY runs also render a progress bar while the file is being restored. JSON mode stays silent until the final result so agents can parse the output safely.