@telepat/snoopy 0.1.4

package/dist/src/services/openrouter/prompts.js

@@ -0,0 +1,48 @@
+const SYSTEM_CONTEXT = `\
+You are configuring a job for an automated Reddit monitoring system.
+How the system works:
+- The user defines monitoring jobs, each with a set of subreddits and a qualification prompt.
+- Every 30 minutes, the system fetches all new posts and comments from those subreddits.
+- Each post/comment is individually evaluated by an LLM using the job's qualification prompt.
+- Items that pass are surfaced to the user as relevant matches.
+The goal is to capture content the user genuinely cares about while filtering out noise.`;
+export function buildClarificationPrompt(criteria) {
+    return [
+        SYSTEM_CONTEXT,
+        '',
+        'The user has described what they want to monitor. Ask 2 to 4 short clarification questions',
+        'that will help you write a precise, effective qualification prompt later.',
+        'Focus on intent, signal vs. noise, and edge cases — not on which subreddits to watch',
+        '(subreddits are configured separately).',
+        '',
+        'Output only JSON with this exact schema:',
+        '{"questions":[{"id":"q1","question":"..."}]}',
+        '',
+        `User criteria: ${criteria}`
+    ].join('\n');
+}
+export function buildSpecPrompt(criteria, answers) {
+    return [
+        SYSTEM_CONTEXT,
+        '',
+        'Using the user criteria and their answers to the clarification questions, produce a monitoring job spec.',
+        '',
+        'The most important field is qualificationPrompt — this is the exact prompt that will be prepended',
+        'to each Reddit post or comment and sent to an LLM to decide whether that content is a match.',
+        'It should be written in second-person imperative ("Decide whether this post…"), be specific about',
+        'what counts as a match vs. not a match, and be resilient to tangential or off-topic content.',
+        '',
+        'Return strict JSON only with this schema:',
+        '{"name":"...","slug":"...","description":"...","qualificationPrompt":"...","suggestedSubreddits":["sub1","sub2"]}',
+        '',
+        'Rules:',
+        '- slug: a memorable, scannable identifier for this job shown in job listings (e.g. "ai-funding-rounds", "rust-job-postings"). kebab-case, lowercase, 2-40 chars, letters/numbers/hyphens only.',
+        '- description: one tight sentence a user can read at a glance to know exactly what this job is watching for. Prefer active phrasing, e.g. "Monitors posts asking for SaaS tool recommendations" rather than generic summaries.',
+        '- qualificationPrompt: 2-5 sentences; precise, actionable, unambiguous.',
+        '- suggestedSubreddits: 3 to 8 relevant subreddit names without the r/ prefix.',
+        '',
+        `Original criteria: ${criteria}`,
+        `Clarifications: ${JSON.stringify(answers)}`
+    ].join('\n');
+}
+//# sourceMappingURL=prompts.js.map

package/dist/src/services/openrouter/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../../src/services/openrouter/prompts.ts"],"names":[],"mappings":"AAAA,MAAM,cAAc,GAAG;;;;;;;yFAOkE,CAAC;AAE1F,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO;QACL,cAAc;QACd,EAAE;QACF,4FAA4F;QAC5F,2EAA2E;QAC3E,sFAAsF;QACtF,yCAAyC;QACzC,EAAE;QACF,0CAA0C;QAC1C,8CAA8C;QAC9C,EAAE;QACF,kBAAkB,QAAQ,EAAE;KAC7B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,OAAoD;IACpG,OAAO;QACL,cAAc;QACd,EAAE;QACF,0GAA0G;QAC1G,EAAE;QACF,mGAAmG;QACnG,8FAA8F;QAC9F,mGAAmG;QACnG,8FAA8F;QAC9F,EAAE;QACF,2CAA2C;QAC3C,mHAAmH;QACnH,EAAE;QACF,QAAQ;QACR,gMAAgM;QAChM,gOAAgO;QAChO,yEAAyE;QACzE,+EAA+E;QAC/E,EAAE;QACF,sBAAsB,QAAQ,EAAE;QAChC,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;KAC7C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/src/services/reddit/client.d.ts

@@ -0,0 +1,25 @@
+import type { RedditCredentials } from '../../types/settings.js';
+export interface RedditTraceHooks {
+    onRequest?: (operation: string, payload: unknown) => void;
+    onResponse?: (operation: string, payload: unknown) => void;
+    onError?: (operation: string, payload: unknown) => void;
+}
+export interface RedditPost {
+    id: string;
+    subreddit: string;
+    title: string;
+    body: string;
+    author: string;
+    url: string;
+    postedAt: string;
+}
+export interface RedditComment {
+    id: string;
+    author: string;
+    body: string;
+    permalink?: string;
+    url?: string;
+    replies: RedditComment[];
+}
+export declare function getRecentSubredditPosts(subreddit: string, credentials?: RedditCredentials | null, traceHooks?: RedditTraceHooks): Promise<RedditPost[]>;
+export declare function getRedditPostComments(postId: string, credentials?: RedditCredentials | null, traceHooks?: RedditTraceHooks): Promise<RedditComment[]>;

package/dist/src/services/reddit/client.js

@@ -0,0 +1,186 @@
+const DEFAULT_USER_AGENT = 'snoopy:reddit-client:v1';
+let tokenState = null;
+function assertCredentials(credentials) {
+    if (!credentials.clientId || !credentials.clientSecret || !credentials.appName) {
+        throw new Error('Reddit credentials are incomplete. clientId, clientSecret, and appName are required.');
+    }
+}
+async function getAccessToken(credentials) {
+    const params = new URLSearchParams();
+    params.append('grant_type', 'client_credentials');
+    const authHeader = Buffer.from(`${credentials.clientId}:${credentials.clientSecret}`).toString('base64');
+    const response = await fetch('https://www.reddit.com/api/v1/access_token', {
+        method: 'POST',
+        body: params,
+        headers: {
+            Authorization: `Basic ${authHeader}`,
+            'Content-Type': 'application/x-www-form-urlencoded',
+            'User-Agent': credentials.appName
+        }
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to authenticate with Reddit (${response.status} ${response.statusText}).`);
+    }
+    const data = (await response.json());
+    if (!data.access_token) {
+        throw new Error(`Failed to get Reddit access token${data.error ? `: ${data.error}` : ''}`);
+    }
+    const expiresInSec = typeof data.expires_in === 'number' ? data.expires_in : 3600;
+    tokenState = {
+        accessToken: data.access_token,
+        // Keep a small safety margin so token is refreshed before hard expiry.
+        expiresAt: Date.now() + Math.max(expiresInSec - 30, 1) * 1000
+    };
+    return data.access_token;
+}
+async function ensureToken(credentials) {
+    if (tokenState && Date.now() < tokenState.expiresAt) {
+        return tokenState.accessToken;
+    }
+    return getAccessToken(credentials);
+}
+async function callOAuthRedditApi(endpoint, credentials, traceHooks) {
+    assertCredentials(credentials);
+    const makeRequest = async (token) => {
+        const response = await fetch(`https://oauth.reddit.com${endpoint}`, {
+            headers: {
+                Authorization: `Bearer ${token}`,
+                'User-Agent': credentials.appName
+            }
+        });
+        if (response.status === 401 && tokenState?.accessToken === token) {
+            tokenState = null;
+            return null;
+        }
+        return response;
+    };
+    let token = await ensureToken(credentials);
+    let response = await makeRequest(token);
+    if (!response) {
+        token = await ensureToken(credentials);
+        response = await makeRequest(token);
+    }
+    if (!response) {
+        throw new Error('Failed to authenticate with Reddit API.');
+    }
+    if (!response.ok) {
+        traceHooks?.onError?.('reddit.oauth', {
+            endpoint,
+            status: response.status,
+            statusText: response.statusText
+        });
+        throw new Error(`Reddit API request failed (${response.status} ${response.statusText}).`);
+    }
+    traceHooks?.onRequest?.('reddit.oauth', {
+        method: 'GET',
+        url: `https://oauth.reddit.com${endpoint}`,
+        headers: {
+            Authorization: 'Bearer [redacted]',
+            'User-Agent': credentials.appName
+        }
+    });
+    const json = await response.json();
+    traceHooks?.onResponse?.('reddit.oauth', {
+        endpoint,
+        status: response.status,
+        body: json
+    });
+    return json;
+}
+function isFallbackEligibleStatus(status) {
+    return status === 401 || status === 403 || status === 429;
+}
+function getUserAgent(credentials) {
+    return credentials?.appName?.trim() || DEFAULT_USER_AGENT;
+}
+async function callRedditApi(endpoint, credentials, traceHooks) {
+    const userAgent = getUserAgent(credentials);
+    const unauthUrl = `https://www.reddit.com${endpoint}`;
+    try {
+        traceHooks?.onRequest?.('reddit.public', {
+            method: 'GET',
+            url: unauthUrl,
+            headers: {
+                'User-Agent': userAgent
+            }
+        });
+        const unauthResponse = await fetch(unauthUrl, {
+            headers: {
+                'User-Agent': userAgent
+            }
+        });
+        if (unauthResponse.ok) {
+            const json = await unauthResponse.json();
+            traceHooks?.onResponse?.('reddit.public', {
+                endpoint,
+                status: unauthResponse.status,
+                body: json
+            });
+            return json;
+        }
+        traceHooks?.onError?.('reddit.public', {
+            endpoint,
+            status: unauthResponse.status,
+            statusText: unauthResponse.statusText
+        });
+        if (!isFallbackEligibleStatus(unauthResponse.status)) {
+            throw new Error(`Reddit API request failed (${unauthResponse.status} ${unauthResponse.statusText}).`);
+        }
+    }
+    catch (error) {
+        if (!credentials) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error('Failed to fetch Reddit content without OAuth credentials.');
+        }
+    }
+    if (!credentials) {
+        throw new Error('Reddit denied unauthenticated access. Configure OAuth fallback credentials in settings.');
+    }
+    return callOAuthRedditApi(endpoint, credentials, traceHooks);
+}
+function parseComment(thing) {
+    const data = thing.data ?? {};
+    const replies = data.replies?.data?.children ?? [];
+    const permalink = typeof data.permalink === 'string' ? data.permalink : undefined;
+    return {
+        id: String(data.id ?? ''),
+        author: String(data.author ?? '[deleted]'),
+        body: String(data.body ?? data.selftext ?? ''),
+        permalink,
+        url: permalink ? `https://www.reddit.com${permalink}` : undefined,
+        replies: replies
+            .filter((child) => child.kind === 't1')
+            .map((child) => parseComment(child))
+    };
+}
+export async function getRecentSubredditPosts(subreddit, credentials, traceHooks) {
+    const response = (await callRedditApi(`/r/${encodeURIComponent(subreddit)}/new.json?raw_json=1&limit=100`, credentials, traceHooks));
+    const children = response.data?.children ?? [];
+    return children
+        .filter((item) => item.kind === 't3')
+        .map((item) => {
+        const data = item.data ?? {};
+        const postId = String(data.id ?? '');
+        const postSubreddit = String(data.subreddit ?? subreddit);
+        const permalink = String(data.permalink ?? `/r/${postSubreddit}/comments/${postId}/`);
+        return {
+            id: postId,
+            subreddit: postSubreddit,
+            title: String(data.title ?? ''),
+            body: String(data.selftext ?? ''),
+            author: String(data.author ?? '[deleted]'),
+            url: `https://www.reddit.com${permalink}`,
+            postedAt: new Date((Number(data.created_utc ?? Date.now() / 1000) || Date.now() / 1000) * 1000).toISOString()
+        };
+    })
+        .filter((post) => post.author !== 'AutoModerator');
+}
+export async function getRedditPostComments(postId, credentials, traceHooks) {
+    const response = (await callRedditApi(`/comments/${encodeURIComponent(postId)}.json?raw_json=1&limit=500`, credentials, traceHooks));
+    const listing = response[1];
+    const comments = listing?.data?.children ?? [];
+    return comments.filter((item) => item.kind === 't1').map((item) => parseComment(item));
+}
+//# sourceMappingURL=client.js.map

package/dist/src/services/reddit/client.js.map

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

package/dist/src/services/scheduler/cronScheduler.d.ts

@@ -0,0 +1,11 @@
+export declare class CronScheduler {
+    private readonly jobsRepo;
+    private readonly settingsRepo;
+    private readonly runner;
+    private readonly tasks;
+    private readonly running;
+    start(): void;
+    stop(): void;
+    reload(): void;
+    registerJob(jobId: string): void;
+}

package/dist/src/services/scheduler/cronScheduler.js

@@ -0,0 +1,76 @@
+import cron from 'node-cron';
+import { JobsRepository } from '../db/repositories/jobsRepo.js';
+import { SettingsRepository } from '../db/repositories/settingsRepo.js';
+import { JobRunner } from './jobRunner.js';
+import { logger } from '../../utils/logger.js';
+import { intervalToCron } from '../../types/settings.js';
+export class CronScheduler {
+    jobsRepo = new JobsRepository();
+    settingsRepo = new SettingsRepository();
+    runner = new JobRunner();
+    tasks = new Map();
+    running = new Set();
+    start() {
+        const jobs = this.jobsRepo.listEnabled();
+        jobs.forEach((job) => this.registerJob(job.id));
+        logger.info(`Scheduler started with ${jobs.length} enabled jobs.`);
+    }
+    stop() {
+        this.tasks.forEach((task) => task.stop());
+        this.tasks.clear();
+        logger.info('Scheduler stopped.');
+    }
+    reload() {
+        this.stop();
+        this.start();
+    }
+    registerJob(jobId) {
+        const job = this.jobsRepo.getById(jobId);
+        if (!job || !job.enabled) {
+            return;
+        }
+        const previous = this.tasks.get(jobId);
+        if (previous) {
+            previous.stop();
+        }
+        const { cronIntervalMinutes, jobTimeoutMs } = this.settingsRepo.getAppSettings();
+        const cronExpression = intervalToCron(cronIntervalMinutes);
+        const task = cron.schedule(cronExpression, async () => {
+            if (this.running.has(jobId)) {
+                logger.warn(`Job ${jobId} is already running, skipping tick.`);
+                return;
+            }
+            this.running.add(jobId);
+            try {
+                const fresh = this.jobsRepo.getById(jobId);
+                if (!fresh || !fresh.enabled) {
+                    return;
+                }
+                const runPromise = this.runner.run(fresh);
+                if (jobTimeoutMs > 0) {
+                    let timeoutHandle;
+                    const timeoutPromise = new Promise((_, reject) => {
+                        timeoutHandle = setTimeout(() => reject(new Error(`Job ${jobId} timed out after ${jobTimeoutMs / 1000}s`)), jobTimeoutMs);
+                    });
+                    try {
+                        await Promise.race([runPromise, timeoutPromise]);
+                    }
+                    finally {
+                        clearTimeout(timeoutHandle);
+                    }
+                }
+                else {
+                    await runPromise;
+                }
+            }
+            catch (error) {
+                logger.error(`Scheduler error for job ${jobId}: ${String(error)}`);
+            }
+            finally {
+                this.running.delete(jobId);
+            }
+        });
+        this.tasks.set(jobId, task);
+    }
+}
+//# sourceMappingURL=cronScheduler.js.map

package/dist/src/services/scheduler/cronScheduler.js.map

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

package/dist/src/services/scheduler/jobRunner.d.ts

@@ -0,0 +1,76 @@
+import type { Job } from '../../types/job.js';
+export interface JobRunOptions {
+    maxNewItems?: number;
+    onProgress?: (event: JobRunProgressEvent) => void;
+}
+export type JobRunProgressEvent = {
+    type: 'run_start';
+    jobId: string;
+    jobName: string;
+    subredditCount: number;
+    maxNewItems?: number;
+} | {
+    type: 'run_skipped';
+    reason: 'missing_api_key';
+    message: string;
+} | {
+    type: 'subreddit_fetched';
+    subreddit: string;
+    postCount: number;
+} | {
+    type: 'post_scanned';
+    postId: string;
+    subreddit: string;
+    status: 'existing' | 'new';
+    title?: string;
+    bodySnippet?: string;
+    postUrl?: string;
+    qualified?: boolean;
+    qualificationReason?: string;
+    itemsNew: number;
+    itemsQualified: number;
+} | {
+    type: 'comments_loaded';
+    postId: string;
+    subreddit: string;
+    authors: number;
+    threads: number;
+} | {
+    type: 'comment_scanned';
+    postId: string;
+    commentId: string;
+    author: string;
+    status: 'existing' | 'new';
+    commentSnippet?: string;
+    postUrl?: string;
+    commentUrl?: string;
+    qualified?: boolean;
+    qualificationReason?: string;
+    itemsNew: number;
+    itemsQualified: number;
+} | {
+    type: 'limit_reached';
+    maxNewItems: number;
+    itemsNew: number;
+} | {
+    type: 'run_complete';
+    itemsDiscovered: number;
+    itemsNew: number;
+    itemsQualified: number;
+    promptTokens: number;
+    completionTokens: number;
+    estimatedCostUsd: number | null;
+} | {
+    type: 'run_failed';
+    message: string;
+};
+export declare class JobRunner {
+    private readonly settingsRepo;
+    private readonly runsRepo;
+    private readonly scanItemsRepo;
+    private emit;
+    run(job: Job, options?: JobRunOptions): Promise<void>;
+    private accumulateTokens;
+    private hasReachedLimit;
+    private estimateCost;
+}