@aigne/afs-cli 1.11.0-beta.5 → 1.11.0-beta.7

package/dist/explorer/components/metadata-panel.mjs

@@ -10,7 +10,7 @@ function formatMetadata(entry, metadata) {
 	const prefix = icon ? `${icon} ` : "";
 	lines.push(`${prefix}${entry.name}`);
 	lines.push("");
-	lines.push(`Type: ${entry.type}`);
+	lines.push(`Path: ${entry.path}`);
 	if (entry.size !== void 0 || metadata?.size !== void 0) {
 		const size = metadata?.size ?? entry.size;
 		lines.push(`Size: ${formatSize(size)}`);
@@ -29,20 +29,131 @@ function formatMetadata(entry, metadata) {
 		const display = hash.length > 20 ? `${hash.slice(0, 20)}...` : hash;
 		lines.push(`Hash: ${display}`);
 	}
-	if (entry.description || metadata?.description) {
-		lines.push("");
-		lines.push("Description:");
-		const wrapped = wrapText(metadata?.description ?? entry.description, 25);
-		lines.push(...wrapped);
+	if (metadata?.mountPath) lines.push(`Mount: ${metadata.mountPath}`);
+	if (metadata?.uri) lines.push(`URI: ${metadata.uri}`);
+	const kinds = entry.kinds && entry.kinds.length > 0 ? entry.kinds : metadata?.extra?.kinds;
+	const kind = entry.kind ?? metadata?.extra?.kind;
+	if (kinds && kinds.length > 0) lines.push(`Kinds: ${kinds.join(" → ")}`);
+	else if (kind) lines.push(`Kind: ${kind}`);
+	if (metadata?.extra && Object.keys(metadata.extra).length > 0) {
+		const builtInFields = new Set([
+			"size",
+			"mimeType",
+			"childrenCount",
+			"hash",
+			"provider",
+			"mountPath",
+			"uri",
+			"permissions",
+			"kind",
+			"kinds"
+		]);
+		for (const [key, value] of Object.entries(metadata.extra)) {
+			if (builtInFields.has(key) || value === void 0) continue;
+			if (key === "inputSchema" && typeof value === "object" && value !== null) {
+				const schema = value;
+				if (schema.properties && typeof schema.properties === "object") {
+					lines.push("");
+					lines.push("InputSchema:");
+					const props = schema.properties;
+					for (const [propName, propSchema] of Object.entries(props)) {
+						const ps = propSchema;
+						const type = ps.type || "any";
+						const desc = ps.description ? ` - ${ps.description}` : "";
+						const req = Array.isArray(schema.required) && schema.required.includes(propName) ? "*" : "";
+						lines.push(`  • ${propName}${req}: ${type}${desc}`);
+					}
+					continue;
+				}
+			}
+			const displayKey = key.charAt(0).toUpperCase() + key.slice(1);
+			const displayValue = formatValue(value);
+			if (displayValue.includes("\n")) {
+				lines.push("");
+				lines.push(`${displayKey}:`);
+				for (const line of displayValue.split("\n")) lines.push(`  ${line}`);
+			} else lines.push(`${displayKey}: ${displayValue}`);
+		}
 	}
-	if (metadata?.mountPath) {
+	const actions = metadata?.actions ?? entry.actions;
+	lines.push("");
+	lines.push("─────── Actions ───────");
+	if (actions && actions.length > 0) {
+		for (let i = 0; i < actions.length; i++) {
+			const action = actions[i];
+			if (action) lines.push(`[${i + 1}] ${action.name}`);
+		}
 		lines.push("");
-		lines.push(`Mount: ${metadata.mountPath}`);
-	}
-	if (metadata?.uri) lines.push(`URI: ${metadata.uri}`);
+		lines.push("(F4 to execute)");
+	} else lines.push("(none)");
 	return lines;
 }
 /**
+* Format a value for display
+*/
+function formatValue(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	if (Array.isArray(value)) {
+		if (value.length === 0) return "[]";
+		if (value.every((v) => typeof v === "string" || typeof v === "number")) return value.join(", ");
+		if (value.every((v) => typeof v === "object" && v !== null && "name" in v)) return formatNamedItems(value);
+		try {
+			return JSON.stringify(value, null, 2);
+		} catch {
+			return "[unable to display]";
+		}
+	}
+	if (typeof value === "object") {
+		const obj = value;
+		if (isSchemaProperties(obj)) return formatSchemaProperties(obj);
+		try {
+			return JSON.stringify(value, null, 2);
+		} catch {
+			return "[unable to display]";
+		}
+	}
+	return String(value);
+}
+/**
+* Check if object looks like JSON Schema properties
+*/
+function isSchemaProperties(obj) {
+	const values = Object.values(obj);
+	if (values.length === 0) return false;
+	return values.every((v) => typeof v === "object" && v !== null && ("type" in v || "$ref" in v));
+}
+/**
+* Format JSON Schema properties object
+*/
+function formatSchemaProperties(props) {
+	const lines = [];
+	for (const [name, schema] of Object.entries(props)) {
+		const s = schema;
+		const type = s.type || s.$ref || "any";
+		const desc = s.description ? ` - ${s.description}` : "";
+		lines.push(`• ${name}: ${type}${desc}`);
+	}
+	return lines.join("\n");
+}
+/**
+* Format array of named items (columns, fields, etc.)
+*/
+function formatNamedItems(items) {
+	const lines = [];
+	for (const item of items) {
+		const type = item.type ? `: ${item.type}` : "";
+		const desc = item.description ? ` - ${item.description}` : "";
+		const flags = [];
+		if (item.primaryKey) flags.push("PK");
+		if (item.nullable) flags.push("nullable");
+		const flagsStr = flags.length > 0 ? ` (${flags.join(", ")})` : "";
+		lines.push(`• ${item.name}${type}${flagsStr}${desc}`);
+	}
+	return lines.join("\n");
+}
+/**
 * Format date and time
 */
 function formatDateTime(date) {
@@ -55,20 +166,6 @@ function formatDateTime(date) {
 	});
 }
 /**
-* Word wrap text
-*/
-function wrapText(text, maxWidth) {
-	const words = text.split(/\s+/);
-	const lines = [];
-	let current = "";
-	for (const word of words) if (current.length + word.length + 1 > maxWidth) {
-		if (current) lines.push(current);
-		current = word;
-	} else current = current ? `${current} ${word}` : word;
-	if (current) lines.push(current);
-	return lines;
-}
-/**
 * Create metadata panel component
 */
 function createMetadataPanel(blessed, options) {

package/dist/explorer/components/metadata-panel.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-panel.mjs","names":[],"sources":["../../../src/explorer/components/metadata-panel.ts"],"sourcesContent":["/**\n * AFS Explorer Metadata Panel Component\n *\n * Right panel showing detailed metadata for selected entry.\n */\n\nimport type Blessed from \"blessed\";\nimport { Colors, formatSize, Icons } from \"../theme.js\";\nimport type { EntryMetadata, ExplorerEntry } from \"../types.js\";\n\nexport interface MetadataPanelOptions {\n  parent: Blessed.Widgets.Node;\n  width: string | number;\n  height: string | number;\n  top?: string | number;\n  right?: string | number;\n}\n\n/**\n * Format metadata for display\n */\nexport function formatMetadata(entry: ExplorerEntry, metadata?: EntryMetadata): string[] {\n  const lines: string[] = [];\n\n  // Entry name with type indicator (only show icon for non-files)\n  const icon = entry.type !== \"file\" ? Icons[entry.type] : \"\";\n  const prefix = icon ? `${icon} ` : \"\";\n  lines.push(`${prefix}${entry.name}`);\n  lines.push(\"\");\n\n  // Type\n  lines.push(`Type: ${entry.type}`);\n\n  // Size\n  if (entry.size !== undefined || metadata?.size !== undefined) {\n    const size = metadata?.size ?? entry.size;\n    lines.push(`Size: ${formatSize(size!)}`);\n  }\n\n  // Children count\n  if (entry.childrenCount !== undefined || metadata?.childrenCount !== undefined) {\n    const count = metadata?.childrenCount ?? entry.childrenCount;\n    lines.push(`Items: ${count}`);\n  }\n\n  // Modified date\n  if (entry.modified || metadata?.modified) {\n    const date = metadata?.modified ?? entry.modified;\n    lines.push(`Modified: ${formatDateTime(date!)}`);\n  }\n\n  // Provider\n  if (entry.provider || metadata?.provider) {\n    lines.push(`Provider: ${metadata?.provider ?? entry.provider}`);\n  }\n\n  // Hash\n  if (entry.hash || metadata?.hash) {\n    const hash = metadata?.hash ?? entry.hash;\n    // Truncate long hashes\n    const display = hash!.length > 20 ? `${hash!.slice(0, 20)}...` : hash;\n    lines.push(`Hash: ${display}`);\n  }\n\n  // Description\n  if (entry.description || metadata?.description) {\n    lines.push(\"\");\n    lines.push(\"Description:\");\n    const desc = metadata?.description ?? entry.description;\n    // Word wrap description\n    const wrapped = wrapText(desc!, 25);\n    lines.push(...wrapped);\n  }\n\n  // Mount path\n  if (metadata?.mountPath) {\n    lines.push(\"\");\n    lines.push(`Mount: ${metadata.mountPath}`);\n  }\n\n  // URI\n  if (metadata?.uri) {\n    lines.push(`URI: ${metadata.uri}`);\n  }\n\n  return lines;\n}\n\n/**\n * Format date and time\n */\nfunction formatDateTime(date: Date): string {\n  return date.toLocaleString(\"en\", {\n    year: \"numeric\",\n    month: \"short\",\n    day: \"numeric\",\n    hour: \"2-digit\",\n    minute: \"2-digit\",\n  });\n}\n\n/**\n * Word wrap text\n */\nfunction wrapText(text: string, maxWidth: number): string[] {\n  const words = text.split(/\\s+/);\n  const lines: string[] = [];\n  let current = \"\";\n\n  for (const word of words) {\n    if (current.length + word.length + 1 > maxWidth) {\n      if (current) lines.push(current);\n      current = word;\n    } else {\n      current = current ? `${current} ${word}` : word;\n    }\n  }\n  if (current) lines.push(current);\n\n  return lines;\n}\n\n/**\n * Create metadata panel component\n */\nexport function createMetadataPanel(blessed: typeof Blessed, options: MetadataPanelOptions) {\n  const { parent, width, height, top = 0, right = 0 } = options;\n\n  // Create box for metadata panel\n  const panel = blessed.box({\n    parent,\n    top,\n    right,\n    width,\n    height,\n    tags: true,\n    scrollable: true,\n    alwaysScroll: true,\n    style: {\n      fg: Colors.fg.normal,\n      bg: Colors.bg.main,\n    },\n    border: {\n      type: \"line\",\n    },\n    label: \" Details \",\n  });\n\n  let currentEntry: ExplorerEntry | undefined;\n  let _currentMetadata: EntryMetadata | undefined;\n\n  return {\n    element: panel,\n\n    /**\n     * Update panel with entry info\n     */\n    update(entry: ExplorerEntry, metadata?: EntryMetadata): void {\n      currentEntry = entry;\n      _currentMetadata = metadata;\n\n      if (entry.type === \"up\") {\n        panel.setContent(\" Parent directory\");\n        (panel.screen as Blessed.Widgets.Screen)?.render();\n        return;\n      }\n\n      const lines = formatMetadata(entry, metadata);\n      panel.setContent(lines.map((l) => ` ${l}`).join(\"\\n\"));\n      (panel.screen as Blessed.Widgets.Screen)?.render();\n    },\n\n    /**\n     * Clear the panel\n     */\n    clear(): void {\n      currentEntry = undefined;\n      _currentMetadata = undefined;\n      panel.setContent(\"\");\n      (panel.screen as Blessed.Widgets.Screen)?.render();\n    },\n\n    /**\n     * Get current entry\n     */\n    getCurrentEntry(): ExplorerEntry | undefined {\n      return currentEntry;\n    },\n\n    /**\n     * Destroy the component\n     */\n    destroy(): void {\n      panel.destroy();\n    },\n  };\n}\n\nexport type MetadataPanel = ReturnType<typeof createMetadataPanel>;\n"],"mappings":"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"}
+{"version":3,"file":"metadata-panel.mjs","names":[],"sources":["../../../src/explorer/components/metadata-panel.ts"],"sourcesContent":["/**\n * AFS Explorer Metadata Panel Component\n *\n * Right panel showing detailed metadata for selected entry.\n */\n\nimport type Blessed from \"blessed\";\nimport { Colors, formatSize, Icons } from \"../theme.js\";\nimport type { EntryMetadata, ExplorerEntry } from \"../types.js\";\n\nexport interface MetadataPanelOptions {\n  parent: Blessed.Widgets.Node;\n  width: string | number;\n  height: string | number;\n  top?: string | number;\n  right?: string | number;\n}\n\n/**\n * Format metadata for display\n */\nexport function formatMetadata(entry: ExplorerEntry, metadata?: EntryMetadata): string[] {\n  const lines: string[] = [];\n\n  // Entry name with type indicator (only show icon for non-files)\n  const icon = entry.type !== \"file\" ? Icons[entry.type] : \"\";\n  const prefix = icon ? `${icon} ` : \"\";\n  lines.push(`${prefix}${entry.name}`);\n  lines.push(\"\");\n\n  // Path\n  lines.push(`Path: ${entry.path}`);\n\n  // Size\n  if (entry.size !== undefined || metadata?.size !== undefined) {\n    const size = metadata?.size ?? entry.size;\n    lines.push(`Size: ${formatSize(size!)}`);\n  }\n\n  // Children count\n  if (entry.childrenCount !== undefined || metadata?.childrenCount !== undefined) {\n    const count = metadata?.childrenCount ?? entry.childrenCount;\n    lines.push(`Items: ${count}`);\n  }\n\n  // Modified date\n  if (entry.modified || metadata?.modified) {\n    const date = metadata?.modified ?? entry.modified;\n    lines.push(`Modified: ${formatDateTime(date!)}`);\n  }\n\n  // Provider\n  if (entry.provider || metadata?.provider) {\n    lines.push(`Provider: ${metadata?.provider ?? entry.provider}`);\n  }\n\n  // Hash\n  if (entry.hash || metadata?.hash) {\n    const hash = metadata?.hash ?? entry.hash;\n    // Truncate long hashes\n    const display = hash!.length > 20 ? `${hash!.slice(0, 20)}...` : hash;\n    lines.push(`Hash: ${display}`);\n  }\n\n  // Mount path\n  if (metadata?.mountPath) {\n    lines.push(`Mount: ${metadata.mountPath}`);\n  }\n\n  // URI\n  if (metadata?.uri) {\n    lines.push(`URI: ${metadata.uri}`);\n  }\n\n  // Kind/Kinds information (show one or the other, avoid redundancy)\n  // Prefer entry.kinds/kind, fallback to metadata.extra.kinds/kind\n  const kinds =\n    entry.kinds && entry.kinds.length > 0\n      ? entry.kinds\n      : (metadata?.extra?.kinds as string[] | undefined);\n  const kind = entry.kind ?? (metadata?.extra?.kind as string | undefined);\n\n  if (kinds && kinds.length > 0) {\n    lines.push(`Kinds: ${kinds.join(\" → \")}`);\n  } else if (kind) {\n    lines.push(`Kind: ${kind}`);\n  }\n\n  // Display all meta fields from extra (flat, same level as other fields)\n  if (metadata?.extra && Object.keys(metadata.extra).length > 0) {\n    // Filter out built-in fields that are already displayed above\n    const builtInFields = new Set([\n      \"size\",\n      \"mimeType\",\n      \"childrenCount\",\n      \"hash\",\n      \"provider\",\n      \"mountPath\",\n      \"uri\",\n      \"permissions\",\n      \"kind\",\n      \"kinds\",\n    ]);\n\n    for (const [key, value] of Object.entries(metadata.extra)) {\n      if (builtInFields.has(key) || value === undefined) continue;\n\n      // Special handling for inputSchema - show properties nicely\n      if (key === \"inputSchema\" && typeof value === \"object\" && value !== null) {\n        const schema = value as Record<string, unknown>;\n        if (schema.properties && typeof schema.properties === \"object\") {\n          lines.push(\"\");\n          lines.push(\"InputSchema:\");\n          const props = schema.properties as Record<string, unknown>;\n          for (const [propName, propSchema] of Object.entries(props)) {\n            const ps = propSchema as Record<string, unknown>;\n            const type = ps.type || \"any\";\n            const desc = ps.description ? ` - ${ps.description}` : \"\";\n            const req =\n              Array.isArray(schema.required) && schema.required.includes(propName) ? \"*\" : \"\";\n            lines.push(`  • ${propName}${req}: ${type}${desc}`);\n          }\n          continue;\n        }\n      }\n\n      // Capitalize first letter of key for display\n      const displayKey = key.charAt(0).toUpperCase() + key.slice(1);\n      const displayValue = formatValue(value);\n\n      if (displayValue.includes(\"\\n\")) {\n        lines.push(\"\");\n        lines.push(`${displayKey}:`);\n        for (const line of displayValue.split(\"\\n\")) {\n          lines.push(`  ${line}`);\n        }\n      } else {\n        lines.push(`${displayKey}: ${displayValue}`);\n      }\n    }\n  }\n\n  // Actions section (prefer metadata.actions from stat, fallback to entry.actions)\n  const actions = metadata?.actions ?? entry.actions;\n  lines.push(\"\");\n  lines.push(\"─────── Actions ───────\");\n  if (actions && actions.length > 0) {\n    for (let i = 0; i < actions.length; i++) {\n      const action = actions[i];\n      if (action) {\n        lines.push(`[${i + 1}] ${action.name}`);\n      }\n    }\n    lines.push(\"\");\n    lines.push(\"(F4 to execute)\");\n  } else {\n    lines.push(\"(none)\");\n  }\n\n  return lines;\n}\n\n/**\n * Format a value for display\n */\nfunction formatValue(value: unknown): string {\n  if (value === null || value === undefined) {\n    return \"\";\n  }\n  if (typeof value === \"string\") {\n    return value;\n  }\n  if (typeof value === \"number\" || typeof value === \"boolean\") {\n    return String(value);\n  }\n  if (Array.isArray(value)) {\n    if (value.length === 0) return \"[]\";\n    // Simple arrays of primitives\n    if (value.every((v) => typeof v === \"string\" || typeof v === \"number\")) {\n      return value.join(\", \");\n    }\n    // Arrays of objects with name/type (like columns, fields, properties)\n    if (value.every((v) => typeof v === \"object\" && v !== null && \"name\" in v)) {\n      return formatNamedItems(\n        value as Array<{ name: string; type?: string; description?: string }>,\n      );\n    }\n    try {\n      return JSON.stringify(value, null, 2);\n    } catch {\n      return \"[unable to display]\";\n    }\n  }\n  if (typeof value === \"object\") {\n    // Check if it's a JSON Schema properties object\n    const obj = value as Record<string, unknown>;\n    if (isSchemaProperties(obj)) {\n      return formatSchemaProperties(obj);\n    }\n    try {\n      return JSON.stringify(value, null, 2);\n    } catch {\n      return \"[unable to display]\";\n    }\n  }\n  return String(value);\n}\n\n/**\n * Check if object looks like JSON Schema properties\n */\nfunction isSchemaProperties(obj: Record<string, unknown>): boolean {\n  const values = Object.values(obj);\n  if (values.length === 0) return false;\n  // Check if values look like schema definitions (have type property)\n  return values.every((v) => typeof v === \"object\" && v !== null && (\"type\" in v || \"$ref\" in v));\n}\n\n/**\n * Format JSON Schema properties object\n */\nfunction formatSchemaProperties(props: Record<string, unknown>): string {\n  const lines: string[] = [];\n  for (const [name, schema] of Object.entries(props)) {\n    const s = schema as Record<string, unknown>;\n    const type = s.type || s.$ref || \"any\";\n    const desc = s.description ? ` - ${s.description}` : \"\";\n    lines.push(`• ${name}: ${type}${desc}`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format array of named items (columns, fields, etc.)\n */\nfunction formatNamedItems(\n  items: Array<{\n    name: string;\n    type?: string;\n    description?: string;\n    nullable?: boolean;\n    primaryKey?: boolean;\n  }>,\n): string {\n  const lines: string[] = [];\n  for (const item of items) {\n    const type = item.type ? `: ${item.type}` : \"\";\n    const desc = item.description ? ` - ${item.description}` : \"\";\n    // Add flags for nullable and primaryKey\n    const flags: string[] = [];\n    if (item.primaryKey) flags.push(\"PK\");\n    if (item.nullable) flags.push(\"nullable\");\n    const flagsStr = flags.length > 0 ? ` (${flags.join(\", \")})` : \"\";\n    lines.push(`• ${item.name}${type}${flagsStr}${desc}`);\n  }\n  return lines.join(\"\\n\");\n}\n\n/**\n * Format date and time\n */\nfunction formatDateTime(date: Date): string {\n  return date.toLocaleString(\"en\", {\n    year: \"numeric\",\n    month: \"short\",\n    day: \"numeric\",\n    hour: \"2-digit\",\n    minute: \"2-digit\",\n  });\n}\n\n/**\n * Create metadata panel component\n */\nexport function createMetadataPanel(blessed: typeof Blessed, options: MetadataPanelOptions) {\n  const { parent, width, height, top = 0, right = 0 } = options;\n\n  // Create box for metadata panel\n  const panel = blessed.box({\n    parent,\n    top,\n    right,\n    width,\n    height,\n    tags: true,\n    scrollable: true,\n    alwaysScroll: true,\n    style: {\n      fg: Colors.fg.normal,\n      bg: Colors.bg.main,\n    },\n    border: {\n      type: \"line\",\n    },\n    label: \" Details \",\n  });\n\n  let currentEntry: ExplorerEntry | undefined;\n  let _currentMetadata: EntryMetadata | undefined;\n\n  return {\n    element: panel,\n\n    /**\n     * Update panel with entry info\n     */\n    update(entry: ExplorerEntry, metadata?: EntryMetadata): void {\n      currentEntry = entry;\n      _currentMetadata = metadata;\n\n      if (entry.type === \"up\") {\n        panel.setContent(\" Parent directory\");\n        (panel.screen as Blessed.Widgets.Screen)?.render();\n        return;\n      }\n\n      const lines = formatMetadata(entry, metadata);\n      panel.setContent(lines.map((l) => ` ${l}`).join(\"\\n\"));\n      (panel.screen as Blessed.Widgets.Screen)?.render();\n    },\n\n    /**\n     * Clear the panel\n     */\n    clear(): void {\n      currentEntry = undefined;\n      _currentMetadata = undefined;\n      panel.setContent(\"\");\n      (panel.screen as Blessed.Widgets.Screen)?.render();\n    },\n\n    /**\n     * Get current entry\n     */\n    getCurrentEntry(): ExplorerEntry | undefined {\n      return currentEntry;\n    },\n\n    /**\n     * Destroy the component\n     */\n    destroy(): void {\n      panel.destroy();\n    },\n  };\n}\n\nexport type MetadataPanel = ReturnType<typeof createMetadataPanel>;\n"],"mappings":"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"}

package/dist/explorer/screen.cjs

@@ -14,24 +14,23 @@ blessed = require_rolldown_runtime.__toESM(blessed);
 
 //#region src/explorer/screen.ts
 /**
-* AFS Explorer Screen
-*
-* Main screen controller that manages all UI components and user interaction.
-*/
-/**
 * Create and run the explorer screen
 */
 async function createExplorerScreen(options) {
-	const { runtime, startPath = "/", version, mountCount } = options;
+	const { afs, startPath = "/", version } = options;
+	const isRemote = !!(options.input || options.output);
 	const store = require_state.createStore(require_actions.createInitialState(startPath));
 	const registry = require_keybindings.createDefaultRegistry();
-	const screen = blessed.default.screen({
+	const screenOpts = {
 		smartCSR: true,
 		title: "AFS Explorer",
-		terminal: "xterm",
+		terminal: options.terminal || "xterm",
 		fullUnicode: true,
 		warnings: false
-	});
+	};
+	if (options.input) screenOpts.input = options.input;
+	if (options.output) screenOpts.output = options.output;
+	const screen = blessed.default.screen(screenOpts);
 	require_status_bar.createStatusBar(blessed.default, {
 		parent: screen,
 		store,
@@ -60,12 +59,13 @@ async function createExplorerScreen(options) {
 		bottom: 0
 	});
 	const dialogs = require_dialog.createDialogManager(blessed.default, { parent: screen });
+	const mountCount = afs.getMounts().length;
 	async function loadPath(path) {
 		store.setState({
 			loading: true,
 			error: void 0
 		});
-		const result = await require_actions.loadDirectory(runtime, path);
+		const result = await require_actions.loadDirectory(afs, path);
 		store.setState({
 			currentPath: path,
 			entries: result.entries,
@@ -79,7 +79,7 @@ async function createExplorerScreen(options) {
 	async function updateMetadata() {
 		const selected = require_actions.navigation.getSelected(store.getState());
 		if (selected) {
-			const metadata = await require_actions.loadMetadata(runtime, selected);
+			const metadata = await require_actions.loadMetadata(afs, selected);
 			metadataPanel.update(selected, metadata);
 		} else metadataPanel.clear();
 	}
@@ -99,7 +99,7 @@ async function createExplorerScreen(options) {
 		if (!selected || selected.type === "up") return;
 		if (selected.type === "file") {
 			dialogs.showLoading("Loading file");
-			const result = await require_actions.readFileContent(runtime, selected.path);
+			const result = await require_actions.readFileContent(afs, selected.path);
 			if (result.error) dialogs.showError("View Error", result.error);
 			else dialogs.showFileView(selected.path, result.content);
 		} else if (selected.type === "directory") await loadPath(selected.path);
@@ -108,16 +108,61 @@ async function createExplorerScreen(options) {
 		const selected = require_actions.navigation.getSelected(store.getState());
 		if (!selected || selected.type === "up") return;
 		dialogs.showLoading("Getting explain info");
-		const result = await require_actions.getExplain(runtime, selected.path);
+		const result = await require_actions.getExplain(afs, selected.path);
 		if (result.error) dialogs.showError("Explain Error", result.error);
 		else dialogs.showExplain(selected.path, result.content);
 	}
+	async function runAction(item) {
+		if (item.inputSchema) dialogs.showParamsInput(item.path, item.inputSchema, async (params) => {
+			dialogs.showLoading("Executing action");
+			const result = await require_actions.executeAction(afs, item.path, item.name, params);
+			dialogs.showActionResult(item.name, result.success, result.message, result.data);
+		});
+		else {
+			dialogs.showLoading("Executing action");
+			const result = await require_actions.executeAction(afs, item.path, item.name);
+			dialogs.showActionResult(item.name, result.success, result.message, result.data);
+		}
+	}
 	async function handleExec() {
 		const selected = require_actions.navigation.getSelected(store.getState());
 		if (!selected || selected.type === "up") return;
-		dialogs.showLoading("Executing action");
-		const result = await require_actions.executeAction(runtime, selected.path, "default");
-		dialogs.showActionResult("default", result.success, result.message, result.data);
+		const metadata = await require_actions.loadMetadata(afs, selected);
+		const actionItems = [];
+		const actions = metadata?.actions ?? selected.actions;
+		if (actions && actions.length > 0) for (const action of actions) {
+			let inputSchema = action.inputSchema;
+			if (!inputSchema) try {
+				const actionPath = `${selected.path}/.actions/${action.name}`;
+				inputSchema = (await afs.stat(actionPath)).data?.meta?.inputSchema;
+			} catch {}
+			actionItems.push({
+				name: action.name,
+				path: `${selected.path}/.actions/${action.name}`,
+				description: action.description,
+				inputSchema
+			});
+		}
+		if (selected.type === "exec") {
+			const inputSchema = metadata?.extra?.inputSchema;
+			actionItems.push({
+				name: "Execute",
+				path: selected.path,
+				description: "Execute this node directly",
+				inputSchema
+			});
+		}
+		if (actionItems.length === 0) {
+			dialogs.showError("No Actions", `${selected.name} has no available actions`);
+			return;
+		}
+		if (actionItems.length === 1) {
+			await runAction(actionItems[0]);
+			return;
+		}
+		dialogs.showActionPicker(selected.path, actionItems, async (item) => {
+			await runAction(item);
+		});
 	}
 	async function handleRefresh() {
 		await loadPath(store.getState().currentPath);
@@ -129,13 +174,19 @@ async function createExplorerScreen(options) {
 		exec: handleExec,
 		refresh: handleRefresh,
 		quit: () => {
-			dialogs.showConfirm("Are you sure you want to quit?", () => {
-				screen.destroy();
-				require_index.printLogo();
+			dialogs.showConfirm("Are you sure you want to quit?", async () => {
+				if (isRemote || options.onExit) {
+					screen.destroy();
+					options.onExit?.();
+					return;
+				}
+				const logo = require_index.colors.brightCyan("▄▀█ █▀▀ █▀\n█▀█ █▀░ ▄█\n");
+				const tagline = require_index.colors.dim("Agentic File System");
 				const versionPart = require_index.colors.green(`v${version}`);
 				const mountPart = require_index.colors.yellow(`${mountCount} ${mountCount === 1 ? "mount" : "mounts"}`);
-				console.log(`${versionPart} ${require_index.colors.dim("•")} ${mountPart}`);
-				console.log(require_index.colors.dim("\nThanks for using AFS Explorer!\n"));
+				const farewell = `\n${logo}${tagline}\n\n${`${versionPart} ${require_index.colors.dim("•")} ${mountPart}`}\n${require_index.colors.dim("Thanks for using AFS Explorer!")}\n`;
+				screen.destroy();
+				process.stdout.write(farewell);
 				process.exit(0);
 			});
 		},

package/dist/explorer/screen.d.cts

@@ -0,0 +1,23 @@
+import { AFS } from "@aigne/afs";
+
+//#region src/explorer/screen.d.ts
+interface ExplorerScreenOptions {
+  afs: AFS;
+  startPath?: string;
+  version: string;
+  /** Custom input stream (for remote/WebSocket sessions). */
+  input?: NodeJS.ReadableStream;
+  /** Custom output stream (for remote/WebSocket sessions). */
+  output?: NodeJS.WritableStream;
+  /** Terminal type override. */
+  terminal?: string;
+  /** Called when the screen is destroyed (instead of process.exit). */
+  onExit?: () => void;
+}
+/**
+ * Create and run the explorer screen
+ */
+declare function createExplorerScreen(options: ExplorerScreenOptions): Promise<void>;
+//#endregion
+export { createExplorerScreen };
+//# sourceMappingURL=screen.d.cts.map

package/dist/explorer/screen.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.cts","names":[],"sources":["../../src/explorer/screen.ts"],"mappings":";;;UA6BiB,qBAAA;EACf,GAAA,EAAK,GAAA;EACL,SAAA;EACA,OAAA;EAI8B;EAF9B,KAAA,GAAQ,MAAA,CAAO,cAAA;EAJV;EAML,MAAA,GAAS,MAAA,CAAO,cAAA;EAJhB;EAMA,QAAA;EAJQ;EAMR,MAAA;AAAA;;;;iBAMoB,oBAAA,CAAqB,OAAA,EAAS,qBAAA,GAAwB,OAAA"}

package/dist/explorer/screen.d.mts

@@ -0,0 +1,23 @@
+import { AFS } from "@aigne/afs";
+
+//#region src/explorer/screen.d.ts
+interface ExplorerScreenOptions {
+  afs: AFS;
+  startPath?: string;
+  version: string;
+  /** Custom input stream (for remote/WebSocket sessions). */
+  input?: NodeJS.ReadableStream;
+  /** Custom output stream (for remote/WebSocket sessions). */
+  output?: NodeJS.WritableStream;
+  /** Terminal type override. */
+  terminal?: string;
+  /** Called when the screen is destroyed (instead of process.exit). */
+  onExit?: () => void;
+}
+/**
+ * Create and run the explorer screen
+ */
+declare function createExplorerScreen(options: ExplorerScreenOptions): Promise<void>;
+//#endregion
+export { createExplorerScreen };
+//# sourceMappingURL=screen.d.mts.map

package/dist/explorer/screen.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.mts","names":[],"sources":["../../src/explorer/screen.ts"],"mappings":";;;UA6BiB,qBAAA;EACf,GAAA,EAAK,GAAA;EACL,SAAA;EACA,OAAA;EAI8B;EAF9B,KAAA,GAAQ,MAAA,CAAO,cAAA;EAJV;EAML,MAAA,GAAS,MAAA,CAAO,cAAA;EAJhB;EAMA,QAAA;EAJQ;EAMR,MAAA;AAAA;;;;iBAMoB,oBAAA,CAAqB,OAAA,EAAS,qBAAA,GAAwB,OAAA"}

package/dist/explorer/screen.mjs

@@ -1,4 +1,4 @@
-import { colors, printLogo } from "../ui/index.mjs";
+import { colors } from "../ui/index.mjs";
 import { createInitialState, executeAction, getExplain, loadDirectory, loadMetadata, navigation, readFileContent } from "./actions.mjs";
 import { createDefaultRegistry } from "./keybindings.mjs";
 import { createDialogManager } from "./components/dialog.mjs";
@@ -12,24 +12,23 @@ import blessed from "blessed";
 
 //#region src/explorer/screen.ts
 /**
-* AFS Explorer Screen
-*
-* Main screen controller that manages all UI components and user interaction.
-*/
-/**
 * Create and run the explorer screen
 */
 async function createExplorerScreen(options) {
-	const { runtime, startPath = "/", version, mountCount } = options;
+	const { afs, startPath = "/", version } = options;
+	const isRemote = !!(options.input || options.output);
 	const store = createStore(createInitialState(startPath));
 	const registry = createDefaultRegistry();
-	const screen = blessed.screen({
+	const screenOpts = {
 		smartCSR: true,
 		title: "AFS Explorer",
-		terminal: "xterm",
+		terminal: options.terminal || "xterm",
 		fullUnicode: true,
 		warnings: false
-	});
+	};
+	if (options.input) screenOpts.input = options.input;
+	if (options.output) screenOpts.output = options.output;
+	const screen = blessed.screen(screenOpts);
 	createStatusBar(blessed, {
 		parent: screen,
 		store,
@@ -58,12 +57,13 @@ async function createExplorerScreen(options) {
 		bottom: 0
 	});
 	const dialogs = createDialogManager(blessed, { parent: screen });
+	const mountCount = afs.getMounts().length;
 	async function loadPath(path) {
 		store.setState({
 			loading: true,
 			error: void 0
 		});
-		const result = await loadDirectory(runtime, path);
+		const result = await loadDirectory(afs, path);
 		store.setState({
 			currentPath: path,
 			entries: result.entries,
@@ -77,7 +77,7 @@ async function createExplorerScreen(options) {
 	async function updateMetadata() {
 		const selected = navigation.getSelected(store.getState());
 		if (selected) {
-			const metadata = await loadMetadata(runtime, selected);
+			const metadata = await loadMetadata(afs, selected);
 			metadataPanel.update(selected, metadata);
 		} else metadataPanel.clear();
 	}
@@ -97,7 +97,7 @@ async function createExplorerScreen(options) {
 		if (!selected || selected.type === "up") return;
 		if (selected.type === "file") {
 			dialogs.showLoading("Loading file");
-			const result = await readFileContent(runtime, selected.path);
+			const result = await readFileContent(afs, selected.path);
 			if (result.error) dialogs.showError("View Error", result.error);
 			else dialogs.showFileView(selected.path, result.content);
 		} else if (selected.type === "directory") await loadPath(selected.path);
@@ -106,16 +106,61 @@ async function createExplorerScreen(options) {
 		const selected = navigation.getSelected(store.getState());
 		if (!selected || selected.type === "up") return;
 		dialogs.showLoading("Getting explain info");
-		const result = await getExplain(runtime, selected.path);
+		const result = await getExplain(afs, selected.path);
 		if (result.error) dialogs.showError("Explain Error", result.error);
 		else dialogs.showExplain(selected.path, result.content);
 	}
+	async function runAction(item) {
+		if (item.inputSchema) dialogs.showParamsInput(item.path, item.inputSchema, async (params) => {
+			dialogs.showLoading("Executing action");
+			const result = await executeAction(afs, item.path, item.name, params);
+			dialogs.showActionResult(item.name, result.success, result.message, result.data);
+		});
+		else {
+			dialogs.showLoading("Executing action");
+			const result = await executeAction(afs, item.path, item.name);
+			dialogs.showActionResult(item.name, result.success, result.message, result.data);
+		}
+	}
 	async function handleExec() {
 		const selected = navigation.getSelected(store.getState());
 		if (!selected || selected.type === "up") return;
-		dialogs.showLoading("Executing action");
-		const result = await executeAction(runtime, selected.path, "default");
-		dialogs.showActionResult("default", result.success, result.message, result.data);
+		const metadata = await loadMetadata(afs, selected);
+		const actionItems = [];
+		const actions = metadata?.actions ?? selected.actions;
+		if (actions && actions.length > 0) for (const action of actions) {
+			let inputSchema = action.inputSchema;
+			if (!inputSchema) try {
+				const actionPath = `${selected.path}/.actions/${action.name}`;
+				inputSchema = (await afs.stat(actionPath)).data?.meta?.inputSchema;
+			} catch {}
+			actionItems.push({
+				name: action.name,
+				path: `${selected.path}/.actions/${action.name}`,
+				description: action.description,
+				inputSchema
+			});
+		}
+		if (selected.type === "exec") {
+			const inputSchema = metadata?.extra?.inputSchema;
+			actionItems.push({
+				name: "Execute",
+				path: selected.path,
+				description: "Execute this node directly",
+				inputSchema
+			});
+		}
+		if (actionItems.length === 0) {
+			dialogs.showError("No Actions", `${selected.name} has no available actions`);
+			return;
+		}
+		if (actionItems.length === 1) {
+			await runAction(actionItems[0]);
+			return;
+		}
+		dialogs.showActionPicker(selected.path, actionItems, async (item) => {
+			await runAction(item);
+		});
 	}
 	async function handleRefresh() {
 		await loadPath(store.getState().currentPath);
@@ -127,13 +172,19 @@ async function createExplorerScreen(options) {
 		exec: handleExec,
 		refresh: handleRefresh,
 		quit: () => {
-			dialogs.showConfirm("Are you sure you want to quit?", () => {
-				screen.destroy();
-				printLogo();
+			dialogs.showConfirm("Are you sure you want to quit?", async () => {
+				if (isRemote || options.onExit) {
+					screen.destroy();
+					options.onExit?.();
+					return;
+				}
+				const logo = colors.brightCyan("▄▀█ █▀▀ █▀\n█▀█ █▀░ ▄█\n");
+				const tagline = colors.dim("Agentic File System");
 				const versionPart = colors.green(`v${version}`);
 				const mountPart = colors.yellow(`${mountCount} ${mountCount === 1 ? "mount" : "mounts"}`);
-				console.log(`${versionPart} ${colors.dim("•")} ${mountPart}`);
-				console.log(colors.dim("\nThanks for using AFS Explorer!\n"));
+				const farewell = `\n${logo}${tagline}\n\n${`${versionPart} ${colors.dim("•")} ${mountPart}`}\n${colors.dim("Thanks for using AFS Explorer!")}\n`;
+				screen.destroy();
+				process.stdout.write(farewell);
 				process.exit(0);
 			});
 		},