askai-free 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# Ask AI
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Use AskAI.free models without leaving the terminal.
+
+```sh
+npm install --global askai-free
+askai config set-key
+askai "Explain the difference between a process and a thread"
+git diff | askai "Review this diff"
+askai models
+askai usage
+```
+
+Create an API key in your <https://askai.free/account>. For CI, set `ASKAI_API_KEY`.

package/bin/askai.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const pkg = require('../package.json');
+
+const defaultBase = 'https://askai.free';
+const defaultModel = 'chatgpt-5-6-sol';
+
+function configFile() {
+  const root = process.env.XDG_CONFIG_HOME || (process.platform === 'win32' && process.env.APPDATA) || path.join(os.homedir(), '.config');
+  return path.join(root, 'ask-ai', 'config.json');
+}
+
+function loadConfig() {
+  try { return JSON.parse(fs.readFileSync(configFile(), 'utf8')); }
+  catch (error) { if (error.code === 'ENOENT') return {}; throw error; }
+}
+
+function saveConfig(config) {
+  fs.mkdirSync(path.dirname(configFile()), { recursive: true, mode: 0o700 });
+  fs.writeFileSync(configFile(), `${JSON.stringify(config, null, 2)}\n`, { mode: 0o600 });
+  try { fs.chmodSync(configFile(), 0o600); } catch {}
+}
+
+function secret(label) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY || !process.stdin.setRawMode) throw new Error('Interactive key entry requires a terminal; use ASKAI_API_KEY in scripts.');
+  return new Promise((resolve, reject) => {
+    let value = '';
+    process.stdout.write(label);
+    process.stdin.setRawMode(true); process.stdin.resume(); process.stdin.setEncoding('utf8');
+    const done = (error) => {
+      process.stdin.setRawMode(false); process.stdin.pause(); process.stdin.off('data', input); process.stdout.write('\n');
+      error ? reject(error) : resolve(value.trim());
+    };
+    const input = (key) => {
+      if (key === '\u0003') return done(new Error('Cancelled.'));
+      if (key === '\r' || key === '\n') return done();
+      if (key === '\u007f' || key === '\b') value = value.slice(0, -1);
+      else if (key >= ' ') value += key;
+    };
+    process.stdin.on('data', input);
+  });
+}
+
+function auth() {
+  const config = loadConfig();
+  return {
+    key: process.env.ASKAI_API_KEY || config.apiKey,
+    model: process.env.ASKAI_MODEL || config.model || defaultModel,
+    base: (process.env.ASKAI_BASE_URL || config.baseUrl || defaultBase).replace(/\/$/, ''),
+  };
+}
+
+async function api(endpoint, options = {}) {
+  const current = auth();
+  if (!current.key) throw new Error('No API key found. Run `askai config set-key` or set ASKAI_API_KEY.');
+  const response = await fetch(`${current.base}/v1/${endpoint}`, {
+    method: options.method || 'GET',
+    headers: { Authorization: `Bearer ${current.key}`, 'Content-Type': 'application/json', 'User-Agent': `ask-ai/${pkg.version}` },
+    body: options.body ? JSON.stringify(options.body) : undefined,
+    signal: AbortSignal.timeout(120_000),
+  });
+  const data = await response.json().catch(() => ({}));
+  if (!response.ok) throw new Error(data.error?.message || `Ask AI returned HTTP ${response.status}.`);
+  return data;
+}
+
+async function stdin() {
+  if (process.stdin.isTTY) return '';
+  const chunks = [];
+  for await (const chunk of process.stdin) chunks.push(chunk);
+  return Buffer.concat(chunks).toString('utf8').trim();
+}
+
+function help() {
+  return `Ask AI ${pkg.version}
+
+Usage:
+  askai "Explain this error"
+  command | askai "Review this output"
+  askai models [--json]
+  askai usage [--json]
+  askai config set-key|clear-key|show
+
+Options:
+  -m, --model MODEL
+  -s, --system MESSAGE
+  --max-tokens N
+  --json`;
+}
+
+function parse(args) {
+  const options = { json: false, maxTokens: 1000, words: [] };
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === '--json') options.json = true;
+    else if (arg === '--model' || arg === '-m') options.model = args[++i];
+    else if (arg === '--system' || arg === '-s') options.system = args[++i];
+    else if (arg === '--max-tokens') options.maxTokens = Number(args[++i]);
+    else options.words.push(arg);
+  }
+  if (!Number.isInteger(options.maxTokens) || options.maxTokens < 1 || options.maxTokens > 8000) throw new Error('--max-tokens must be an integer from 1 to 8000.');
+  return options;
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  if (!args.length || args.includes('--help') || args.includes('-h')) return process.stdout.write(`${help()}\n`);
+  if (args.includes('--version') || args.includes('-v')) return process.stdout.write(`${pkg.version}\n`);
+  const command = ['models', 'usage', 'config', 'ask'].includes(args[0]) ? args.shift() : 'ask';
+  const options = parse(args);
+  if (command === 'config') {
+    const action = options.words[0] || 'show';
+    const config = loadConfig();
+    if (action === 'set-key') {
+      const key = await secret('Ask AI API key: ');
+      if (!key.startsWith('sk_askai_')) throw new Error('That does not look like an Ask AI API key.');
+      config.apiKey = key; saveConfig(config); process.stdout.write(`API key saved in ${configFile()}\n`);
+    } else if (action === 'clear-key') {
+      delete config.apiKey; saveConfig(config); process.stdout.write('API key removed.\n');
+    } else {
+      const current = auth();
+      process.stdout.write(`Config: ${configFile()}\nAPI key: ${current.key ? `${current.key.slice(0, 9)}…${current.key.slice(-4)}` : 'not set'}\nModel: ${current.model}\n`);
+    }
+    return;
+  }
+  if (command === 'models' || command === 'usage') {
+    const data = await api(command);
+    if (options.json) return process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+    if (command === 'models') return process.stdout.write(`${(data.data || []).map((item) => `${item.id}\t${item.name || ''}`).join('\n')}\n`);
+    return process.stdout.write(`Plan: ${data.plan || '-'}\nTokens remaining: ${data.token_credits_remaining ?? '-'}\n`);
+  }
+  const prompt = [options.words.join(' ').trim(), await stdin()].filter(Boolean).join('\n\n');
+  if (!prompt) throw new Error('Add a prompt or pipe text into askai.');
+  const current = auth();
+  const messages = [...(options.system ? [{ role: 'system', content: options.system }] : []), { role: 'user', content: prompt }];
+  const data = await api('chat/completions', { method: 'POST', body: { model: options.model || current.model, messages, max_tokens: options.maxTokens, stream: false } });
+  if (options.json) process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+  else process.stdout.write(`${data.choices?.[0]?.message?.content || ''}\n`);
+}
+
+if (require.main === module) main().catch((error) => { process.stderr.write(`askai: ${error.message}\n`); process.exitCode = 1; });
+
+module.exports = { parse };

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "askai-free",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Use ChatGPT, Claude, and DeepSeek through Ask AI from your terminal.",
+  "bin": { "askai": "bin/askai.js", "ask-ai": "bin/askai.js" },
+  "files": ["bin", "README.md"],
+  "scripts": { "test": "node --check bin/askai.js && node bin/askai.js --version", "prepublishOnly": "npm test" },
+  "engines": { "node": ">=20" },
+  "keywords": ["ai", "chatgpt", "claude", "deepseek", "terminal", "cli", "ask-ai"],
+  "homepage": "https://askai.free/cli",
+  "license": "UNLICENSED",
+  "author": "AskAI.free",
+  "publishConfig": { "access": "public" }
+}