@archildata/just-bash 0.8.17 → 0.8.19

package/dist/shell.mjs

@@ -0,0 +1,319 @@
+#!/usr/bin/env node
+import { n as createArchilCommand, r as ArchilFs } from "./src-zhIdm_Vq.mjs";
+import { ArchilClient } from "@archildata/native";
+import { Bash } from "just-bash";
+import * as readline from "readline";
+import { Command } from "commander";
+import { Archil } from "disk";
+//#region bin/shell.ts
+/**
+* Interactive just-bash shell with Archil filesystem
+*
+* Quick start with S3 bucket:
+*   npx @archildata/just-bash s3://my-bucket --api-key adt_xxx
+*
+* Traditional usage:
+*   npx @archildata/just-bash aws-us-east-1 myaccount/mydisk
+*   npx @archildata/just-bash --region aws-us-east-1 --disk myaccount/mydisk
+*/
+const program = new Command();
+program.name("archil-shell").description("Interactive bash shell with Archil filesystem").version("0.1.0").argument("[target]", "S3 bucket (s3://bucket) or region (e.g., aws-us-east-1)").argument("[disk]", "Disk name (e.g., myaccount/mydisk) - only when target is region").option("-r, --region <region>", "Region identifier (e.g., aws-us-east-1)").option("-d, --disk <disk>", "Disk name (e.g., myaccount/mydisk)").option("-k, --api-key <key>", "API key for disk management (required for S3 bucket mode)").option("-t, --token <token>", "Auth token for direct connection (defaults to IAM)").option("-l, --log-level <level>", "Log level: trace, debug, info, warn, error").option("--bucket-region <region>", "AWS region for the S3 bucket (default: us-east-1)").option("--bucket-prefix <prefix>", "Path prefix within the bucket").addHelpText("after", `
+Quick Start (S3 bucket mode):
+  Connect directly to an S3 bucket - creates a disk if needed:
+  $ npx @archildata/just-bash s3://my-bucket --api-key adt_xxx
+  $ npx @archildata/just-bash s3://my-bucket --api-key adt_xxx --bucket-region us-west-2
+
+  AWS credentials are read from environment:
+  $ AWS_ACCESS_KEY_ID=xxx AWS_SECRET_ACCESS_KEY=xxx npx @archildata/just-bash s3://my-bucket -k adt_xxx
+
+Traditional usage (direct connection):
+  $ npx @archildata/just-bash aws-us-east-1 myaccount/mydisk
+  $ npx @archildata/just-bash --region aws-us-east-1 --disk myaccount/mydisk
+  $ ARCHIL_DISK_TOKEN=xxx npx @archildata/just-bash aws-us-east-1 myaccount/mydisk
+
+Subdirectory mounting (mount a subdirectory as the root):
+  $ npx @archildata/just-bash aws-us-east-1 myaccount/mydisk:/data/project
+
+Environment variables:
+  ARCHIL_API_KEY    API key for disk management
+  ARCHIL_REGION     Fallback for --region
+  ARCHIL_DISK       Fallback for --disk
+  ARCHIL_DISK_TOKEN      Fallback for --token (recommended for secrets)
+  ARCHIL_LOG_LEVEL  Fallback for --log-level
+  AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY  S3 credentials for bucket mode
+`);
+program.parse();
+const opts = program.opts();
+const args = program.args;
+const isS3Bucket = args[0]?.startsWith("s3://");
+/**
+* Parse S3 bucket URL
+*/
+function parseS3Url(url) {
+	const match = url.match(/^s3:\/\/([^/]+)(\/.*)?$/);
+	if (!match) throw new Error(`Invalid S3 URL: ${url}`);
+	return {
+		bucket: match[1],
+		prefix: match[2]?.slice(1) || void 0
+	};
+}
+/**
+* Generate a disk name from an S3 bucket
+*/
+function diskNameFromBucket(bucket) {
+	return `s3-${bucket.replace(/[^a-zA-Z0-9-]/g, "-")}`;
+}
+/**
+* Find an existing disk that mounts the given S3 bucket
+*/
+function findDiskForBucket(disks, bucketName) {
+	return disks.find((disk) => disk.mounts?.some((mount) => mount.type === "s3" && mount.config?.bucketName === bucketName));
+}
+/**
+* S3 bucket quick-start mode
+*/
+async function runS3BucketMode() {
+	const s3Url = args[0];
+	const logLevel = opts.logLevel || process.env.ARCHIL_LOG_LEVEL;
+	const region = opts.region || process.env.ARCHIL_REGION || "aws-us-east-1";
+	const bucketRegion = opts.bucketRegion || "us-east-1";
+	const awsAccessKeyId = process.env.AWS_ACCESS_KEY_ID;
+	const awsSecretAccessKey = process.env.AWS_SECRET_ACCESS_KEY;
+	if (!awsAccessKeyId || !awsSecretAccessKey) {
+		console.error("Error: AWS credentials required for S3 bucket mode");
+		console.error("");
+		console.error("Set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables:");
+		console.error("  AWS_ACCESS_KEY_ID=xxx AWS_SECRET_ACCESS_KEY=xxx npx @archildata/just-bash s3://my-bucket -k adt_xxx");
+		process.exit(1);
+	}
+	const { bucket, prefix } = parseS3Url(s3Url);
+	const combinedPrefix = opts.bucketPrefix ? opts.bucketPrefix + (prefix ? "/" + prefix : "") : prefix;
+	console.log("Archil S3 Quick Start");
+	console.log("=====================");
+	console.log(`  Bucket: ${bucket}`);
+	if (combinedPrefix) console.log(`  Prefix: ${combinedPrefix}`);
+	console.log(`  Region: ${region}`);
+	console.log(`  Bucket Region: ${bucketRegion}`);
+	console.log("");
+	let archil;
+	try {
+		archil = new Archil({
+			apiKey: opts.apiKey,
+			region
+		});
+	} catch (err) {
+		console.error(err instanceof Error ? err.message : err);
+		console.error("");
+		console.error("Usage:");
+		console.error("  npx @archildata/just-bash s3://my-bucket --api-key adt_xxx");
+		console.error("");
+		console.error("Or set ARCHIL_API_KEY environment variable:");
+		console.error("  ARCHIL_API_KEY=adt_xxx npx @archildata/just-bash s3://my-bucket");
+		process.exit(1);
+	}
+	console.log("Checking for existing disk...");
+	let disk;
+	let mountToken;
+	try {
+		disk = findDiskForBucket(await archil.disks.list(), bucket);
+		if (disk) console.log(`Found existing disk: ${disk.name} (${disk.id})`);
+	} catch (err) {
+		console.error("Failed to list disks:", err instanceof Error ? err.message : err);
+		process.exit(1);
+	}
+	if (!disk) {
+		const diskName = diskNameFromBucket(bucket);
+		console.log(`Creating new disk: ${diskName}`);
+		try {
+			const result = await archil.disks.create({
+				name: diskName,
+				mounts: [{
+					type: "s3",
+					bucketName: bucket,
+					bucketPrefix: combinedPrefix,
+					accessKeyId: awsAccessKeyId,
+					secretAccessKey: awsSecretAccessKey
+				}]
+			});
+			disk = result.disk;
+			mountToken = result.token ?? void 0;
+			console.log(`Created disk: ${disk.name} (${disk.id})`);
+		} catch (err) {
+			console.error("Failed to create disk:", err instanceof Error ? err.message : err);
+			process.exit(1);
+		}
+	}
+	if (!mountToken) try {
+		const { token } = await disk.createToken("just-bash");
+		mountToken = token;
+	} catch (err) {
+		console.error("Failed to create mount token:", err instanceof Error ? err.message : err);
+		process.exit(1);
+	}
+	console.log("Connecting...");
+	let client;
+	try {
+		client = await disk.mount({
+			authToken: mountToken,
+			logLevel
+		});
+		console.log("Connected!");
+	} catch (err) {
+		console.error("Failed to connect:", err instanceof Error ? err.message : err);
+		process.exit(1);
+	}
+	return {
+		client,
+		diskName: disk.name,
+		subdirectory: void 0
+	};
+}
+/**
+* Traditional direct connection mode
+*/
+async function runDirectMode() {
+	const region = args[0] || opts.region || process.env.ARCHIL_REGION;
+	const rawDisk = args[1] || opts.disk || process.env.ARCHIL_DISK;
+	const authToken = opts.token || process.env.ARCHIL_DISK_TOKEN;
+	const logLevel = opts.logLevel || process.env.ARCHIL_LOG_LEVEL;
+	let diskName;
+	let subdirectory;
+	if (rawDisk) {
+		const colonIdx = rawDisk.indexOf(":/");
+		if (colonIdx !== -1) {
+			diskName = rawDisk.substring(0, colonIdx);
+			const subdir = rawDisk.substring(colonIdx + 1).replace(/^\/+|\/+$/g, "");
+			if (subdir) subdirectory = subdir;
+		} else diskName = rawDisk;
+	}
+	if (!region || !diskName) {
+		console.error("Error: region and disk are required\n");
+		console.error("Usage:");
+		console.error("  npx @archildata/just-bash <region> <disk>");
+		console.error("  npx @archildata/just-bash --region <region> --disk <disk>");
+		console.error("\nQuick start with S3 bucket:");
+		console.error("  npx @archildata/just-bash s3://my-bucket --api-key adt_xxx");
+		console.error("\nExamples:");
+		console.error("  npx @archildata/just-bash aws-us-east-1 myaccount/mydisk");
+		console.error("  ARCHIL_DISK_TOKEN=xxx npx @archildata/just-bash aws-us-east-1 myaccount/mydisk");
+		console.error("\nRun with --help for more options.");
+		process.exit(1);
+	}
+	console.log("Connecting to Archil...");
+	console.log(`  Region: ${region}`);
+	console.log(`  Disk: ${diskName}`);
+	if (subdirectory) console.log(`  Subdirectory: ${subdirectory}`);
+	console.log(`  Auth: ${authToken ? "token" : "IAM"}`);
+	if (logLevel) console.log(`  Log level: ${logLevel}`);
+	console.log("");
+	let client;
+	try {
+		client = await ArchilClient.connect({
+			region,
+			diskName,
+			authToken: authToken || void 0,
+			logLevel
+		});
+		console.log("Connected!");
+	} catch (err) {
+		console.error("Failed to connect:", err instanceof Error ? err.message : err);
+		process.exit(1);
+	}
+	return {
+		client,
+		diskName,
+		subdirectory
+	};
+}
+async function main() {
+	const { client, diskName, subdirectory } = isS3Bucket ? await runS3BucketMode() : await runDirectMode();
+	const fs = await ArchilFs.create(client, { subdirectory });
+	const bash = new Bash({
+		fs,
+		customCommands: [createArchilCommand(client, fs)]
+	});
+	let cleaningUp = false;
+	const cleanup = async (signal) => {
+		if (cleaningUp) return;
+		cleaningUp = true;
+		if (signal) console.log(`\nReceived ${signal}, cleaning up...`);
+		else console.log("\nGoodbye!");
+		try {
+			const released = await client.close();
+			if (released > 0) console.log(`Released ${released} delegation${released > 1 ? "s" : ""}`);
+		} catch (err) {
+			console.error("Error during cleanup:", err instanceof Error ? err.message : err);
+		}
+		process.exit(0);
+	};
+	process.on("SIGINT", () => cleanup("SIGINT"));
+	process.on("SIGTERM", () => cleanup("SIGTERM"));
+	process.on("SIGHUP", () => cleanup("SIGHUP"));
+	console.log("");
+	console.log("=== Archil just-bash shell ===");
+	console.log(`Connected to: ${diskName}${subdirectory ? ":" + subdirectory : ""}`);
+	console.log("");
+	console.log("Type bash commands to interact with the filesystem.");
+	console.log("Special commands:");
+	console.log("  archil checkout [--force] <path>  - Acquire write delegation");
+	console.log("  archil checkin <path>             - Release write delegation");
+	console.log("  archil list-delegations           - Show held delegations");
+	console.log("  archil help                       - Show archil commands");
+	console.log("Type 'exit' or Ctrl+D to quit.");
+	console.log("");
+	const rl = readline.createInterface({
+		input: process.stdin,
+		output: process.stdout,
+		prompt: "archil$ "
+	});
+	let cwd = "/";
+	const prompt = () => {
+		rl.setPrompt(`archil:${cwd}$ `);
+		rl.prompt();
+	};
+	prompt();
+	rl.on("line", async (line) => {
+		const trimmed = line.trim();
+		if (trimmed === "exit" || trimmed === "quit") {
+			await cleanup();
+			return;
+		}
+		if (!trimmed) {
+			prompt();
+			return;
+		}
+		rl.pause();
+		try {
+			const result = await bash.exec(trimmed, {
+				cwd,
+				env: {
+					HOME: "/",
+					USER: "archil",
+					PWD: cwd
+				}
+			});
+			if (result.stdout) {
+				process.stdout.write(result.stdout);
+				if (!result.stdout.endsWith("\n")) console.log("");
+			}
+			if (result.stderr) {
+				process.stderr.write(result.stderr);
+				if (!result.stderr.endsWith("\n")) console.error("");
+			}
+			if (result.env?.PWD && result.env.PWD !== cwd) cwd = result.env.PWD;
+		} catch (err) {
+			console.error("Error:", err instanceof Error ? err.message : err);
+		}
+		rl.resume();
+		prompt();
+	});
+	rl.on("close", () => cleanup());
+}
+main().catch((err) => {
+	console.error("Fatal error:", err);
+	process.exit(1);
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=shell.mjs.map

package/dist/shell.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.mjs","names":[],"sources":["../bin/shell.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Interactive just-bash shell with Archil filesystem\n *\n * Quick start with S3 bucket:\n *   npx @archildata/just-bash s3://my-bucket --api-key adt_xxx\n *\n * Traditional usage:\n *   npx @archildata/just-bash aws-us-east-1 myaccount/mydisk\n *   npx @archildata/just-bash --region aws-us-east-1 --disk myaccount/mydisk\n */\n\nimport * as readline from \"readline\";\nimport { Command } from \"commander\";\nimport { ArchilClient } from \"@archildata/native\";\nimport { Archil, Disk } from \"disk\";\nimport { Bash } from \"just-bash\";\nimport { ArchilFs, createArchilCommand } from \"../src/index.js\";\n\nconst program = new Command();\n\nprogram\n  .name(\"archil-shell\")\n  .description(\"Interactive bash shell with Archil filesystem\")\n  .version(\"0.1.0\")\n  .argument(\"[target]\", \"S3 bucket (s3://bucket) or region (e.g., aws-us-east-1)\")\n  .argument(\"[disk]\", \"Disk name (e.g., myaccount/mydisk) - only when target is region\")\n  .option(\"-r, --region <region>\", \"Region identifier (e.g., aws-us-east-1)\")\n  .option(\"-d, --disk <disk>\", \"Disk name (e.g., myaccount/mydisk)\")\n  .option(\"-k, --api-key <key>\", \"API key for disk management (required for S3 bucket mode)\")\n  .option(\"-t, --token <token>\", \"Auth token for direct connection (defaults to IAM)\")\n  .option(\"-l, --log-level <level>\", \"Log level: trace, debug, info, warn, error\")\n  .option(\"--bucket-region <region>\", \"AWS region for the S3 bucket (default: us-east-1)\")\n  .option(\"--bucket-prefix <prefix>\", \"Path prefix within the bucket\")\n  .addHelpText(\"after\", `\nQuick Start (S3 bucket mode):\n  Connect directly to an S3 bucket - creates a disk if needed:\n  $ npx @archildata/just-bash s3://my-bucket --api-key adt_xxx\n  $ npx @archildata/just-bash s3://my-bucket --api-key adt_xxx --bucket-region us-west-2\n\n  AWS credentials are read from environment:\n  $ AWS_ACCESS_KEY_ID=xxx AWS_SECRET_ACCESS_KEY=xxx npx @archildata/just-bash s3://my-bucket -k adt_xxx\n\nTraditional usage (direct connection):\n  $ npx @archildata/just-bash aws-us-east-1 myaccount/mydisk\n  $ npx @archildata/just-bash --region aws-us-east-1 --disk myaccount/mydisk\n  $ ARCHIL_DISK_TOKEN=xxx npx @archildata/just-bash aws-us-east-1 myaccount/mydisk\n\nSubdirectory mounting (mount a subdirectory as the root):\n  $ npx @archildata/just-bash aws-us-east-1 myaccount/mydisk:/data/project\n\nEnvironment variables:\n  ARCHIL_API_KEY    API key for disk management\n  ARCHIL_REGION     Fallback for --region\n  ARCHIL_DISK       Fallback for --disk\n  ARCHIL_DISK_TOKEN      Fallback for --token (recommended for secrets)\n  ARCHIL_LOG_LEVEL  Fallback for --log-level\n  AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY  S3 credentials for bucket mode\n`);\n\nprogram.parse();\n\nconst opts = program.opts();\nconst args = program.args;\n\n// Check if first argument is an S3 bucket\nconst isS3Bucket = args[0]?.startsWith(\"s3://\");\n\n/**\n * Parse S3 bucket URL\n */\nfunction parseS3Url(url: string): { bucket: string; prefix?: string } {\n  const match = url.match(/^s3:\\/\\/([^/]+)(\\/.*)?$/);\n  if (!match) {\n    throw new Error(`Invalid S3 URL: ${url}`);\n  }\n  return {\n    bucket: match[1],\n    prefix: match[2]?.slice(1) || undefined, // Remove leading /\n  };\n}\n\n/**\n * Generate a disk name from an S3 bucket\n */\nfunction diskNameFromBucket(bucket: string): string {\n  // Sanitize bucket name for use as disk name (alphanumeric, hyphens, underscores)\n  return `s3-${bucket.replace(/[^a-zA-Z0-9-]/g, \"-\")}`;\n}\n\n/**\n * Find an existing disk that mounts the given S3 bucket\n */\nfunction findDiskForBucket(disks: Disk[], bucketName: string): Disk | undefined {\n  return disks.find((disk) =>\n    disk.mounts?.some(\n      (mount) =>\n        mount.type === \"s3\" &&\n        mount.config?.bucketName === bucketName\n    )\n  );\n}\n\n/**\n * S3 bucket quick-start mode\n */\nasync function runS3BucketMode() {\n  const s3Url = args[0];\n  const logLevel = opts.logLevel || process.env.ARCHIL_LOG_LEVEL;\n  const region = opts.region || process.env.ARCHIL_REGION || \"aws-us-east-1\";\n  const bucketRegion = opts.bucketRegion || \"us-east-1\";\n\n  // Check for AWS credentials\n  const awsAccessKeyId = process.env.AWS_ACCESS_KEY_ID;\n  const awsSecretAccessKey = process.env.AWS_SECRET_ACCESS_KEY;\n\n  if (!awsAccessKeyId || !awsSecretAccessKey) {\n    console.error(\"Error: AWS credentials required for S3 bucket mode\");\n    console.error(\"\");\n    console.error(\"Set AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY environment variables:\");\n    console.error(\"  AWS_ACCESS_KEY_ID=xxx AWS_SECRET_ACCESS_KEY=xxx npx @archildata/just-bash s3://my-bucket -k adt_xxx\");\n    process.exit(1);\n  }\n\n  const { bucket, prefix } = parseS3Url(s3Url);\n  const combinedPrefix = opts.bucketPrefix\n    ? opts.bucketPrefix + (prefix ? \"/\" + prefix : \"\")\n    : prefix;\n\n  console.log(\"Archil S3 Quick Start\");\n  console.log(\"=====================\");\n  console.log(`  Bucket: ${bucket}`);\n  if (combinedPrefix) {\n    console.log(`  Prefix: ${combinedPrefix}`);\n  }\n  console.log(`  Region: ${region}`);\n  console.log(`  Bucket Region: ${bucketRegion}`);\n  console.log(\"\");\n\n  // Initialize Archil control plane client\n  // apiKey falls back to ARCHIL_API_KEY env var via the Archil constructor\n  let archil: Archil;\n  try {\n    archil = new Archil({\n      apiKey: opts.apiKey,\n      region,\n    });\n  } catch (err) {\n    console.error(err instanceof Error ? err.message : err);\n    console.error(\"\");\n    console.error(\"Usage:\");\n    console.error(\"  npx @archildata/just-bash s3://my-bucket --api-key adt_xxx\");\n    console.error(\"\");\n    console.error(\"Or set ARCHIL_API_KEY environment variable:\");\n    console.error(\"  ARCHIL_API_KEY=adt_xxx npx @archildata/just-bash s3://my-bucket\");\n    process.exit(1);\n  }\n\n  // Check if a disk for this bucket already exists\n  console.log(\"Checking for existing disk...\");\n  let disk: Disk | undefined;\n  let mountToken: string | undefined;\n\n  try {\n    const disks = await archil.disks.list();\n    disk = findDiskForBucket(disks, bucket);\n\n    if (disk) {\n      console.log(`Found existing disk: ${disk.name} (${disk.id})`);\n    }\n  } catch (err) {\n    console.error(\"Failed to list disks:\", err instanceof Error ? err.message : err);\n    process.exit(1);\n  }\n\n  // Create disk if it doesn't exist\n  if (!disk) {\n    const diskName = diskNameFromBucket(bucket);\n    console.log(`Creating new disk: ${diskName}`);\n\n    try {\n      const result = await archil.disks.create({\n        name: diskName,\n        mounts: [\n          {\n            type: \"s3\",\n            bucketName: bucket,\n            bucketPrefix: combinedPrefix,\n            accessKeyId: awsAccessKeyId,\n            secretAccessKey: awsSecretAccessKey,\n          },\n        ],\n      });\n      disk = result.disk;\n      mountToken = result.token ?? undefined;\n      console.log(`Created disk: ${disk.name} (${disk.id})`);\n    } catch (err) {\n      console.error(\"Failed to create disk:\", err instanceof Error ? err.message : err);\n      process.exit(1);\n    }\n  }\n\n  // For existing disks, generate a fresh mount token\n  if (!mountToken) {\n    try {\n      const { token } = await disk.createToken(\"just-bash\");\n      mountToken = token;\n    } catch (err) {\n      console.error(\"Failed to create mount token:\", err instanceof Error ? err.message : err);\n      process.exit(1);\n    }\n  }\n\n  // Connect to the disk\n  console.log(\"Connecting...\");\n  let client: ArchilClient;\n  try {\n    client = await disk.mount({ authToken: mountToken, logLevel }) as ArchilClient;\n    console.log(\"Connected!\");\n  } catch (err) {\n    console.error(\"Failed to connect:\", err instanceof Error ? err.message : err);\n    process.exit(1);\n  }\n\n  return { client, diskName: disk.name, subdirectory: undefined as string | undefined };\n}\n\n/**\n * Traditional direct connection mode\n */\nasync function runDirectMode() {\n  const region = args[0] || opts.region || process.env.ARCHIL_REGION;\n  const rawDisk = args[1] || opts.disk || process.env.ARCHIL_DISK;\n  const authToken = opts.token || process.env.ARCHIL_DISK_TOKEN;\n  const logLevel = opts.logLevel || process.env.ARCHIL_LOG_LEVEL;\n\n  // Parse disk:/subdirectory syntax (e.g., \"myaccount/mydisk:/data/project\")\n  // Uses \":/\" delimiter to match NFS convention where paths are always absolute.\n  let diskName: string | undefined;\n  let subdirectory: string | undefined;\n  if (rawDisk) {\n    const colonIdx = rawDisk.indexOf(\":/\");\n    if (colonIdx !== -1) {\n      diskName = rawDisk.substring(0, colonIdx);\n      const subdir = rawDisk.substring(colonIdx + 1).replace(/^\\/+|\\/+$/g, \"\");\n      if (subdir) {\n        subdirectory = subdir;\n      }\n    } else {\n      diskName = rawDisk;\n    }\n  }\n\n  if (!region || !diskName) {\n    console.error(\"Error: region and disk are required\\n\");\n    console.error(\"Usage:\");\n    console.error(\"  npx @archildata/just-bash <region> <disk>\");\n    console.error(\"  npx @archildata/just-bash --region <region> --disk <disk>\");\n    console.error(\"\\nQuick start with S3 bucket:\");\n    console.error(\"  npx @archildata/just-bash s3://my-bucket --api-key adt_xxx\");\n    console.error(\"\\nExamples:\");\n    console.error(\"  npx @archildata/just-bash aws-us-east-1 myaccount/mydisk\");\n    console.error(\"  ARCHIL_DISK_TOKEN=xxx npx @archildata/just-bash aws-us-east-1 myaccount/mydisk\");\n    console.error(\"\\nRun with --help for more options.\");\n    process.exit(1);\n  }\n\n  console.log(\"Connecting to Archil...\");\n  console.log(`  Region: ${region}`);\n  console.log(`  Disk: ${diskName}`);\n  if (subdirectory) {\n    console.log(`  Subdirectory: ${subdirectory}`);\n  }\n  console.log(`  Auth: ${authToken ? \"token\" : \"IAM\"}`);\n  if (logLevel) {\n    console.log(`  Log level: ${logLevel}`);\n  }\n  console.log(\"\");\n\n  let client: ArchilClient;\n  try {\n    client = await ArchilClient.connect({\n      region,\n      diskName,\n      authToken: authToken || undefined,\n      logLevel,\n    });\n    console.log(\"Connected!\");\n  } catch (err) {\n    console.error(\"Failed to connect:\", err instanceof Error ? err.message : err);\n    process.exit(1);\n  }\n\n  return { client, diskName, subdirectory };\n}\n\nasync function main() {\n  // Determine which mode to run\n  const { client, diskName, subdirectory } = isS3Bucket\n    ? await runS3BucketMode()\n    : await runDirectMode();\n\n  // Create filesystem adapter (resolves subdirectory eagerly if specified)\n  const fs = await ArchilFs.create(client, { subdirectory });\n\n  // Create bash environment with archil delegation commands\n  const bash = new Bash({ fs, customCommands: [createArchilCommand(client, fs)] });\n\n  // Cleanup function to release delegations and close connection\n  let cleaningUp = false;\n  const cleanup = async (signal?: string) => {\n    if (cleaningUp) return;\n    cleaningUp = true;\n\n    if (signal) {\n      console.log(`\\nReceived ${signal}, cleaning up...`);\n    } else {\n      console.log(\"\\nGoodbye!\");\n    }\n\n    try {\n      // close() releases all delegations and cleans up resources\n      const released = await client.close();\n      if (released > 0) {\n        console.log(`Released ${released} delegation${released > 1 ? \"s\" : \"\"}`);\n      }\n    } catch (err) {\n      console.error(\"Error during cleanup:\", err instanceof Error ? err.message : err);\n    }\n\n    process.exit(0);\n  };\n\n  // Handle signals for graceful shutdown\n  process.on(\"SIGINT\", () => cleanup(\"SIGINT\"));\n  process.on(\"SIGTERM\", () => cleanup(\"SIGTERM\"));\n  process.on(\"SIGHUP\", () => cleanup(\"SIGHUP\"));\n\n  console.log(\"\");\n  console.log(\"=== Archil just-bash shell ===\");\n  console.log(`Connected to: ${diskName}${subdirectory ? \":\" + subdirectory : \"\"}`);\n  console.log(\"\");\n  console.log(\"Type bash commands to interact with the filesystem.\");\n  console.log(\"Special commands:\");\n  console.log(\"  archil checkout [--force] <path>  - Acquire write delegation\");\n  console.log(\"  archil checkin <path>             - Release write delegation\");\n  console.log(\"  archil list-delegations           - Show held delegations\");\n  console.log(\"  archil help                       - Show archil commands\");\n  console.log(\"Type 'exit' or Ctrl+D to quit.\");\n  console.log(\"\");\n\n  // Create readline interface for interactive input\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n    prompt: \"archil$ \",\n  });\n\n  let cwd = \"/\";\n\n  const prompt = () => {\n    rl.setPrompt(`archil:${cwd}$ `);\n    rl.prompt();\n  };\n\n  prompt();\n\n  rl.on(\"line\", async (line) => {\n    const trimmed = line.trim();\n\n    if (trimmed === \"exit\" || trimmed === \"quit\") {\n      await cleanup();\n      return;\n    }\n\n    if (!trimmed) {\n      prompt();\n      return;\n    }\n\n    // Pause readline while we process the command\n    rl.pause();\n\n    try {\n      const result = await bash.exec(trimmed, {\n        cwd,\n        env: {\n          HOME: \"/\",\n          USER: \"archil\",\n          PWD: cwd,\n        },\n      });\n\n      // Print output\n      if (result.stdout) {\n        process.stdout.write(result.stdout);\n        if (!result.stdout.endsWith(\"\\n\")) {\n          console.log(\"\");\n        }\n      }\n      if (result.stderr) {\n        process.stderr.write(result.stderr);\n        if (!result.stderr.endsWith(\"\\n\")) {\n          console.error(\"\");\n        }\n      }\n\n      // Update cwd if command changed it\n      if (result.env?.PWD && result.env.PWD !== cwd) {\n        cwd = result.env.PWD;\n      }\n    } catch (err) {\n      console.error(\"Error:\", err instanceof Error ? err.message : err);\n    }\n\n    rl.resume();\n    prompt();\n  });\n\n  rl.on(\"close\", () => cleanup());\n}\n\nmain().catch((err) => {\n  console.error(\"Fatal error:\", err);\n  process.exit(1);\n});\n"],"mappings":"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"}