@sprinterai/runtime 0.6.0 → 0.8.0

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,77 @@
+import { z } from 'zod';
+/** 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<{
+    /** Generated name for the automation agent. */
+    name: z.ZodString;
+    /** Agent slug (kebab-case, unique identifier). */
+    slug: z.ZodString;
+    /** What this automation does, in one sentence. */
+    description: z.ZodString;
+    /** The entity type slug to monitor (from available types), or null. */
+    entityTypeSlug: z.ZodNullable<z.ZodString>;
+    /** Cron schedule expression. */
+    schedule: z.ZodString;
+    /** Human-readable schedule. */
+    scheduleHuman: z.ZodString;
+    /** The heartbeat prompt — what the agent should do each run. */
+    prompt: z.ZodString;
+    /** Suggested icon (lucide icon name). */
+    icon: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    slug: string;
+    name: string;
+    description: string;
+    icon: string;
+    entityTypeSlug: string | null;
+    prompt: string;
+    schedule: string;
+    scheduleHuman: string;
+}, {
+    slug: string;
+    name: string;
+    description: string;
+    icon: string;
+    entityTypeSlug: string | null;
+    prompt: string;
+    schedule: string;
+    scheduleHuman: string;
+}>;
+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,KAAK,CAAC;AAwBxB,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;IAC/B,+CAA+C;;IAE/C,kDAAkD;;IAElD,kDAAkD;;IAElD,uEAAuE;;IAEvE,gCAAgC;;IAEhC,+BAA+B;;IAE/B,gEAAgE;;IAEhE,yCAAyC;;;;;;;;;;;;;;;;;;;;EAEzC,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';
+// ---------------------------------------------------------------------------
+// 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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E,MAAM,YAAY,GAA2B;IAC3C,WAAW,EAAE,cAAc;IAC3B,aAAa,EAAE,iBAAiB;IAChC,cAAc,EAAE,kBAAkB;IAClC,cAAc,EAAE,kBAAkB;IAClC,WAAW,EAAE,YAAY;IACzB,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,eAAe;IAC5B,aAAa,EAAE,kBAAkB;IACjC,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,kBAAkB;IAC/B,WAAW,EAAE,oBAAoB;CAClC,CAAC;AAEF,iEAAiE;AACjE,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;IAE3D,IACE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC;QACvB,IAAI,KAAK,GAAG;QACZ,UAAU,KAAK,GAAG;QAClB,KAAK,KAAK,GAAG;QACb,SAAS,KAAK,GAAG,EACjB,CAAC;QACD,OAAO,SAAS,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC;IAC5C,CAAC;IAED,IACE,MAAM,KAAK,GAAG;QACd,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QACrB,UAAU,KAAK,GAAG;QAClB,KAAK,KAAK,GAAG;QACb,SAAS,KAAK,GAAG,EACjB,CAAC;QACD,OAAO,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IACxC,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,IAAY,EACZ,OAYC;IAED,IAAI,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,SAAS,GAAwC,EAAE,CAAC;QAC1D,IAAI,OAAO,CAAC,GAAG;YAAE,SAAS,CAAC,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC;QACrD,IAAI,OAAO,CAAC,QAAQ;YAAE,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,uDAAuD;AACvD,8EAA8E;AAE9E,oDAAoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,+CAA+C;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,kDAAkD;IAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,kDAAkD;IAClD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,uEAAuE;IACvE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,gCAAgC;IAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,+BAA+B;IAC/B,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE;IACzB,gEAAgE;IAChE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,yCAAyC;IACzC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAwE;IAExE,MAAM,QAAQ,GAAG,WAAW;SACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;SACjF,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;EAGP,QAAQ,IAAI,yBAAyB;;;;;;;;;4CASK,CAAC;AAC7C,CAAC"}

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":""}

package/dist/automation/index.test.js

@@ -0,0 +1,135 @@
+import { describe, it, expect } from 'vitest';
+import { cronToHuman, getNextRun, AutomationPlanSchema, buildParserSystemPrompt } from './index.js';
+describe('cronToHuman', () => {
+    it('converts known cron expressions', () => {
+        expect(cronToHuman('0 9 * * *')).toBe('Daily at 9 AM');
+        expect(cronToHuman('0 * * * *')).toBe('Every hour');
+        expect(cronToHuman('0 0 * * *')).toBe('Daily at midnight');
+        expect(cronToHuman('0 0 1 * *')).toBe('Monthly on the 1st');
+        expect(cronToHuman('0 0 * * 1')).toBe('Weekly on Monday');
+        expect(cronToHuman('0 9 * * 1-5')).toBe('Weekdays at 9 AM');
+    });
+    it('handles minute interval expressions', () => {
+        expect(cronToHuman('*/5 * * * *')).toBe('Every 5 minutes');
+        expect(cronToHuman('*/15 * * * *')).toBe('Every 15 minutes');
+        expect(cronToHuman('*/30 * * * *')).toBe('Every 30 minutes');
+    });
+    it('handles hour interval expressions', () => {
+        expect(cronToHuman('0 */2 * * *')).toBe('Every 2 hours');
+        expect(cronToHuman('0 */6 * * *')).toBe('Every 6 hours');
+        expect(cronToHuman('0 */12 * * *')).toBe('Every 12 hours');
+    });
+    it('handles extra whitespace in cron expression', () => {
+        expect(cronToHuman('  0 9 * * *  ')).toBe('Daily at 9 AM');
+    });
+    it('returns original expression for unknown/invalid crons', () => {
+        expect(cronToHuman('custom-schedule')).toBe('custom-schedule');
+    });
+    it('parses generic minute interval not in lookup table', () => {
+        expect(cronToHuman('*/7 * * * *')).toBe('Every 7 minutes');
+    });
+    it('parses generic hour interval not in lookup table', () => {
+        expect(cronToHuman('0 */3 * * *')).toBe('Every 3 hours');
+    });
+});
+describe('getNextRun', () => {
+    it('returns null when no parser is provided', () => {
+        expect(getNextRun('0 9 * * *')).toBeNull();
+    });
+    it('returns null when parser is not passed in options', () => {
+        expect(getNextRun('0 9 * * *', { timezone: 'UTC' })).toBeNull();
+    });
+    it('uses an injected parser to compute next run', () => {
+        const fixedDate = new Date('2026-01-01T10:00:00Z');
+        const mockParser = {
+            parse: (_expr, _opts) => ({
+                next: () => ({ toDate: () => fixedDate }),
+            }),
+        };
+        const result = getNextRun('0 9 * * *', { parser: mockParser });
+        expect(result).toBe(fixedDate.toISOString());
+    });
+    it('returns null if the parser throws', () => {
+        const badParser = {
+            parse: () => {
+                throw new Error('Invalid cron');
+            },
+        };
+        const result = getNextRun('bad-cron', { parser: badParser });
+        expect(result).toBeNull();
+    });
+});
+describe('AutomationPlanSchema', () => {
+    it('validates a correct automation plan', () => {
+        const plan = {
+            name: 'News Monitor',
+            slug: 'news-monitor',
+            description: 'Monitor news for portfolio companies',
+            entityTypeSlug: 'company',
+            schedule: '0 9 * * *',
+            scheduleHuman: 'Daily at 9 AM',
+            prompt: 'Search for recent news about each company',
+            icon: 'search',
+        };
+        const result = AutomationPlanSchema.safeParse(plan);
+        expect(result.success).toBe(true);
+    });
+    it('accepts null entityTypeSlug', () => {
+        const plan = {
+            name: 'Daily Digest',
+            slug: 'daily-digest',
+            description: 'Send a daily summary',
+            entityTypeSlug: null,
+            schedule: '0 8 * * 1-5',
+            scheduleHuman: 'Weekdays at 8 AM',
+            prompt: 'Generate a summary',
+            icon: 'mail',
+        };
+        const result = AutomationPlanSchema.safeParse(plan);
+        expect(result.success).toBe(true);
+        if (result.success) {
+            expect(result.data.entityTypeSlug).toBeNull();
+        }
+    });
+    it('rejects a plan missing required fields', () => {
+        const result = AutomationPlanSchema.safeParse({ name: 'Incomplete' });
+        expect(result.success).toBe(false);
+    });
+});
+describe('buildParserSystemPrompt', () => {
+    it('includes entity types in the prompt', () => {
+        const entityTypes = [
+            { slug: 'company', name: 'Company', description: 'Portfolio companies' },
+            { slug: 'contact', name: 'Contact' },
+        ];
+        const prompt = buildParserSystemPrompt(entityTypes);
+        expect(prompt).toContain('company: Company');
+        expect(prompt).toContain('contact: Contact');
+        expect(prompt).toContain('Portfolio companies');
+    });
+    it('shows placeholder when no entity types', () => {
+        const prompt = buildParserSystemPrompt([]);
+        expect(prompt).toContain('(none configured yet)');
+    });
+    it('contains automation-specific instructions', () => {
+        const prompt = buildParserSystemPrompt([]);
+        expect(prompt).toContain('cron');
+        expect(prompt).toContain('heartbeat');
+    });
+});
+describe('AutomationPlan type', () => {
+    it('is inferred correctly from schema', () => {
+        const plan = {
+            name: 'Test',
+            slug: 'test',
+            description: 'Test automation',
+            entityTypeSlug: null,
+            schedule: '0 * * * *',
+            scheduleHuman: 'Every hour',
+            prompt: 'Do something',
+            icon: 'bell',
+        };
+        expect(plan.slug).toBe('test');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/automation/index.test.js.map

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

package/dist/capture/capture-parser.d.ts

@@ -0,0 +1,13 @@
+import type { EntityTypeRecord } from '@sprinterai/core';
+import type { LanguageModel } from 'ai';
+import { type ParseResult } from './capture-schema.js';
+export interface CaptureParserConfig {
+    model: LanguageModel;
+    getEntityTypes: () => Promise<EntityTypeRecord[]>;
+}
+export interface CaptureContext {
+    entityTypeSlug?: string;
+    entityId?: string;
+}
+export declare function createCaptureParser(config: CaptureParserConfig): (text: string, context?: CaptureContext) => Promise<ParseResult>;
+//# sourceMappingURL=capture-parser.d.ts.map

package/dist/capture/capture-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-parser.d.ts","sourceRoot":"","sources":["../../src/capture/capture-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AAGxC,OAAO,EAAqB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAYvE,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,EAAE,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,IAC1B,MAAM,MAAM,EAAE,UAAU,cAAc,KAAG,OAAO,CAAC,WAAW,CAAC,CA6CjG"}

package/dist/capture/capture-parser.js

@@ -0,0 +1,55 @@
+import { generateObject } from 'ai';
+import { z } from 'zod';
+import { ParseResultSchema } from './capture-schema.js';
+const ParseCaptureInput = z.object({
+    text: z.string().min(1).max(1000),
+    context: z
+        .object({
+        entityTypeSlug: z.string().optional(),
+        entityId: z.string().uuid().optional(),
+    })
+        .optional(),
+});
+export function createCaptureParser(config) {
+    return async function parseCapture(text, context) {
+        const validated = ParseCaptureInput.parse({ text, context });
+        const entityTypes = await config.getEntityTypes();
+        const typeDescriptions = entityTypes
+            .map((t) => {
+            const schema = t.json_schema ? JSON.stringify(t.json_schema, null, 2) : 'No schema defined';
+            return `- **${t.name}** (slug: "${t.slug}")\n  Schema: ${schema}`;
+        })
+            .join('\n');
+        let contextInfo = '';
+        if (validated.context?.entityTypeSlug) {
+            contextInfo += `\nThe user is currently viewing the "${validated.context.entityTypeSlug}" entity type list. Bias toward creating this type unless the input clearly indicates otherwise.`;
+        }
+        if (validated.context?.entityId) {
+            contextInfo += `\nThe user is viewing entity ID "${validated.context.entityId}". Suggest a relation to this entity if it makes sense.`;
+        }
+        const { object } = await generateObject({
+            model: config.model,
+            schema: ParseResultSchema,
+            prompt: `Parse this quick capture input into a structured entity.
+
+Available entity types:
+${typeDescriptions}
+${contextInfo}
+
+User input: "${validated.text}"
+
+Rules:
+- Pick the most appropriate entity type based on the input
+- Generate a clear, concise title
+- Populate content fields that match the entity type's JSON schema
+- For enum fields, ONLY use values from the enum list — never invent values
+- For date fields, use YYYY-MM-DD format
+- For string fields, use plain text (no markdown)
+- Only include fields defined in the schema — do not add extra keys
+- Only suggest relations if context.entityId is provided and it makes sense
+- If no relations make sense, return an empty suggestedRelations array`,
+        });
+        return object;
+    };
+}
+//# sourceMappingURL=capture-parser.js.map

package/dist/capture/capture-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture-parser.js","sourceRoot":"","sources":["../../src/capture/capture-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,IAAI,CAAC;AAEpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAoB,MAAM,kBAAkB,CAAC;AAEvE,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACrC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;KACvC,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC;AAYH,MAAM,UAAU,mBAAmB,CAAC,MAA2B;IAC7D,OAAO,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,OAAwB;QACvE,MAAM,SAAS,GAAG,iBAAiB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAE7D,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;QAElD,MAAM,gBAAgB,GAAG,WAAW;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACT,MAAM,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC;YAC5F,OAAO,OAAO,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,IAAI,iBAAiB,MAAM,EAAE,CAAC;QACpE,CAAC,CAAC;aACD,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,SAAS,CAAC,OAAO,EAAE,cAAc,EAAE,CAAC;YACtC,WAAW,IAAI,wCAAwC,SAAS,CAAC,OAAO,CAAC,cAAc,kGAAkG,CAAC;QAC5L,CAAC;QACD,IAAI,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;YAChC,WAAW,IAAI,oCAAoC,SAAS,CAAC,OAAO,CAAC,QAAQ,yDAAyD,CAAC;QACzI,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,CAAC;YACtC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE;;;EAGZ,gBAAgB;EAChB,WAAW;;eAEE,SAAS,CAAC,IAAI;;;;;;;;;;;uEAW0C;SAClE,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/capture/capture-parser.test.d.ts

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

package/dist/capture/capture-parser.test.d.ts.map

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