opencandle 0.1.1 → 0.3.0

package/dist/runtime/workflow-runner.js

@@ -0,0 +1,129 @@
+import { createWorkflowRun, transitionStepStatus, } from "./workflow-types.js";
+let runCounter = 0;
+function generateRunId() {
+    runCounter += 1;
+    return `run_${Date.now()}_${runCounter}`;
+}
+/**
+ * Typed workflow execution engine with run IDs, step definitions,
+ * state transitions, cancellation, and event logging.
+ */
+export class WorkflowRunner {
+    eventLogger;
+    providerTracker;
+    activeRun = null;
+    constructor(options = {}) {
+        this.eventLogger = options.eventLogger;
+        this.providerTracker = options.providerTracker;
+    }
+    /** Get the currently active run, if any. */
+    getActiveRun() {
+        return this.activeRun;
+    }
+    /**
+     * Start a new workflow run. If a run is already active, it is cancelled first.
+     */
+    async start(workflowType, stepDefinitions, executor) {
+        // Cancel any active run
+        if (this.activeRun && this.activeRun.status === "running") {
+            this.cancel();
+        }
+        const runId = generateRunId();
+        const run = createWorkflowRun(runId, workflowType, stepDefinitions);
+        this.activeRun = run;
+        run.status = "running";
+        this.providerTracker?.resetAll();
+        this.logEvent(runId, 0, "workflow_started", {
+            workflowType,
+            stepCount: stepDefinitions.length,
+        });
+        // Execute steps
+        await this.executeSteps(run, executor);
+        return run;
+    }
+    /** Cancel the active run. */
+    cancel() {
+        const run = this.activeRun;
+        if (!run || run.status !== "running")
+            return;
+        for (let i = run.currentStepIndex; i < run.steps.length; i++) {
+            const step = run.steps[i];
+            if (step.status === "pending" || step.status === "running") {
+                step.status = transitionStepStatus(step.status, "skipped");
+                this.logEvent(run.runId, i, "step_skipped", {
+                    stepType: step.stepType,
+                    reason: "cancelled",
+                });
+            }
+        }
+        run.status = "cancelled";
+        this.logEvent(run.runId, run.currentStepIndex, "workflow_cancelled", {
+            cancelledAtStep: run.currentStepIndex,
+        });
+    }
+    async executeSteps(run, executor) {
+        for (let i = 0; i < run.steps.length; i++) {
+            // Check if run was cancelled externally
+            if (run.status !== "running")
+                return;
+            const step = run.steps[i];
+            run.currentStepIndex = i;
+            // Collect all prior evidence
+            const priorEvidence = [];
+            for (const [, output] of run.stepOutputs) {
+                priorEvidence.push(...output.evidence);
+            }
+            // Transition to running
+            step.status = transitionStepStatus(step.status, "running");
+            this.logEvent(run.runId, i, "step_started", { stepType: step.stepType });
+            try {
+                const context = {
+                    runId: run.runId,
+                    providerTracker: this.providerTracker,
+                };
+                const output = await executor(step, i, priorEvidence, context);
+                // If run was cancelled during execution, stop without further transitions
+                if (run.status !== "running")
+                    return;
+                step.status = transitionStepStatus(step.status, "completed");
+                run.stepOutputs.set(i, output);
+                this.logEvent(run.runId, i, "step_completed", {
+                    stepType: step.stepType,
+                    evidenceCount: output.evidence.length,
+                });
+            }
+            catch (error) {
+                // If run was cancelled during execution, stop without further transitions
+                if (run.status !== "running")
+                    return;
+                const message = error instanceof Error ? error.message : "unknown_error";
+                if (step.skippable) {
+                    step.status = transitionStepStatus(step.status, "skipped");
+                    this.logEvent(run.runId, i, "step_skipped", {
+                        stepType: step.stepType,
+                        reason: message,
+                    });
+                }
+                else {
+                    step.status = transitionStepStatus(step.status, "failed");
+                    this.logEvent(run.runId, i, "step_failed", {
+                        stepType: step.stepType,
+                        error: message,
+                    });
+                    run.status = "failed";
+                    return;
+                }
+            }
+        }
+        if (run.status === "running") {
+            run.status = "completed";
+            this.logEvent(run.runId, run.steps.length - 1, "workflow_completed", {
+                workflowType: run.workflowType,
+            });
+        }
+    }
+    logEvent(runId, stepIndex, eventType, payload) {
+        this.eventLogger?.log(runId, stepIndex, eventType, payload);
+    }
+}
+//# sourceMappingURL=workflow-runner.js.map

package/dist/runtime/workflow-runner.js.map

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

package/dist/runtime/workflow-types.d.ts

@@ -0,0 +1,60 @@
+import type { EvidenceRecord } from "./evidence.js";
+/** Status of a single workflow step. */
+export type StepStatus = "pending" | "running" | "completed" | "failed" | "skipped";
+/** Overall status of a workflow run. */
+export type RunStatus = "pending" | "running" | "completed" | "failed" | "cancelled";
+/** Check whether a step status transition is valid. */
+export declare function isValidStepTransition(from: StepStatus, to: StepStatus): boolean;
+/** Transition a step status, throwing on invalid transitions. */
+export declare function transitionStepStatus(from: StepStatus, to: StepStatus): StepStatus;
+/** Definition of a single workflow step. */
+export interface WorkflowStep {
+    stepType: string;
+    description: string;
+    requiredInputs: string[];
+    expectedOutputs: string[];
+    skippable: boolean;
+    status: StepStatus;
+}
+/** Output produced by a completed workflow step. */
+export interface StepOutput {
+    stepIndex: number;
+    stepType: string;
+    evidence: EvidenceRecord[];
+    rawText?: string;
+}
+/** Analyst signal direction. */
+export type AnalystSignal = "BUY" | "HOLD" | "SELL";
+/** Structured output from a single analyst role. */
+export interface AnalystOutput {
+    role: string;
+    signal: AnalystSignal;
+    conviction: number;
+    thesis: string;
+    evidence: EvidenceRecord[];
+    rawText?: string;
+}
+/** Debate side in bull/bear adversarial debate. */
+export type DebateSide = "bull" | "bear";
+/** Structured output from a debate step (eval/test only — not used in live path). */
+export interface DebateOutput {
+    side: DebateSide;
+    thesis: string;
+    keyRisk: string;
+    concessions: string[];
+    remainingConviction: number;
+    evidence: EvidenceRecord[];
+    rawText: string;
+}
+/** A complete workflow run definition and state. */
+export interface WorkflowRun {
+    runId: string;
+    workflowType: string;
+    steps: WorkflowStep[];
+    currentStepIndex: number;
+    status: RunStatus;
+    stepOutputs: Map<number, StepOutput>;
+    createdAt: string;
+}
+/** Create a new workflow run with all steps in pending state. */
+export declare function createWorkflowRun(runId: string, workflowType: string, stepDefinitions: Omit<WorkflowStep, "status">[]): WorkflowRun;

package/dist/runtime/workflow-types.js

@@ -0,0 +1,32 @@
+/** Valid step status transitions. */
+const VALID_STEP_TRANSITIONS = {
+    pending: ["running", "skipped"],
+    running: ["completed", "failed", "skipped"],
+    completed: [],
+    failed: [],
+    skipped: [],
+};
+/** Check whether a step status transition is valid. */
+export function isValidStepTransition(from, to) {
+    return VALID_STEP_TRANSITIONS[from].includes(to);
+}
+/** Transition a step status, throwing on invalid transitions. */
+export function transitionStepStatus(from, to) {
+    if (!isValidStepTransition(from, to)) {
+        throw new Error(`Invalid step transition: ${from} → ${to}`);
+    }
+    return to;
+}
+/** Create a new workflow run with all steps in pending state. */
+export function createWorkflowRun(runId, workflowType, stepDefinitions) {
+    return {
+        runId,
+        workflowType,
+        steps: stepDefinitions.map((def) => ({ ...def, status: "pending" })),
+        currentStepIndex: 0,
+        status: "pending",
+        stepOutputs: new Map(),
+        createdAt: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=workflow-types.js.map

package/dist/runtime/workflow-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-types.js","sourceRoot":"","sources":["../../src/runtime/workflow-types.ts"],"names":[],"mappings":"AAQA,qCAAqC;AACrC,MAAM,sBAAsB,GAAqC;IAC/D,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC;IAC/B,OAAO,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC;IAC3C,SAAS,EAAE,EAAE;IACb,MAAM,EAAE,EAAE;IACV,OAAO,EAAE,EAAE;CACZ,CAAC;AAEF,uDAAuD;AACvD,MAAM,UAAU,qBAAqB,CAAC,IAAgB,EAAE,EAAc;IACpE,OAAO,sBAAsB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,oBAAoB,CAAC,IAAgB,EAAE,EAAc;IACnE,IAAI,CAAC,qBAAqB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AA0DD,iEAAiE;AACjE,MAAM,UAAU,iBAAiB,CAC/B,KAAa,EACb,YAAoB,EACpB,eAA+C;IAE/C,OAAO;QACL,KAAK;QACL,YAAY;QACZ,KAAK,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE,SAAkB,EAAE,CAAC,CAAC;QAC7E,gBAAgB,EAAE,CAAC;QACnB,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,IAAI,GAAG,EAAE;QACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC"}

package/dist/sentiment/adapters/finnhub.d.ts

@@ -0,0 +1,7 @@
+import type { SentinelRecord } from "../types.js";
+import type { FinnhubArticle } from "../../providers/finnhub.js";
+export declare class FinnhubAdapter {
+    readonly source: "finnhub";
+    mapToRecords(articles: FinnhubArticle[], query: string): SentinelRecord[];
+}
+export declare function extractTickersFromQuery(query: string): string[];

package/dist/sentiment/adapters/finnhub.js

@@ -0,0 +1,39 @@
+import { randomUUID } from "node:crypto";
+import { extractEntities } from "../../routing/entity-extractor.js";
+const MAX_TICKERS = 3;
+export class FinnhubAdapter {
+    source = "finnhub";
+    mapToRecords(articles, query) {
+        const fetchedAt = new Date().toISOString();
+        return articles.map((article) => ({
+            id: randomUUID(),
+            source: this.source,
+            sourceId: String(article.id),
+            query,
+            title: article.headline,
+            text: article.summary,
+            author: article.source,
+            url: article.url,
+            publishedAt: new Date(article.datetime * 1000).toISOString(),
+            fetchedAt,
+            engagement: {
+                score: 0,
+                replies: null,
+                shares: null,
+                views: null,
+            },
+            sentiment: {
+                score: 0,
+                confidence: 0,
+                method: "keyword",
+                tickers: article.related ? article.related.split(",").map((t) => t.trim()).filter(Boolean) : [],
+            },
+            metadata: { category: article.category },
+        }));
+    }
+}
+export function extractTickersFromQuery(query) {
+    const entities = extractEntities(query);
+    return entities.symbols.slice(0, MAX_TICKERS);
+}
+//# sourceMappingURL=finnhub.js.map

package/dist/sentiment/adapters/finnhub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finnhub.js","sourceRoot":"","sources":["../../../src/sentiment/adapters/finnhub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEpE,MAAM,WAAW,GAAG,CAAC,CAAC;AAEtB,MAAM,OAAO,cAAc;IAChB,MAAM,GAAG,SAAkB,CAAC;IAErC,YAAY,CAAC,QAA0B,EAAE,KAAa;QACpD,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,QAAQ;YACvB,IAAI,EAAE,OAAO,CAAC,OAAO;YACrB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,WAAW,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;YAC5D,SAAS;YACT,UAAU,EAAE;gBACV,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;aACZ;YACD,SAAS,EAAE;gBACT,KAAK,EAAE,CAAC;gBACR,UAAU,EAAE,CAAC;gBACb,MAAM,EAAE,SAAkB;gBAC1B,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;aAChG;YACD,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE;SACzC,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;AAChD,CAAC"}

package/dist/sentiment/adapters/reddit.d.ts

@@ -0,0 +1,11 @@
+import type { SentinelRecord, SentimentAdapter } from "../types.js";
+import type { RedditSentimentResult } from "../../types/sentiment.js";
+import type { RedditComment } from "../../providers/reddit.js";
+export declare class RedditAdapter implements SentimentAdapter {
+    readonly source: "reddit";
+    mapPostsToRecords(result: RedditSentimentResult, query: string): SentinelRecord[];
+    mapCommentsToRecords(comments: RedditComment[], parentId: string, subreddit: string, query: string): SentinelRecord[];
+    fetch(_query: string, _options?: {
+        hours?: number;
+    }): Promise<SentinelRecord[]>;
+}

package/dist/sentiment/adapters/reddit.js

@@ -0,0 +1,54 @@
+import { randomUUID } from "node:crypto";
+export class RedditAdapter {
+    source = "reddit";
+    mapPostsToRecords(result, query) {
+        const fetchedAt = result.fetchedAt;
+        return result.posts.map((post) => ({
+            id: randomUUID(),
+            source: this.source,
+            sourceId: post.id,
+            query,
+            title: post.title,
+            text: post.selftext ? `${post.title}\n${post.selftext}` : post.title,
+            author: post.author,
+            url: post.url,
+            publishedAt: post.created,
+            fetchedAt,
+            engagement: {
+                score: post.score,
+                replies: post.comments,
+                shares: null,
+                views: null,
+            },
+            sentiment: { score: 0, confidence: 0, method: "keyword", tickers: [] },
+            metadata: { subreddit: result.subreddit },
+        }));
+    }
+    mapCommentsToRecords(comments, parentId, subreddit, query) {
+        const fetchedAt = new Date().toISOString();
+        return comments.map((comment) => ({
+            id: randomUUID(),
+            source: this.source,
+            sourceId: comment.id,
+            query,
+            title: null,
+            text: comment.body,
+            author: comment.author,
+            url: comment.permalink,
+            publishedAt: null,
+            fetchedAt,
+            engagement: {
+                score: comment.score,
+                replies: null,
+                shares: null,
+                views: null,
+            },
+            sentiment: { score: 0, confidence: 0, method: "keyword", tickers: [] },
+            metadata: { isComment: true, parentId, subreddit },
+        }));
+    }
+    async fetch(_query, _options) {
+        throw new Error("Use pipeline.run() instead of adapter.fetch() directly");
+    }
+}
+//# sourceMappingURL=reddit.js.map

package/dist/sentiment/adapters/reddit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reddit.js","sourceRoot":"","sources":["../../../src/sentiment/adapters/reddit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAKzC,MAAM,OAAO,aAAa;IACf,MAAM,GAAG,QAAiB,CAAC;IAEpC,iBAAiB,CAAC,MAA6B,EAAE,KAAa;QAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACjC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,EAAE;YACjB,KAAK;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK;YACpE,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,WAAW,EAAE,IAAI,CAAC,OAAO;YACzB,SAAS;YACT,UAAU,EAAE;gBACV,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,OAAO,EAAE,IAAI,CAAC,QAAQ;gBACtB,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;aACZ;YACD,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/E,QAAQ,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE;SAC1C,CAAC,CAAC,CAAC;IACN,CAAC;IAED,oBAAoB,CAClB,QAAyB,EACzB,QAAgB,EAChB,SAAiB,EACjB,KAAa;QAEb,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAChC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,OAAO,CAAC,EAAE;YACpB,KAAK;YACL,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,GAAG,EAAE,OAAO,CAAC,SAAS;YACtB,WAAW,EAAE,IAAI;YACjB,SAAS;YACT,UAAU,EAAE;gBACV,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;aACZ;YACD,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/E,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE;SACnD,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,QAA6B;QACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/sentiment/adapters/twitter.d.ts

@@ -0,0 +1,9 @@
+import type { SentinelRecord, SentimentAdapter } from "../types.js";
+import type { TwitterSentimentResult } from "../../types/sentiment.js";
+export declare class TwitterAdapter implements SentimentAdapter {
+    readonly source: "twitter";
+    mapToRecords(result: TwitterSentimentResult, query: string): SentinelRecord[];
+    fetch(_query: string, _options?: {
+        hours?: number;
+    }): Promise<SentinelRecord[]>;
+}

package/dist/sentiment/adapters/twitter.js

@@ -0,0 +1,32 @@
+import { randomUUID } from "node:crypto";
+export class TwitterAdapter {
+    source = "twitter";
+    mapToRecords(result, query) {
+        const fetchedAt = result.fetchedAt;
+        return result.tweets.map((tweet) => ({
+            id: randomUUID(),
+            source: this.source,
+            sourceId: tweet.id,
+            query,
+            title: null,
+            text: tweet.text,
+            author: tweet.author,
+            url: tweet.url,
+            publishedAt: tweet.created,
+            fetchedAt,
+            engagement: {
+                score: tweet.likes,
+                replies: tweet.replies,
+                shares: tweet.retweets,
+                views: tweet.views,
+            },
+            sentiment: { score: 0, confidence: 0, method: "keyword", tickers: [] },
+            metadata: {},
+        }));
+    }
+    async fetch(_query, _options) {
+        // Actual fetching is done by the pipeline via the provider
+        throw new Error("Use pipeline.run() instead of adapter.fetch() directly");
+    }
+}
+//# sourceMappingURL=twitter.js.map

package/dist/sentiment/adapters/twitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter.js","sourceRoot":"","sources":["../../../src/sentiment/adapters/twitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,OAAO,cAAc;IAChB,MAAM,GAAG,SAAkB,CAAC;IAErC,YAAY,CAAC,MAA8B,EAAE,KAAa;QACxD,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,OAAO,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACnC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,KAAK,CAAC,EAAE;YAClB,KAAK;YACL,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,WAAW,EAAE,KAAK,CAAC,OAAO;YAC1B,SAAS;YACT,UAAU,EAAE;gBACV,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,KAAK,CAAC,QAAQ;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;aACnB;YACD,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/E,QAAQ,EAAE,EAAE;SACb,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,QAA6B;QACvD,2DAA2D;QAC3D,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/sentiment/adapters/web.d.ts

@@ -0,0 +1,9 @@
+import type { SentinelRecord, SentimentAdapter } from "../types.js";
+import type { WebSearchEnvelope } from "../../types/sentiment.js";
+export declare class WebAdapter implements SentimentAdapter {
+    readonly source: "web";
+    mapToRecords(envelope: WebSearchEnvelope, query: string): SentinelRecord[];
+    fetch(_query: string, _options?: {
+        hours?: number;
+    }): Promise<SentinelRecord[]>;
+}

package/dist/sentiment/adapters/web.js

@@ -0,0 +1,40 @@
+import { randomUUID } from "node:crypto";
+export class WebAdapter {
+    source = "web";
+    mapToRecords(envelope, query) {
+        const fetchedAt = envelope.fetchedAt;
+        return envelope.results.map((result) => ({
+            id: randomUUID(),
+            source: this.source,
+            sourceId: canonicalizeUrl(result.url),
+            query,
+            title: result.title,
+            text: result.snippet,
+            author: result.source,
+            url: result.url,
+            publishedAt: result.published,
+            fetchedAt,
+            engagement: {
+                score: 0,
+                replies: null,
+                shares: null,
+                views: null,
+            },
+            sentiment: { score: 0, confidence: 0, method: "keyword", tickers: [] },
+            metadata: { category: result.category, provider: envelope.provider },
+        }));
+    }
+    async fetch(_query, _options) {
+        throw new Error("Use pipeline.run() instead of adapter.fetch() directly");
+    }
+}
+function canonicalizeUrl(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.origin + parsed.pathname;
+    }
+    catch {
+        return url;
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/sentiment/adapters/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/sentiment/adapters/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,MAAM,OAAO,UAAU;IACZ,MAAM,GAAG,KAAc,CAAC;IAEjC,YAAY,CAAC,QAA2B,EAAE,KAAa;QACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC;QACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACvC,EAAE,EAAE,UAAU,EAAE;YAChB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC;YACrC,KAAK;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,IAAI,EAAE,MAAM,CAAC,OAAO;YACpB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,WAAW,EAAE,MAAM,CAAC,SAAS;YAC7B,SAAS;YACT,UAAU,EAAE;gBACV,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,KAAK,EAAE,IAAI;aACZ;YACD,SAAS,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,MAAM,EAAE,SAAkB,EAAE,OAAO,EAAE,EAAE,EAAE;YAC/E,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;SACrE,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAc,EAAE,QAA6B;QACvD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;IAC5E,CAAC;CACF;AAED,SAAS,eAAe,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/sentiment/index.d.ts

@@ -0,0 +1,16 @@
+export type { SentinelRecord, SentinelEngagement, SentinelSentiment, SentimentAdapter, ScorerOptions, TrendBucket, TrendResult, DivergenceResult, SentimentSummary, SentimentSource, } from "./types.js";
+export { isSentinelRecord, SENTIMENT_SOURCES } from "./types.js";
+export { SentimentStore } from "./store.js";
+export { scoreRecords, keywordScore } from "./scorer.js";
+export { SentimentPipeline } from "./pipeline.js";
+export { renderSparkline, computeTrend, computeDivergence } from "./trends.js";
+export { BULLISH_TERMS, BEARISH_TERMS } from "./keywords.js";
+export { TwitterAdapter } from "./adapters/twitter.js";
+export { RedditAdapter } from "./adapters/reddit.js";
+export { WebAdapter } from "./adapters/web.js";
+import { SentimentStore } from "./store.js";
+import { SentimentPipeline } from "./pipeline.js";
+export declare function getSentimentStore(): SentimentStore;
+export declare function getSentimentPipeline(): SentimentPipeline;
+/** For testing: reset singletons */
+export declare function _resetSentimentSingletons(): void;

package/dist/sentiment/index.js

@@ -0,0 +1,44 @@
+export { isSentinelRecord, SENTIMENT_SOURCES } from "./types.js";
+export { SentimentStore } from "./store.js";
+export { scoreRecords, keywordScore } from "./scorer.js";
+export { SentimentPipeline } from "./pipeline.js";
+export { renderSparkline, computeTrend, computeDivergence } from "./trends.js";
+export { BULLISH_TERMS, BEARISH_TERMS } from "./keywords.js";
+export { TwitterAdapter } from "./adapters/twitter.js";
+export { RedditAdapter } from "./adapters/reddit.js";
+export { WebAdapter } from "./adapters/web.js";
+import { SentimentStore } from "./store.js";
+import { SentimentPipeline } from "./pipeline.js";
+import { getConfig } from "../config.js";
+import { resolveOpenCandlePath } from "../infra/opencandle-paths.js";
+let _pipeline = null;
+let _store = null;
+export function getSentimentStore() {
+    if (!_store) {
+        const dbPath = resolveOpenCandlePath("sentinel.db");
+        _store = new SentimentStore(dbPath);
+        const config = getConfig();
+        _store.prune(config.sentiment?.retentionDays ?? 30);
+    }
+    return _store;
+}
+export function getSentimentPipeline() {
+    if (!_pipeline) {
+        const store = getSentimentStore();
+        const config = getConfig();
+        _pipeline = new SentimentPipeline(store, config.sentiment);
+    }
+    return _pipeline;
+}
+/** For testing: reset singletons */
+export function _resetSentimentSingletons() {
+    if (_store) {
+        try {
+            _store.close();
+        }
+        catch { /* ignore */ }
+    }
+    _pipeline = null;
+    _store = null;
+}
+//# sourceMappingURL=index.js.map

package/dist/sentiment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sentiment/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,IAAI,SAAS,GAA6B,IAAI,CAAC;AAC/C,IAAI,MAAM,GAA0B,IAAI,CAAC;AAEzC,MAAM,UAAU,iBAAiB;IAC/B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC;QACpD,MAAM,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,IAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,KAAK,GAAG,iBAAiB,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;QAC3B,SAAS,GAAG,IAAI,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAU,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,yBAAyB;IACvC,IAAI,MAAM,EAAE,CAAC;QACX,IAAI,CAAC;YAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAChD,CAAC;IACD,SAAS,GAAG,IAAI,CAAC;IACjB,MAAM,GAAG,IAAI,CAAC;AAChB,CAAC"}

package/dist/sentiment/keywords.d.ts

@@ -0,0 +1,2 @@
+export declare const BULLISH_TERMS: readonly ["moon", "buy", "undervalued", "breakout", "calls", "bullish", "rocket", "diamond hands", "accumulate", "dip buy", "long", "rip", "squeeze"];
+export declare const BEARISH_TERMS: readonly ["crash", "overvalued", "sell", "puts", "bearish", "bubble", "dump", "short", "bagholding", "exit", "drill", "tank", "rug"];

package/dist/sentiment/keywords.js

@@ -0,0 +1,9 @@
+export const BULLISH_TERMS = [
+    "moon", "buy", "undervalued", "breakout", "calls", "bullish",
+    "rocket", "diamond hands", "accumulate", "dip buy", "long", "rip", "squeeze",
+];
+export const BEARISH_TERMS = [
+    "crash", "overvalued", "sell", "puts", "bearish", "bubble",
+    "dump", "short", "bagholding", "exit", "drill", "tank", "rug",
+];
+//# sourceMappingURL=keywords.js.map

package/dist/sentiment/keywords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keywords.js","sourceRoot":"","sources":["../../src/sentiment/keywords.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS;IAC5D,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS;CACpE,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ;IAC1D,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK;CACrD,CAAC"}

package/dist/sentiment/pipeline.d.ts

@@ -0,0 +1,9 @@
+import type { SentinelRecord, SentimentSummary } from "./types.js";
+import type { SentimentConfig } from "../config.js";
+import { SentimentStore } from "./store.js";
+export declare class SentimentPipeline {
+    private store;
+    private config;
+    constructor(store: SentimentStore, config: SentimentConfig);
+    processRecords(records: SentinelRecord[], query: string): Promise<SentimentSummary>;
+}

package/dist/sentiment/pipeline.js

@@ -0,0 +1,57 @@
+import { scoreRecords } from "./scorer.js";
+import { computeTrend, computeDivergence } from "./trends.js";
+export class SentimentPipeline {
+    store;
+    config;
+    constructor(store, config) {
+        this.store = store;
+        this.config = config;
+    }
+    async processRecords(records, query) {
+        const warnings = [];
+        if (records.length === 0) {
+            return { fresh: [], trend: null, divergence: null, warnings };
+        }
+        // Check if store had prior data before this fetch
+        const priorSeries = this.store.getTimeSeries(query, { days: 30, bucketHours: 24 });
+        const hadPriorData = priorSeries.length >= 2;
+        // Score all records
+        const scored = scoreRecords(records);
+        // Insert into store
+        this.store.insert(scored);
+        // Compute trend from historical data (only if we had prior data)
+        let trend = null;
+        if (hadPriorData) {
+            const series = this.store.getTimeSeries(query, { days: 7, bucketHours: 24 });
+            if (series.length >= 2) {
+                trend = [computeTrend(series, "aggregate")];
+            }
+        }
+        // Compute divergence from fresh records
+        let divergence = null;
+        const sourceGroups = groupBySource(scored);
+        const sourceStats = {};
+        for (const [source, recs] of Object.entries(sourceGroups)) {
+            // Exclude comments from divergence calculation
+            const postLevel = recs.filter((r) => !r.metadata.isComment);
+            if (postLevel.length > 0) {
+                const avg = postLevel.reduce((sum, r) => sum + r.sentiment.score, 0) / postLevel.length;
+                sourceStats[source] = { avg, count: postLevel.length };
+            }
+        }
+        if (Object.keys(sourceStats).length >= 2) {
+            divergence = computeDivergence(sourceStats, this.config.divergenceThreshold);
+        }
+        return { fresh: scored, trend, divergence, warnings };
+    }
+}
+function groupBySource(records) {
+    const groups = {};
+    for (const r of records) {
+        if (!groups[r.source])
+            groups[r.source] = [];
+        groups[r.source].push(r);
+    }
+    return groups;
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/sentiment/pipeline.js.map

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

package/dist/sentiment/scorer.d.ts

@@ -0,0 +1,9 @@
+import type { SentinelRecord } from "./types.js";
+interface ScoreResult {
+    score: number;
+    confidence: number;
+    tickers: string[];
+}
+export declare function keywordScore(record: SentinelRecord): ScoreResult;
+export declare function scoreRecords(records: SentinelRecord[]): SentinelRecord[];
+export {};