botinabox 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -466,6 +466,8 @@ declare class ChannelRegistry {
      * Run health checks on all registered adapters.
      */
     healthCheck(): Promise<Record<string, HealthStatus>>;
+    /** Check if an adapter is registered. */
+    has(id: string): boolean;
     /** Get an adapter by ID. */
     get(id: string): ChannelAdapter | undefined;
     /** List all registered adapters. */
@@ -550,6 +552,7 @@ type EntitySource = {
     remoteKey: string;
     remoteTable: string;
     filters?: Filter[];
+    softDelete?: boolean;
     orderBy?: string;
     limit?: number;
 } | {
@@ -986,6 +989,69 @@ declare const CORE_MIGRATIONS: Array<{
  */
 declare function defineCoreEntityContexts(db: DataStore): void;
 
+/**
+ * Options for domain table generation.
+ * Enable/disable optional tables based on your app's needs.
+ */
+interface DomainSchemaOptions {
+    /** Include client + invoice tables (default: true) */
+    clients?: boolean;
+    /** Include repository table (default: true) */
+    repositories?: boolean;
+    /** Include file table (default: true) */
+    files?: boolean;
+    /** Include channel table (default: true) */
+    channels?: boolean;
+    /** Include rule table + junction tables (default: true) */
+    rules?: boolean;
+    /** Include event audit log (default: true) */
+    events?: boolean;
+}
+/**
+ * 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
+ * ```
+ */
+declare function defineDomainTables(db: DataStore, options?: DomainSchemaOptions): void;
+
+/**
+ * Options for domain entity context generation.
+ * Match the options used in defineDomainTables().
+ */
+interface DomainEntityContextOptions {
+    clients?: boolean;
+    repositories?: boolean;
+    files?: boolean;
+    channels?: boolean;
+    rules?: boolean;
+}
+/**
+ * Define entity context rendering for standard domain tables.
+ * Call after defineDomainTables() and defineCoreTables().
+ *
+ * Renders per-entity directories with context files for:
+ * org, project, + optional client, file, channel entities.
+ * Also adds PROJECTS.md, RULES.md, SKILLS.md, REPOS.md to agent context.
+ *
+ * @example
+ * ```ts
+ * defineCoreTables(db);
+ * defineDomainTables(db);
+ * defineCoreEntityContexts(db);    // agents, users, skills
+ * defineDomainEntityContexts(db);  // org, project, client, file, channel
+ * ```
+ */
+declare function defineDomainEntityContexts(db: DataStore, options?: DomainEntityContextOptions): void;
+
 interface SanitizerOptions {
     fieldLengthLimits?: Record<string, number>;
     truncateSuffix?: string;
@@ -1047,6 +1113,20 @@ declare class AuditEmitter {
     emit(event: AuditEvent): void;
 }
 
+/**
+ * Build a clean environment for spawned subprocesses.
+ * Strips secrets and passes only safe system variables.
+ * Used by the CLI execution adapter when spawning agent processes.
+ */
+/**
+ * Build a filtered environment for subprocess execution.
+ * Only passes explicitly allowed variables — all secrets are stripped.
+ *
+ * @param allowedKeys - Additional keys to allow beyond the defaults
+ * @param inject - Extra key-value pairs to inject into the env
+ */
+declare function buildProcessEnv(allowedKeys?: string[], inject?: Record<string, string>): Record<string, string>;
+
 interface PackageUpdate {
     name: string;
     installedVersion: string;
@@ -1373,4 +1453,36 @@ declare class SecretStore {
     private _toMeta;
 }
 
-export { AGENT_STATUSES, type AgentConfig, type AgentDefinition, type AgentFilter, type AgentRecord, AgentRegistry, type AgentStatus, ApiExecutionAdapter, AuditEmitter, type AuditEvent, BackupManager, type BotConfig, type BudgetCheck, type BudgetConfig, BudgetController, CORE_MIGRATIONS, ChannelAdapter, ChannelRegistry, ChannelRegistryError, ChatMessage, ChatSessionManager, CliExecutionAdapter, type ColumnValidator, ColumnValidatorImpl, type ConfigLoadError, type ConfigLoadResult, DEFAULTS, DEFAULT_CONFIG, type DataConfig, DataStore, DataStoreError, EVENTS, type EntityColumnDef, type EntityConfig, type EntityContextDef, type EntityFileSpec, type EntitySource, type ExecutionAdapter, type Filter, HealthStatus, HeartbeatScheduler, HookBus, type HookHandler, type HookOptions, type HookRegistration, InboundMessage, LLMProvider, MAX_CHAIN_DEPTH, MessagePipeline, type ModelConfig, ModelInfo, ModelRouter, NdjsonLogger, NotificationQueue, type PackageMigration, type PackageUpdate, type PkLookup, ProviderRegistry, type QueryOptions, RUN_STATUSES, type RelationDef, type RenderConfig, ResolvedModel, type RetryPolicy, type Row, type RunContext, RunManager, type RunResult, type RunStatus, type SanitizerOptions, type SchemaError, type SecretInput, type SecretMeta, SecretStore, type SecurityConfig, type SeedItem, SessionKey, SessionManager, type SqliteAdapter, type StepRef, TASK_STATUSES, type TableDefinition, type TableInfoRow, type TaskDefinition, TaskQueue, type TaskRecord, type TaskStatus, TokenUsage, type Unsubscribe, UpdateChecker, type UpdateConfig, UpdateManager, type UpdateManifest, type User, type UserInput, UserRegistry, WakeupQueue, type WorkflowConfigEntry, type WorkflowDefinition$1 as WorkflowDefinition, WorkflowEngine, type WorkflowRunRecord, type WorkflowRunStatus, type WorkflowStep$1 as WorkflowStep, type WorkflowStepConfig, type WorkflowTrigger, _resetConfig, areDependenciesMet, buildAgentBindings, buildChainOrigin, checkAllowlist, checkChainDepth, checkMentionGate, chunkText, classifyUpdate, compareVersions, createConfigRevision, defineCoreEntityContexts, defineCoreTables, detectCycle, discoverChannels, discoverProviders, formatText, getConfig, initConfig, interpolate, interpolateEnv, loadConfig, parseVersion, runPackageMigrations, sanitize, topologicalSort, validateConfig };
+/**
+ * Parse Claude CLI NDJSON (stream-json) output into structured results.
+ * Used by the CLI execution adapter to extract session info, costs,
+ * token usage, and text output from Claude CLI subprocess output.
+ */
+interface ParsedStream {
+    sessionId: string | null;
+    model: string | null;
+    costUsd: number | null;
+    usage: UsageSummary | null;
+    summary: string;
+    isError: boolean;
+    errorMessage: string | null;
+    stopReason: string | null;
+}
+interface UsageSummary {
+    inputTokens: number;
+    cachedInputTokens: number;
+    outputTokens: number;
+}
+/**
+ * Parse Claude CLI NDJSON output into a structured result.
+ * Handles init, assistant, and result event types.
+ */
+declare function parseClaudeStream(stdout: string): ParsedStream;
+/** Check if the run stopped due to max turns. */
+declare function isMaxTurns(parsed: ParsedStream): boolean;
+/** Check if Claude CLI requires login. */
+declare function isLoginRequired(stdout: string): boolean;
+/** Rewrite local image paths to prevent CLI auto-embedding as vision content. */
+declare function deactivateLocalImagePaths(prompt: string): string;
+
+export { AGENT_STATUSES, type AgentConfig, type AgentDefinition, type AgentFilter, type AgentRecord, AgentRegistry, type AgentStatus, ApiExecutionAdapter, AuditEmitter, type AuditEvent, BackupManager, type BotConfig, type BudgetCheck, type BudgetConfig, BudgetController, CORE_MIGRATIONS, ChannelAdapter, ChannelRegistry, ChannelRegistryError, ChatMessage, ChatSessionManager, CliExecutionAdapter, type ColumnValidator, ColumnValidatorImpl, type ConfigLoadError, type ConfigLoadResult, DEFAULTS, DEFAULT_CONFIG, type DataConfig, DataStore, DataStoreError, type DomainEntityContextOptions, type DomainSchemaOptions, EVENTS, type EntityColumnDef, type EntityConfig, type EntityContextDef, type EntityFileSpec, type EntitySource, type ExecutionAdapter, type Filter, HealthStatus, HeartbeatScheduler, HookBus, type HookHandler, type HookOptions, type HookRegistration, InboundMessage, LLMProvider, MAX_CHAIN_DEPTH, MessagePipeline, type ModelConfig, ModelInfo, ModelRouter, NdjsonLogger, NotificationQueue, type PackageMigration, type PackageUpdate, type ParsedStream, type PkLookup, ProviderRegistry, type QueryOptions, RUN_STATUSES, type RelationDef, type RenderConfig, ResolvedModel, type RetryPolicy, type Row, type RunContext, RunManager, type RunResult, type RunStatus, type SanitizerOptions, type SchemaError, type SecretInput, type SecretMeta, SecretStore, type SecurityConfig, type SeedItem, SessionKey, SessionManager, type SqliteAdapter, type StepRef, TASK_STATUSES, type TableDefinition, type TableInfoRow, type TaskDefinition, TaskQueue, type TaskRecord, type TaskStatus, TokenUsage, type Unsubscribe, UpdateChecker, type UpdateConfig, UpdateManager, type UpdateManifest, type UsageSummary, type User, type UserInput, UserRegistry, WakeupQueue, type WorkflowConfigEntry, type WorkflowDefinition$1 as WorkflowDefinition, WorkflowEngine, type WorkflowRunRecord, type WorkflowRunStatus, type WorkflowStep$1 as WorkflowStep, type WorkflowStepConfig, type WorkflowTrigger, _resetConfig, areDependenciesMet, buildAgentBindings, buildChainOrigin, buildProcessEnv, checkAllowlist, checkChainDepth, checkMentionGate, chunkText, classifyUpdate, compareVersions, createConfigRevision, deactivateLocalImagePaths, defineCoreEntityContexts, defineCoreTables, defineDomainEntityContexts, defineDomainTables, detectCycle, discoverChannels, discoverProviders, formatText, getConfig, initConfig, interpolate, interpolateEnv, isLoginRequired, isMaxTurns, loadConfig, parseClaudeStream, parseVersion, runPackageMigrations, sanitize, topologicalSort, validateConfig };

package/dist/index.js

@@ -585,6 +585,10 @@ var ChannelRegistry = class {
     }
     return results;
   }
+  /** Check if an adapter is registered. */
+  has(id) {
+    return this.adapters.has(id);
+  }
   /** Get an adapter by ID. */
   get(id) {
     return this.adapters.get(id)?.adapter;
@@ -830,14 +834,14 @@ var SessionManager = class {
   async save(agentId, channelId, peerId, params) {
     const existing = await this._find(agentId, channelId, peerId);
     if (existing) {
-      await this.db.update("messages", { id: existing["id"] }, {
+      await this.db.update("sessions", { id: existing["id"] }, {
         context: JSON.stringify(params),
         last_message_at: (/* @__PURE__ */ new Date()).toISOString(),
         message_count: (existing["message_count"] ?? 0) + 1
       });
       return existing["id"];
     } else {
-      const row = await this.db.insert("messages", {
+      const row = await this.db.insert("sessions", {
         agent_id: agentId,
         channel: channelId,
         peer_id: peerId,
@@ -857,7 +861,7 @@ var SessionManager = class {
   async clear(agentId, channelId, peerId) {
     const session = await this._find(agentId, channelId, peerId);
     if (session) {
-      await this.db.delete("messages", { id: session["id"] });
+      await this.db.delete("sessions", { id: session["id"] });
     }
   }
   async shouldClear(session, opts) {
@@ -876,7 +880,7 @@ var SessionManager = class {
     return false;
   }
   async _find(agentId, channelId, peerId) {
-    const rows = await this.db.query("messages", {
+    const rows = await this.db.query("sessions", {
       where: { agent_id: agentId, channel: channelId, peer_id: peerId }
     });
     return rows[0] ?? void 0;
@@ -923,6 +927,9 @@ var NotificationQueue = class {
    * Returns the notification ID.
    */
   async enqueue(channel, recipient, payload) {
+    if (!this.channelRegistry.has(channel)) {
+      throw new Error(`No registered adapter for channel: ${channel}`);
+    }
     const row = await this.db.insert("notifications", {
       channel,
       recipient_id: recipient,
@@ -1369,20 +1376,41 @@ function defineCoreTables(db) {
     ]
   });
   db.define("messages", {
+    columns: {
+      id: "TEXT PRIMARY KEY",
+      channel: "TEXT NOT NULL DEFAULT 'slack'",
+      direction: "TEXT NOT NULL DEFAULT 'inbound'",
+      from_user: "TEXT",
+      from_agent: "TEXT",
+      agent_id: "TEXT",
+      user_id: "TEXT",
+      body: "TEXT NOT NULL",
+      thread_id: "TEXT",
+      task_id: "TEXT",
+      created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
+      deleted_at: "TEXT"
+    },
+    tableConstraints: [
+      "CREATE INDEX IF NOT EXISTS idx_messages_created ON messages(created_at)",
+      "CREATE INDEX IF NOT EXISTS idx_messages_thread ON messages(thread_id)",
+      "CREATE INDEX IF NOT EXISTS idx_messages_agent ON messages(agent_id)"
+    ]
+  });
+  db.define("sessions", {
     columns: {
       id: "TEXT PRIMARY KEY",
       agent_id: "TEXT NOT NULL",
       channel: "TEXT NOT NULL",
       peer_id: "TEXT NOT NULL",
       user_id: "TEXT",
-      last_message_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
-      message_count: "INTEGER NOT NULL DEFAULT 0",
       context: "TEXT NOT NULL DEFAULT '{}'",
+      message_count: "INTEGER NOT NULL DEFAULT 0",
+      last_message_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
       created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
       expires_at: "TEXT"
     },
     tableConstraints: [
-      "CREATE UNIQUE INDEX IF NOT EXISTS idx_messages_agent_channel_peer ON messages(agent_id, channel, peer_id)"
+      "CREATE UNIQUE INDEX IF NOT EXISTS idx_sessions_agent_channel_peer ON sessions(agent_id, channel, peer_id)"
     ]
   });
   db.define("skills", {
@@ -1671,6 +1699,55 @@ ${s.definition}` : null,
       }
     }
   });
+  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" ? "\u2192" : "\u2190";
+        const who = r.from_agent ?? r.from_user ?? "unknown";
+        const time = (r.created_at ?? "").slice(0, 16);
+        const preview = (r.body ?? "").slice(0, 80);
+        return `- ${dir} **${who}** (${time}): ${preview}`;
+      });
+      return `# Messages
+
+Last ${lines.length} messages:
+
+${lines.join("\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");
+        }
+      }
+    }
+  });
 }
 
 // src/core/data/domain-schema.ts
@@ -2697,8 +2774,9 @@ var TaskQueue = class {
         )
       )
     });
-    await this.hooks.emit("task.created", { taskId: row["id"], title: task.title });
-    return row["id"];
+    const taskId = row["id"];
+    void this.hooks.emit("task.created", { taskId, title: task.title });
+    return taskId;
   }
   async update(id, changes) {
     await this.db.update("tasks", { id }, {
@@ -2835,6 +2913,11 @@ var RunManager = class {
         }
       }
     } else {
+      await this.db.update("tasks", { id: taskId }, {
+        status: "done",
+        result: result.output,
+        updated_at: (/* @__PURE__ */ new Date()).toISOString()
+      });
       const task = await this.db.get("tasks", { id: taskId });
       if (task && task["followup_agent_id"]) {
         const chainDepth = (task["chain_depth"] ?? 0) + 1;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botinabox",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Bot in a Box — framework for building multi-agent bots",
   "type": "module",
   "main": "./dist/index.js",