botinabox 2.4.2 → 2.5.0

package/dist/core/data/domain-schema.js

@@ -1,323 +0,0 @@
-/**
- * Define standard domain tables that most multi-agent apps need.
- * Call after defineCoreTables() and before db.init().
- *
- * Provides: org, project, + optional client, invoice, repository,
- * file, channel, rule, event tables with appropriate junction tables.
- *
- * @example
- * ```ts
- * defineCoreTables(db);
- * defineDomainTables(db);          // all tables
- * defineDomainTables(db, { clients: false }); // skip client/invoice
- * ```
- */
-export function defineDomainTables(db, options = {}) {
-    const opts = {
-        clients: true,
-        repositories: true,
-        files: true,
-        channels: true,
-        rules: true,
-        events: true,
-        junctions: true,
-        ...options,
-    };
-    // --- Core domain entities ---
-    db.define("org", {
-        columns: {
-            id: "TEXT PRIMARY KEY",
-            name: "TEXT NOT NULL",
-            type: "TEXT NOT NULL DEFAULT 'company'",
-            description: "TEXT",
-            mission: "TEXT",
-            website: "TEXT",
-            created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            updated_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            deleted_at: "TEXT",
-        },
-    });
-    db.define("project", {
-        columns: {
-            id: "TEXT PRIMARY KEY",
-            org_id: "TEXT NOT NULL",
-            name: "TEXT NOT NULL",
-            status: "TEXT",
-            description: "TEXT",
-            tech_stack: "TEXT",
-            github_repo: "TEXT",
-            deploy_target: "TEXT",
-            production_url: "TEXT",
-            branch_strategy: "TEXT",
-            repo_path: "TEXT",
-            codename: "TEXT",
-            notes: "TEXT",
-            created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            updated_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            deleted_at: "TEXT",
-        },
-    });
-    // Agent ↔ project junction
-    db.define("agent_project", {
-        columns: {
-            agent_id: "TEXT NOT NULL",
-            project_id: "TEXT NOT NULL",
-            role: "TEXT",
-            created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-        },
-        primaryKey: ["agent_id", "project_id"],
-    });
-    // Secret ↔ project junction
-    db.define("secret_project", {
-        columns: {
-            secret_id: "TEXT NOT NULL",
-            project_id: "TEXT NOT NULL",
-            created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-        },
-        primaryKey: ["secret_id", "project_id"],
-    });
-    // Secret ↔ org junction
-    db.define("secret_org", {
-        columns: {
-            secret_id: "TEXT NOT NULL",
-            org_id: "TEXT NOT NULL",
-            created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-        },
-        primaryKey: ["secret_id", "org_id"],
-    });
-    // --- Optional: clients + invoicing ---
-    if (opts.clients) {
-        db.define("client", {
-            columns: {
-                id: "TEXT PRIMARY KEY",
-                org_id: "TEXT NOT NULL",
-                name: "TEXT NOT NULL",
-                contact_name: "TEXT",
-                contact_email: "TEXT",
-                phone: "TEXT",
-                address: "TEXT",
-                status: "TEXT NOT NULL DEFAULT 'active'",
-                notes: "TEXT",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                updated_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                deleted_at: "TEXT",
-            },
-        });
-        db.define("invoice", {
-            columns: {
-                id: "TEXT PRIMARY KEY",
-                org_id: "TEXT NOT NULL",
-                client_id: "TEXT NOT NULL",
-                number: "TEXT",
-                amount_cents: "INTEGER",
-                currency: "TEXT DEFAULT 'USD'",
-                status: "TEXT NOT NULL DEFAULT 'draft'",
-                description: "TEXT",
-                hours: "REAL",
-                rate_cents: "INTEGER",
-                items_json: "TEXT",
-                issued_at: "TEXT",
-                due_at: "TEXT",
-                paid_at: "TEXT",
-                notes: "TEXT",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                updated_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                deleted_at: "TEXT",
-            },
-            tableConstraints: [
-                "CREATE INDEX IF NOT EXISTS idx_invoice_client ON invoice(client_id)",
-            ],
-        });
-        db.define("agent_client", {
-            columns: {
-                agent_id: "TEXT NOT NULL",
-                client_id: "TEXT NOT NULL",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["agent_id", "client_id"],
-        });
-    }
-    // --- Optional: repositories ---
-    if (opts.repositories) {
-        db.define("repository", {
-            columns: {
-                id: "TEXT PRIMARY KEY",
-                org_id: "TEXT NOT NULL",
-                project_id: "TEXT",
-                client_id: "TEXT",
-                name: "TEXT NOT NULL",
-                url: "TEXT",
-                local_path: "TEXT",
-                default_branch: "TEXT DEFAULT 'main'",
-                platform: "TEXT DEFAULT 'github'",
-                status: "TEXT NOT NULL DEFAULT 'active'",
-                notes: "TEXT",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                updated_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                deleted_at: "TEXT",
-            },
-            tableConstraints: [
-                "CREATE INDEX IF NOT EXISTS idx_repository_project ON repository(project_id)",
-                "CREATE INDEX IF NOT EXISTS idx_repository_client ON repository(client_id)",
-            ],
-        });
-    }
-    // --- Optional: files ---
-    if (opts.files) {
-        db.define("file", {
-            columns: {
-                id: "TEXT PRIMARY KEY",
-                org_id: "TEXT",
-                name: "TEXT NOT NULL",
-                file_path: "TEXT",
-                mime_type: "TEXT",
-                size_bytes: "INTEGER",
-                project_id: "TEXT",
-                access_level: "TEXT NOT NULL DEFAULT 'org'",
-                description: "TEXT",
-                tags: "TEXT",
-                notes: "TEXT",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                updated_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                deleted_at: "TEXT",
-            },
-        });
-    }
-    // --- Optional: channels ---
-    if (opts.channels) {
-        db.define("channel", {
-            columns: {
-                id: "TEXT PRIMARY KEY",
-                org_id: "TEXT",
-                platform: "TEXT NOT NULL",
-                external_id: "TEXT",
-                name: "TEXT NOT NULL",
-                type: "TEXT NOT NULL DEFAULT 'channel'",
-                instructions: "TEXT",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                updated_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                deleted_at: "TEXT",
-            },
-        });
-    }
-    // --- Optional: rules ---
-    if (opts.rules) {
-        db.define("rule", {
-            columns: {
-                id: "TEXT PRIMARY KEY",
-                org_id: "TEXT",
-                title: "TEXT NOT NULL",
-                rule_text: "TEXT NOT NULL",
-                scope: "TEXT NOT NULL DEFAULT 'org'",
-                category: "TEXT NOT NULL DEFAULT 'process'",
-                priority: "INTEGER NOT NULL DEFAULT 50",
-                rationale: "TEXT",
-                enforcement: "TEXT DEFAULT 'advisory'",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                updated_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                deleted_at: "TEXT",
-            },
-        });
-        db.define("rule_agent", {
-            columns: {
-                rule_id: "TEXT NOT NULL",
-                agent_id: "TEXT NOT NULL",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["rule_id", "agent_id"],
-        });
-        db.define("rule_project", {
-            columns: {
-                rule_id: "TEXT NOT NULL",
-                project_id: "TEXT NOT NULL",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["rule_id", "project_id"],
-        });
-        db.define("rule_org", {
-            columns: {
-                rule_id: "TEXT NOT NULL",
-                org_id: "TEXT NOT NULL",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["rule_id", "org_id"],
-        });
-    }
-    // --- Optional: event audit log ---
-    if (opts.events) {
-        db.define("event", {
-            columns: {
-                id: "TEXT PRIMARY KEY",
-                org_id: "TEXT",
-                type: "TEXT NOT NULL",
-                summary: "TEXT NOT NULL",
-                details: "TEXT",
-                severity: "TEXT NOT NULL DEFAULT 'info'",
-                actor_agent_id: "TEXT",
-                actor_user_id: "TEXT",
-                project_id: "TEXT",
-                channel_id: "TEXT",
-                source: "TEXT",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-                deleted_at: "TEXT",
-            },
-            tableConstraints: [
-                "CREATE INDEX IF NOT EXISTS idx_event_type ON event(type, created_at)",
-                "CREATE INDEX IF NOT EXISTS idx_event_project ON event(project_id)",
-            ],
-        });
-    }
-    // --- Optional: cross-domain junction tables ---
-    if (opts.junctions) {
-        db.define("secret_client", {
-            columns: {
-                secret_id: "TEXT NOT NULL",
-                client_id: "TEXT NOT NULL",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["secret_id", "client_id"],
-        });
-        db.define("secret_user", {
-            columns: {
-                secret_id: "TEXT NOT NULL",
-                user_id: "TEXT NOT NULL",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["secret_id", "user_id"],
-        });
-        db.define("secret_repository", {
-            columns: {
-                secret_id: "TEXT NOT NULL",
-                repository_id: "TEXT NOT NULL",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["secret_id", "repository_id"],
-        });
-        db.define("file_agent", {
-            columns: {
-                file_id: "TEXT NOT NULL",
-                agent_id: "TEXT NOT NULL",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["file_id", "agent_id"],
-        });
-        db.define("user_channel", {
-            columns: {
-                user_id: "TEXT NOT NULL",
-                channel_id: "TEXT NOT NULL",
-                role: "TEXT",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["user_id", "channel_id"],
-        });
-        db.define("user_project", {
-            columns: {
-                user_id: "TEXT NOT NULL",
-                project_id: "TEXT NOT NULL",
-                role: "TEXT",
-                created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-            },
-            primaryKey: ["user_id", "project_id"],
-        });
-    }
-}

package/dist/core/data/index.d.ts

@@ -1,7 +0,0 @@
-export * from './types.js';
-export * from './data-store.js';
-export * from './core-schema.js';
-export * from './core-migrations.js';
-export * from './core-entity-contexts.js';
-export * from './domain-schema.js';
-export * from './domain-entity-contexts.js';

package/dist/core/data/index.js

@@ -1,7 +0,0 @@
-export * from './types.js';
-export * from './data-store.js';
-export * from './core-schema.js';
-export * from './core-migrations.js';
-export * from './core-entity-contexts.js';
-export * from './domain-schema.js';
-export * from './domain-entity-contexts.js';

package/dist/core/data/types.d.ts

@@ -1,111 +0,0 @@
-export interface TableDefinition {
-    columns: Record<string, string>;
-    primaryKey?: string | string[];
-    tableConstraints?: string[];
-    relations?: Record<string, RelationDef>;
-    render?: string | ((rows: Row[]) => string);
-    outputFile?: string;
-    filter?: (rows: Row[]) => Row[];
-}
-export interface RelationDef {
-    type: 'belongsTo' | 'hasMany';
-    table: string;
-    foreignKey: string;
-    references?: string;
-}
-export interface EntityContextDef {
-    table: string;
-    directory: string;
-    slugColumn: string;
-    files: Record<string, EntityFileSpec>;
-    indexFile?: string;
-    /** Custom index render function. If omitted, a default listing is generated. */
-    indexRender?: (rows: Row[]) => string;
-    protectedFiles?: string[];
-    /** When true, this entity's data is never rendered into other entities' context files. */
-    protected?: boolean;
-    /** Enable at-rest encryption. Requires encryptionKey in Lattice options. */
-    encrypted?: boolean | {
-        columns: string[];
-    };
-}
-export interface EntityFileSpec {
-    source: EntitySource;
-    render: string | ((rows: Row[]) => string);
-    junctionColumns?: string[];
-    omitIfEmpty?: boolean;
-}
-export type EntitySource = {
-    type: 'self';
-} | {
-    type: 'hasMany';
-    table: string;
-    foreignKey: string;
-    filters?: Filter[];
-    softDelete?: boolean;
-    orderBy?: string;
-    limit?: number;
-} | {
-    type: 'manyToMany';
-    junctionTable: string;
-    localKey: string;
-    remoteKey: string;
-    remoteTable: string;
-    filters?: Filter[];
-    softDelete?: boolean;
-    orderBy?: string;
-    limit?: number;
-} | {
-    type: 'belongsTo';
-    table: string;
-    foreignKey: string;
-} | {
-    type: 'enriched';
-    include: Record<string, EntitySource>;
-} | {
-    type: 'custom';
-    resolve: (row: Row, adapter: SqliteAdapter) => Row[];
-};
-export interface Filter {
-    col: string;
-    op: 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'in' | 'isNull' | 'isNotNull';
-    val?: unknown;
-}
-export interface QueryOptions {
-    where?: Record<string, unknown>;
-    filters?: Filter[];
-    orderBy?: string | Array<{
-        col: string;
-        dir: 'asc' | 'desc';
-    }>;
-    orderDir?: 'asc' | 'desc';
-    limit?: number;
-    offset?: number;
-}
-export type Row = Record<string, unknown>;
-export type PkLookup = string | Record<string, unknown>;
-export interface SqliteAdapter {
-    run(sql: string, params?: unknown[]): import('better-sqlite3').RunResult;
-    get<T = Row>(sql: string, params?: unknown[]): T | undefined;
-    all<T = Row>(sql: string, params?: unknown[]): T[];
-    tableInfo(table: string): TableInfoRow[];
-    invalidateTableCache(table: string): void;
-}
-export interface TableInfoRow {
-    cid: number;
-    name: string;
-    type: string;
-    notnull: number;
-    dflt_value: unknown;
-    pk: number;
-}
-export interface SeedItem {
-    table: string;
-    rows: Row[];
-    naturalKey?: string | string[];
-    junctions?: Array<{
-        table: string;
-        items: Array<Row>;
-    }>;
-    softDeleteMissing?: boolean;
-}

package/dist/core/data/types.js

@@ -1 +0,0 @@
-export {};

package/dist/core/hooks/hook-bus.d.ts

@@ -1,18 +0,0 @@
-import type { HookHandler, HookOptions, Unsubscribe } from "./types.js";
-/**
- * Priority-ordered event bus for decoupled inter-layer communication.
- * Story 1.1 — handlers run in priority order, errors are isolated,
- * and registrations are unsubscribable.
- */
-export declare class HookBus {
-    private readonly registrations;
-    private nextId;
-    register(event: string, handler: HookHandler, opts?: HookOptions): Unsubscribe;
-    emit(event: string, context: Record<string, unknown>): Promise<void>;
-    /** Emit synchronously (use only when async is not needed) */
-    emitSync(event: string, context: Record<string, unknown>): void;
-    hasListeners(event: string): boolean;
-    listRegistered(): string[];
-    /** Remove all handlers for an event, or all handlers if no event given */
-    clear(event?: string): void;
-}

package/dist/core/hooks/hook-bus.js

@@ -1,120 +0,0 @@
-/**
- * Priority-ordered event bus for decoupled inter-layer communication.
- * Story 1.1 — handlers run in priority order, errors are isolated,
- * and registrations are unsubscribable.
- */
-export class HookBus {
-    registrations = new Map();
-    nextId = 0;
-    register(event, handler, opts) {
-        const reg = {
-            event,
-            handler,
-            priority: opts?.priority ?? 50,
-            once: opts?.once ?? false,
-            filter: opts?.filter,
-            id: this.nextId++,
-        };
-        const list = this.registrations.get(event) ?? [];
-        list.push(reg);
-        // Sort by priority ASC, then id ASC (insertion order tiebreaker)
-        list.sort((a, b) => a.priority - b.priority || a.id - b.id);
-        this.registrations.set(event, list);
-        return () => {
-            const arr = this.registrations.get(event);
-            if (!arr)
-                return;
-            const idx = arr.indexOf(reg);
-            if (idx !== -1)
-                arr.splice(idx, 1);
-        };
-    }
-    async emit(event, context) {
-        const list = this.registrations.get(event);
-        if (!list || list.length === 0)
-            return;
-        // Copy to avoid mutation issues during iteration
-        const snapshot = [...list];
-        const toRemove = [];
-        for (const reg of snapshot) {
-            // Filter check: every key/value in filter must match context
-            if (reg.filter) {
-                const matches = Object.entries(reg.filter).every(([k, v]) => context[k] === v);
-                if (!matches)
-                    continue;
-            }
-            try {
-                await reg.handler(context);
-            }
-            catch (err) {
-                // Errors are caught and logged — never block other handlers
-                console.error(`[HookBus] Handler error on event "${event}":`, err);
-            }
-            if (reg.once)
-                toRemove.push(reg);
-        }
-        // Remove once-handlers after iteration (avoid splice-during-iteration bugs)
-        for (const r of toRemove) {
-            const arr = this.registrations.get(event);
-            if (!arr)
-                continue;
-            const idx = arr.indexOf(r);
-            if (idx !== -1)
-                arr.splice(idx, 1);
-        }
-    }
-    /** Emit synchronously (use only when async is not needed) */
-    emitSync(event, context) {
-        const list = this.registrations.get(event);
-        if (!list || list.length === 0)
-            return;
-        const snapshot = [...list];
-        const toRemove = [];
-        for (const reg of snapshot) {
-            if (reg.filter) {
-                const matches = Object.entries(reg.filter).every(([k, v]) => context[k] === v);
-                if (!matches)
-                    continue;
-            }
-            try {
-                const result = reg.handler(context);
-                if (result instanceof Promise) {
-                    result.catch(err => console.error(`[HookBus] Async handler error on event "${event}":`, err));
-                }
-            }
-            catch (err) {
-                console.error(`[HookBus] Handler error on event "${event}":`, err);
-            }
-            if (reg.once)
-                toRemove.push(reg);
-        }
-        for (const r of toRemove) {
-            const arr = this.registrations.get(event);
-            if (!arr)
-                continue;
-            const idx = arr.indexOf(r);
-            if (idx !== -1)
-                arr.splice(idx, 1);
-        }
-    }
-    hasListeners(event) {
-        return (this.registrations.get(event)?.length ?? 0) > 0;
-    }
-    listRegistered() {
-        const result = [];
-        for (const [k, v] of this.registrations) {
-            if (v.length > 0)
-                result.push(k);
-        }
-        return result;
-    }
-    /** Remove all handlers for an event, or all handlers if no event given */
-    clear(event) {
-        if (event) {
-            this.registrations.delete(event);
-        }
-        else {
-            this.registrations.clear();
-        }
-    }
-}

package/dist/core/hooks/index.d.ts

@@ -1,2 +0,0 @@
-export { HookBus } from "./hook-bus.js";
-export type { HookHandler, HookOptions, HookRegistration, Unsubscribe } from "./types.js";

package/dist/core/hooks/index.js

@@ -1 +0,0 @@
-export { HookBus } from "./hook-bus.js";

package/dist/core/hooks/types.d.ts

@@ -1,19 +0,0 @@
-export type HookHandler = (context: Record<string, unknown>) => Promise<void> | void;
-export type Unsubscribe = () => void;
-export interface HookOptions {
-    /** 0–100, default 50. Lower = runs first. */
-    priority?: number;
-    /** Auto-unsubscribe after first invocation. */
-    once?: boolean;
-    /** Only fire if context matches all filter key/value pairs. */
-    filter?: Record<string, unknown>;
-}
-export interface HookRegistration {
-    event: string;
-    handler: HookHandler;
-    priority: number;
-    once: boolean;
-    filter?: Record<string, unknown>;
-    /** Internal auto-increment for stable sort within same priority */
-    id: number;
-}

package/dist/core/hooks/types.js

@@ -1 +0,0 @@
-export {};

package/dist/core/index.d.ts

@@ -1,4 +0,0 @@
-export * from "./hooks/index.js";
-export * from "./config/index.js";
-export * from "./llm/index.js";
-export * from "./chat/index.js";

package/dist/core/index.js

@@ -1,4 +0,0 @@
-export * from "./hooks/index.js";
-export * from "./config/index.js";
-export * from "./llm/index.js";
-export * from "./chat/index.js";

package/dist/core/llm/auto-discovery.d.ts

@@ -1,11 +0,0 @@
-import type { LLMProvider } from "./types.js";
-type Importer = (packageName: string) => Promise<unknown>;
-/**
- * Scans nodeModulesPath/@botinabox/{pkg}/package.json for each package in the scope.
- * If pkg.botinabox?.type === 'provider', dynamically imports the package
- * and returns the discovered LLMProvider instances.
- *
- * The optional importer parameter allows injection for testing.
- */
-export declare function discoverProviders(nodeModulesPath: string, importer?: Importer): Promise<LLMProvider[]>;
-export {};