opencandle 0.11.0 → 0.12.0

package/dist/onboarding/validate-model-key.d.ts

@@ -0,0 +1,17 @@
+export type ModelKeyProviderId = "google" | "openai" | "anthropic";
+export type ModelKeyValidationResult = {
+    status: "valid";
+    providerLabel: string;
+} | {
+    status: "invalid";
+    providerLabel: string;
+} | {
+    status: "transient";
+    providerLabel: string;
+    reason: string;
+};
+/**
+ * Checks whether an API key is accepted by a model provider without saving it.
+ * Transient failures deliberately permit saving so offline setup remains usable.
+ */
+export declare function validateModelKey(providerId: ModelKeyProviderId, key: string): Promise<ModelKeyValidationResult>;

package/dist/onboarding/validate-model-key.js

@@ -0,0 +1,54 @@
+const VALIDATION_TIMEOUT_MS = 5_000;
+const MODEL_KEY_PROBES = {
+    google: {
+        label: "Google Gemini",
+        url: "https://generativelanguage.googleapis.com/v1beta/models",
+        headers: (key) => ({ "x-goog-api-key": key }),
+    },
+    openai: {
+        label: "OpenAI",
+        url: "https://api.openai.com/v1/models",
+        headers: (key) => ({ Authorization: `Bearer ${key}` }),
+    },
+    anthropic: {
+        label: "Anthropic",
+        url: "https://api.anthropic.com/v1/models",
+        headers: (key) => ({ "x-api-key": key, "anthropic-version": "2023-06-01" }),
+    },
+};
+/**
+ * Checks whether an API key is accepted by a model provider without saving it.
+ * Transient failures deliberately permit saving so offline setup remains usable.
+ */
+export async function validateModelKey(providerId, key) {
+    const probe = MODEL_KEY_PROBES[providerId];
+    try {
+        const response = await fetch(probe.url, {
+            method: "GET",
+            headers: probe.headers(key),
+            signal: AbortSignal.timeout(VALIDATION_TIMEOUT_MS),
+        });
+        if (response.status === 401 || response.status === 403) {
+            return { status: "invalid", providerLabel: probe.label };
+        }
+        if (!response.ok) {
+            // Google reports bad keys as 400 INVALID_ARGUMENT / API_KEY_INVALID
+            // rather than 401.
+            if (response.status === 400) {
+                const body = await response.text().catch(() => "");
+                if (/API_KEY_INVALID|API key not valid/i.test(body)) {
+                    return { status: "invalid", providerLabel: probe.label };
+                }
+            }
+            return { status: "transient", providerLabel: probe.label, reason: `HTTP ${response.status}` };
+        }
+        return { status: "valid", providerLabel: probe.label };
+    }
+    catch (error) {
+        return {
+            status: "transient",
+            providerLabel: probe.label,
+            reason: error instanceof Error ? error.message : String(error),
+        };
+    }
+}

package/dist/onboarding/validation.js

@@ -114,4 +114,3 @@ export async function validateCredential(providerId, key) {
             });
     }
 }
-//# sourceMappingURL=validation.js.map

package/dist/pi/opencandle-extension.js

@@ -20,9 +20,18 @@ export default function openCandleExtension(pi, options) {
     const coordinator = new SessionCoordinator();
     // Workflow transforms replace the user's turn with the expanded prompt; this
     // marker lets the GUI render the user's original words instead.
-    const markOriginalInput = (original) => {
+    const markOriginalInput = (original, ctx) => {
+        if (hasUnconsumedOriginalInputMarker(ctx))
+            return;
         pi.appendEntry("opencandle-user-input", { original });
     };
+    const appendComprehensiveAnalysisWorkflowEntry = (symbol, definition) => {
+        pi.appendEntry("opencandle-workflow", {
+            workflow: "comprehensive_analysis",
+            resolvedSlots: { symbol },
+            analystsTotal: definition.steps.filter((step) => step.stepType.startsWith("analyst_")).length,
+        });
+    };
     // Credential-interception state. Lifetime:
     //   `sessionPromptedSet` — cleared on session_start, persists across turns
     //      within a session so users don't get re-prompted after picking
@@ -60,6 +69,7 @@ export default function openCandleExtension(pi, options) {
                 return;
             }
             const definition = buildComprehensiveAnalysisDefinition(symbol);
+            appendComprehensiveAnalysisWorkflowEntry(symbol, definition);
             coordinator.executeWorkflow(pi, definition, ctx);
         },
     });
@@ -565,9 +575,10 @@ export default function openCandleExtension(pi, options) {
         const analysis = isAnalysisRequest(event.text);
         if (analysis.match && analysis.symbol) {
             const definition = buildComprehensiveAnalysisDefinition(analysis.symbol);
+            appendComprehensiveAnalysisWorkflowEntry(analysis.symbol, definition);
             const prompt = coordinator.transformWorkflowInput(pi, definition, ctx);
             if (prompt)
-                markOriginalInput(event.text);
+                markOriginalInput(event.text, ctx);
             return prompt ? { action: "transform", text: prompt } : { action: "handled" };
         }
         const dispatched = await handleLlmRouterTurn(event.text, ctx);
@@ -679,6 +690,8 @@ export default function openCandleExtension(pi, options) {
     }
     async function dispatchRouterWorkflow(output, ctx, originalText) {
         const workflow = output.workflow;
+        if (!workflow)
+            return false;
         const storage = coordinator.getStorage();
         const workflowPrefs = storage?.getWorkflowPreferences("global") ?? {};
         const entities = mergeRouterSlotsIntoEntities(output);
@@ -693,7 +706,7 @@ export default function openCandleExtension(pi, options) {
             const definition = buildPortfolioWorkflowDefinition(resolution);
             const prompt = coordinator.transformWorkflowInput(pi, definition, ctx);
             if (prompt)
-                markOriginalInput(originalText);
+                markOriginalInput(originalText, ctx);
             return prompt ? { action: "transform", text: prompt } : false;
         }
         if (workflow === "options_screener") {
@@ -710,7 +723,7 @@ export default function openCandleExtension(pi, options) {
                 const definition = buildOptionsScreenerWorkflowDefinition(resolution);
                 const prompt = coordinator.transformWorkflowInput(pi, definition, ctx);
                 if (prompt)
-                    markOriginalInput(originalText);
+                    markOriginalInput(originalText, ctx);
                 return prompt ? { action: "transform", text: prompt } : false;
             }
             // Missing required symbol — treat as fallback with ask_user directive.
@@ -756,7 +769,7 @@ export default function openCandleExtension(pi, options) {
             applyPreflightAnnotation(definition, preflight.dropped);
             const prompt = coordinator.transformWorkflowInput(pi, definition, ctx);
             if (prompt)
-                markOriginalInput(originalText);
+                markOriginalInput(originalText, ctx);
             return prompt ? { action: "transform", text: prompt } : false;
         }
         // single_asset_analysis / watchlist / general_qa + any workflow with
@@ -977,7 +990,6 @@ export default function openCandleExtension(pi, options) {
         const model = ctx.model;
         if (!model)
             return null;
-        // biome-ignore lint/suspicious/noExplicitAny: Pi typings keep Model generic
         return createPiAiRouterClient(model);
     }
     // System prompt assembly — delegate to coordinator. When a fallback context
@@ -990,6 +1002,34 @@ export default function openCandleExtension(pi, options) {
         };
     });
 }
+function hasUnconsumedOriginalInputMarker(ctx) {
+    const manager = ctx?.sessionManager;
+    const entries = typeof manager?.getBranch === "function"
+        ? manager.getBranch()
+        : typeof manager?.getEntries === "function"
+            ? manager.getEntries()
+            : [];
+    let markerAfterLastUser = false;
+    for (const entry of entries) {
+        if (!isSessionEntryRecord(entry))
+            continue;
+        if (entry.type === "message" && entry.message?.role === "user") {
+            markerAfterLastUser = false;
+            continue;
+        }
+        if (entry.type === "custom" && entry.customType === "opencandle-user-input") {
+            markerAfterLastUser = true;
+            continue;
+        }
+        if (markerAfterLastUser) {
+            markerAfterLastUser = false;
+        }
+    }
+    return markerAfterLastUser;
+}
+function isSessionEntryRecord(entry) {
+    return typeof entry === "object" && entry !== null;
+}
 /** Concatenate text from a Pi message `content` (plain string or block array). */
 function extractMessageText(content) {
     if (typeof content === "string")
@@ -1026,4 +1066,3 @@ function isPlaceholderSessionName(name, candidates) {
     }
     return false;
 }
-//# sourceMappingURL=opencandle-extension.js.map

package/dist/pi/session-action-dedupe.js

@@ -123,4 +123,3 @@ function acceptedActionStorePath(sessionManager) {
         ? `${scope}.accepted-actions.json`
         : join(scope, "accepted-actions.json");
 }
-//# sourceMappingURL=session-action-dedupe.js.map

package/dist/pi/session-storage.js

@@ -2,4 +2,3 @@ import { SessionManager } from "@earendil-works/pi-coding-agent";
 export function continueOpenCandleSession(cwd, sessionDir) {
     return SessionManager.continueRecent(cwd, sessionDir);
 }
-//# sourceMappingURL=session-storage.js.map

package/dist/pi/session-writer-lock.js

@@ -320,4 +320,3 @@ function isFileScope(scopePath) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-//# sourceMappingURL=session-writer-lock.js.map

package/dist/pi/session.js

@@ -50,4 +50,3 @@ async function applySavedDefaultModel(result) {
         return;
     await result.session.setModel(savedDefault);
 }
-//# sourceMappingURL=session.js.map

package/dist/pi/setup.d.ts

@@ -1,8 +1,10 @@
 import { type ExtensionAPI, type ExtensionContext } from "@earendil-works/pi-coding-agent";
 type SetupMode = "startup" | "manual";
 type SetupRequirement = "ready" | "select_model" | "connect_auth";
+type ApiKeyProviderId = "google" | "openai" | "anthropic";
 type SetupResult = "ready" | "shutdown" | "cancelled";
 export declare function getLlmSetupRequirement(ctx: Pick<ExtensionContext, "model" | "modelRegistry">): SetupRequirement;
+export declare function runApiKeySetup(ctx: ExtensionContext, provider: ApiKeyProviderId): Promise<boolean>;
 export declare function runOpenCandleSetup(api: ExtensionAPI, ctx: ExtensionContext, options?: {
     mode: SetupMode;
 }): Promise<SetupResult>;

package/dist/pi/setup.js

@@ -1,4 +1,5 @@
 import { LoginDialogComponent, } from "@earendil-works/pi-coding-agent";
+import { validateModelKey } from "../onboarding/validate-model-key.js";
 /**
  * Registry of "fast default" models for each LLM auth provider. After a fresh
  * sign-in we try to activate the default without opening a picker, falling back
@@ -174,7 +175,7 @@ async function runLoginDialog(ctx, providerId) {
     }
     return false;
 }
-async function runApiKeySetup(ctx, provider) {
+export async function runApiKeySetup(ctx, provider) {
     const label = API_KEY_PROVIDER_LABELS[provider];
     ctx.ui.notify(`OpenCandle stores your ${label} API key locally. After saving it, OpenCandle will select a fast default model when one is available.`, "info");
     const key = await ctx.ui.input(`Paste your ${label} API key`, "API key");
@@ -183,9 +184,16 @@ async function runApiKeySetup(ctx, provider) {
         ctx.ui.notify("No API key entered.", "warning");
         return false;
     }
+    const validation = await validateModelKey(provider, trimmed);
+    if (validation.status === "invalid") {
+        ctx.ui.notify(`Key was rejected by ${validation.providerLabel}. Paste a different key.`, "error");
+        return false;
+    }
     ctx.modelRegistry.authStorage.set(provider, { type: "api_key", key: trimmed });
     ctx.modelRegistry.refresh();
-    ctx.ui.notify(`${label} API key saved to OpenCandle.`, "info");
+    ctx.ui.notify(validation.status === "transient"
+        ? `Saved — couldn't verify (network issue). ${label} API key saved to OpenCandle.`
+        : `${label} API key saved to OpenCandle.`, "info");
     return true;
 }
 /**
@@ -316,4 +324,3 @@ export async function runOpenCandleSetup(api, ctx, options = { mode: "startup" }
     }
     return "ready";
 }
-//# sourceMappingURL=setup.js.map

package/dist/pi/tool-adapter.js

@@ -31,4 +31,3 @@ function safeGetDefaults(toolName) {
         return {};
     }
 }
-//# sourceMappingURL=tool-adapter.js.map

package/dist/pi/tui-session-coordinator.js

@@ -280,4 +280,3 @@ function asRecord(value) {
         ? value
         : {};
 }
-//# sourceMappingURL=tui-session-coordinator.js.map

package/dist/prompts/context-builder.js

@@ -33,7 +33,7 @@ export class PromptContextBuilder {
         let truncationMarkers = 0;
         for (const name of SECTION_ORDER) {
             const section = this.sections.get(name);
-            if (!section.content)
+            if (!section?.content)
                 continue;
             const truncated = truncateTobudget(section.content, section.characterBudget);
             const wasTruncated = truncated.includes("[...truncated]");
@@ -258,4 +258,3 @@ Every committal response MUST carry four elements:
 
 ## Assumption Disclosure
 Structured workflow prompts may include a pre-rendered "Assumptions" block with correct source attribution (user-specified, saved preference, or default). Start with that block only when the workflow instructions explicitly say to. Fallback prompts include "Assumptions Context" only for internal routing context; do not reproduce that context unless the user explicitly asks for assumptions. Do NOT independently relabel any value's source anywhere in your response. When an assumptions block is shown, it is the single authoritative provenance representation.`;
-//# sourceMappingURL=context-builder.js.map

package/dist/prompts/disclaimer.js

@@ -6,4 +6,3 @@
 export const DISCLAIMER_TEXT = "OpenCandle is a research and analysis tool, not financial advice or a fiduciary financial advisor. " +
     "Views, targets, and allocations are informational analyst output — not personalized recommendations. " +
     "Verify independently before acting.";
-//# sourceMappingURL=disclaimer.js.map

package/dist/prompts/policy-cards.js

@@ -198,4 +198,3 @@ function placeholder(id, taskFamily, capabilityGapIds) {
         content: "",
     };
 }
-//# sourceMappingURL=policy-cards.js.map

package/dist/prompts/sections.js

@@ -32,4 +32,3 @@ export const DEFAULT_BUDGETS = {
     "provider-status": 500,
     "output-format": 2500,
 };
-//# sourceMappingURL=sections.js.map

package/dist/prompts/symbol-preflight.js

@@ -46,4 +46,3 @@ function validateSymbol(symbol, search) {
         checkedAt: Date.now(),
     }));
 }
-//# sourceMappingURL=symbol-preflight.js.map

package/dist/prompts/workflow-prompts.js

@@ -442,4 +442,3 @@ ${tableInstruction}
 ${actionPlanResponse}
 - Note any caveats (different sectors, concentration, market cap disparity, unavailable fundamentals, unavailable forward-looking estimates, etc.).${horizonResponse}`;
 }
-//# sourceMappingURL=workflow-prompts.js.map

package/dist/providers/alpha-vantage.js

@@ -182,7 +182,7 @@ export async function getGlobalQuote(symbol, apiKey) {
         const data = await httpGet(url);
         throwIfApiMessage(data);
         const gq = data["Global Quote"];
-        if (!gq || !gq["05. price"]) {
+        if (!gq?.["05. price"]) {
             throw new Error(`Alpha Vantage: No quote data for ${symbol}`);
         }
         const price = parseFloat(gq["05. price"]) || 0;
@@ -201,6 +201,7 @@ export async function getGlobalQuote(symbol, apiKey) {
             week52High: 0, // Not available from GLOBAL_QUOTE
             week52Low: 0, // Not available from GLOBAL_QUOTE
             timestamp: Date.now(),
+            asOf: dateOnlyValue(gq["07. latest trading day"]),
         };
         cache.set(cacheKey, result, TTL.QUOTE);
         return result;
@@ -213,6 +214,11 @@ export async function getGlobalQuote(symbol, apiKey) {
         throw error;
     }
 }
+function dateOnlyValue(value) {
+    if (!value || !/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return undefined;
+    return value;
+}
 export async function getDailyHistory(symbol, apiKey, range = "6mo") {
     const cacheKey = `av:daily:${symbol}:${range}`;
     const cached = cache.get(cacheKey);
@@ -285,6 +291,5 @@ function parseNullableNum(s) {
     if (!s || s === "None" || s === "-")
         return null;
     const n = parseFloat(s);
-    return isNaN(n) ? null : n;
+    return Number.isNaN(n) ? null : n;
 }
-//# sourceMappingURL=alpha-vantage.js.map

package/dist/providers/coingecko.js

@@ -28,6 +28,7 @@ export async function getCryptoPrice(id) {
             circulatingSupply: md.circulating_supply,
             totalSupply: md.total_supply,
             timestamp: Date.now(),
+            asOf: md.last_updated,
         };
         cache.set(cacheKey, result, TTL.QUOTE);
         return result;
@@ -66,4 +67,3 @@ export async function getCryptoHistory(id, days = 180) {
         throw error;
     }
 }
-//# sourceMappingURL=coingecko.js.map

package/dist/providers/errors.js

@@ -8,4 +8,3 @@ export class InvalidSymbolError extends Error {
         this.name = "InvalidSymbolError";
     }
 }
-//# sourceMappingURL=errors.js.map

package/dist/providers/exa-search.js

@@ -90,14 +90,16 @@ function parseMcpResultBlocks(text) {
     return results;
 }
 function mapApiResults(results) {
-    return results
-        .filter((r) => r.url)
-        .map((r) => ({
-        title: r.title ?? "",
-        url: r.url,
-        published: r.publishedDate ?? null,
-        snippet: (r.highlights?.join(" ") || r.text || "").slice(0, SNIPPET_MAX_CHARS),
-    }));
+    return results.flatMap((r) => {
+        if (!r.url)
+            return [];
+        return {
+            title: r.title ?? "",
+            url: r.url,
+            published: r.publishedDate ?? null,
+            snippet: (r.highlights?.join(" ") || r.text || "").slice(0, SNIPPET_MAX_CHARS),
+        };
+    });
 }
 // ---------------------------------------------------------------------------
 // Freshness post-filter
@@ -108,7 +110,7 @@ function filterByFreshness(results, freshness) {
         if (!r.published)
             return true; // benefit of the doubt
         const pubTime = new Date(r.published).getTime();
-        return !isNaN(pubTime) && pubTime >= cutoff;
+        return !Number.isNaN(pubTime) && pubTime >= cutoff;
     });
 }
 // ---------------------------------------------------------------------------
@@ -281,4 +283,3 @@ export async function exaSearch(query, opts) {
 }
 // Exported for testing
 export { enrichQueryForMcp, extractJsonRpcPayload, filterByFreshness, mapApiResults, parseMcpResultBlocks, };
-//# sourceMappingURL=exa-search.js.map

package/dist/providers/external-tool-command.js

@@ -111,4 +111,3 @@ function commandNames(command, platform) {
     }
     return names;
 }
-//# sourceMappingURL=external-tool-command.js.map

package/dist/providers/external-tool-error.js

@@ -18,4 +18,3 @@ export class ExternalToolNotInstalled extends Error {
         this.name = "ExternalToolNotInstalled";
     }
 }
-//# sourceMappingURL=external-tool-error.js.map

package/dist/providers/fear-greed.js

@@ -31,4 +31,3 @@ export async function getFearGreedIndex() {
         throw error;
     }
 }
-//# sourceMappingURL=fear-greed.js.map

package/dist/providers/finnhub.js

@@ -89,4 +89,3 @@ export async function getCompanyNews(symbol, from, to, apiKey) {
         throw error;
     }
 }
-//# sourceMappingURL=finnhub.js.map

package/dist/providers/fred.js

@@ -54,4 +54,3 @@ export async function getSeries(seriesId, apiKey, limit = 60) {
         throw error;
     }
 }
-//# sourceMappingURL=fred.js.map

package/dist/providers/index.js

@@ -7,4 +7,3 @@ export { searchFilings } from "./sec-edgar.js";
 export { getQuotes, screenStocks } from "./tradingview.js";
 export { braveSearch, ddgSearch, normalizeFinancialQuery, searchWeb } from "./web-search.js";
 export { clearCrumbCache, computeTimeToExpiry, getHistory, getOptionsChain, getQuote, getYahooCrumb, } from "./yahoo-finance.js";
-//# sourceMappingURL=index.js.map

package/dist/providers/polymarket.d.ts

@@ -0,0 +1,2 @@
+import type { PredictionMarketQuote } from "../types/prediction-markets.js";
+export declare function searchPredictionMarkets(query: string, limit?: number): Promise<PredictionMarketQuote[]>;

package/dist/providers/polymarket.js

@@ -0,0 +1,162 @@
+import { cache, STALE_LIMIT, TTL } from "../infra/cache.js";
+import { httpGet } from "../infra/http-client.js";
+import { rateLimiter } from "../infra/rate-limiter.js";
+const BASE_URL = "https://gamma-api.polymarket.com";
+const POLYMARKET_URL = "https://polymarket.com";
+export async function searchPredictionMarkets(query, limit = 8) {
+    const normalizedQuery = query.trim();
+    const normalizedLimit = normalizeLimit(limit);
+    if (!normalizedQuery)
+        return [];
+    const cacheKey = `polymarket:search:${normalizedQuery.toLowerCase()}:${normalizedLimit}`;
+    const cached = cache.get(cacheKey);
+    if (cached)
+        return cached;
+    try {
+        await rateLimiter.acquire("polymarket");
+        const url = `${BASE_URL}/public-search?q=${encodeURIComponent(normalizedQuery)}&limit=${normalizedLimit}`;
+        const response = await httpGet(url, {
+            headers: { Accept: "application/json" },
+            maxRetries: 0,
+        });
+        const quotes = decodeSearchResponse(response).slice(0, normalizedLimit);
+        cache.set(cacheKey, quotes, TTL.PREDICTION_MARKETS);
+        return quotes;
+    }
+    catch (error) {
+        const stale = cache.getStale(cacheKey, STALE_LIMIT.PREDICTION_MARKETS);
+        if (stale)
+            return stale.value;
+        throw error;
+    }
+}
+function decodeSearchResponse(response) {
+    const markets = [
+        ...(response.events ?? []).flatMap((event) => (event.markets ?? []).map((market) => ({ event, market }))),
+        ...(response.markets ?? []).map((market) => ({ market })),
+    ];
+    return markets.flatMap(({ event, market }) => isOpenMarket(market) ? marketToQuotes(market, event) : []);
+}
+function marketToQuotes(market, event) {
+    const marketId = market.id === undefined ? undefined : String(market.id);
+    const title = stringValue(market.question) ?? stringValue(event?.title);
+    if (!marketId || !title)
+        return [];
+    const outcomes = parseStringArray(market.outcomes);
+    const prices = parseNumberArray(market.outcomePrices);
+    if (outcomes.length === 0 || prices.length === 0)
+        return [];
+    const resolutionCriteria = firstNonEmpty(market.description, market.resolutionSource);
+    const volumeUsd = numberValue(market.volumeNum) ?? numberValue(market.volume) ?? numberValue(event?.volume);
+    const liquidityUsd = numberValue(market.liquidityNum) ??
+        numberValue(market.liquidity) ??
+        numberValue(event?.liquidity);
+    const closeDate = stringValue(market.endDate) ?? normalizeDateOnly(market.endDateIso ?? event?.endDate);
+    const url = marketUrl(market, event);
+    const asOf = stringValue(market.updatedAt) ?? stringValue(event?.updatedAt);
+    return outcomes.flatMap((outcome, index) => {
+        const probability = prices[index];
+        if (probability === undefined || probability < 0 || probability > 1)
+            return [];
+        return [
+            {
+                source: "polymarket",
+                marketId,
+                title,
+                outcome,
+                probability,
+                ...(volumeUsd !== undefined && { volumeUsd }),
+                ...(liquidityUsd !== undefined && { liquidityUsd }),
+                ...(closeDate && { closeDate }),
+                ...(resolutionCriteria && { resolutionCriteria }),
+                url,
+                ...(asOf && { asOf }),
+            },
+        ];
+    });
+}
+function isOpenMarket(market) {
+    if (booleanValue(market.closed) === true)
+        return false;
+    if (booleanValue(market.active) === false)
+        return false;
+    const endDate = stringValue(market.endDate) ?? stringValue(market.endDateIso);
+    if (!endDate)
+        return true;
+    const parsed = new Date(endDate);
+    return Number.isNaN(parsed.getTime()) || parsed.getTime() > Date.now();
+}
+function normalizeLimit(limit) {
+    if (!Number.isFinite(limit))
+        return 8;
+    return Math.min(50, Math.max(1, Math.floor(limit)));
+}
+function parseStringArray(value) {
+    const parsed = parseJsonArray(value);
+    return parsed.flatMap((item) => {
+        const text = stringValue(item);
+        return text ? [text] : [];
+    });
+}
+function parseNumberArray(value) {
+    const parsed = parseJsonArray(value);
+    return parsed.map((item) => numberValue(item));
+}
+function parseJsonArray(value) {
+    if (Array.isArray(value))
+        return value;
+    if (typeof value !== "string")
+        return [];
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function numberValue(value) {
+    const number = typeof value === "number" ? value : typeof value === "string" ? Number(value) : NaN;
+    return Number.isFinite(number) ? number : undefined;
+}
+function stringValue(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function booleanValue(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "true")
+        return true;
+    if (normalized === "false")
+        return false;
+    return undefined;
+}
+function firstNonEmpty(...values) {
+    for (const value of values) {
+        const text = stringValue(value);
+        if (text)
+            return text;
+    }
+    return undefined;
+}
+function normalizeDateOnly(value) {
+    if (!value)
+        return undefined;
+    return /^\d{4}-\d{2}-\d{2}$/.test(value) ? `${value}T00:00:00Z` : value;
+}
+function marketUrl(market, event) {
+    const marketSlug = stringValue(market.slug);
+    const eventSlug = stringValue(event?.slug);
+    if (eventSlug && marketSlug) {
+        return `${POLYMARKET_URL}/event/${encodeURIComponent(eventSlug)}/${encodeURIComponent(marketSlug)}`;
+    }
+    if (marketSlug)
+        return `${POLYMARKET_URL}/event/${encodeURIComponent(marketSlug)}`;
+    return POLYMARKET_URL;
+}

package/dist/providers/provider-credential-error.js

@@ -19,4 +19,3 @@ export class ProviderCredentialError extends Error {
         this.httpStatus = httpStatus;
     }
 }
-//# sourceMappingURL=provider-credential-error.js.map

package/dist/providers/reddit-cli.js

@@ -169,4 +169,3 @@ function runCommand(command, args) {
         maxOutputChars: MAX_OUTPUT_CHARS,
     });
 }
-//# sourceMappingURL=reddit-cli.js.map

package/dist/providers/reddit.js

@@ -73,4 +73,3 @@ export function scoreSentiment(posts) {
         bearish,
     };
 }
-//# sourceMappingURL=reddit.js.map

package/dist/providers/sec-edgar.js

@@ -231,4 +231,3 @@ function isLikelyTableOfContentsSnippet(snippet) {
     const itemHeadingCount = lower.match(/\bitem\s+\d+[a-z]?\b/g)?.length ?? 0;
     return lower.includes("table of contents") && itemHeadingCount >= 2;
 }
-//# sourceMappingURL=sec-edgar.js.map