@sulala/agent 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,149 @@
+/** App config (env + config file) */
+export interface Config {
+    port: number;
+    host: string;
+    dbPath: string;
+    watchFolders: string[];
+    debug: boolean;
+    gatewayApiKey: string | null;
+    webhookUrls: string[];
+    webhookSecret: string | null;
+    rateLimitMax: number;
+    rateLimitWindowMs: number;
+    /** Default system prompt for agent (env AGENT_SYSTEM_PROMPT). */
+    agentSystemPrompt: string | null;
+    /** Default agent run timeout in ms (env AGENT_TIMEOUT_MS). 0 = no timeout. */
+    agentTimeoutMs: number;
+    /** Optional path to file or directory; contents are appended to the agent system prompt (env AGENT_CONTEXT_PATH). */
+    agentContextPath: string | null;
+    /** If set, read_file tool can only read paths under this directory (env AGENT_WORKSPACE_ROOT). */
+    agentWorkspaceRoot: string | null;
+    /** Bundled skills dir, e.g. <project>/context. */
+    skillsBundledDir: string;
+    /** Managed skills dir, e.g. ~/.sulala/skills (env SULALA_SKILLS_DIR). */
+    skillsManagedDir: string;
+    /** Extra skill dirs (env SKILLS_EXTRA_DIRS). */
+    skillsExtraDirs: string[];
+    /** Plugin skill dirs (plugins/name/skills). */
+    skillsPluginDirs: string[];
+    /** Watch skill dirs (env SKILLS_WATCH). */
+    skillsWatch: boolean;
+}
+/** Task row from DB */
+export interface TaskRow {
+    id: string;
+    type: string;
+    payload: string | null;
+    status: string;
+    scheduled_at: number | null;
+    started_at: number | null;
+    finished_at: number | null;
+    retry_count: number;
+    max_retries: number;
+    error: string | null;
+    created_at: number;
+    updated_at: number;
+}
+/** Insert task payload */
+export interface InsertTaskPayload {
+    id: string;
+    type: string;
+    payload?: unknown;
+    scheduled_at?: number | null;
+    max_retries?: number;
+}
+/** Tool call from model */
+export interface ToolCallSpec {
+    id: string;
+    name: string;
+    arguments: string;
+}
+/** AI adapter: one provider */
+export interface AIAdapter {
+    defaultModel: string;
+    complete(opts: {
+        model?: string;
+        messages: Array<{
+            role: string;
+            content?: string | null;
+            tool_calls?: ToolCallSpec[];
+            tool_call_id?: string;
+            name?: string;
+        }>;
+        max_tokens?: number;
+        tools?: Array<{
+            name: string;
+            description: string;
+            parameters?: Record<string, unknown>;
+        }>;
+        signal?: AbortSignal;
+    }): Promise<{
+        content: string;
+        usage?: Record<string, number>;
+        tool_calls?: ToolCallSpec[];
+    }>;
+}
+/** Complete options for orchestrator */
+export interface CompleteOptions {
+    provider?: string;
+    model?: string;
+    messages?: Array<{
+        role: string;
+        content?: string | null;
+        tool_calls?: ToolCallSpec[];
+        tool_call_id?: string;
+        name?: string;
+    }>;
+    max_tokens?: number;
+    task_id?: string | null;
+    tools?: Array<{
+        name: string;
+        description: string;
+        parameters?: Record<string, unknown>;
+    }>;
+    signal?: AbortSignal;
+}
+/** Express app with optional locals */
+export interface AppLocals {
+    wsBroadcast?: (data: unknown) => void;
+    enqueueTaskId?: (id: string) => void;
+}
+/** Agent session (DB row) */
+export interface AgentSessionRow {
+    id: string;
+    session_key: string;
+    meta: string | null;
+    created_at: number;
+    updated_at: number;
+}
+/** Agent message (DB row or in-memory) */
+export interface AgentMessageRow {
+    id?: number;
+    session_id: string;
+    role: string;
+    content: string | null;
+    tool_calls: string | null;
+    tool_call_id: string | null;
+    name: string | null;
+    created_at: number;
+}
+/** Message format for AI / agent loop */
+export interface AgentTurnMessage {
+    role: string;
+    content?: string | null;
+    tool_calls?: Array<{
+        id: string;
+        name: string;
+        arguments: string;
+    }>;
+    tool_call_id?: string;
+    name?: string;
+}
+/** Tool definition for registry */
+export interface ToolDef {
+    name: string;
+    description: string;
+    parameters?: Record<string, unknown>;
+    execute: (args: Record<string, unknown>) => Promise<unknown> | unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/watcher/index.d.ts

@@ -0,0 +1,15 @@
+import { type FSWatcher } from 'chokidar';
+export interface FileEventPayload {
+    event: string;
+    path: string;
+    ts: number;
+    mtimeMs?: number;
+    size?: number;
+}
+export declare function setEventCallback(fn: (payload: FileEventPayload) => void): void;
+export declare function startWatcher(folders?: string[] | null, options?: {
+    ignoreInitial?: boolean;
+}): FSWatcher | null;
+export declare function enqueueTaskOnEvent(payload: FileEventPayload): void;
+export declare function stopWatcher(): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/watcher/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"AAAA,OAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AAMpD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAKD,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI,CAE9E;AA0BD,wBAAgB,YAAY,CAC1B,OAAO,GAAE,MAAM,EAAE,GAAG,IAAW,EAC/B,OAAO,GAAE;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GACxC,SAAS,GAAG,IAAI,CAwClB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAOlE;AAED,wBAAgB,WAAW,IAAI,IAAI,CAKlC"}

package/dist/watcher/index.js

@@ -0,0 +1,87 @@
+import chokidar from 'chokidar';
+import { statSync } from 'fs';
+import { config } from '../config.js';
+import { initDb, getDb, log, upsertFileState, insertTask } from '../db/index.js';
+let watcher = null;
+let eventCallback = null;
+export function setEventCallback(fn) {
+    eventCallback = fn;
+}
+function normalizeEvent(event, path, stats = null) {
+    const payload = { event, path, ts: Date.now() };
+    if (stats) {
+        payload.mtimeMs = stats.mtimeMs;
+        payload.size = stats.size;
+    }
+    return payload;
+}
+function emit(event, path, stats) {
+    const payload = normalizeEvent(event, path, stats);
+    try {
+        getDb();
+        if (event !== 'unlink' && payload.mtimeMs != null) {
+            upsertFileState(path, payload.mtimeMs, payload.size ?? null);
+        }
+        log('watcher', 'info', `${event}: ${path}`, payload);
+        if (eventCallback)
+            eventCallback(payload);
+        return payload;
+    }
+    catch (e) {
+        log('watcher', 'error', e.message, { path, stack: e.stack });
+    }
+}
+export function startWatcher(folders = null, options = {}) {
+    if (watcher)
+        return watcher;
+    initDb(config.dbPath);
+    const paths = folders?.length ? folders : config.watchFolders;
+    if (!paths.length) {
+        log('watcher', 'info', 'No watch folders configured; skipping file watcher');
+        return null;
+    }
+    watcher = chokidar.watch(paths, {
+        ignored: /(^|[/\\])\../,
+        persistent: true,
+        ignoreInitial: options.ignoreInitial !== false,
+        ...options,
+    });
+    watcher
+        .on('add', (path) => {
+        try {
+            const stats = statSync(path);
+            emit('add', path, stats);
+        }
+        catch {
+            emit('add', path, null);
+        }
+    })
+        .on('change', (path) => {
+        try {
+            const stats = statSync(path);
+            emit('change', path, stats);
+        }
+        catch {
+            emit('change', path, null);
+        }
+    })
+        .on('unlink', (path) => emit('unlink', path, null))
+        .on('error', (err) => log('watcher', 'error', err instanceof Error ? err.message : String(err), err instanceof Error ? { stack: err.stack } : null));
+    log('watcher', 'info', 'Watching folders', { paths });
+    return watcher;
+}
+export function enqueueTaskOnEvent(payload) {
+    insertTask({
+        id: `ev_${payload.ts}_${Math.random().toString(36).slice(2, 9)}`,
+        type: 'file_event',
+        payload,
+        max_retries: 2,
+    });
+}
+export function stopWatcher() {
+    if (watcher) {
+        watcher.close();
+        watcher = null;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/watcher/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/watcher/index.ts"],"names":[],"mappings":"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"}

package/dist/webhooks.d.ts

@@ -0,0 +1,2 @@
+export declare function fireWebhooks(eventType: string, payload: unknown): void;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AA6BA,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAatE"}

package/dist/webhooks.js

@@ -0,0 +1,38 @@
+import { config } from './config.js';
+import { log } from './db/index.js';
+const MAX_RETRIES = 3;
+const RETRY_DELAY_MS = 1000;
+async function postWithRetry(url, body, headers, eventType, attempt = 1) {
+    try {
+        const res = await fetch(url, { method: 'POST', headers, body });
+        if (!res.ok && attempt < MAX_RETRIES) {
+            await new Promise((r) => setTimeout(r, RETRY_DELAY_MS * attempt));
+            return postWithRetry(url, body, headers, eventType, attempt + 1);
+        }
+        if (!res.ok)
+            log('webhook', 'warn', `Webhook ${url} returned ${res.status} after ${MAX_RETRIES} tries`, { eventType });
+    }
+    catch (err) {
+        if (attempt < MAX_RETRIES) {
+            await new Promise((r) => setTimeout(r, RETRY_DELAY_MS * attempt));
+            return postWithRetry(url, body, headers, eventType, attempt + 1);
+        }
+        log('webhook', 'error', `Webhook ${url} failed after ${MAX_RETRIES} tries: ${err.message}`, { eventType });
+    }
+}
+export function fireWebhooks(eventType, payload) {
+    const urls = config.webhookUrls ?? [];
+    if (!urls.length)
+        return;
+    const body = JSON.stringify({ event: eventType, payload, ts: Date.now() });
+    const secret = config.webhookSecret ?? null;
+    const headers = {
+        'Content-Type': 'application/json',
+        'User-Agent': 'Sulala-Agent-Webhook',
+        ...(secret && { 'X-Webhook-Secret': secret }),
+    };
+    for (const url of urls) {
+        postWithRetry(url, body, headers, eventType);
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,WAAW,GAAG,CAAC,CAAC;AACtB,MAAM,cAAc,GAAG,IAAI,CAAC;AAE5B,KAAK,UAAU,aAAa,CAC1B,GAAW,EACX,IAAY,EACZ,OAA+B,EAC/B,SAAiB,EACjB,OAAO,GAAG,CAAC;IAEX,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;YAClE,OAAO,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,aAAa,GAAG,CAAC,MAAM,UAAU,WAAW,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACzH,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;YAC1B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;YAClE,OAAO,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,GAAG,iBAAiB,WAAW,WAAY,GAAa,CAAC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACxH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,OAAgB;IAC9D,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC;IACtC,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO;IACzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,aAAa,IAAI,IAAI,CAAC;IAC5C,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;QAClC,YAAY,EAAE,sBAAsB;QACpC,GAAG,CAAC,MAAM,IAAI,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9C,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@sulala/agent",
+  "version": "0.1.0",
+  "description": "Local AI orchestration platform — file watcher, task scheduler, AI layer, plugins",
+  "type": "module",
+  "main": "src/index.ts",
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "gateway": "tsx src/gateway/server.ts",
+    "dashboard": "cd dashboard && npm run dev",
+    "dashboard:build": "cd dashboard && npm run build",
+    "cli": "tsx src/cli.ts",
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc && cp src/db/schema.sql dist/db/",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint src"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "ai",
+    "orchestration",
+    "automation",
+    "file-watcher",
+    "local"
+  ],
+  "license": "MIT",
+  "files": ["dist", "bin", "src/db/schema.sql"],
+  "prepublishOnly": "pnpm run build",
+  "publishConfig": { "access": "public" },
+  "bin": {
+    "sulala": "bin/sulala.mjs"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.6.0",
+    "chokidar": "^4.0.1",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.5",
+    "express": "^4.21.1",
+    "node-cron": "^3.0.3",
+    "openai": "^6.25.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.3.1",
+    "@types/node-cron": "^3.0.11",
+    "@types/ws": "^8.18.1",
+    "@typescript-eslint/eslint-plugin": "^8.56.1",
+    "@typescript-eslint/parser": "^8.56.1",
+    "eslint": "^10.0.2",
+    "globals": "^17.3.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

package/src/db/schema.sql

@@ -0,0 +1,74 @@
+-- Sulala Agent — SQLite schema
+-- Tasks, Logs, File States, AI Results
+
+CREATE TABLE IF NOT EXISTS tasks (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  payload TEXT,
+  status TEXT NOT NULL DEFAULT 'pending',
+  scheduled_at INTEGER,
+  started_at INTEGER,
+  finished_at INTEGER,
+  retry_count INTEGER DEFAULT 0,
+  max_retries INTEGER DEFAULT 3,
+  error TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS logs (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  source TEXT NOT NULL,
+  level TEXT NOT NULL,
+  message TEXT NOT NULL,
+  meta TEXT,
+  created_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS file_states (
+  path TEXT PRIMARY KEY,
+  mtime_ms INTEGER NOT NULL,
+  size INTEGER,
+  hash TEXT,
+  last_seen INTEGER NOT NULL,
+  meta TEXT
+);
+
+CREATE TABLE IF NOT EXISTS ai_results (
+  id TEXT PRIMARY KEY,
+  provider TEXT NOT NULL,
+  model TEXT,
+  task_id TEXT,
+  request_meta TEXT,
+  response_meta TEXT,
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (task_id) REFERENCES tasks(id)
+);
+
+-- Agent runner: sessions and message history
+CREATE TABLE IF NOT EXISTS agent_sessions (
+  id TEXT PRIMARY KEY,
+  session_key TEXT UNIQUE NOT NULL,
+  meta TEXT,
+  created_at INTEGER NOT NULL,
+  updated_at INTEGER NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS agent_messages (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  session_id TEXT NOT NULL,
+  role TEXT NOT NULL,
+  content TEXT,
+  tool_calls TEXT,
+  tool_call_id TEXT,
+  name TEXT,
+  created_at INTEGER NOT NULL,
+  FOREIGN KEY (session_id) REFERENCES agent_sessions(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_agent_messages_session ON agent_messages(session_id);
+
+CREATE INDEX IF NOT EXISTS idx_tasks_status ON tasks(status);
+CREATE INDEX IF NOT EXISTS idx_tasks_scheduled ON tasks(scheduled_at);
+CREATE INDEX IF NOT EXISTS idx_logs_created ON logs(created_at);
+CREATE INDEX IF NOT EXISTS idx_ai_results_created ON ai_results(created_at);

package/src/index.ts

@@ -0,0 +1,83 @@
+import 'dotenv/config';
+import { createServer } from 'http';
+import { loadFullConfig } from './agent/skills-config.js';
+import { config } from './config.js';
+import { initDb, log } from './db/index.js';
+import { createGateway, attachWebSocket } from './gateway/server.js';
+import { startWatcher, setEventCallback, enqueueTaskOnEvent } from './watcher/index.js';
+import { setTaskHandler, loadPendingFromDb, enqueue } from './scheduler/queue.js';
+import { scheduleCron } from './scheduler/cron.js';
+import { loadAllPlugins, onFileEvent, onTask } from './plugins/index.js';
+import { fireWebhooks } from './webhooks.js';
+import { registerBuiltInTools } from './agent/tools.js';
+import { startSkillsWatcher } from './agent/skills-watcher.js';
+import type { AppLocals } from './types.js';
+
+async function main(): Promise<void> {
+  initDb(config.dbPath);
+  // Inject skill config into process.env so run_command (e.g. curl with $PERIGON_API_KEY) sees them
+  const full = loadFullConfig();
+  const entries = full.skills?.entries;
+  if (entries && typeof entries === 'object') {
+    for (const entry of Object.values(entries)) {
+      if (!entry || typeof entry !== 'object') continue;
+      for (const [key, value] of Object.entries(entry)) {
+        if (key === 'enabled') continue;
+        if (typeof value === 'string' && value.trim() && !process.env[key]) process.env[key] = value;
+      }
+    }
+  }
+  log('main', 'info', 'Starting Sulala Agent', { port: config.port });
+
+  registerBuiltInTools(enqueue);
+
+  const app = createGateway();
+  (app.locals as AppLocals).enqueueTaskId = enqueue;
+  const http = createServer(app);
+  const { broadcast } = attachWebSocket(http);
+  (app.locals as AppLocals).wsBroadcast = broadcast;
+  const server = http.listen(config.port, config.host, () => {
+    console.log(`Gateway http://${config.host}:${config.port} (WS /ws)`);
+  });
+  const shutdown = () => {
+    log('main', 'info', 'Shutting down');
+    server.close(() => {
+      log('main', 'info', 'Gateway closed');
+      process.exit(0);
+    });
+    setTimeout(() => process.exit(1), 10000);
+  };
+  process.on('SIGTERM', shutdown);
+  process.on('SIGINT', shutdown);
+
+  await loadAllPlugins();
+
+  setEventCallback((payload) => {
+    onFileEvent(payload);
+    enqueueTaskOnEvent(payload);
+    broadcast({ type: 'file_event', payload });
+    fireWebhooks('file_event', payload);
+  });
+  startWatcher();
+  startSkillsWatcher(config, (ev) => broadcast(ev));
+
+  setTaskHandler(async (task) => {
+    const handled = await onTask(task);
+    if (handled) return;
+    if (task.type === 'file_event') {
+      log('worker', 'info', 'File event task', (task.payload ?? null) as Record<string, unknown> | null);
+    }
+    broadcast({ type: 'task_done', taskId: task.id });
+    fireWebhooks('task_done', { taskId: task.id, type: task.type });
+  });
+
+  loadPendingFromDb();
+  scheduleCron('* * * * *', 'heartbeat', { ts: Date.now() });
+
+  log('main', 'info', 'Sulala Agent ready');
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});