@inetafrica/open-claudia 2.0.3 → 2.0.5

package/core/system-prompt.js

@@ -6,9 +6,10 @@ const fs = require("fs");
 const path = require("path");
 const { SOUL_FILE, CRONS_FILE, VAULT_FILE, FILES_DIR, BOT_DIR, WHISPER_CLI, FFMPEG } = require("./config");
 const { currentState } = require("./state");
-const { currentAdapter } = require("./context");
+const { currentAdapter, currentChannelId } = require("./context");
 const { vault } = require("./vault-store");
 const { transcriptPointerNote } = require("./transcripts");
+const tasksStore = require("./tasks");
 
 function loadSoul() {
   try { return fs.readFileSync(SOUL_FILE, "utf-8"); }
@@ -20,10 +21,22 @@ function buildSystemPrompt() {
   const soul = loadSoul();
   const hasVoice = WHISPER_CLI && FFMPEG;
   const adapter = currentAdapter();
+  const channelId = currentChannelId();
   const channelLabel = adapter
     ? (adapter.type === "kazee" ? "Kazee Chat" : adapter.type === "telegram" ? "Telegram" : adapter.type)
     : "Telegram";
 
+  let pendingTasksBlock = "";
+  if (adapter && channelId) {
+    try {
+      const pending = tasksStore.pendingSummary(adapter.id, channelId);
+      if (pending.length > 0) {
+        const tree = tasksStore.formatTree(adapter.id, channelId, { showIds: true });
+        pendingTasksBlock = `\n## Pending tasks\nYou may be resuming prior work. Before starting anything new, review these and decide whether to continue, update, or abandon them. Mark a subtask in_progress when you actually start it and completed when it's done.\n\n${tree}\n`;
+      }
+    } catch (e) {}
+  }
+
   return `
 ${soul}
 
@@ -43,7 +56,7 @@ ${soul}
 - Received user files directory: ${FILES_DIR}
 
 ${transcriptPointerNote(state)}
-
+${pendingTasksBlock}
 ## Delivery
 Reply normally in your final answer. To send a file, image, or voice clip back to the current chat, run the bot CLI from inside this task — channel context is already in the env:
 - \`open-claudia send-file <path> [caption]\` — any document/binary
@@ -51,6 +64,34 @@ 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 with plans + subtasks (per channel; survives compaction and restart).
+
+For any work with 3+ distinct steps you MUST create a plan before starting. The plan is a parent task whose children are the steps. As you work, mark each subtask in_progress when you begin and completed when done — this is how a resumed turn (after compaction, restart, or wakeup) sees where you left off. If pending tasks already exist when you start a turn they will be shown under "## Pending tasks" above; check them first.
+
+- \`open-claudia task plan "<plan title>" "<step 1>" "<step 2>" "<step 3>" [--description "<why / success criteria>"]\` — atomic create
+- \`open-claudia task add "<content>" [--parent <plan-id>] [--description "..."]\` — add a single task or subtask
+- \`open-claudia task list\` — renders as a tree
+- \`open-claudia task start <id>\` / \`task done <id>\` / \`task remove <id>\` (removing a plan removes its subtasks)
+- \`open-claudia task clear-completed\` — only clears plans whose subtasks are all done
+
+For one-off work under 3 steps, skip the plan and just track it in your own response.
+
+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,168 @@
+// 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.
+//
+// Tasks support a single level of hierarchy via parentId: a top-level
+// "plan" task can have child subtasks. This lets the agent break a big
+// piece of work into a plan whose progress is visible at a glance.
+
+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, opts = {}) {
+  const list = load(adapter, channelId);
+  const parentId = opts.parentId || null;
+  if (parentId) {
+    const parent = list.find((t) => t.id === parentId);
+    if (!parent) throw new Error(`parent task not found: ${parentId}`);
+    if (parent.parentId) throw new Error(`nested subtasks not supported: ${parentId} is already a subtask`);
+  }
+  const t = {
+    id: nextId(),
+    content: String(content || "").trim(),
+    status: "pending",
+    parentId,
+    description: opts.description ? String(opts.description) : null,
+    createdAt: Date.now(),
+    updatedAt: Date.now(),
+  };
+  list.push(t);
+  save(adapter, channelId, list);
+  return t;
+}
+
+function plan(adapter, channelId, title, subtaskContents, opts = {}) {
+  const parent = add(adapter, channelId, title, { description: opts.description || null });
+  const children = [];
+  for (const c of subtaskContents || []) {
+    if (!String(c || "").trim()) continue;
+    children.push(add(adapter, channelId, c, { parentId: parent.id }));
+  }
+  return { parent, children };
+}
+
+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 target = list.find((t) => t.id === id);
+  if (!target) return null;
+  const ids = new Set([id]);
+  if (!target.parentId) {
+    for (const t of list) if (t.parentId === id) ids.add(t.id);
+  }
+  const next = list.filter((t) => !ids.has(t.id));
+  save(adapter, channelId, next);
+  return { removed: target, alsoRemoved: ids.size - 1 };
+}
+
+function clearCompleted(adapter, channelId) {
+  const all = load(adapter, channelId);
+  const drop = new Set();
+  for (const t of all) {
+    if (t.status !== "completed") continue;
+    if (t.parentId) { drop.add(t.id); continue; }
+    const kids = all.filter((c) => c.parentId === t.id);
+    if (kids.length === 0 || kids.every((c) => c.status === "completed")) {
+      drop.add(t.id);
+      for (const c of kids) drop.add(c.id);
+    }
+  }
+  const remaining = all.filter((t) => !drop.has(t.id));
+  save(adapter, channelId, remaining);
+  return remaining;
+}
+
+function list(adapter, channelId, opts = {}) {
+  const all = load(adapter, channelId);
+  if (opts.status) return all.filter((t) => t.status === opts.status);
+  return all;
+}
+
+function tree(adapter, channelId) {
+  const all = load(adapter, channelId);
+  const byParent = new Map();
+  const roots = [];
+  for (const t of all) {
+    if (t.parentId) {
+      if (!byParent.has(t.parentId)) byParent.set(t.parentId, []);
+      byParent.get(t.parentId).push(t);
+    } else {
+      roots.push(t);
+    }
+  }
+  return roots.map((r) => ({ ...r, children: byParent.get(r.id) || [] }));
+}
+
+function pendingSummary(adapter, channelId) {
+  const all = load(adapter, channelId);
+  return all.filter((t) => t.status === "pending" || t.status === "in_progress");
+}
+
+function statusMark(t) {
+  return t.status === "completed" ? "[x]" : t.status === "in_progress" ? "[~]" : "[ ]";
+}
+
+function format(t, idx) {
+  const num = typeof idx === "number" ? `${idx + 1}. ` : "";
+  return `${num}${statusMark(t)} ${t.content}`;
+}
+
+function formatTree(adapter, channelId, opts = {}) {
+  const showIds = opts.showIds !== false;
+  const t = tree(adapter, channelId);
+  const lines = [];
+  t.forEach((root, i) => {
+    const head = `${i + 1}. ${statusMark(root)} ${root.content}` + (showIds ? `    (${root.id})` : "");
+    lines.push(head);
+    if (root.description) lines.push(`      ${root.description}`);
+    root.children.forEach((child) => {
+      lines.push(`    ${statusMark(child)} ${child.content}` + (showIds ? `    (${child.id})` : ""));
+    });
+  });
+  return lines.join("\n");
+}
+
+module.exports = {
+  filePathFor,
+  load, save,
+  add, plan, update, remove, list, tree, clearCompleted,
+  pendingSummary,
+  format, formatTree, statusMark,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@inetafrica/open-claudia",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "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,
-};