@amodalai/runtime 0.1.0

package/dist/src/agent/user-context-fetcher.test.js

@@ -0,0 +1,121 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { fetchUserContext, _parseUserContextSpecForTesting as parseSpec } from './user-context-fetcher.js';
+function makeRepo(userContext) {
+    return {
+        source: 'local',
+        origin: '/test',
+        config: {
+            name: 'test',
+            version: '1.0.0',
+            userContext,
+            models: {
+                main: { provider: 'anthropic', model: 'claude-sonnet-4-20250514' },
+            },
+        },
+        connections: new Map(),
+        skills: [],
+        agents: { subagents: [] },
+        automations: [],
+        knowledge: [],
+        evals: [],
+        tools: [],
+        stores: [],
+    };
+}
+describe('parseUserContextSpec', () => {
+    it('should parse "GET crm/users/me"', () => {
+        const result = parseSpec('GET crm/users/me');
+        expect(result).toEqual({
+            method: 'GET',
+            connection: 'crm',
+            path: '/users/me',
+        });
+    });
+    it('should parse "POST api/auth"', () => {
+        const result = parseSpec('POST api/auth');
+        expect(result).toEqual({
+            method: 'POST',
+            connection: 'api',
+            path: '/auth',
+        });
+    });
+    it('should handle connection with no path', () => {
+        const result = parseSpec('GET crm');
+        expect(result).toEqual({
+            method: 'GET',
+            connection: 'crm',
+            path: '/',
+        });
+    });
+    it('should return null for empty string', () => {
+        const result = parseSpec('');
+        expect(result).toBeNull();
+    });
+    it('should return null for single word', () => {
+        const result = parseSpec('GET');
+        expect(result).toBeNull();
+    });
+});
+describe('fetchUserContext', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('should return empty object when no userContext configured', async () => {
+        const repo = makeRepo();
+        const result = await fetchUserContext(repo, 'token', {});
+        expect(result).toEqual({});
+    });
+    it('should return empty object when connection not found', async () => {
+        const repo = makeRepo('GET unknown/users/me');
+        const result = await fetchUserContext(repo, 'token', {});
+        expect(result).toEqual({});
+    });
+    it('should return empty object when base_url missing', async () => {
+        const repo = makeRepo('GET crm/users/me');
+        const connMap = {
+            crm: { no_base_url: true },
+        };
+        const result = await fetchUserContext(repo, 'token', connMap);
+        expect(result).toEqual({});
+    });
+    it('should fetch user context successfully', async () => {
+        const repo = makeRepo('GET crm/users/me');
+        const connMap = {
+            crm: { base_url: 'https://api.example.com' },
+        };
+        const mockResponse = { role: 'admin', name: 'Test User' };
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response(JSON.stringify(mockResponse), { status: 200 }));
+        const result = await fetchUserContext(repo, 'my-token', connMap);
+        expect(result).toEqual(mockResponse);
+        expect(fetch).toHaveBeenCalledWith('https://api.example.com/users/me', expect.objectContaining({
+            method: 'GET',
+            headers: expect.objectContaining({
+                Authorization: 'Bearer my-token',
+            }),
+        }));
+    });
+    it('should return empty object on HTTP error', async () => {
+        const repo = makeRepo('GET crm/users/me');
+        const connMap = {
+            crm: { base_url: 'https://api.example.com' },
+        };
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(new Response('Not Found', { status: 404 }));
+        const result = await fetchUserContext(repo, 'token', connMap);
+        expect(result).toEqual({});
+    });
+    it('should return empty object on fetch error', async () => {
+        const repo = makeRepo('GET crm/users/me');
+        const connMap = {
+            crm: { base_url: 'https://api.example.com' },
+        };
+        vi.spyOn(globalThis, 'fetch').mockRejectedValue(new Error('Network error'));
+        const result = await fetchUserContext(repo, 'token', connMap);
+        expect(result).toEqual({});
+    });
+});
+//# sourceMappingURL=user-context-fetcher.test.js.map

package/dist/src/agent/user-context-fetcher.test.js.map

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

package/dist/src/audit/audit-client.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Batching HTTP client that posts audit entries to the platform API.
+ * Fire-and-forget — never blocks chat processing.
+ */
+export interface AuditEntry {
+    event: string;
+    resource_name: string;
+    author?: string;
+    details?: Record<string, unknown>;
+    timestamp?: string;
+}
+export interface AuditClientOptions {
+    /** Platform API base URL */
+    platformApiUrl: string;
+    /** Flush interval in ms (default 2000) */
+    flushIntervalMs?: number;
+    /** Max batch size before auto-flush (default 20) */
+    maxBatchSize?: number;
+}
+export declare class AuditClient {
+    private readonly platformApiUrl;
+    private readonly flushIntervalMs;
+    private readonly maxBatchSize;
+    private readonly pending;
+    private flushTimer;
+    constructor(options: AuditClientOptions);
+    /**
+     * Queue an audit entry for batched delivery.
+     * Fire-and-forget — never throws.
+     */
+    log(appId: string, token: string, entry: AuditEntry): void;
+    /**
+     * Flush all pending batches immediately.
+     */
+    flush(): Promise<void>;
+    /**
+     * Stop the flush timer and drain remaining entries.
+     */
+    shutdown(): Promise<void>;
+    private send;
+}

package/dist/src/audit/audit-client.js

@@ -0,0 +1,83 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+const DEFAULT_FLUSH_INTERVAL_MS = 2000;
+const DEFAULT_MAX_BATCH_SIZE = 20;
+export class AuditClient {
+    platformApiUrl;
+    flushIntervalMs;
+    maxBatchSize;
+    pending = new Map();
+    flushTimer = null;
+    constructor(options) {
+        this.platformApiUrl = options.platformApiUrl;
+        this.flushIntervalMs = options.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS;
+        this.maxBatchSize = options.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE;
+        this.flushTimer = setInterval(() => {
+            void this.flush();
+        }, this.flushIntervalMs);
+        this.flushTimer.unref();
+    }
+    /**
+     * Queue an audit entry for batched delivery.
+     * Fire-and-forget — never throws.
+     */
+    log(appId, token, entry) {
+        const key = `${appId}:${token}`;
+        let batch = this.pending.get(key);
+        if (!batch) {
+            batch = { appId, token, entries: [] };
+            this.pending.set(key, batch);
+        }
+        batch.entries.push({
+            ...entry,
+            timestamp: entry.timestamp ?? new Date().toISOString(),
+        });
+        if (batch.entries.length >= this.maxBatchSize) {
+            const toSend = batch;
+            this.pending.delete(key);
+            void this.send(toSend);
+        }
+    }
+    /**
+     * Flush all pending batches immediately.
+     */
+    async flush() {
+        const batches = [...this.pending.values()];
+        this.pending.clear();
+        await Promise.all(batches.map((b) => this.send(b)));
+    }
+    /**
+     * Stop the flush timer and drain remaining entries.
+     */
+    async shutdown() {
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        await this.flush();
+    }
+    async send(batch) {
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 10000);
+            await fetch(`${this.platformApiUrl}/api/applications/${batch.appId}/audit-logs`, {
+                method: 'POST',
+                signal: controller.signal,
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${batch.token}`,
+                },
+                body: JSON.stringify({ entries: batch.entries }),
+            });
+            clearTimeout(timer);
+        }
+        catch (err) {
+            // Fire-and-forget — log but don't throw
+            process.stderr.write(`[WARN] Failed to send audit batch: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+}
+//# sourceMappingURL=audit-client.js.map

package/dist/src/audit/audit-client.js.map

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

package/dist/src/cron/heartbeat-runner.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AutomationDefinition } from '@amodalai/core';
+import type { AutomationResult } from '../types.js';
+import type { SessionManager } from '../session/session-manager.js';
+import type { AuditClient } from '../audit/audit-client.js';
+export type AutomationRunnerFn = (automation: AutomationDefinition, payload?: Record<string, unknown>) => Promise<AutomationResult>;
+export interface AutomationRunnerOptions {
+    sessionManager: SessionManager;
+    auditClient?: AuditClient;
+    /** App ID for audit logging (e.g. from platform config) */
+    auditAppId?: string;
+    /** Auth token for audit logging */
+    auditToken?: string;
+}
+/**
+ * Create an automation runner function.
+ * Each invocation creates an ephemeral session, runs the prompt, routes output,
+ * and destroys the session.
+ */
+export declare function createAutomationRunner(options: AutomationRunnerOptions): AutomationRunnerFn;

package/dist/src/cron/heartbeat-runner.js

@@ -0,0 +1,87 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { runMessage } from '../session/session-runner.js';
+import { routeOutput } from '../output/output-router.js';
+/**
+ * Create an automation runner function.
+ * Each invocation creates an ephemeral session, runs the prompt, routes output,
+ * and destroys the session.
+ */
+export function createAutomationRunner(options) {
+    return async (automation, payload) => {
+        const startTime = Date.now();
+        let session;
+        try {
+            session = await options.sessionManager.create();
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[ERROR] Automation "${automation.name}" failed to create session: ${message}\n`);
+            return {
+                automation: automation.name,
+                response: '',
+                tool_calls: [],
+                output_sent: false,
+                duration_ms: Date.now() - startTime,
+            };
+        }
+        // Build audit context if audit client is available
+        let audit;
+        if (options.auditClient && options.auditAppId && options.auditToken) {
+            audit = {
+                auditClient: options.auditClient,
+                appId: options.auditAppId,
+                token: options.auditToken,
+            };
+        }
+        try {
+            // Build prompt — optionally include payload data
+            let prompt = automation.prompt;
+            if (payload && Object.keys(payload).length > 0) {
+                prompt += `\n\nEvent data: ${JSON.stringify(payload)}`;
+            }
+            // Set up timeout if constraints specify one
+            const controller = new AbortController();
+            let timeoutId;
+            if (automation.constraints?.timeout_seconds) {
+                timeoutId = setTimeout(() => controller.abort(), automation.constraints.timeout_seconds * 1000);
+            }
+            try {
+                const result = await runMessage(session, prompt, controller.signal, audit);
+                const automationResult = {
+                    automation: automation.name,
+                    response: result.response,
+                    tool_calls: result.tool_calls,
+                    output_sent: false,
+                    duration_ms: Date.now() - startTime,
+                };
+                // Route output
+                const outputSent = await routeOutput(automation.output, automationResult);
+                automationResult.output_sent = outputSent;
+                return automationResult;
+            }
+            finally {
+                if (timeoutId)
+                    clearTimeout(timeoutId);
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            process.stderr.write(`[ERROR] Automation "${automation.name}" failed: ${message}\n`);
+            return {
+                automation: automation.name,
+                response: '',
+                tool_calls: [],
+                output_sent: false,
+                duration_ms: Date.now() - startTime,
+            };
+        }
+        finally {
+            await options.sessionManager.destroy(session.id);
+        }
+    };
+}
+//# sourceMappingURL=heartbeat-runner.js.map

package/dist/src/cron/heartbeat-runner.js.map

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

package/dist/src/cron/heartbeat-runner.test.d.ts

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

package/dist/src/cron/heartbeat-runner.test.js

@@ -0,0 +1,120 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// Mock dependencies
+const mockRunMessage = vi.fn();
+vi.mock('../session/session-runner.js', () => ({
+    runMessage: (...args) => mockRunMessage(...args),
+}));
+const mockRouteOutput = vi.fn();
+vi.mock('../output/output-router.js', () => ({
+    routeOutput: (...args) => mockRouteOutput(...args),
+}));
+const { createAutomationRunner } = await import('./heartbeat-runner.js');
+function makeAutomation(overrides = {}) {
+    return {
+        name: 'zone-monitor',
+        trigger: { type: 'cron', schedule: '*/5 * * * *' },
+        prompt: 'Check all zones.',
+        tools: ['get_zone_overview'],
+        skills: ['*'],
+        output: { channel: 'slack', target: 'https://hooks.slack.com/abc' },
+        allow_writes: false,
+        ...overrides,
+    };
+}
+describe('createAutomationRunner', () => {
+    const mockCreate = vi.fn();
+    const mockDestroy = vi.fn();
+    beforeEach(() => {
+        vi.clearAllMocks();
+        mockCreate.mockResolvedValue({
+            id: 'hb-sess-1',
+            config: {},
+            geminiClient: {},
+            scheduler: {},
+        });
+        mockDestroy.mockResolvedValue(undefined);
+        mockRunMessage.mockResolvedValue({
+            session_id: 'hb-sess-1',
+            response: 'All clear.',
+            tool_calls: [],
+        });
+        mockRouteOutput.mockResolvedValue(true);
+    });
+    function makeRunner() {
+        return createAutomationRunner({
+            sessionManager: {
+                create: mockCreate,
+                destroy: mockDestroy,
+            },
+        });
+    }
+    it('creates session, runs prompt, routes output, and destroys session', async () => {
+        const runner = makeRunner();
+        const result = await runner(makeAutomation());
+        expect(mockCreate).toHaveBeenCalledOnce();
+        expect(mockRunMessage).toHaveBeenCalledOnce();
+        expect(mockRouteOutput).toHaveBeenCalledOnce();
+        expect(mockDestroy).toHaveBeenCalledWith('hb-sess-1');
+        expect(result.automation).toBe('zone-monitor');
+        expect(result.response).toBe('All clear.');
+        expect(result.output_sent).toBe(true);
+        expect(result.duration_ms).toBeGreaterThanOrEqual(0);
+    });
+    it('includes payload data in prompt', async () => {
+        const runner = makeRunner();
+        await runner(makeAutomation(), { device_id: '42' });
+        const promptArg = mockRunMessage.mock.calls[0][1];
+        expect(promptArg).toContain('Check all zones.');
+        expect(promptArg).toContain('device_id');
+        expect(promptArg).toContain('42');
+    });
+    it('handles session creation failure gracefully', async () => {
+        mockCreate.mockRejectedValue(new Error('config error'));
+        vi.spyOn(process.stderr, 'write').mockReturnValue(true);
+        const runner = makeRunner();
+        const result = await runner(makeAutomation());
+        expect(result.automation).toBe('zone-monitor');
+        expect(result.response).toBe('');
+        expect(result.output_sent).toBe(false);
+    });
+    it('handles runMessage failure gracefully', async () => {
+        mockRunMessage.mockRejectedValue(new Error('LLM error'));
+        vi.spyOn(process.stderr, 'write').mockReturnValue(true);
+        const runner = makeRunner();
+        const result = await runner(makeAutomation());
+        expect(result.response).toBe('');
+        expect(result.output_sent).toBe(false);
+        expect(mockDestroy).toHaveBeenCalledOnce(); // Still cleans up
+    });
+    it('handles output routing failure gracefully', async () => {
+        mockRouteOutput.mockResolvedValue(false);
+        const runner = makeRunner();
+        const result = await runner(makeAutomation());
+        expect(result.output_sent).toBe(false);
+        expect(result.response).toBe('All clear.'); // Still has response
+    });
+    it('destroys session even on error', async () => {
+        mockRunMessage.mockRejectedValue(new Error('boom'));
+        vi.spyOn(process.stderr, 'write').mockReturnValue(true);
+        const runner = makeRunner();
+        await runner(makeAutomation());
+        expect(mockDestroy).toHaveBeenCalledWith('hb-sess-1');
+    });
+    it('respects timeout constraint', async () => {
+        // Create a slow runMessage
+        mockRunMessage.mockImplementation(() => new Promise((resolve) => setTimeout(resolve, 100)));
+        const runner = makeRunner();
+        const automation = makeAutomation({
+            constraints: { timeout_seconds: 1 },
+        });
+        // This should still complete (1s timeout > 100ms)
+        await runner(automation);
+        expect(mockRunMessage).toHaveBeenCalledOnce();
+    });
+});
+//# sourceMappingURL=heartbeat-runner.test.js.map

package/dist/src/cron/heartbeat-runner.test.js.map

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

package/dist/src/cron/heartbeat-scheduler.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import type { AutomationDefinition } from '@amodalai/core';
+import type { AutomationRunnerFn } from './heartbeat-runner.js';
+/**
+ * Registers in-process cron jobs from automation definitions.
+ * Only registers automations with trigger type "cron".
+ */
+export declare class AutomationScheduler {
+    private readonly jobs;
+    /**
+     * Register cron automations and start them.
+     */
+    start(automations: AutomationDefinition[], runAutomation: AutomationRunnerFn): void;
+    /**
+     * Stop all scheduled cron jobs.
+     */
+    stop(): void;
+    /**
+     * Number of registered cron jobs.
+     */
+    get size(): number;
+}

package/dist/src/cron/heartbeat-scheduler.js

@@ -0,0 +1,54 @@
+/**
+ * @license
+ * Copyright 2025 Amodal Labs, Inc.
+ * SPDX-License-Identifier: MIT
+ */
+import cron from 'node-cron';
+/**
+ * Registers in-process cron jobs from automation definitions.
+ * Only registers automations with trigger type "cron".
+ */
+export class AutomationScheduler {
+    jobs = [];
+    /**
+     * Register cron automations and start them.
+     */
+    start(automations, runAutomation) {
+        const cronAutomations = automations.filter((a) => a.trigger.type === 'cron');
+        for (const a of cronAutomations) {
+            if (a.trigger.type !== 'cron')
+                continue;
+            const schedule = a.trigger.schedule;
+            if (!cron.validate(schedule)) {
+                process.stderr.write(`[WARN] Invalid cron schedule for automation "${a.name}": ${schedule}\n`);
+                continue;
+            }
+            const task = cron.schedule(schedule, () => {
+                void runAutomation(a).catch((err) => {
+                    const message = err instanceof Error ? err.message : String(err);
+                    process.stderr.write(`[ERROR] Cron automation "${a.name}" failed: ${message}\n`);
+                });
+            });
+            this.jobs.push({ automation: a, task });
+        }
+        if (this.jobs.length > 0) {
+            process.stderr.write(`[INFO] Registered ${this.jobs.length} cron automation(s)\n`);
+        }
+    }
+    /**
+     * Stop all scheduled cron jobs.
+     */
+    stop() {
+        for (const job of this.jobs) {
+            job.task.stop();
+        }
+        this.jobs.length = 0;
+    }
+    /**
+     * Number of registered cron jobs.
+     */
+    get size() {
+        return this.jobs.length;
+    }
+}
+//# sourceMappingURL=heartbeat-scheduler.js.map

package/dist/src/cron/heartbeat-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-scheduler.js","sourceRoot":"","sources":["../../../src/cron/heartbeat-scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B;;;GAGG;AACH,MAAM,OAAO,mBAAmB;IACb,IAAI,GAAmB,EAAE,CAAC;IAE3C;;OAEG;IACH,KAAK,CACH,WAAmC,EACnC,aAAiC;QAEjC,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CACxC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,CACjC,CAAC;QAEF,KAAK,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM;gBAAE,SAAS;YAExC,MAAM,QAAQ,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;YACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gDAAgD,CAAC,CAAC,IAAI,MAAM,QAAQ,IAAI,CACzE,CAAC;gBACF,SAAS;YACX,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACxC,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;oBAC3C,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,4BAA4B,CAAC,CAAC,IAAI,aAAa,OAAO,IAAI,CAC3D,CAAC;gBACJ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,qBAAqB,IAAI,CAAC,IAAI,CAAC,MAAM,uBAAuB,CAC7D,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI;QACF,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;CACF"}

package/dist/src/cron/heartbeat-scheduler.test.d.ts

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