@webability/core 1.14.0 → 1.15.0

package/dist/hostedFixJudge-DXYes7X1.d.cts

@@ -0,0 +1,62 @@
+/**
+ * Thin client of the hosted FIX judge (POST /api/judge-fixes on the WebAbility
+ * platform).
+ *
+ * This file holds the wire contract and one `fetch`. It holds NO judge: the
+ * prompts, model routing, verdict rules, value correction and agent tools run
+ * on the platform and never ship in this package. A caller sends { url, fixes }
+ * and gets back a verdict per fix: whether the fix is needed and right
+ * (`apply`), a better value when the sent one is wrong, and a one-line reason.
+ *
+ * The platform answers only a user bearer token or the hosted MCP's
+ * `x-mcp-internal` secret. Any non-2xx is an error: the caller treats every
+ * fix of that call as unjudged (never as approved).
+ */
+/** Fixes per request; the platform rejects more. */
+declare const FIX_JUDGE_MAX_FIXES = 20;
+interface FixJudgeFix {
+    issue_type: string;
+    selector: string;
+    /** The attribute the fix writes (alt, aria-label, title, ...). */
+    attr: string;
+    value: string;
+}
+interface FixJudgeRequest {
+    /** The public page the fixes were produced on; the platform loads it itself. */
+    url: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    fixes: FixJudgeFix[];
+}
+type FixJudgeVerdictKind = 'correct_needed' | 'correct_unneeded' | 'wrong_value' | 'harmful' | 'unclear';
+interface FixJudgeVerdict {
+    /** Position of the fix in the request. */
+    index: number;
+    verdict: FixJudgeVerdictKind;
+    /** True only when the judge is sure the fix is needed and right as sent. */
+    apply: boolean;
+    /** wrong_value only: the value the judge says would be right. */
+    suggestedValue?: string;
+    /** One line. */
+    reason: string;
+}
+type FixJudgeTransport = (req: FixJudgeRequest, signal: AbortSignal) => Promise<{
+    verdicts: FixJudgeVerdict[];
+}>;
+declare class FixJudgeHttpError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+/**
+ * Transport for the hosted fix judge. `token` is a user bearer; `mcpInternalSecret` is the
+ * hosted MCP's shared secret. Send one or both; with neither the platform answers 401.
+ */
+declare function hostedFixJudgeTransport(cfg: {
+    apiUrl: string;
+    token?: string;
+    mcpInternalSecret?: string;
+}): FixJudgeTransport;
+
+export { FIX_JUDGE_MAX_FIXES as F, type FixJudgeFix as a, FixJudgeHttpError as b, type FixJudgeRequest as c, type FixJudgeTransport as d, type FixJudgeVerdict as e, type FixJudgeVerdictKind as f, hostedFixJudgeTransport as h };

package/dist/hostedFixJudge-DXYes7X1.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Thin client of the hosted FIX judge (POST /api/judge-fixes on the WebAbility
+ * platform).
+ *
+ * This file holds the wire contract and one `fetch`. It holds NO judge: the
+ * prompts, model routing, verdict rules, value correction and agent tools run
+ * on the platform and never ship in this package. A caller sends { url, fixes }
+ * and gets back a verdict per fix: whether the fix is needed and right
+ * (`apply`), a better value when the sent one is wrong, and a one-line reason.
+ *
+ * The platform answers only a user bearer token or the hosted MCP's
+ * `x-mcp-internal` secret. Any non-2xx is an error: the caller treats every
+ * fix of that call as unjudged (never as approved).
+ */
+/** Fixes per request; the platform rejects more. */
+declare const FIX_JUDGE_MAX_FIXES = 20;
+interface FixJudgeFix {
+    issue_type: string;
+    selector: string;
+    /** The attribute the fix writes (alt, aria-label, title, ...). */
+    attr: string;
+    value: string;
+}
+interface FixJudgeRequest {
+    /** The public page the fixes were produced on; the platform loads it itself. */
+    url: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    fixes: FixJudgeFix[];
+}
+type FixJudgeVerdictKind = 'correct_needed' | 'correct_unneeded' | 'wrong_value' | 'harmful' | 'unclear';
+interface FixJudgeVerdict {
+    /** Position of the fix in the request. */
+    index: number;
+    verdict: FixJudgeVerdictKind;
+    /** True only when the judge is sure the fix is needed and right as sent. */
+    apply: boolean;
+    /** wrong_value only: the value the judge says would be right. */
+    suggestedValue?: string;
+    /** One line. */
+    reason: string;
+}
+type FixJudgeTransport = (req: FixJudgeRequest, signal: AbortSignal) => Promise<{
+    verdicts: FixJudgeVerdict[];
+}>;
+declare class FixJudgeHttpError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+/**
+ * Transport for the hosted fix judge. `token` is a user bearer; `mcpInternalSecret` is the
+ * hosted MCP's shared secret. Send one or both; with neither the platform answers 401.
+ */
+declare function hostedFixJudgeTransport(cfg: {
+    apiUrl: string;
+    token?: string;
+    mcpInternalSecret?: string;
+}): FixJudgeTransport;
+
+export { FIX_JUDGE_MAX_FIXES as F, type FixJudgeFix as a, FixJudgeHttpError as b, type FixJudgeRequest as c, type FixJudgeTransport as d, type FixJudgeVerdict as e, type FixJudgeVerdictKind as f, hostedFixJudgeTransport as h };