@aigne/aos 0.2.0-beta

package/dist/terminal-repl.cjs

@@ -0,0 +1,371 @@
+
+//#region src/terminal-repl.ts
+const ARC_ART = ["▄▀█ █▀█ █▀▀", "█▀█ █▀▄ █▄▄"];
+const TAGLINE = "Agentic Realm Computer";
+const COPYRIGHT = "Copyright (c) 2026 ArcBlock Inc. All rights reserved.";
+const R = "\x1B[0m";
+const ART_GRADIENT = [[
+	100,
+	220,
+	255
+], [
+	180,
+	120,
+	255
+]];
+const TAGLINE_GRADIENT = [
+	[
+		100,
+		255,
+		255
+	],
+	[
+		80,
+		220,
+		255
+	],
+	[
+		60,
+		180,
+		255
+	],
+	[
+		100,
+		140,
+		255
+	],
+	[
+		180,
+		120,
+		255
+	],
+	[
+		220,
+		100,
+		255
+	]
+];
+function interpColor(t, stops) {
+	const scaled = t * (stops.length - 1);
+	const i = Math.min(Math.floor(scaled), stops.length - 2);
+	const frac = scaled - i;
+	const a = stops[i] ?? [
+		0,
+		0,
+		0
+	];
+	const b = stops[i + 1] ?? [
+		0,
+		0,
+		0
+	];
+	return [
+		Math.round(a[0] + (b[0] - a[0]) * frac),
+		Math.round(a[1] + (b[1] - a[1]) * frac),
+		Math.round(a[2] + (b[2] - a[2]) * frac)
+	];
+}
+function rainbowText(text) {
+	const chars = [...text];
+	return chars.map((ch, i) => {
+		if (ch === " ") return ch;
+		const [r, g, b] = interpColor(chars.length > 1 ? i / (chars.length - 1) : 0, TAGLINE_GRADIENT);
+		return `\x1b[38;2;${r};${g};${b}m${ch}${R}`;
+	}).join("");
+}
+/**
+* Render the ARC terminal banner.
+*
+* Uses 24-bit truecolor gradient (matches Node splash.ts exactly).
+*
+* Output (colored):
+*   ▄▀█ █▀█ █▀▀  Agentic Realm Computer
+*   █▀█ █▀▄ █▄▄  v1.0.0 (abc1234) · 2026-04-23
+*   Copyright (c) 2026 ArcBlock Inc. All rights reserved.
+*
+*   Session: <id> · N providers · Type help for commands.
+*/
+function renderArcBanner(opts) {
+	const color = opts.color !== false;
+	const { version, commit, date, providerCount, sessionId } = opts;
+	const tc = (rgb, s) => color ? `\x1b[38;2;${rgb[0]};${rgb[1]};${rgb[2]}m${s}${R}` : s;
+	const cyan = (s) => color ? `\x1b[96m${s}${R}` : s;
+	const dim = (s) => color ? `\x1b[2m${s}${R}` : s;
+	const art = ARC_ART.map((line, i) => color ? tc(ART_GRADIENT[i], line) : line);
+	const tagline = color ? rainbowText(TAGLINE) : TAGLINE;
+	const versionStr = [
+		cyan(`v${version}`),
+		dim(`(${commit})`),
+		dim("·"),
+		dim(date)
+	].join(" ");
+	const copyrightStr = dim(COPYRIGHT);
+	const gap = "  ";
+	const lines = [
+		`  ${art[0]}${gap}${tagline}`,
+		`  ${art[1]}${gap}${versionStr}`,
+		`  ${copyrightStr}`
+	];
+	if (providerCount !== void 0 || sessionId) {
+		const parts = [];
+		if (sessionId) parts.push(`Session: ${dim(sessionId)}`);
+		if (providerCount !== void 0) {
+			const plural = providerCount === 1 ? "provider" : "providers";
+			parts.push(`${providerCount} ${plural}`);
+		}
+		parts.push(`Type ${cyan("help")} for commands.`);
+		lines.push("", `  ${parts.join(dim(" · "))}`);
+	}
+	return lines.join("\r\n");
+}
+/** Generate a random hex session ID. */
+function genSessionId() {
+	const arr = new Uint8Array(8);
+	if (typeof crypto !== "undefined" && crypto.getRandomValues) crypto.getRandomValues(arr);
+	else for (let i = 0; i < arr.length; i++) arr[i] = Math.floor(Math.random() * 256);
+	return Array.from(arr, (b) => b.toString(16).padStart(2, "0")).join("");
+}
+function resolvePath(cwd, raw) {
+	if (!raw || raw === ".") return cwd;
+	const parts = (raw.startsWith("/") ? raw : `${cwd === "/" ? "" : cwd}/${raw}`).split("/").filter(Boolean);
+	const resolved = [];
+	for (const p of parts) if (p === "..") resolved.pop();
+	else if (p !== ".") resolved.push(p);
+	return `/${resolved.join("/")}`;
+}
+function parseArgs(input) {
+	const args = [];
+	let current = "";
+	let quote = null;
+	for (const ch of input) if (quote) if (ch === quote) quote = null;
+	else current += ch;
+	else if (ch === "\"" || ch === "'") quote = ch;
+	else if (ch === " " || ch === "	") {
+		if (current) {
+			args.push(current);
+			current = "";
+		}
+	} else current += ch;
+	if (current) args.push(current);
+	return args;
+}
+function makeAnsi(color) {
+	const r = color ? "\x1B[0m" : "";
+	const red = color ? "\x1B[31m" : "";
+	const blue = color ? "\x1B[34m" : "";
+	const yellow = color ? "\x1B[33m" : "";
+	const bold = color ? "\x1B[1m" : "";
+	return {
+		r,
+		red,
+		blue,
+		yellow,
+		bold,
+		err: (msg) => `${red}Error:${r} ${msg}`,
+		help: () => [
+			`${bold}Available commands:${r}`,
+			"",
+			`  ${bold}AFS Commands:${r}`,
+			`    ${yellow}ls${r} [path]               List directory contents (default: current dir)`,
+			`    ${yellow}read${r} <path>             Read file content`,
+			`    ${yellow}write${r} <path> <content>  Write content to file`,
+			`    ${yellow}stat${r} [path]             Get file or directory info`,
+			`    ${yellow}exec${r} <path> [args]      Execute an action`,
+			`    ${yellow}explain${r} [path]          Explain path capabilities`,
+			`    ${yellow}search${r} <path> <query>   Search content`,
+			"",
+			`  ${bold}REPL Commands:${r}`,
+			`    ${yellow}cd${r} [path]               Change working directory`,
+			`    ${yellow}pwd${r}                     Print working directory`,
+			`    ${yellow}help${r}                    Show this help`,
+			`    ${yellow}clear${r}                   Clear screen`,
+			`    ${yellow}exit${r} / ${yellow}quit${r}             Exit session`
+		].join("\r\n")
+	};
+}
+async function cmdLs(afs, path, ansi) {
+	try {
+		const items = (await afs.list(path, { maxDepth: 1 })).data ?? [];
+		if (!items.length) return "(empty)";
+		return items.map((e) => {
+			const isDir = e.meta?.kind === "directory" || (e.meta?.childrenCount ?? 0) > 0;
+			const name = e.path.split("/").at(-1) ?? e.path;
+			return isDir ? `${ansi.blue}${name}/${ansi.r}` : name;
+		}).join("\r\n");
+	} catch (e) {
+		return ansi.err(e instanceof Error ? e.message : String(e));
+	}
+}
+async function cmdRead(afs, path, ansi) {
+	try {
+		const content = (await afs.read(path)).data?.content;
+		if (content === void 0 || content === null) return ansi.err("Not found or not readable");
+		if (typeof content === "string") return content;
+		if (content instanceof Uint8Array) return new TextDecoder().decode(content);
+		return JSON.stringify(content, null, 2);
+	} catch (e) {
+		const msg = e instanceof Error ? e.message : String(e);
+		if (/not found|ENOENT/i.test(msg)) return ansi.err(`Not found: ${path}`);
+		return ansi.err(msg);
+	}
+}
+async function cmdWrite(afs, path, content, ansi) {
+	try {
+		await afs.write(path, { content });
+		return `Written: ${path}`;
+	} catch (e) {
+		return ansi.err(e instanceof Error ? e.message : String(e));
+	}
+}
+async function cmdStat(afs, path, ansi) {
+	try {
+		const meta = (await afs.stat(path))?.data?.meta ?? {};
+		const lines = [`${ansi.bold}Path:${ansi.r} ${path}`];
+		for (const [k, v] of Object.entries(meta)) if (v !== void 0 && v !== null) lines.push(`${ansi.yellow}${k}:${ansi.r} ${JSON.stringify(v)}`);
+		return lines.join("\r\n");
+	} catch (e) {
+		const msg = e instanceof Error ? e.message : String(e);
+		if (/not found|ENOENT/i.test(msg)) return ansi.err(`Not found: ${path}`);
+		return ansi.err(msg);
+	}
+}
+async function cmdExec(afs, path, args, ansi) {
+	try {
+		const data = (await afs.exec(path, args))?.data;
+		if (data === void 0 || data === null) return "(no output)";
+		if (typeof data === "string") return data;
+		return JSON.stringify(data, null, 2);
+	} catch (e) {
+		return ansi.err(e instanceof Error ? e.message : String(e));
+	}
+}
+async function cmdExplain(afs, path, ansi) {
+	try {
+		const result = await afs.explain(path);
+		if (!result) return "(no explanation)";
+		return result.content ?? "(no explanation)";
+	} catch (e) {
+		return ansi.err(e instanceof Error ? e.message : String(e));
+	}
+}
+async function cmdSearch(afs, path, query, ansi) {
+	try {
+		const items = (await afs.search(path, query))?.data ?? [];
+		if (!Array.isArray(items) || !items.length) return "(no results)";
+		return items.map((e) => {
+			const entry = e;
+			return typeof entry.path === "string" ? entry.path : JSON.stringify(e);
+		}).join("\r\n");
+	} catch (e) {
+		return ansi.err(e instanceof Error ? e.message : String(e));
+	}
+}
+async function cmdCd(afs, cwd, target) {
+	const newCwd = resolvePath(cwd, target);
+	if (newCwd === "/") return { newCwd };
+	try {
+		const meta = (await afs.stat(newCwd))?.data?.meta ?? {};
+		if (!(meta.kind === "directory" || meta.childrenCount !== void 0 || newCwd.split("/").filter(Boolean).length === 1)) return {
+			newCwd: cwd,
+			error: `Not a directory: ${newCwd}`
+		};
+		return { newCwd };
+	} catch {
+		try {
+			await afs.list(newCwd, { maxDepth: 1 });
+			return { newCwd };
+		} catch {
+			return {
+				newCwd: cwd,
+				error: `Not found: ${newCwd}`
+			};
+		}
+	}
+}
+/**
+* Create a platform-agnostic AFS REPL session.
+*
+* Used by both the CF Worker terminal and the Node daemon terminal.
+* Transport (WebSocket send/receive) is handled by the caller.
+*/
+function createAfsReplSession(afs, opts) {
+	const sessionId = genSessionId();
+	const ansi = makeAnsi(opts.color !== false);
+	let cwd = "/";
+	let cachedProviderCount = null;
+	return {
+		sessionId,
+		getPrompt() {
+			return `afs ${cwd === "/" ? "/" : cwd.split("/").at(-1)}> `;
+		},
+		async countProviders() {
+			if (cachedProviderCount !== null) return cachedProviderCount;
+			try {
+				const result = await afs.list("/");
+				const seen = /* @__PURE__ */ new Set();
+				for (const e of result.data ?? []) if (typeof e?.path === "string") seen.add(e.path);
+				cachedProviderCount = seen.size || 0;
+			} catch {
+				cachedProviderCount = 0;
+			}
+			return cachedProviderCount;
+		},
+		async route(line) {
+			const trimmed = line.trim();
+			if (!trimmed) return {};
+			const args = parseArgs(trimmed.startsWith("afs ") ? trimmed.slice(4).trim() : trimmed);
+			const cmd = args[0]?.toLowerCase() ?? "";
+			switch (cmd) {
+				case "ls": {
+					const rawPath = args[1] ?? cwd;
+					return { output: await cmdLs(afs, resolvePath(cwd, rawPath), ansi) };
+				}
+				case "read":
+				case "cat":
+					if (!args[1]) return { output: ansi.err("Usage: read <path>") };
+					return { output: (await cmdRead(afs, resolvePath(cwd, args[1]), ansi)).replace(/\n/g, "\r\n") };
+				case "write":
+					if (!args[1]) return { output: ansi.err("Usage: write <path> <content>") };
+					return { output: await cmdWrite(afs, resolvePath(cwd, args[1]), args.slice(2).join(" "), ansi) };
+				case "stat": {
+					const rawPath = args[1] ?? cwd;
+					return { output: await cmdStat(afs, resolvePath(cwd, rawPath), ansi) };
+				}
+				case "exec": {
+					if (!args[1]) return { output: ansi.err("Usage: exec <path> [args...]") };
+					const path = resolvePath(cwd, args[1]);
+					const execArgs = {};
+					for (let i = 2; i < args.length; i++) {
+						const kv = args[i].split("=");
+						if (kv.length === 2) execArgs[kv[0]] = kv[1];
+						else execArgs[`arg${i - 2}`] = args[i];
+					}
+					return { output: await cmdExec(afs, path, execArgs, ansi) };
+				}
+				case "explain": {
+					const rawPath = args[1] ?? cwd;
+					return { output: await cmdExplain(afs, resolvePath(cwd, rawPath), ansi) };
+				}
+				case "search":
+					if (!args[1] || !args[2]) return { output: ansi.err("Usage: search <path> <query>") };
+					return { output: await cmdSearch(afs, resolvePath(cwd, args[1]), args.slice(2).join(" "), ansi) };
+				case "cd": {
+					const target = args[1] ?? "/";
+					const { newCwd, error } = await cmdCd(afs, cwd, target);
+					cwd = newCwd;
+					return { output: error ? ansi.err(error) : void 0 };
+				}
+				case "pwd": return { output: cwd };
+				case "help": return { output: ansi.help() };
+				case "clear": return { clear: true };
+				case "exit":
+				case "quit": return { exit: true };
+				default: return { output: `${ansi.err(`Unknown command: ${cmd}`)} — type ${ansi.yellow}help${ansi.r} for available commands` };
+			}
+		}
+	};
+}
+
+//#endregion
+exports.createAfsReplSession = createAfsReplSession;
+exports.renderArcBanner = renderArcBanner;

package/dist/terminal-repl.d.cts

@@ -0,0 +1,69 @@
+import { AFS } from "@aigne/afs";
+
+//#region src/terminal-repl.d.ts
+interface BannerOptions {
+  version: string;
+  commit: string;
+  date: string;
+  /** Provider count to display in the session line. */
+  providerCount?: number;
+  /** Session ID to display in the session line. */
+  sessionId?: string;
+  /** Use ANSI color codes. Default: true. */
+  color?: boolean;
+}
+/**
+ * Render the ARC terminal banner.
+ *
+ * Uses 24-bit truecolor gradient (matches Node splash.ts exactly).
+ *
+ * Output (colored):
+ *   ▄▀█ █▀█ █▀▀  Agentic Realm Computer
+ *   █▀█ █▀▄ █▄▄  v1.0.0 (abc1234) · 2026-04-23
+ *   Copyright (c) 2026 ArcBlock Inc. All rights reserved.
+ *
+ *   Session: <id> · N providers · Type help for commands.
+ */
+declare function renderArcBanner(opts: BannerOptions): string;
+interface AfsReplResult {
+  /** Text to display in the terminal (pre-formatted, CRLF line endings). */
+  output?: string;
+  /** If true, the terminal should clear its screen. */
+  clear?: boolean;
+  /** If true, the session is ending; caller should close the connection. */
+  exit?: boolean;
+}
+interface AfsReplSession {
+  /** Unique session ID (hex string). */
+  readonly sessionId: string;
+  /** Get current prompt string (e.g. `afs data> `). */
+  getPrompt(): string;
+  /**
+   * Count mounted providers via `afs.list("/")`.
+   * Safe to call before the first command — result is cached.
+   */
+  countProviders(): Promise<number>;
+  /**
+   * Route a line of user input.
+   * Handles builtins (cd, pwd, help, clear, exit) and AFS primitives
+   * (ls, read, write, stat, exec, explain, search).
+   */
+  route(line: string): Promise<AfsReplResult>;
+}
+interface AfsReplOptions {
+  version: string;
+  commit: string;
+  date: string;
+  /** Use ANSI color. Default: true. */
+  color?: boolean;
+}
+/**
+ * Create a platform-agnostic AFS REPL session.
+ *
+ * Used by both the CF Worker terminal and the Node daemon terminal.
+ * Transport (WebSocket send/receive) is handled by the caller.
+ */
+declare function createAfsReplSession(afs: AFS, opts: AfsReplOptions): AfsReplSession;
+//#endregion
+export { AfsReplOptions, AfsReplResult, AfsReplSession, BannerOptions, createAfsReplSession, renderArcBanner };
+//# sourceMappingURL=terminal-repl.d.cts.map

package/dist/terminal-repl.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-repl.d.cts","names":[],"sources":["../src/terminal-repl.ts"],"mappings":";;;UAqEiB,aAAA;EACf,OAAA;EACA,MAAA;EACA,IAAA;EAqBoC;EAnBpC,aAAA;EA0De;EAxDf,SAAA;;EAEA,KAAA;AAAA;;;;;AA+DF;;;;;;;;iBAhDgB,eAAA,CAAgB,IAAA,EAAM,aAAA;AAAA,UAuCrB,aAAA;EAkBf;EAhBA,MAAA;EAsBA;EApBA,KAAA;EAoBqB;EAlBrB,IAAA;AAAA;AAAA,UAGe,cAAA;EAkBA;EAAA,SAhBN,SAAA;;EAET,SAAA;EAeA;;;;EAVA,cAAA,IAAkB,OAAA;EAcb;AA2PP;;;;EAnQE,KAAA,CAAM,IAAA,WAAe,OAAA,CAAQ,aAAA;AAAA;AAAA,UAGd,cAAA;EACf,OAAA;EACA,MAAA;EACA,IAAA;EA6PmD;EA3PnD,KAAA;AAAA;;;;;;;iBA2Pc,oBAAA,CAAqB,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,cAAA,GAAiB,cAAA"}

package/dist/terminal-repl.d.mts

@@ -0,0 +1,69 @@
+import { AFS } from "@aigne/afs";
+
+//#region src/terminal-repl.d.ts
+interface BannerOptions {
+  version: string;
+  commit: string;
+  date: string;
+  /** Provider count to display in the session line. */
+  providerCount?: number;
+  /** Session ID to display in the session line. */
+  sessionId?: string;
+  /** Use ANSI color codes. Default: true. */
+  color?: boolean;
+}
+/**
+ * Render the ARC terminal banner.
+ *
+ * Uses 24-bit truecolor gradient (matches Node splash.ts exactly).
+ *
+ * Output (colored):
+ *   ▄▀█ █▀█ █▀▀  Agentic Realm Computer
+ *   █▀█ █▀▄ █▄▄  v1.0.0 (abc1234) · 2026-04-23
+ *   Copyright (c) 2026 ArcBlock Inc. All rights reserved.
+ *
+ *   Session: <id> · N providers · Type help for commands.
+ */
+declare function renderArcBanner(opts: BannerOptions): string;
+interface AfsReplResult {
+  /** Text to display in the terminal (pre-formatted, CRLF line endings). */
+  output?: string;
+  /** If true, the terminal should clear its screen. */
+  clear?: boolean;
+  /** If true, the session is ending; caller should close the connection. */
+  exit?: boolean;
+}
+interface AfsReplSession {
+  /** Unique session ID (hex string). */
+  readonly sessionId: string;
+  /** Get current prompt string (e.g. `afs data> `). */
+  getPrompt(): string;
+  /**
+   * Count mounted providers via `afs.list("/")`.
+   * Safe to call before the first command — result is cached.
+   */
+  countProviders(): Promise<number>;
+  /**
+   * Route a line of user input.
+   * Handles builtins (cd, pwd, help, clear, exit) and AFS primitives
+   * (ls, read, write, stat, exec, explain, search).
+   */
+  route(line: string): Promise<AfsReplResult>;
+}
+interface AfsReplOptions {
+  version: string;
+  commit: string;
+  date: string;
+  /** Use ANSI color. Default: true. */
+  color?: boolean;
+}
+/**
+ * Create a platform-agnostic AFS REPL session.
+ *
+ * Used by both the CF Worker terminal and the Node daemon terminal.
+ * Transport (WebSocket send/receive) is handled by the caller.
+ */
+declare function createAfsReplSession(afs: AFS, opts: AfsReplOptions): AfsReplSession;
+//#endregion
+export { AfsReplOptions, AfsReplResult, AfsReplSession, BannerOptions, createAfsReplSession, renderArcBanner };
+//# sourceMappingURL=terminal-repl.d.mts.map

package/dist/terminal-repl.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-repl.d.mts","names":[],"sources":["../src/terminal-repl.ts"],"mappings":";;;UAqEiB,aAAA;EACf,OAAA;EACA,MAAA;EACA,IAAA;EAqBoC;EAnBpC,aAAA;EA0De;EAxDf,SAAA;;EAEA,KAAA;AAAA;;;;;AA+DF;;;;;;;;iBAhDgB,eAAA,CAAgB,IAAA,EAAM,aAAA;AAAA,UAuCrB,aAAA;EAkBf;EAhBA,MAAA;EAsBA;EApBA,KAAA;EAoBqB;EAlBrB,IAAA;AAAA;AAAA,UAGe,cAAA;EAkBA;EAAA,SAhBN,SAAA;;EAET,SAAA;EAeA;;;;EAVA,cAAA,IAAkB,OAAA;EAcb;AA2PP;;;;EAnQE,KAAA,CAAM,IAAA,WAAe,OAAA,CAAQ,aAAA;AAAA;AAAA,UAGd,cAAA;EACf,OAAA;EACA,MAAA;EACA,IAAA;EA6PmD;EA3PnD,KAAA;AAAA;;;;;;;iBA2Pc,oBAAA,CAAqB,GAAA,EAAK,GAAA,EAAK,IAAA,EAAM,cAAA,GAAiB,cAAA"}