react-semaphor 0.1.335 → 0.1.337

package/dist/chunks/{validators-BuaRUBQI.js → validators-BOqiGymD.js}

@@ -1,7 +1,7 @@
 function s(e, i, n) {
   return n ? { code: e, message: i, path: n } : { code: e, message: i };
 }
-function h(e) {
+function y(e) {
   const i = /* @__PURE__ */ new Set();
   for (const n of e) {
     if (i.has(n))
@@ -13,10 +13,10 @@ function h(e) {
 function a(e) {
   return typeof e == "string" && e.trim().length > 0;
 }
-function f(e) {
+function p(e) {
   return !!(e && typeof e == "object" && !Array.isArray(e));
 }
-function _(e, i, n, t = {}) {
+function h(e, i, n, o = {}) {
   if (!e || typeof e != "object") {
     n.push(s("missing_source", "Analytics intent needs a source.", i));
     return;
@@ -60,28 +60,28 @@ function _(e, i, n, t = {}) {
         "SQL source needs a connectionId.",
         `${i}.connectionId`
       )
-    ), t.requireSqlText !== !1 && !a(e.sql) && n.push(s("missing_sql", "SQL source needs SQL text.", `${i}.sql`));
+    ), o.requireSqlText !== !1 && !a(e.sql) && n.push(s("missing_sql", "SQL source needs SQL text.", `${i}.sql`));
     return;
   }
   n.push(s("invalid_source_kind", "Source kind is not supported.", i));
 }
-function m(e, i, n, t = {}) {
-  if (!e || !f(e)) {
-    t.required && n.push(
+function m(e, i, n, o = {}) {
+  if (!e || !p(e)) {
+    o.required && n.push(
       s("missing_field_ref", "Field reference needs a name.", i)
     );
     return;
   }
   a(e.name) || n.push(
     s("missing_field_ref", "Field reference needs a name.", `${i}.name`)
-  ), e.source !== void 0 && _(e.source, `${i}.source`, n, {
+  ), e.source !== void 0 && h(e.source, `${i}.source`, n, {
     requireSqlText: !1
   });
 }
 function k(e, i) {
   if (e.analysis === void 0)
     return;
-  if (!f(e.analysis)) {
+  if (!p(e.analysis)) {
     i.push(
       s(
         "invalid_metric_analysis",
@@ -115,140 +115,239 @@ function k(e, i) {
     )
   );
   const { timeWindow: n } = e.analysis;
-  if (n !== void 0) {
-    if (!f(n)) {
-      i.push(
+  n !== void 0 && b(n, "analysis.timeWindow", i);
+}
+function b(e, i, n) {
+  if (!p(e)) {
+    n.push(
+      s(
+        "invalid_time_window",
+        "Time window must be a structured object.",
+        i
+      )
+    );
+    return;
+  }
+  e.unit !== "second" && e.unit !== "minute" && e.unit !== "hour" && e.unit !== "day" && e.unit !== "week" && e.unit !== "month" && e.unit !== "quarter" && e.unit !== "year" && n.push(
+    s(
+      "invalid_time_window",
+      "Time window unit must be second, minute, hour, day, week, month, quarter, or year.",
+      `${i}.unit`
+    )
+  ), (typeof e.value != "number" || !Number.isFinite(e.value) || e.value <= 0) && n.push(
+    s(
+      "invalid_time_window",
+      "Time window value must be a positive number.",
+      `${i}.value`
+    )
+  ), e.anchor !== void 0 && e.anchor !== "now" && e.anchor !== "latest_available" && n.push(
+    s(
+      "invalid_time_window",
+      "Time window anchor must be now or latest_available.",
+      `${i}.anchor`
+    )
+  );
+}
+function q(e, i, n) {
+  if (e !== void 0) {
+    if (!Array.isArray(e)) {
+      n.push(
         s(
-          "invalid_time_window",
-          "Analysis timeWindow must be a structured object.",
-          "analysis.timeWindow"
+          "invalid_analytics_filters",
+          "Analytics filters must be an array.",
+          i
         )
       );
       return;
     }
-    n.unit !== "day" && n.unit !== "month" && i.push(
+    e.forEach((o, f) => {
+      const d = `${i}.${f}`;
+      if (!p(o)) {
+        n.push(
+          s(
+            "invalid_analytics_filter",
+            "Analytics filter must be a structured object.",
+            d
+          )
+        );
+        return;
+      }
+      const r = o;
+      m(r.field, `${d}.field`, n, {
+        required: !0
+      }), r.operator !== void 0 && r.operator !== "=" && r.operator !== "!=" && r.operator !== "in" && r.operator !== "not_in" && r.operator !== "contains" && r.operator !== "not_contains" && r.operator !== "between" && r.operator !== "not_between" && r.operator !== ">" && r.operator !== ">=" && r.operator !== "<" && r.operator !== "<=" && r.operator !== "is_null" && r.operator !== "is_not_null" && n.push(
+        s(
+          "invalid_analytics_filter_operator",
+          "Analytics filter operator is not supported.",
+          `${d}.operator`
+        )
+      ), r.value === void 0 && r.values === void 0 && r.operator !== "is_null" && r.operator !== "is_not_null" && n.push(
+        s(
+          "missing_analytics_filter_value",
+          "Analytics filter needs value or values unless it is a null check.",
+          d
+        )
+      ), r.values !== void 0 && !Array.isArray(r.values) && n.push(
+        s(
+          "invalid_analytics_filter_values",
+          "Analytics filter values must be an array when provided.",
+          `${d}.values`
+        )
+      );
+    });
+  }
+}
+function g(e) {
+  var o, f, d, r;
+  const i = [], n = [];
+  if (!e || typeof e != "object")
+    return {
+      ok: !1,
+      errors: [
+        s(
+          "invalid_analytics_intent",
+          "Analytics intent must be a structured object."
+        )
+      ],
+      warnings: n,
+      repairHints: [
+        {
+          code: "invalid_analytics_intent",
+          recommendedNextStep: "Send one structured analytics intent object with kind, source, and required fields."
+        }
+      ]
+    };
+  if (e.version !== void 0 && e.version !== 1 && i.push(
+    s("invalid_version", "Analytics intent version must be 1.", "version")
+  ), h(e.source, "source", i, {
+    requireSqlText: e.kind !== "sql" || !a(e.sql)
+  }), e.kind === "metric") {
+    const u = Array.isArray(e.metrics) ? e.metrics.filter(a) : [];
+    if (!Array.isArray(e.metrics) || e.metrics.length === 0 ? i.push(
+      s("missing_metric", "Metric intent needs at least one metric.", "metrics")
+    ) : e.metrics.some((t) => !a(t)) && i.push(
+      s(
+        "invalid_metric_list",
+        "Metric intent metrics must be an array of non-empty metric names.",
+        "metrics"
+      )
+    ), u.length > 0) {
+      const t = y(u);
+      t && i.push(
+        s(
+          "duplicate_metric",
+          `Metric intent has duplicate metric "${t}".`,
+          "metrics"
+        )
+      );
+    }
+    if (e.primaryMetric !== void 0 && (!a(e.primaryMetric) || u.length > 0 && !u.includes(e.primaryMetric)) && i.push(
       s(
-        "invalid_time_window",
-        "Analysis timeWindow unit must be day or month.",
-        "analysis.timeWindow.unit"
+        "invalid_primary_metric",
+        "Metric intent primaryMetric must be one of metrics.",
+        "primaryMetric"
       )
-    ), (typeof n.value != "number" || !Number.isFinite(n.value) || n.value <= 0) && i.push(
+    ), e.metricRefs !== void 0 && !Array.isArray(e.metricRefs))
+      i.push(
+        s(
+          "invalid_metric_refs",
+          "Metric intent metricRefs must be an array of field references.",
+          "metricRefs"
+        )
+      );
+    else if (Array.isArray(e.metricRefs)) {
+      e.metricRefs.forEach((c, _) => {
+        m(c, `metricRefs.${_}`, i, {
+          required: !0
+        });
+      });
+      const t = e.metricRefs.filter(
+        (c) => p(c) && a(c.name)
+      ).map((c) => c.name);
+      (u.length > 0 ? t.filter(
+        (c) => !u.includes(c)
+      ) : []).length > 0 && i.push(
+        s(
+          "invalid_metric_refs",
+          "Metric intent metricRefs must reference names included in metrics.",
+          "metricRefs"
+        )
+      );
+    }
+    e.dimensions !== void 0 && !Array.isArray(e.dimensions) ? i.push(
       s(
-        "invalid_time_window",
-        "Analysis timeWindow value must be a positive number.",
-        "analysis.timeWindow.value"
+        "invalid_metric_dimensions",
+        "Metric intent dimensions must be an array of field references.",
+        "dimensions"
       )
-    ), n.anchor !== void 0 && n.anchor !== "now" && n.anchor !== "latest_available" && i.push(
+    ) : Array.isArray(e.dimensions) && e.dimensions.some(
+      (t) => !p(t) || !a(t.name)
+    ) && i.push(
       s(
-        "invalid_time_window",
-        "Analysis timeWindow anchor must be now or latest_available.",
-        "analysis.timeWindow.anchor"
+        "invalid_metric_dimensions",
+        "Metric intent dimensions must be an array of field references with names.",
+        "dimensions"
       )
-    );
-  }
-}
-function v(e) {
-  var t, c, d, p;
-  const i = [], n = [];
-  return !e || typeof e != "object" ? {
-    ok: !1,
-    errors: [
+    ), e.dateField !== void 0 && m(e.dateField, "dateField", i), e.timeWindow !== void 0 && (b(e.timeWindow, "timeWindow", i), e.dateField || i.push(
       s(
-        "invalid_analytics_intent",
-        "Analytics intent must be a structured object."
+        "missing_time_window_date_field",
+        "Metric timeWindow needs a dateField.",
+        "dateField"
       )
-    ],
-    warnings: n,
-    repairHints: [
-      {
-        code: "invalid_analytics_intent",
-        recommendedNextStep: "Send one structured analytics intent object with kind, source, and required fields."
-      }
-    ]
-  } : (e.version !== void 0 && e.version !== 1 && i.push(
-    s("invalid_version", "Analytics intent version must be 1.", "version")
-  ), _(e.source, "source", i, {
-    requireSqlText: e.kind !== "sql" || !a(e.sql)
-  }), e.kind === "metric" ? (a(e.metric) || i.push(
-    s("missing_metric", "Metric intent needs a metric.", "metric")
-  ), e.metrics !== void 0 && !Array.isArray(e.metrics) ? i.push(
-    s(
-      "invalid_metric_list",
-      "Metric intent metrics must be an array of metric names.",
-      "metrics"
-    )
-  ) : Array.isArray(e.metrics) && e.metrics.some((l) => !a(l)) && i.push(
-    s(
-      "invalid_metric_list",
-      "Metric intent metrics must be an array of non-empty metric names.",
-      "metrics"
-    )
-  ), e.dimensions !== void 0 && !Array.isArray(e.dimensions) ? i.push(
-    s(
-      "invalid_metric_dimensions",
-      "Metric intent dimensions must be an array of field references.",
-      "dimensions"
-    )
-  ) : Array.isArray(e.dimensions) && e.dimensions.some(
-    (l) => !f(l) || !a(l.name)
-  ) && i.push(
-    s(
-      "invalid_metric_dimensions",
-      "Metric intent dimensions must be an array of field references with names.",
-      "dimensions"
-    )
-  ), e.dateField !== void 0 && m(e.dateField, "dateField", i), Array.isArray(e.dimensions) && e.dimensions.forEach((l, r) => {
-    m(l, `dimensions.${r}`, i);
-  }), k(e, i)) : e.kind === "records" ? (!Array.isArray(e.fields) || e.fields.length === 0 ? i.push(
+    )), q(e.filters, "filters", i), Array.isArray(e.dimensions) && e.dimensions.forEach((t, l) => {
+      m(t, `dimensions.${l}`, i);
+    }), k(e, i);
+  } else e.kind === "records" ? (!Array.isArray(e.fields) || e.fields.length === 0 ? i.push(
     s(
       "missing_record_fields",
       "Records intent needs at least one field.",
       "fields"
     )
   ) : e.fields.some(
-    (l) => !f(l) || !a(l.name)
+    (u) => !p(u) || !a(u.name)
   ) && i.push(
     s(
       "invalid_record_fields",
       "Records intent fields must be field references with names.",
       "fields"
     )
-  ), Array.isArray(e.fields) && e.fields.forEach((l, r) => {
-    m(l, `fields.${r}`, i);
+  ), Array.isArray(e.fields) && e.fields.forEach((u, t) => {
+    m(u, `fields.${t}`, i);
   }), e.dateField !== void 0 && m(e.dateField, "dateField", i)) : e.kind === "inputOptions" ? ((!e.field || !a(e.field.name)) && i.push(
     s(
       "missing_input_options_field",
       "Input options intent needs a field.",
       "field"
     )
-  ), m(e.field, "field", i, { required: !0 })) : e.kind === "sql" ? (((t = e.source) == null ? void 0 : t.kind) !== "sql" && ((c = e.source) == null ? void 0 : c.kind) !== "physical" && i.push(
+  ), m(e.field, "field", i, { required: !0 })) : e.kind === "sql" ? (((o = e.source) == null ? void 0 : o.kind) !== "sql" && ((f = e.source) == null ? void 0 : f.kind) !== "physical" && i.push(
     s(
       "invalid_sql_source",
       "SQL analytics intent must use a SQL or physical source.",
       "source"
     )
-  ), a(e.sql) && ((d = e.source) == null ? void 0 : d.kind) === "sql" && a(e.source.sql) && y(e.sql) !== y(e.source.sql) && i.push(
+  ), a(e.sql) && ((d = e.source) == null ? void 0 : d.kind) === "sql" && a(e.source.sql) && v(e.sql) !== v(e.source.sql) && i.push(
     s(
       "conflicting_sql",
       "SQL analytics intent cannot define different SQL text in source.sql and sql.",
       "sql"
     )
-  ), !a(e.sql) && !(((p = e.source) == null ? void 0 : p.kind) === "sql" && a(e.source.sql)) && i.push(s("missing_sql", "SQL analytics intent needs SQL text.", "sql")), Array.isArray(e.fields) && e.fields.forEach((l, r) => {
-    m(l, `fields.${r}`, i);
+  ), !a(e.sql) && !(((r = e.source) == null ? void 0 : r.kind) === "sql" && a(e.source.sql)) && i.push(s("missing_sql", "SQL analytics intent needs SQL text.", "sql")), Array.isArray(e.fields) && e.fields.forEach((u, t) => {
+    m(u, `fields.${t}`, i);
   })) : i.push(
     s("invalid_analytics_kind", "Analytics kind is not supported.", "kind")
-  ), {
+  );
+  return {
     ok: i.length === 0,
     errors: i,
     warnings: n,
-    repairHints: q(i)
-  });
+    repairHints: S(i)
+  };
 }
-function y(e) {
+function v(e) {
   return e.replace(/\r\n/g, `
 `).trim();
 }
-function A(e) {
+function $(e) {
   const i = [], n = [];
   if (!e || typeof e != "object")
     return {
@@ -276,18 +375,18 @@ function A(e) {
         "Answer-obligations operation intent needs at least one obligation.",
         "obligations"
       )
-    ) : e.obligations.forEach((t, c) => {
-      a(t.id) || i.push(
+    ) : e.obligations.forEach((o, f) => {
+      a(o.id) || i.push(
         s(
           "missing_obligation_id",
           "Each analytics obligation needs an id.",
-          `obligations.${c}.id`
+          `obligations.${f}.id`
         )
-      ), a(t.prompt) || i.push(
+      ), a(o.prompt) || i.push(
         s(
           "missing_obligation_prompt",
           "Each analytics obligation needs a prompt.",
-          `obligations.${c}.prompt`
+          `obligations.${f}.prompt`
         )
       );
     });
@@ -299,10 +398,10 @@ function A(e) {
         "instruction"
       )
     ), e.analyticsIntent) {
-      const t = v(
+      const o = g(
         e.analyticsIntent
       );
-      i.push(...t.errors), n.push(...t.warnings);
+      i.push(...o.errors), n.push(...o.warnings);
     }
   } else
     i.push(
@@ -316,10 +415,10 @@ function A(e) {
     ok: i.length === 0,
     errors: i,
     warnings: n,
-    repairHints: b(i)
+    repairHints: w(i)
   };
 }
-function x(e) {
+function R(e) {
   const i = [], n = [];
   if (!e || typeof e != "object")
     return {
@@ -347,8 +446,8 @@ function x(e) {
       "kind"
     )
   );
-  const t = A(e.operationIntent);
-  return i.push(...t.errors), n.push(...t.warnings), Array.isArray(e.plannedToolCalls) || i.push(
+  const o = $(e.operationIntent);
+  return i.push(...o.errors), n.push(...o.warnings), Array.isArray(e.plannedToolCalls) || i.push(
     s(
       "invalid_planned_tool_calls",
       "Recovery plan plannedToolCalls must be an array.",
@@ -358,16 +457,16 @@ function x(e) {
     ok: i.length === 0,
     errors: i,
     warnings: n,
-    repairHints: b(i)
+    repairHints: w(i)
   };
 }
-function b(e) {
+function w(e) {
   return e.map((i) => ({
     code: i.code,
     recommendedNextStep: i.code === "missing_obligations" ? "Normalize the user request into one or more typed analytics obligations before recovery planning." : "Correct the operation/recovery contract shape before planning execution."
   }));
 }
-function q(e) {
+function S(e) {
   return e.map((i) => {
     switch (i.code) {
       case "missing_source":
@@ -420,7 +519,7 @@ function q(e) {
     }
   }).filter((i) => !!i);
 }
-function S(e, i, n, t) {
+function x(e, i, n, o) {
   if (!e || typeof e != "object") {
     n.push(s("invalid_view", "Dashboard view must be an object.", i));
     return;
@@ -436,7 +535,7 @@ function S(e, i, n, t) {
     return;
   }
   if (e.presentation.kind === "text") {
-    a(e.text) || t.push(
+    a(e.text) || o.push(
       s(
         "missing_text_content",
         "Text views should include text content.",
@@ -455,13 +554,13 @@ function S(e, i, n, t) {
     );
     return;
   }
-  const c = v(e.analytics);
-  for (const d of c.errors)
+  const f = g(e.analytics);
+  for (const d of f.errors)
     n.push(
       s(d.code, d.message, `${i}.analytics${d.path ? `.${d.path}` : ""}`)
     );
-  for (const d of c.warnings)
-    t.push(
+  for (const d of f.warnings)
+    o.push(
       s(
         d.code,
         d.message,
@@ -469,7 +568,7 @@ function S(e, i, n, t) {
       )
     );
 }
-function $(e) {
+function I(e) {
   const i = [], n = [];
   if (!e || typeof e != "object")
     return {
@@ -483,27 +582,27 @@ function $(e) {
       warnings: n
     };
   e.version !== 1 && i.push(s("invalid_version", "Dashboard intent version must be 1.")), e.kind !== "dashboard" && i.push(s("invalid_kind", "Experience intent kind must be dashboard.")), a(e.title) || i.push(s("missing_title", "Dashboard intent needs a title.", "title"));
-  const t = Array.isArray(e.inputs) ? e.inputs : [], c = h(
-    t.filter(f).map((r) => r.id).filter((r) => typeof r == "string")
+  const o = Array.isArray(e.inputs) ? e.inputs : [], f = y(
+    o.filter(p).map((t) => t.id).filter((t) => typeof t == "string")
   );
-  c && i.push(
+  f && i.push(
     s(
       "duplicate_input_id",
-      `Duplicate input id: ${c}.`,
+      `Duplicate input id: ${f}.`,
       "inputs"
     )
   );
-  for (const [r, o] of t.entries()) {
-    const u = `inputs.${r}`;
-    if (!f(o)) {
-      i.push(s("invalid_input", "Dashboard input must be an object.", u));
+  for (const [t, l] of o.entries()) {
+    const c = `inputs.${t}`;
+    if (!p(l)) {
+      i.push(s("invalid_input", "Dashboard input must be an object.", c));
       continue;
     }
-    a(o.id) || i.push(s("missing_input_id", "Input needs an id.", `${u}.id`)), a(o.label) || i.push(
-      s("missing_input_label", "Input needs a label.", `${u}.label`)
-    ), !o.field || !a(o.field.name) ? i.push(
-      s("missing_input_field", "Input needs a field.", `${u}.field`)
-    ) : m(o.field, `${u}.field`, i), o.source && _(o.source, `${u}.source`, i);
+    a(l.id) || i.push(s("missing_input_id", "Input needs an id.", `${c}.id`)), a(l.label) || i.push(
+      s("missing_input_label", "Input needs a label.", `${c}.label`)
+    ), !l.field || !a(l.field.name) ? i.push(
+      s("missing_input_field", "Input needs a field.", `${c}.field`)
+    ) : m(l.field, `${c}.field`, i), l.source && h(l.source, `${c}.source`, i);
   }
   const d = Array.isArray(e.sections) ? e.sections : [];
   d.length === 0 && i.push(
@@ -513,40 +612,40 @@ function $(e) {
       "sections"
     )
   );
-  const p = d.flatMap(
-    (r) => r && typeof r == "object" && Array.isArray(r.views) ? r.views.filter(f).map((o) => o.id).filter((o) => !!o) : []
-  ), l = h(p);
-  l && i.push(
+  const r = d.flatMap(
+    (t) => t && typeof t == "object" && Array.isArray(t.views) ? t.views.filter(p).map((l) => l.id).filter((l) => !!l) : []
+  ), u = y(r);
+  u && i.push(
     s(
       "duplicate_view_id",
-      `Duplicate dashboard view id: ${l}.`,
+      `Duplicate dashboard view id: ${u}.`,
       "sections"
     )
   );
-  for (const [r, o] of d.entries()) {
-    const u = `sections.${r}`;
-    if (!o || typeof o != "object") {
+  for (const [t, l] of d.entries()) {
+    const c = `sections.${t}`;
+    if (!l || typeof l != "object") {
       i.push(
-        s("invalid_section", "Dashboard section must be an object.", u)
+        s("invalid_section", "Dashboard section must be an object.", c)
       );
       continue;
     }
-    if (a(o.title) || i.push(
-      s("missing_section_title", "Dashboard section needs a title.", u)
-    ), !Array.isArray(o.views) || o.views.length === 0) {
+    if (a(l.title) || i.push(
+      s("missing_section_title", "Dashboard section needs a title.", c)
+    ), !Array.isArray(l.views) || l.views.length === 0) {
       i.push(
         s(
           "missing_section_views",
           "Dashboard section needs at least one view.",
-          `${u}.views`
+          `${c}.views`
         )
       );
       continue;
     }
-    for (const [g, w] of o.views.entries())
-      S(
-        w,
-        `${u}.views.${g}`,
+    for (const [_, A] of l.views.entries())
+      x(
+        A,
+        `${c}.views.${_}`,
         i,
         n
       );
@@ -554,8 +653,8 @@ function $(e) {
   return { ok: i.length === 0, errors: i, warnings: n };
 }
 export {
-  A as a,
-  x as b,
-  $ as c,
-  v
+  $ as a,
+  R as b,
+  I as c,
+  g as v
 };

package/dist/chunks/validators-BtFXY3S_.js

@@ -0,0 +1,2 @@
+"use strict";function s(e,i,n){return n?{code:e,message:i,path:n}:{code:e,message:i}}function h(e){const i=new Set;for(const n of e){if(i.has(n))return n;i.add(n)}return null}function a(e){return typeof e=="string"&&e.trim().length>0}function p(e){return!!(e&&typeof e=="object"&&!Array.isArray(e))}function y(e,i,n,o={}){if(!e||typeof e!="object"){n.push(s("missing_source","Analytics intent needs a source.",i));return}if(e.kind==="semantic"){a(e.domainId)||n.push(s("missing_semantic_domain","Semantic source needs a domainId.",`${i}.domainId`)),a(e.datasetName)||n.push(s("missing_dataset_name","Semantic source needs a datasetName.",`${i}.datasetName`));return}if(e.kind==="physical"){a(e.connectionId)||n.push(s("missing_connection_id","Physical source needs a connectionId.",`${i}.connectionId`)),a(e.tableName)||n.push(s("missing_table_name","Physical source needs a tableName.",`${i}.tableName`));return}if(e.kind==="sql"){a(e.connectionId)||n.push(s("missing_connection_id","SQL source needs a connectionId.",`${i}.connectionId`)),o.requireSqlText!==!1&&!a(e.sql)&&n.push(s("missing_sql","SQL source needs SQL text.",`${i}.sql`));return}n.push(s("invalid_source_kind","Source kind is not supported.",i))}function m(e,i,n,o={}){if(!e||!p(e)){o.required&&n.push(s("missing_field_ref","Field reference needs a name.",i));return}a(e.name)||n.push(s("missing_field_ref","Field reference needs a name.",`${i}.name`)),e.source!==void 0&&y(e.source,`${i}.source`,n,{requireSqlText:!1})}function q(e,i){if(e.analysis===void 0)return;if(!p(e.analysis)){i.push(s("invalid_metric_analysis","Metric analysis must be a structured object.","analysis"));return}if(e.analysis.kind!=="period_change"){i.push(s("invalid_metric_analysis","Metric analysis kind is not supported.","analysis.kind"));return}e.dateField||i.push(s("missing_analysis_date_field","Period-change analysis needs a dateField.","dateField")),e.timeGrain||i.push(s("missing_analysis_time_grain","Period-change analysis needs a timeGrain.","timeGrain"));const{timeWindow:n}=e.analysis;n!==void 0&&g(n,"analysis.timeWindow",i)}function g(e,i,n){if(!p(e)){n.push(s("invalid_time_window","Time window must be a structured object.",i));return}e.unit!=="second"&&e.unit!=="minute"&&e.unit!=="hour"&&e.unit!=="day"&&e.unit!=="week"&&e.unit!=="month"&&e.unit!=="quarter"&&e.unit!=="year"&&n.push(s("invalid_time_window","Time window unit must be second, minute, hour, day, week, month, quarter, or year.",`${i}.unit`)),(typeof e.value!="number"||!Number.isFinite(e.value)||e.value<=0)&&n.push(s("invalid_time_window","Time window value must be a positive number.",`${i}.value`)),e.anchor!==void 0&&e.anchor!=="now"&&e.anchor!=="latest_available"&&n.push(s("invalid_time_window","Time window anchor must be now or latest_available.",`${i}.anchor`))}function $(e,i,n){if(e!==void 0){if(!Array.isArray(e)){n.push(s("invalid_analytics_filters","Analytics filters must be an array.",i));return}e.forEach((o,f)=>{const d=`${i}.${f}`;if(!p(o)){n.push(s("invalid_analytics_filter","Analytics filter must be a structured object.",d));return}const r=o;m(r.field,`${d}.field`,n,{required:!0}),r.operator!==void 0&&r.operator!=="="&&r.operator!=="!="&&r.operator!=="in"&&r.operator!=="not_in"&&r.operator!=="contains"&&r.operator!=="not_contains"&&r.operator!=="between"&&r.operator!=="not_between"&&r.operator!==">"&&r.operator!==">="&&r.operator!=="<"&&r.operator!=="<="&&r.operator!=="is_null"&&r.operator!=="is_not_null"&&n.push(s("invalid_analytics_filter_operator","Analytics filter operator is not supported.",`${d}.operator`)),r.value===void 0&&r.values===void 0&&r.operator!=="is_null"&&r.operator!=="is_not_null"&&n.push(s("missing_analytics_filter_value","Analytics filter needs value or values unless it is a null check.",d)),r.values!==void 0&&!Array.isArray(r.values)&&n.push(s("invalid_analytics_filter_values","Analytics filter values must be an array when provided.",`${d}.values`))})}}function v(e){var o,f,d,r;const i=[],n=[];if(!e||typeof e!="object")return{ok:!1,errors:[s("invalid_analytics_intent","Analytics intent must be a structured object.")],warnings:n,repairHints:[{code:"invalid_analytics_intent",recommendedNextStep:"Send one structured analytics intent object with kind, source, and required fields."}]};if(e.version!==void 0&&e.version!==1&&i.push(s("invalid_version","Analytics intent version must be 1.","version")),y(e.source,"source",i,{requireSqlText:e.kind!=="sql"||!a(e.sql)}),e.kind==="metric"){const u=Array.isArray(e.metrics)?e.metrics.filter(a):[];if(!Array.isArray(e.metrics)||e.metrics.length===0?i.push(s("missing_metric","Metric intent needs at least one metric.","metrics")):e.metrics.some(t=>!a(t))&&i.push(s("invalid_metric_list","Metric intent metrics must be an array of non-empty metric names.","metrics")),u.length>0){const t=h(u);t&&i.push(s("duplicate_metric",`Metric intent has duplicate metric "${t}".`,"metrics"))}if(e.primaryMetric!==void 0&&(!a(e.primaryMetric)||u.length>0&&!u.includes(e.primaryMetric))&&i.push(s("invalid_primary_metric","Metric intent primaryMetric must be one of metrics.","primaryMetric")),e.metricRefs!==void 0&&!Array.isArray(e.metricRefs))i.push(s("invalid_metric_refs","Metric intent metricRefs must be an array of field references.","metricRefs"));else if(Array.isArray(e.metricRefs)){e.metricRefs.forEach((c,_)=>{m(c,`metricRefs.${_}`,i,{required:!0})});const t=e.metricRefs.filter(c=>p(c)&&a(c.name)).map(c=>c.name);(u.length>0?t.filter(c=>!u.includes(c)):[]).length>0&&i.push(s("invalid_metric_refs","Metric intent metricRefs must reference names included in metrics.","metricRefs"))}e.dimensions!==void 0&&!Array.isArray(e.dimensions)?i.push(s("invalid_metric_dimensions","Metric intent dimensions must be an array of field references.","dimensions")):Array.isArray(e.dimensions)&&e.dimensions.some(t=>!p(t)||!a(t.name))&&i.push(s("invalid_metric_dimensions","Metric intent dimensions must be an array of field references with names.","dimensions")),e.dateField!==void 0&&m(e.dateField,"dateField",i),e.timeWindow!==void 0&&(g(e.timeWindow,"timeWindow",i),e.dateField||i.push(s("missing_time_window_date_field","Metric timeWindow needs a dateField.","dateField"))),$(e.filters,"filters",i),Array.isArray(e.dimensions)&&e.dimensions.forEach((t,l)=>{m(t,`dimensions.${l}`,i)}),q(e,i)}else e.kind==="records"?(!Array.isArray(e.fields)||e.fields.length===0?i.push(s("missing_record_fields","Records intent needs at least one field.","fields")):e.fields.some(u=>!p(u)||!a(u.name))&&i.push(s("invalid_record_fields","Records intent fields must be field references with names.","fields")),Array.isArray(e.fields)&&e.fields.forEach((u,t)=>{m(u,`fields.${t}`,i)}),e.dateField!==void 0&&m(e.dateField,"dateField",i)):e.kind==="inputOptions"?((!e.field||!a(e.field.name))&&i.push(s("missing_input_options_field","Input options intent needs a field.","field")),m(e.field,"field",i,{required:!0})):e.kind==="sql"?(((o=e.source)==null?void 0:o.kind)!=="sql"&&((f=e.source)==null?void 0:f.kind)!=="physical"&&i.push(s("invalid_sql_source","SQL analytics intent must use a SQL or physical source.","source")),a(e.sql)&&((d=e.source)==null?void 0:d.kind)==="sql"&&a(e.source.sql)&&b(e.sql)!==b(e.source.sql)&&i.push(s("conflicting_sql","SQL analytics intent cannot define different SQL text in source.sql and sql.","sql")),!a(e.sql)&&!(((r=e.source)==null?void 0:r.kind)==="sql"&&a(e.source.sql))&&i.push(s("missing_sql","SQL analytics intent needs SQL text.","sql")),Array.isArray(e.fields)&&e.fields.forEach((u,t)=>{m(u,`fields.${t}`,i)})):i.push(s("invalid_analytics_kind","Analytics kind is not supported.","kind"));return{ok:i.length===0,errors:i,warnings:n,repairHints:x(i)}}function b(e){return e.replace(/\r\n/g,`
+`).trim()}function A(e){const i=[],n=[];if(!e||typeof e!="object")return{ok:!1,errors:[s("invalid_operation_intent","Operation intent must be a structured object.")],warnings:n,repairHints:[{code:"invalid_operation_intent",recommendedNextStep:"Send one typed operation intent with version, kind, and required operation fields."}]};if(e.version!==1&&i.push(s("invalid_version","Operation intent version must be 1.","version")),e.kind==="answer_obligations")!Array.isArray(e.obligations)||e.obligations.length===0?i.push(s("missing_obligations","Answer-obligations operation intent needs at least one obligation.","obligations")):e.obligations.forEach((o,f)=>{a(o.id)||i.push(s("missing_obligation_id","Each analytics obligation needs an id.",`obligations.${f}.id`)),a(o.prompt)||i.push(s("missing_obligation_prompt","Each analytics obligation needs a prompt.",`obligations.${f}.prompt`))});else if(e.kind==="dashboard_change"||e.kind==="data_app_change"){if(a(e.instruction)||i.push(s("missing_instruction","Change operation intent needs an instruction.","instruction")),e.analyticsIntent){const o=v(e.analyticsIntent);i.push(...o.errors),n.push(...o.warnings)}}else i.push(s("invalid_operation_kind","Operation intent kind is not supported.","kind"));return{ok:i.length===0,errors:i,warnings:n,repairHints:w(i)}}function S(e){const i=[],n=[];if(!e||typeof e!="object")return{ok:!1,errors:[s("invalid_recovery_plan","Analytics recovery plan must be a structured object.")],warnings:n,repairHints:[{code:"invalid_recovery_plan",recommendedNextStep:"Return a typed recovery plan with operationIntent and plannedToolCalls."}]};e.version!==1&&i.push(s("invalid_version","Recovery plan version must be 1.","version")),e.kind!=="analytics_recovery_plan"&&i.push(s("invalid_recovery_plan_kind","Recovery plan kind must be analytics_recovery_plan.","kind"));const o=A(e.operationIntent);return i.push(...o.errors),n.push(...o.warnings),Array.isArray(e.plannedToolCalls)||i.push(s("invalid_planned_tool_calls","Recovery plan plannedToolCalls must be an array.","plannedToolCalls")),{ok:i.length===0,errors:i,warnings:n,repairHints:w(i)}}function w(e){return e.map(i=>({code:i.code,recommendedNextStep:i.code==="missing_obligations"?"Normalize the user request into one or more typed analytics obligations before recovery planning.":"Correct the operation/recovery contract shape before planning execution."}))}function x(e){return e.map(i=>{switch(i.code){case"missing_source":return{code:i.code,fieldRole:"source",recommendedNextStep:"Provide a semantic, physical, or SQL source before executing analytics."};case"missing_metric":return{code:i.code,fieldRole:"metric",recommendedNextStep:"Choose one exact metric from the grounded schema candidates."};case"missing_record_fields":return{code:i.code,fieldRole:"dimension",recommendedNextStep:"Provide at least one field for the records intent."};case"missing_input_options_field":return{code:i.code,fieldRole:"input",recommendedNextStep:"Provide the exact field whose option values should be listed."};case"missing_sql":return{code:i.code,fieldRole:"sql",recommendedNextStep:"Provide bounded read-only SQL with an explicit outer LIMIT."};case"conflicting_sql":return{code:i.code,fieldRole:"sql",recommendedNextStep:"Use one canonical SQL text location for the intent; prefer top-level sql."};case"missing_semantic_domain":case"missing_dataset_name":case"missing_connection_id":case"missing_table_name":return{code:i.code,fieldRole:"source",recommendedNextStep:"Use grounded catalog metadata to fill the missing source reference."};default:return}}).filter(i=>!!i)}function R(e,i,n,o){if(!e||typeof e!="object"){n.push(s("invalid_view","Dashboard view must be an object.",i));return}if(a(e.title)||n.push(s("missing_view_title","Dashboard view needs a title.",i)),!e.presentation||typeof e.presentation!="object"){n.push(s("missing_presentation","Dashboard view needs a presentation.",`${i}.presentation`));return}if(e.presentation.kind==="text"){a(e.text)||o.push(s("missing_text_content","Text views should include text content.",`${i}.text`));return}if(!e.analytics){n.push(s("missing_view_analytics","Non-text dashboard views need analytics intent.",`${i}.analytics`));return}const f=v(e.analytics);for(const d of f.errors)n.push(s(d.code,d.message,`${i}.analytics${d.path?`.${d.path}`:""}`));for(const d of f.warnings)o.push(s(d.code,d.message,`${i}.analytics${d.path?`.${d.path}`:""}`))}function I(e){const i=[],n=[];if(!e||typeof e!="object")return{ok:!1,errors:[s("invalid_dashboard_intent","Dashboard intent must be a structured object.")],warnings:n};e.version!==1&&i.push(s("invalid_version","Dashboard intent version must be 1.")),e.kind!=="dashboard"&&i.push(s("invalid_kind","Experience intent kind must be dashboard.")),a(e.title)||i.push(s("missing_title","Dashboard intent needs a title.","title"));const o=Array.isArray(e.inputs)?e.inputs:[],f=h(o.filter(p).map(t=>t.id).filter(t=>typeof t=="string"));f&&i.push(s("duplicate_input_id",`Duplicate input id: ${f}.`,"inputs"));for(const[t,l]of o.entries()){const c=`inputs.${t}`;if(!p(l)){i.push(s("invalid_input","Dashboard input must be an object.",c));continue}a(l.id)||i.push(s("missing_input_id","Input needs an id.",`${c}.id`)),a(l.label)||i.push(s("missing_input_label","Input needs a label.",`${c}.label`)),!l.field||!a(l.field.name)?i.push(s("missing_input_field","Input needs a field.",`${c}.field`)):m(l.field,`${c}.field`,i),l.source&&y(l.source,`${c}.source`,i)}const d=Array.isArray(e.sections)?e.sections:[];d.length===0&&i.push(s("missing_sections","Dashboard intent needs at least one section.","sections"));const r=d.flatMap(t=>t&&typeof t=="object"&&Array.isArray(t.views)?t.views.filter(p).map(l=>l.id).filter(l=>!!l):[]),u=h(r);u&&i.push(s("duplicate_view_id",`Duplicate dashboard view id: ${u}.`,"sections"));for(const[t,l]of d.entries()){const c=`sections.${t}`;if(!l||typeof l!="object"){i.push(s("invalid_section","Dashboard section must be an object.",c));continue}if(a(l.title)||i.push(s("missing_section_title","Dashboard section needs a title.",c)),!Array.isArray(l.views)||l.views.length===0){i.push(s("missing_section_views","Dashboard section needs at least one view.",`${c}.views`));continue}for(const[_,k]of l.views.entries())R(k,`${c}.views.${_}`,i,n)}return{ok:i.length===0,errors:i,warnings:n}}exports.validateSemaphorAnalyticsIntent=v;exports.validateSemaphorAnalyticsRecoveryPlan=S;exports.validateSemaphorDashboardIntent=I;exports.validateSemaphorOperationIntent=A;