botinabox 0.6.0 → 1.1.0

package/dist/channels/slack/index.d.ts

@@ -39,8 +39,23 @@ declare function createSlackAdapter(client?: BoltClient): SlackAdapter;
  * Story 4.5
  */
 
+interface SlackFile {
+    id?: string;
+    filetype?: string;
+    subtype?: string;
+    url_private?: string;
+    preview?: string;
+    transcription?: {
+        status?: string;
+        preview?: {
+            content?: string;
+        };
+    };
+    [key: string]: unknown;
+}
 interface SlackEvent {
     type: string;
+    subtype?: string;
     client_msg_id?: string;
     ts?: string;
     event_ts?: string;
@@ -48,10 +63,21 @@ interface SlackEvent {
     user?: string;
     text?: string;
     thread_ts?: string;
+    files?: SlackFile[];
     [key: string]: unknown;
 }
+/**
+ * Extract the text content from a voice message file.
+ * Prefers the transcription preview; falls back to the file preview text.
+ * Returns null if the file is not a voice message or has no transcript.
+ */
+declare function extractVoiceTranscript(file: SlackFile): string | null;
 /**
  * Parse a Slack event into an InboundMessage.
+ *
+ * Handles standard text messages and voice messages (file_share subtype
+ * with audio files). Voice message transcripts are extracted and prefixed
+ * with `[Voice message]`.
  */
 declare function parseSlackEvent(event: SlackEvent): InboundMessage;
 
@@ -78,4 +104,4 @@ interface SlackConfig {
     signingSecret?: string;
 }
 
-export { type BoltClient, SlackAdapter, type SlackConfig, type SlackEvent, createSlackAdapter as default, formatForSlack, parseSlackEvent };
+export { type BoltClient, SlackAdapter, type SlackConfig, type SlackEvent, type SlackFile, createSlackAdapter as default, extractVoiceTranscript, formatForSlack, parseSlackEvent };

package/dist/channels/slack/index.js

@@ -1,6 +1,7 @@
 import {
+  extractVoiceTranscript,
   parseSlackEvent
-} from "../../chunk-QLA6YOFN.js";
+} from "../../chunk-2LGXQPEA.js";
 
 // src/channels/slack/outbound.ts
 function formatForSlack(text) {
@@ -63,7 +64,7 @@ var SlackAdapter = class {
   /** Simulate receiving an inbound message (for testing/webhooks). */
   async receive(event) {
     if (this.onMessage) {
-      const { parseSlackEvent: parseSlackEvent2 } = await import("../../inbound-AFOHYNUY.js");
+      const { parseSlackEvent: parseSlackEvent2 } = await import("../../inbound-CGIXRXGC.js");
       const msg = parseSlackEvent2(event);
       await this.onMessage(msg);
     }
@@ -75,6 +76,7 @@ function createSlackAdapter(client) {
 export {
   SlackAdapter,
   createSlackAdapter as default,
+  extractVoiceTranscript,
   formatForSlack,
   parseSlackEvent
 };

package/dist/chunk-2LGXQPEA.js

@@ -0,0 +1,41 @@
+// src/channels/slack/inbound.ts
+var AUDIO_TYPES = /* @__PURE__ */ new Set(["aac", "mp4", "m4a", "ogg", "webm", "mp3", "wav"]);
+function extractVoiceTranscript(file) {
+  const isAudio = file.subtype === "slack_audio" || AUDIO_TYPES.has(file.filetype ?? "");
+  if (!isAudio) return null;
+  const transcript = file.transcription?.preview?.content ?? (typeof file.preview === "string" ? file.preview : null);
+  return transcript ?? null;
+}
+function parseSlackEvent(event) {
+  const id = event.client_msg_id ?? event.ts ?? event.event_ts ?? `slack-${Date.now()}`;
+  const channel = event.channel ?? "unknown";
+  const from = event.user ?? "unknown";
+  const threadId = event.thread_ts !== void 0 ? event.thread_ts : void 0;
+  const receivedAt = event.ts ? new Date(parseFloat(event.ts) * 1e3).toISOString() : (/* @__PURE__ */ new Date()).toISOString();
+  let body = event.text ?? "";
+  if (event.subtype === "file_share" && event.files?.length) {
+    for (const file of event.files) {
+      const transcript = extractVoiceTranscript(file);
+      if (transcript) {
+        body = body ? `${body}
+
+[Voice message] ${transcript}` : `[Voice message] ${transcript}`;
+        break;
+      }
+    }
+  }
+  return {
+    id,
+    channel,
+    from,
+    body,
+    threadId,
+    receivedAt,
+    raw: event
+  };
+}
+
+export {
+  extractVoiceTranscript,
+  parseSlackEvent
+};

package/dist/inbound-CGIXRXGC.js

@@ -0,0 +1,8 @@
+import {
+  extractVoiceTranscript,
+  parseSlackEvent
+} from "./chunk-2LGXQPEA.js";
+export {
+  extractVoiceTranscript,
+  parseSlackEvent
+};

package/dist/index.d.ts

@@ -324,6 +324,13 @@ declare const AGENT_STATUSES: readonly ["idle", "running", "paused", "terminated
 /** Run status values */
 declare const RUN_STATUSES: readonly ["queued", "running", "succeeded", "failed", "cancelled"];
 
+/** Shared utility functions. */
+/**
+ * Truncate text at a word boundary, appending "..." if truncated.
+ * Returns the original text if it's shorter than maxLen.
+ */
+declare function truncateAtWord(text: string, maxLen: number): string;
+
 type HookHandler = (context: Record<string, unknown>) => Promise<void> | void;
 type Unsubscribe = () => void;
 interface HookOptions {
@@ -1012,6 +1019,8 @@ interface DomainSchemaOptions {
     rules?: boolean;
     /** Include event audit log (default: true) */
     events?: boolean;
+    /** Include cross-domain junction tables (default: true) */
+    junctions?: boolean;
 }
 /**
  * Define standard domain tables that most multi-agent apps need.
@@ -1514,6 +1523,15 @@ declare class SecretStore {
     list(): Promise<SecretMeta[]>;
     rotate(name: string, newValue: string, environment?: string): Promise<void>;
     delete(name: string, environment?: string): Promise<void>;
+    /**
+     * Load a sync cursor by key. Returns undefined if not found.
+     * Cursors are stored as secrets with type='sync_cursor'.
+     */
+    loadCursor(key: string): Promise<string | undefined>;
+    /**
+     * Persist a sync cursor by key. Creates or updates the secret.
+     */
+    saveCursor(key: string, value: string): Promise<void>;
     private _toMeta;
 }
 
@@ -1549,4 +1567,4 @@ 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, ConnectorConfig, 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, 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 Schedule, type ScheduleDef, Scheduler, 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 };
+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, ConnectorConfig, 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, 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 Schedule, type ScheduleDef, Scheduler, 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, truncateAtWord, validateConfig };

package/dist/index.js

@@ -75,6 +75,15 @@ var RUN_STATUSES = [
   "cancelled"
 ];
 
+// src/shared/utils.ts
+function truncateAtWord(text, maxLen) {
+  if (text.length <= maxLen) return text;
+  const truncated = text.slice(0, maxLen);
+  const lastSpace = truncated.lastIndexOf(" ");
+  const cutPoint = lastSpace > maxLen * 0.5 ? lastSpace : maxLen;
+  return truncated.slice(0, cutPoint) + "...";
+}
+
 // src/core/hooks/hook-bus.ts
 var HookBus = class {
   registrations = /* @__PURE__ */ new Map();
@@ -1763,7 +1772,7 @@ ${s.definition}` : null,
         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);
+        const preview = truncateAtWord(r.body ?? "", 80);
         return `- ${dir} **${who}** (${time}): ${preview}`;
       });
       return `# Messages
@@ -1810,6 +1819,7 @@ function defineDomainTables(db, options = {}) {
     channels: true,
     rules: true,
     events: true,
+    junctions: true,
     ...options
   };
   db.define("org", {
@@ -1837,6 +1847,8 @@ function defineDomainTables(db, options = {}) {
       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",
@@ -1877,6 +1889,7 @@ function defineDomainTables(db, options = {}) {
         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",
@@ -1954,6 +1967,7 @@ function defineDomainTables(db, options = {}) {
         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",
@@ -1987,6 +2001,8 @@ function defineDomainTables(db, options = {}) {
         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"
@@ -2030,6 +2046,7 @@ function defineDomainTables(db, options = {}) {
         actor_user_id: "TEXT",
         project_id: "TEXT",
         channel_id: "TEXT",
+        source: "TEXT",
         created_at: "TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP",
         deleted_at: "TEXT"
       },
@@ -2039,6 +2056,58 @@ function defineDomainTables(db, options = {}) {
       ]
     });
   }
+  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"]
+    });
+  }
 }
 
 // src/core/data/domain-entity-contexts.ts
@@ -2151,7 +2220,32 @@ ${lines.join("\n\n")}
           },
           omitIfEmpty: true
         }
-      } : {}
+      } : {},
+      "MESSAGES.md": {
+        source: {
+          type: "hasMany",
+          table: "messages",
+          foreignKey: "project_id",
+          orderBy: "created_at",
+          limit: 100
+        },
+        render: (rows) => {
+          if (!rows.length) return "# Messages\n\nNo messages.\n";
+          const lines = rows.map((r) => {
+            const dir = r.direction === "inbound" ? "\u2192" : "\u2190";
+            const ts = (r.created_at ?? "").slice(0, 16);
+            const agent = r.from_agent ? ` [${r.from_agent}]` : "";
+            const body = r.body ?? "";
+            const preview = truncateAtWord(body, 150);
+            return `- ${dir} **${ts}**${agent} ${preview}`;
+          });
+          return `# Messages
+
+${lines.join("\n")}
+`;
+        },
+        omitIfEmpty: false
+      }
     }
   });
   if (opts.clients) {
@@ -4039,6 +4133,44 @@ var SecretStore = class {
     });
     await this.hooks.emit("secret.deleted", { name, environment });
   }
+  // ── Cursor persistence helpers ──────────────────────────────────
+  /**
+   * Load a sync cursor by key. Returns undefined if not found.
+   * Cursors are stored as secrets with type='sync_cursor'.
+   */
+  async loadCursor(key) {
+    const name = `sync-cursor:${key}`;
+    const rows = await this.db.query("secrets", {
+      where: { name },
+      filters: [{ col: "deleted_at", op: "isNull" }],
+      limit: 1
+    });
+    return rows[0]?.value ?? void 0;
+  }
+  /**
+   * Persist a sync cursor by key. Creates or updates the secret.
+   */
+  async saveCursor(key, value) {
+    const name = `sync-cursor:${key}`;
+    const rows = await this.db.query("secrets", {
+      where: { name },
+      filters: [{ col: "deleted_at", op: "isNull" }],
+      limit: 1
+    });
+    if (rows.length > 0) {
+      await this.db.update("secrets", rows[0].id, {
+        value,
+        updated_at: (/* @__PURE__ */ new Date()).toISOString()
+      });
+    } else {
+      await this.db.insert("secrets", {
+        id: uuidv42(),
+        name,
+        type: "sync_cursor",
+        value
+      });
+    }
+  }
   _toMeta(row) {
     return {
       id: row.id,
@@ -4213,5 +4345,6 @@ export {
   runPackageMigrations,
   sanitize,
   topologicalSort,
+  truncateAtWord,
   validateConfig
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botinabox",
-  "version": "0.6.0",
+  "version": "1.1.0",
   "description": "Bot in a Box — framework for building multi-agent bots",
   "type": "module",
   "main": "./dist/index.js",
@@ -59,7 +59,7 @@
     "@types/uuid": "^10.0.0",
     "ajv": "^8.17.1",
     "cron-parser": "^4.9.0",
-    "latticesql": "^0.18.0",
+    "latticesql": "^1.0.0",
     "uuid": "^13.0.0",
     "yaml": "^2.7.0"
   },