@agentmark-ai/api-types 0.5.0 → 0.7.0

package/README.md

@@ -0,0 +1,7 @@
+# @agentmark-ai/api-types
+
+Shared API contract types (analytics service, traces, scores, experiments)
+used by the AgentMark CLI dev server and the AgentMark platform.
+
+Looking for the public wire contract (Zod schemas, error envelope)? That is
+[`@agentmark-ai/api-schemas`](https://www.npmjs.com/package/@agentmark-ai/api-schemas).

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. */
@@ -626,6 +630,12 @@ export interface ScoresParams extends Partial<PaginationParams> {
     sessionId?: string;
     startDate?: string;
     endDate?: string;
+    /**
+     * Structured filters over scores-table fields (name, score, source,
+     * user_id, resource_id, created_at) — AND of leaves and one-level
+     * OR-groups. Ignored by resource-keyed lookups (`resourceId` set).
+     */
+    filters?: AnalyticsFilterNode[];
     /** Single-env scoping per FR-031/FR-051/FR-109. Undefined = no env filter. */
     environment?: EnvironmentScope;
     /** Env-name allow-list from a saved filter (FR-122..FR-124). */
@@ -764,6 +774,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,21 +1,21 @@
 {
   "name": "@agentmark-ai/api-types",
-  "version": "0.5.0",
-  "description": "Shared API contract types for AgentMark services",
+  "version": "0.7.0",
+  "description": "Shared API contract types (analytics service, traces, scores) used by the AgentMark CLI dev server and platform. For the public wire schemas use @agentmark-ai/api-schemas.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "dist"
+  ],
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@agentmark-ai/api-schemas": "0.4.0"
+    "@agentmark-ai/api-schemas": "0.6.0"
   },
   "devDependencies": {
     "typescript": "^5.5.3"