@vertana/cli 0.1.0-dev.8 → 0.2.0-dev.15

package/dist/index.cjs

@@ -41,6 +41,7 @@ let node_fs = require("node:fs");
 let _napi_rs_keyring = require("@napi-rs/keyring");
 let node_os = require("node:os");
 let node_path = require("node:path");
+let _vertana_context_web = require("@vertana/context-web");
 let _vertana_facade = require("@vertana/facade");
 let node_stream = require("node:stream");
 
@@ -399,13 +400,13 @@ const globalOptions = (0, _optique_core_constructs.object)({ logging: (0, _optiq
 */
 const translateCommand = (0, _optique_core_primitives.command)("translate", (0, _optique_core_constructs.object)({
 	command: (0, _optique_core_primitives.constant)("translate"),
-	target: (0, _optique_core_primitives.option)("-t", "--target", (0, _optique_core_valueparser.string)({ metavar: "LANG" })),
-	source: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.option)("-s", "--source", (0, _optique_core_valueparser.string)({ metavar: "LANG" }))),
+	target: (0, _optique_core_primitives.option)("-t", "--target", (0, _optique_core_valueparser.string)({ metavar: "LANG" }), { description: _optique_core_message.message`Target language code (e.g., ${"ko"}, ${"ja"}, ${"es"}).` }),
+	source: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.option)("-s", "--source", (0, _optique_core_valueparser.string)({ metavar: "LANG" }), { description: _optique_core_message.message`Source language code. Auto-detected if omitted.` })),
 	mediaType: (0, _optique_core_modifiers.withDefault)((0, _optique_core_primitives.option)("-T", "--type", (0, _optique_core_valueparser.choice)([
 		"text/plain",
 		"text/markdown",
 		"text/html"
-	])), "text/plain"),
+	]), { description: _optique_core_message.message`Media type of the input text.` }), "text/plain"),
 	tone: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.option)("--tone", (0, _optique_core_valueparser.choice)([
 		"formal",
 		"informal",
@@ -414,23 +415,24 @@ const translateCommand = (0, _optique_core_primitives.command)("translate", (0,
 		"professional",
 		"literary",
 		"journalistic"
-	]))),
-	domain: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.option)("--domain", (0, _optique_core_valueparser.string)())),
-	glossary: (0, _optique_core_modifiers.multiple)((0, _optique_core_primitives.option)("-g", "--glossary", glossaryEntry())),
+	]), { description: _optique_core_message.message`Tone of the translation.` })),
+	domain: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.option)("--domain", (0, _optique_core_valueparser.string)(), { description: _optique_core_message.message`Domain or context (e.g., ${"legal"}, ${"medical"}, ${"tech"}).` })),
+	glossary: (0, _optique_core_modifiers.multiple)((0, _optique_core_primitives.option)("-g", "--glossary", glossaryEntry(), { description: _optique_core_message.message`Term translation mapping. Can be repeated.` })),
 	glossaryFile: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.option)("--glossary-file", (0, _optique_run_valueparser.path)({
 		mustExist: true,
 		type: "file"
-	}))),
-	output: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.option)("-o", "--output", (0, _optique_run_valueparser.path)({ metavar: "FILE" }))),
-	input: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.argument)((0, _optique_run_valueparser.path)({ metavar: "FILE" })))
-}));
+	}), { description: _optique_core_message.message`Path to a JSON file with glossary entries.` })),
+	fetchLinks: (0, _optique_core_primitives.option)("-L", "--fetch-links", { description: _optique_core_message.message`Fetch linked pages for additional context.` }),
+	output: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.option)("-o", "--output", (0, _optique_run_valueparser.path)({ metavar: "FILE" }), { description: _optique_core_message.message`Output file path. Writes to stdout if omitted.` })),
+	input: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.argument)((0, _optique_run_valueparser.path)({ metavar: "FILE" }), { description: _optique_core_message.message`Input file. Reads from stdin if omitted.` }))
+}), { description: _optique_core_message.message`Translate text to another language using an LLM.` });
 /**
 * Parser for the "config model" subcommand.
 */
 const configModelCommand = (0, _optique_core_primitives.command)("model", (0, _optique_core_constructs.object)({
 	subcommand: (0, _optique_core_primitives.constant)("model"),
-	value: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.argument)(modelCode()))
-}));
+	value: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.argument)(modelCode(), { description: _optique_core_message.message`Model to configure in provider:model format.` }))
+}), { description: _optique_core_message.message`Get or set the default LLM model.` });
 /**
 * Parser for the "config api-key" subcommand.
 */
@@ -440,16 +442,16 @@ const configApiKeyCommand = (0, _optique_core_primitives.command)("api-key", (0,
 		"openai",
 		"anthropic",
 		"google"
-	], { metavar: "PROVIDER" })),
-	key: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.argument)((0, _optique_core_valueparser.string)({ metavar: "KEY" })))
-}));
+	], { metavar: "PROVIDER" }), { description: _optique_core_message.message`Provider name.` }),
+	key: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.argument)((0, _optique_core_valueparser.string)({ metavar: "KEY" }), { description: _optique_core_message.message`API key value. Prompts if omitted.` }))
+}), { description: _optique_core_message.message`Get or set an API key for a provider.` });
 /**
 * Parser for the "config" subcommand with nested subcommands.
 */
 const configCommand = (0, _optique_core_primitives.command)("config", (0, _optique_core_constructs.object)({
 	command: (0, _optique_core_primitives.constant)("config"),
 	action: (0, _optique_core_constructs.or)(configModelCommand, configApiKeyCommand)
-}));
+}), { description: _optique_core_message.message`Configure CLI settings such as model and API keys.` });
 /**
 * The main CLI parser combining all subcommands.
 */
@@ -577,12 +579,14 @@ async function executeTranslate(result) {
 		return;
 	}
 	const glossary = buildGlossary(result.glossary, result.glossaryFile);
+	const contextSources = buildContextSources(inputText, result.mediaType, result.fetchLinks);
 	const translation = await (0, _vertana_facade.translate)(model, result.target, inputText, {
 		sourceLanguage: result.source,
 		mediaType: result.mediaType,
 		tone: result.tone,
 		domain: result.domain,
-		glossary: glossary.length > 0 ? glossary : void 0
+		glossary: glossary.length > 0 ? glossary : void 0,
+		contextSources: contextSources.length > 0 ? contextSources : void 0
 	});
 	if (result.output != null) try {
 		(0, node_fs.writeFileSync)(result.output, translation.text + "\n", "utf-8");
@@ -612,6 +616,25 @@ function buildGlossary(cliEntries, filePath) {
 	if (cliEntries.length > 0) glossaries.push(cliEntries);
 	return mergeGlossaries(...glossaries);
 }
+/**
+* Builds context sources based on CLI options.
+*
+* @param text The input text.
+* @param mediaType The media type of the text.
+* @param fetchLinksEnabled Whether to fetch linked pages.
+* @returns Array of context sources.
+*/
+function buildContextSources(text$5, mediaType, fetchLinksEnabled) {
+	const sources = [];
+	if (fetchLinksEnabled) {
+		sources.push((0, _vertana_context_web.fetchLinkedPages)({
+			text: text$5,
+			mediaType
+		}));
+		sources.push(_vertana_context_web.fetchWebPage);
+	}
+	return sources;
+}
 
 //#endregion
 //#region src/index.ts

package/dist/index.mjs

@@ -13,6 +13,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { Entry } from "@napi-rs/keyring";
 import { homedir } from "node:os";
 import { join } from "node:path";
+import { fetchLinkedPages, fetchWebPage } from "@vertana/context-web";
 import { translate } from "@vertana/facade";
 import { Readable } from "node:stream";
 
@@ -371,13 +372,13 @@ const globalOptions = object({ logging: loggingOptions({ level: "verbosity" }) }
 */
 const translateCommand = command("translate", object({
 	command: constant("translate"),
-	target: option("-t", "--target", string({ metavar: "LANG" })),
-	source: optional(option("-s", "--source", string({ metavar: "LANG" }))),
+	target: option("-t", "--target", string({ metavar: "LANG" }), { description: message`Target language code (e.g., ${"ko"}, ${"ja"}, ${"es"}).` }),
+	source: optional(option("-s", "--source", string({ metavar: "LANG" }), { description: message`Source language code. Auto-detected if omitted.` })),
 	mediaType: withDefault(option("-T", "--type", choice([
 		"text/plain",
 		"text/markdown",
 		"text/html"
-	])), "text/plain"),
+	]), { description: message`Media type of the input text.` }), "text/plain"),
 	tone: optional(option("--tone", choice([
 		"formal",
 		"informal",
@@ -386,23 +387,24 @@ const translateCommand = command("translate", object({
 		"professional",
 		"literary",
 		"journalistic"
-	]))),
-	domain: optional(option("--domain", string())),
-	glossary: multiple(option("-g", "--glossary", glossaryEntry())),
+	]), { description: message`Tone of the translation.` })),
+	domain: optional(option("--domain", string(), { description: message`Domain or context (e.g., ${"legal"}, ${"medical"}, ${"tech"}).` })),
+	glossary: multiple(option("-g", "--glossary", glossaryEntry(), { description: message`Term translation mapping. Can be repeated.` })),
 	glossaryFile: optional(option("--glossary-file", path({
 		mustExist: true,
 		type: "file"
-	}))),
-	output: optional(option("-o", "--output", path({ metavar: "FILE" }))),
-	input: optional(argument(path({ metavar: "FILE" })))
-}));
+	}), { description: message`Path to a JSON file with glossary entries.` })),
+	fetchLinks: option("-L", "--fetch-links", { description: message`Fetch linked pages for additional context.` }),
+	output: optional(option("-o", "--output", path({ metavar: "FILE" }), { description: message`Output file path. Writes to stdout if omitted.` })),
+	input: optional(argument(path({ metavar: "FILE" }), { description: message`Input file. Reads from stdin if omitted.` }))
+}), { description: message`Translate text to another language using an LLM.` });
 /**
 * Parser for the "config model" subcommand.
 */
 const configModelCommand = command("model", object({
 	subcommand: constant("model"),
-	value: optional(argument(modelCode()))
-}));
+	value: optional(argument(modelCode(), { description: message`Model to configure in provider:model format.` }))
+}), { description: message`Get or set the default LLM model.` });
 /**
 * Parser for the "config api-key" subcommand.
 */
@@ -412,16 +414,16 @@ const configApiKeyCommand = command("api-key", object({
 		"openai",
 		"anthropic",
 		"google"
-	], { metavar: "PROVIDER" })),
-	key: optional(argument(string({ metavar: "KEY" })))
-}));
+	], { metavar: "PROVIDER" }), { description: message`Provider name.` }),
+	key: optional(argument(string({ metavar: "KEY" }), { description: message`API key value. Prompts if omitted.` }))
+}), { description: message`Get or set an API key for a provider.` });
 /**
 * Parser for the "config" subcommand with nested subcommands.
 */
 const configCommand = command("config", object({
 	command: constant("config"),
 	action: or(configModelCommand, configApiKeyCommand)
-}));
+}), { description: message`Configure CLI settings such as model and API keys.` });
 /**
 * The main CLI parser combining all subcommands.
 */
@@ -549,12 +551,14 @@ async function executeTranslate(result) {
 		return;
 	}
 	const glossary = buildGlossary(result.glossary, result.glossaryFile);
+	const contextSources = buildContextSources(inputText, result.mediaType, result.fetchLinks);
 	const translation = await translate(model, result.target, inputText, {
 		sourceLanguage: result.source,
 		mediaType: result.mediaType,
 		tone: result.tone,
 		domain: result.domain,
-		glossary: glossary.length > 0 ? glossary : void 0
+		glossary: glossary.length > 0 ? glossary : void 0,
+		contextSources: contextSources.length > 0 ? contextSources : void 0
 	});
 	if (result.output != null) try {
 		writeFileSync(result.output, translation.text + "\n", "utf-8");
@@ -584,6 +588,25 @@ function buildGlossary(cliEntries, filePath) {
 	if (cliEntries.length > 0) glossaries.push(cliEntries);
 	return mergeGlossaries(...glossaries);
 }
+/**
+* Builds context sources based on CLI options.
+*
+* @param text The input text.
+* @param mediaType The media type of the text.
+* @param fetchLinksEnabled Whether to fetch linked pages.
+* @returns Array of context sources.
+*/
+function buildContextSources(text$1, mediaType, fetchLinksEnabled) {
+	const sources = [];
+	if (fetchLinksEnabled) {
+		sources.push(fetchLinkedPages({
+			text: text$1,
+			mediaType
+		}));
+		sources.push(fetchWebPage);
+	}
+	return sources;
+}
 
 //#endregion
 //#region src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertana/cli",
-  "version": "0.1.0-dev.8+2c1883ec",
+  "version": "0.2.0-dev.15+f34ed253",
   "description": "Command-line interface for Vertana translation",
   "keywords": [
     "LLM",
@@ -59,9 +59,10 @@
   "dependencies": {
     "@logtape/logtape": "^1.3.5",
     "@napi-rs/keyring": "^1.2.0",
-    "@optique/core": "^0.8.3",
-    "@optique/logtape": "^0.8.3",
-    "@optique/run": "^0.8.3",
+    "@optique/core": "^0.8.5",
+    "@optique/logtape": "^0.8.5",
+    "@optique/run": "^0.8.5",
+    "@vertana/context-web": "",
     "@vertana/facade": ""
   },
   "peerDependencies": {