opencandle 0.1.1 → 0.2.0

package/dist/runtime/validation.js

@@ -0,0 +1,157 @@
+/** Create an empty validation result. */
+export function emptyValidationResult() {
+    return { passes: [], failures: [], warnings: [] };
+}
+/** Check that market-sensitive evidence records have timestamps. */
+export function checkTimestamps(evidence, marketSensitiveLabels) {
+    const warnings = [];
+    for (const record of evidence) {
+        if (marketSensitiveLabels.has(record.label) &&
+            record.provenance.source === "fetched" &&
+            !record.provenance.timestamp) {
+            warnings.push({
+                message: `Market-sensitive value '${record.label}' has no timestamp`,
+                evidenceLabel: record.label,
+            });
+        }
+    }
+    return warnings;
+}
+/** Check that options expiry dates are in the future. */
+export function checkOptionsExpiries(evidence, today) {
+    const failures = [];
+    for (const record of evidence) {
+        if (record.label.toLowerCase().includes("expir") &&
+            typeof record.value === "string" &&
+            record.value < today) {
+            failures.push({
+                message: `Options expiry ${record.value} is in the past`,
+                evidenceLabel: record.label,
+                detail: `Today is ${today}`,
+            });
+        }
+    }
+    return failures;
+}
+/** Check that all required fields have evidence records. */
+export function checkRequiredFields(evidence, requiredLabels) {
+    const present = new Set(evidence.map((e) => e.label));
+    const failures = [];
+    for (const label of requiredLabels) {
+        if (!present.has(label)) {
+            failures.push({
+                message: `Required field '${label}' has no evidence record`,
+                evidenceLabel: label,
+            });
+        }
+    }
+    return failures;
+}
+/** Default market-sensitive labels. */
+export const DEFAULT_MARKET_SENSITIVE_LABELS = new Set([
+    "Stock Price",
+    "Volume",
+    "Market Cap",
+    "52-Week High",
+    "52-Week Low",
+    "Bid",
+    "Ask",
+    "Day High",
+    "Day Low",
+    "Open",
+    "Previous Close",
+    "Crypto Price",
+    "Crypto Volume",
+]);
+/**
+ * Orchestrates all deterministic validation checks on evidence records.
+ * Runs before LLM-based validation.
+ */
+export class RuntimeValidator {
+    config;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    /** Run all validation checks and return a combined result. */
+    validate(evidence) {
+        const result = emptyValidationResult();
+        // Timestamp checks
+        const timestampWarnings = checkTimestamps(evidence, this.config.marketSensitiveLabels ?? DEFAULT_MARKET_SENSITIVE_LABELS);
+        result.warnings.push(...timestampWarnings);
+        // Options expiry checks
+        const today = this.config.today ?? new Date().toISOString().slice(0, 10);
+        const expiryFailures = checkOptionsExpiries(evidence, today);
+        result.failures.push(...expiryFailures);
+        // Required field checks
+        if (this.config.requiredFields) {
+            const fieldFailures = checkRequiredFields(evidence, this.config.requiredFields);
+            result.failures.push(...fieldFailures);
+        }
+        // Number match checks
+        if (this.config.toolResults) {
+            const numberEntries = checkNumberMatch(evidence, this.config.toolResults);
+            for (const entry of numberEntries) {
+                if (entry.type === "pass") {
+                    result.passes.push(entry);
+                }
+                else {
+                    result.failures.push(entry);
+                }
+            }
+        }
+        return result;
+    }
+    /** Format validation results as a summary string for the LLM validation prompt. */
+    formatForLLM(result) {
+        const lines = ["## Deterministic Validation Results"];
+        if (result.failures.length > 0) {
+            lines.push(`\n### Failures (${result.failures.length})`);
+            for (const f of result.failures) {
+                lines.push(`- ${f.message}`);
+            }
+        }
+        if (result.warnings.length > 0) {
+            lines.push(`\n### Warnings (${result.warnings.length})`);
+            for (const w of result.warnings) {
+                lines.push(`- ${w.message}`);
+            }
+        }
+        if (result.passes.length > 0) {
+            lines.push(`\n### Verified (${result.passes.length})`);
+            for (const p of result.passes) {
+                lines.push(`- ${p.message}`);
+            }
+        }
+        if (result.failures.length === 0 && result.warnings.length === 0) {
+            lines.push("\nAll deterministic checks passed.");
+        }
+        return lines.join("\n");
+    }
+}
+/** Check that evidence values match expected tool result values. */
+export function checkNumberMatch(evidence, toolResults) {
+    const results = [];
+    for (const record of evidence) {
+        if (typeof record.value !== "number")
+            continue;
+        const expected = toolResults.get(record.label);
+        if (expected === undefined)
+            continue;
+        if (record.value === expected) {
+            results.push({
+                type: "pass",
+                message: `${record.label}: ${record.value} matches tool result`,
+                evidenceLabel: record.label,
+            });
+        }
+        else {
+            results.push({
+                type: "failure",
+                message: `${record.label} mismatch: evidence says ${record.value}, tool returned ${expected}`,
+                evidenceLabel: record.label,
+            });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=validation.js.map

package/dist/runtime/validation.js.map

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

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

@@ -0,0 +1,21 @@
+import type Database from "better-sqlite3";
+/** All workflow event types. */
+export type WorkflowEventType = "workflow_started" | "slot_resolved" | "clarification_asked" | "clarification_answered" | "step_started" | "step_completed" | "step_failed" | "step_skipped" | "tool_called" | "tool_failed" | "validation_passed" | "validation_failed" | "workflow_completed" | "workflow_cancelled";
+/** A persisted workflow event row. */
+export interface WorkflowEvent {
+    id: number;
+    runId: string;
+    stepIndex: number;
+    eventType: WorkflowEventType;
+    payloadJson: string | null;
+    timestamp: string;
+}
+/** Append-only workflow event logger backed by SQLite. */
+export declare class WorkflowEventLogger {
+    private readonly db;
+    constructor(db: Database.Database);
+    /** Append a workflow event. */
+    log(runId: string, stepIndex: number, eventType: WorkflowEventType, payload?: Record<string, unknown>): void;
+    /** Query all events for a given run ID, ordered by timestamp. */
+    getEventsByRunId(runId: string): WorkflowEvent[];
+}

package/dist/runtime/workflow-events.js

@@ -0,0 +1,31 @@
+/** Append-only workflow event logger backed by SQLite. */
+export class WorkflowEventLogger {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /** Append a workflow event. */
+    log(runId, stepIndex, eventType, payload) {
+        const now = new Date().toISOString();
+        const payloadJson = payload ? JSON.stringify(payload) : null;
+        this.db
+            .prepare(`INSERT INTO workflow_events (run_id, step_index, event_type, payload_json, timestamp)
+         VALUES (?, ?, ?, ?, ?)`)
+            .run(runId, stepIndex, eventType, payloadJson, now);
+    }
+    /** Query all events for a given run ID, ordered by timestamp. */
+    getEventsByRunId(runId) {
+        const rows = this.db
+            .prepare("SELECT id, run_id, step_index, event_type, payload_json, timestamp FROM workflow_events WHERE run_id = ? ORDER BY id")
+            .all(runId);
+        return rows.map((r) => ({
+            id: r.id,
+            runId: r.run_id,
+            stepIndex: r.step_index,
+            eventType: r.event_type,
+            payloadJson: r.payload_json,
+            timestamp: r.timestamp,
+        }));
+    }
+}
+//# sourceMappingURL=workflow-events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-events.js","sourceRoot":"","sources":["../../src/runtime/workflow-events.ts"],"names":[],"mappings":"AA6BA,0DAA0D;AAC1D,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,EAAqB;QAArB,OAAE,GAAF,EAAE,CAAmB;IAAG,CAAC;IAEtD,+BAA+B;IAC/B,GAAG,CACD,KAAa,EACb,SAAiB,EACjB,SAA4B,EAC5B,OAAiC;QAEjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;gCACwB,CACzB;aACA,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,iEAAiE;IACjE,gBAAgB,CAAC,KAAa;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE;aACjB,OAAO,CACN,sHAAsH,CACvH;aACA,GAAG,CAAC,KAAK,CAOR,CAAC;QAEL,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,MAAM;YACf,SAAS,EAAE,CAAC,CAAC,UAAU;YACvB,SAAS,EAAE,CAAC,CAAC,UAA+B;YAC5C,WAAW,EAAE,CAAC,CAAC,YAAY;YAC3B,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

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

@@ -0,0 +1,36 @@
+import type { WorkflowRun, StepOutput, WorkflowStep } from "./workflow-types.js";
+import type { WorkflowEventLogger } from "./workflow-events.js";
+import type { ProviderTracker } from "./provider-tracker.js";
+import type { EvidenceRecord } from "./evidence.js";
+/** Function that executes a single workflow step. */
+export type StepExecutor = (step: WorkflowStep, stepIndex: number, priorEvidence: EvidenceRecord[], context: StepExecutionContext) => Promise<StepOutput>;
+/** Context passed to step executors. */
+export interface StepExecutionContext {
+    runId: string;
+    providerTracker: ProviderTracker;
+}
+/** Options for creating a WorkflowRunner. */
+export interface WorkflowRunnerOptions {
+    eventLogger?: WorkflowEventLogger;
+    providerTracker?: ProviderTracker;
+}
+/**
+ * Typed workflow execution engine with run IDs, step definitions,
+ * state transitions, cancellation, and event logging.
+ */
+export declare class WorkflowRunner {
+    private readonly eventLogger?;
+    private readonly providerTracker?;
+    private activeRun;
+    constructor(options?: WorkflowRunnerOptions);
+    /** Get the currently active run, if any. */
+    getActiveRun(): WorkflowRun | null;
+    /**
+     * Start a new workflow run. If a run is already active, it is cancelled first.
+     */
+    start(workflowType: string, stepDefinitions: Omit<WorkflowStep, "status">[], executor: StepExecutor): Promise<WorkflowRun>;
+    /** Cancel the active run. */
+    cancel(): void;
+    private executeSteps;
+    private logEvent;
+}

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/system-prompt.js

@@ -16,9 +16,10 @@ You provide data-driven analysis for stocks, crypto, macro economics, and portfo
 - **Fundamentals**: get_company_overview, get_financials, get_earnings, compute_dcf, compare_companies, get_sec_filings — company financials, valuation metrics, DCF intrinsic value, peer comparison, and SEC EDGAR filings (10-K, 10-Q, 8-K)
 - **Technical Analysis**: get_technical_indicators, backtest_strategy — SMA, EMA, RSI, MACD, Bollinger Bands, OBV, VWAP computed from price data, plus simple strategy backtesting
 - **Macro**: get_economic_data, get_fear_greed — FRED economic indicators and market sentiment
-- **Sentiment**: get_reddit_sentiment, get_reddit_discussions — retail sentiment from financial Reddit communities
+- **Sentiment**: get_reddit_sentiment, get_reddit_discussions, get_twitter_sentiment — retail sentiment from Reddit and Twitter/X
 - **Options**: get_option_chain — full options chain with strikes, bids/asks, volume, OI, IV, and computed Greeks (delta, gamma, theta, vega, rho)
 - **Portfolio**: track_portfolio, analyze_risk, manage_watchlist, analyze_correlation, track_prediction — position tracking, P&L, Sharpe ratio, VaR, watchlist with price alerts, correlation matrix, and prediction tracking with accuracy scoring
+- **User Interaction**: ask_user — ask clarification questions; trigger_twitter_login — open a browser for Twitter/X login
 
 ## Analytical Framework
 When analyzing a stock, follow these steps in order:
@@ -29,7 +30,7 @@ When analyzing a stock, follow these steps in order:
 5. **SYNTHESIS**: State your reasoning chain explicitly: "Because [data point] + [data point], I conclude [thesis]."
 
 ## Guidelines
-- Always fetch data with tools before stating prices, ratios, or metrics. Never guess financial numbers.
+- Always fetch data with tools before stating prices, ratios, or metrics. Never guess financial numbers. Every substantive response should be backed by at least one tool call — if you find yourself writing a response with zero tool calls, stop and think about what data would make it better.
 - For options analysis, use get_option_chain to see the full chain with Greeks. Pay attention to put/call ratio, unusual volume, and IV levels.
 - Present numerical data in tables when comparing multiple securities.
 - Include data timestamps so users know how fresh the information is.
@@ -39,6 +40,55 @@ When analyzing a stock, follow these steps in order:
 - Reuse prior tool outputs when they already answer the question. Do not re-fetch the same symbol and parameters unless you need a missing field or fresher timestamp.
 - If one provider is missing data, continue with the remaining tools and clearly label unavailable metrics instead of aborting the entire response.
 
+## When to Ask for Clarification
+Use the ask_user tool BEFORE proceeding when:
+- The request is broad or vague (e.g., "analyze the market" without specifying which asset or sector)
+- Required information is missing: a ticker symbol for asset analysis, a budget for portfolio construction, or a time horizon for recommendations
+- Multiple valid analysis approaches exist and the user has not indicated a preference (e.g., fundamental vs. technical, short-term vs. long-term)
+- Risk tolerance is unclear for portfolio or options recommendations
+
+Do NOT ask clarifying questions when:
+- The request is clear and specific (e.g., "get AAPL quote", "analyze BTC")
+- You can reasonably infer the intent from context or prior conversation
+- A reasonable default exists and can be disclosed in the Assumptions block instead
+- The user explicitly asks you to use your judgment
+
+Keep questions concise and offer specific options when possible. Prefer select-type questions over open-ended text input to minimize user effort.
+
+## Twitter Authentication
+get_twitter_sentiment requires a one-time Twitter/X login. When the tool returns [LOGIN_NEEDED]:
+1. Use ask_user (confirm) to ask: "Twitter sentiment requires a one-time login. A browser will open — want to proceed?"
+2. If confirmed, call trigger_twitter_login. It opens a browser, waits for the user to log in, and returns success/failure.
+3. On success, retry get_twitter_sentiment with the original query.
+If the user declines, skip Twitter sentiment and continue with other available data sources.
+
+## After Clarification: Fetch Data Immediately
+CRITICAL: After ask_user answers come back, your NEXT action MUST be tool calls — not a text response. You are a data agent, not a chatbot. Never respond with generic investment categories or tell the user to come back with tickers. YOU pick the relevant assets and indicators based on what you learned, then fetch the data.
+
+Playbooks by scenario (use these as starting points, adapt as needed):
+
+**"Where should I put $X" / general investment advice:**
+1. Fetch get_fear_greed — is the market fearful or greedy right now?
+2. Fetch get_economic_data for key macro indicators (Fed funds rate, CPI, unemployment)
+3. Fetch get_stock_quote for benchmark ETFs relevant to their goal (e.g., SPY, QQQ, VTI for growth; BND, SCHD for income; GLD, BTC for alternatives)
+4. Fetch get_technical_indicators on those ETFs to assess current momentum and overbought/oversold conditions
+5. Synthesize: "Given current market conditions [data], here's how I'd think about allocating $X across [specific assets] and why"
+
+**"Build me a portfolio" / allocation request:**
+1. Pick 5-8 candidate assets matching their stated goal and risk level
+2. Fetch get_stock_quote and get_company_overview for each
+3. Fetch analyze_correlation to check diversification
+4. Present a concrete allocation with percentages, backed by the data you fetched
+
+**"What's happening in the market" / market outlook:**
+1. Fetch get_stock_quote for SPY, QQQ, IWM, DIA (major indices)
+2. Fetch get_fear_greed
+3. Fetch get_economic_data for 2-3 key FRED series
+4. Fetch get_reddit_sentiment for current retail mood
+5. Synthesize a market snapshot with data points
+
+If you are about to write a response that contains zero tool call results, STOP. Go fetch data first.
+
 ## Assumption Disclosure
 Workflow prompts include a pre-rendered "Assumptions" block with correct source attribution (user-specified, saved preference, or default). Start your response with that block exactly as written. Do NOT independently relabel any value's source anywhere in your response. The assumptions block is the single authoritative provenance representation.
 ${memorySection}

package/dist/system-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,aAAsB;IACtD,MAAM,aAAa,GAAG,aAAa;QACjC,CAAC,CAAC;;;;EAIJ,aAAa,EAAE;QACb,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCP,aAAa;;;mNAGoM,CAAC;AACpN,CAAC"}
+{"version":3,"file":"system-prompt.js","sourceRoot":"","sources":["../src/system-prompt.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,aAAsB;IACtD,MAAM,aAAa,GAAG,aAAa;QACjC,CAAC,CAAC;;;;EAIJ,aAAa,EAAE;QACb,CAAC,CAAC,EAAE,CAAC;IAEP,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqFP,aAAa;;;mNAGoM,CAAC;AACpN,CAAC"}

package/dist/tool-kit.d.ts

@@ -8,12 +8,16 @@ export { agentToolToPiTool } from "./pi/tool-adapter.js";
 export { Type } from "@sinclair/typebox";
 export type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 export type { AgentTool } from "@mariozechner/pi-agent-core";
-export declare function getThirdPartyToolDescriptions(): ReadonlyArray<{
+export declare function getAddonToolDescriptions(): ReadonlyArray<{
     name: string;
     description: string;
 }>;
-export interface RegisterToolsOptions {
-    namespace?: string;
-    description?: string;
+export interface ToolConfig<TParams extends TSchema, TDetails = unknown> {
+    name: string;
+    label: string;
+    description: string;
+    parameters: TParams;
+    execute: AgentTool<TParams, TDetails>["execute"];
 }
-export declare function registerOpenCandleTools<TParams extends TSchema>(pi: ExtensionAPI, tools: AgentTool<TParams>[], options?: RegisterToolsOptions): void;
+export declare function createTool<TParams extends TSchema, TDetails = unknown>(config: ToolConfig<TParams, TDetails>): AgentTool<TParams, TDetails>;
+export declare function registerTools<TParams extends TSchema>(pi: ExtensionAPI, tools: AgentTool<TParams>[]): void;