@vertana/cli 0.1.0-dev.1 → 0.1.0-dev.10

package/README.md

@@ -0,0 +1,93 @@
+@vertana/cli
+============
+
+[![JSR][JSR badge]][JSR]
+[![npm][npm badge]][npm]
+
+> [!CAUTION]
+> Vertana is currently in early development for proof of concept purposes,
+> and is not yet ready for production use.  The API is subject to change,
+> and there may be bugs or missing features.
+
+Command-line interface for [Vertana] translation.  Translate documents from
+the terminal with support for multiple providers (OpenAI, Anthropic, Google).
+
+[JSR]: https://jsr.io/@vertana/cli
+[JSR badge]: https://jsr.io/badges/@vertana/cli
+[npm]: https://www.npmjs.com/package/@vertana/cli
+[npm badge]: https://img.shields.io/npm/v/@vertana/cli?logo=npm
+[Vertana]: https://vertana.org/
+
+
+Installation
+------------
+
+~~~~ bash
+deno install -g --name vertana --allow-all jsr:@vertana/cli
+npm  install -g @vertana/cli
+pnpm add     -g @vertana/cli
+bun  add     -g @vertana/cli
+~~~~
+
+
+Quick start
+-----------
+
+First, configure your API key and default model:
+
+~~~~ bash
+vertana config api-key openai
+vertana config model openai:gpt-4o
+~~~~
+
+Then translate a file:
+
+~~~~ bash
+vertana translate -t ko document.md
+~~~~
+
+Or pipe text through stdin:
+
+~~~~ bash
+echo "Hello, world!" | vertana translate -t ko
+~~~~
+
+
+Commands
+--------
+
+### translate
+
+Translate text or files to a target language.
+
+~~~~ bash
+vertana translate [options] [input]
+~~~~
+
+Options:
+
+ -  `-t, --target LANG`: Target language (required)
+ -  `-s, --source LANG`: Source language (optional, auto-detected)
+ -  `-T, --type TYPE`: Media type (`text/plain`, `text/markdown`, `text/html`)
+ -  `--tone TONE`: Translation tone (formal, informal, technical, etc.)
+ -  `--domain DOMAIN`: Subject domain for terminology
+ -  `-g, --glossary TERM=TRANS`: Add glossary entry (repeatable)
+ -  `--glossary-file FILE`: Load glossary from file
+ -  `-o, --output FILE`: Output file (defaults to stdout)
+
+
+### config
+
+Manage configuration settings.
+
+~~~~ bash
+vertana config model [PROVIDER:MODEL]  # Set or display default model
+vertana config api-key PROVIDER [KEY]  # Manage API keys
+~~~~
+
+Supported providers: `openai`, `anthropic`, `google`
+
+
+For more resources, see the [docs].
+
+[docs]: https://vertana.org/

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");
 
@@ -421,6 +422,7 @@ const translateCommand = (0, _optique_core_primitives.command)("translate", (0,
 		mustExist: true,
 		type: "file"
 	}))),
+	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" }))),
 	input: (0, _optique_core_modifiers.optional)((0, _optique_core_primitives.argument)((0, _optique_run_valueparser.path)({ metavar: "FILE" })))
 }));
@@ -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";
 
@@ -393,6 +394,7 @@ const translateCommand = command("translate", object({
 		mustExist: true,
 		type: "file"
 	}))),
+	fetchLinks: option("-L", "--fetch-links", { description: message`Fetch linked pages for additional context.` }),
 	output: optional(option("-o", "--output", path({ metavar: "FILE" }))),
 	input: optional(argument(path({ metavar: "FILE" })))
 }));
@@ -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.1",
+  "version": "0.1.0-dev.10+fd710745",
   "description": "Command-line interface for Vertana translation",
   "keywords": [
     "LLM",
@@ -62,6 +62,7 @@
     "@optique/core": "^0.8.3",
     "@optique/logtape": "^0.8.3",
     "@optique/run": "^0.8.3",
+    "@vertana/context-web": "",
     "@vertana/facade": ""
   },
   "peerDependencies": {