opencandle 0.2.0 → 0.4.0

package/dist/onboarding/tool-tags.js

@@ -0,0 +1,149 @@
+// Tool-result text tags used by OpenCandle's conversational-provider-setup
+// flow. These tagged lines are the LLM-facing contract — Pi provider adapters
+// serialize the `content` field of tool results into the model's conversation,
+// so any signal we want the model to reason over must live in text, not
+// `details`.
+//
+// Tag format (single line, parseable):
+//   [OPENCANDLE_<KIND> field=value field2=value ... ]
+//
+// Values may be:
+//   - bare: provider=alpha_vantage  reason=missing  silenced=true  httpStatus=401
+//   - quoted (for spaces or commas): remediation="run /connect economy"
+//   - lists (comma-separated inside quotes): unlocks="fundamentals, DCF"
+//   - null/absent: fallback=none
+//
+// Parser is tolerant of unknown fields and extra whitespace.
+// -----------------------------------------------------------------------------
+// Builders
+// -----------------------------------------------------------------------------
+function quote(value) {
+    return `"${value.replace(/"/g, '\\"')}"`;
+}
+function formatField(key, value) {
+    return `${key}=${value}`;
+}
+export function buildCredentialRequiredTag(fields) {
+    const parts = [
+        "[OPENCANDLE_CREDENTIAL_REQUIRED",
+        formatField("provider", fields.provider),
+        formatField("reason", fields.reason),
+        `unlocks=${quote(fields.unlocks.join(", "))}`,
+        formatField("fallback", fields.fallback ?? "none"),
+    ];
+    if (fields.httpStatus !== undefined) {
+        parts.push(formatField("httpStatus", fields.httpStatus));
+    }
+    return `${parts.join(" ")}]`;
+}
+export function buildSoftDegradedTag(fields) {
+    return [
+        "[OPENCANDLE_SOFT_DEGRADED",
+        formatField("provider", fields.provider),
+        formatField("fallback", fields.fallback),
+        `remediation=${quote(fields.remediation)}`,
+    ].join(" ") + "]";
+}
+export function buildSkippedTag(fields) {
+    const parts = [
+        "[OPENCANDLE_SKIPPED",
+        formatField("provider", fields.provider),
+        formatField("reason", fields.reason),
+        `remediation=${quote(fields.remediation)}`,
+    ];
+    if (fields.silenced) {
+        parts.push(formatField("silenced", "true"));
+    }
+    return `${parts.join(" ")}]`;
+}
+export function buildConnectedTag(fields) {
+    return `[OPENCANDLE_CONNECTED provider=${fields.provider}]`;
+}
+// -----------------------------------------------------------------------------
+// Parser
+// -----------------------------------------------------------------------------
+const TAG_LINE_REGEX = /\[OPENCANDLE_(CREDENTIAL_REQUIRED|SOFT_DEGRADED|SKIPPED|CONNECTED)([^\]]*)\]/;
+function parseFields(raw) {
+    // Split on `key=value` pairs, respecting quoted values.
+    const fields = {};
+    const pattern = /(\w+)=("((?:[^"\\]|\\.)*)"|([^\s\]]+))/g;
+    let match;
+    while ((match = pattern.exec(raw)) !== null) {
+        const key = match[1];
+        const value = match[3] !== undefined ? match[3].replace(/\\"/g, '"') : match[4];
+        fields[key] = value;
+    }
+    return fields;
+}
+export function parseToolTag(text) {
+    const match = TAG_LINE_REGEX.exec(text);
+    if (!match)
+        return undefined;
+    const kind = match[1];
+    const rest = match[2];
+    const fields = parseFields(rest);
+    switch (kind) {
+        case "CREDENTIAL_REQUIRED": {
+            const provider = fields.provider;
+            const reason = fields.reason;
+            const unlocksRaw = fields.unlocks ?? "";
+            const fallbackRaw = fields.fallback;
+            if (!provider || (reason !== "missing" && reason !== "stale")) {
+                return undefined;
+            }
+            const unlocks = unlocksRaw
+                .split(",")
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0);
+            const fallback = fallbackRaw === undefined || fallbackRaw === "none" ? null : fallbackRaw;
+            const parsed = {
+                kind: "credential_required",
+                provider: provider,
+                reason: reason,
+                unlocks,
+                fallback,
+            };
+            if (fields.httpStatus !== undefined) {
+                const n = Number(fields.httpStatus);
+                if (!Number.isNaN(n))
+                    parsed.httpStatus = n;
+            }
+            return parsed;
+        }
+        case "SOFT_DEGRADED": {
+            const { provider, fallback, remediation } = fields;
+            if (!provider || !fallback || !remediation)
+                return undefined;
+            return {
+                kind: "soft_degraded",
+                provider: provider,
+                fallback,
+                remediation,
+            };
+        }
+        case "SKIPPED": {
+            const { provider, reason, remediation } = fields;
+            if (!provider || reason !== "credential_not_provided" || !remediation) {
+                return undefined;
+            }
+            const parsed = {
+                kind: "skipped",
+                provider: provider,
+                reason: "credential_not_provided",
+                remediation,
+            };
+            if (fields.silenced === "true")
+                parsed.silenced = true;
+            return parsed;
+        }
+        case "CONNECTED": {
+            const { provider } = fields;
+            if (!provider)
+                return undefined;
+            return { kind: "connected", provider: provider };
+        }
+        default:
+            return undefined;
+    }
+}
+//# sourceMappingURL=tool-tags.js.map

package/dist/onboarding/tool-tags.js.map

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

package/dist/onboarding/validation.d.ts

@@ -0,0 +1,19 @@
+import type { ProviderId } from "./providers.js";
+export type ValidationResult = {
+    status: "valid";
+} | {
+    status: "invalid";
+    httpStatus?: number;
+    message?: string;
+} | {
+    status: "transient";
+    reason: string;
+};
+/**
+ * Validate a pasted credential against the provider's API. Returns a
+ * ValidationResult describing whether the key should be persisted.
+ *
+ * This function is side-effect-free beyond the network call: it does not
+ * touch the config file, onboarding state, or any in-memory cache.
+ */
+export declare function validateCredential(providerId: ProviderId, key: string): Promise<ValidationResult>;

package/dist/onboarding/validation.js

@@ -0,0 +1,117 @@
+// Pre-persist credential validation for OpenCandle data providers.
+//
+// Each `validateCredential` call makes a single cheap request to the
+// provider's canonical API with the pasted key and classifies the response
+// into one of three states:
+//
+//   - `valid`      — provider accepted the credential (persist it)
+//   - `invalid`    — provider rejected the credential (do NOT persist;
+//                    re-prompt or return a classified failure)
+//   - `transient`  — network/timeout/server error (persist anyway; the next
+//                    tool call will surface any real issue and re-open the
+//                    prompt via the credential-required tag)
+//
+// The endpoint chosen for each provider is the cheapest one available that
+// also exercises the auth header/query param — we don't pay for meaningful
+// data, just "did the server like the key". Alpha Vantage is a special case:
+// it returns HTTP 200 even for bad keys, with an `Error Message` or
+// `Information` field in the JSON body, so the body must be inspected.
+//
+// All validators share a 5-second timeout via `AbortSignal.timeout` so the
+// connect flow cannot hang if a provider is unreachable.
+const VALIDATION_TIMEOUT_MS = 5_000;
+async function validateWithFetch(url, init, classifyBody) {
+    try {
+        const response = await fetch(url, {
+            ...init,
+            signal: AbortSignal.timeout(VALIDATION_TIMEOUT_MS),
+        });
+        // Hard auth failures — the key is definitively bad.
+        if (response.status === 401 || response.status === 403) {
+            return { status: "invalid", httpStatus: response.status };
+        }
+        // FRED returns 400 with an `error_message` for bad keys.
+        if (response.status === 400) {
+            return { status: "invalid", httpStatus: 400 };
+        }
+        // 5xx and other non-2xx — treat as transient. Don't block the user on a
+        // provider outage; the next real tool call will surface a fresh error.
+        if (!response.ok) {
+            return { status: "transient", reason: `HTTP ${response.status}` };
+        }
+        // Body-level classification for providers that return 200 with an error
+        // shape (Alpha Vantage).
+        if (classifyBody) {
+            const body = await response.text();
+            const classified = classifyBody(body);
+            if (classified)
+                return classified;
+        }
+        return { status: "valid" };
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return { status: "transient", reason };
+    }
+}
+/**
+ * Alpha Vantage returns HTTP 200 with an error shape in the JSON body when
+ * the key is bad. Two fields to watch for:
+ *   - `Error Message`: indicates a malformed query OR an invalid key
+ *   - `Information`: used for rate-limit messages AND for "Invalid API key"
+ *
+ * The rate-limit form of `Information` is NOT an invalid-key signal, so we
+ * only match when the string mentions "invalid api".
+ */
+function classifyAlphaVantageBody(body) {
+    try {
+        const parsed = JSON.parse(body);
+        const errorMessage = parsed["Error Message"];
+        if (typeof errorMessage === "string" && errorMessage.length > 0) {
+            return { status: "invalid", message: errorMessage };
+        }
+        const information = parsed["Information"];
+        if (typeof information === "string" && /invalid api/i.test(information)) {
+            return { status: "invalid", message: information };
+        }
+    }
+    catch {
+        // Non-JSON body — fall through and trust the HTTP status.
+    }
+    return undefined;
+}
+/**
+ * Validate a pasted credential against the provider's API. Returns a
+ * ValidationResult describing whether the key should be persisted.
+ *
+ * This function is side-effect-free beyond the network call: it does not
+ * touch the config file, onboarding state, or any in-memory cache.
+ */
+export async function validateCredential(providerId, key) {
+    switch (providerId) {
+        case "alpha_vantage":
+            return validateWithFetch(`https://www.alphavantage.co/query?function=GLOBAL_QUOTE&symbol=IBM&apikey=${encodeURIComponent(key)}`, { method: "GET" }, classifyAlphaVantageBody);
+        case "fred":
+            return validateWithFetch(`https://api.stlouisfed.org/fred/series?series_id=GDP&api_key=${encodeURIComponent(key)}&file_type=json`, { method: "GET" });
+        case "finnhub":
+            return validateWithFetch(`https://finnhub.io/api/v1/quote?symbol=AAPL&token=${encodeURIComponent(key)}`, { method: "GET" });
+        case "brave":
+            return validateWithFetch("https://api.search.brave.com/res/v1/web/search?q=test&count=1", {
+                method: "GET",
+                headers: {
+                    "X-Subscription-Token": key,
+                    Accept: "application/json",
+                },
+            });
+        case "exa":
+            return validateWithFetch("https://api.exa.ai/search", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": key,
+                },
+                body: JSON.stringify({ query: "test", numResults: 1 }),
+            });
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/onboarding/validation.js.map

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

package/dist/pi/opencandle-extension.d.ts

@@ -1,6 +1,12 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { RouterLlmClient } from "../routing/router-types.js";
 import type { AskUserHandler } from "../types/index.js";
 export interface OpenCandleExtensionOptions {
     askUserHandler?: AskUserHandler;
+    /**
+     * Optional router LLM client. When provided, this instance is used instead
+     * of the pi-ai-backed default. Intended for tests + offline eval runners.
+     */
+    routerLlmClient?: RouterLlmClient;
 }
 export default function openCandleExtension(pi: ExtensionAPI, options?: OpenCandleExtensionOptions): void;