@enricai/barnacle 1.0.0

package/dist/lib/option-matcher.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEMANTIC_EQUIVALENCES = void 0;
+exports.matchToOptions = matchToOptions;
+const logging_1 = require("../lib/logging");
+const us_states_1 = require("../lib/us-states");
+const logger = (0, logging_1.getLogger)({ name: "lib/option-matcher" });
+/**
+ * Known synonyms keyed by their canonical option value (lowercased).
+ * When a payload sends a synonym, we return the canonical option.
+ */
+exports.SEMANTIC_EQUIVALENCES = {
+    "i do not wish to disclose": [
+        "prefer not to say",
+        "prefer not to disclose",
+        "decline to answer",
+        "decline",
+    ],
+    no: ["na", "n/a", "not applicable"],
+    "not a veteran": ["not applicable"],
+    "master's degree": ["ms", "m.s.", "masters", "master"],
+    "bachelor's degree": ["bs", "b.s.", "ba", "b.a.", "bachelors", "bachelor"],
+    "doctorate degree": ["phd", "ph.d.", "doctorate", "doctoral"],
+    "higher degree (phd/jd/md/do)": ["jd", "j.d.", "md", "m.d.", "do", "d.o."],
+    "associate's degree/college diploma": ["as", "a.s.", "aa", "a.a.", "associates", "associate"],
+    "high school diploma/ged": ["ged", "high school", "hs"],
+};
+/**
+ * Match a raw value against a question's allowed options. Dropdown questions
+ * on ATS forms require the submitted value to be one of the declared options —
+ * sending an out-of-list value typically causes a server error.
+ *
+ * Matching cascade: exact → case-insensitive → US state name→abbrev →
+ * semantic equivalence → substring containment → fallback to first option.
+ */
+function matchToOptions(rawValue, options) {
+    const stringOpts = options.filter((o) => typeof o === "string");
+    if (stringOpts.length === 0)
+        return rawValue;
+    const raw = rawValue.trim();
+    for (const opt of stringOpts) {
+        if (opt === raw)
+            return opt;
+    }
+    const rawLower = raw.toLowerCase();
+    for (const opt of stringOpts) {
+        if (opt.toLowerCase() === rawLower)
+            return opt;
+    }
+    const stateAbbrev = us_states_1.US_STATE_NAMES[rawLower];
+    if (stateAbbrev) {
+        for (const opt of stringOpts) {
+            if (opt.toUpperCase() === stateAbbrev)
+                return opt;
+        }
+    }
+    for (const opt of stringOpts) {
+        const synonyms = exports.SEMANTIC_EQUIVALENCES[opt.toLowerCase()];
+        if (synonyms?.some((s) => s === rawLower))
+            return opt;
+    }
+    for (const opt of stringOpts) {
+        if (opt.toLowerCase().includes(rawLower) || rawLower.includes(opt.toLowerCase()))
+            return opt;
+    }
+    logger.warn(`option mismatch: raw="${raw}" not in [${stringOpts.slice(0, 5).join(", ")}${stringOpts.length > 5 ? ", ..." : ""}] — using fallback "${stringOpts[0]}"`);
+    return stringOpts[0];
+}
+//# sourceMappingURL=option-matcher.js.map

package/dist/lib/option-matcher.js.map

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

package/dist/lib/phone.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Parses a US phone string into area code and subscriber number.
+ * Oracle HCM requires the phone split into `areaCode` (first 3 digits) and
+ * `number` (remaining digits). Inputs shorter than 10 digits get an empty
+ * `areaCode` so the partial number is still submitted as-is.
+ */
+export declare function parsePhone(raw: string): {
+    areaCode: string;
+    number: string;
+};
+//# sourceMappingURL=phone.d.ts.map

package/dist/lib/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../src/lib/phone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAM5E"}

package/dist/lib/phone.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePhone = parsePhone;
+/**
+ * Parses a US phone string into area code and subscriber number.
+ * Oracle HCM requires the phone split into `areaCode` (first 3 digits) and
+ * `number` (remaining digits). Inputs shorter than 10 digits get an empty
+ * `areaCode` so the partial number is still submitted as-is.
+ */
+function parsePhone(raw) {
+    const digits = raw.replace(/\D/g, "");
+    if (digits.length >= 10) {
+        return { areaCode: digits.slice(0, 3), number: digits.slice(3) };
+    }
+    return { areaCode: "", number: digits };
+}
+//# sourceMappingURL=phone.js.map

package/dist/lib/phone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.js","sourceRoot":"","sources":["../../src/lib/phone.ts"],"names":[],"mappings":";;AAMA,gCAMC;AAZD;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,GAAW;IACpC,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACtC,IAAI,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC1C,CAAC"}

package/dist/lib/random.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tiny RNG helpers shared by scraper jitter and metrics reservoir sampling.
+ *
+ * Exists because hand-rolled `Math.floor(Math.random() * ...)` and inline
+ * `pick a random index` blocks were duplicated across throttle.ts, metrics.ts,
+ * and session.ts. Centralising them keeps the bounds semantics (inclusive on
+ * both sides) consistent and gives the call sites a single name to scan for.
+ */
+/**
+ * Returns a uniformly distributed integer in the inclusive range [min, max].
+ * If `max <= min` the function returns `min` rather than producing NaN or
+ * an out-of-range value — callers in throttle/metrics rely on this guard.
+ */
+export declare function randomIntInclusive(min: number, max: number): number;
+/**
+ * Picks a uniformly random element from a non-empty readonly array. Falls
+ * back to `arr[0]` so the return type stays `T` (no undefined leakage) even
+ * if a typed empty array is somehow passed in — TypeScript's `readonly T[]`
+ * type does not prove non-emptiness at compile time.
+ */
+export declare function pickRandom<T>(arr: readonly T[]): T;
+//# sourceMappingURL=random.d.ts.map

package/dist/lib/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/lib/random.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAGlD"}

package/dist/lib/random.js

@@ -0,0 +1,33 @@
+"use strict";
+/**
+ * Tiny RNG helpers shared by scraper jitter and metrics reservoir sampling.
+ *
+ * Exists because hand-rolled `Math.floor(Math.random() * ...)` and inline
+ * `pick a random index` blocks were duplicated across throttle.ts, metrics.ts,
+ * and session.ts. Centralising them keeps the bounds semantics (inclusive on
+ * both sides) consistent and gives the call sites a single name to scan for.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.randomIntInclusive = randomIntInclusive;
+exports.pickRandom = pickRandom;
+/**
+ * Returns a uniformly distributed integer in the inclusive range [min, max].
+ * If `max <= min` the function returns `min` rather than producing NaN or
+ * an out-of-range value — callers in throttle/metrics rely on this guard.
+ */
+function randomIntInclusive(min, max) {
+    if (max <= min)
+        return min;
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+/**
+ * Picks a uniformly random element from a non-empty readonly array. Falls
+ * back to `arr[0]` so the return type stays `T` (no undefined leakage) even
+ * if a typed empty array is somehow passed in — TypeScript's `readonly T[]`
+ * type does not prove non-emptiness at compile time.
+ */
+function pickRandom(arr) {
+    const index = randomIntInclusive(0, arr.length - 1);
+    return arr[index] ?? arr[0];
+}
+//# sourceMappingURL=random.js.map

package/dist/lib/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../src/lib/random.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAOH,gDAGC;AAQD,gCAGC;AAnBD;;;;GAIG;AACH,SAAgB,kBAAkB,CAAC,GAAW,EAAE,GAAW;IACzD,IAAI,GAAG,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAI,GAAiB;IAC7C,MAAM,KAAK,GAAG,kBAAkB,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,CAAC,KAAK,CAAC,IAAK,GAAG,CAAC,CAAC,CAAO,CAAC;AACrC,CAAC"}

package/dist/lib/statsd.d.ts

@@ -0,0 +1,11 @@
+/**
+ * DogStatsD client singleton following Vivian's hot-shots pattern. Sends
+ * metrics to the Datadog agent when DD_TRACE_ENABLED=true; falls back to a
+ * mock client that logs at debug level for local dev without an agent.
+ */
+import type { StatsD as StatsDInstance } from "hot-shots";
+/** Returns the process-global DogStatsD client (lazily initialized). */
+export declare function getStatsD(): StatsDInstance;
+/** Flushes pending packets and closes the UDP socket. Call during shutdown. */
+export declare function shutdownStatsD(): Promise<void>;
+//# sourceMappingURL=statsd.d.ts.map

package/dist/lib/statsd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statsd.d.ts","sourceRoot":"","sources":["../../src/lib/statsd.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAuC1D,wEAAwE;AACxE,wBAAgB,SAAS,IAAI,cAAc,CAK1C;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAc9C"}

package/dist/lib/statsd.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * DogStatsD client singleton following Vivian's hot-shots pattern. Sends
+ * metrics to the Datadog agent when DD_TRACE_ENABLED=true; falls back to a
+ * mock client that logs at debug level for local dev without an agent.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStatsD = getStatsD;
+exports.shutdownStatsD = shutdownStatsD;
+const hot_shots_1 = __importDefault(require("hot-shots"));
+const env_1 = require("../lib/env");
+const logging_1 = require("../lib/logging");
+const logger = (0, logging_1.getLogger)({ name: "statsd" });
+function createClient() {
+    const traceEnabled = (0, env_1.getBoolEnv)("DD_TRACE_ENABLED", false);
+    if (traceEnabled) {
+        const host = (0, env_1.getEnv)("DD_AGENT_HOST", "localhost");
+        const port = (0, env_1.getNumericEnv)("DD_DOGSTATSD_PORT", 8125);
+        logger.info(`initializing DogStatsD client on ${host}:${port}`);
+        return new hot_shots_1.default({
+            host,
+            port,
+            prefix: "barnacle.",
+            globalTags: {
+                service: (0, env_1.getEnv)("DD_SERVICE", "barnacle"),
+                env: (0, env_1.getEnv)("DD_ENV", "development"),
+            },
+            errorHandler: (err) => {
+                logger.warn(`statsd send error: ${err.message}`);
+            },
+        });
+    }
+    logger.debug("initializing mock DogStatsD client (DD_TRACE_ENABLED is off)");
+    return new hot_shots_1.default({
+        mock: true,
+        prefix: "barnacle.",
+        globalTags: { service: "barnacle", env: "development" },
+    });
+}
+let client;
+/** Returns the process-global DogStatsD client (lazily initialized). */
+function getStatsD() {
+    if (!client) {
+        client = createClient();
+    }
+    return client;
+}
+/** Flushes pending packets and closes the UDP socket. Call during shutdown. */
+function shutdownStatsD() {
+    if (!client) {
+        return Promise.resolve();
+    }
+    const c = client;
+    return new Promise((resolve, reject) => {
+        c.close((err) => {
+            if (err) {
+                reject(err);
+            }
+            else {
+                resolve();
+            }
+        });
+    });
+}
+//# sourceMappingURL=statsd.js.map

package/dist/lib/statsd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statsd.js","sourceRoot":"","sources":["../../src/lib/statsd.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;AA0CH,8BAKC;AAGD,wCAcC;AA7DD,0DAA+B;AAE/B,mCAA8D;AAC9D,2CAA0C;AAE1C,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AAE7C,SAAS,YAAY;IACnB,MAAM,YAAY,GAAG,IAAA,gBAAU,EAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;IAE3D,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,IAAA,YAAM,EAAC,eAAe,EAAE,WAAW,CAAC,CAAC;QAClD,MAAM,IAAI,GAAG,IAAA,mBAAa,EAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,IAAI,CAAC,oCAAoC,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,mBAAM,CAAC;YAChB,IAAI;YACJ,IAAI;YACJ,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE;gBACV,OAAO,EAAE,IAAA,YAAM,EAAC,YAAY,EAAE,UAAU,CAAC;gBACzC,GAAG,EAAE,IAAA,YAAM,EAAC,QAAQ,EAAE,aAAa,CAAC;aACrC;YACD,YAAY,EAAE,CAAC,GAAU,EAAE,EAAE;gBAC3B,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACnD,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC7E,OAAO,IAAI,mBAAM,CAAC;QAChB,IAAI,EAAE,IAAI;QACV,MAAM,EAAE,WAAW;QACnB,UAAU,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE;KACxD,CAAC,CAAC;AACL,CAAC;AAED,IAAI,MAAkC,CAAC;AAEvC,wEAAwE;AACxE,SAAgB,SAAS;IACvB,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,GAAG,YAAY,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,SAAgB,cAAc;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC;IACjB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAsB,EAAE,EAAE;YACjC,IAAI,GAAG,EAAE,CAAC;gBACR,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/lib/telemetry/call-capture.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Append-only NDJSON sink for LLM/Stagehand call samples. Each call emits
+ * exactly one line so the judge and self-heal skills have a scoreable corpus
+ * without coupling this module to any specific call site.
+ */
+import { z } from "zod/v4";
+/**
+ * Categorical failure reason for an LLM call. Surfaces post-mortem without
+ * regex-scanning `errorMessage`. Discriminated upstream by the caller.
+ */
+export declare const llmCallFailureKindSchema: z.ZodEnum<{
+    "anthropic-billing": "anthropic-billing";
+    "anthropic-rate-limit": "anthropic-rate-limit";
+    "anthropic-other": "anthropic-other";
+    "schema-validation-failed": "schema-validation-failed";
+    "response-empty": "response-empty";
+    "exception-other": "exception-other";
+}>;
+export type LlmCallFailureKind = z.infer<typeof llmCallFailureKindSchema>;
+/**
+ * Anthropic returns status 400 + `error.type === "invalid_request_error"`
+ * for BOTH genuine bad-request errors AND quota/spend-limit exhaustion.
+ * The official taxonomy at https://platform.claude.com/docs/en/api/errors
+ * reuses the same enum value for format problems and quota hits; only the
+ * embedded `error.message` text discriminates the latter. This regex is
+ * confined to that single ambiguous status+type branch in
+ * classifyLlmCallFailure — it is not a broad message scan.
+ */
+export declare const ANTHROPIC_QUOTA_MESSAGE_RX: RegExp;
+/**
+ * Classify a thrown LLM-call error into one of the discrete failure kinds.
+ *
+ * Strategy (priority-ordered):
+ *   1. Status + structured `error.type` from the SDK fields. Anthropic's
+ *      documented taxonomy: 402 + billing_error = payment; 429 +
+ *      rate_limit_error = rate-limited.
+ *   2. For the (400 + invalid_request_error) tuple, Anthropic provides no
+ *      structural discriminator between "bad format" and "quota exhausted"
+ *      — match the embedded error.message against ANTHROPIC_QUOTA_MESSAGE_RX
+ *      to identify the latter. This is the one documented exception to
+ *      structural classification.
+ *   3. Best-effort fallbacks for errors whose SDK shape stripped structure
+ *      (legacy paths, generic exceptions).
+ *
+ * SDK-agnostic via duck-typing — works with @anthropic-ai/sdk's APIError,
+ * Vercel ai SDK's APICallError, or any provider exposing similar fields.
+ */
+export declare function classifyLlmCallFailure(err: unknown): LlmCallFailureKind;
+/**
+ * Validated shape of one LLM call sample. Field names follow beacon/pila's
+ * NDJSON contract but in Barnacle's camelCase convention.
+ */
+export declare const llmCallSampleSchema: z.ZodObject<{
+    callId: z.ZodString;
+    callType: z.ZodString;
+    model: z.ZodString;
+    systemPrompt: z.ZodNullable<z.ZodString>;
+    userContent: z.ZodString;
+    responseContent: z.ZodNullable<z.ZodString>;
+    parsedOk: z.ZodBoolean;
+    inputTokens: z.ZodNullable<z.ZodNumber>;
+    outputTokens: z.ZodNullable<z.ZodNumber>;
+    latencyMs: z.ZodNullable<z.ZodNumber>;
+    success: z.ZodBoolean;
+    errorMessage: z.ZodNullable<z.ZodString>;
+    failureKind: z.ZodNullable<z.ZodEnum<{
+        "anthropic-billing": "anthropic-billing";
+        "anthropic-rate-limit": "anthropic-rate-limit";
+        "anthropic-other": "anthropic-other";
+        "schema-validation-failed": "schema-validation-failed";
+        "response-empty": "response-empty";
+        "exception-other": "exception-other";
+    }>>;
+    ts: z.ZodString;
+}, z.core.$strip>;
+export type LlmCallSample = z.infer<typeof llmCallSampleSchema>;
+/** Input to `captureLlmCall` — `ts` is derived internally so callers omit it. */
+export type LlmCallInput = Omit<LlmCallSample, "ts">;
+/** Options for `captureLlmCall`. */
+export interface CaptureOptions {
+    /** Override the sink path; used in tests to avoid touching the real file. */
+    sinkPath?: string;
+}
+/**
+ * Appends one validated NDJSON line for an LLM call to the configured sink.
+ * Errors are logged and swallowed — telemetry must never break the happy path.
+ */
+export declare function captureLlmCall(input: LlmCallInput, opts?: CaptureOptions): Promise<void>;
+//# sourceMappingURL=call-capture.d.ts.map

package/dist/lib/telemetry/call-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-capture.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/call-capture.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAC;AAQ3B;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;EAOnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;GAQG;AACH,eAAO,MAAM,0BAA0B,QACiG,CAAC;AA+DzI;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,kBAAkB,CAqBvE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;iBAe9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,iFAAiF;AACjF,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;AAErD,oCAAoC;AACpC,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/lib/telemetry/call-capture.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Append-only NDJSON sink for LLM/Stagehand call samples. Each call emits
+ * exactly one line so the judge and self-heal skills have a scoreable corpus
+ * without coupling this module to any specific call site.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.llmCallSampleSchema = exports.ANTHROPIC_QUOTA_MESSAGE_RX = exports.llmCallFailureKindSchema = void 0;
+exports.classifyLlmCallFailure = classifyLlmCallFailure;
+exports.captureLlmCall = captureLlmCall;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const date_fns_1 = require("date-fns");
+const v4_1 = require("zod/v4");
+const config_1 = require("../../config");
+const logging_1 = require("../../lib/logging");
+const s3_sink_1 = require("../../lib/telemetry/s3-sink");
+const logger = (0, logging_1.getLogger)({ name: "telemetry/call-capture" });
+/**
+ * Categorical failure reason for an LLM call. Surfaces post-mortem without
+ * regex-scanning `errorMessage`. Discriminated upstream by the caller.
+ */
+exports.llmCallFailureKindSchema = v4_1.z.enum([
+    "anthropic-billing",
+    "anthropic-rate-limit",
+    "anthropic-other",
+    "schema-validation-failed",
+    "response-empty",
+    "exception-other",
+]);
+/**
+ * Anthropic returns status 400 + `error.type === "invalid_request_error"`
+ * for BOTH genuine bad-request errors AND quota/spend-limit exhaustion.
+ * The official taxonomy at https://platform.claude.com/docs/en/api/errors
+ * reuses the same enum value for format problems and quota hits; only the
+ * embedded `error.message` text discriminates the latter. This regex is
+ * confined to that single ambiguous status+type branch in
+ * classifyLlmCallFailure — it is not a broad message scan.
+ */
+exports.ANTHROPIC_QUOTA_MESSAGE_RX = /(your credit balance is too low|insufficient_quota|billing_hard_limit_reached|reached your specified API usage limits|usage limits)/i;
+/**
+ * Extract the HTTP status from any of: direct `.status`, `.statusCode`,
+ * or the `"<NNN> {json}"` prefix the Vercel ai SDK uses for its default
+ * error message format. Returns undefined when no status signal exists.
+ */
+function extractAnthropicStatus(errorObj, message) {
+    if (errorObj !== null) {
+        if (typeof errorObj.status === "number")
+            return errorObj.status;
+        if (typeof errorObj.statusCode === "number")
+            return errorObj.statusCode;
+    }
+    const match = message.match(/(?:^|\s)(\d{3})\s+\{/);
+    if (match?.[1]) {
+        const parsed = Number.parseInt(match[1], 10);
+        if (parsed >= 100 && parsed < 600)
+            return parsed;
+    }
+    return undefined;
+}
+/**
+ * Extract Anthropic's structured `error.type` from whichever shape the SDK
+ * chain exposed: direct `.type` (Anthropic SDK APIError), `.responseBody`
+ * JSON (Vercel ai SDK APICallError), `.data` (Vercel ai SDK), or the JSON
+ * body embedded in `err.message` as `"<status> {json}"` (the Vercel ai
+ * SDK's default toString format). Returns null when no structured marker
+ * is present.
+ */
+function extractAnthropicErrorType(errorObj) {
+    if (errorObj === null)
+        return null;
+    if (typeof errorObj.type === "string")
+        return errorObj.type;
+    const responseBody = errorObj.responseBody;
+    if (typeof responseBody === "string" && responseBody.length > 0) {
+        try {
+            const parsed = JSON.parse(responseBody);
+            const t = parsed.error?.type ?? parsed.type;
+            if (typeof t === "string")
+                return t;
+        }
+        catch {
+            // fall through
+        }
+    }
+    const data = errorObj.data;
+    if (data !== undefined && data !== null) {
+        const t = data.error?.type ?? data.type;
+        if (typeof t === "string")
+            return t;
+    }
+    const message = typeof errorObj.message === "string" ? errorObj.message : "";
+    const jsonMatch = message.match(/\d{3}\s+(\{.+\})$/s);
+    if (jsonMatch?.[1]) {
+        try {
+            const parsed = JSON.parse(jsonMatch[1]);
+            const t = parsed.error?.type ?? parsed.type;
+            if (typeof t === "string")
+                return t;
+        }
+        catch {
+            // fall through
+        }
+    }
+    return null;
+}
+/**
+ * Classify a thrown LLM-call error into one of the discrete failure kinds.
+ *
+ * Strategy (priority-ordered):
+ *   1. Status + structured `error.type` from the SDK fields. Anthropic's
+ *      documented taxonomy: 402 + billing_error = payment; 429 +
+ *      rate_limit_error = rate-limited.
+ *   2. For the (400 + invalid_request_error) tuple, Anthropic provides no
+ *      structural discriminator between "bad format" and "quota exhausted"
+ *      — match the embedded error.message against ANTHROPIC_QUOTA_MESSAGE_RX
+ *      to identify the latter. This is the one documented exception to
+ *      structural classification.
+ *   3. Best-effort fallbacks for errors whose SDK shape stripped structure
+ *      (legacy paths, generic exceptions).
+ *
+ * SDK-agnostic via duck-typing — works with @anthropic-ai/sdk's APIError,
+ * Vercel ai SDK's APICallError, or any provider exposing similar fields.
+ */
+function classifyLlmCallFailure(err) {
+    const errorObj = typeof err === "object" && err !== null ? err : null;
+    const message = err instanceof Error ? err.message : String(err);
+    const name = err instanceof Error ? err.name : "";
+    const structuredType = extractAnthropicErrorType(errorObj);
+    const status = extractAnthropicStatus(errorObj, message);
+    if (structuredType === "billing_error" || status === 402)
+        return "anthropic-billing";
+    if (structuredType === "rate_limit_error" || status === 429 || name === "RateLimitError") {
+        return "anthropic-rate-limit";
+    }
+    if (status === 400 && structuredType === "invalid_request_error") {
+        if (exports.ANTHROPIC_QUOTA_MESSAGE_RX.test(message))
+            return "anthropic-billing";
+        return "anthropic-other";
+    }
+    if (structuredType !== null)
+        return "anthropic-other";
+    if (typeof status === "number" && status >= 400 && status < 600)
+        return "anthropic-other";
+    if (exports.ANTHROPIC_QUOTA_MESSAGE_RX.test(message))
+        return "anthropic-billing";
+    if (/APIError$|AnthropicError$|APICallError$/.test(name))
+        return "anthropic-other";
+    if (/zod|schema|parsed_output is null/i.test(message))
+        return "schema-validation-failed";
+    return "exception-other";
+}
+/**
+ * Validated shape of one LLM call sample. Field names follow beacon/pila's
+ * NDJSON contract but in Barnacle's camelCase convention.
+ */
+exports.llmCallSampleSchema = v4_1.z.object({
+    callId: v4_1.z.string(),
+    callType: v4_1.z.string(),
+    model: v4_1.z.string(),
+    systemPrompt: v4_1.z.string().nullable(),
+    userContent: v4_1.z.string(),
+    responseContent: v4_1.z.string().nullable(),
+    parsedOk: v4_1.z.boolean(),
+    inputTokens: v4_1.z.number().int().nullable(),
+    outputTokens: v4_1.z.number().int().nullable(),
+    latencyMs: v4_1.z.number().nullable(),
+    success: v4_1.z.boolean(),
+    errorMessage: v4_1.z.string().nullable(),
+    failureKind: exports.llmCallFailureKindSchema.nullable(),
+    ts: v4_1.z.string(),
+});
+/**
+ * Appends one validated NDJSON line for an LLM call to the configured sink.
+ * Errors are logged and swallowed — telemetry must never break the happy path.
+ */
+async function captureLlmCall(input, opts = {}) {
+    const sinkPath = opts.sinkPath ?? config_1.config.telemetry.callsNdjsonPath;
+    const sample = { ...input, ts: (0, date_fns_1.formatISO)(new Date()) };
+    try {
+        const line = `${JSON.stringify(sample)}\n`;
+        await (0, promises_1.mkdir)((0, node_path_1.dirname)(sinkPath), { recursive: true });
+        await (0, promises_1.appendFile)(sinkPath, line, "utf8");
+        (0, s3_sink_1.bufferCallLine)(line);
+    }
+    catch (err) {
+        logger.error(`captureLlmCall: failed to write to ${sinkPath}: ${String(err)}`);
+    }
+}
+//# sourceMappingURL=call-capture.js.map

package/dist/lib/telemetry/call-capture.js.map

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

package/dist/lib/telemetry/call-types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Canonical call_type string constants for all LLM call sites Barnacle owns
+ * directly. Referencing these avoids magic strings in call sites, tests, and
+ * the judge/self-heal skills (feat-004/005).
+ */
+/** Attempt-4 rephrase inside the recon-browser step-healing cascade. */
+export declare const CALL_TYPE_RECON_REPHRASE = "recon-rephrase";
+/** Global replan after a step terminally fails in recon-browser. */
+export declare const CALL_TYPE_RECON_REPLAN = "recon-replan";
+/** Patch proposal from the recon-flow-patch-generator (recon-heal). */
+export declare const CALL_TYPE_RECON_FLOW_PATCH = "recon-flow-patch";
+/** Patch proposal from the llm-call-patch-generator (llm-heal). */
+export declare const CALL_TYPE_LLM_PROMPT_PATCH = "llm-prompt-patch";
+/**
+ * Stagehand `act()` envelope-validation. Captured by the guardedAct wrapper
+ * so every Stagehand-driven LLM call lands in the same NDJSON sink as
+ * Barnacle's own Anthropic-SDK calls. Per the user directive that every
+ * LLM-touching surface enforces a schema, every act call is logged
+ * regardless of outcome — full parity with our other call-type telemetry.
+ */
+export declare const CALL_TYPE_STAGEHAND_ACT = "stagehand-act";
+/** Stagehand `observe()` envelope-validation. See CALL_TYPE_STAGEHAND_ACT. */
+export declare const CALL_TYPE_STAGEHAND_OBSERVE = "stagehand-observe";
+/** Stagehand `extract()` schema-enforced call. See CALL_TYPE_STAGEHAND_ACT. */
+export declare const CALL_TYPE_STAGEHAND_EXTRACT = "stagehand-extract";
+/**
+ * Haiku 4.5 judge for submit-success verification. Replaces the per-site
+ * regex (`submitEndpointPattern`) that mislabeled successful submits as
+ * failures whenever AppCast used a different POST URL than the regex
+ * expected. The judge receives evidence (recent network captures, page
+ * URL/title, unfocused observe, site criteria) and returns a discriminated
+ * verdict — verified=true requires multi-signal corroboration to prevent
+ * lax false positives.
+ */
+export declare const CALL_TYPE_JUDGE_SUBMIT_VERIFY = "judge-submit-verify";
+/**
+ * Haiku 4.5 judge for invalid-field detection. Replaces INVALID_CLASS_RX
+ * (limited to ng-invalid / mat-form-field-invalid / is-invalid class
+ * signatures) with structured detection covering aria-invalid attributes,
+ * data-invalid attributes, and arbitrary framework variants we haven't
+ * seen yet. Strict prompting: only mark a field present when there's a
+ * structural invalid marker, not just visual red-border styling.
+ */
+export declare const CALL_TYPE_JUDGE_INVALID_FIELDS = "judge-invalid-fields";
+/**
+ * Haiku 4.5 judge for modal-priority ranking of unfocused-observe
+ * candidates. Replaces MODAL_PRIORITY_RX (keyword regex over English
+ * descriptions). Surfaces modals/dialogs/overlays that BLOCK the form,
+ * skips always-visible panels and sidebars that don't.
+ */
+export declare const CALL_TYPE_JUDGE_MODAL_PRIORITY = "judge-modal-priority";
+/**
+ * Haiku 4.5 judge for visible-error-message extraction. Replaces
+ * errorPattern (class-name regex). Extracts structurally-marked error
+ * messages with field hints and severity, skipping placeholder/help text.
+ */
+export declare const CALL_TYPE_JUDGE_ERROR_MESSAGES = "judge-error-messages";
+/**
+ * Haiku 4.5 judge that picks the best AVAILABLE option for a required
+ * dropdown when the flow's hardcoded answer text doesn't exist in this
+ * requisition's option list (per-req screening-question variance). Used by
+ * `trySelectPrimitive`'s LLM fallback.
+ */
+export declare const CALL_TYPE_JUDGE_SELECT_OPTION = "judge-select-option";
+//# sourceMappingURL=call-types.d.ts.map

package/dist/lib/telemetry/call-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"call-types.d.ts","sourceRoot":"","sources":["../../../src/lib/telemetry/call-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,mBAAmB,CAAC;AAEzD,oEAAoE;AACpE,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D,mEAAmE;AACnE,eAAO,MAAM,0BAA0B,qBAAqB,CAAC;AAE7D;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAE/D,+EAA+E;AAC/E,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAE/D;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE;;;;;;;GAOG;AACH,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC"}