@amodalai/runtime 0.1.0

package/dist/src/agent/local-server.js

@@ -0,0 +1,158 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import express from 'express';
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { loadRepo } from '@amodalai/core';
+import { AgentSessionManager } from './session-manager.js';
+import { LocalShellExecutor } from './shell-executor-local.js';
+import { ConfigWatcher } from './config-watcher.js';
+import { ProactiveRunner } from './proactive/proactive-runner.js';
+import { createChatRouter } from './routes/chat.js';
+import { createTaskRouter } from './routes/task.js';
+import { createInspectRouter } from './routes/inspect.js';
+import { createAutomationRouter } from './routes/automations.js';
+import { createWebhookRouter } from './routes/webhooks.js';
+import { createStoresRouter } from './routes/stores.js';
+import { errorHandler } from '../middleware/error-handler.js';
+import { createPGLiteStoreBackend } from '../stores/pglite-store-backend.js';
+/**
+ * Creates an Express server for repo-based agent mode.
+ *
+ * Loads the `.amodal/` config from `config.repoPath`, creates a
+ * `AgentSessionManager`, mounts chat/task/inspect/automation/webhook routes,
+ * and optionally watches for config changes (hot reload).
+ */
+export async function createLocalServer(config) {
+    const repo = await loadRepo({ localPath: config.repoPath });
+    // Create shell executor if sandbox.shellExec is enabled
+    const shellExecutor = repo.config.sandbox?.shellExec
+        ? new LocalShellExecutor()
+        : undefined;
+    // Create shared store backend if stores are defined
+    let storeBackend;
+    if (repo.stores.length > 0) {
+        const dataDir = repo.config.stores?.dataDir
+            ?? `${config.repoPath}/.amodal/store-data`;
+        storeBackend = await createPGLiteStoreBackend(repo.stores, dataDir);
+    }
+    const sessionManager = new AgentSessionManager(repo, {
+        ttlMs: config.sessionTtlMs,
+        shellExecutor,
+        storeBackend,
+    });
+    const runner = new ProactiveRunner(repo, {
+        webhookSecret: config.webhookSecret,
+        createSession: async () => sessionManager.create('automation'),
+        destroySession: async (id) => sessionManager.destroy(id),
+    });
+    let watcher = null;
+    const app = express();
+    // CORS
+    const corsOrigin = config.corsOrigin ?? '*';
+    app.use((_req, res, next) => {
+        res.header('Access-Control-Allow-Origin', corsOrigin);
+        res.header('Access-Control-Allow-Headers', 'Origin, X-Requested-With, Content-Type, Accept, Authorization');
+        res.header('Access-Control-Allow-Methods', 'GET, POST, PUT, PATCH, DELETE, OPTIONS');
+        if (_req.method === 'OPTIONS') {
+            res.sendStatus(204);
+            return;
+        }
+        next();
+    });
+    app.use(express.json());
+    // Health
+    const startedAt = Date.now();
+    app.get('/health', (_req, res) => {
+        res.json({
+            status: 'ok',
+            mode: 'repo',
+            repo_path: config.repoPath,
+            uptime_ms: Date.now() - startedAt,
+            active_sessions: sessionManager.size,
+        });
+    });
+    // Routes
+    app.use(createChatRouter({ sessionManager }));
+    app.use(createTaskRouter({ sessionManager }));
+    app.use(createInspectRouter({ sessionManager, repoPath: config.repoPath }));
+    app.use(createAutomationRouter({ runner }));
+    app.use(createWebhookRouter({ runner, webhookSecret: config.webhookSecret }));
+    // Store REST API (if stores are defined)
+    if (storeBackend) {
+        app.use(createStoresRouter({ repo, storeBackend, tenantId: 'local' }));
+    }
+    // App middleware (e.g., Vite dev server for runtime app)
+    if (config.appMiddleware) {
+        app.use(config.appMiddleware);
+    }
+    else if (config.staticAppDir && existsSync(config.staticAppDir)) {
+        // Serve pre-built SPA static assets with index.html fallback
+        app.use(express.static(config.staticAppDir));
+        app.get('*', (_req, res) => {
+            const indexPath = path.join(config.staticAppDir, 'index.html');
+            if (existsSync(indexPath)) {
+                res.sendFile(indexPath);
+            }
+            else {
+                res.status(404).json({ error: 'Runtime app not found' });
+            }
+        });
+    }
+    // Error handler (must be last)
+    app.use(errorHandler);
+    let server = null;
+    const host = config.host ?? '0.0.0.0';
+    const port = config.port;
+    return {
+        app,
+        async start() {
+            // Start hot reload watcher
+            if (config.hotReload) {
+                watcher = new ConfigWatcher(config.repoPath, (newRepo) => {
+                    sessionManager.updateRepo(newRepo);
+                });
+                watcher.start();
+            }
+            return new Promise((resolve) => {
+                const httpServer = app.listen(port, host, () => {
+                    process.stderr.write(`[INFO] Repo server listening on ${host}:${port}\n`);
+                    process.stderr.write(`[INFO] Repo: ${config.repoPath}\n`);
+                    if (config.hotReload) {
+                        process.stderr.write('[INFO] Hot reload enabled\n');
+                    }
+                    resolve(httpServer);
+                });
+                server = httpServer;
+            });
+        },
+        async stop() {
+            runner.stop();
+            if (watcher) {
+                watcher.stop();
+                watcher = null;
+            }
+            if (server) {
+                const s = server;
+                await new Promise((resolve, reject) => {
+                    s.close((err) => {
+                        if (err)
+                            reject(err);
+                        else
+                            resolve();
+                    });
+                });
+                server = null;
+            }
+            await sessionManager.shutdown();
+            if (storeBackend) {
+                await storeBackend.close();
+            }
+            process.stderr.write('[INFO] Repo server stopped\n');
+        },
+    };
+}
+//# sourceMappingURL=local-server.js.map

package/dist/src/agent/local-server.js.map

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

package/dist/src/agent/local-server.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/agent/local-server.test.js

@@ -0,0 +1,126 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createLocalServer } from './local-server.js';
+// Use vi.hoisted so mocks survive vi.restoreAllMocks() from global test-setup
+const { mockLoadRepo, mockSetupSession, mockPrepareExploreConfig, mockPlanModeManager } = vi.hoisted(() => ({
+    mockLoadRepo: vi.fn(),
+    mockSetupSession: vi.fn(),
+    mockPrepareExploreConfig: vi.fn(),
+    mockPlanModeManager: vi.fn(),
+}));
+vi.mock('@amodalai/core', () => ({
+    loadRepo: mockLoadRepo,
+    setupSession: mockSetupSession,
+    prepareExploreConfig: mockPrepareExploreConfig,
+    PlanModeManager: mockPlanModeManager,
+    extractRoles: vi.fn(() => []),
+    buildConnectionsMap: vi.fn(() => ({})),
+}));
+const MOCK_REPO = {
+    source: 'local',
+    origin: '/test',
+    config: {
+        name: 'test',
+        version: '1.0.0',
+        models: { main: { provider: 'anthropic', model: 'claude-sonnet-4-20250514' } },
+    },
+    connections: new Map(),
+    skills: [],
+    agents: {},
+    automations: [],
+    knowledge: [],
+    evals: [],
+    tools: [],
+    stores: [],
+};
+function applyMockImplementations() {
+    mockLoadRepo.mockResolvedValue(MOCK_REPO);
+    mockSetupSession.mockReturnValue({
+        repo: { connections: new Map(), skills: [], automations: [], knowledge: [], evals: [], tools: [], stores: [] },
+        scrubTracker: {},
+        fieldScrubber: {},
+        outputGuard: {},
+        actionGate: { evaluate: vi.fn() },
+        contextCompiler: {},
+        compiledContext: { systemPrompt: 'test', tokenUsage: { total: 100000, used: 500, remaining: 99500, sectionBreakdown: {} }, sections: [] },
+        exploreContext: { systemPrompt: 'explore', tokenUsage: { total: 100000, used: 300, remaining: 99700, sectionBreakdown: {} }, sections: [] },
+        outputPipeline: { process: vi.fn(), createStreamProcessor: vi.fn() },
+        telemetry: { logScrub: vi.fn(), logGuard: vi.fn(), logGate: vi.fn() },
+        connectionsMap: {},
+        userRoles: [],
+        sessionId: 'test',
+        isDelegated: false,
+    });
+    mockPrepareExploreConfig.mockReturnValue({
+        systemPrompt: 'explore',
+        model: { provider: 'anthropic', model: 'test' },
+        connectionsMap: {},
+        readOnly: true,
+        maxTurns: 10,
+        maxDepth: 2,
+    });
+    mockPlanModeManager.mockImplementation(() => ({
+        isActive: vi.fn(() => false),
+        enter: vi.fn(),
+        exit: vi.fn(),
+        getPlanningReminder: vi.fn(() => null),
+        getApprovedPlanContext: vi.fn(() => null),
+    }));
+}
+describe('createLocalServer', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        applyMockImplementations();
+    });
+    it('should create a server instance', async () => {
+        const server = await createLocalServer({
+            repoPath: '/test',
+            port: 0,
+        });
+        expect(server).toBeDefined();
+        expect(server.app).toBeDefined();
+        expect(typeof server.start).toBe('function');
+        expect(typeof server.stop).toBe('function');
+    });
+    it('should respond to health checks', async () => {
+        const server = await createLocalServer({
+            repoPath: '/test',
+            port: 0,
+        });
+        const { default: request } = await import('supertest');
+        const res = await request(server.app).get('/health');
+        expect(res.status).toBe(200);
+        expect(res.body).toMatchObject({
+            status: 'ok',
+            mode: 'repo',
+            repo_path: '/test',
+        });
+    });
+    it('should start and stop cleanly', async () => {
+        const server = await createLocalServer({
+            repoPath: '/test',
+            port: 0,
+            host: '127.0.0.1',
+        });
+        const httpServer = await server.start();
+        expect(httpServer).toBeDefined();
+        await server.stop();
+    });
+    it('should respond to inspect endpoint', async () => {
+        const server = await createLocalServer({
+            repoPath: '/test',
+            port: 0,
+        });
+        const { default: request } = await import('supertest');
+        const res = await request(server.app).get('/inspect/context');
+        expect(res.status).toBe(200);
+        expect(res.body).toHaveProperty('repo_path', '/test');
+        expect(res.body).toHaveProperty('sections');
+        expect(res.body).toHaveProperty('connections');
+    });
+});
+//# sourceMappingURL=local-server.test.js.map

package/dist/src/agent/local-server.test.js.map

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

package/dist/src/agent/proactive/delivery.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export interface DeliveryPayload {
+    automation: string;
+    response: string;
+    timestamp: string;
+}
+/**
+ * Deliver automation results to stdout (default) or a proactive webhook.
+ *
+ * The agent itself handles delivery to Slack/email/etc. via connections.
+ * This function only handles the system-level output of the automation run.
+ */
+export declare function deliverResult(payload: DeliveryPayload, webhookUrl?: string, webhookSecret?: string): Promise<boolean>;
+/**
+ * Verify an incoming webhook request's HMAC signature.
+ */
+export declare function verifyHmacSignature(body: string, signature: string, secret: string): boolean;

package/dist/src/agent/proactive/delivery.js

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { createHmac } from 'node:crypto';
+/**
+ * Deliver automation results to stdout (default) or a proactive webhook.
+ *
+ * The agent itself handles delivery to Slack/email/etc. via connections.
+ * This function only handles the system-level output of the automation run.
+ */
+export async function deliverResult(payload, webhookUrl, webhookSecret) {
+    if (webhookUrl) {
+        return deliverWebhook(webhookUrl, payload, webhookSecret);
+    }
+    return deliverStdout(payload);
+}
+async function deliverWebhook(url, payload, webhookSecret) {
+    const body = JSON.stringify(payload);
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    if (webhookSecret) {
+        const signature = createHmac('sha256', webhookSecret)
+            .update(body)
+            .digest('hex');
+        headers['X-Amodal-Signature'] = `sha256=${signature}`;
+    }
+    try {
+        const response = await fetch(url, { method: 'POST', headers, body });
+        return response.ok;
+    }
+    catch {
+        return false;
+    }
+}
+function deliverStdout(payload) {
+    try {
+        process.stdout.write(JSON.stringify(payload) + '\n');
+        return Promise.resolve(true);
+    }
+    catch {
+        return Promise.resolve(false);
+    }
+}
+/**
+ * Verify an incoming webhook request's HMAC signature.
+ */
+export function verifyHmacSignature(body, signature, secret) {
+    const expected = createHmac('sha256', secret)
+        .update(body)
+        .digest('hex');
+    const expectedFull = `sha256=${expected}`;
+    if (signature.length !== expectedFull.length) {
+        return false;
+    }
+    const sigBuffer = Buffer.from(signature);
+    const expectedBuffer = Buffer.from(expectedFull);
+    return sigBuffer.length === expectedBuffer.length &&
+        createHmac('sha256', 'compare')
+            .update(sigBuffer)
+            .digest()
+            .equals(createHmac('sha256', 'compare')
+            .update(expectedBuffer)
+            .digest());
+}
+//# sourceMappingURL=delivery.js.map

package/dist/src/agent/proactive/delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../../src/agent/proactive/delivery.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAC;AAQvC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAwB,EACxB,UAAmB,EACnB,aAAsB;IAEtB,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,cAAc,CAAC,UAAU,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,GAAW,EACX,OAAwB,EACxB,aAAsB;IAEtB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAA2B;QACtC,cAAc,EAAE,kBAAkB;KACnC,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,SAAS,GAAG,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC;aAClD,MAAM,CAAC,IAAI,CAAC;aACZ,MAAM,CAAC,KAAK,CAAC,CAAC;QACjB,OAAO,CAAC,oBAAoB,CAAC,GAAG,UAAU,SAAS,EAAE,CAAC;IACxD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC,CAAC;QACnE,OAAO,QAAQ,CAAC,EAAE,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAwB;IAC7C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACrD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,SAAiB,EACjB,MAAc;IAEd,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC;SAC1C,MAAM,CAAC,IAAI,CAAC;SACZ,MAAM,CAAC,KAAK,CAAC,CAAC;IACjB,MAAM,YAAY,GAAG,UAAU,QAAQ,EAAE,CAAC;IAE1C,IAAI,SAAS,CAAC,MAAM,KAAK,YAAY,CAAC,MAAM,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjD,OAAO,SAAS,CAAC,MAAM,KAAK,cAAc,CAAC,MAAM;QAC/C,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;aAC5B,MAAM,CAAC,SAAS,CAAC;aACjB,MAAM,EAAE;aACR,MAAM,CACL,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC;aAC5B,MAAM,CAAC,cAAc,CAAC;aACtB,MAAM,EAAE,CACZ,CAAC;AACR,CAAC"}

package/dist/src/agent/proactive/delivery.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+export {};

package/dist/src/agent/proactive/delivery.test.js

@@ -0,0 +1,65 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { createHmac } from 'node:crypto';
+import { describe, it, expect, vi, afterEach } from 'vitest';
+import { deliverResult, verifyHmacSignature } from './delivery.js';
+describe('deliverResult', () => {
+    const payload = {
+        automation: 'daily-check',
+        response: 'All systems nominal.',
+        timestamp: '2025-01-01T00:00:00Z',
+    };
+    afterEach(() => {
+        vi.restoreAllMocks();
+        vi.unstubAllGlobals();
+    });
+    it('delivers to stdout when no webhook URL provided', async () => {
+        const writeSpy = vi.spyOn(process.stdout, 'write').mockImplementation(() => true);
+        const result = await deliverResult(payload);
+        expect(result).toBe(true);
+        expect(writeSpy).toHaveBeenCalledWith(JSON.stringify(payload) + '\n');
+    });
+    it('POSTs to webhook URL when provided', async () => {
+        const mockFetch = vi.fn().mockResolvedValue({ ok: true });
+        vi.stubGlobal('fetch', mockFetch);
+        const result = await deliverResult(payload, 'https://hooks.example.com/finops');
+        expect(result).toBe(true);
+        expect(mockFetch).toHaveBeenCalledWith('https://hooks.example.com/finops', expect.objectContaining({ method: 'POST' }));
+    });
+    it('includes HMAC signature when secret provided', async () => {
+        const mockFetch = vi.fn().mockResolvedValue({ ok: true });
+        vi.stubGlobal('fetch', mockFetch);
+        await deliverResult(payload, 'https://hooks.example.com', 'my-secret');
+        const callArgs = mockFetch.mock.calls[0];
+        const headers = callArgs[1].headers;
+        expect(headers['X-Amodal-Signature']).toMatch(/^sha256=/);
+    });
+    it('returns false when webhook fetch fails', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockRejectedValue(new Error('network')));
+        const result = await deliverResult(payload, 'https://hooks.example.com');
+        expect(result).toBe(false);
+    });
+    it('returns false when webhook returns non-ok', async () => {
+        vi.stubGlobal('fetch', vi.fn().mockResolvedValue({ ok: false, status: 500 }));
+        const result = await deliverResult(payload, 'https://hooks.example.com');
+        expect(result).toBe(false);
+    });
+});
+describe('verifyHmacSignature', () => {
+    it('verifies a valid signature', () => {
+        const body = '{"test": true}';
+        const secret = 'webhook-secret';
+        const sig = `sha256=${createHmac('sha256', secret).update(body).digest('hex')}`;
+        expect(verifyHmacSignature(body, sig, secret)).toBe(true);
+    });
+    it('rejects an invalid signature', () => {
+        expect(verifyHmacSignature('body', 'sha256=invalid', 'secret')).toBe(false);
+    });
+    it('rejects wrong length signature', () => {
+        expect(verifyHmacSignature('body', 'short', 'secret')).toBe(false);
+    });
+});
+//# sourceMappingURL=delivery.test.js.map

package/dist/src/agent/proactive/delivery.test.js.map

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

package/dist/src/agent/proactive/proactive-runner.d.ts

@@ -0,0 +1,76 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AmodalRepo } from '@amodalai/core';
+import type { AgentSession } from '../agent-types.js';
+export interface ProactiveRunnerConfig {
+    webhookSecret?: string;
+    /** Factory for creating ephemeral sessions */
+    createSession: () => Promise<AgentSession>;
+    /** Cleanup after ephemeral session */
+    destroySession: (sessionId: string) => Promise<void>;
+}
+export interface AutomationInfo {
+    name: string;
+    title: string;
+    schedule?: string;
+    webhookTriggered: boolean;
+    running: boolean;
+}
+/**
+ * Manages scheduled and webhook-triggered automation execution.
+ *
+ * - Cron automations must be explicitly started by name
+ * - Webhook-triggered automations are always available
+ * - Results are delivered according to each automation's delivery config
+ */
+export declare class ProactiveRunner {
+    private readonly config;
+    private readonly automations;
+    private readonly cronJobs;
+    constructor(repo: AmodalRepo, config: ProactiveRunnerConfig);
+    /**
+     * Start a specific cron automation by name.
+     * Returns an error message if the automation cannot be started.
+     */
+    startAutomation(name: string): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * Stop a specific cron automation by name.
+     */
+    stopAutomation(name: string): {
+        success: boolean;
+        error?: string;
+    };
+    /**
+     * Start all cron-scheduled automations.
+     */
+    start(): void;
+    /**
+     * Stop all cron jobs.
+     */
+    stop(): void;
+    /**
+     * Handle an incoming webhook event, matching it to webhook-triggered automations.
+     */
+    handleWebhook(automationName: string, payload: Record<string, unknown>): Promise<{
+        matched: boolean;
+        error?: string;
+    }>;
+    /**
+     * List all registered automations with their running state.
+     */
+    listAutomations(): AutomationInfo[];
+    /**
+     * Manually trigger an automation by name.
+     */
+    triggerAutomation(name: string, payload?: Record<string, unknown>): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    private runAutomation;
+}