botinabox 2.5.0 → 2.5.2

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

@@ -0,0 +1,11 @@
+export interface PackageUpdate {
+    name: string;
+    installedVersion: string;
+    latestVersion: string;
+    updateType: 'patch' | 'minor' | 'major';
+}
+export interface UpdateManifest {
+    checkedAt: string;
+    packages: PackageUpdate[];
+    hasUpdates: boolean;
+}

package/dist/core/update/types.js

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

package/dist/core/update/update-checker.d.ts

@@ -0,0 +1,11 @@
+import type { UpdateManifest } from './types.js';
+export declare class UpdateChecker {
+    private nodeModulesPath;
+    private opts?;
+    private readonly fetchFn;
+    constructor(nodeModulesPath: string, opts?: {
+        fetch?: typeof globalThis.fetch;
+    } | undefined);
+    getInstalledPackages(): string[];
+    check(packageNames?: string[]): Promise<UpdateManifest>;
+}

package/dist/core/update/update-checker.js

@@ -0,0 +1,63 @@
+import { readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { classifyUpdate, compareVersions } from './version-utils.js';
+export class UpdateChecker {
+    nodeModulesPath;
+    opts;
+    fetchFn;
+    constructor(nodeModulesPath, opts) {
+        this.nodeModulesPath = nodeModulesPath;
+        this.opts = opts;
+        this.fetchFn = opts?.fetch ?? globalThis.fetch;
+    }
+    getInstalledPackages() {
+        try {
+            const botinaboxPath = join(this.nodeModulesPath, '@botinabox');
+            const entries = readdirSync(botinaboxPath, { withFileTypes: true });
+            return entries
+                .filter((e) => e.isDirectory())
+                .map((e) => e.name);
+        }
+        catch {
+            return [];
+        }
+    }
+    async check(packageNames) {
+        const installed = packageNames ?? this.getInstalledPackages();
+        const updates = [];
+        for (const pkg of installed) {
+            try {
+                const pkgJsonPath = join(this.nodeModulesPath, '@botinabox', pkg, 'package.json');
+                const pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+                const installedVersion = pkgJson.version ?? '0.0.0';
+                const response = await this.fetchFn(`https://registry.npmjs.org/@botinabox/${pkg}`);
+                if (!response.ok)
+                    continue;
+                const data = await response.json();
+                const latestVersion = data['dist-tags']?.['latest'];
+                if (!latestVersion)
+                    continue;
+                if (compareVersions(latestVersion, installedVersion) > 0) {
+                    const updateType = classifyUpdate(installedVersion, latestVersion);
+                    if (updateType !== 'none') {
+                        updates.push({
+                            name: `@botinabox/${pkg}`,
+                            installedVersion,
+                            latestVersion,
+                            updateType,
+                        });
+                    }
+                }
+            }
+            catch {
+                // Gracefully skip on error
+                continue;
+            }
+        }
+        return {
+            checkedAt: new Date().toISOString(),
+            packages: updates,
+            hasUpdates: updates.length > 0,
+        };
+    }
+}

package/dist/core/update/update-manager.d.ts

@@ -0,0 +1,25 @@
+import type { DataStore } from '../data/data-store.js';
+import type { HookBus } from '../hooks/hook-bus.js';
+import type { PackageUpdate, UpdateManifest } from './types.js';
+import { UpdateChecker } from './update-checker.js';
+type UpdatePolicy = 'auto-all' | 'auto-compatible' | 'auto-patch' | 'notify' | 'manual';
+export declare class UpdateManager {
+    private checker;
+    private db;
+    private hooks;
+    private opts?;
+    private backupManager;
+    constructor(checker: UpdateChecker, db: DataStore, hooks: HookBus, opts?: {
+        projectRoot?: string;
+        policy?: UpdatePolicy;
+        maintenanceWindow?: {
+            utcHourStart: number;
+            utcHourEnd: number;
+        };
+    } | undefined);
+    checkAndNotify(): Promise<UpdateManifest>;
+    applyUpdates(updates: PackageUpdate[]): Promise<void>;
+    isInMaintenanceWindow(): boolean;
+    filterByPolicy(updates: PackageUpdate[]): PackageUpdate[];
+}
+export {};

package/dist/core/update/update-manager.js

@@ -0,0 +1,101 @@
+import { execSync } from 'child_process';
+import { BackupManager } from './backup-manager.js';
+export class UpdateManager {
+    checker;
+    db;
+    hooks;
+    opts;
+    backupManager;
+    constructor(checker, db, hooks, opts) {
+        this.checker = checker;
+        this.db = db;
+        this.hooks = hooks;
+        this.opts = opts;
+        this.backupManager = new BackupManager(opts?.projectRoot ?? process.cwd());
+    }
+    async checkAndNotify() {
+        const manifest = await this.checker.check();
+        if (manifest.hasUpdates) {
+            await this.hooks.emit('update.available', { manifest });
+        }
+        return manifest;
+    }
+    async applyUpdates(updates) {
+        const filtered = this.filterByPolicy(updates);
+        if (filtered.length === 0)
+            return;
+        if (!this.isInMaintenanceWindow()) {
+            await this.hooks.emit('update.deferred', { reason: 'outside maintenance window' });
+            return;
+        }
+        let backupPath;
+        const historyIds = [];
+        try {
+            backupPath = await this.backupManager.backup();
+            for (const update of filtered) {
+                const row = await this.db.insert('update_history', {
+                    from_version: update.installedVersion,
+                    to_version: update.latestVersion,
+                    status: 'pending',
+                });
+                historyIds.push(row['id']);
+            }
+            execSync('pnpm install', {
+                cwd: this.opts?.projectRoot ?? process.cwd(),
+                stdio: 'ignore',
+            });
+            for (const id of historyIds) {
+                await this.db.update('update_history', { id }, { status: 'succeeded' });
+            }
+            await this.backupManager.cleanup(backupPath);
+            await this.hooks.emit('update.completed', { updates: filtered });
+        }
+        catch (err) {
+            for (const id of historyIds) {
+                await this.db.update('update_history', { id }, {
+                    status: 'failed',
+                    migration_log: String(err),
+                });
+            }
+            if (backupPath) {
+                try {
+                    await this.backupManager.restore(backupPath);
+                    await this.backupManager.cleanup(backupPath);
+                }
+                catch {
+                    // best effort restore
+                }
+            }
+            await this.hooks.emit('update.failed', { updates: filtered, error: String(err) });
+        }
+    }
+    isInMaintenanceWindow() {
+        const window = this.opts?.maintenanceWindow;
+        if (!window)
+            return true; // No window configured = always allowed
+        const nowHour = new Date().getUTCHours();
+        const { utcHourStart, utcHourEnd } = window;
+        if (utcHourStart <= utcHourEnd) {
+            return nowHour >= utcHourStart && nowHour < utcHourEnd;
+        }
+        else {
+            // Wraps midnight
+            return nowHour >= utcHourStart || nowHour < utcHourEnd;
+        }
+    }
+    filterByPolicy(updates) {
+        const policy = this.opts?.policy ?? 'notify';
+        switch (policy) {
+            case 'auto-all':
+                return updates;
+            case 'auto-compatible':
+                return updates.filter((u) => u.updateType !== 'major');
+            case 'auto-patch':
+                return updates.filter((u) => u.updateType === 'patch');
+            case 'notify':
+            case 'manual':
+            default:
+                return [];
+        }
+    }
+}

package/dist/core/update/version-utils.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Simple semver utilities — no external deps.
+ */
+export declare function parseVersion(v: string): [number, number, number];
+export declare function compareVersions(a: string, b: string): -1 | 0 | 1;
+export declare function classifyUpdate(from: string, to: string): 'patch' | 'minor' | 'major' | 'none';

package/dist/core/update/version-utils.js

@@ -0,0 +1,34 @@
+/**
+ * Simple semver utilities — no external deps.
+ */
+export function parseVersion(v) {
+    // Strip leading 'v' and any pre-release suffix
+    const cleaned = v.replace(/^v/, '').split('-')[0] ?? v;
+    const parts = cleaned.split('.');
+    const major = parseInt(parts[0] ?? '0', 10) || 0;
+    const minor = parseInt(parts[1] ?? '0', 10) || 0;
+    const patch = parseInt(parts[2] ?? '0', 10) || 0;
+    return [major, minor, patch];
+}
+export function compareVersions(a, b) {
+    const [aMaj, aMin, aPat] = parseVersion(a);
+    const [bMaj, bMin, bPat] = parseVersion(b);
+    if (aMaj !== bMaj)
+        return aMaj < bMaj ? -1 : 1;
+    if (aMin !== bMin)
+        return aMin < bMin ? -1 : 1;
+    if (aPat !== bPat)
+        return aPat < bPat ? -1 : 1;
+    return 0;
+}
+export function classifyUpdate(from, to) {
+    const [fMaj, fMin] = parseVersion(from);
+    const [tMaj, tMin] = parseVersion(to);
+    if (compareVersions(from, to) === 0)
+        return 'none';
+    if (tMaj !== fMaj)
+        return 'major';
+    if (tMin !== fMin)
+        return 'minor';
+    return 'patch';
+}

package/dist/gmail-connector-2FVYTQJH.js

@@ -0,0 +1,6 @@
+import {
+  GoogleGmailConnector
+} from "./chunk-DSNJKNEW.js";
+export {
+  GoogleGmailConnector
+};

package/dist/gmail-connector-MNUBRNFM.js

@@ -0,0 +1,6 @@
+import {
+  GoogleGmailConnector
+} from "./chunk-3X3YKI4T.js";
+export {
+  GoogleGmailConnector
+};

package/dist/gmail-connector-PS2VLGNE.js

@@ -0,0 +1,6 @@
+import {
+  GoogleGmailConnector
+} from "./chunk-UACT2WXX.js";
+export {
+  GoogleGmailConnector
+};

package/dist/gmail-connector-ULSMN6X2.js

@@ -0,0 +1,6 @@
+import {
+  GoogleGmailConnector
+} from "./chunk-XYF5PSB2.js";
+export {
+  GoogleGmailConnector
+};

package/dist/gmail-connector-URRFX6A3.js

@@ -0,0 +1,6 @@
+import {
+  GoogleGmailConnector
+} from "./chunk-D47AIFOD.js";
+export {
+  GoogleGmailConnector
+};

package/dist/inbound-AFBUPSPG.js

@@ -0,0 +1,10 @@
+import {
+  enrichVoiceMessage,
+  extractVoiceTranscript,
+  parseSlackEvent
+} from "./chunk-GS2JFL6I.js";
+export {
+  enrichVoiceMessage,
+  extractVoiceTranscript,
+  parseSlackEvent
+};

package/dist/inbound-AFOHYNUY.js

@@ -0,0 +1,6 @@
+import {
+  parseSlackEvent
+} from "./chunk-QLA6YOFN.js";
+export {
+  parseSlackEvent
+};

package/dist/inbound-CGIXRXGC.js

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

package/dist/inbound-MCOLRH6U.js

@@ -0,0 +1,10 @@
+import {
+  enrichVoiceMessage,
+  extractVoiceTranscript,
+  parseSlackEvent
+} from "./chunk-J6S6QMUY.js";
+export {
+  enrichVoiceMessage,
+  extractVoiceTranscript,
+  parseSlackEvent
+};

package/dist/inbound-SNEMBLGA.js

@@ -0,0 +1,6 @@
+import {
+  parseDiscordEvent
+} from "./chunk-DLJKZD3Q.js";
+export {
+  parseDiscordEvent
+};

package/dist/inbound-ZJHAYVMF.js

@@ -0,0 +1,10 @@
+import {
+  enrichVoiceMessage,
+  extractVoiceTranscript,
+  parseSlackEvent
+} from "./chunk-NNPCKR6G.js";
+export {
+  enrichVoiceMessage,
+  extractVoiceTranscript,
+  parseSlackEvent
+};

package/dist/index.d.ts

@@ -2166,6 +2166,16 @@ declare const searchConversationTool: {
     handler: ToolHandler;
 };
 
+/**
+ * Shared agent resolution: slug → role → name (case-insensitive).
+ *
+ * LLMs see list_agents output like "AgentName (role)" and naturally use
+ * the role as the identifier. All agent-resolving tools must accept
+ * slug, role, OR name — not just slug.
+ */
+
+declare function resolveAgent(db: DataStore, ref: string): Promise<Record<string, unknown> | null>;
+
 /**
  * Built-in tools: Entity creation — agents, projects.
  */
@@ -2290,4 +2300,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, type ApprovalResponse, type ApprovalStatus, AuditEmitter, type AuditEvent, BackupManager, type BotConfig, BreakerState, type BudgetCheck, type BudgetConfig, BudgetController, CORE_MIGRATIONS, ChannelAdapter, ChannelRegistry, ChannelRegistryError, type ChatConfig, ChatMessage, ChatPipelineV2, type ChatPipelineV2Config, ChatResponder, ChatResponderConfig, ChatSessionManager, CircuitBreaker, type CircuitBreakerConfig, CliExecutionAdapter, type ColumnValidator, ColumnValidatorImpl, type ConfigLoadError, type ConfigLoadResult, ConnectorConfig, DEFAULTS, DEFAULT_CONFIG, type DataConfig, DataStore, type DefaultLLMCallConfig, DeterministicAdapter, type DeterministicConfig, type DomainEntityContextOptions, type DomainSchemaOptions, DriftGate, EVENTS, type EntityColumnDef, type EntityConfig, type ExecutionAdapter, type ExecutionConfig, type ExecutionEngineConfig, Extractor, type FeedbackEntry, type GateFinding, type GateInput, type GateResult, GateRunner, type GateVerdict, GovernanceGate, HealthStatus, HookBus, InboundMessage, LLMProvider, LearningPipeline, type LearningPipelineConfig, type LoopDetection, LoopDetector, type LoopDetectorConfig, LoopType, MAX_CHAIN_DEPTH, MessageInterpreter, MessagePipeline, MessageStore, type ModelConfig, ModelInfo, ModelRouter, NdjsonLogger, NotificationQueue, type PackageMigration, type PackageUpdate, type ParsedStream, type PermissionPrompt, type PermissionProvider, PermissionRelay, type PermissionRelayConfig, type PlaybookEntry, ProviderRegistry, QAGate, QualityGate, RUN_STATUSES, type RenderConfig, ResolvedModel, type RetryPolicy, type RoutingConfig, type RunContext, RunManager, type RunResult, type RunStatus, type SafetyConfig, type SanitizerOptions, type Schedule, type ScheduleDef, Scheduler, type SchemaError, type SecretInput, type SecretMeta, SecretStore, type SecurityConfig, SessionKey, SessionManager, type SkillEntry, type StepRef, type SystemContextOptions, TASK_STATUSES, type TaskDefinition, TaskQueue, type TaskRecord, type TaskStatus, TokenUsage, type ToolContext, type ToolDefinition, type ToolHandler, 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, addTaskCommentTool, areDependenciesMet, autoUpdate, buildAgentBindings, buildChainOrigin, buildProcessEnv, buildSystemContext, cancelTaskTool, checkAllowlist, checkChainDepth, checkMentionGate, chunkText, classifyUpdate, compareVersions, coordinatorTools, createAgentTool, createConfigRevision, createDefaultLLMCall, createProjectTool, deactivateLocalImagePaths, defineCoreEntityContexts, defineCoreTables, defineDomainEntityContexts, defineDomainTables, detectCycle, discoverChannels, discoverProviders, dispatchTaskTool, formatText, getActiveTasksTool, getAgentDetailTool, getAgentStatusTool, getConfig, getSystemStatusTool, getTaskStatusTool, initConfig, interpolate, interpolateEnv, isLoginRequired, isMaxTurns, listAgentsTool, listFilesTool, listProjectsTool, loadConfig, nativeTools, parseClaudeStream, parseVersion, readConversationTool, readFileTool, reassignTaskTool, registerExecutionEngine, registerFileTool, runPackageMigrations, sanitize, searchConversationTool, sendFileTool, sendMessageTool, topologicalSort, truncateAtWord, validateConfig };
+export { AGENT_STATUSES, type AgentConfig, type AgentDefinition, type AgentFilter, type AgentRecord, AgentRegistry, type AgentStatus, ApiExecutionAdapter, type ApprovalResponse, type ApprovalStatus, AuditEmitter, type AuditEvent, BackupManager, type BotConfig, BreakerState, type BudgetCheck, type BudgetConfig, BudgetController, CORE_MIGRATIONS, ChannelAdapter, ChannelRegistry, ChannelRegistryError, type ChatConfig, ChatMessage, ChatPipelineV2, type ChatPipelineV2Config, ChatResponder, ChatResponderConfig, ChatSessionManager, CircuitBreaker, type CircuitBreakerConfig, CliExecutionAdapter, type ColumnValidator, ColumnValidatorImpl, type ConfigLoadError, type ConfigLoadResult, ConnectorConfig, DEFAULTS, DEFAULT_CONFIG, type DataConfig, DataStore, type DefaultLLMCallConfig, DeterministicAdapter, type DeterministicConfig, type DomainEntityContextOptions, type DomainSchemaOptions, DriftGate, EVENTS, type EntityColumnDef, type EntityConfig, type ExecutionAdapter, type ExecutionConfig, type ExecutionEngineConfig, Extractor, type FeedbackEntry, type GateFinding, type GateInput, type GateResult, GateRunner, type GateVerdict, GovernanceGate, HealthStatus, HookBus, InboundMessage, LLMProvider, LearningPipeline, type LearningPipelineConfig, type LoopDetection, LoopDetector, type LoopDetectorConfig, LoopType, MAX_CHAIN_DEPTH, MessageInterpreter, MessagePipeline, MessageStore, type ModelConfig, ModelInfo, ModelRouter, NdjsonLogger, NotificationQueue, type PackageMigration, type PackageUpdate, type ParsedStream, type PermissionPrompt, type PermissionProvider, PermissionRelay, type PermissionRelayConfig, type PlaybookEntry, ProviderRegistry, QAGate, QualityGate, RUN_STATUSES, type RenderConfig, ResolvedModel, type RetryPolicy, type RoutingConfig, type RunContext, RunManager, type RunResult, type RunStatus, type SafetyConfig, type SanitizerOptions, type Schedule, type ScheduleDef, Scheduler, type SchemaError, type SecretInput, type SecretMeta, SecretStore, type SecurityConfig, SessionKey, SessionManager, type SkillEntry, type StepRef, type SystemContextOptions, TASK_STATUSES, type TaskDefinition, TaskQueue, type TaskRecord, type TaskStatus, TokenUsage, type ToolContext, type ToolDefinition, type ToolHandler, 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, addTaskCommentTool, areDependenciesMet, autoUpdate, buildAgentBindings, buildChainOrigin, buildProcessEnv, buildSystemContext, cancelTaskTool, checkAllowlist, checkChainDepth, checkMentionGate, chunkText, classifyUpdate, compareVersions, coordinatorTools, createAgentTool, createConfigRevision, createDefaultLLMCall, createProjectTool, deactivateLocalImagePaths, defineCoreEntityContexts, defineCoreTables, defineDomainEntityContexts, defineDomainTables, detectCycle, discoverChannels, discoverProviders, dispatchTaskTool, formatText, getActiveTasksTool, getAgentDetailTool, getAgentStatusTool, getConfig, getSystemStatusTool, getTaskStatusTool, initConfig, interpolate, interpolateEnv, isLoginRequired, isMaxTurns, listAgentsTool, listFilesTool, listProjectsTool, loadConfig, nativeTools, parseClaudeStream, parseVersion, readConversationTool, readFileTool, reassignTaskTool, registerExecutionEngine, registerFileTool, resolveAgent, runPackageMigrations, sanitize, searchConversationTool, sendFileTool, sendMessageTool, topologicalSort, truncateAtWord, validateConfig };

package/dist/index.js

@@ -6685,6 +6685,25 @@ var registerFileTool = {
 
 // src/core/orchestrator/tools/task-ops.ts
 import { randomUUID as randomUUID2 } from "crypto";
+
+// src/core/orchestrator/tools/resolve-agent.ts
+async function resolveAgent(db, ref) {
+  const bySlug = await db.query("agents", { where: { slug: ref } });
+  if (bySlug[0] && !bySlug[0].deleted_at) return bySlug[0];
+  const byRole = await db.query("agents", { where: { role: ref } });
+  const activeByRole = byRole.find((a) => !a.deleted_at);
+  if (activeByRole) return activeByRole;
+  const byName = await db.query("agents", { where: { name: ref } });
+  const activeByName = byName.find((a) => !a.deleted_at);
+  if (activeByName) return activeByName;
+  const lower = ref.toLowerCase();
+  const all = await db.query("agents");
+  return all.find(
+    (a) => !a.deleted_at && (a.slug?.toLowerCase() === lower || a.role?.toLowerCase() === lower || a.name?.toLowerCase() === lower)
+  ) ?? null;
+}
+
+// src/core/orchestrator/tools/task-ops.ts
 var dispatchTaskTool = {
   definition: {
     name: "dispatch_task",
@@ -6694,15 +6713,14 @@ var dispatchTaskTool = {
       properties: {
         title: { type: "string", description: "Short task title" },
         description: { type: "string", description: "Detailed task description" },
-        agent_slug: { type: "string", description: 'Agent slug to assign to (e.g. "engineer", "qa")' },
+        agent_slug: { type: "string", description: 'Agent slug, role, or name (e.g. "eddy", "engineer", "Eddy")' },
         priority: { type: "number", description: "Priority 1-10 (lower = higher priority). Default: 5" }
       },
       required: ["title", "agent_slug"]
     }
   },
   handler: async (input, ctx) => {
-    const agents = await ctx.db.query("agents", { where: { slug: input.agent_slug } });
-    const agent = agents[0];
+    const agent = await resolveAgent(ctx.db, input.agent_slug);
     if (!agent) return `Error: agent "${input.agent_slug}" not found.`;
     const row = await ctx.db.insert("tasks", {
       id: randomUUID2(),
@@ -6742,7 +6760,7 @@ var reassignTaskTool = {
       type: "object",
       properties: {
         task_id: { type: "string", description: "Task ID to reassign" },
-        new_agent_slug: { type: "string", description: "Agent slug to reassign to" }
+        new_agent_slug: { type: "string", description: "Agent slug, role, or name to reassign to" }
       },
       required: ["task_id", "new_agent_slug"]
     }
@@ -6750,8 +6768,7 @@ var reassignTaskTool = {
   handler: async (input, ctx) => {
     const task = await ctx.db.get("tasks", { id: input.task_id });
     if (!task) return `Error: task ${input.task_id} not found.`;
-    const agents = await ctx.db.query("agents", { where: { slug: input.new_agent_slug } });
-    const newAgent = agents[0];
+    const newAgent = await resolveAgent(ctx.db, input.new_agent_slug);
     if (!newAgent) return `Error: agent "${input.new_agent_slug}" not found.`;
     await ctx.db.update("tasks", { id: input.task_id }, { status: "cancelled" });
     const row = await ctx.db.insert("tasks", {
@@ -6799,14 +6816,13 @@ var getAgentStatusTool = {
     input_schema: {
       type: "object",
       properties: {
-        agent_slug: { type: "string", description: 'Agent slug (e.g. "engineer")' }
+        agent_slug: { type: "string", description: 'Agent slug, role, or name (e.g. "eddy", "engineer", "Eddy")' }
       },
       required: ["agent_slug"]
     }
   },
   handler: async (input, ctx) => {
-    const agents = await ctx.db.query("agents", { where: { slug: input.agent_slug } });
-    const agent = agents[0];
+    const agent = await resolveAgent(ctx.db, input.agent_slug);
     if (!agent) return `Agent "${input.agent_slug}" not found.`;
     const tasks = await ctx.db.query("tasks", { where: { assignee_id: agent.id, status: "todo" } });
     const runs = await ctx.db.query("runs", { where: { agent_id: agent.id }, limit: 5 });
@@ -6890,8 +6906,7 @@ var getAgentDetailTool = {
     }
   },
   handler: async (input, ctx) => {
-    const agents = await ctx.db.query("agents", { where: { slug: input.agent_slug } });
-    const agent = agents[0];
+    const agent = await resolveAgent(ctx.db, input.agent_slug);
     if (!agent) return `Agent "${input.agent_slug}" not found.`;
     const skills = await ctx.db.query("agent_skills", { where: { agent_id: agent.id } }).catch(() => []);
     const skillNames = [];
@@ -7567,6 +7582,7 @@ export {
   reassignTaskTool,
   registerExecutionEngine,
   registerFileTool,
+  resolveAgent,
   runPackageMigrations,
   sanitize,
   searchConversationTool,

package/dist/provider-qqJYv9nv.d.ts

@@ -0,0 +1,75 @@
+/** LLM provider types — Story 1.5 / 2.1 */
+interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+interface ChatMessage {
+    role: "user" | "assistant" | "system";
+    content: string | ContentBlock[];
+}
+type ContentBlock = {
+    type: "text";
+    text: string;
+} | {
+    type: "tool_use";
+    id: string;
+    name: string;
+    input: unknown;
+} | {
+    type: "tool_result";
+    tool_use_id: string;
+    content: string;
+};
+interface ChatParams {
+    messages: ChatMessage[];
+    system?: string;
+    tools?: ToolDefinition[];
+    maxTokens?: number;
+    temperature?: number;
+    model: string;
+    abortSignal?: AbortSignal;
+}
+interface TokenUsage {
+    inputTokens: number;
+    outputTokens: number;
+    cacheReadTokens?: number;
+    cacheWriteTokens?: number;
+}
+interface ChatResult {
+    content: string;
+    toolUses?: ToolUse[];
+    usage: TokenUsage;
+    model: string;
+    stopReason: "end_turn" | "tool_use" | "max_tokens" | "stop_sequence";
+}
+interface ToolUse {
+    id: string;
+    name: string;
+    input: unknown;
+}
+interface ModelInfo {
+    id: string;
+    displayName: string;
+    contextWindow: number;
+    maxOutputTokens: number;
+    capabilities: Array<"chat" | "tools" | "vision" | "streaming">;
+    /** Cost in micro-cents per 1M tokens */
+    inputCostPerMToken?: number;
+    outputCostPerMToken?: number;
+}
+interface ResolvedModel {
+    provider: string;
+    model: string;
+}
+interface LLMProvider {
+    id: string;
+    displayName: string;
+    models: ModelInfo[];
+    chat(params: ChatParams): Promise<ChatResult>;
+    chatStream(params: ChatParams): AsyncGenerator<string, ChatResult, unknown>;
+    /** Convert ToolDefinition[] to provider-native format */
+    serializeTools(tools: ToolDefinition[]): unknown;
+}
+
+export type { ChatMessage as C, LLMProvider as L, ModelInfo as M, ResolvedModel as R, TokenUsage as T, ChatParams as a, ChatResult as b, ContentBlock as c, ToolDefinition as d, ToolUse as e };

package/dist/providers/anthropic/models.d.ts

@@ -0,0 +1,2 @@
+import type { ModelInfo } from "../../shared/index.js";
+export declare const MODELS: ModelInfo[];

package/dist/providers/anthropic/models.js

@@ -0,0 +1,29 @@
+export const MODELS = [
+    {
+        id: 'claude-opus-4-6',
+        displayName: 'Claude Opus 4.6',
+        contextWindow: 200000,
+        maxOutputTokens: 32000,
+        inputCostPerMToken: 15,
+        outputCostPerMToken: 75,
+        capabilities: ['chat', 'tools', 'vision', 'streaming'],
+    },
+    {
+        id: 'claude-sonnet-4-6',
+        displayName: 'Claude Sonnet 4.6',
+        contextWindow: 200000,
+        maxOutputTokens: 16000,
+        inputCostPerMToken: 3,
+        outputCostPerMToken: 15,
+        capabilities: ['chat', 'tools', 'vision', 'streaming'],
+    },
+    {
+        id: 'claude-haiku-4-5',
+        displayName: 'Claude Haiku 4.5',
+        contextWindow: 200000,
+        maxOutputTokens: 8192,
+        inputCostPerMToken: 0.8,
+        outputCostPerMToken: 4,
+        capabilities: ['chat', 'tools', 'vision', 'streaming'],
+    },
+];

package/dist/providers/anthropic/provider.d.ts

@@ -0,0 +1,13 @@
+import type { LLMProvider, ChatParams, ChatResult, ModelInfo, ToolDefinition } from "../../shared/index.js";
+export declare class AnthropicProvider implements LLMProvider {
+    readonly id = "anthropic";
+    readonly displayName = "Anthropic";
+    readonly models: ModelInfo[];
+    private client;
+    constructor({ apiKey }: {
+        apiKey: string;
+    });
+    serializeTools(tools: ToolDefinition[]): unknown;
+    chat(params: ChatParams): Promise<ChatResult>;
+    chatStream(params: ChatParams): AsyncGenerator<string, ChatResult, unknown>;
+}