tiger-agent 0.2.3 → 0.2.5

package/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="./IMG_5745.jpg" alt="Tiger bot" width="900" />
+</p>
+
 # 🐯 Tiger Agent
 
 [![npm version](https://img.shields.io/npm/v/tiger-agent.svg)](https://www.npmjs.com/package/tiger-agent)
@@ -10,13 +14,20 @@ Made by **AI Research Group, Department of Civil Engineering, KMUTT**
 
 ---
 
-## 🆕 What's New — v0.2.0
+## 🆕 What's New — v0.2.4
+
+- **ClawHub skill install fixed** — `clawhub_install` and `clawhub_search` now work correctly when installed via `npm install -g`
+- **No required API keys** — `tiger onboard` skips providers with no key; any single provider is enough to start
+- **`/limit` Telegram command** — set per-provider daily token limits from chat without restarting
+- **Soul & ownskill refresh fixed** — 24-hour regeneration timer now uses DB timestamps, not file mtime, so reflection appends no longer block the update cycle
+
+### v0.2.0
 
 - **npm global install** — `npm install -g tiger-agent`, no git clone needed
 - **Multi-provider LLM** — 5 providers (Kimi, Z.ai, MiniMax, Claude, Moonshot) with auto-fallback
 - **Daily token limits** — per-provider limits with automatic switching at UTC midnight
 - **`tiger` CLI** — unified command: `tiger onboard`, `tiger start`, `tiger telegram`, `tiger stop`
-- **Telegram `/api` & `/tokens`** — switch providers and monitor usage from chat
+- **Telegram `/api`, `/tokens`, `/limit`** — manage providers and usage from chat
 - **Encrypted secrets** — optional at-rest encryption for API keys
 
 ---
@@ -259,6 +270,27 @@ Without it, Tiger falls back to cosine similarity in Python — slower but fully
 | **Skills** | `list_skills`, `load_skill`, `clawhub_search`, `clawhub_install` |
 | **Orchestration** | `run_sub_agents` |
 
+### ClawHub Skills
+
+Tiger can search and install skills from [ClawHub](https://clawhub.dev) — a community registry of reusable agent skills. The `clawhub` CLI is bundled with Tiger, no separate install needed.
+
+Enable skill install in `~/.tiger/.env`:
+
+```env
+ALLOW_SKILL_INSTALL=true
+```
+
+Then just ask Tiger in chat:
+
+```
+Search for a web search skill on clawhub
+Install the web-search skill
+```
+
+Skills are installed to `~/.tiger/skills/` and loaded automatically on demand.
+
+> **Note:** `ALLOW_SKILL_INSTALL=true` must be set during `tiger onboard` or added manually to `~/.tiger/.env`.
+
 ---
 
 ## 🔒 Security

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tiger-agent",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "Cognitive AI agent with persistent memory, multi-provider LLM, and Telegram bot",
   "type": "commonjs",
   "main": "src/cli.js",

package/src/agent/contextFileMirrors.js

@@ -0,0 +1,39 @@
+const fs = require('fs');
+const path = require('path');
+
+function getLegacyRootMirrorPath(filePath) {
+  const canonical = path.resolve(filePath);
+  const candidate = path.resolve(process.cwd(), path.basename(canonical));
+
+  if (candidate === canonical) return null;
+  if (!fs.existsSync(candidate)) return null;
+
+  return candidate;
+}
+
+function syncLegacyRootMirror(filePath) {
+  const canonical = path.resolve(filePath);
+  const legacy = getLegacyRootMirrorPath(canonical);
+  if (!legacy) return;
+
+  const content = fs.readFileSync(canonical, 'utf8');
+  fs.writeFileSync(legacy, content, 'utf8');
+}
+
+function writeContextFile(filePath, content) {
+  const canonical = path.resolve(filePath);
+  fs.writeFileSync(canonical, content, 'utf8');
+  syncLegacyRootMirror(canonical);
+}
+
+function appendContextFile(filePath, content) {
+  const canonical = path.resolve(filePath);
+  fs.appendFileSync(canonical, content, 'utf8');
+  syncLegacyRootMirror(canonical);
+}
+
+module.exports = {
+  writeContextFile,
+  appendContextFile,
+  syncLegacyRootMirror
+};

package/src/agent/contextFiles.js

@@ -2,6 +2,7 @@ const fs = require('fs');
 const path = require('path');
 const { dataDir } = require('../config');
 const { ensureDir } = require('../utils');
+const { writeContextFile, syncLegacyRootMirror } = require('./contextFileMirrors');
 
 const files = ['soul.md', 'human.md', 'human2.md', 'ownskill.md'];
 
@@ -10,8 +11,10 @@ function ensureContextFiles() {
   for (const name of files) {
     const full = path.join(dataDir, name);
     if (!fs.existsSync(full)) {
-      fs.writeFileSync(full, `# ${name.replace('.md', '')}\n\n`, 'utf8');
+      writeContextFile(full, `# ${name.replace('.md', '')}\n\n`);
+      continue;
     }
+    syncLegacyRootMirror(full);
   }
 }
 

package/src/agent/mainAgent.js

@@ -12,6 +12,7 @@ const {
   memoryIngestMinChars
 } = require('../config');
 const { loadContextFiles } = require('./contextFiles');
+const { writeContextFile, appendContextFile } = require('./contextFileMirrors');
 const { tools, callTool } = require('./toolbox');
 const {
   ensureConversation,
@@ -98,7 +99,7 @@ async function maybeUpdateHumanFile(userText, assistantText) {
   if (!append) return;
 
   const block = `\n## Update ${new Date().toISOString()}\n${append}\n`;
-  fs.appendFileSync(path.resolve(human2.full), block, 'utf8');
+  appendContextFile(path.resolve(human2.full), block);
 }
 
 function buildSystemPrompt(contextText, memoriesText) {
@@ -173,7 +174,7 @@ async function maybeUpdateOwnSkillSummary(conversationIdValue) {
 
   const next = String(message.content || '').trim();
   if (!next) return;
-  fs.writeFileSync(path.resolve(ownSkillPath), `${next}\n`, 'utf8');
+  writeContextFile(path.resolve(ownSkillPath), `${next}\n`);
   setMeta(OWNSKILL_META_KEY, Date.now());
 }
 
@@ -209,7 +210,7 @@ async function maybeUpdateSoulSummary(conversationIdValue) {
 
   const next = String(message.content || '').trim();
   if (!next) return;
-  fs.writeFileSync(path.resolve(soulPath), `${next}\n`, 'utf8');
+  writeContextFile(path.resolve(soulPath), `${next}\n`);
   setMeta(SOUL_META_KEY, Date.now());
 }
 

package/src/agent/reflectionAgent.js

@@ -1,8 +1,9 @@
 const fs = require('fs');
 const path = require('path');
 const { chatCompletion, embedText } = require('../llmClient');
-const { dataDir, embeddingsEnabled } = require('../config');
+const { dataDir, embeddingsEnabled, reflectionUpdateHours } = require('../config');
 const { addMemory, getMeta, setMeta, getMessagesSince, getRecentMessagesAll } = require('./db');
+const { writeContextFile } = require('./contextFileMirrors');
 
 const REFLECTION_META_KEY = 'memory_reflection_last_run_ts';
 const MAX_MESSAGE_SCAN = 600;
@@ -67,7 +68,7 @@ function appendTimestampedBullets(filePath, heading, bullets, stamp) {
   const withHeading = ensureHeading(existing, heading);
   const lines = bullets.map((line) => `- [${stamp}] ${line}`).join('\n');
   const next = `${withHeading.trimEnd()}\n${lines}\n`;
-  fs.writeFileSync(full, next, 'utf8');
+  writeContextFile(full, next);
 }
 
 function appendHuman2Update(filePath, payload, stampIso) {
@@ -80,7 +81,7 @@ function appendHuman2Update(filePath, payload, stampIso) {
   for (const w of payload.successfulWorkflows) lines.push(`- Workflow: ${w}`);
   if (!lines.length) return;
   const block = `\n## Update ${stampIso}\n${lines.join('\n')}\n`;
-  fs.writeFileSync(full, `${existing.trimEnd()}\n${block}`, 'utf8');
+  writeContextFile(full, `${existing.trimEnd()}${block}`);
 }
 
 async function generateReflection(rows, sinceIso, untilIso) {
@@ -123,9 +124,20 @@ async function generateReflection(rows, sinceIso, untilIso) {
   };
 }
 
+function shouldRunReflectionCycle(lastRunTs) {
+  if (!lastRunTs) return true;
+  const hoursPassed = (nowTs() - lastRunTs) / (60 * 60 * 1000);
+  return hoursPassed >= reflectionUpdateHours;
+}
+
 async function maybeRunReflectionCycle({ force = false } = {}) {
   const startedAt = nowTs();
   const lastRunTs = Number(getMeta(REFLECTION_META_KEY, 0) || 0);
+
+  if (!force && !shouldRunReflectionCycle(lastRunTs)) {
+    return { ok: true, skipped: true, reason: 'not_yet_due' };
+  }
+
   const rows = lastRunTs
     ? getMessagesSince(lastRunTs, MAX_MESSAGE_SCAN)
     : getRecentMessagesAll(Math.min(MAX_MESSAGE_SCAN, 240));
@@ -185,6 +197,7 @@ async function maybeRunReflectionCycle({ force = false } = {}) {
   }
 
   setMeta(REFLECTION_META_KEY, startedAt);
+  console.log(`[ReflectionCycle] Completed at ${stampIso} (${rows.length} messages processed)`);
   return { ok: true, skipped: false, at: stampIso };
 }
 

package/src/agent/reflectionScheduler.js

@@ -8,14 +8,30 @@ function startReflectionScheduler() {
 
   const everyMs = Math.max(1, Number(reflectionUpdateHours || 12)) * 60 * 60 * 1000;
 
+  console.log(`[ReflectionScheduler] Starting with interval: ${reflectionUpdateHours || 12} hours (${everyMs}ms)`);
+
   // Kick one asynchronous check on startup.
-  maybeRunReflectionCycle().catch(() => {});
+  maybeRunReflectionCycle().catch((err) => {
+    console.error('[ReflectionScheduler] Startup check failed:', err.message);
+  });
 
   intervalHandle = setInterval(() => {
-    maybeRunReflectionCycle().catch(() => {});
+    console.log('[ReflectionScheduler] Running scheduled reflection cycle...');
+    maybeRunReflectionCycle().catch((err) => {
+      console.error('[ReflectionScheduler] Scheduled cycle failed:', err.message);
+    });
   }, everyMs);
 }
 
+function stopReflectionScheduler() {
+  if (intervalHandle) {
+    clearInterval(intervalHandle);
+    intervalHandle = null;
+    console.log('[ReflectionScheduler] Stopped');
+  }
+}
+
 module.exports = {
-  startReflectionScheduler
+  startReflectionScheduler,
+  stopReflectionScheduler
 };