@inetafrica/open-claudia 2.0.3 → 2.0.4

package/core/system-prompt.js

@@ -51,6 +51,27 @@ Reply normally in your final answer. To send a file, image, or voice clip back t
 - \`open-claudia send-voice <path>\` — ogg/opus voice note
 Never print or embed bot tokens in prompts, commands, logs, or messages.
 
+## Background work
+You can persist work across turns and wake yourself up later. These survive bot restarts.
+
+Wake-ups and crons (real schedulers, not hallucinations — use them instead of saying "I'll check back later"):
+- \`open-claudia schedule-wakeup <when> "<prompt>"\` — one-shot. \`<when>\` is a duration like \`30s\`/\`5m\`/\`2h\`/\`1d\` or an ISO datetime. When it fires you wake up in this same conversation with the prompt as if the user typed it.
+- \`open-claudia cron-add "<5-field cron>" "<prompt>"\` — recurring.
+- \`open-claudia cron-list\` — list all wakeups + crons on this channel.
+- \`open-claudia cron-remove <id>\` — cancel one.
+
+Persistent todo list (per channel; use for multi-step work so progress survives compaction):
+- \`open-claudia task add "<content>"\`
+- \`open-claudia task list\`
+- \`open-claudia task start <id>\` / \`task done <id>\` / \`task remove <id>\`
+
+Sub-agents (spawn a fresh throwaway Claude for focused research — output comes back on stdout):
+- \`open-claudia agent "<prompt>" [--role "<role>"]\`
+- Use when a side question would pollute this conversation, or to fan out independent lookups.
+- The sub-agent has Read/Glob/Grep/Bash but no access to your chat session or send-* tools.
+
+If you tell the user "I'll check back in N minutes" or "I'll run this every morning", you MUST schedule it with one of the commands above in the same turn. Otherwise nothing happens.
+
 ## Guidelines
 - Keep responses concise — many users are on mobile.
 - Markdown: *bold*, _italic_, \`code\`, \`\`\`code blocks\`\`\` work on both Telegram and Kazee. Skip headers (#) and links [text](url).

package/core/tasks.js

@@ -0,0 +1,92 @@
+// Per-channel persistent todo list. The agent uses this to track
+// multi-step work that should survive a turn, a compaction, or a
+// restart. Scoped by adapter+channel so Telegram and Kazee see
+// separate lists.
+
+const fs = require("fs");
+const path = require("path");
+const { TASKS_DIR } = require("./config");
+
+function safe(s) {
+  return String(s || "").replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 80);
+}
+
+function filePathFor(adapter, channelId) {
+  fs.mkdirSync(TASKS_DIR, { recursive: true });
+  return path.join(TASKS_DIR, `${safe(adapter)}-${safe(channelId)}.json`);
+}
+
+function load(adapter, channelId) {
+  try {
+    const raw = JSON.parse(fs.readFileSync(filePathFor(adapter, channelId), "utf-8"));
+    return Array.isArray(raw) ? raw : [];
+  } catch (e) { return []; }
+}
+
+function save(adapter, channelId, list) {
+  const f = filePathFor(adapter, channelId);
+  const tmp = `${f}.tmp`;
+  fs.writeFileSync(tmp, JSON.stringify(list, null, 2));
+  fs.renameSync(tmp, f);
+}
+
+function nextId() {
+  return `task_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`;
+}
+
+function add(adapter, channelId, content) {
+  const list = load(adapter, channelId);
+  const t = {
+    id: nextId(),
+    content: String(content || "").trim(),
+    status: "pending",
+    createdAt: Date.now(),
+    updatedAt: Date.now(),
+  };
+  list.push(t);
+  save(adapter, channelId, list);
+  return t;
+}
+
+function update(adapter, channelId, id, patch) {
+  const list = load(adapter, channelId);
+  const idx = list.findIndex((t) => t.id === id);
+  if (idx < 0) return null;
+  list[idx] = { ...list[idx], ...patch, updatedAt: Date.now() };
+  save(adapter, channelId, list);
+  return list[idx];
+}
+
+function remove(adapter, channelId, id) {
+  const list = load(adapter, channelId);
+  const idx = list.findIndex((t) => t.id === id);
+  if (idx < 0) return null;
+  const [removed] = list.splice(idx, 1);
+  save(adapter, channelId, list);
+  return removed;
+}
+
+function clearCompleted(adapter, channelId) {
+  const list = load(adapter, channelId).filter((t) => t.status !== "completed");
+  save(adapter, channelId, list);
+  return list;
+}
+
+function list(adapter, channelId, opts = {}) {
+  const all = load(adapter, channelId);
+  if (opts.status) return all.filter((t) => t.status === opts.status);
+  return all;
+}
+
+function format(t, idx) {
+  const mark = t.status === "completed" ? "[x]" : t.status === "in_progress" ? "[~]" : "[ ]";
+  const num = typeof idx === "number" ? `${idx + 1}. ` : "";
+  return `${num}${mark} ${t.content}`;
+}
+
+module.exports = {
+  filePathFor,
+  load, save,
+  add, update, remove, list, clearCompleted,
+  format,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "2.0.3",
+  "version": "2.0.4",
   "description": "Your always-on AI coding assistant — Claude Code, Cursor Agent, and OpenAI Codex via Telegram or Kazee Chat",
   "main": "bot.js",
   "bin": {

package/core/cron.js

@@ -1,77 +0,0 @@
-// Cron loader and scheduler. Cron jobs fire from a timer (no inbound
-// message, so no chatContext) — we resolve the owner's preferred
-// channel from identities and bind the run to that adapter.
-
-const fs = require("fs");
-const path = require("path");
-const cron = require("node-cron");
-const { CRONS_FILE, WORKSPACE, CHAT_ID } = require("./config");
-const { runInChat } = require("./context");
-const { canonicalForTelegram, identities } = require("./identity");
-const { runClaudeSilent } = require("./runner");
-
-const activeCrons = new Map();
-let adaptersById = new Map();
-
-function setAdapters(adapters) {
-  adaptersById = new Map();
-  for (const a of adapters) adaptersById.set(a.type, a);
-}
-
-function loadCrons() {
-  try { return JSON.parse(fs.readFileSync(CRONS_FILE, "utf-8")); }
-  catch (e) { return []; }
-}
-
-function saveCrons(list) {
-  fs.writeFileSync(CRONS_FILE, JSON.stringify(list, null, 2));
-}
-
-function ownerDispatchTarget() {
-  // Prefer an explicit owner mapping; fall back to legacy Telegram CHAT_ID.
-  const ownerId = canonicalForTelegram(CHAT_ID || "");
-  const preferred = identities.preferred[ownerId];
-  if (preferred && preferred.transport && adaptersById.get(preferred.transport)) {
-    return {
-      adapter: adaptersById.get(preferred.transport),
-      channelId: String(preferred.channelId),
-      canonicalUserId: ownerId,
-    };
-  }
-  const tg = adaptersById.get("telegram");
-  if (tg && CHAT_ID) {
-    return { adapter: tg, channelId: String(CHAT_ID), canonicalUserId: ownerId };
-  }
-  return null;
-}
-
-function scheduleCron(c) {
-  const cwd = path.join(WORKSPACE, c.project);
-  if (activeCrons.has(c.id)) activeCrons.get(c.id).task.stop();
-  const task = cron.schedule(c.schedule, () => {
-    const target = ownerDispatchTarget();
-    if (!target) {
-      console.error(`Cron ${c.label}: no adapter available to deliver result`);
-      return;
-    }
-    runInChat(target, () => runClaudeSilent(c.prompt, cwd, c.label));
-  });
-  activeCrons.set(c.id, { task, config: c });
-}
-
-function initCrons() {
-  for (const c of loadCrons()) {
-    try { scheduleCron(c); }
-    catch (e) { console.error("Cron error:", e.message); }
-  }
-  console.log(`Loaded ${loadCrons().length} cron(s)`);
-}
-
-module.exports = {
-  activeCrons,
-  setAdapters,
-  loadCrons,
-  saveCrons,
-  scheduleCron,
-  initCrons,
-};