opencandle 0.6.0 → 0.7.0

package/dist/tools/sentiment/twitter-sentiment.js

@@ -1,8 +1,13 @@
 import { Type } from "@sinclair/typebox";
+import { promptUser } from "../../onboarding/prompt-user.js";
+import { getProvider } from "../../onboarding/providers.js";
+import { loadOnboardingState, markProviderNeverAsk, saveOnboardingState, } from "../../onboarding/state.js";
+import { buildExternalToolRequiredTag, buildSkippedTag } from "../../onboarding/tool-tags.js";
 import { getTwitterSentiment } from "../../providers/twitter.js";
 import { wrapProvider } from "../../providers/wrap-provider.js";
 import { TwitterAdapter } from "../../sentiment/adapters/twitter.js";
 import { getSentimentPipeline } from "../../sentiment/index.js";
+import { formatInsightSection } from "./insight-format.js";
 import { renderUntrustedText, untrustedContentHeader } from "./untrusted-text.js";
 const params = Type.Object({
     query: Type.String({
@@ -11,72 +16,190 @@ const params = Type.Object({
     limit: Type.Optional(Type.Number({ description: "Max tweets to fetch. Default: 50, max: 200" })),
     hours: Type.Optional(Type.Number({ description: "Lookback window in hours. Default: 24" })),
 });
-export const twitterSentimentTool = {
-    name: "get_twitter_sentiment",
-    label: "Twitter Sentiment",
-    description: "Fetch recent tweets for a stock ticker or search query and compute engagement-weighted sentiment. Returns tweet data, sentiment score, and co-mentioned tickers. Requires a Twitter session via trigger_twitter_login.",
-    parameters: params,
-    async execute(_toolCallId, args) {
-        const limit = Math.min(args.limit ?? 50, 200);
-        const hours = args.hours ?? 24;
-        const providerResult = await wrapProvider("twitter", () => getTwitterSentiment(args.query, limit, hours));
-        if (providerResult.status === "unavailable") {
-            const isLoginIssue = providerResult.reason.includes("No Twitter session") ||
-                providerResult.reason.includes("session expired");
-            const text = isLoginIssue
-                ? `⚠ Twitter sentiment unavailable: ${providerResult.reason}\n[LOGIN_NEEDED] Use ask_user to confirm, then call trigger_twitter_login. After success, retry this tool.`
-                : `⚠ Twitter sentiment unavailable (${providerResult.reason}).`;
-            return {
-                content: [{ type: "text", text }],
-                details: null,
-            };
-        }
-        const result = providerResult.data;
-        const sentimentLabel = result.sentimentScore > 0.3
-            ? "Bullish"
-            : result.sentimentScore < -0.3
-                ? "Bearish"
-                : result.sentimentScore > 0
-                    ? "Leaning Bullish"
-                    : result.sentimentScore < 0
-                        ? "Leaning Bearish"
-                        : "Neutral";
-        const lines = [
-            `**Twitter: ${result.query}** — ${result.tweetCount} tweets (last ${hours}h, ${result.fetchedAt})`,
-            `Sentiment: ${result.sentimentScore.toFixed(2)} (${sentimentLabel}) | Bullish: ${result.bullishCount} | Bearish: ${result.bearishCount}`,
-        ];
-        if (result.topMentions.length > 0) {
-            lines.push(`Co-mentions: ${result.topMentions.map((t) => `$${t}`).join(", ")}`);
-        }
+const INSTALL_CONTINUE_LABEL = "Continue after installing twitter-cli";
+const SESSION_CONTINUE_LABEL = "Continue after refreshing X/Twitter session";
+const SKIP_ONCE_LABEL = "Skip X/Twitter once";
+const ALWAYS_SKIP_LABEL = "Always skip X/Twitter";
+export function createTwitterSentimentTool(options = {}) {
+    return {
+        name: "get_twitter_sentiment",
+        label: "Twitter Sentiment",
+        description: "Fetch recent tweets for a stock ticker or search query and compute engagement-weighted sentiment. Returns tweet data, sentiment score, and co-mentioned tickers. Requires twitter-cli and a browser X/Twitter session.",
+        parameters: params,
+        async execute(_toolCallId, args, _signal, _onUpdate, ctx) {
+            const limit = Math.min(args.limit ?? 50, 200);
+            const hours = args.hours ?? 24;
+            const descriptor = getProvider("twitter");
+            const state = loadOnboardingState();
+            if (state.providers.twitter?.status === "never_ask") {
+                return skippedResult("You previously asked not to be reminded about X/Twitter.", true, "run opencandle doctor --enable twitter to re-enable X/Twitter sentiment (silenced)");
+            }
+            const fetchTwitterSentiment = () => wrapProvider("twitter", () => getTwitterSentiment(args.query, limit, hours));
+            const providerResult = await fetchTwitterSentiment();
+            if (providerResult.status === "unavailable") {
+                const reason = providerResult.reason;
+                const unavailableKind = classifyUnavailableReason(reason);
+                const askUserHandler = options.askUserHandler ??
+                    ctx?.askUserHandler;
+                const canAsk = askUserHandler != null || ctx?.hasUI === true;
+                if (unavailableKind !== "other" && canAsk) {
+                    const promptResult = await promptUser((ctx ?? { hasUI: false }), {
+                        question: setupQuestion(unavailableKind, reason),
+                        questionType: "select",
+                        options: [
+                            unavailableKind === "install" ? INSTALL_CONTINUE_LABEL : SESSION_CONTINUE_LABEL,
+                            SKIP_ONCE_LABEL,
+                            ALWAYS_SKIP_LABEL,
+                        ],
+                        reason: "X/Twitter sentiment needs the twitter-cli command and a browser session before it can fetch tweets.",
+                    }, askUserHandler);
+                    if (!promptResult.cancelled && promptResult.answer?.startsWith("Continue")) {
+                        const retried = await fetchTwitterSentiment();
+                        if (retried.status === "ok") {
+                            return formatTwitterSentimentResult(retried.data, args.query, hours, {
+                                stale: retried.stale,
+                                timestamp: retried.timestamp,
+                            });
+                        }
+                        return passiveUnavailableResult(retried.reason, classifyUnavailableReason(retried.reason), { interceptable: false });
+                    }
+                    if (!promptResult.cancelled && promptResult.answer === ALWAYS_SKIP_LABEL) {
+                        saveOnboardingState(markProviderNeverAsk(state, "twitter"));
+                        return skippedResult(`User chose to always skip ${descriptor.displayName} data. Do not ask about X/Twitter setup again unless the user explicitly reconnects it.`, true, "run opencandle doctor --enable twitter to re-enable X/Twitter sentiment (silenced)");
+                    }
+                    return skippedResult(`User chose to skip ${descriptor.displayName} data for this request. Do not ask about X/Twitter setup again in this turn.`, false, "user chose to skip X/Twitter for this request");
+                }
+                return passiveUnavailableResult(reason, unavailableKind);
+            }
+            return formatTwitterSentimentResult(providerResult.data, args.query, hours, {
+                stale: providerResult.stale,
+                timestamp: providerResult.timestamp,
+            });
+        },
+    };
+}
+export const twitterSentimentTool = createTwitterSentimentTool();
+function classifyUnavailableReason(reason) {
+    if (reason.includes("not installed") || reason.includes("uv tool install"))
+        return "install";
+    if (/no twitter cookies|no cookies|401|unauthorized|expired|session/i.test(reason)) {
+        return "session";
+    }
+    return "other";
+}
+function setupQuestion(kind, reason) {
+    if (kind === "install") {
+        return `X/Twitter sentiment requires twitter-cli. Install it with \`uv tool install twitter-cli\`, then choose whether to continue or skip X/Twitter. Current status: ${reason}`;
+    }
+    return `X/Twitter sentiment needs an active browser session. Log into or refresh x.com in a supported browser, then choose whether to continue or skip X/Twitter. Current status: ${reason}`;
+}
+function passiveUnavailableResult(reason, kind, options = {}) {
+    if ((options.interceptable ?? true) && (kind === "install" || kind === "session")) {
+        const tag = buildExternalToolRequiredTag({
+            provider: "twitter",
+            reason: kind === "install"
+                ? "not_installed"
+                : /401|unauthorized|expired/i.test(reason)
+                    ? "session_stale"
+                    : "session_missing",
+            installCmd: "uv tool install twitter-cli",
+            loginCmd: "log into x.com in a supported browser",
+            fallback: "reddit-web-news",
+        });
+        const guidance = kind === "install"
+            ? "Twitter sentiment requires twitter-cli. Install it with `uv tool install twitter-cli`, then choose whether to continue or skip X/Twitter."
+            : "Twitter sentiment requires an active X/Twitter browser session. Log into or refresh x.com in a supported browser, then retry after confirmation.";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `⚠ Twitter sentiment unavailable: ${reason}\n${tag}\n${guidance}`,
+                },
+            ],
+            details: null,
+        };
+    }
+    const text = `⚠ Twitter sentiment unavailable (${reason}).`;
+    return {
+        content: [{ type: "text", text }],
+        details: null,
+    };
+}
+function skippedResult(message, silenced, remediation) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: `${buildSkippedTag({
+                    provider: "twitter",
+                    reason: "credential_not_provided",
+                    remediation,
+                    silenced,
+                })}\n\n${message}`,
+            },
+        ],
+        details: null,
+    };
+}
+async function formatTwitterSentimentResult(result, query, hours, metadata) {
+    const sentimentLabel = result.sentimentScore > 0.3
+        ? "Bullish"
+        : result.sentimentScore < -0.3
+            ? "Bearish"
+            : result.sentimentScore > 0
+                ? "Leaning Bullish"
+                : result.sentimentScore < 0
+                    ? "Leaning Bearish"
+                    : "Neutral";
+    const lines = [
+        `**Twitter: ${result.query}** — ${result.tweetCount} tweets (last ${hours}h, ${result.fetchedAt})`,
+        `Sentiment: ${result.sentimentScore.toFixed(2)} (${sentimentLabel}) | Bullish: ${result.bullishCount} | Bearish: ${result.bearishCount}`,
+    ];
+    if (result.topMentions.length > 0) {
+        lines.push(`Co-mentions: ${result.topMentions.map((t) => `$${t}`).join(", ")}`);
+    }
+    lines.push("");
+    lines.push(untrustedContentHeader("tweets"));
+    lines.push("| Author | Tweet | ❤️ | 🔁 | 💬 |");
+    lines.push("|--------|-------|----|----|----|");
+    const top = result.tweets.slice(0, 15);
+    for (const tweet of top) {
+        const text = renderUntrustedText(tweet.text, 100);
+        lines.push(`| @${tweet.author} | ${text} | ${tweet.likes} | ${tweet.retweets} | ${tweet.replies} |`);
+    }
+    if (metadata.stale) {
         lines.push("");
-        lines.push(untrustedContentHeader("tweets"));
-        lines.push("| Author | Tweet | ❤️ | 🔁 | 💬 |");
-        lines.push("|--------|-------|----|----|----|");
-        const top = result.tweets.slice(0, 15);
-        for (const tweet of top) {
-            const text = renderUntrustedText(tweet.text, 100);
-            lines.push(`| @${tweet.author} | ${text} | ${tweet.likes} | ${tweet.retweets} | ${tweet.replies} |`);
+        lines.push(`⚠ Stale data (cached at ${metadata.timestamp})`);
+    }
+    let details = result;
+    // Index in sentiment store and append trend context
+    try {
+        const adapter = new TwitterAdapter();
+        const records = adapter.mapToRecords(result, query);
+        const pipeline = getSentimentPipeline();
+        const pipelineResult = await pipeline.processRecords(records, query);
+        if (pipelineResult.insight) {
+            const insight = metadata.stale
+                ? {
+                    ...pipelineResult.insight,
+                    caveats: [
+                        ...pipelineResult.insight.caveats,
+                        `Stale data cached at ${metadata.timestamp}.`,
+                    ],
+                }
+                : pipelineResult.insight;
+            details = { ...result, insight };
+            lines.push(...formatInsightSection(insight));
         }
-        if (providerResult.stale) {
+        if (pipelineResult.trend && pipelineResult.trend.length > 0) {
+            const t = pipelineResult.trend[0];
             lines.push("");
-            lines.push(`⚠ Stale data (cached at ${providerResult.timestamp})`);
-        }
-        // Index in sentiment store and append trend context
-        try {
-            const adapter = new TwitterAdapter();
-            const records = adapter.mapToRecords(result, args.query);
-            const pipeline = getSentimentPipeline();
-            const pipelineResult = await pipeline.processRecords(records, args.query);
-            if (pipelineResult.trend && pipelineResult.trend.length > 0) {
-                const t = pipelineResult.trend[0];
-                lines.push("");
-                lines.push(`Trend: ${t.sparkline} ${t.direction} (${t.delta >= 0 ? "+" : ""}${t.delta.toFixed(2)}, ${t.count} records)`);
-            }
-        }
-        catch {
-            // Sentiment indexing is best-effort — don't fail the tool
+            lines.push(`Trend: ${t.sparkline} ${t.direction} (${t.delta >= 0 ? "+" : ""}${t.delta.toFixed(2)}, ${t.count} records)`);
         }
-        return { content: [{ type: "text", text: lines.join("\n") }], details: result };
-    },
-};
+    }
+    catch {
+        // Sentiment indexing is best-effort — don't fail the tool
+    }
+    return { content: [{ type: "text", text: lines.join("\n") }], details };
+}
 //# sourceMappingURL=twitter-sentiment.js.map

package/dist/tools/sentiment/twitter-sentiment.js.map

@@ -1 +1 @@
-{"version":3,"file":"twitter-sentiment.js","sourceRoot":"","sources":["../../../src/tools/sentiment/twitter-sentiment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzB,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;QACjB,WAAW,EAAE,qEAAqE;KACnF,CAAC;IACF,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC,CAAC;IAChG,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,uCAAuC,EAAE,CAAC,CAAC;CAC5F,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAqD;IACpF,IAAI,EAAE,uBAAuB;IAC7B,KAAK,EAAE,mBAAmB;IAC1B,WAAW,EACT,wNAAwN;IAC1N,UAAU,EAAE,MAAM;IAClB,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;QAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAE/B,MAAM,cAAc,GAAG,MAAM,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,CACxD,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAC9C,CAAC;QAEF,IAAI,cAAc,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;YAC5C,MAAM,YAAY,GAChB,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC;gBACpD,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,YAAY;gBACvB,CAAC,CAAC,oCAAoC,cAAc,CAAC,MAAM,4GAA4G;gBACvK,CAAC,CAAC,oCAAoC,cAAc,CAAC,MAAM,IAAI,CAAC;YAClE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;gBACjC,OAAO,EAAE,IAAW;aACrB,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC;QAEnC,MAAM,cAAc,GAClB,MAAM,CAAC,cAAc,GAAG,GAAG;YACzB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC,GAAG;gBAC5B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC;oBACzB,CAAC,CAAC,iBAAiB;oBACnB,CAAC,CAAC,MAAM,CAAC,cAAc,GAAG,CAAC;wBACzB,CAAC,CAAC,iBAAiB;wBACnB,CAAC,CAAC,SAAS,CAAC;QAEtB,MAAM,KAAK,GAAG;YACZ,cAAc,MAAM,CAAC,KAAK,QAAQ,MAAM,CAAC,UAAU,iBAAiB,KAAK,MAAM,MAAM,CAAC,SAAS,GAAG;YAClG,cAAc,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,cAAc,gBAAgB,MAAM,CAAC,YAAY,eAAe,MAAM,CAAC,YAAY,EAAE;SACzI,CAAC;QAEF,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAClD,KAAK,CAAC,IAAI,CACR,MAAM,KAAK,CAAC,MAAM,MAAM,IAAI,MAAM,KAAK,CAAC,KAAK,MAAM,KAAK,CAAC,QAAQ,MAAM,KAAK,CAAC,OAAO,IAAI,CACzF,CAAC;QACJ,CAAC;QAED,IAAI,cAAc,CAAC,KAAK,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,2BAA2B,cAAc,CAAC,SAAS,GAAG,CAAC,CAAC;QACrE,CAAC;QAED,oDAAoD;QACpD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;YACrC,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;YACxC,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1E,IAAI,cAAc,CAAC,KAAK,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5D,MAAM,CAAC,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAClC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACf,KAAK,CAAC,IAAI,CACR,UAAU,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,WAAW,CAC7G,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,0DAA0D;QAC5D,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClF,CAAC;CACF,CAAC"}
+{"version":3,"file":"twitter-sentiment.js","sourceRoot":"","sources":["../../../src/tools/sentiment/twitter-sentiment.ts"],"names":[],"mappings":"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"}

package/dist/tools/sentiment/web-sentiment.js

@@ -2,6 +2,7 @@ import { Type } from "@sinclair/typebox";
 import { searchWeb } from "../../providers/web-search.js";
 import { WebAdapter } from "../../sentiment/adapters/web.js";
 import { getSentimentPipeline } from "../../sentiment/index.js";
+import { formatInsightSection } from "./insight-format.js";
 import { renderUntrustedText, untrustedContentHeader } from "./untrusted-text.js";
 const params = Type.Object({
     query: Type.String({ description: "Ticker or topic to search for web/news sentiment" }),
@@ -42,6 +43,9 @@ export const webSentimentTool = {
             const avgScore = result.fresh.reduce((s, r) => s + r.sentiment.score, 0) / result.fresh.length;
             const label = sentimentLabel(avgScore);
             lines.push(`**Web sentiment for "${args.query}"** — ${result.fresh.length} results (${label}, ${avgScore.toFixed(2)})`);
+            if (result.insight) {
+                lines.push(...formatInsightSection(result.insight));
+            }
             lines.push("");
             lines.push(untrustedContentHeader("web sentiment results"));
             for (const rec of result.fresh.slice(0, limit)) {

package/dist/tools/sentiment/web-sentiment.js.map

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

package/dist/types/sentiment.d.ts

@@ -1,3 +1,4 @@
+import type { SentinelRecord } from "../sentiment/types.js";
 export interface FearGreedData {
     value: number;
     label: string;
@@ -17,6 +18,54 @@ export interface TwitterTweet {
     url: string;
     created: string;
 }
+export type SentimentInsightMethod = "deterministic-keyword-v1" | "llm";
+export type SentimentConfidenceLevel = "low" | "medium" | "high";
+export interface SentimentInsightConfidence {
+    level: SentimentConfidenceLevel;
+    score: number;
+    reasons: string[];
+}
+export interface SentimentInsightDriver {
+    label: string;
+    count: number;
+    polarity: "positive" | "negative" | "mixed";
+    terms: string[];
+    sourceIds: string[];
+}
+export interface SentimentRepresentativeItem {
+    source: "twitter" | "reddit" | "web" | "finnhub" | "aggregate";
+    sourceId: string;
+    title: string | null;
+    excerpt: string;
+    url: string | null;
+    author: string | null;
+    publishedAt: string | null;
+    engagement: number | null;
+    score: number;
+    matchedTerms: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface SentimentSourceCoverage {
+    sources: string[];
+    counts: Record<string, number>;
+    missingSources?: string[];
+    notes?: string[];
+}
+export interface SentimentInsight {
+    label: string;
+    score: number;
+    sampleSize: number;
+    scoredSampleSize: number;
+    confidence: SentimentInsightConfidence;
+    positiveDrivers: SentimentInsightDriver[];
+    negativeDrivers: SentimentInsightDriver[];
+    mixedDrivers: SentimentInsightDriver[];
+    notableClaims: string[];
+    representativeItems: SentimentRepresentativeItem[];
+    sourceCoverage: SentimentSourceCoverage;
+    caveats: string[];
+    method: SentimentInsightMethod;
+}
 export interface TwitterSentimentResult {
     query: string;
     tweetCount: number;
@@ -26,6 +75,7 @@ export interface TwitterSentimentResult {
     bearishCount: number;
     topMentions: string[];
     fetchedAt: string;
+    insight?: SentimentInsight;
 }
 export interface WebSearchResult {
     title: string;
@@ -62,4 +112,6 @@ export interface RedditSentimentResult {
     bullishCount: number;
     bearishCount: number;
     fetchedAt: string;
+    insight?: SentimentInsight;
+    records?: SentinelRecord[];
 }

package/gui/server/invoke-tool.ts

@@ -6,6 +6,7 @@ import { Value } from "@sinclair/typebox/value";
 import { getDefaults } from "../../src/memory/tool-defaults.js";
 import { wrapWithDefaults } from "../../src/runtime/tool-defaults-wrapper.js";
 import { getAllTools } from "../../src/tools/index.js";
+import type { AskUserHandler } from "../../src/types/index.js";
 import { buildToolInvokeAckMessage } from "./tool-invoke-ack.js";
 
 export interface InvokeToolResult {
@@ -30,6 +31,7 @@ export interface ToolInvokeControllerOptions {
   onMarketStateChanged?: () => void;
   getTools?: typeof getAllTools;
   invokeTool?: typeof invokeToolFromUi;
+  askUserHandler?: AskUserHandler;
 }
 
 export function createToolInvokeController({
@@ -39,6 +41,7 @@ export function createToolInvokeController({
   onMarketStateChanged,
   getTools = getAllTools,
   invokeTool = invokeToolFromUi,
+  askUserHandler,
 }: ToolInvokeControllerOptions): ToolInvokeController {
   async function handleToolInvoke(
     toolName: string,
@@ -47,7 +50,7 @@ export function createToolInvokeController({
     if (role !== "writer") throw new Error("Read-only follower mode");
     const tool = getTools().find((candidate) => candidate.name === toolName);
     if (!tool) throw new Error(`Unknown tool: ${toolName}`);
-    const result = await invokeTool(getSessionManager(), tool, args, "ui");
+    const result = await invokeTool(getSessionManager(), tool, args, "ui", { askUserHandler });
     if (!result.isError && marketStateToolMapping(toolName) != null) {
       onMarketStateChanged?.();
     }
@@ -94,7 +97,7 @@ export async function invokeToolFromUi(
   tool: AgentTool<TSchema, unknown>,
   args: Record<string, unknown>,
   source: "ui" | "background" = "ui",
-  options: { recordTranscript?: boolean } = {},
+  options: { askUserHandler?: AskUserHandler; recordTranscript?: boolean } = {},
 ): Promise<InvokeToolResult> {
   if (!Value.Check(tool.parameters, args)) {
     const errors = [...Value.Errors(tool.parameters, args)]
@@ -130,7 +133,18 @@ export async function invokeToolFromUi(
   let result: AgentToolResult<unknown>;
   let isError = false;
   try {
-    result = await wrapped.execute(toolCallId, args as never);
+    result = await (
+      wrapped.execute as (
+        id: string,
+        params: never,
+        signal: AbortSignal | undefined,
+        onUpdate: undefined,
+        ctx: { askUserHandler?: AskUserHandler; hasUI: false },
+      ) => ReturnType<typeof wrapped.execute>
+    )(toolCallId, args as never, undefined, undefined, {
+      askUserHandler: options.askUserHandler,
+      hasUI: false,
+    });
   } catch (error) {
     isError = true;
     result = {

package/gui/server/model-setup.ts

@@ -1,6 +1,10 @@
 import type { Api, Model } from "@earendil-works/pi-ai";
 import { persistProviderCredential } from "../../src/onboarding/connect.js";
-import { getCredentialSource, PROVIDERS, type ProviderId } from "../../src/onboarding/providers.js";
+import {
+  getCredentialSource,
+  isApiKeyProvider,
+  PROVIDERS,
+} from "../../src/onboarding/providers.js";
 import { validateCredential } from "../../src/onboarding/validation.js";
 
 export type ModelSetupRequirement = "ready" | "select_model" | "connect_auth";
@@ -193,6 +197,9 @@ export function createModelSetupController({
 
     const descriptor = PROVIDERS.find((candidate) => candidate.id === providerId);
     if (!descriptor) throw new Error(`Unknown provider: ${providerId}`);
+    if (!isApiKeyProvider(descriptor)) {
+      throw new Error(`${descriptor.displayName} is not configured with an API key.`);
+    }
 
     if (getCredentialSource(descriptor.id) === "env") {
       throw new Error(
@@ -203,7 +210,7 @@ export function createModelSetupController({
     const trimmed = apiKey.trim();
     if (!trimmed) throw new Error(`Paste a ${descriptor.displayName} API key first.`);
 
-    const validation = await validateCredential(descriptor.id as ProviderId, trimmed);
+    const validation = await validateCredential(descriptor.id, trimmed);
     if (validation.status === "invalid") {
       const statusHint =
         validation.httpStatus !== undefined ? ` (HTTP ${validation.httpStatus})` : "";
@@ -213,7 +220,7 @@ export function createModelSetupController({
       );
     }
 
-    persistProviderCredential(descriptor.id as ProviderId, trimmed);
+    persistProviderCredential(descriptor.id, trimmed);
 
     const verifiedNote =
       validation.status === "transient"

package/gui/server/projector.ts

@@ -36,6 +36,7 @@ const DIRECT_TOOL_GAP_PROVIDERS: Record<string, string> = {
   compare_companies: "alpha_vantage",
   get_economic_data: "fred",
   get_twitter_sentiment: "twitter",
+  get_reddit_sentiment: "reddit",
 };
 
 export function createEmptyDashboardState(): DashboardState {
@@ -213,7 +214,8 @@ function parseSkippedProviders(text: string): string[] {
 
 function parseSoftGapProviders(text: string): string[] {
   const providers: string[] = [];
-  const re = /\[OPENCANDLE_(?:SKIPPED|SOFT_DEGRADED)[^\]]*provider=([a-z0-9_-]+)/gi;
+  const re =
+    /\[OPENCANDLE_(?:SKIPPED|SOFT_DEGRADED|EXTERNAL_TOOL_REQUIRED)[^\]]*provider=([a-z0-9_-]+)/gi;
   while (true) {
     const match = re.exec(text);
     if (!match) break;
@@ -226,7 +228,9 @@ function inferDirectToolGapProvider(
   toolName: string | undefined,
   text: string,
 ): string | undefined {
-  if (!toolName || !/(?:⚠|unavailable|No .*data found|LOGIN_NEEDED)/i.test(text)) return undefined;
+  if (!toolName || !/(?:⚠|unavailable|No .*data found|EXTERNAL_TOOL_SETUP)/i.test(text)) {
+    return undefined;
+  }
   return DIRECT_TOOL_GAP_PROVIDERS[toolName];
 }
 

package/gui/server/server.ts

@@ -13,6 +13,7 @@ import {
   SettingsManager,
 } from "@earendil-works/pi-coding-agent";
 import { createOpenCandleSession } from "../../src/index.js";
+import { probeProviderStatus } from "../../src/onboarding/provider-status.js";
 import type { ChatEvent } from "../shared/chat-events.js";
 import { createAskUserBridge } from "./ask-user-bridge.js";
 import {
@@ -117,6 +118,7 @@ const toolInvokeController = createToolInvokeController({
   getSessionManager: () => sessionManager,
   broadcastState: () => wsHub.broadcastState(),
   onMarketStateChanged: () => quoteSnapshotStore.invalidate(),
+  askUserHandler: askUserBridge.ask,
 });
 const sessionActionsController = createSessionActionsController({
   role: lockResult.role,
@@ -226,6 +228,22 @@ async function handleHttpRequest(req: IncomingMessage, res: ServerResponse): Pro
     return;
   }
 
+  if (url.pathname === "/api/diagnostics/twitter-cli" && req.method === "GET") {
+    if (!allowTrustedGuiRequest(req, res, "Diagnostics API")) return;
+    const mode = url.searchParams.get("mode") === "session" ? "session" : "install";
+    const force = url.searchParams.get("force") === "1";
+    writeJson(res, await probeProviderStatus("twitter", { mode, force }));
+    return;
+  }
+
+  if (url.pathname === "/api/diagnostics/reddit-cli" && req.method === "GET") {
+    if (!allowTrustedGuiRequest(req, res, "Diagnostics API")) return;
+    const mode = url.searchParams.get("mode") === "session" ? "session" : "install";
+    const force = url.searchParams.get("force") === "1";
+    writeJson(res, await probeProviderStatus("reddit", { mode, force }));
+    return;
+  }
+
   if (url.pathname === "/api/chat/run" && req.method === "POST") {
     if (!allowTrustedGuiRequest(req, res, "Chat run API")) return;
     await handleSseChatRun(req, res);