@warmdrift/kgauto-compiler 2.0.0-alpha.7 → 2.0.0-alpha.70

package/dist/chunk-65ZMX5OT.mjs

@@ -0,0 +1,169 @@
+// src/brain-proxy.ts
+var SEGMENT_TO_TABLE = {
+  outcomes: "compile_outcomes",
+  compile_outcome_advisories: "compile_outcome_advisories",
+  compile_outcome_quality: "compile_outcome_quality",
+  probe_outcomes: "probe_outcomes",
+  // alpha.62 (eval spine): golden-set capture. Only receives rows when the
+  // consumer has explicitly opted in via KGAUTO_GOLDEN_CAPTURE — the segment
+  // existing here does not by itself store anything.
+  golden_irs: "kgauto_golden_irs"
+};
+var KNOWN_SEGMENTS = Object.keys(SEGMENT_TO_TABLE);
+var JSON_HEADERS = { "Content-Type": "application/json" };
+function jsonResponse(status, body) {
+  return new Response(JSON.stringify(body), { status, headers: JSON_HEADERS });
+}
+function bearerOf(req) {
+  const header = req.headers.get("Authorization") ?? "";
+  const match = /^Bearer\s+(.+)$/i.exec(header);
+  return match?.[1]?.trim() ?? "";
+}
+function requireString(name, value) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`createBrainForwardRoutes: ${name} is required`);
+  }
+  return value;
+}
+function isNumericOutcomeId(value) {
+  return typeof value === "number" || typeof value === "string" && /^\d+$/.test(value);
+}
+function createBrainForwardRoutes(config) {
+  const ingestSecret = requireString("ingestSecret", config.ingestSecret);
+  const brainUrl = requireString("brainUrl", config.brainUrl).replace(/\/+$/, "");
+  const serviceKey = requireString("serviceKey", config.serviceKey);
+  const fetchFn = config.fetchImpl ?? fetch;
+  async function resolveQualityOutcomeIds(body) {
+    const rows = Array.isArray(body) ? body : [body];
+    const handles = [
+      ...new Set(
+        rows.map((r) => r?.outcome_id).filter(
+          (v) => typeof v === "string" && !isNumericOutcomeId(v)
+        )
+      )
+    ];
+    if (handles.length === 0) return body;
+    const list = handles.map((h) => `"${h.replace(/"/g, "")}"`).join(",");
+    const url = `${brainUrl}/rest/v1/compile_outcomes?select=id,handle&handle=in.(${encodeURIComponent(list)})&order=id.desc`;
+    let idByHandle;
+    try {
+      const res = await fetchFn(url, {
+        headers: { apikey: serviceKey, Authorization: `Bearer ${serviceKey}` }
+      });
+      if (!res.ok) {
+        const text = await res.text().catch(() => "<no body>");
+        return jsonResponse(502, {
+          error: "handle-resolution-failed",
+          table: "compile_outcome_quality",
+          status: res.status,
+          detail: text
+        });
+      }
+      const found = await res.json();
+      idByHandle = /* @__PURE__ */ new Map();
+      for (const r of found) {
+        if (!idByHandle.has(r.handle)) idByHandle.set(r.handle, r.id);
+      }
+    } catch (err) {
+      return jsonResponse(502, {
+        error: "handle-resolution-failed",
+        table: "compile_outcome_quality",
+        detail: err instanceof Error ? err.message : String(err)
+      });
+    }
+    const unresolved = handles.filter((h) => !idByHandle.has(h));
+    if (unresolved.length > 0) {
+      return jsonResponse(404, {
+        error: "handle_not_found",
+        table: "compile_outcome_quality",
+        unresolved
+      });
+    }
+    const rewritten = rows.map(
+      (r) => typeof r?.outcome_id === "string" && idByHandle.has(r.outcome_id) ? { ...r, outcome_id: idByHandle.get(r.outcome_id) } : r
+    );
+    return Array.isArray(body) ? rewritten : rewritten[0];
+  }
+  async function handle(req, segment) {
+    try {
+      if (req.method !== "POST") {
+        return jsonResponse(405, {
+          error: "method-not-allowed",
+          method: req.method,
+          allowed: ["POST"]
+        });
+      }
+      const table = SEGMENT_TO_TABLE[segment];
+      if (!table) {
+        return jsonResponse(404, {
+          error: "unknown-brain-forward-segment",
+          segment,
+          known: KNOWN_SEGMENTS
+        });
+      }
+      if (bearerOf(req) !== ingestSecret) {
+        return jsonResponse(401, { error: "unauthorized" });
+      }
+      let body;
+      try {
+        body = await req.json();
+      } catch {
+        return jsonResponse(400, { error: "invalid-json" });
+      }
+      let row = Array.isArray(body) ? body : { ...body };
+      if (table === "compile_outcome_quality") {
+        const outcome = await resolveQualityOutcomeIds(row);
+        if (outcome instanceof Response) return outcome;
+        row = outcome;
+      }
+      const wantsRepresentation = /return=representation/i.test(
+        req.headers.get("Prefer") ?? ""
+      );
+      let brainRes;
+      try {
+        brainRes = await fetchFn(`${brainUrl}/rest/v1/${table}`, {
+          method: "POST",
+          headers: {
+            apikey: serviceKey,
+            Authorization: `Bearer ${serviceKey}`,
+            "Content-Type": "application/json",
+            Prefer: wantsRepresentation ? "return=representation" : "return=minimal"
+          },
+          body: JSON.stringify(row)
+        });
+      } catch (err) {
+        return jsonResponse(502, {
+          error: "brain-unreachable",
+          table,
+          detail: err instanceof Error ? err.message : String(err)
+        });
+      }
+      if (brainRes.ok) {
+        if (wantsRepresentation) {
+          const text2 = await brainRes.text().catch(() => "");
+          if (text2.length > 0) {
+            return new Response(text2, { status: 201, headers: JSON_HEADERS });
+          }
+        }
+        return jsonResponse(201, { ok: true });
+      }
+      const text = await brainRes.text().catch(() => "<no body>");
+      return jsonResponse(brainRes.status, {
+        error: "brain-write-failed",
+        table,
+        status: brainRes.status,
+        detail: text
+      });
+    } catch (err) {
+      return jsonResponse(500, {
+        error: "brain-forward-internal-error",
+        detail: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return { handle, segments: KNOWN_SEGMENTS };
+}
+
+export {
+  createBrainForwardRoutes
+};

package/dist/{chunk-5TI6PNSK.mjs → chunk-BVEXV5KC.mjs}

@@ -45,12 +45,22 @@ var INTENT_ARCHETYPES = {
     name: "transform",
     description: "Change format or style while preserving content",
     examples: ["markdown \u2192 html", "formal \u2192 casual", "translate"]
+  },
+  judge: {
+    name: "judge",
+    description: "Pairwise comparison of two candidate outputs for the same input",
+    examples: ["golden-set eval A/B verdict", "model-swap non-inferiority check", "response bake-off"]
   }
 };
 var ALL_ARCHETYPES = Object.keys(INTENT_ARCHETYPES);
 function isArchetype(name) {
   return name in INTENT_ARCHETYPES;
 }
+function resolveOutputMode(args) {
+  if (args.declared) return args.declared;
+  if (args.structuredOutput === true) return "json";
+  return args.toolCount > 0 ? "tool_call" : "text";
+}
 function bucketContext(tokens) {
   if (tokens < 1e3) return "tiny";
   if (tokens < 4e3) return "small";
@@ -87,6 +97,7 @@ export {
   INTENT_ARCHETYPES,
   ALL_ARCHETYPES,
   isArchetype,
+  resolveOutputMode,
   bucketContext,
   bucketToolCount,
   bucketHistory,

package/dist/chunk-FR4DNGLW.mjs

@@ -0,0 +1,203 @@
+// src/version.ts
+var LIBRARY_VERSION = "2.0.0-alpha.70";
+
+// src/key-health.ts
+var JSON_HEADERS = { "Content-Type": "application/json" };
+function jsonResponse(status, body) {
+  return new Response(JSON.stringify(body), { status, headers: JSON_HEADERS });
+}
+function bearerOf(req) {
+  const header = req.headers.get("Authorization") ?? "";
+  const match = /^Bearer\s+(.+)$/i.exec(header);
+  return match?.[1]?.trim() ?? "";
+}
+function requireString(name, value) {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`createKeyHealthRoute: ${name} is required`);
+  }
+  return value;
+}
+function envKey(env, name) {
+  const v = env[name];
+  if (typeof v !== "string") return void 0;
+  const trimmed = v.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+var PROBE_SPECS = [
+  {
+    provider: "anthropic",
+    canonicalEnvName: "ANTHROPIC_API_KEY",
+    buildRequest: (key) => ({
+      url: "https://api.anthropic.com/v1/models?limit=1",
+      headers: { "x-api-key": key, "anthropic-version": "2023-06-01" }
+    })
+  },
+  {
+    provider: "deepseek",
+    canonicalEnvName: "DEEPSEEK_API_KEY",
+    buildRequest: (key) => ({
+      url: "https://api.deepseek.com/user/balance",
+      headers: { Authorization: `Bearer ${key}` }
+    }),
+    parseBalanceUsd: (body) => {
+      const infos = body?.balance_infos;
+      if (!Array.isArray(infos) || infos.length === 0) return void 0;
+      const first = infos[0];
+      if (first?.currency !== "USD") return void 0;
+      const n = Number(first.total_balance);
+      return Number.isFinite(n) ? n : void 0;
+    }
+  },
+  {
+    provider: "moonshot",
+    canonicalEnvName: "MOONSHOT_API_KEY",
+    buildRequest: (key) => ({
+      url: "https://api.moonshot.ai/v1/models",
+      headers: { Authorization: `Bearer ${key}` }
+    })
+  },
+  {
+    provider: "google",
+    canonicalEnvName: "GEMINI_API_KEY",
+    buildRequest: (key) => ({
+      url: `https://generativelanguage.googleapis.com/v1beta/models?pageSize=1&key=${encodeURIComponent(key)}`,
+      headers: {}
+    })
+  },
+  {
+    provider: "openai",
+    canonicalEnvName: "OPENAI_API_KEY",
+    buildRequest: (key) => ({
+      url: "https://api.openai.com/v1/models",
+      headers: { Authorization: `Bearer ${key}` }
+    })
+  }
+];
+function createKeyHealthRoute(config) {
+  const appId = requireString("appId", config.appId);
+  const ingestSecret = requireString("ingestSecret", config.ingestSecret);
+  const fetchFn = config.fetchImpl ?? fetch;
+  const timeoutMs = config.timeoutMs ?? 3e3;
+  async function probeProvider(spec, env) {
+    let key;
+    let envName = spec.canonicalEnvName;
+    if (spec.provider === "google") {
+      const gemini = envKey(env, "GEMINI_API_KEY");
+      const google = envKey(env, "GOOGLE_API_KEY");
+      const aiSdk = envKey(env, "GOOGLE_GENERATIVE_AI_API_KEY");
+      key = gemini ?? google ?? aiSdk;
+      envName = gemini ? "GEMINI_API_KEY" : google ? "GOOGLE_API_KEY" : aiSdk ? "GOOGLE_GENERATIVE_AI_API_KEY" : "GEMINI_API_KEY";
+    } else if (spec.provider === "moonshot") {
+      const moonshot = envKey(env, "MOONSHOT_API_KEY");
+      const kimi = envKey(env, "KIMI_API_KEY");
+      key = moonshot ?? kimi;
+      envName = moonshot ? "MOONSHOT_API_KEY" : kimi ? "KIMI_API_KEY" : "MOONSHOT_API_KEY";
+    } else {
+      key = envKey(env, spec.canonicalEnvName);
+    }
+    if (!key) {
+      return {
+        provider: spec.provider,
+        env: envName,
+        present: false,
+        valid: null,
+        detail: "key_absent"
+      };
+    }
+    const base = {
+      provider: spec.provider,
+      env: envName,
+      present: true,
+      valid: null
+    };
+    const { url, headers } = spec.buildRequest(key);
+    const started = Date.now();
+    let res;
+    try {
+      res = await fetchFn(url, {
+        method: "GET",
+        headers,
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+    } catch (err) {
+      const isTimeout = err instanceof Error && (err.name === "TimeoutError" || err.name === "AbortError");
+      return {
+        ...base,
+        latency_ms: Date.now() - started,
+        // NEVER echo err.message — provider errors could theoretically carry
+        // request context; a fixed vocabulary keeps key material impossible.
+        detail: isTimeout ? "timeout" : "network_error"
+      };
+    }
+    const latencyMs = Date.now() - started;
+    if (res.ok) {
+      const result = {
+        ...base,
+        valid: true,
+        status: res.status,
+        latency_ms: latencyMs
+      };
+      if (spec.parseBalanceUsd) {
+        try {
+          const body = await res.json();
+          const balance = spec.parseBalanceUsd(body);
+          if (balance !== void 0) result.balance_usd = balance;
+        } catch {
+        }
+      }
+      return result;
+    }
+    if (res.status === 401 || res.status === 403) {
+      return { ...base, valid: false, status: res.status, latency_ms: latencyMs };
+    }
+    return {
+      ...base,
+      valid: null,
+      status: res.status,
+      latency_ms: latencyMs,
+      detail: `http_${res.status}`
+    };
+  }
+  async function handle(req) {
+    try {
+      if (req.method !== "GET") {
+        return jsonResponse(405, { error: "method_not_allowed" });
+      }
+      if (bearerOf(req) !== ingestSecret) {
+        return jsonResponse(401, { error: "unauthorized" });
+      }
+      const env = config.env ?? process.env;
+      const settled = await Promise.allSettled(
+        PROBE_SPECS.map((spec) => probeProvider(spec, env))
+      );
+      const keys = settled.map((s, i) => {
+        if (s.status === "fulfilled") return s.value;
+        const spec = PROBE_SPECS[i];
+        return {
+          provider: spec.provider,
+          env: spec.canonicalEnvName,
+          present: true,
+          valid: null,
+          detail: "probe_failed"
+        };
+      });
+      keys.sort((a, b) => a.provider.localeCompare(b.provider));
+      const body = {
+        app_id: appId,
+        checked_at: (/* @__PURE__ */ new Date()).toISOString(),
+        library_version: LIBRARY_VERSION,
+        keys
+      };
+      return jsonResponse(200, body);
+    } catch (err) {
+      void err;
+      return jsonResponse(500, { error: "key_health_internal_error" });
+    }
+  }
+  return { handle };
+}
+
+export {
+  LIBRARY_VERSION,
+  createKeyHealthRoute
+};

package/dist/chunk-NBO4R5PC.mjs

@@ -0,0 +1,313 @@
+// src/glassbox/types.ts
+var GLASSBOX_STREAM_TTL_MS = 6e4;
+
+// src/glassbox/pubsub-upstash.ts
+var UpstashPubSub = class {
+  url;
+  token;
+  fetchImpl;
+  blockMs;
+  maxLen;
+  constructor(cfg) {
+    this.url = cfg.url.replace(/\/$/, "");
+    this.token = cfg.token;
+    this.fetchImpl = cfg.fetchImpl ?? globalThis.fetch.bind(globalThis);
+    this.blockMs = cfg.blockMs ?? 100;
+    this.maxLen = cfg.maxLen ?? 100;
+  }
+  async publish(channelKey, event) {
+    const key = channelKey;
+    const payload = JSON.stringify(event);
+    await this.cmd([
+      "XADD",
+      key,
+      "MAXLEN",
+      "~",
+      String(this.maxLen),
+      "*",
+      "event",
+      payload
+    ]);
+    await this.cmd(["EXPIRE", key, String(Math.ceil(GLASSBOX_STREAM_TTL_MS / 1e3))]);
+  }
+  subscribe(channelKey) {
+    const key = channelKey;
+    const self = this;
+    let cursor = "$";
+    let cancelled = false;
+    let ttlDeadline = Date.now() + GLASSBOX_STREAM_TTL_MS;
+    return new ReadableStream({
+      async start(controller) {
+        try {
+          while (!cancelled && Date.now() < ttlDeadline) {
+            const resp = await self.cmd([
+              "XREAD",
+              "BLOCK",
+              String(self.blockMs),
+              "STREAMS",
+              key,
+              cursor
+            ]);
+            if (cancelled) break;
+            const parsed = parseXReadResult(resp.result);
+            if (parsed.entries.length === 0) {
+              continue;
+            }
+            for (const entry of parsed.entries) {
+              const evt = decodeEvent(entry.fields);
+              if (evt) {
+                try {
+                  controller.enqueue(evt);
+                } catch {
+                  cancelled = true;
+                  break;
+                }
+              }
+              cursor = entry.id;
+            }
+            ttlDeadline = Date.now() + GLASSBOX_STREAM_TTL_MS;
+          }
+        } catch (err) {
+          if (!cancelled) {
+            try {
+              controller.error(err);
+            } catch {
+            }
+            return;
+          }
+        }
+        try {
+          controller.close();
+        } catch {
+        }
+      },
+      cancel() {
+        cancelled = true;
+      }
+    });
+  }
+  async cmd(args) {
+    const res = await this.fetchImpl(this.url, {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(args)
+    });
+    if (!res.ok) {
+      throw new Error(`Upstash ${args[0]} failed: HTTP ${res.status}`);
+    }
+    const json = await res.json();
+    if (json.error) {
+      throw new Error(`Upstash ${args[0]} failed: ${json.error}`);
+    }
+    return json;
+  }
+};
+function traceChannel(traceId) {
+  return `glassbox:trace:${traceId}`;
+}
+function appChannel(appId) {
+  return `glassbox:app:${appId}`;
+}
+function decodeEvent(fields) {
+  const raw = fields["event"];
+  if (!raw) return void 0;
+  try {
+    const parsed = JSON.parse(raw);
+    if (typeof parsed.kind === "string" && typeof parsed.at === "number") {
+      return parsed;
+    }
+    return void 0;
+  } catch {
+    return void 0;
+  }
+}
+function parseXReadResult(raw) {
+  if (!Array.isArray(raw)) return { entries: [] };
+  const entries = [];
+  for (const stream of raw) {
+    if (!Array.isArray(stream) || stream.length < 2) continue;
+    const streamEntries = stream[1];
+    if (!Array.isArray(streamEntries)) continue;
+    for (const entry of streamEntries) {
+      if (!Array.isArray(entry) || entry.length < 2) continue;
+      const id = String(entry[0]);
+      const flat = entry[1];
+      if (!Array.isArray(flat)) continue;
+      const fields = {};
+      for (let i = 0; i < flat.length; i += 2) {
+        const k = flat[i];
+        const v = flat[i + 1];
+        if (typeof k === "string") fields[k] = String(v ?? "");
+      }
+      entries.push({ id, fields });
+    }
+  }
+  return { entries };
+}
+
+// src/glassbox/pubsub-memory.ts
+var MemoryPubSub = class {
+  subscribers = /* @__PURE__ */ new Map();
+  async publish(channelKey, event) {
+    const subs = this.subscribers.get(channelKey);
+    if (!subs || subs.size === 0) return;
+    for (const sub of subs) {
+      if (sub.closed) continue;
+      try {
+        sub.controller.enqueue(event);
+      } catch {
+        sub.closed = true;
+        continue;
+      }
+      this.refreshTtl(channelKey, sub);
+    }
+  }
+  subscribe(channelKey) {
+    const self = this;
+    let sub;
+    return new ReadableStream({
+      start(controller) {
+        sub = {
+          controller,
+          ttlTimer: setTimeout(() => {
+            self.closeSubscriber(channelKey, sub);
+          }, GLASSBOX_STREAM_TTL_MS),
+          closed: false
+        };
+        let set = self.subscribers.get(channelKey);
+        if (!set) {
+          set = /* @__PURE__ */ new Set();
+          self.subscribers.set(channelKey, set);
+        }
+        set.add(sub);
+      },
+      cancel() {
+        if (sub) self.removeSubscriber(channelKey, sub);
+      }
+    });
+  }
+  /**
+   * Refresh the rolling TTL for a subscriber after an event lands. Replaces
+   * the existing timer with a fresh 60s one.
+   */
+  refreshTtl(channelKey, sub) {
+    clearTimeout(sub.ttlTimer);
+    sub.ttlTimer = setTimeout(() => {
+      this.closeSubscriber(channelKey, sub);
+    }, GLASSBOX_STREAM_TTL_MS);
+  }
+  /**
+   * Close the subscriber's stream cleanly and remove from the fan-out set.
+   * Idempotent — safe to call multiple times.
+   */
+  closeSubscriber(channelKey, sub) {
+    if (sub.closed) return;
+    sub.closed = true;
+    clearTimeout(sub.ttlTimer);
+    try {
+      sub.controller.close();
+    } catch {
+    }
+    this.removeSubscriber(channelKey, sub);
+  }
+  removeSubscriber(channelKey, sub) {
+    clearTimeout(sub.ttlTimer);
+    const set = this.subscribers.get(channelKey);
+    if (!set) return;
+    set.delete(sub);
+    if (set.size === 0) this.subscribers.delete(channelKey);
+  }
+  /**
+   * Test-only reset. Tears down all subscribers, clears all state. Calling
+   * outside of tests is harmless but cancels every active stream.
+   */
+  _reset() {
+    for (const [, set] of this.subscribers) {
+      for (const sub of set) {
+        this.closeSubscriber("", sub);
+      }
+    }
+    this.subscribers.clear();
+  }
+};
+
+// src/glassbox/emit.ts
+var activePubSub;
+function getPubSub() {
+  if (activePubSub) return activePubSub;
+  const url = readEnv("UPSTASH_REDIS_URL");
+  const token = readEnv("UPSTASH_REDIS_TOKEN");
+  if (url && token) {
+    activePubSub = new UpstashPubSub({ url, token });
+  } else {
+    activePubSub = new MemoryPubSub();
+  }
+  return activePubSub;
+}
+function readEnv(key) {
+  try {
+    if (typeof process !== "undefined" && process.env) {
+      const v = process.env[key];
+      return v && v.trim() !== "" ? v : void 0;
+    }
+  } catch {
+  }
+  return void 0;
+}
+function emitGlassboxEvent(traceId, appId, kind, data) {
+  if (!traceId) return;
+  const event = { kind, at: Date.now(), data };
+  const ps = getPubSub();
+  try {
+    const p1 = ps.publish(traceChannel(traceId), event);
+    if (p1 && typeof p1.then === "function") {
+      p1.catch(() => {
+      });
+    }
+  } catch {
+  }
+  if (appId) {
+    try {
+      const p2 = ps.publish(appChannel(appId), event);
+      if (p2 && typeof p2.then === "function") {
+        p2.catch(() => {
+        });
+      }
+    } catch {
+    }
+  }
+}
+function emitCompileStart(traceId, appId, data) {
+  emitGlassboxEvent(traceId, appId, "compile.start", data);
+}
+function emitCompileDone(traceId, appId, data) {
+  emitGlassboxEvent(traceId, appId, "compile.done", data);
+}
+function emitExecuteAttempt(traceId, appId, data) {
+  emitGlassboxEvent(traceId, appId, "execute.attempt", data);
+}
+function emitExecuteSuccess(traceId, appId, data) {
+  emitGlassboxEvent(traceId, appId, "execute.success", data);
+}
+function emitAdvisoryFired(traceId, appId, data) {
+  emitGlassboxEvent(traceId, appId, "advisory.fired", data);
+}
+function emitFallbackWalked(traceId, appId, data) {
+  emitGlassboxEvent(traceId, appId, "fallback.walked", data);
+}
+
+export {
+  GLASSBOX_STREAM_TTL_MS,
+  traceChannel,
+  appChannel,
+  getPubSub,
+  emitCompileStart,
+  emitCompileDone,
+  emitExecuteAttempt,
+  emitExecuteSuccess,
+  emitAdvisoryFired,
+  emitFallbackWalked
+};