@sprinterai/runtime 0.7.1 → 0.9.0

package/dist/agent/versioning.test.js

@@ -0,0 +1,147 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { InMemoryAgentVersionStore, InMemoryAgentStore } from '../testing/index.js';
+import { createAgentVersion, getVersionHistory, rollbackToVersion } from './versioning.js';
+function makeAgent(overrides = {}) {
+    return {
+        id: 'agent-1',
+        tenant_id: 'tenant-1',
+        slug: 'default',
+        name: 'Assistant',
+        description: 'Test agent',
+        icon: 'sparkles',
+        system_prompt: 'You are an assistant.',
+        model: null,
+        role_id: null,
+        config: null,
+        is_enabled: true,
+        created_at: new Date().toISOString(),
+        updated_at: new Date().toISOString(),
+        ...overrides,
+    };
+}
+describe('createAgentVersion', () => {
+    let versionStore;
+    beforeEach(() => {
+        versionStore = new InMemoryAgentVersionStore();
+    });
+    it('creates a version with number 1 when no prior versions exist', async () => {
+        const version = await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'You are an assistant.',
+            model: null,
+        });
+        expect(version.version_number).toBe(1);
+        expect(version.agent_id).toBe('agent-1');
+    });
+    it('auto-increments version numbers', async () => {
+        await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'v1',
+            model: null,
+        });
+        const v2 = await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'v2',
+            model: null,
+        });
+        expect(v2.version_number).toBe(2);
+    });
+    it('stores the change summary', async () => {
+        const version = await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'prompt',
+            model: null,
+            changeSummary: 'Updated instructions',
+        });
+        expect(version.change_summary).toBe('Updated instructions');
+    });
+    it('version numbers are independent per agent', async () => {
+        await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'a1-v1',
+            model: null,
+        });
+        const a2v1 = await createAgentVersion(versionStore, 'agent-2', {
+            agentConfig: null,
+            systemPrompt: 'a2-v1',
+            model: null,
+        });
+        expect(a2v1.version_number).toBe(1);
+    });
+});
+describe('getVersionHistory', () => {
+    let versionStore;
+    beforeEach(() => {
+        versionStore = new InMemoryAgentVersionStore();
+    });
+    it('returns versions ordered newest first', async () => {
+        await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'v1',
+            model: null,
+        });
+        await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'v2',
+            model: null,
+        });
+        const history = await getVersionHistory(versionStore, 'agent-1');
+        expect(history[0].version_number).toBe(2);
+        expect(history[1].version_number).toBe(1);
+    });
+    it('returns empty array when no versions exist', async () => {
+        const history = await getVersionHistory(versionStore, 'nonexistent');
+        expect(history).toHaveLength(0);
+    });
+    it('respects the limit parameter', async () => {
+        for (let i = 0; i < 5; i++) {
+            await createAgentVersion(versionStore, 'agent-1', {
+                agentConfig: null,
+                systemPrompt: `v${String(i + 1)}`,
+                model: null,
+            });
+        }
+        const history = await getVersionHistory(versionStore, 'agent-1', 3);
+        expect(history).toHaveLength(3);
+        expect(history[0].version_number).toBe(5);
+    });
+});
+describe('rollbackToVersion', () => {
+    let versionStore;
+    let agentStore;
+    beforeEach(() => {
+        versionStore = new InMemoryAgentVersionStore();
+        agentStore = new InMemoryAgentStore();
+    });
+    it('restores the agent to the target version config', async () => {
+        agentStore.seedAgent(makeAgent({ system_prompt: 'current prompt' }));
+        const v1 = await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'original prompt',
+            model: null,
+        });
+        await rollbackToVersion(versionStore, agentStore, 'agent-1', v1.id);
+        const agent = await agentStore.getAgentById('agent-1');
+        expect(agent?.system_prompt).toBe('original prompt');
+    });
+    it('saves a pre-rollback snapshot before applying', async () => {
+        agentStore.seedAgent(makeAgent({ system_prompt: 'current prompt' }));
+        const v1 = await createAgentVersion(versionStore, 'agent-1', {
+            agentConfig: null,
+            systemPrompt: 'v1',
+            model: null,
+        });
+        await rollbackToVersion(versionStore, agentStore, 'agent-1', v1.id);
+        const history = await getVersionHistory(versionStore, 'agent-1');
+        // v1 + the pre-rollback snapshot
+        expect(history.length).toBeGreaterThanOrEqual(2);
+        const snapshot = history.find((v) => v.change_summary?.includes('Pre-rollback'));
+        expect(snapshot).toBeDefined();
+        expect(snapshot?.system_prompt).toBe('current prompt');
+    });
+    it('throws when the version ID does not exist', async () => {
+        agentStore.seedAgent(makeAgent());
+        await expect(rollbackToVersion(versionStore, agentStore, 'agent-1', 'nonexistent-id')).rejects.toThrow('Version not found');
+    });
+});
+//# sourceMappingURL=versioning.test.js.map

package/dist/agent/versioning.test.js.map

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

package/dist/analytics/analytics-recorder.d.ts

@@ -0,0 +1,12 @@
+import type { AnalyticsProvider } from './analytics-types.js';
+export interface AnalyticsRecorderConfig {
+    providers: AnalyticsProvider[];
+    /** Called when a provider throws. Default: swallow silently. */
+    onError?: (provider: AnalyticsProvider, error: unknown) => void;
+}
+/**
+ * Creates a fire-and-forget analytics recorder that fans out events to multiple providers.
+ * Provider errors are caught and passed to onError (or swallowed if not configured).
+ */
+export declare function createAnalyticsRecorder(config: AnalyticsRecorderConfig): (type: string, metadata: Record<string, unknown>, tenantId: string, userId?: string) => void;
+//# sourceMappingURL=analytics-recorder.d.ts.map

package/dist/analytics/analytics-recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-recorder.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics-recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3E,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACjE;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,uBAAuB,IAEnE,MAAM,MAAM,EACZ,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,UAAU,MAAM,EAChB,SAAS,MAAM,KACd,IAAI,CAoBR"}

package/dist/analytics/analytics-recorder.js

@@ -0,0 +1,27 @@
+/**
+ * Creates a fire-and-forget analytics recorder that fans out events to multiple providers.
+ * Provider errors are caught and passed to onError (or swallowed if not configured).
+ */
+export function createAnalyticsRecorder(config) {
+    return function recordEvent(type, metadata, tenantId, userId) {
+        const event = {
+            type,
+            metadata,
+            tenantId,
+            userId,
+            timestamp: new Date().toISOString(),
+        };
+        for (const provider of config.providers) {
+            try {
+                const result = provider.track(event);
+                if (result instanceof Promise) {
+                    result.catch((err) => config.onError?.(provider, err));
+                }
+            }
+            catch (err) {
+                config.onError?.(provider, err);
+            }
+        }
+    };
+}
+//# sourceMappingURL=analytics-recorder.js.map

package/dist/analytics/analytics-recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-recorder.js","sourceRoot":"","sources":["../../src/analytics/analytics-recorder.ts"],"names":[],"mappings":"AAQA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAA+B;IACrE,OAAO,SAAS,WAAW,CACzB,IAAY,EACZ,QAAiC,EACjC,QAAgB,EAChB,MAAe;QAEf,MAAM,KAAK,GAAmB;YAC5B,IAAI;YACJ,QAAQ;YACR,QAAQ;YACR,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACrC,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;gBAClE,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/analytics/analytics-recorder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=analytics-recorder.test.d.ts.map

package/dist/analytics/analytics-recorder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-recorder.test.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics-recorder.test.ts"],"names":[],"mappings":""}

package/dist/analytics/analytics-recorder.test.js

@@ -0,0 +1,98 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createAnalyticsRecorder } from './analytics-recorder.js';
+function makeProvider(impl) {
+    return {
+        track: vi.fn().mockResolvedValue(undefined),
+        ...impl,
+    };
+}
+describe('createAnalyticsRecorder', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    it('calls track on a single provider with the correct event shape', () => {
+        const provider = makeProvider();
+        const record = createAnalyticsRecorder({ providers: [provider] });
+        record('tool_run', { toolSlug: 'roi-calculator' }, 'tenant-1', 'user-1');
+        expect(provider.track).toHaveBeenCalledOnce();
+        const event = vi.mocked(provider.track).mock.calls[0][0];
+        expect(event.type).toBe('tool_run');
+        expect(event.metadata).toEqual({ toolSlug: 'roi-calculator' });
+        expect(event.tenantId).toBe('tenant-1');
+        expect(event.userId).toBe('user-1');
+        expect(event.timestamp).toMatch(/^\d{4}-\d{2}-\d{2}T/);
+    });
+    it('fans out to multiple providers', () => {
+        const p1 = makeProvider();
+        const p2 = makeProvider();
+        const record = createAnalyticsRecorder({ providers: [p1, p2] });
+        record('chat_started', {}, 'tenant-2');
+        expect(p1.track).toHaveBeenCalledOnce();
+        expect(p2.track).toHaveBeenCalledOnce();
+    });
+    it('omits userId when not provided', () => {
+        const provider = makeProvider();
+        const record = createAnalyticsRecorder({ providers: [provider] });
+        record('page_view', {}, 'tenant-3');
+        const event = vi.mocked(provider.track).mock.calls[0][0];
+        expect(event.userId).toBeUndefined();
+    });
+    it('calls onError when a sync provider throws', () => {
+        const provider = makeProvider({
+            track: vi.fn().mockImplementation(() => {
+                throw new Error('sync fail');
+            }),
+        });
+        const onError = vi.fn();
+        const record = createAnalyticsRecorder({ providers: [provider], onError });
+        record('event', {}, 'tenant-1');
+        expect(onError).toHaveBeenCalledWith(provider, expect.any(Error));
+    });
+    it('calls onError when an async provider rejects', async () => {
+        const err = new Error('async fail');
+        const provider = makeProvider({ track: vi.fn().mockRejectedValue(err) });
+        const onError = vi.fn();
+        const record = createAnalyticsRecorder({ providers: [provider], onError });
+        record('event', {}, 'tenant-1');
+        // Let the rejected promise settle
+        await vi.runAllTimersAsync();
+        await Promise.resolve();
+        expect(onError).toHaveBeenCalledWith(provider, err);
+    });
+    it('swallows async errors silently when onError is not configured', async () => {
+        const provider = makeProvider({ track: vi.fn().mockRejectedValue(new Error('fail')) });
+        const record = createAnalyticsRecorder({ providers: [provider] });
+        expect(() => record('event', {}, 'tenant-1')).not.toThrow();
+        await vi.runAllTimersAsync();
+        await Promise.resolve();
+        // no unhandled rejection — test passes
+    });
+    it('continues to subsequent providers after one throws', () => {
+        const p1 = makeProvider({
+            track: vi.fn().mockImplementation(() => {
+                throw new Error('p1 fail');
+            }),
+        });
+        const p2 = makeProvider();
+        const record = createAnalyticsRecorder({ providers: [p1, p2] });
+        record('event', {}, 'tenant-1');
+        expect(p2.track).toHaveBeenCalledOnce();
+    });
+    it('works with zero providers', () => {
+        const record = createAnalyticsRecorder({ providers: [] });
+        expect(() => record('event', {}, 'tenant-1')).not.toThrow();
+    });
+    it('works with a synchronous provider', () => {
+        const events = [];
+        const syncProvider = {
+            track: (event) => {
+                events.push(event);
+            },
+        };
+        const record = createAnalyticsRecorder({ providers: [syncProvider] });
+        record('sync_event', { key: 'val' }, 'tenant-1', 'user-2');
+        expect(events).toHaveLength(1);
+        expect(events[0].type).toBe('sync_event');
+    });
+});
+//# sourceMappingURL=analytics-recorder.test.js.map

package/dist/analytics/analytics-recorder.test.js.map

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

package/dist/analytics/analytics-types.d.ts

@@ -0,0 +1,13 @@
+/** A structured analytics event with tenant context. */
+export interface AnalyticsEvent {
+    type: string;
+    metadata: Record<string, unknown>;
+    tenantId: string;
+    userId?: string;
+    timestamp?: string;
+}
+/** Interface for analytics providers (PostHog, Mixpanel, custom DB, etc.). */
+export interface AnalyticsProvider {
+    track(event: AnalyticsEvent): void | Promise<void>;
+}
+//# sourceMappingURL=analytics-types.d.ts.map

package/dist/analytics/analytics-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-types.d.ts","sourceRoot":"","sources":["../../src/analytics/analytics-types.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD"}

package/dist/analytics/analytics-types.js

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

package/dist/analytics/analytics-types.js.map

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

package/dist/analytics/index.d.ts

@@ -0,0 +1,4 @@
+export type { AnalyticsEvent, AnalyticsProvider } from './analytics-types.js';
+export { createAnalyticsRecorder } from './analytics-recorder.js';
+export type { AnalyticsRecorderConfig } from './analytics-recorder.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/analytics/index.js

@@ -0,0 +1,2 @@
+export { createAnalyticsRecorder } from './analytics-recorder.js';
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/automation/index.d.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod/v4';
+/** Convert a cron expression to a human-readable description. */
+export declare function cronToHuman(cron: string): string;
+/**
+ * Compute the next occurrence of a cron schedule after a given date.
+ * Returns null if the schedule cannot be parsed or cron-parser is unavailable.
+ *
+ * To enable next-run computation, install `cron-parser` and pass it in:
+ * ```ts
+ * import { CronExpressionParser } from 'cron-parser';
+ * getNextRun('0 9 * * *', { now: new Date(), parser: CronExpressionParser });
+ * ```
+ */
+export declare function getNextRun(cron: string, options?: {
+    now?: Date;
+    timezone?: string;
+    /** Optional cron parser — inject `CronExpressionParser` from `cron-parser` package. */
+    parser?: {
+        parse(expr: string, opts?: {
+            currentDate?: Date;
+            tz?: string;
+        }): {
+            next(): {
+                toDate(): Date;
+            };
+        };
+    };
+}): string | null;
+/** Structured output from NL automation parsing. */
+export declare const AutomationPlanSchema: z.ZodObject<{
+    name: z.ZodString;
+    slug: z.ZodString;
+    description: z.ZodString;
+    entityTypeSlug: z.ZodNullable<z.ZodString>;
+    schedule: z.ZodString;
+    scheduleHuman: z.ZodString;
+    prompt: z.ZodString;
+    icon: z.ZodString;
+}, z.core.$strip>;
+export type AutomationPlan = z.infer<typeof AutomationPlanSchema>;
+/**
+ * Build the system prompt for the NL automation parser.
+ * Includes available entity types as context so the AI can match
+ * user intent to the right data.
+ */
+export declare function buildParserSystemPrompt(entityTypes: Array<{
+    slug: string;
+    name: string;
+    description?: string;
+}>): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/automation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAwB3B,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+BhD;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IACR,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,MAAM,CAAC,EAAE;QACP,KAAK,CACH,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;YAAE,WAAW,CAAC,EAAE,IAAI,CAAC;YAAC,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,GACzC;YACD,IAAI,IAAI;gBAAE,MAAM,IAAI,IAAI,CAAA;aAAE,CAAC;SAC5B,CAAC;KACH,CAAC;CACH,GACA,MAAM,GAAG,IAAI,CAWf;AAMD,oDAAoD;AACpD,eAAO,MAAM,oBAAoB;;;;;;;;;iBAiB/B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GACvE,MAAM,CAkBR"}

package/dist/automation/index.js

@@ -0,0 +1,119 @@
+import { z } from 'zod/v4';
+// ---------------------------------------------------------------------------
+// Schedule utilities
+// ---------------------------------------------------------------------------
+const COMMON_CRONS = {
+    '* * * * *': 'Every minute',
+    '*/5 * * * *': 'Every 5 minutes',
+    '*/15 * * * *': 'Every 15 minutes',
+    '*/30 * * * *': 'Every 30 minutes',
+    '0 * * * *': 'Every hour',
+    '0 */2 * * *': 'Every 2 hours',
+    '0 */4 * * *': 'Every 4 hours',
+    '0 */6 * * *': 'Every 6 hours',
+    '0 */12 * * *': 'Every 12 hours',
+    '0 0 * * *': 'Daily at midnight',
+    '0 9 * * *': 'Daily at 9 AM',
+    '0 9 * * 1-5': 'Weekdays at 9 AM',
+    '0 0 * * 0': 'Weekly on Sunday',
+    '0 0 * * 1': 'Weekly on Monday',
+    '0 0 1 * *': 'Monthly on the 1st',
+};
+/** Convert a cron expression to a human-readable description. */
+export function cronToHuman(cron) {
+    const normalized = cron.trim();
+    const known = COMMON_CRONS[normalized];
+    if (known)
+        return known;
+    const parts = normalized.split(/\s+/);
+    if (parts.length !== 5)
+        return cron;
+    const [minute, hour, dayOfMonth, month, dayOfWeek] = parts;
+    if (minute.startsWith('*/') &&
+        hour === '*' &&
+        dayOfMonth === '*' &&
+        month === '*' &&
+        dayOfWeek === '*') {
+        return `Every ${minute.slice(2)} minutes`;
+    }
+    if (minute === '0' &&
+        hour.startsWith('*/') &&
+        dayOfMonth === '*' &&
+        month === '*' &&
+        dayOfWeek === '*') {
+        return `Every ${hour.slice(2)} hours`;
+    }
+    return cron;
+}
+/**
+ * Compute the next occurrence of a cron schedule after a given date.
+ * Returns null if the schedule cannot be parsed or cron-parser is unavailable.
+ *
+ * To enable next-run computation, install `cron-parser` and pass it in:
+ * ```ts
+ * import { CronExpressionParser } from 'cron-parser';
+ * getNextRun('0 9 * * *', { now: new Date(), parser: CronExpressionParser });
+ * ```
+ */
+export function getNextRun(cron, options) {
+    if (!options?.parser)
+        return null;
+    try {
+        const parseOpts = {};
+        if (options.now)
+            parseOpts.currentDate = options.now;
+        if (options.timezone)
+            parseOpts.tz = options.timezone;
+        const interval = options.parser.parse(cron, parseOpts);
+        return interval.next().toDate().toISOString();
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// NL Automation Plan (AI-assisted automation creation)
+// ---------------------------------------------------------------------------
+/** Structured output from NL automation parsing. */
+export const AutomationPlanSchema = z.object({
+    /** Generated name for the automation agent. */
+    name: z.string(),
+    /** Agent slug (kebab-case, unique identifier). */
+    slug: z.string(),
+    /** What this automation does, in one sentence. */
+    description: z.string(),
+    /** The entity type slug to monitor (from available types), or null. */
+    entityTypeSlug: z.string().nullable(),
+    /** Cron schedule expression. */
+    schedule: z.string(),
+    /** Human-readable schedule. */
+    scheduleHuman: z.string(),
+    /** The heartbeat prompt — what the agent should do each run. */
+    prompt: z.string(),
+    /** Suggested icon (lucide icon name). */
+    icon: z.string(),
+});
+/**
+ * Build the system prompt for the NL automation parser.
+ * Includes available entity types as context so the AI can match
+ * user intent to the right data.
+ */
+export function buildParserSystemPrompt(entityTypes) {
+    const typeList = entityTypes
+        .map((t) => `- ${t.slug}: ${t.name}${t.description ? ` (${t.description})` : ''}`)
+        .join('\n');
+    return `You are an automation configuration assistant. Parse the user's natural language description into a structured heartbeat automation config.
+
+Available entity types in this workspace:
+${typeList || '- (none configured yet)'}
+
+Rules:
+- Generate a concise, descriptive agent name (e.g., "WBM Customer News Monitor")
+- Generate a kebab-case slug from the name (e.g., "wbm-customer-news-monitor")
+- Match the user's intent to an entity type from the list above. If no match, set entityTypeSlug to null.
+- Convert schedule intent to cron: "daily" = "0 9 * * *", "weekly" = "0 9 * * 1", "hourly" = "0 * * * *", "every 15 minutes" = "*/15 * * * *"
+- Write a clear heartbeat prompt that tells the agent exactly what to do each run
+- Choose an appropriate lucide icon: "search" for monitoring, "bell" for alerts, "file-text" for reports, "trending-up" for tracking, "shield" for security, "mail" for outreach
+- Keep the description under 100 characters`;
+}
+//# sourceMappingURL=index.js.map

package/dist/automation/index.js.map

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

package/dist/automation/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/automation/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../src/automation/index.test.ts"],"names":[],"mappings":""}