abtars 0.1.0-alpha.1

package/core/skills/tools/model-scout/scout-openrouter.py

@@ -0,0 +1,85 @@
+#!/usr/bin/env python3
+"""List free models from OpenRouter, compare against models.json catalog.
+Usage:
+  scout-openrouter.py          # list only
+  scout-openrouter.py --test   # list + liveness test + write status to models.json
+"""
+import json, os, sys, urllib.request
+
+config_dir = os.path.expanduser("~/.abtars/config")
+tc_path = os.path.join(config_dir, "transport.json")
+models_path = os.path.join(config_dir, "models.json")
+do_test = "--test" in sys.argv
+
+# Get API key from transport.json
+try:
+    tc = json.load(open(tc_path))
+    env_var = tc["providers"].get("openrouter", {}).get("apiKeyEnv", "OPENROUTER_API_KEY")
+    key = os.environ.get(env_var, "")
+except Exception:
+    key = os.environ.get("OPENROUTER_API_KEY", "")
+
+if not key:
+    print("❌ No OpenRouter API key found"); sys.exit(1)
+
+# Fetch models
+req = urllib.request.Request("https://openrouter.ai/api/v1/models", headers={"Authorization": f"Bearer {key}"})
+data = json.loads(urllib.request.urlopen(req, timeout=10).read())
+free = [m for m in data["data"] if ":free" in m["id"]]
+free.sort(key=lambda m: m.get("context_length") or 0, reverse=True)
+
+# Load current catalog
+try:
+    catalog = json.load(open(models_path))
+except Exception:
+    catalog = {}
+cataloged = {k for k in catalog if "openrouter" in catalog[k].get("transports", [])}
+
+print(f"{'Model':<45} {'Ctx':>8} {'MaxOut':>8} {'Status'}")
+print("-" * 80)
+
+from datetime import date
+today = date.today().isoformat()
+
+for m in free[:30]:
+    mid = m["id"]
+    ctx = m.get("context_length") or 0
+    out = m.get("top_provider", {}).get("max_completion_tokens") or 0
+    short = mid.split("/")[-1].replace(":free", ":cloud") if "/" in mid else mid
+    status = "✓ cataloged" if short in cataloged or mid in cataloged else "NEW"
+
+    # Liveness test
+    if do_test and status == "NEW":
+        try:
+            test_req = urllib.request.Request(
+                "https://openrouter.ai/api/v1/chat/completions",
+                headers={"Authorization": f"Bearer {key}", "Content-Type": "application/json"},
+                data=json.dumps({"model": mid, "messages": [{"role": "user", "content": "Say OK"}], "max_tokens": 5}).encode()
+            )
+            resp = json.loads(urllib.request.urlopen(test_req, timeout=15).read())
+            content = resp.get("choices", [{}])[0].get("message", {}).get("content", "")
+            alive = bool(content.strip())
+        except Exception:
+            alive = False
+        status = f"{'✓ alive' if alive else '✗ dead'}"
+
+        # Write to models.json
+        if mid not in catalog:
+            catalog[mid] = {
+                "contextWindow": ctx, "maxOutput": out, "rank": 2 if ctx >= 200000 else 3,
+                "cost": {"input": 0.0, "output": 0.0},
+                "transports": ["openrouter"],
+                "description": f"Scouted {today}",
+                "validatedAt": today, "status": "alive" if alive else "dead"
+            }
+        else:
+            catalog[mid]["validatedAt"] = today
+            catalog[mid]["status"] = "alive" if alive else "dead"
+
+    print(f"{mid:<45} {ctx:>8} {out:>8} {status}")
+
+if do_test:
+    with open(models_path, "w") as f:
+        json.dump(catalog, f, indent=2)
+        f.write("\n")
+    print(f"\n✓ models.json updated ({len(catalog)} entries)")

package/core/skills/tools/nlm/SKILL.md

@@ -0,0 +1,40 @@
+---
+name: nlm
+description: Query the NotebookLM knowledge base (Layer 6) for answers grounded in curated reference material
+user-invocable: false
+---
+
+# Knowledge Base Query (NotebookLM)
+
+Query curated reference documents — research papers, technical docs, guides.
+
+```bash
+nlm notebook query <NOTEBOOK_ID> "your question here" --json
+```
+
+Other commands:
+```bash
+nlm notebook list --json                    # list notebooks
+nlm notebook create <name> --json           # create notebook
+nlm source list <NOTEBOOK_ID> --json        # list sources
+```
+
+## Troubleshooting
+
+If `nlm` returns `400 Bad Request` or auth errors, the session has expired. Fix:
+```bash
+nlm login
+```
+This opens a browser for Google re-authentication. Happens periodically when Google rotates session tokens.
+
+Returns JSON: `answer`, `sources_used`.
+
+## When to use
+- Questions about uploaded reference material (docs, research, guides)
+- Technical documentation lookups local memory wouldn't have
+- Local memory search returned nothing and question is about curated knowledge
+
+## When NOT to use
+- Answer already in conversation context
+- Personal memories / past conversations (use memory-search)
+- Real-time / live information (knowledge base is static)

package/core/skills/tools/todo/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: todo
+description: Manage a persistent todo list
+user-invocable: false
+---
+
+# Todo Skill
+
+Manage a persistent todo list via shell commands.
+
+## Commands
+
+- `abtars-todo add "description"` — add new item
+- `abtars-todo list` — show all items
+- `abtars-todo done <N>` — mark item N as complete
+- `abtars-todo remove <N>` — delete item N
+
+Item numbers are 1-based, in the order they appear in the file.
+
+## When to use
+
+- User says "remind me", "don't forget", "add to my list", "todo", "emlékeztess", "ne felejtsd"
+- User asks "what's on my list", "what do I need to do", "mi van a listámon"
+- After completing a task the user previously asked to track
+
+## When NOT to use
+
+- For time-specific reminders with a specific date/time (use abtars-cron instead)
+- For facts/preferences (use abmind store instead)
+- For routine conversational messages

package/core/skills/tools/twitterX/SKILL.md

@@ -0,0 +1,52 @@
+---
+name: twitterX
+description: Fetch Twitter/X feeds, timelines, replies, and search. Use when user asks about tweets, X feed, social media monitoring, or follow discovery.
+requires:
+  files: [~/.abtars/workspace/twitterX]
+---
+
+# Twitter/X Feed Tool
+
+Fetch and analyze Twitter/X content via rettiwt-api + FxTwitter.
+
+## Commands
+
+```bash
+# Feed (all follows, ranked)
+node {baseDir}/scripts/abtars-tweet.js --feed
+
+# Feed as markdown
+node {baseDir}/scripts/abtars-tweet.js --feed --format md
+
+# Feed + discover new follows
+node {baseDir}/scripts/abtars-tweet.js --feed --discover
+
+# Single tweet
+node {baseDir}/scripts/abtars-tweet.js --fetch <tweet-url>
+
+# User timeline
+node {baseDir}/scripts/abtars-tweet.js --timeline <handle> --count 10
+
+# Replies on a tweet
+node {baseDir}/scripts/abtars-tweet.js --replies <tweet-id>
+
+# Search
+node {baseDir}/scripts/abtars-tweet.js --search "query"
+
+# User profile
+node {baseDir}/scripts/abtars-tweet.js --user <handle>
+```
+
+## Config
+
+- Follows files: `~/.abtars/workspace/twitterX/base.follows.json` and env `TWEET_FOLLOWS_FILE` (default: `agent.follows.json`)
+- Cookies: `~/.abtars/secret/cookies/x-cookies.json` (required for authenticated endpoints)
+- Output: `~/.abtars/workspace/twitterX/output/ (daily JSON reports)
+
+## Cron usage
+
+Scheduled via `/task add`:
+```
+executor: script
+command: node ~/.abtars/skills/tools/twitterX/scripts/abtars-tweet.js --feed
+```