@gzmagyari/kanbanboard 1.0.0

package/llm.mjs

@@ -0,0 +1,307 @@
+import { nanoid } from 'nanoid';
+import { request as httpRequest } from 'node:http';
+import { request as httpsRequest } from 'node:https';
+import { URL } from 'node:url';
+import { db } from './db.mjs';
+
+function nowMs() {
+  return Date.now();
+}
+
+function parseEnabled(val) {
+  if (val === undefined || val === null) return false;
+  const s = String(val).trim().toLowerCase();
+  return s === '1' || s === 'true' || s === 'yes' || s === 'on';
+}
+
+export function getLLMConfig() {
+  // This is an OpenAI-compatible chat completions client.
+  // Works with LiteLLM proxy, OpenRouter direct, etc.
+  const enabled = parseEnabled(process.env.LLM_ENABLED);
+  const base_url =
+    (process.env.LLM_BASE_URL || process.env.OPENAI_BASE_URL || process.env.OPENROUTER_BASE_URL || '').trim();
+  const api_key =
+    (process.env.LLM_API_KEY || process.env.OPENAI_API_KEY || process.env.OPENROUTER_API_KEY || '').trim();
+  const model = (process.env.LLM_MODEL || 'openrouter/google/gemini-3-pro-preview').trim();
+  const timeout_ms = Number(process.env.LLM_TIMEOUT_MS || 45_000);
+  const temperature = process.env.LLM_TEMPERATURE !== undefined ? Number(process.env.LLM_TEMPERATURE) : 0;
+
+  return {
+    enabled,
+    base_url,
+    api_key,
+    model,
+    timeout_ms: Number.isFinite(timeout_ms) ? timeout_ms : 45_000,
+    temperature: Number.isFinite(temperature) ? temperature : 0
+  };
+}
+
+export function isLLMEnabled() {
+  const cfg = getLLMConfig();
+  return !!(cfg.enabled && cfg.base_url && cfg.model);
+}
+
+function urlCandidates(baseUrl) {
+  const b = String(baseUrl || '').trim().replace(/\/+$/, '');
+  if (!b) return [];
+
+  // If the user already provided the full completions endpoint, use as-is
+  if (b.endsWith('/chat/completions')) {
+    return [b];
+  }
+
+  // Many OpenAI-compatible services expose:
+  // - <base>/chat/completions  (LiteLLM proxy when base_url has no /v1)
+  // - <base>/v1/chat/completions (some servers)
+  // If base_url ends with /v1, prefer /chat/completions.
+  if (b.endsWith('/v1')) {
+    return [`${b}/chat/completions`];
+  }
+
+  return [`${b}/chat/completions`, `${b}/v1/chat/completions`];
+}
+
+function postJson(url, body, headers = {}, timeoutMs = 45_000) {
+  const u = new URL(url);
+  const isHttps = u.protocol === 'https:';
+  const reqFn = isHttps ? httpsRequest : httpRequest;
+
+  const payload = JSON.stringify(body);
+  const finalHeaders = {
+    'content-type': 'application/json',
+    'content-length': Buffer.byteLength(payload),
+    ...headers
+  };
+
+  // Remove undefined headers (node will throw in some versions)
+  for (const k of Object.keys(finalHeaders)) {
+    if (finalHeaders[k] === undefined) delete finalHeaders[k];
+  }
+
+  return new Promise((resolve, reject) => {
+    const req = reqFn(
+      {
+        protocol: u.protocol,
+        hostname: u.hostname,
+        port: u.port || (isHttps ? 443 : 80),
+        path: `${u.pathname}${u.search}`,
+        method: 'POST',
+        headers: finalHeaders
+      },
+      (res) => {
+        let text = '';
+        res.setEncoding('utf8');
+        res.on('data', (chunk) => (text += chunk));
+        res.on('end', () => resolve({ status: res.statusCode || 0, text, headers: res.headers }));
+      }
+    );
+
+    req.setTimeout(timeoutMs, () => {
+      req.destroy(new Error(`LLM request timeout after ${timeoutMs}ms`));
+    });
+
+    req.on('error', reject);
+    req.write(payload);
+    req.end();
+  });
+}
+
+function safeJsonParse(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * OpenAI-compatible chat completion runner, with DB logging (llm_runs).
+ *
+ * @param {object} args
+ * @param {string} args.op
+ * @param {string|null} args.projectId
+ * @param {string|null} args.entityType
+ * @param {string|null} args.entityId
+ * @param {Array} args.messages
+ * @param {string=} args.model
+ * @param {number=} args.temperature
+ * @returns {Promise<{run_id: string, url: string, data: any, content: string}>}
+ */
+export async function llmChat(args) {
+  const cfg = getLLMConfig();
+  if (!isLLMEnabled()) {
+    const err = new Error('LLM is not enabled/configured (set LLM_ENABLED=1 and LLM_BASE_URL)');
+    err.statusCode = 400;
+    throw err;
+  }
+
+  const model = (args.model || cfg.model).trim();
+  const temperature = args.temperature !== undefined ? args.temperature : cfg.temperature;
+
+  const requestBody = {
+    model,
+    messages: args.messages || [],
+    temperature: Number.isFinite(temperature) ? temperature : 0,
+    response_format: args.response_format || { type: 'json_object' }
+  };
+
+  const run_id = nanoid(12);
+  const created_at = nowMs();
+  const logBody = parseEnabled(process.env.LLM_LOG_BODY ?? '1');
+
+  const reqLog = logBody ? JSON.stringify(requestBody) : JSON.stringify({ model, message_count: (requestBody.messages || []).length, note: 'body omitted (LLM_LOG_BODY=0)' });
+
+  db.prepare(`
+    INSERT INTO llm_runs (id, op, project_id, entity_type, entity_id, model, request_json, response_json, error, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, NULL, NULL, ?)
+  `).run(
+    run_id,
+    String(args.op || 'unknown'),
+    args.projectId ?? null,
+    args.entityType ?? null,
+    args.entityId ?? null,
+    model,
+    reqLog,
+    created_at
+  );
+
+  const authHeader = cfg.api_key ? { Authorization: `Bearer ${cfg.api_key}` } : {};
+  const candidates = urlCandidates(cfg.base_url);
+  let lastErr = null;
+
+  for (const url of candidates) {
+    try {
+      const { status, text } = await postJson(url, requestBody, authHeader, cfg.timeout_ms);
+
+      // Retry alternative path if endpoint is missing
+      if (status === 404 || status === 405) {
+        lastErr = new Error(`LLM endpoint not found (${status}) at ${url}`);
+        continue;
+      }
+
+      if (status < 200 || status >= 300) {
+        lastErr = new Error(`LLM HTTP ${status}: ${String(text || '').slice(0, 600)}`);
+        const errLog = logBody ? JSON.stringify({ url, status, text }) : JSON.stringify({ url, status, note: 'body omitted' });
+        db.prepare(`UPDATE llm_runs SET response_json = ?, error = ? WHERE id = ?`)
+          .run(errLog, lastErr.message, run_id);
+        throw lastErr;
+      }
+
+      const parsed = safeJsonParse(text) ?? { raw_text: text };
+      const content = parsed?.choices?.[0]?.message?.content ?? '';
+
+      const resLog = logBody ? JSON.stringify({ url, status, response: parsed }) : JSON.stringify({ url, status, content_length: content.length, note: 'body omitted' });
+      db.prepare(`UPDATE llm_runs SET response_json = ?, error = NULL WHERE id = ?`)
+        .run(resLog, run_id);
+
+      return { run_id, url, data: parsed, content };
+    } catch (e) {
+      lastErr = e;
+      // Try next candidate URL if available
+    }
+  }
+
+  const msg = String(lastErr?.message || lastErr || 'LLM request failed');
+  db.prepare(`UPDATE llm_runs SET error = ? WHERE id = ?`).run(msg, run_id);
+  throw lastErr || new Error(msg);
+}
+
+/**
+ * OpenAI-compatible chat completion with tool/function-calling support.
+ * Unlike llmChat(), this does NOT force response_format: json_object,
+ * and it accepts optional `tools` and `tool_choice` parameters.
+ *
+ * @param {object} args
+ * @param {string} args.op
+ * @param {string|null} args.projectId
+ * @param {string|null} args.entityType
+ * @param {string|null} args.entityId
+ * @param {Array} args.messages
+ * @param {Array=} args.tools - OpenAI tool definitions
+ * @param {string=} args.tool_choice - 'auto' | 'none' | specific
+ * @param {string=} args.model
+ * @param {number=} args.temperature
+ * @returns {Promise<{run_id: string, url: string, data: any, content: string, tool_calls: Array}>}
+ */
+export async function llmChatWithTools(args) {
+  const cfg = getLLMConfig();
+  if (!isLLMEnabled()) {
+    const err = new Error('LLM is not enabled/configured (set LLM_ENABLED=1 and LLM_BASE_URL)');
+    err.statusCode = 400;
+    throw err;
+  }
+
+  const model = (args.model || cfg.model).trim();
+  const temperature = args.temperature !== undefined ? args.temperature : cfg.temperature;
+
+  const requestBody = {
+    model,
+    messages: args.messages || [],
+    temperature: Number.isFinite(temperature) ? temperature : 0
+  };
+
+  if (args.tools && args.tools.length > 0) {
+    requestBody.tools = args.tools;
+    requestBody.tool_choice = args.tool_choice || 'auto';
+  }
+
+  const run_id = nanoid(12);
+  const created_at = nowMs();
+  const logBody = parseEnabled(process.env.LLM_LOG_BODY ?? '1');
+
+  const reqLog = logBody ? JSON.stringify(requestBody) : JSON.stringify({ model, message_count: (requestBody.messages || []).length, note: 'body omitted (LLM_LOG_BODY=0)' });
+
+  db.prepare(`
+    INSERT INTO llm_runs (id, op, project_id, entity_type, entity_id, model, request_json, response_json, error, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, NULL, NULL, ?)
+  `).run(
+    run_id,
+    String(args.op || 'unknown'),
+    args.projectId ?? null,
+    args.entityType ?? null,
+    args.entityId ?? null,
+    model,
+    reqLog,
+    created_at
+  );
+
+  const authHeader = cfg.api_key ? { Authorization: `Bearer ${cfg.api_key}` } : {};
+  const candidates = urlCandidates(cfg.base_url);
+  let lastErr = null;
+
+  for (const url of candidates) {
+    try {
+      const { status, text } = await postJson(url, requestBody, authHeader, cfg.timeout_ms);
+
+      if (status === 404 || status === 405) {
+        lastErr = new Error(`LLM endpoint not found (${status}) at ${url}`);
+        continue;
+      }
+
+      if (status < 200 || status >= 300) {
+        lastErr = new Error(`LLM HTTP ${status}: ${String(text || '').slice(0, 600)}`);
+        const errLog = logBody ? JSON.stringify({ url, status, text }) : JSON.stringify({ url, status, note: 'body omitted' });
+        db.prepare(`UPDATE llm_runs SET response_json = ?, error = ? WHERE id = ?`)
+          .run(errLog, lastErr.message, run_id);
+        throw lastErr;
+      }
+
+      const parsed = safeJsonParse(text) ?? { raw_text: text };
+      const message = parsed?.choices?.[0]?.message ?? {};
+      const content = message.content ?? '';
+      const tool_calls = message.tool_calls ?? [];
+
+      const resLog = logBody ? JSON.stringify({ url, status, response: parsed }) : JSON.stringify({ url, status, content_length: content.length, tool_calls_count: tool_calls.length, note: 'body omitted' });
+      db.prepare(`UPDATE llm_runs SET response_json = ?, error = NULL WHERE id = ?`)
+        .run(resLog, run_id);
+
+      return { run_id, url, data: parsed, content, tool_calls };
+    } catch (e) {
+      lastErr = e;
+    }
+  }
+
+  const msg = String(lastErr?.message || lastErr || 'LLM request failed');
+  db.prepare(`UPDATE llm_runs SET error = ? WHERE id = ?`).run(msg, run_id);
+  throw lastErr || new Error(msg);
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@gzmagyari/kanbanboard",
+  "version": "1.0.0",
+  "description": "AI-powered Kanban dashboard with LLM integration, Claude Code agents, and MCP server support",
+  "type": "module",
+  "bin": {
+    "kanbanboard": "./bin/cli.mjs"
+  },
+  "scripts": {
+    "start": "node server.mjs",
+    "dev": "node server.mjs"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "public/",
+    "docs/",
+    "server.mjs",
+    "db.mjs",
+    "llm.mjs",
+    "repo-grounding.mjs",
+    "kanban-mcp-server.mjs",
+    "kanban.mjs",
+    "cron-sync.mjs",
+    ".env.example",
+    "API.md",
+    "README.md"
+  ],
+  "keywords": [
+    "kanban",
+    "dashboard",
+    "project-management",
+    "ai",
+    "llm",
+    "claude",
+    "mcp",
+    "sqlite",
+    "express",
+    "vuetify"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.7.2",
+    "dotenv": "^17.2.4",
+    "express": "^4.19.2",
+    "morgan": "^1.10.0",
+    "nanoid": "^5.0.7"
+  }
+}