@agentmark-ai/api-types 0.5.0 → 0.6.0

package/dist/types.d.ts

@@ -301,7 +301,11 @@ export interface TracesParams extends PaginationParams {
     name?: string;
     tags?: string[];
     commitSha?: string;
-    filters?: AnalyticsFilter[];
+    /**
+     * AND of leaves and one-level OR-groups (see {@link AnalyticsFilterNode}).
+     * Plain `AnalyticsFilter[]` callers keep working unchanged.
+     */
+    filters?: AnalyticsFilterNode[];
     sortBy?: string;
     sortOrder?: 'asc' | 'desc';
     /** Single-env scoping per FR-031/FR-051. Undefined = no env filter. */
@@ -764,6 +768,24 @@ export interface AnalyticsFilter {
     operator: string;
     value: string | string[];
 }
+/**
+ * Disjunction of leaf predicates — matches rows satisfying ANY member.
+ * One level deep by design: a filter list is an AND of leaves and OR-groups
+ * (conjunctive normal form); members are always leaves, never nested groups.
+ */
+export interface AnalyticsFilterOrGroup {
+    or: AnalyticsFilter[];
+}
+/**
+ * One element of a filter list: a leaf predicate or an OR-group.
+ * `AnalyticsFilter[]` stays assignable wherever `AnalyticsFilterNode[]` is
+ * accepted, so existing AND-only callers are unaffected.
+ */
+export type AnalyticsFilterNode = AnalyticsFilter | AnalyticsFilterOrGroup;
+/**
+ * Type guard for OR-group nodes in a filter list.
+ */
+export declare function isAnalyticsFilterOrGroup(node: AnalyticsFilterNode): node is AnalyticsFilterOrGroup;
 /**
  * Supported filter fields for metrics queries.
  */

package/dist/types.js

@@ -9,6 +9,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isFilterConfigV2 = isFilterConfigV2;
 exports.isViewConfigV3 = isViewConfigV3;
+exports.isAnalyticsFilterOrGroup = isAnalyticsFilterOrGroup;
 /**
  * Type guard for v2 saved filter configs.
  */
@@ -21,3 +22,9 @@ function isFilterConfigV2(config) {
 function isViewConfigV3(config) {
     return 'version' in config && config.version === 3;
 }
+/**
+ * Type guard for OR-group nodes in a filter list.
+ */
+function isAnalyticsFilterOrGroup(node) {
+    return typeof node === 'object' && node !== null && Array.isArray(node.or);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentmark-ai/api-types",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Shared API contract types for AgentMark services",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,7 +15,7 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@agentmark-ai/api-schemas": "0.4.0"
+    "@agentmark-ai/api-schemas": "0.5.0"
   },
   "devDependencies": {
     "typescript": "^5.5.3"