tune-sdk 0.2.2 → 0.2.4

package/README.md

@@ -6,6 +6,18 @@ With tune [javascript sdk](https://www.npmjs.com/package/tune-sdk) you can make
 ## Demo
 <img src="https://github.com/iovdin/tune/blob/770f382a03a25e15eeef293f553b6aee0f3531f6/docs/assets/gifs/tune.gif">
 
+
+## Setup
+install tune-sdk
+```bash
+npm install -g tune-sdk
+
+tune-sdk init
+```
+
+edit `~/.tune/.env` file and add `OPENAI_KEY` and other keys
+
+
 ## Template Language
 
 ```chat
@@ -24,9 +36,41 @@ With tune [javascript sdk](https://www.npmjs.com/package/tune-sdk) you can make
 ```
 [read more](https://iovdin.github.io/tune/template-language)
 
+## Extend with Middlewares
+Extend Tune with middlewares:
+
+* [tune-fs](https://www.npmjs.com/package/tune-fs) - connect tools & files from local filesystem
+* [tune-models](https://www.npmjs.com/package/tune-models) - connect llm models from Anthropic/OpenAI/Gemini/Openrouter/Mistral/Groq
+* [tune-basic-toolset](https://www.npmjs.com/package/tune-basic-toolset) - basic tools like read file, write file, shell etc.
+* [tune-s3](https://www.npmjs.com/package/tune-s3) - read/write files from s3
+
+For example:
+```sh
+cd ~/.tune 
+npm install tune-models
+```
+
+Edit `default.ctx.js` and add middlewares
+```javascript
+const models = require('tune-models')
+
+module.exports = [
+    ...
+    models({
+        default: "gpt-5-mini"
+    })
+    ...
+]
+```
+
+Edit `.env` file and add provider's keys
 
-## Batteries Included
-**Anthropic/OpenAI/Gemini/Openrouter/Mistral/Groq** models providers are supported and **30+ tools** come with text editor.
+```.env
+OPENAI_KEY="<openai_key>"
+ANTHROPIC_KEY="<anthropic_key>"
+```
+
+Use it in chat
 ```chat
 system: 
 @gemini-2.5-pro @openai_imgen
@@ -41,20 +85,23 @@ a simple stickman drawing with a talking bubble saying 'Hello world'
 tool_result: 
 image generated
 ```
-[read more](tools/README.md)
+
 
 ## CLI
 
 ```bash
+# install tune globally
+npm install -g tune-sdk
+
 # append user message to newchat.chat run and save
-npx tune-sdk --user "hi how are you?" --filename newchat.chat  --save
+tune-sdk --user "hi how are you?" --filename newchat.chat  --save
 
 # start new chat with system prompt and initial user message 
 # print result to console
-npx tune-sdk --system "You are Groot" --user "Hi how are you?"
+tune-sdk --system "You are Groot" --user "Hi how are you?"
 
 #set context variable
-npx tune-sdk --set-test "hello" --user "@test" --system "You are echo you print everythting back"  
+tune-sdk --set-test "hello" --user "@test" --system "You are echo you print everythting back"  
 ```
 
 

package/config/default.ctx.js

@@ -1,25 +1,22 @@
-const fs = require('fs') 
 const path = require('path')
 
 const models = require("tune-models")
-const { curFile, fsMix, defaultWrite } = require("tune-sdk/fsctx");
-const { file2run, makeContext } = require("tune-sdk");
+const basics = require("tune-basic-toolset")
+const tunefs = require("tune-fs")
+const { current, writer } = tunefs
 
-async function makeSchema(params, ctx) {
-  return file2run({ filename:  path.join(__dirname, "schema.tool.chat")}, params, ctx);
-}
 let dirs = [];
 if (process.env.TUNE_PATH) {
   dirs = process.env.TUNE_PATH.split(path.delimiter);
 }
 
-
 module.exports = [
-  // curFile,
-  fsMix(dirs, { makeSchema }),
+  current(),
+  basics(),
+  tunefs({ paths: dirs, makeSchema: true }),
   models({
-    default: "gpt-4.1-mini",
+    default: "gpt-5-mini",
     alias: { "sonnet": "claude-sonnet-4-20250514"}
   }),
-  defaultWrite()
+  writer()
 ]

package/config/editor-filename.chat

@@ -0,0 +1,10 @@
+s: @{ gpt-5-nano | json_format }
+You are giving name for chat based on the chat contents
+chat file content:
+```
+@{ editor/buffer | head 100}
+```
+example json output:
+{ "filename": "how-to-make-hero-costume.chat"}
+or
+{ "filename": "accounting-database-zig.chat"}

package/config/package.json

@@ -1,5 +1,7 @@
 {
   "dependencies": {
+    "tune-basic-toolset": "latest",
+    "tune-fs": "latest",
     "tune-models": "latest",
     "tune-sdk": "latest"
   }

package/dist/cli.js

@@ -5,20 +5,27 @@ function showHelp() {
   console.log("TUNE-CLI - Command Line Interface for Tune SDK");
   console.log("");
   console.log("USAGE:");
-  console.log("  npx tune-sdk [OPTIONS]");
+  console.log("  tune-sdk [cmd] [OPTIONS]");
   console.log("");
-  console.log("TLDR EXAMPLES:");
+  console.log("COMMANDS:");
+  console.log("  rpc                   Start RPC server mode");
+  console.log("  init                  Initialize Tune config directory");
+  console.log("");
+  console.log("EXAMPLES:");
   console.log("  # Quick chat with system prompt");
-  console.log("  npx tune-sdk --system \"You are Groot\" --user \"Hi how are you?\"");
+  console.log("  tune-sdk --system \"You are Groot\" --user \"Hi how are you?\"");
   console.log("");
   console.log("  # Continue existing chat");
-  console.log("  npx tune-sdk --user \"continue the conversation\" --filename chat.chat --save");
+  console.log("  tune-sdk --user \"continue the conversation\" --filename chat.chat --save");
   console.log("");
   console.log("  # Set context variables");
-  console.log("  npx tune-sdk --set-test=hello --user \"@test\" --system \"Echo assistant\"");
+  console.log("  tune-sdk --set-test=hello --user \"@test\" --system \"Echo assistant\"");
   console.log("");
   console.log("  # RPC mode for editor integration");
-  console.log("  npx tune-sdk --rpc");
+  console.log("  tune-sdk rpc");
+  console.log("");
+  console.log("  # Initialize or reinitialize config directory");
+  console.log("  tune-sdk init --force");
   console.log("");
   console.log("OPTIONS:");
   console.log("  --user <text>         User message to send");
@@ -29,26 +36,13 @@ function showHelp() {
   console.log("  --text <content>      chat content");
   console.log("  --response <type>     Response format: content|json|messages|chat (default: content)");
   console.log("  --set-<name>=<value>  Set context parameter");
-  console.log("  --rpc                 Start RPC server mode");
   console.log("  --path <paths>        Additional search paths (colon-separated)");
   console.log("  --home <dir>          Tune config directory (default: ~/.tune)");
   console.log("  --debug               Enable debug output");
   console.log("  --silent              Suppress output");
-  console.log("  --force-init          Force config initialization");
-  console.log("  --help            Show this help");
-  console.log("");
-  console.log("EXAMPLES:");
-  console.log("  # Start new chat");
-  console.log("  npx tune-sdk --system \"You are Groot\" --user \"Hi how are you?\"");
-  console.log("");
-  console.log("  # Append to existing chat and save");
-  console.log("  npx tune-sdk --user \"hi how are you?\" --filename newchat.chat --save");
-  console.log("");
-  console.log("  # Stop at specific word");
-  console.log("  npx tune-sdk --user \"continue\" --filename chat.chat --stop \"END\"");
-  console.log("");
-  console.log("  #Set context variable");
-  console.log("  npx tune-sdk --set-test=\"hello\" --user \"@test\" --system \"You are echo you print everythting back\"");
+  console.log("  --force               Force config initialization (with 'init')");
+  console.log("  --help                Show this help");
+  console.log("  --version             Show CLI version");
   return console.log("");
 }
 showHelp;
@@ -64,13 +58,18 @@ function validateArgs(args) {
   if (args.path) assert(typeof args.path === "string", "--path must be a string");
   if (args.home) assert(typeof args.home === "string", "--home must be a string");
   if (!!args.save) assert(typeof args.save === "boolean", "--save must be a boolean");
-  if (!!args.rpc) assert(typeof args.rpc === "boolean", "--rpc must be a boolean");
   if (!!args.debug) assert(typeof args.debug === "boolean" || typeof args.debug === "string", "--debug must be a boolean");
   if (!!args.silent) assert(typeof args.silent === "boolean", "--silent must be a boolean");
-  if (!!args.forceInit) assert(typeof args.forceInit === "boolean", "--force-init must be a boolean");
+  if (!!args.force) assert(typeof args.force === "boolean", "--force must be a boolean");
+  if (typeof args.rpc !== "undefined") assert(false, "Use 'tune-sdk rpc' instead of --rpc");
+  if (typeof args.forceInit !== "undefined") assert(false, "Use 'tune-sdk init --force' instead of --force-init");
   if (args.params) assert(!!args.params && (typeof args.params === "object"), "--set-* parameters must form a valid object");
   if ((args.stop && (typeof args.stop === "string"))) assert((args.stop === "assistant") || (args.stop === "step") || (args.stop.length > 0), "--stop must be 'assistant', 'step', or a non-empty custom string");
-  if ((!args.rpc && !args.help && !args.user && !args.filename)) assert(false, "Must specify --user, --filename, --rpc, or --help");
+  if (args.cmd) {
+    assert(typeof args.cmd === "string", "Command must be a string");
+    assert((args.cmd === "rpc") || (args.cmd === "init"), "Unknown command: " + args.cmd);
+  }
+  if ((!args.help && !args.version && !args.cmd && !args.user && !args.filename)) assert(false, "Must specify --user, --filename, a command (rpc|init), --version, or --help");
   return args;
 }
 validateArgs;
@@ -100,6 +99,12 @@ function parseArgs(args) {
     } else if (curKey) {
       memo[curKey] = arg;
       curKey = null;
+    } else {
+      if (!memo.__cmd) {
+        memo.__cmd = arg;
+      } else {
+        assert(false, "Only a single positional command is allowed");
+      }
     }
     return memo;
   }), {});
@@ -110,6 +115,10 @@ function parseArgs(args) {
   for (key in _ref) {
     value = _ref[key];
     assert(typeof key === "string", "Argument keys must be strings");
+    if (key === "__cmd") {
+      res1.cmd = value;
+      continue;
+    }
     if (key.startsWith("set-")) {
       res1.params = res1.params || {}
       assert(key.substr(4).length > 0, "Set parameter name cannot be empty");
@@ -119,6 +128,7 @@ function parseArgs(args) {
     }
   }
   if ((res1.h || res1.help)) res1.help = true;
+  if ((res1.v || res1.version)) res1.version = true;
   stop = res1.stop;
   if ((!!stop && (stop !== "step" && stop !== "assistant"))) {
     assert(typeof stop === "string", "Custom stop condition must be a string");
@@ -159,7 +169,7 @@ async function initConfig(args) {
   var homedir;
   homedir = getHomedir(args);
   assert(typeof homedir === "string", "Home directory must be a string");
-  if ((!args.forceInit && fs.existsSync(homedir))) return;
+  if ((!args.force && fs.existsSync(homedir))) return;
   console.error("[tune-sdk] initialize " + homedir);
   fs.mkdirSync(homedir, {
     recursive: true
@@ -292,6 +302,17 @@ async function run(args) {
   return (!args.silient ? console.log(res) : undefined);
 }
 run;
+
+function flatten(array) {
+  return array.reduce((memo, item) => {
+    if (Array.isArray(item)) {
+      return memo.concat(item)
+    }
+    memo.push(item)
+    return memo
+  }, [])
+}
+
 async function initContext(args) {
   var dirs, pwd, ctx, dir, ctxName, ext, module, m, _i, _ref, _len, _i0, _ref0, _len0;
   var dirs;
@@ -334,7 +355,7 @@ async function initContext(args) {
     if ((typeof module === "function")) {
       ctx.use(module);
     } else if (Array.isArray(module)) {
-      _ref0 = module;
+      _ref0 = module.flat(Infinity);
       for (_i0 = 0, _len0 = _ref0.length; _i0 < _len0; ++_i0) {
         m = _ref0[_i0];
         if ((typeof m === "function")) {
@@ -365,9 +386,26 @@ async function main() {
       showHelp();
       process.exit(0);
     }
+    if (args.version) {
+      try {
+        var pkg = require(path.resolve(__dirname, "../package.json"));
+        console.log(pkg.version || "0.0.0");
+      } catch (e) {
+        console.log("0.0.0");
+      }
+      process.exit(0);
+    }
     validateArgs(args);
-    await initConfig(args);
-    _ref = args.rpc ? await runRpc(args) : await run(args);
+    if (args.cmd === "rpc") {
+      await initConfig(args); // ensure config exists if needed
+      _ref = await runRpc(args);
+    } else if (args.cmd === "init") {
+      await initConfig(args);
+      _ref = null;
+    } else {
+      await initConfig(args); // auto-init if missing
+      _ref = await run(args);
+    }
   } catch (e) {
     console.error(e);
     _ref = process.exit(1);
@@ -398,4 +436,4 @@ tpl;
 exports.parseArgs = parseArgs;
 exports.rpc = rpc;
 exports.main = main;
-exports.run = run;
+exports.run = run;

package/dist/tune.js

@@ -1159,10 +1159,18 @@ Context.prototype.exec = (async function(name, args) {
   return _ref;
 });
 Context.prototype.write = (async function(name, args) {
-  var ws;
-  ws = ws || this.ws;
+  var ws, cur, res, _res, _ref;
+  ws = (this.ws || [])
+    .slice();
   if (!ws.length) return;
-  return ws[0](name, args, this, this.write.bind(this, name, args, ws.slice(1)));
+  cur = ws.shift();
+  _res = [];
+  while (cur) {
+    res = await cur.call(this, name, args, this);
+    if (res) break;
+    if (typeof(_ref = (cur = ws.shift())) !== 'undefined') _res.push(_ref);
+  }
+  return _res;
 });
 
 function envmd(md) {
@@ -1221,18 +1229,20 @@ function makeContext() {
   var ctx;
   ctx = new Context();
   if (!args[0]) return ctx;
-  args.forEach((function(md) {
-    var _ref;
-    if ((typeof md === "function")) {
-      _ref = ctx.use(md);
-    } else if (typeof md === "object") {
-      _ref = ctx.use(envmd(md));
-    } else {
-      _ref = undefined;
-      throw new TuneError("context middlewares might be either function or an object");
-    }
-    return _ref;
-  }));
+  args
+    .flat(Infinity)
+    .forEach((function(md) {
+      var _ref;
+      if ((typeof md === "function")) {
+        _ref = ctx.use(md);
+      } else if (typeof md === "object") {
+        _ref = ctx.use(envmd(md));
+      } else {
+        _ref = undefined;
+        throw new TuneError("context middlewares might be either function or an object");
+      }
+      return _ref;
+    }));
   return ctx;
 }
 makeContext;
@@ -1853,7 +1863,7 @@ async function payload2http(payload, ctx) {
     stack = TuneError.ctx2stack(ctx);
     var lastStack;
     lastStack = stack.pop();
-    throw new TuneError("llm file not found", (((typeof lastStack !== "undefined") && (lastStack !== null) && !Number.isNaN(lastStack) && (typeof lastStack.filename !== "undefined") && (lastStack.filename !== null) && !Number.isNaN(lastStack.filename)) ? lastStack.filename : undefined), (((typeof lastStack !== "undefined") && (lastStack !== null) && !Number.isNaN(lastStack) && (typeof lastStack.row !== "undefined") && (lastStack.row !== null) && !Number.isNaN(lastStack.row)) ? lastStack.row : undefined), (((typeof lastStack !== "undefined") && (lastStack !== null) && !Number.isNaN(lastStack) && (typeof lastStack.col !== "undefined") && (lastStack.col !== null) && !Number.isNaN(lastStack.col)) ? lastStack.col : undefined), stack);
+    throw new TuneError("llm file not found, check your env or ~/.tune/.env for provider api keys, like OPENAI_KEY, ANTHROPIC_KEY etc ", (((typeof lastStack !== "undefined") && (lastStack !== null) && !Number.isNaN(lastStack) && (typeof lastStack.filename !== "undefined") && (lastStack.filename !== null) && !Number.isNaN(lastStack.filename)) ? lastStack.filename : undefined), (((typeof lastStack !== "undefined") && (lastStack !== null) && !Number.isNaN(lastStack) && (typeof lastStack.row !== "undefined") && (lastStack.row !== null) && !Number.isNaN(lastStack.row)) ? lastStack.row : undefined), (((typeof lastStack !== "undefined") && (lastStack !== null) && !Number.isNaN(lastStack) && (typeof lastStack.col !== "undefined") && (lastStack.col !== null) && !Number.isNaN(lastStack.col)) ? lastStack.col : undefined), stack);
   }
   var body;
   body = Object.assign({}, payload);
@@ -2076,7 +2086,8 @@ function text2run(text, ctx, opts) {
                 tc = delta.tool_calls[0];
                 tcIdx = tc.index || 0;
                 msg.tool_calls[tcIdx] = msg.tool_calls[tcIdx] || tc;
-                msg.tool_calls[tcIdx].function.arguments += tc.function.arguments;
+                msg.tool_calls[tcIdx].function.arguments = msg.tool_calls[tcIdx].function.arguments || "";
+                msg.tool_calls[tcIdx].function.arguments += (tc.function.arguments || "");
               }
               return msg;
             }), {
@@ -2115,7 +2126,7 @@ function text2run(text, ctx, opts) {
 }
 text2run;
 async function file2run(args, params, ctx) {
-  var lctx, text, stop, node, response, res, r, chunk, itergeDPeG9, _ref;
+  var lctx, text, stop, node, response, res, r, chunk, itergzwE3tN, _ref;
   var lctx;
   lctx = ctx.clone();
   lctx.ms.unshift(envmd(params));
@@ -2181,7 +2192,7 @@ async function file2run(args, params, ctx) {
       stream: true
     });
     chunk = {};
-    itergeDPeG9 = new AsyncIter();
+    itergzwE3tN = new AsyncIter();
     (async function($lastRes) {
       var _ref;
       try {
@@ -2190,20 +2201,20 @@ async function file2run(args, params, ctx) {
           res = (chunk.value || "");
           if (chunk.done) await save();
           $lastRes = transformOutput(res) || $lastRes;
-          itergeDPeG9.result = {
+          itergzwE3tN.result = {
             value: $lastRes
           }
         }
-        _ref = itergeDPeG9.result = {
+        _ref = itergzwE3tN.result = {
           value: $lastRes,
           done: true
         }
       } catch (e) {
-        _ref = (itergeDPeG9.err = e);
+        _ref = (itergzwE3tN.err = e);
       }
       return _ref;
     })();
-    _ref = itergeDPeG9;
+    _ref = itergzwE3tN;
   }
   return _ref;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tune-sdk",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "tune - LLM chat in text file",
   "main": "dist/tune.js",
   "module": "dist/tune.mjs",
@@ -30,5 +30,8 @@
     "type": "git",
     "url": "https://github.com/iovdin/tune"
   },
-  "license": "MIT"
+  "license": "MIT",
+  "dependencies": {
+    "tune-sdk": "^0.2.3"
+  }
 }

package/config/package.prod.json

@@ -1,7 +0,0 @@
-{
-  "dependencies": {
-    "tune-sdk": "latest",
-    "tune-models": "latest",
-    "tune-toolset": "latest"
-  }
-}