@saguiitay/eventhouse-ai-observability 0.1.1 → 0.2.0

package/dist/validate.js

@@ -0,0 +1,237 @@
+#!/usr/bin/env node
+import {
+  createObservability
+} from "./chunk-XGCHW72B.js";
+
+// src/validation/fabric.ts
+import { randomUUID } from "crypto";
+import { setTimeout as sleep } from "timers/promises";
+var IngestionValidationError = class extends Error {
+  constructor(stage, message) {
+    super(message);
+    this.stage = stage;
+    this.name = "IngestionValidationError";
+  }
+  stage;
+};
+function interval(value, name, maximum) {
+  if (!Number.isSafeInteger(value) || value < 1 || value > maximum)
+    throw new IngestionValidationError(
+      "configuration",
+      `${name} must be a positive integer no greater than ${maximum}.`
+    );
+  return value;
+}
+function rows(value) {
+  const tables = value?.Tables;
+  if (Array.isArray(tables)) {
+    for (const table of tables) {
+      if (table === null || typeof table !== "object") continue;
+      const data = table;
+      if (!Array.isArray(data.Columns) || !Array.isArray(data.Rows)) continue;
+      const columns = data.Columns.map(
+        (column) => typeof column?.ColumnName === "string" ? column.ColumnName : ""
+      );
+      if (["traceId", "spanId", "parentSpanId"].every(
+        (name) => columns.includes(name)
+      )) {
+        if (data.Rows.every(Array.isArray))
+          return { columns, rows: data.Rows };
+      }
+    }
+  }
+  throw new IngestionValidationError(
+    "query",
+    "Unexpected query response; verify the Eventhouse query endpoint and trace schema."
+  );
+}
+async function validateFabricIngestion(options, dependencies = {}) {
+  let endpoint;
+  try {
+    endpoint = new URL(options.queryEndpoint);
+    if (endpoint.protocol !== "https:" || endpoint.username || endpoint.password || endpoint.search || endpoint.hash)
+      throw new Error();
+  } catch {
+    throw new IngestionValidationError(
+      "configuration",
+      "FABRIC_KQL_QUERY_ENDPOINT must be a credential-free HTTPS query URI."
+    );
+  }
+  if (!options.connectionString.trim() || !options.database.trim() || !options.accessToken.trim() || /[\r\n\0]/u.test(options.accessToken))
+    throw new IngestionValidationError(
+      "configuration",
+      "Supply producer credentials, a database name, and a valid query access token through the environment."
+    );
+  const timeout = interval(options.timeoutMs ?? 18e4, "timeoutMs", 9e5);
+  const poll = interval(
+    options.pollIntervalMs ?? 5e3,
+    "pollIntervalMs",
+    6e4
+  );
+  const now = dependencies.now ?? Date.now;
+  const wait = dependencies.sleep ?? sleep;
+  const send = dependencies.fetch ?? fetch;
+  const notify = (stage, message) => {
+    try {
+      void Promise.resolve(options.onProgress?.(stage, message)).catch(
+        () => {
+        }
+      );
+    } catch {
+    }
+  };
+  const runId = `validation-${randomUUID()}`;
+  let rootId = "";
+  let childId = "";
+  let traceId = "";
+  let observer;
+  let producerFailed = false;
+  notify("producer", "Sending two metadata-only validation spans.");
+  try {
+    observer = (dependencies.createObserver ?? createObservability)({
+      connectionString: options.connectionString,
+      ...options.entityName ? { entityName: options.entityName } : {},
+      serviceName: "eventhouse-ingestion-validation",
+      environment: "validation",
+      captureContent: false,
+      samplingRatio: 1,
+      exportTimeoutMs: Math.min(timeout, 15e3),
+      shutdownTimeoutMs: Math.min(timeout, 15e3)
+    });
+    const attributes = { "validation.run.id": runId };
+    const root = observer.startSpan("validation.root", { attributes });
+    const child = observer.startSpan("invoke_agent validation", {
+      parent: root,
+      attributes: { ...attributes, "gen_ai.operation.name": "invoke_agent" }
+    });
+    rootId = root.spanContext().spanId;
+    childId = child.spanContext().spanId;
+    traceId = root.spanContext().traceId;
+    child.end();
+    root.end();
+  } catch {
+    producerFailed = true;
+  } finally {
+    try {
+      await observer?.shutdown();
+    } catch {
+      producerFailed = true;
+    }
+  }
+  const diagnostics = observer?.getDiagnostics();
+  if (producerFailed || diagnostics?.eventsExported !== 2 || diagnostics.eventsDropped !== 0 || diagnostics.exportFailures !== 0)
+    throw new IngestionValidationError(
+      "producer",
+      "Producer acknowledgement failed; check source Send credentials, entity name, and network access."
+    );
+  notify(
+    "producer",
+    "Both spans acknowledged. This does not yet prove Eventhouse ingestion."
+  );
+  notify("ingestion", "Waiting for matching Eventhouse rows.");
+  const deadline = now() + timeout;
+  while (now() < deadline) {
+    let response;
+    let result;
+    try {
+      response = await send(new URL("/v1/rest/query", endpoint), {
+        method: "POST",
+        headers: {
+          authorization: `Bearer ${options.accessToken}`,
+          "content-type": "application/json"
+        },
+        body: JSON.stringify({
+          db: options.database,
+          csl: `AIObservabilityTraces | where tostring(spanAttributes["validation.run.id"]) == "${runId}" | summarize arg_max(timestamp, *) by traceId, spanId | project traceId, spanId, parentSpanId | take 3`
+        }),
+        signal: AbortSignal.timeout(
+          Math.max(1, Math.min(15e3, deadline - now()))
+        )
+      });
+      if (!response.ok) {
+        const message = response.status === 401 || response.status === 403 ? "Query authorization failed; check the separate Kusto query token and database permissions." : `Query failed with HTTP ${response.status}; check the query endpoint, database schema, and capacity.`;
+        throw new IngestionValidationError("query", message);
+      }
+      result = rows(await response.json());
+    } catch (error) {
+      if (error instanceof IngestionValidationError) throw error;
+      throw new IngestionValidationError(
+        "query",
+        "Query request failed; check endpoint availability, network access, and token validity."
+      );
+    }
+    const trace = result.columns.indexOf("traceId");
+    const span = result.columns.indexOf("spanId");
+    const parent = result.columns.indexOf("parentSpanId");
+    const root = result.rows.find((row) => row[span] === rootId);
+    const child = result.rows.find((row) => row[span] === childId);
+    if (root && child) {
+      notify("ingestion", "Both validation spans are present in Eventhouse.");
+      if (root[trace] !== traceId || child[trace] !== traceId || child[parent] !== rootId)
+        throw new IngestionValidationError(
+          "correlation",
+          "Rows were ingested, but trace or parent-child identifiers do not match; verify the JSON mapping."
+        );
+      notify(
+        "correlation",
+        "Trace and parent-child identifiers are preserved."
+      );
+      return;
+    }
+    const remaining = deadline - now();
+    if (remaining > 0) await wait(Math.min(poll, remaining));
+  }
+  throw new IngestionValidationError(
+    "ingestion",
+    "Producer acknowledged both spans, but ingestion timed out; check Eventstream routing, table/mapping, and capacity."
+  );
+}
+async function runValidationCli(args, environment = process.env, dependencies = {}, output = {
+  info: console.log,
+  error: console.error
+}) {
+  if (args.length === 1 && args[0] === "--help") {
+    output.info(
+      "Validate Fabric producer acknowledgement, Eventhouse ingestion, and trace correlation.\nRunning validation writes two metadata-only spans, not AI requests. --help performs no network I/O.\nSet FABRIC_EVENTSTREAM_CONNECTION_STRING, FABRIC_KQL_QUERY_ENDPOINT, FABRIC_KQL_DATABASE,\nand FABRIC_KQL_ACCESS_TOKEN in the environment. Optionally set FABRIC_EVENTSTREAM_ENTITY_NAME\nand FABRIC_VALIDATION_TIMEOUT_MS (default 180000, maximum 900000).\nCredentials are never accepted as command-line arguments."
+    );
+    return 0;
+  }
+  try {
+    if (args.length)
+      throw new IngestionValidationError(
+        "configuration",
+        "Only --help is accepted; configure credentials through the environment."
+      );
+    const required = (name) => {
+      const value = environment[name];
+      if (!value?.trim())
+        throw new IngestionValidationError("configuration", `Missing ${name}.`);
+      return value;
+    };
+    const entityName = environment.FABRIC_EVENTSTREAM_ENTITY_NAME;
+    const timeout = environment.FABRIC_VALIDATION_TIMEOUT_MS;
+    await validateFabricIngestion(
+      {
+        connectionString: required("FABRIC_EVENTSTREAM_CONNECTION_STRING"),
+        queryEndpoint: required("FABRIC_KQL_QUERY_ENDPOINT"),
+        database: required("FABRIC_KQL_DATABASE"),
+        accessToken: required("FABRIC_KQL_ACCESS_TOKEN"),
+        ...entityName ? { entityName } : {},
+        ...timeout !== void 0 ? { timeoutMs: Number(timeout) } : {},
+        onProgress: (stage, message) => output.info(`[${stage}] ${message}`)
+      },
+      dependencies
+    );
+    output.info("Fabric ingestion validation passed.");
+    return 0;
+  } catch (error) {
+    output.error(
+      error instanceof IngestionValidationError ? `[${error.stage}] ${error.message}` : "Validation failed; check producer/query configuration and network access."
+    );
+    return 1;
+  }
+}
+
+// src/validate.ts
+process.exitCode = await runValidationCli(process.argv.slice(2));
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/validation/fabric.ts","../src/validate.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { setTimeout as sleep } from \"node:timers/promises\";\nimport {\n  createObservability,\n  type EventhouseObservabilityOptions,\n} from \"../index.js\";\nimport type { Observability } from \"../engine.js\";\n\ntype Stage =\n  \"configuration\" | \"producer\" | \"ingestion\" | \"correlation\" | \"query\";\n\nexport class IngestionValidationError extends Error {\n  constructor(\n    readonly stage: Stage,\n    message: string,\n  ) {\n    super(message);\n    this.name = \"IngestionValidationError\";\n  }\n}\n\nexport interface IngestionValidationOptions {\n  connectionString: string;\n  entityName?: string;\n  queryEndpoint: string;\n  database: string;\n  accessToken: string;\n  timeoutMs?: number;\n  pollIntervalMs?: number;\n  onProgress?: (stage: Stage, message: string) => void;\n}\n\ninterface Dependencies {\n  createObserver?: (options: EventhouseObservabilityOptions) => Observability;\n  fetch?: typeof fetch;\n  now?: () => number;\n  sleep?: (milliseconds: number) => Promise<void>;\n}\n\nfunction interval(value: number, name: string, maximum: number): number {\n  if (!Number.isSafeInteger(value) || value < 1 || value > maximum)\n    throw new IngestionValidationError(\n      \"configuration\",\n      `${name} must be a positive integer no greater than ${maximum}.`,\n    );\n  return value;\n}\n\nfunction rows(value: unknown): { columns: string[]; rows: unknown[][] } {\n  const tables = (value as { Tables?: unknown } | null)?.Tables;\n  if (Array.isArray(tables)) {\n    for (const table of tables) {\n      if (table === null || typeof table !== \"object\") continue;\n      const data = table as { Columns?: unknown; Rows?: unknown };\n      if (!Array.isArray(data.Columns) || !Array.isArray(data.Rows)) continue;\n      const columns = data.Columns.map((column: { ColumnName?: unknown }) =>\n        typeof column?.ColumnName === \"string\" ? column.ColumnName : \"\",\n      );\n      if (\n        [\"traceId\", \"spanId\", \"parentSpanId\"].every((name) =>\n          columns.includes(name),\n        )\n      ) {\n        if (data.Rows.every(Array.isArray))\n          return { columns, rows: data.Rows as unknown[][] };\n      }\n    }\n  }\n  throw new IngestionValidationError(\n    \"query\",\n    \"Unexpected query response; verify the Eventhouse query endpoint and trace schema.\",\n  );\n}\n\nexport async function validateFabricIngestion(\n  options: IngestionValidationOptions,\n  dependencies: Dependencies = {},\n): Promise<void> {\n  let endpoint: URL;\n  try {\n    endpoint = new URL(options.queryEndpoint);\n    if (\n      endpoint.protocol !== \"https:\" ||\n      endpoint.username ||\n      endpoint.password ||\n      endpoint.search ||\n      endpoint.hash\n    )\n      throw new Error();\n  } catch {\n    throw new IngestionValidationError(\n      \"configuration\",\n      \"FABRIC_KQL_QUERY_ENDPOINT must be a credential-free HTTPS query URI.\",\n    );\n  }\n  if (\n    !options.connectionString.trim() ||\n    !options.database.trim() ||\n    !options.accessToken.trim() ||\n    /[\\r\\n\\0]/u.test(options.accessToken)\n  )\n    throw new IngestionValidationError(\n      \"configuration\",\n      \"Supply producer credentials, a database name, and a valid query access token through the environment.\",\n    );\n  const timeout = interval(options.timeoutMs ?? 180000, \"timeoutMs\", 900000);\n  const poll = interval(\n    options.pollIntervalMs ?? 5000,\n    \"pollIntervalMs\",\n    60000,\n  );\n  const now = dependencies.now ?? Date.now;\n  const wait = dependencies.sleep ?? sleep;\n  const send = dependencies.fetch ?? fetch;\n  const notify = (stage: Stage, message: string) => {\n    try {\n      void Promise.resolve(options.onProgress?.(stage, message)).catch(\n        () => {},\n      );\n    } catch {}\n  };\n  const runId = `validation-${randomUUID()}`;\n  let rootId = \"\";\n  let childId = \"\";\n  let traceId = \"\";\n  let observer: Observability | undefined;\n  let producerFailed = false;\n  notify(\"producer\", \"Sending two metadata-only validation spans.\");\n  try {\n    observer = (dependencies.createObserver ?? createObservability)({\n      connectionString: options.connectionString,\n      ...(options.entityName ? { entityName: options.entityName } : {}),\n      serviceName: \"eventhouse-ingestion-validation\",\n      environment: \"validation\",\n      captureContent: false,\n      samplingRatio: 1,\n      exportTimeoutMs: Math.min(timeout, 15000),\n      shutdownTimeoutMs: Math.min(timeout, 15000),\n    });\n    const attributes = { \"validation.run.id\": runId };\n    const root = observer.startSpan(\"validation.root\", { attributes });\n    const child = observer.startSpan(\"invoke_agent validation\", {\n      parent: root,\n      attributes: { ...attributes, \"gen_ai.operation.name\": \"invoke_agent\" },\n    });\n    rootId = root.spanContext().spanId;\n    childId = child.spanContext().spanId;\n    traceId = root.spanContext().traceId;\n    child.end();\n    root.end();\n  } catch {\n    producerFailed = true;\n  } finally {\n    try {\n      await observer?.shutdown();\n    } catch {\n      producerFailed = true;\n    }\n  }\n  const diagnostics = observer?.getDiagnostics();\n  if (\n    producerFailed ||\n    diagnostics?.eventsExported !== 2 ||\n    diagnostics.eventsDropped !== 0 ||\n    diagnostics.exportFailures !== 0\n  )\n    throw new IngestionValidationError(\n      \"producer\",\n      \"Producer acknowledgement failed; check source Send credentials, entity name, and network access.\",\n    );\n  notify(\n    \"producer\",\n    \"Both spans acknowledged. This does not yet prove Eventhouse ingestion.\",\n  );\n  notify(\"ingestion\", \"Waiting for matching Eventhouse rows.\");\n  const deadline = now() + timeout;\n  while (now() < deadline) {\n    let response: Response;\n    let result: ReturnType<typeof rows>;\n    try {\n      response = await send(new URL(\"/v1/rest/query\", endpoint), {\n        method: \"POST\",\n        headers: {\n          authorization: `Bearer ${options.accessToken}`,\n          \"content-type\": \"application/json\",\n        },\n        body: JSON.stringify({\n          db: options.database,\n          csl: `AIObservabilityTraces | where tostring(spanAttributes[\"validation.run.id\"]) == \"${runId}\" | summarize arg_max(timestamp, *) by traceId, spanId | project traceId, spanId, parentSpanId | take 3`,\n        }),\n        signal: AbortSignal.timeout(\n          Math.max(1, Math.min(15000, deadline - now())),\n        ),\n      });\n      if (!response.ok) {\n        const message =\n          response.status === 401 || response.status === 403\n            ? \"Query authorization failed; check the separate Kusto query token and database permissions.\"\n            : `Query failed with HTTP ${response.status}; check the query endpoint, database schema, and capacity.`;\n        throw new IngestionValidationError(\"query\", message);\n      }\n      result = rows(await response.json());\n    } catch (error) {\n      if (error instanceof IngestionValidationError) throw error;\n      throw new IngestionValidationError(\n        \"query\",\n        \"Query request failed; check endpoint availability, network access, and token validity.\",\n      );\n    }\n    const trace = result.columns.indexOf(\"traceId\");\n    const span = result.columns.indexOf(\"spanId\");\n    const parent = result.columns.indexOf(\"parentSpanId\");\n    const root = result.rows.find((row) => row[span] === rootId);\n    const child = result.rows.find((row) => row[span] === childId);\n    if (root && child) {\n      notify(\"ingestion\", \"Both validation spans are present in Eventhouse.\");\n      if (\n        root[trace] !== traceId ||\n        child[trace] !== traceId ||\n        child[parent] !== rootId\n      )\n        throw new IngestionValidationError(\n          \"correlation\",\n          \"Rows were ingested, but trace or parent-child identifiers do not match; verify the JSON mapping.\",\n        );\n      notify(\n        \"correlation\",\n        \"Trace and parent-child identifiers are preserved.\",\n      );\n      return;\n    }\n    const remaining = deadline - now();\n    if (remaining > 0) await wait(Math.min(poll, remaining));\n  }\n  throw new IngestionValidationError(\n    \"ingestion\",\n    \"Producer acknowledged both spans, but ingestion timed out; check Eventstream routing, table/mapping, and capacity.\",\n  );\n}\n\nexport async function runValidationCli(\n  args: string[],\n  environment: NodeJS.ProcessEnv = process.env,\n  dependencies: Dependencies = {},\n  output: {\n    info: (message: string) => void;\n    error: (message: string) => void;\n  } = {\n    info: console.log,\n    error: console.error,\n  },\n): Promise<number> {\n  if (args.length === 1 && args[0] === \"--help\") {\n    output.info(\n      \"Validate Fabric producer acknowledgement, Eventhouse ingestion, and trace correlation.\\n\" +\n        \"Running validation writes two metadata-only spans, not AI requests. --help performs no network I/O.\\n\" +\n        \"Set FABRIC_EVENTSTREAM_CONNECTION_STRING, FABRIC_KQL_QUERY_ENDPOINT, FABRIC_KQL_DATABASE,\\n\" +\n        \"and FABRIC_KQL_ACCESS_TOKEN in the environment. Optionally set FABRIC_EVENTSTREAM_ENTITY_NAME\\n\" +\n        \"and FABRIC_VALIDATION_TIMEOUT_MS (default 180000, maximum 900000).\\n\" +\n        \"Credentials are never accepted as command-line arguments.\",\n    );\n    return 0;\n  }\n  try {\n    if (args.length)\n      throw new IngestionValidationError(\n        \"configuration\",\n        \"Only --help is accepted; configure credentials through the environment.\",\n      );\n    const required = (name: string) => {\n      const value = environment[name];\n      if (!value?.trim())\n        throw new IngestionValidationError(\"configuration\", `Missing ${name}.`);\n      return value;\n    };\n    const entityName = environment.FABRIC_EVENTSTREAM_ENTITY_NAME;\n    const timeout = environment.FABRIC_VALIDATION_TIMEOUT_MS;\n    await validateFabricIngestion(\n      {\n        connectionString: required(\"FABRIC_EVENTSTREAM_CONNECTION_STRING\"),\n        queryEndpoint: required(\"FABRIC_KQL_QUERY_ENDPOINT\"),\n        database: required(\"FABRIC_KQL_DATABASE\"),\n        accessToken: required(\"FABRIC_KQL_ACCESS_TOKEN\"),\n        ...(entityName ? { entityName } : {}),\n        ...(timeout !== undefined ? { timeoutMs: Number(timeout) } : {}),\n        onProgress: (stage, message) => output.info(`[${stage}] ${message}`),\n      },\n      dependencies,\n    );\n    output.info(\"Fabric ingestion validation passed.\");\n    return 0;\n  } catch (error) {\n    output.error(\n      error instanceof IngestionValidationError\n        ? `[${error.stage}] ${error.message}`\n        : \"Validation failed; check producer/query configuration and network access.\",\n    );\n    return 1;\n  }\n}\n","#!/usr/bin/env node\nimport { runValidationCli } from \"./validation/fabric.js\";\n\nprocess.exitCode = await runValidationCli(process.argv.slice(2));\n"],"mappings":"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","names":[]}

package/dist/validation/fabric.d.ts

@@ -0,0 +1,29 @@
+import { type EventhouseObservabilityOptions } from "../index.js";
+import type { Observability } from "../engine.js";
+type Stage = "configuration" | "producer" | "ingestion" | "correlation" | "query";
+export declare class IngestionValidationError extends Error {
+    readonly stage: Stage;
+    constructor(stage: Stage, message: string);
+}
+export interface IngestionValidationOptions {
+    connectionString: string;
+    entityName?: string;
+    queryEndpoint: string;
+    database: string;
+    accessToken: string;
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    onProgress?: (stage: Stage, message: string) => void;
+}
+interface Dependencies {
+    createObserver?: (options: EventhouseObservabilityOptions) => Observability;
+    fetch?: typeof fetch;
+    now?: () => number;
+    sleep?: (milliseconds: number) => Promise<void>;
+}
+export declare function validateFabricIngestion(options: IngestionValidationOptions, dependencies?: Dependencies): Promise<void>;
+export declare function runValidationCli(args: string[], environment?: NodeJS.ProcessEnv, dependencies?: Dependencies, output?: {
+    info: (message: string) => void;
+    error: (message: string) => void;
+}): Promise<number>;
+export {};

package/dist/vercel.d.ts

@@ -0,0 +1,15 @@
+import { type VercelAdapterOptions } from "./adapters/vercel.js";
+import { type EventhouseObservabilityOptions } from "./index.js";
+import type { Observability } from "./engine.js";
+export type { VercelAdapterOptions, VercelTelemetrySettings, } from "./adapters/vercel.js";
+export type VercelObservabilityOptions = VercelAdapterOptions & ((EventhouseObservabilityOptions & {
+    engine?: never;
+}) | {
+    engine: Observability;
+});
+export declare function observeVercelAI(options: VercelObservabilityOptions): {
+    telemetry: import("./adapters/vercel.js").VercelTelemetrySettings;
+    flush: () => Promise<void>;
+    getDiagnostics: () => Readonly<import("./engine.js").Diagnostics>;
+    shutdown(): Promise<void>;
+};