@sprinterai/runtime 0.6.0 → 0.8.0

package/dist/skill/skill-loader.test.js

@@ -0,0 +1,64 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { createLoadSkillTool } from './skill-loader.js';
+function getExecute(tools) {
+    // AI SDK Tool.execute expects (args, options) — cast through unknown for tests
+    return tools.loadSkill.execute;
+}
+function makeConfig(overrides = {}) {
+    return {
+        getSkillBySlug: vi.fn().mockResolvedValue(null),
+        ...overrides,
+    };
+}
+describe('createLoadSkillTool', () => {
+    beforeEach(() => vi.clearAllMocks());
+    it('creates a loadSkill tool', () => {
+        const tools = createLoadSkillTool(makeConfig());
+        expect(tools.loadSkill).toBeDefined();
+        expect(tools.loadSkill.description).toContain('Load a skill');
+    });
+    it('returns skill instructions on valid slug', async () => {
+        const config = makeConfig({
+            getSkillBySlug: vi.fn().mockResolvedValue({
+                id: 's1',
+                slug: 'data-analysis',
+                name: 'Data Analysis',
+                instructions: 'Follow these steps to analyze data...',
+            }),
+        });
+        const result = await getExecute(createLoadSkillTool(config))({ slug: 'data-analysis' });
+        expect(result).toMatchObject({
+            skillSlug: 'data-analysis',
+            skillName: 'Data Analysis',
+            instructions: 'Follow these steps to analyze data...',
+        });
+    });
+    it('returns error for unknown skill', async () => {
+        const result = await getExecute(createLoadSkillTool(makeConfig()))({ slug: 'nonexistent' });
+        expect(result).toMatchObject({ error: expect.stringContaining('not found') });
+    });
+    it('calls onSkillLoaded with skill id on success', async () => {
+        const onSkillLoaded = vi.fn();
+        const config = makeConfig({
+            getSkillBySlug: vi.fn().mockResolvedValue({
+                id: 's42',
+                slug: 'writing',
+                name: 'Writing',
+                instructions: null,
+            }),
+            onSkillLoaded,
+        });
+        await getExecute(createLoadSkillTool(config))({ slug: 'writing' });
+        expect(onSkillLoaded).toHaveBeenCalledWith('s42');
+    });
+    it('does not call onSkillLoaded when skill not found', async () => {
+        const onSkillLoaded = vi.fn();
+        const config = makeConfig({
+            getSkillBySlug: vi.fn().mockResolvedValue(null),
+            onSkillLoaded,
+        });
+        await getExecute(createLoadSkillTool(config))({ slug: 'missing' });
+        expect(onSkillLoaded).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=skill-loader.test.js.map

package/dist/skill/skill-loader.test.js.map

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

package/dist/skill/skill-prompt.d.ts

@@ -0,0 +1,7 @@
+import type { SkillRecord } from '@sprinterai/core';
+/**
+ * Build a skill index string for injection into agent system prompts.
+ * Lists available skills with their descriptions so the agent knows what it can load.
+ */
+export declare function buildSkillIndex(skills: SkillRecord[]): string;
+//# sourceMappingURL=skill-prompt.d.ts.map

package/dist/skill/skill-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.d.ts","sourceRoot":"","sources":["../../src/skill/skill-prompt.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAY7D"}

package/dist/skill/skill-prompt.js

@@ -0,0 +1,17 @@
+/**
+ * Build a skill index string for injection into agent system prompts.
+ * Lists available skills with their descriptions so the agent knows what it can load.
+ */
+export function buildSkillIndex(skills) {
+    if (skills.length === 0)
+        return '';
+    const lines = skills.map((s) => {
+        const desc = s.description ? ` — ${s.description}` : '';
+        return `- **${s.name}** (\`${s.slug}\`)${desc}`;
+    });
+    return `\n\n## Available Skills
+You have access to the following skills. Use the \`loadSkill\` tool with the skill's slug to load its detailed instructions when needed.
+
+${lines.join('\n')}`;
+}
+//# sourceMappingURL=skill-prompt.js.map

package/dist/skill/skill-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.js","sourceRoot":"","sources":["../../src/skill/skill-prompt.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAqB;IACnD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,OAAO,OAAO,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,IAAI,MAAM,IAAI,EAAE,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,OAAO;;;EAGP,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACrB,CAAC"}

package/dist/skill/skill-prompt.test.d.ts

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

package/dist/skill/skill-prompt.test.d.ts.map

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

package/dist/skill/skill-prompt.test.js

@@ -0,0 +1,44 @@
+import { describe, it, expect } from 'vitest';
+import { buildSkillIndex } from './skill-prompt.js';
+function makeSkill(overrides = {}) {
+    return {
+        id: 's1',
+        tenant_id: 'tenant-1',
+        slug: 'test',
+        name: 'Test Skill',
+        description: 'A test skill',
+        instructions: 'Do things',
+        category: 'general',
+        source: 'manual',
+        metadata: null,
+        user_invocable: false,
+        enabled: true,
+        created_at: '',
+        updated_at: '',
+        ...overrides,
+    };
+}
+describe('buildSkillIndex', () => {
+    it('returns empty string for no skills', () => {
+        expect(buildSkillIndex([])).toBe('');
+    });
+    it('formats skill list with names and slugs', () => {
+        const skills = [
+            makeSkill({ slug: 'data-analysis', name: 'Data Analysis', description: 'Analyze data' }),
+            makeSkill({ slug: 'writing', name: 'Writing', description: null }),
+        ];
+        const result = buildSkillIndex(skills);
+        expect(result).toContain('Data Analysis');
+        expect(result).toContain('`data-analysis`');
+        expect(result).toContain('Analyze data');
+        expect(result).toContain('Writing');
+        expect(result).toContain('loadSkill');
+    });
+    it('handles skills without descriptions', () => {
+        const skills = [makeSkill({ name: 'Simple', description: null })];
+        const result = buildSkillIndex(skills);
+        expect(result).toContain('Simple');
+        expect(result).not.toContain('—');
+    });
+});
+//# sourceMappingURL=skill-prompt.test.js.map

package/dist/skill/skill-prompt.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-prompt.test.js","sourceRoot":"","sources":["../../src/skill/skill-prompt.test.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,SAAS,SAAS,CAAC,YAAkC,EAAE;IACrD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,SAAS,EAAE,UAAU;QACrB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,cAAc;QAC3B,YAAY,EAAE,WAAW;QACzB,QAAQ,EAAE,SAAS;QACnB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,IAAI;QACd,cAAc,EAAE,KAAK;QACrB,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,EAAE;QACd,UAAU,EAAE,EAAE;QACd,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,MAAM,GAAG;YACb,SAAS,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;YACxF,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;SACnE,CAAC;QACF,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/source/index.d.ts

@@ -0,0 +1,5 @@
+export type { ValidationStatus } from './source-status.js';
+export { getSourceValidationStatus, resolveSourceSyncStatus, canRunSourceSync, isSourceDue, } from './source-status.js';
+export type { FetchedItem, SourceFetchResult, SourcePollSummary, SourcePollerConfig, SourcePoller, } from './source-poller.js';
+export { createSourcePoller } from './source-poller.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/source/index.js

@@ -0,0 +1,3 @@
+export { getSourceValidationStatus, resolveSourceSyncStatus, canRunSourceSync, isSourceDue, } from './source-status.js';
+export { createSourcePoller } from './source-poller.js';
+//# sourceMappingURL=index.js.map

package/dist/source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/source/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,gBAAgB,EAChB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/source/source-poller.d.ts

@@ -0,0 +1,66 @@
+import type { SourceRecord, SourceStore } from '@sprinterai/core';
+/** A single content item fetched from a source. */
+export interface FetchedItem {
+    title: string;
+    url: string;
+    summary: string;
+    author?: string | null;
+    publishedAt?: string | null;
+    externalId?: string | null;
+}
+/** Result of fetching a single source. */
+export interface SourceFetchResult {
+    items: FetchedItem[];
+    /** If set, the fetch failed with this error message. */
+    error?: string;
+}
+/** Summary of a poll run across all due sources. */
+export interface SourcePollSummary {
+    polled: number;
+    succeeded: number;
+    failed: number;
+    errors: {
+        sourceId: string;
+        error: string;
+    }[];
+}
+export interface SourcePollerConfig {
+    store: SourceStore;
+    /**
+     * Framework-supplied function that fetches content items from a source.
+     * Called once per due source during `pollDueSources`.
+     */
+    fetchContent: (source: SourceRecord) => Promise<SourceFetchResult>;
+    /**
+     * Optional callback invoked after successful item fetches.
+     * Use this to enqueue items for downstream processing.
+     */
+    onItemsFetched?: (sourceId: string, items: FetchedItem[]) => Promise<void>;
+}
+export interface SourcePoller {
+    /** Returns true if the source's schedule indicates it is due for a sync. */
+    isDue(source: SourceRecord): boolean;
+    /** Lists all enabled, due sources for a tenant and polls each one. */
+    pollDueSources(tenantId: string): Promise<SourcePollSummary>;
+}
+/**
+ * Create a framework-agnostic source polling engine.
+ *
+ * The engine is responsible for schedule evaluation and status management.
+ * Content fetching is delegated to the caller-supplied `fetchContent` function,
+ * keeping this engine free of HTTP, RSS, or scraping dependencies.
+ *
+ * @example
+ * ```ts
+ * const poller = createSourcePoller({
+ *   store,
+ *   fetchContent: async (source) => fetchRss(source.url),
+ *   onItemsFetched: async (sourceId, items) => queue.push({ sourceId, items }),
+ * });
+ *
+ * // Call from a cron handler:
+ * const summary = await poller.pollDueSources(tenantId);
+ * ```
+ */
+export declare function createSourcePoller(config: SourcePollerConfig): SourcePoller;
+//# sourceMappingURL=source-poller.d.ts.map

package/dist/source/source-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-poller.d.ts","sourceRoot":"","sources":["../../src/source/source-poller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMlE,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,0CAA0C;AAC1C,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oDAAoD;AACpD,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,CAAC;IACnB;;;OAGG;IACH,YAAY,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnE;;;OAGG;IACH,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E;AAED,MAAM,WAAW,YAAY;IAC3B,4EAA4E;IAC5E,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC;IACrC,sEAAsE;IACtE,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC9D;AAID;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAiD3E"}

package/dist/source/source-poller.js

@@ -0,0 +1,64 @@
+import { isSourceDue } from './source-status.js';
+// ─── Factory ──────────────────────────────────────────────────
+/**
+ * Create a framework-agnostic source polling engine.
+ *
+ * The engine is responsible for schedule evaluation and status management.
+ * Content fetching is delegated to the caller-supplied `fetchContent` function,
+ * keeping this engine free of HTTP, RSS, or scraping dependencies.
+ *
+ * @example
+ * ```ts
+ * const poller = createSourcePoller({
+ *   store,
+ *   fetchContent: async (source) => fetchRss(source.url),
+ *   onItemsFetched: async (sourceId, items) => queue.push({ sourceId, items }),
+ * });
+ *
+ * // Call from a cron handler:
+ * const summary = await poller.pollDueSources(tenantId);
+ * ```
+ */
+export function createSourcePoller(config) {
+    const { store, fetchContent, onItemsFetched } = config;
+    return {
+        isDue(source) {
+            return isSourceDue(source);
+        },
+        async pollDueSources(tenantId) {
+            const sources = await store.listSources(tenantId);
+            const due = sources.filter((s) => s.enabled && isSourceDue(s));
+            const summary = {
+                polled: due.length,
+                succeeded: 0,
+                failed: 0,
+                errors: [],
+            };
+            for (const source of due) {
+                try {
+                    const result = await fetchContent(source);
+                    if (result.error) {
+                        await store.updateSyncStatus(source.id, tenantId, 'error', result.error);
+                        summary.failed++;
+                        summary.errors.push({ sourceId: source.id, error: result.error });
+                        continue;
+                    }
+                    await store.triggerSync(source.id, tenantId);
+                    await store.updateSyncStatus(source.id, tenantId, 'active', null);
+                    if (onItemsFetched && result.items.length > 0) {
+                        await onItemsFetched(source.id, result.items);
+                    }
+                    summary.succeeded++;
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    await store.updateSyncStatus(source.id, tenantId, 'error', message);
+                    summary.failed++;
+                    summary.errors.push({ sourceId: source.id, error: message });
+                }
+            }
+            return summary;
+        },
+    };
+}
+//# sourceMappingURL=source-poller.js.map

package/dist/source/source-poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-poller.js","sourceRoot":"","sources":["../../src/source/source-poller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkDjD,iEAAiE;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC;IAEvD,OAAO;QACL,KAAK,CAAC,MAAoB;YACxB,OAAO,WAAW,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;QAED,KAAK,CAAC,cAAc,CAAC,QAAgB;YACnC,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAClD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;YAE/D,MAAM,OAAO,GAAsB;gBACjC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,SAAS,EAAE,CAAC;gBACZ,MAAM,EAAE,CAAC;gBACT,MAAM,EAAE,EAAE;aACX,CAAC;YAEF,KAAK,MAAM,MAAM,IAAI,GAAG,EAAE,CAAC;gBACzB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;oBAE1C,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;wBACjB,MAAM,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;wBACzE,OAAO,CAAC,MAAM,EAAE,CAAC;wBACjB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;wBAClE,SAAS;oBACX,CAAC;oBAED,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;oBAC7C,MAAM,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;oBAElE,IAAI,cAAc,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9C,MAAM,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;oBAChD,CAAC;oBAED,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;oBACjE,MAAM,KAAK,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;oBACpE,OAAO,CAAC,MAAM,EAAE,CAAC;oBACjB,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/D,CAAC;YACH,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/source/source-poller.test.d.ts

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

package/dist/source/source-poller.test.d.ts.map

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

package/dist/source/source-poller.test.js

@@ -0,0 +1,184 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { createSourcePoller } from './source-poller.js';
+const now = new Date('2026-04-03T12:00:00Z').getTime();
+function makeSource(overrides = {}) {
+    return {
+        id: 'src-1',
+        tenant_id: 'tenant-1',
+        name: 'Test RSS',
+        source_type: 'rss',
+        url: 'https://example.com/feed.xml',
+        schedule: 'hourly',
+        entity_type_slug: 'article',
+        field_mapping: {},
+        enabled: true,
+        sync_status: 'never_synced',
+        scrape_strategy: null,
+        sync_error: null,
+        last_synced_at: null,
+        last_validated_at: null,
+        metadata: null,
+        created_at: '2026-01-01T00:00:00Z',
+        updated_at: '2026-01-01T00:00:00Z',
+        ...overrides,
+    };
+}
+function makeStore(sources = []) {
+    return {
+        listSources: vi.fn(async () => sources),
+        getSource: vi.fn(async () => null),
+        createSource: vi.fn(async () => sources[0]),
+        updateSource: vi.fn(async () => null),
+        deleteSource: vi.fn(async () => undefined),
+        triggerSync: vi.fn(async () => undefined),
+        updateSyncStatus: vi.fn(async () => undefined),
+    };
+}
+describe('createSourcePoller - isDue', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(now);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('returns true for never-synced source', () => {
+        const poller = createSourcePoller({
+            store: makeStore(),
+            fetchContent: vi.fn(async () => ({ items: [] })),
+        });
+        expect(poller.isDue(makeSource({ last_synced_at: null }))).toBe(true);
+    });
+    it('returns false for manual schedule', () => {
+        const poller = createSourcePoller({
+            store: makeStore(),
+            fetchContent: vi.fn(async () => ({ items: [] })),
+        });
+        expect(poller.isDue(makeSource({ schedule: 'manual', last_synced_at: null }))).toBe(false);
+    });
+    it('returns true for hourly source synced 2 hours ago', () => {
+        const poller = createSourcePoller({
+            store: makeStore(),
+            fetchContent: vi.fn(async () => ({ items: [] })),
+        });
+        expect(poller.isDue(makeSource({ schedule: 'hourly', last_synced_at: '2026-04-03T10:00:00Z' }))).toBe(true);
+    });
+});
+describe('createSourcePoller - pollDueSources', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+        vi.setSystemTime(now);
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('skips disabled sources', async () => {
+        const source = makeSource({ enabled: false, last_synced_at: null });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => ({ items: [] }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(0);
+        expect(fetchContent).not.toHaveBeenCalled();
+    });
+    it('skips non-due sources', async () => {
+        // Synced 5 minutes ago, hourly schedule → not due
+        const source = makeSource({ schedule: 'hourly', last_synced_at: '2026-04-03T11:55:00Z' });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => ({ items: [] }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(0);
+        expect(fetchContent).not.toHaveBeenCalled();
+    });
+    it('polls due source and marks active on success', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const items = [{ title: 'Item', url: 'https://example.com/1', summary: 'Summary' }];
+        const fetchContent = vi.fn(async () => ({ items }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(1);
+        expect(summary.succeeded).toBe(1);
+        expect(summary.failed).toBe(0);
+        expect(store.triggerSync).toHaveBeenCalledWith('src-1', 'tenant-1');
+        expect(store.updateSyncStatus).toHaveBeenCalledWith('src-1', 'tenant-1', 'active', null);
+    });
+    it('marks source as error when fetchContent returns error', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => ({ items: [], error: 'Connection timeout' }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(1);
+        expect(summary.succeeded).toBe(0);
+        expect(summary.failed).toBe(1);
+        expect(summary.errors[0]).toEqual({ sourceId: 'src-1', error: 'Connection timeout' });
+        expect(store.updateSyncStatus).toHaveBeenCalledWith('src-1', 'tenant-1', 'error', 'Connection timeout');
+        expect(store.triggerSync).not.toHaveBeenCalled();
+    });
+    it('marks source as error when fetchContent throws', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => {
+            throw new Error('Network unreachable');
+        });
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.failed).toBe(1);
+        expect(summary.errors[0].error).toBe('Network unreachable');
+        expect(store.updateSyncStatus).toHaveBeenCalledWith('src-1', 'tenant-1', 'error', 'Network unreachable');
+    });
+    it('calls onItemsFetched when items are present', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const items = [{ title: 'T', url: 'https://x.com', summary: 'S' }];
+        const fetchContent = vi.fn(async () => ({ items }));
+        const onItemsFetched = vi.fn(async () => undefined);
+        const poller = createSourcePoller({ store, fetchContent, onItemsFetched });
+        await poller.pollDueSources('tenant-1');
+        expect(onItemsFetched).toHaveBeenCalledWith('src-1', items);
+    });
+    it('does not call onItemsFetched for empty result', async () => {
+        const source = makeSource({ last_synced_at: null });
+        const store = makeStore([source]);
+        const fetchContent = vi.fn(async () => ({ items: [] }));
+        const onItemsFetched = vi.fn(async () => undefined);
+        const poller = createSourcePoller({ store, fetchContent, onItemsFetched });
+        await poller.pollDueSources('tenant-1');
+        expect(onItemsFetched).not.toHaveBeenCalled();
+    });
+    it('polls multiple sources independently', async () => {
+        const src1 = makeSource({ id: 'src-1', last_synced_at: null });
+        const src2 = makeSource({
+            id: 'src-2',
+            last_synced_at: null,
+            name: 'Second',
+            url: 'https://other.com/feed.xml',
+        });
+        const store = makeStore([src1, src2]);
+        const fetchContent = vi.fn(async () => ({ items: [] }));
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(2);
+        expect(summary.succeeded).toBe(2);
+        expect(fetchContent).toHaveBeenCalledTimes(2);
+    });
+    it('continues polling remaining sources after one fails', async () => {
+        const src1 = makeSource({ id: 'src-1', last_synced_at: null });
+        const src2 = makeSource({ id: 'src-2', last_synced_at: null, name: 'Second' });
+        const store = makeStore([src1, src2]);
+        const fetchContent = vi
+            .fn()
+            .mockImplementationOnce(async () => {
+            throw new Error('fail');
+        })
+            .mockResolvedValueOnce({ items: [] });
+        const poller = createSourcePoller({ store, fetchContent });
+        const summary = await poller.pollDueSources('tenant-1');
+        expect(summary.polled).toBe(2);
+        expect(summary.succeeded).toBe(1);
+        expect(summary.failed).toBe(1);
+    });
+});
+//# sourceMappingURL=source-poller.test.js.map

package/dist/source/source-poller.test.js.map

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

package/dist/source/source-status.d.ts

@@ -0,0 +1,41 @@
+import type { SourceSyncStatus, SourceRecord } from '@sprinterai/core';
+export type ValidationStatus = 'valid' | 'invalid' | null;
+/**
+ * Extract the validation status from a source record's metadata.
+ *
+ * Amble stores validation results under `metadata.sourceValidation.status`.
+ */
+export declare function getSourceValidationStatus(metadata: Record<string, unknown> | null | undefined): ValidationStatus;
+/**
+ * Determine the sync status for a source based on validation and history.
+ *
+ * Rules (in priority order):
+ * 1. Invalid validation → 'error'
+ * 2. Previously paused → preserve 'paused'
+ * 3. Has been synced before → 'active'
+ * 4. Everything else → 'never_synced'
+ */
+export declare function resolveSourceSyncStatus(params: {
+    validationStatus: ValidationStatus;
+    previousStatus?: string | null;
+    lastSyncedAt?: string | null;
+}): SourceSyncStatus;
+/**
+ * Returns true if a source sync is allowed to proceed.
+ *
+ * A sync is blocked when the source is paused or has a known invalid configuration.
+ */
+export declare function canRunSourceSync(params: {
+    syncStatus?: string | null;
+    validationStatus: ValidationStatus;
+}): boolean;
+/**
+ * Returns true if the source is due for a sync based on its schedule
+ * and the time of the last sync.
+ *
+ * Sources that have never been synced are always considered due.
+ * Sources with `schedule = 'manual'` are never automatically due.
+ * Unknown cron strings fall back to the 'daily' interval.
+ */
+export declare function isSourceDue(source: Pick<SourceRecord, 'schedule' | 'last_synced_at'>): boolean;
+//# sourceMappingURL=source-status.d.ts.map

package/dist/source/source-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-status.d.ts","sourceRoot":"","sources":["../../src/source/source-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,GACnD,gBAAgB,CAOlB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,gBAAgB,EAAE,gBAAgB,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,gBAAgB,CAOnB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE;IACvC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,gBAAgB,CAAC;CACpC,GAAG,OAAO,CAIV;AASD;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,gBAAgB,CAAC,GAAG,OAAO,CAY9F"}