visionclaw 0.1.209 → 0.1.210-beta.2

package/dist/factcheck/financial-verifier.js

@@ -1,109 +0,0 @@
-/**
- * Thin financial-tool MCP client used by the fact-check sidecar to verify
- * market claims (prices, market caps, fundamentals, options, ticker↔name mapping).
- *
- * The main agent reaches the financial-tool through the SDK's MCP plumbing;
- * the sidecar is out-of-band, so it opens its own short-lived MCP session per
- * audit and tears it down afterwards. All calls are best-effort: a verifier
- * failure degrades the relevant claims to "unverifiable", never crashes.
- */
-import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
-import { resolveFinancialToolApiKey, resolveFinancialToolBaseUrl, } from "../financial-tool-credentials.js";
-import { logger } from "../logger.js";
-/**
- * Open an MCP session to the financial-tool service. Returns `null` when the
- * service is not configured (no API key) so callers can skip financial
- * verification gracefully.
- */
-export async function openFinancialVerifier(config, timeoutMs = 15_000) {
-    const apiKey = resolveFinancialToolApiKey(config);
-    if (!apiKey) {
-        logger.debug("[factcheck] financial verification skipped: service not configured");
-        return null;
-    }
-    const baseUrl = resolveFinancialToolBaseUrl(config);
-    const url = new URL(`${baseUrl}/mcp/${apiKey}`);
-    const client = new Client({ name: "visionclaw-factcheck", version: "0.1.0" });
-    try {
-        await client.connect(new StreamableHTTPClientTransport(url, {
-            requestInit: { headers: { Authorization: `Bearer ${apiKey}` } },
-        }));
-    }
-    catch (err) {
-        logger.warn(`[factcheck] failed to connect to financial-tool: ${err instanceof Error ? err.message : String(err)}`);
-        try {
-            await client.close();
-        }
-        catch {
-            /* ignore */
-        }
-        return null;
-    }
-    async function call(name, args, signal) {
-        const result = await client.callTool({ name, arguments: args }, undefined, {
-            timeout: timeoutMs,
-            ...(signal ? { signal } : {}),
-        });
-        const content = result.content ?? [];
-        const text = content.find((c) => c.type === "text")?.text ?? "{}";
-        try {
-            return JSON.parse(text);
-        }
-        catch {
-            return { raw: text };
-        }
-    }
-    return {
-        searchInstruments: (query, market, signal) => call("financial_search_instruments", {
-            query,
-            asset_class: "any",
-            ...(market && market !== "crypto" ? { market } : {}),
-            active: true,
-            limit: 5,
-        }, signal),
-        getSnapshots: (symbols, market, signal) => call("financial_get_snapshots", {
-            symbols: symbols.slice(0, 50),
-            ...(market ? { market } : {}),
-        }, signal),
-        getFundamentals: (symbol, market, signal) => call("financial_get_fundamentals", {
-            symbol,
-            report_type: "summary",
-            ...(market ? { market } : {}),
-        }, signal),
-        getOptionChain: (underlying, params = {}, signal) => call("financial_get_option_chain", {
-            underlying,
-            ...(params.expiration ? { expiration: params.expiration } : {}),
-            ...(params.expirations ? { expirations: params.expirations } : {}),
-            ...(params.type ? { type: params.type } : {}),
-            ...(typeof params.strikeGte === "number" ? { strike_gte: params.strikeGte } : {}),
-            ...(typeof params.strikeLte === "number" ? { strike_lte: params.strikeLte } : {}),
-            include_greeks: params.includeGreeks ?? true,
-            include_quotes: params.includeQuotes ?? true,
-            include_trades: params.includeTrades ?? true,
-            active: true,
-            limit: params.limit ?? 20,
-        }, signal),
-        getBars: (symbol, from, to, unit, market, signal) => call("financial_get_bars", {
-            symbol,
-            from,
-            to,
-            timeframe: { multiplier: 1, unit },
-            ...(market ? { market } : {}),
-            adjusted: true,
-            sort: "asc",
-            // Cap returned rows: a verification claim needs the endpoints of the
-            // window, not a high-resolution series. Keeps payloads small.
-            limit: 400,
-        }, signal),
-        close: async () => {
-            try {
-                await client.close();
-            }
-            catch {
-                /* best-effort */
-            }
-        },
-    };
-}
-//# sourceMappingURL=financial-verifier.js.map

package/dist/factcheck/financial-verifier.js.map

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

package/dist/factcheck/setup.d.ts

@@ -1,32 +0,0 @@
-/**
- * Wiring helper for the Async Fact-Check Sidecar (issue #530).
- *
- * Builds a {@link FactCheckSidecar} with the standard snapshot source
- * (ActivityTracker) and mid-turn injection path (active session), starts it,
- * and stores it on the shared AgentState. Shared by the startup path in
- * `loop.ts` and the runtime `/fact-check on` toggle so both wire the sidecar
- * identically.
- *
- * Idempotent: if a sidecar is already attached it is left untouched.
- */
-import type { VisionClawConfig } from "../config/types.js";
-import type { AgentState } from "../agent/state.js";
-import type { SessionManager } from "../agent/session-manager.js";
-import type { ActivityTracker } from "../agent/activity-tracker.js";
-import { FactCheckSidecar } from "./sidecar.js";
-export interface SetupFactCheckOptions {
-    config: VisionClawConfig;
-    agentState: AgentState;
-    session: SessionManager;
-    activityTracker: ActivityTracker;
-    /** Force an immediate audit after start (e.g. when startup crossed an engine boundary). */
-    forceAuditOnStart?: boolean;
-    /** Registers a graceful-shutdown callback. Only wired on the startup path. */
-    registerShutdownCallback?: (cb: () => Promise<void>) => void;
-}
-/**
- * Create, start, and attach the fact-check sidecar. Returns the started
- * sidecar, or `null` when the feature is disabled or one is already attached.
- */
-export declare function setupFactCheckSidecar(options: SetupFactCheckOptions): FactCheckSidecar | null;
-//# sourceMappingURL=setup.d.ts.map

package/dist/factcheck/setup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/factcheck/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,gBAAgB,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,OAAO,EAAE,cAAc,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,wBAAwB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;CAC9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,GAAG,IAAI,CAmD7F"}

package/dist/factcheck/setup.js

@@ -1,70 +0,0 @@
-/**
- * Wiring helper for the Async Fact-Check Sidecar (issue #530).
- *
- * Builds a {@link FactCheckSidecar} with the standard snapshot source
- * (ActivityTracker) and mid-turn injection path (active session), starts it,
- * and stores it on the shared AgentState. Shared by the startup path in
- * `loop.ts` and the runtime `/fact-check on` toggle so both wire the sidecar
- * identically.
- *
- * Idempotent: if a sidecar is already attached it is left untouched.
- */
-import { logger } from "../logger.js";
-import { FactCheckSidecar } from "./sidecar.js";
-import { formatCorrections } from "./store.js";
-/**
- * Create, start, and attach the fact-check sidecar. Returns the started
- * sidecar, or `null` when the feature is disabled or one is already attached.
- */
-export function setupFactCheckSidecar(options) {
-    const { config, agentState, session, activityTracker } = options;
-    if (!config.factCheck.enabled)
-        return null;
-    if (agentState.factCheckSidecar)
-        return null;
-    const sidecar = new FactCheckSidecar({
-        config,
-        getSnapshot: () => activityTracker.getFactCheckSnapshot(),
-        onFindings: (findings) => {
-            // Prefer mid-turn injection so the correction lands before the agent
-            // commits further to a hallucinated fact. Return whether we handled it
-            // live; when false the sidecar persists the findings for the next wake
-            // cycle to read + inject (see buildWakeContext). This keeps delivery
-            // exactly-once.
-            if (!agentState.busy)
-                return false;
-            const text = formatCorrections([
-                { generatedAt: Date.now(), trigger: "live", findings },
-            ]);
-            if (!text)
-                return false;
-            const injected = session.activeSession.injectMessage([{ type: "text", text }], { shouldQuery: false });
-            if (injected) {
-                logger.system(`[factcheck] injected ${findings.length} correction(s) mid-turn`);
-            }
-            return injected;
-        },
-        onPersistedError: () => {
-            // A hard factual error was persisted while the agent was idle. Wake the
-            // main loop now so it consumes + injects the correction on the next wake
-            // cycle instead of waiting for a message/heartbeat. No-op if the loop
-            // hasn't wired its wake function yet.
-            if (agentState.busy)
-                return; // already running; it'll inject mid-turn / next turn
-            logger.system("[factcheck] waking idle agent to deliver a factual-error correction");
-            agentState.wakeMainLoop?.();
-        },
-    });
-    if (!sidecar.start())
-        return null;
-    agentState.factCheckSidecar = sidecar;
-    if (options.forceAuditOnStart) {
-        sidecar.onEngineSwitch();
-    }
-    options.registerShutdownCallback?.(() => {
-        sidecar.stop();
-        return Promise.resolve();
-    });
-    return sidecar;
-}
-//# sourceMappingURL=setup.js.map

package/dist/factcheck/setup.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/factcheck/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAa/C;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA8B;IAClE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IAEjE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,UAAU,CAAC,gBAAgB;QAAE,OAAO,IAAI,CAAC;IAE7C,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC;QACnC,MAAM;QACN,WAAW,EAAE,GAAG,EAAE,CAAC,eAAe,CAAC,oBAAoB,EAAE;QACzD,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;YACvB,qEAAqE;YACrE,uEAAuE;YACvE,uEAAuE;YACvE,qEAAqE;YACrE,gBAAgB;YAChB,IAAI,CAAC,UAAU,CAAC,IAAI;gBAAE,OAAO,KAAK,CAAC;YACnC,MAAM,IAAI,GAAG,iBAAiB,CAAC;gBAC7B,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE;aACvD,CAAC,CAAC;YACH,IAAI,CAAC,IAAI;gBAAE,OAAO,KAAK,CAAC;YACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,aAAa,CAClD,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EACxB,EAAE,WAAW,EAAE,KAAK,EAAE,CACvB,CAAC;YACF,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,MAAM,CAAC,wBAAwB,QAAQ,CAAC,MAAM,yBAAyB,CAAC,CAAC;YAClF,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,gBAAgB,EAAE,GAAG,EAAE;YACrB,wEAAwE;YACxE,yEAAyE;YACzE,sEAAsE;YACtE,sCAAsC;YACtC,IAAI,UAAU,CAAC,IAAI;gBAAE,OAAO,CAAC,qDAAqD;YAClF,MAAM,CAAC,MAAM,CAAC,qEAAqE,CAAC,CAAC;YACrF,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;QAC9B,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAElC,UAAU,CAAC,gBAAgB,GAAG,OAAO,CAAC;IACtC,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC9B,OAAO,CAAC,cAAc,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,wBAAwB,EAAE,CAAC,GAAG,EAAE;QACtC,OAAO,CAAC,IAAI,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/factcheck/sidecar.d.ts

@@ -1,131 +0,0 @@
-/**
- * Async Fact-Check Sidecar (issue #530).
- *
- * Decoupled from the main agent turn, this sidecar audits the agent's recent
- * *assertions* (its reasoning, prose, and notify_user messages — not tool
- * inputs/results), then surfaces corrections before the next reasoning step. It
- * runs in-process (matching the EventTriggerSidecar / CalendarInterruptPoller
- * pattern) but every audit executes asynchronously off the agent's critical
- * path.
- *
- * Triggers (any fires an audit):
- *   1. Counter-based: N consecutive whitelisted tool calls (config N, default
- *      5) *arm* the trigger; the audit fires on the next agent assertion so the
- *      snapshot contains the claim the tool results produced, not the
- *      pre-tool-call state.
- *   2. Compaction: context compaction detected → force audit + reset counter.
- *   3. Engine switch: engine change detected → force audit + reset counter.
- *   4. Turn end: the agent finished its turn → audit any not-yet-audited
- *      assertions, so the final user-facing claim (often a blacklisted
- *      notify_user that never trips the counter) is still checked.
- *
- * Concurrency: strictly serial. While an audit runs, at most one further
- * trigger is held pending (coalesced); it runs immediately after the current
- * audit completes. This keeps the corrections file write conflict-free and the
- * behaviour predictable.
- */
-import type { VisionClawConfig } from "../config/types.js";
-import { type FactCheckFinding } from "./store.js";
-export interface FactCheckSidecarDeps {
-    config: VisionClawConfig;
-    /**
-     * Returns the current context snapshot to audit (the agent's recent
-     * assertions — reasoning, prose, notify_user). Captured lazily at audit start
-     * so it reflects the latest state at the moment the audit actually runs.
-     */
-    getSnapshot: () => string;
-    /**
-     * Deliver findings to the main agent's live turn. Return `true` when the
-     * findings were injected into an active turn (handled live), or `false` when
-     * there was no active turn / injection failed. When it returns `false` (or
-     * throws), the sidecar persists the findings to the corrections file so the
-     * next wake cycle picks them up. This keeps the durable backstop and the
-     * live path mutually exclusive — a correction is delivered exactly once.
-     */
-    onFindings: (findings: FactCheckFinding[]) => boolean | Promise<boolean>;
-    /**
-     * Optional: called after findings containing at least one `error`
-     * (contradicted claim) have been *persisted* to the corrections file (i.e.
-     * not handled live). Lets the wiring wake an idle agent so a hard factual
-     * error is reconciled promptly instead of waiting for the next natural wake
-     * (message / heartbeat). Warnings never trigger this — only contradictions.
-     * Best-effort: must not throw.
-     */
-    onPersistedError?: () => void;
-}
-export declare class FactCheckSidecar {
-    private readonly config;
-    private readonly deps;
-    private whitelistCount;
-    private running;
-    private stopped;
-    /**
-     * The counter threshold has been reached but we are waiting for the agent's
-     * next assertion before auditing — so the snapshot contains the claim the
-     * tool results produced rather than the stale pre-tool-call state.
-     */
-    private counterArmed;
-    /**
-     * An assertion has been recorded since the last audit started. Gates the
-     * turn-end trigger so an idle/empty turn doesn't fire a pointless audit, and
-     * ensures the final user-facing claim is always covered by at least one audit.
-     */
-    private hasUnauditedAssertions;
-    /** At most one coalesced pending trigger while an audit is in flight. */
-    private pendingTrigger;
-    /**
-     * AbortController for the currently-running audit, if any. Lets {@link stop}
-     * cancel in-flight LLM/MCP work so a disabled sidecar doesn't keep burning
-     * tokens or persist stale findings after the user toggles it off.
-     */
-    private activeController;
-    constructor(deps: FactCheckSidecarDeps);
-    private get enabled();
-    private get threshold();
-    /** Returns true when the sidecar is active for this profile. */
-    start(): boolean;
-    stop(): void;
-    /**
-     * Observe a single top-level tool call. Increments the whitelist counter for
-     * non-blacklisted tools; when the threshold is reached it *arms* the counter
-     * trigger rather than auditing immediately. The audit fires on the next
-     * agent assertion ({@link recordAssertion}) so the snapshot reflects the
-     * claim the tool results produced, not the pre-tool-call state. Safe to call
-     * on the agent's hot path — it never blocks.
-     */
-    recordToolCall(toolName: string): void;
-    /**
-     * Observe a top-level agent assertion (reasoning / prose / notify_user). This
-     * is where the verifiable claims live, so it both (a) fires an armed counter
-     * audit now that the claim exists in the snapshot, and (b) marks that there
-     * is fresh content for a turn-end audit to cover.
-     */
-    recordAssertion(): void;
-    /**
-     * The agent finished its turn. Audit any assertions not yet covered by an
-     * audit — notably the final notify_user answer, which is blacklisted from the
-     * counter and would otherwise never be checked.
-     */
-    onTurnEnd(): void;
-    /** Force an audit on context compaction, resetting the counter. */
-    onCompaction(): void;
-    /** Force an audit on engine switch, resetting the counter. */
-    onEngineSwitch(): void;
-    /**
-     * Schedule an audit. If one is already running, record (coalesce) the
-     * trigger and return — it will run once the current audit finishes. Counter
-     * triggers never overwrite a higher-priority forced trigger that is already
-     * pending.
-     */
-    private fire;
-    private runAudit;
-}
-/**
- * Whether a tool call is excluded from the counter trigger. Tool names arrive
- * fully qualified (e.g. `mcp__visionclaw__notify_user`); we match against the
- * bare suffix so the blacklist stays engine- and prefix-agnostic. Unknown
- * tools (third-party MCP, browser, file reads) are NOT blacklisted — see
- * {@link BLACKLIST}.
- */
-export declare function isBlacklisted(toolName: string): boolean;
-//# sourceMappingURL=sidecar.d.ts.map

package/dist/factcheck/sidecar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/factcheck/sidecar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,OAAO,EAA4C,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAmE7F,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,gBAAgB,CAAC;IACzB;;;;OAIG;IACH,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B;;;;;;;OAOG;IACH,UAAU,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzE;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;CAC/B;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAuB;IAE5C,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAS;IAC7B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB,CAAS;IACvC,yEAAyE;IACzE,OAAO,CAAC,cAAc,CAAwB;IAC9C;;;;OAIG;IACH,OAAO,CAAC,gBAAgB,CAAgC;gBAE5C,IAAI,EAAE,oBAAoB;IAKtC,OAAO,KAAK,OAAO,GAElB;IAED,OAAO,KAAK,SAAS,GAEpB;IAED,gEAAgE;IAChE,KAAK,IAAI,OAAO;IAehB,IAAI,IAAI,IAAI;IAQZ;;;;;;;OAOG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUtC;;;;;OAKG;IACH,eAAe,IAAI,IAAI;IASvB;;;;OAIG;IACH,SAAS,IAAI,IAAI;IAMjB,mEAAmE;IACnE,YAAY,IAAI,IAAI;IAOpB,8DAA8D;IAC9D,cAAc,IAAI,IAAI;IAOtB;;;;;OAKG;IACH,OAAO,CAAC,IAAI;YAYE,QAAQ;CA4GvB;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMvD"}