botinabox 2.5.0 → 2.5.2

package/dist/core/data/core-entity-contexts.js

@@ -0,0 +1,197 @@
+import { truncateAtWord } from "../../shared/utils.js";
+/**
+ * Define default entity context rendering for botinabox core tables.
+ * Call after defineCoreTables() and before or after init().
+ *
+ * Renders:
+ * - agents/ — per-agent context (AGENT.md, PROJECTS.md if agent_project exists)
+ * - users/  — per-user context (USER.md) — protected
+ * - skills/ — per-skill context (SKILL.md)
+ *
+ * Apps can override by calling db.defineEntityContext() with the same table name
+ * BEFORE calling defineCoreEntityContexts().
+ */
+export function defineCoreEntityContexts(db) {
+    // --- Agents ---
+    db.defineEntityContext("agents", {
+        table: "agents",
+        directory: "agents",
+        slugColumn: "slug",
+        indexFile: "agents/AGENTS.md",
+        files: {
+            "AGENT.md": {
+                source: { type: "self" },
+                render: (rows) => {
+                    const a = rows[0];
+                    if (!a)
+                        return "";
+                    return [
+                        `# ${a.name}`,
+                        "",
+                        a.role ? `**Role:** ${a.role}` : null,
+                        a.adapter ? `**Adapter:** ${a.adapter}` : null,
+                        a.status ? `**Status:** ${a.status}` : null,
+                        a.cwd ? `**Working Directory:** ${a.cwd}` : null,
+                        a.reports_to ? `**Reports To:** ${a.reports_to}` : null,
+                        "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n");
+                },
+            },
+            "SKILLS.md": {
+                source: {
+                    type: "manyToMany",
+                    junctionTable: "agent_skills",
+                    localKey: "agent_id",
+                    remoteKey: "skill_id",
+                    remoteTable: "skills",
+                },
+                omitIfEmpty: true,
+                render: (rows) => {
+                    if (!rows.length)
+                        return "";
+                    const lines = [`# Skills (${rows.length})`, ""];
+                    for (const s of rows) {
+                        lines.push(`## ${s.name}`);
+                        if (s.category)
+                            lines.push(`**Category:** ${s.category}`);
+                        if (s.description)
+                            lines.push("", s.description);
+                        if (s.definition)
+                            lines.push("", "```", s.definition, "```");
+                        lines.push("");
+                    }
+                    return lines.join("\n");
+                },
+            },
+            "PLAYBOOKS.md": {
+                source: {
+                    type: "manyToMany",
+                    junctionTable: "agent_playbooks",
+                    localKey: "agent_id",
+                    remoteKey: "playbook_id",
+                    remoteTable: "playbooks",
+                },
+                omitIfEmpty: true,
+                render: (rows) => {
+                    if (!rows.length)
+                        return "";
+                    const lines = [`# Playbooks (${rows.length})`, ""];
+                    for (const pb of rows) {
+                        lines.push(`## ${pb.pattern ?? pb.name ?? "Unnamed"}`);
+                        if (pb.rule)
+                            lines.push("", pb.rule);
+                        lines.push("");
+                    }
+                    return lines.join("\n");
+                },
+            },
+        },
+    });
+    // --- Users (protected) ---
+    db.defineEntityContext("users", {
+        table: "users",
+        directory: "users",
+        slugColumn: "id",
+        protected: true,
+        indexFile: "users/USERS.md",
+        files: {
+            "USER.md": {
+                source: { type: "self" },
+                render: (rows) => {
+                    const u = rows[0];
+                    if (!u)
+                        return "";
+                    return [
+                        `# ${u.name}`,
+                        "",
+                        u.role ? `**Role:** ${u.role}` : null,
+                        u.title ? `**Title:** ${u.title}` : null,
+                        u.email ? `**Email:** ${u.email}` : null,
+                        u.timezone ? `**Timezone:** ${u.timezone}` : null,
+                        "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n");
+                },
+            },
+        },
+    });
+    // --- Skills ---
+    db.defineEntityContext("skills", {
+        table: "skills",
+        directory: "skills",
+        slugColumn: "slug",
+        indexFile: "skills/SKILLS.md",
+        files: {
+            "SKILL.md": {
+                source: { type: "self" },
+                render: (rows) => {
+                    const s = rows[0];
+                    if (!s)
+                        return "";
+                    return [
+                        `# ${s.name}`,
+                        "",
+                        s.category ? `**Category:** ${s.category}` : null,
+                        s.description ? `\n${s.description}` : null,
+                        s.definition ? `\n## Definition\n\n${s.definition}` : null,
+                        "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n");
+                },
+            },
+        },
+    });
+    // --- Messages ---
+    db.defineEntityContext("messages", {
+        table: "messages",
+        directory: "messages",
+        slugColumn: "id",
+        indexFile: "messages/MESSAGES.md",
+        indexRender: (rows) => {
+            const active = rows.filter((r) => r.deleted_at == null);
+            if (!active.length)
+                return "# Messages\n\nNo messages.\n";
+            const recent = active.slice(-100);
+            const lines = recent.map((r) => {
+                const dir = r.direction === "outbound" ? "→" : "←";
+                const who = r.from_agent ?? r.from_user ?? "unknown";
+                const time = (r.created_at ?? "").slice(0, 16);
+                const preview = truncateAtWord(r.body ?? "", 80);
+                return `- ${dir} **${who}** (${time}): ${preview}`;
+            });
+            return `# Messages\n\nLast ${lines.length} messages:\n\n${lines.join("\n")}\n`;
+        },
+        files: {
+            "MESSAGE.md": {
+                source: { type: "self" },
+                render: (rows) => {
+                    const m = rows[0];
+                    if (!m)
+                        return "";
+                    return [
+                        "# Message",
+                        "",
+                        `**Direction:** ${m.direction}`,
+                        m.from_user ? `**From User:** ${m.from_user}` : null,
+                        m.from_agent ? `**From Agent:** ${m.from_agent}` : null,
+                        `**Channel:** ${m.channel}`,
+                        m.thread_id ? `**Thread:** ${m.thread_id}` : null,
+                        m.task_id ? `**Task:** ${m.task_id}` : null,
+                        `**Time:** ${m.created_at}`,
+                        "",
+                        "---",
+                        "",
+                        m.body,
+                        "",
+                    ]
+                        .filter(Boolean)
+                        .join("\n");
+                },
+            },
+        },
+    });
+}

package/dist/core/data/core-migrations.d.ts

@@ -0,0 +1,5 @@
+/** Initial migration set for core tables */
+export declare const CORE_MIGRATIONS: Array<{
+    version: string;
+    sql: string;
+}>;

package/dist/core/data/core-migrations.js

@@ -0,0 +1,45 @@
+/** Initial migration set for core tables */
+export const CORE_MIGRATIONS = [
+    {
+        version: "001_initial_schema",
+        sql: `-- Initial schema is applied via DataStore.define() + init().
+          -- This migration is a no-op placeholder for version tracking.
+          SELECT 1;`,
+    },
+    {
+        version: "002_activity_log_indexes",
+        sql: `CREATE INDEX IF NOT EXISTS idx_activity_log_type ON activity_log(event_type, recorded_at);`,
+    },
+    {
+        version: "003_runs_cost_index",
+        sql: `CREATE INDEX IF NOT EXISTS idx_runs_cost ON runs(agent_id, completed_at) WHERE cost_cents > 0;`,
+    },
+    {
+        version: "004_schedules_table",
+        sql: `CREATE TABLE IF NOT EXISTS schedules (
+            id TEXT PRIMARY KEY,
+            name TEXT NOT NULL,
+            description TEXT,
+            type TEXT NOT NULL DEFAULT 'recurring',
+            cron TEXT,
+            run_at TEXT,
+            timezone TEXT DEFAULT 'UTC',
+            enabled INTEGER NOT NULL DEFAULT 1,
+            action TEXT NOT NULL,
+            action_config TEXT DEFAULT '{}',
+            last_fired_at TEXT,
+            next_fire_at TEXT,
+            created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            updated_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+            deleted_at TEXT
+          )`,
+    },
+    {
+        version: "005_schedules_name_index",
+        sql: `CREATE UNIQUE INDEX IF NOT EXISTS idx_schedules_name ON schedules(name) WHERE deleted_at IS NULL`,
+    },
+    {
+        version: "006_schedules_next_index",
+        sql: `CREATE INDEX IF NOT EXISTS idx_schedules_next ON schedules(enabled, next_fire_at) WHERE deleted_at IS NULL`,
+    },
+];

package/dist/core/data/core-schema.d.ts

@@ -0,0 +1,6 @@
+import type { DataStore } from "./data-store.js";
+/**
+ * Define all 18 core tables on a DataStore instance.
+ * Call before db.init().
+ */
+export declare function defineCoreTables(db: DataStore): void;