@uluops/ops-sdk 1.8.1 → 1.8.4

package/dist/http/http-client.d.ts

@@ -9,21 +9,36 @@ export { toQuery, type QueryParams, type QueryParamValue } from '@uluops/sdk-cor
 import { type QueryParams as _QP } from '@uluops/sdk-core/utils';
 /**
  * Convert a camelCase query object to snake_case QueryParams for the API.
- * Strips 'all' values (API doesn't accept 'all' as a filter — omit to get all).
+ *
+ * @remarks
+ * Values of `'all'` are intentionally stripped — the API interprets an absent
+ * filter parameter as "return all", so `status: 'all'` and omitting `status`
+ * produce the same result. This convention is used by `StatusFilter` and
+ * `PriorityFilter` union types which include `'all'` for consumer ergonomics.
  */
 export declare function toApiQuery(query: object | undefined): _QP | undefined;
 /**
- * HTTP client configuration
+ * HTTP client configuration — shared base for OpsClient and OpsHttpClient.
+ * OpsClientConfig extends this with higher-level options.
  */
 export interface HttpClientConfig {
+    /** API base URL (defaults to production; localhost:3100 when NODE_ENV=development) */
     baseUrl?: string;
+    /** Request timeout in ms */
     timeout?: number;
+    /** Number of retries for transient errors */
     retries?: number;
+    /** Enable debug logging */
     debug?: boolean;
+    /** API key for authentication (preferred) */
     apiKey?: string;
+    /** Email for session-based auth */
     email?: string;
+    /** Password for session-based auth */
     password?: string;
+    /** Existing session token */
     sessionToken?: string;
+    /** Callback when session token is refreshed */
     onTokenRefresh?: (token: string) => void;
     /** Org slug for multi-tenancy — sets X-Org-Slug header on all requests */
     orgSlug?: string;

package/dist/http/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzF,OAAO,EAAE,KAAK,WAAW,IAAI,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,CAkBrE;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,MAAM,GAAE,gBAAqB;CAY1C"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAInD,OAAO,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzF,OAAO,EAAE,KAAK,WAAW,IAAI,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAGjE;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,GAAG,SAAS,CAkBrE;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,0EAA0E;IAC1E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,MAAM,GAAE,gBAAqB;CAY1C"}

package/dist/http/http-client.js

@@ -11,7 +11,12 @@ export { toQuery } from '@uluops/sdk-core/utils';
 import { toSnakeCase } from '../utils/helpers.js';
 /**
  * Convert a camelCase query object to snake_case QueryParams for the API.
- * Strips 'all' values (API doesn't accept 'all' as a filter — omit to get all).
+ *
+ * @remarks
+ * Values of `'all'` are intentionally stripped — the API interprets an absent
+ * filter parameter as "return all", so `status: 'all'` and omitting `status`
+ * produce the same result. This convention is used by `StatusFilter` and
+ * `PriorityFilter` union types which include `'all'` for consumer ergonomics.
  */
 export function toApiQuery(query) {
     if (!query)

package/dist/http/http-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,2EAA2E;AAC3E,OAAO,EAAE,OAAO,EAA0C,MAAM,wBAAwB,CAAC;AAGzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,KAAK,KAAK,KAAK;YAAE,SAAS,CAAC,yCAAyC;QACxE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3G,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,qEAAqE;YACrE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YACrF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,mEAAmE;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAmBD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,SAA2B,EAAE;QACvC,KAAK,CAAC;YACJ,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,gBAAgB;YAC3C,OAAO,EAAE,iBAAiB;YAC1B,UAAU,EAAE,WAAW;YACvB,YAAY,EAAE,gBAAgB;YAC9B,cAAc,EAAE;gBACd,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D;SACF,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/http/http-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAEvE,2EAA2E;AAC3E,OAAO,EAAE,OAAO,EAA0C,MAAM,wBAAwB,CAAC;AAGzF,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CAAC,KAAyB;IAClD,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,SAAS;YAAE,SAAS;QAClC,IAAI,KAAK,KAAK,KAAK;YAAE,SAAS,CAAC,yCAAyC;QACxE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAC3G,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;QACnC,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,qEAAqE;YACrE,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;YACrF,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QACD,mEAAmE;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AA6BD;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,SAA2B,EAAE;QACvC,KAAK,CAAC;YACJ,GAAG,MAAM;YACT,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,gBAAgB;YAC3C,OAAO,EAAE,iBAAiB;YAC1B,UAAU,EAAE,WAAW;YACvB,YAAY,EAAE,gBAAgB;YAC9B,cAAc,EAAE;gBACd,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC5D;SACF,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/index.d.ts

@@ -12,6 +12,7 @@ export { OpsHttpClient, type HttpClientConfig, type QueryParams, type QueryParam
 export { ApiKeyAuth, JwtSessionAuth, createAuthStrategy, type AuthStrategy, type AuthConfig } from './http/auth-strategy.js';
 export * from './errors/errors.js';
 export * from './types/index.js';
+export type { AnalyticsMetric } from './operations/analytics.js';
 export { loadCredentials, loadConfig, loadEnvFiles, type Credentials, type SdkConfig } from './config/loaders.js';
 export { DEFAULT_BASE_URL, API_KEY_PREFIX, ENV_VARS } from './config/constants.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG7H,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AAG9D,OAAO,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAG7H,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAGjE,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2DAA2D;AAC3D,OAAO,EAAE,SAAS,EAAwB,MAAM,aAAa,CAAC;AAE9D,oFAAoF;AACpF,OAAO,EAAE,aAAa,EAAiE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAsC,MAAM,yBAAyB,CAAC;AAE7H,0EAA0E;AAC1E,cAAc,oBAAoB,CAAC;AAEnC,gEAAgE;AAChE,cAAc,kBAAkB,CAAC;AAEjC,wFAAwF;AACxF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAoC,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,2DAA2D;AAC3D,OAAO,EAAE,SAAS,EAAwB,MAAM,aAAa,CAAC;AAE9D,oFAAoF;AACpF,OAAO,EAAE,aAAa,EAAiE,MAAM,uBAAuB,CAAC;AACrH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAsC,MAAM,yBAAyB,CAAC;AAE7H,0EAA0E;AAC1E,cAAc,oBAAoB,CAAC;AAEnC,gEAAgE;AAChE,cAAc,kBAAkB,CAAC;AAKjC,wFAAwF;AACxF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAoC,MAAM,qBAAqB,CAAC;AAClH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/operations/analytics.d.ts

@@ -1,84 +1,141 @@
 import { z } from 'zod';
 import type { OpsHttpClient } from '../http/http-client.js';
-import type { AnalyticsQuery, AgentInfo, AgentReliabilityQuery, BurndownQuery, VelocityQuery, DiscoveryQuery, AgentMatrixQuery } from '../types/analytics.js';
+import type { AnalyticsQuery, AgentInfo, AgentLifecycleEntry, AgentReliabilityQuery, BurndownQuery, VelocityQuery, DiscoveryQuery, AgentMatrixQuery } from '../types/analytics.js';
 import { AgentPerformanceResponseSchema, AgentReliabilityResultResponseSchema, ResolutionRateResponseSchema, FileHotspotResponseSchema, TaxonomyDistributionResponseSchema, FullTaxonomyAnalyticsResponseSchema, BurndownResultResponseSchema, VelocityResultResponseSchema, DiscoveryResultResponseSchema, AgentMatrixResultResponseSchema, TrendSummaryResponseSchema } from '../types/response-schemas.js';
 /**
- * Get agent performance metrics
+ * Get agent performance metrics (scores, pass rates, issue counts).
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days (default 30), limit
+ * @returns Array of agent performance records with name, averageScore, passRate, totalRuns
  */
 export declare function getAgentPerformance(client: OpsHttpClient, query?: AnalyticsQuery): Promise<z.infer<typeof AgentPerformanceResponseSchema>[]>;
 /**
- * Get agent reliability stats
+ * Get agent reliability statistics (false positive rates, resolution rates).
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: agent name, days (default 90)
+ * @returns `{ agents: AgentReliability[] }` with reliabilityScore per agent
  */
 export declare function getAgentReliability(client: OpsHttpClient, query?: AgentReliabilityQuery): Promise<z.infer<typeof AgentReliabilityResultResponseSchema>>;
 /**
- * Get agent lifecycle trajectory across versions
+ * Get agent lifecycle trajectory — version history with performance per version.
+ *
+ * @param client - HTTP client instance
+ * @param agentName - Agent name (e.g. 'code-validator')
+ * @param query - Optional filters: project, days
+ * @returns Array of lifecycle entries with definitionVersion, firstSeenAt, runs, avgScore, passRate
  */
-export declare function getAgentLifecycle(client: OpsHttpClient, agentName: string, query?: AnalyticsQuery): Promise<unknown>;
+export declare function getAgentLifecycle(client: OpsHttpClient, agentName: string, query?: AnalyticsQuery): Promise<AgentLifecycleEntry[]>;
 /**
- * Get issue resolution rates by project
+ * Get issue resolution rates by project.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days (default 30)
+ * @returns Array of `{ project, resolved, total, rate }` records
  */
 export declare function getResolutionRates(client: OpsHttpClient, query?: AnalyticsQuery): Promise<z.infer<typeof ResolutionRateResponseSchema>[]>;
 /**
- * Get files with most issues (hotspots)
+ * Get files with most issues (hotspots).
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days, limit
+ * @returns Array of `{ filePath, issueCount, failureDomains }` ordered by issueCount desc
  */
 export declare function getFileHotspots(client: OpsHttpClient, query?: AnalyticsQuery): Promise<z.infer<typeof FileHotspotResponseSchema>[]>;
 /**
- * Get basic taxonomy distribution
+ * Get basic taxonomy distribution (issue counts by failure domain and mode).
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days
+ * @returns Array of `{ domain, mode, count }` records
  */
 export declare function getTaxonomyDistribution(client: OpsHttpClient, query?: AnalyticsQuery): Promise<z.infer<typeof TaxonomyDistributionResponseSchema>[]>;
 /**
- * Get full taxonomy analytics with all aggregations.
+ * Get comprehensive taxonomy analytics with all aggregations.
+ * Returns unwrapped data directly (HttpClient auto-strips the `{ data }` envelope).
  *
- * Returns the unwrapped taxonomy data (HttpClient auto-strips the { data } envelope).
- * Includes domain/mode/severity distributions, top failure codes, heatmap data,
- * classification totals, and time period metadata.
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days
+ * @returns FullTaxonomyAnalytics with byDomain, byMode, bySeverity, topFailureCodes, heatmap, period
  */
 export declare function getFullTaxonomy(client: OpsHttpClient, query?: AnalyticsQuery): Promise<z.infer<typeof FullTaxonomyAnalyticsResponseSchema>>;
 /**
- * Get taxonomy burndown time series
+ * Get taxonomy burndown time series by failure domain.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional: project, days (default 30), granularity ('daily' | 'weekly')
+ * @returns `{ timeSeries, trends }` — trends keyed by domain with trend direction and avgDailyChange
  */
 export declare function getBurndown(client: OpsHttpClient, query?: BurndownQuery): Promise<z.infer<typeof BurndownResultResponseSchema>>;
 /**
- * Get taxonomy velocity (rate of change per failure mode)
+ * Get taxonomy velocity — rate of change per failure mode.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional: project, days, alertThreshold (10-500, default 50)
+ * @returns `{ items: VelocityItem[], summary: VelocitySummary, period }` — items have velocityPercent and alert flag
  */
 export declare function getVelocity(client: OpsHttpClient, query?: VelocityQuery): Promise<z.infer<typeof VelocityResultResponseSchema>>;
 /**
- * Get discovery timeline (new vs recurring issues)
+ * Get discovery timeline — new vs recurring issues over time.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days, granularity ('daily' | 'weekly')
+ * @returns `{ timeSeries, summary }` — summary includes newRate, recurringRate, totalNew, totalRecurring
  */
 export declare function getDiscovery(client: OpsHttpClient, query?: DiscoveryQuery): Promise<z.infer<typeof DiscoveryResultResponseSchema>>;
 /**
- * Get agent-taxonomy coverage matrix
+ * Get agent-taxonomy coverage matrix showing which agents detect which failure modes.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional: project, days (default 90), minIssues (default 5)
+ * @returns `{ matrix: AgentMatrixRow[], analysis: { blindSpots, singlePoints, highOverlap } }`
  */
 export declare function getAgentMatrix(client: OpsHttpClient, query?: AgentMatrixQuery): Promise<z.infer<typeof AgentMatrixResultResponseSchema>>;
 /**
- * Get general trend summary
+ * Get weekly trend summary with new issues, resolved issues, regressions, and average scores.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional: project, days
+ * @returns Array of TrendSummary entries with period, newIssues, resolvedIssues, regressions, averageScore
  */
 export declare function getTrendSummary(client: OpsHttpClient, query?: AnalyticsQuery): Promise<z.infer<typeof TrendSummaryResponseSchema>[]>;
 /**
  * List agents with summary info (derived from performance data).
+ * Calls `getAgentPerformance` internally — O(n) where n = total agent records.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days, limit
+ * @returns Array of `{ name, totalRuns, averageScore }` agent summaries
  */
 export declare function listAgents(client: OpsHttpClient, query?: AnalyticsQuery): Promise<AgentInfo[]>;
 /**
  * Valid metric names for getByMetric
  */
-export declare const ANALYTICS_METRICS: readonly ["agent_performance", "resolution_rates", "cross_project_patterns", "file_hotspots", "regression_analysis", "trend_summary", "cost_analysis", "taxonomy_distribution", "category_performance"];
+export declare const ANALYTICS_METRICS: readonly ["agent_performance", "resolution_rates", "cross_project_patterns", "file_hotspots", "regression_analysis", "trend_summary", "cost_analysis", "taxonomy_distribution"];
 export type AnalyticsMetric = (typeof ANALYTICS_METRICS)[number];
 /**
- * Check if a string is a valid analytics metric
+ * Check if a string is a valid analytics metric.
+ *
+ * @param metric - String to check
+ * @returns Type-narrowed `true` if metric is a valid `AnalyticsMetric`
+ * @example
+ * ```typescript
+ * if (isValidMetric(userInput)) {
+ *   const data = await client.analytics.getByMetric(userInput);
+ * }
+ * ```
  */
 export declare function isValidMetric(metric: string): metric is AnalyticsMetric;
 /**
- * Get analytics by metric name (generic endpoint).
- * Note: Response validation is not applied to this generic endpoint.
- * Use the typed methods (getAgentPerformance, getBurndown, etc.) for validated responses.
+ * Get analytics by metric name via the generic `/:metric` endpoint.
+ * Response is untyped (`unknown`) — prefer the typed methods for validated responses.
+ *
+ * @param client - HTTP client instance
+ * @param metric - One of: agent_performance, resolution_rates, cross_project_patterns, file_hotspots, regression_analysis, trend_summary, cost_analysis, taxonomy_distribution
+ * @param query - Optional: project, days
+ * @returns Unvalidated response data
+ * @throws {Error} If metric is not in ANALYTICS_METRICS
  */
 export declare function getByMetric(client: OpsHttpClient, metric: AnalyticsMetric, query?: AnalyticsQuery): Promise<unknown>;
-/** @deprecated Use getAgentPerformance instead */
-export declare const getValidatorPerformance: typeof getAgentPerformance;
-/** @deprecated Use getAgentReliability instead */
-export declare const getValidatorReliability: typeof getAgentReliability;
-/** @deprecated Use getAgentMatrix instead */
-export declare const getValidatorMatrix: typeof getAgentMatrix;
-/** @deprecated Use listAgents instead */
-export declare const listValidators: typeof listAgents;
 //# sourceMappingURL=analytics.d.ts.map

package/dist/operations/analytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/operations/analytics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/operations/analytics.ts"],"names":[],"mappings":"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"}

package/dist/operations/analytics.js

@@ -1,91 +1,143 @@
 import { z } from 'zod';
 import { toApiQuery } from '../http/http-client.js';
-import { AgentPerformanceResponseSchema, AgentReliabilityResultResponseSchema, ResolutionRateResponseSchema, FileHotspotResponseSchema, TaxonomyDistributionResponseSchema, FullTaxonomyAnalyticsResponseSchema, BurndownResultResponseSchema, VelocityResultResponseSchema, DiscoveryResultResponseSchema, AgentMatrixResultResponseSchema, TrendSummaryResponseSchema, } from '../types/response-schemas.js';
+import { InputValidationError } from '../errors/errors.js';
+import { AgentPerformanceResponseSchema, AgentLifecycleEntryResponseSchema, AgentReliabilityResultResponseSchema, ResolutionRateResponseSchema, FileHotspotResponseSchema, TaxonomyDistributionResponseSchema, FullTaxonomyAnalyticsResponseSchema, BurndownResultResponseSchema, VelocityResultResponseSchema, DiscoveryResultResponseSchema, AgentMatrixResultResponseSchema, TrendSummaryResponseSchema, } from '../types/response-schemas.js';
 /**
- * Get agent performance metrics
+ * Get agent performance metrics (scores, pass rates, issue counts).
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days (default 30), limit
+ * @returns Array of agent performance records with name, averageScore, passRate, totalRuns
  */
 export async function getAgentPerformance(client, query) {
     return client.get('/analytics/agents/performance', toApiQuery(query), { schema: z.array(AgentPerformanceResponseSchema) });
 }
 /**
- * Get agent reliability stats
+ * Get agent reliability statistics (false positive rates, resolution rates).
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: agent name, days (default 90)
+ * @returns `{ agents: AgentReliability[] }` with reliabilityScore per agent
  */
 export async function getAgentReliability(client, query) {
     return client.get('/analytics/agents/reliability', toApiQuery(query), { schema: AgentReliabilityResultResponseSchema });
 }
 /**
- * Get agent lifecycle trajectory across versions
+ * Get agent lifecycle trajectory — version history with performance per version.
+ *
+ * @param client - HTTP client instance
+ * @param agentName - Agent name (e.g. 'code-validator')
+ * @param query - Optional filters: project, days
+ * @returns Array of lifecycle entries with definitionVersion, firstSeenAt, runs, avgScore, passRate
  */
 export async function getAgentLifecycle(client, agentName, query) {
-    return client.get(`/agents/${encodeURIComponent(agentName)}/lifecycle`, toApiQuery(query));
+    return client.get(`/agents/${encodeURIComponent(agentName)}/lifecycle`, toApiQuery(query), { schema: z.array(AgentLifecycleEntryResponseSchema) });
 }
 /**
- * Get issue resolution rates by project
+ * Get issue resolution rates by project.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days (default 30)
+ * @returns Array of `{ project, resolved, total, rate }` records
  */
 export async function getResolutionRates(client, query) {
     return client.get('/analytics/projects/resolution-rates', toApiQuery(query), { schema: z.array(ResolutionRateResponseSchema) });
 }
 /**
- * Get files with most issues (hotspots)
+ * Get files with most issues (hotspots).
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days, limit
+ * @returns Array of `{ filePath, issueCount, failureDomains }` ordered by issueCount desc
  */
 export async function getFileHotspots(client, query) {
     return client.get('/analytics/files/hotspots', toApiQuery(query), { schema: z.array(FileHotspotResponseSchema) });
 }
 /**
- * Get basic taxonomy distribution
+ * Get basic taxonomy distribution (issue counts by failure domain and mode).
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days
+ * @returns Array of `{ domain, mode, count }` records
  */
 export async function getTaxonomyDistribution(client, query) {
     return client.get('/analytics/taxonomy/distribution', toApiQuery(query), { schema: z.array(TaxonomyDistributionResponseSchema) });
 }
 /**
- * Get full taxonomy analytics with all aggregations.
+ * Get comprehensive taxonomy analytics with all aggregations.
+ * Returns unwrapped data directly (HttpClient auto-strips the `{ data }` envelope).
  *
- * Returns the unwrapped taxonomy data (HttpClient auto-strips the { data } envelope).
- * Includes domain/mode/severity distributions, top failure codes, heatmap data,
- * classification totals, and time period metadata.
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days
+ * @returns FullTaxonomyAnalytics with byDomain, byMode, bySeverity, topFailureCodes, heatmap, period
  */
 export async function getFullTaxonomy(client, query) {
     return client.get('/analytics/taxonomy/full', toApiQuery(query), { schema: FullTaxonomyAnalyticsResponseSchema });
 }
 /**
- * Get taxonomy burndown time series
+ * Get taxonomy burndown time series by failure domain.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional: project, days (default 30), granularity ('daily' | 'weekly')
+ * @returns `{ timeSeries, trends }` — trends keyed by domain with trend direction and avgDailyChange
  */
 export async function getBurndown(client, query) {
     return client.get('/analytics/taxonomy/burndown', toApiQuery(query), { schema: BurndownResultResponseSchema });
 }
 /**
- * Get taxonomy velocity (rate of change per failure mode)
+ * Get taxonomy velocity — rate of change per failure mode.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional: project, days, alertThreshold (10-500, default 50)
+ * @returns `{ items: VelocityItem[], summary: VelocitySummary, period }` — items have velocityPercent and alert flag
  */
 export async function getVelocity(client, query) {
     return client.get('/analytics/taxonomy/velocity', toApiQuery(query), { schema: VelocityResultResponseSchema });
 }
 /**
- * Get discovery timeline (new vs recurring issues)
+ * Get discovery timeline — new vs recurring issues over time.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days, granularity ('daily' | 'weekly')
+ * @returns `{ timeSeries, summary }` — summary includes newRate, recurringRate, totalNew, totalRecurring
  */
 export async function getDiscovery(client, query) {
     return client.get('/analytics/taxonomy/discovery', toApiQuery(query), { schema: DiscoveryResultResponseSchema });
 }
 /**
- * Get agent-taxonomy coverage matrix
+ * Get agent-taxonomy coverage matrix showing which agents detect which failure modes.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional: project, days (default 90), minIssues (default 5)
+ * @returns `{ matrix: AgentMatrixRow[], analysis: { blindSpots, singlePoints, highOverlap } }`
  */
 export async function getAgentMatrix(client, query) {
     return client.get('/analytics/taxonomy/agent-matrix', toApiQuery(query), { schema: AgentMatrixResultResponseSchema });
 }
 /**
- * Get general trend summary
+ * Get weekly trend summary with new issues, resolved issues, regressions, and average scores.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional: project, days
+ * @returns Array of TrendSummary entries with period, newIssues, resolvedIssues, regressions, averageScore
  */
 export async function getTrendSummary(client, query) {
     return client.get('/analytics/trends/summary', toApiQuery(query), { schema: z.array(TrendSummaryResponseSchema) });
 }
 /**
  * List agents with summary info (derived from performance data).
+ * Calls `getAgentPerformance` internally — O(n) where n = total agent records.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: project, days, limit
+ * @returns Array of `{ name, totalRuns, averageScore }` agent summaries
  */
 export async function listAgents(client, query) {
     const perf = await getAgentPerformance(client, query);
     return perf.map(v => ({
         name: v.name,
         totalRuns: v.totalRuns,
-        avgScore: v.averageScore,
+        averageScore: v.averageScore,
         passRate: v.passRate,
     }));
 }
@@ -101,32 +153,36 @@ export const ANALYTICS_METRICS = [
     'trend_summary',
     'cost_analysis',
     'taxonomy_distribution',
-    'category_performance',
 ];
 /**
- * Check if a string is a valid analytics metric
+ * Check if a string is a valid analytics metric.
+ *
+ * @param metric - String to check
+ * @returns Type-narrowed `true` if metric is a valid `AnalyticsMetric`
+ * @example
+ * ```typescript
+ * if (isValidMetric(userInput)) {
+ *   const data = await client.analytics.getByMetric(userInput);
+ * }
+ * ```
  */
 export function isValidMetric(metric) {
     return ANALYTICS_METRICS.includes(metric);
 }
 /**
- * Get analytics by metric name (generic endpoint).
- * Note: Response validation is not applied to this generic endpoint.
- * Use the typed methods (getAgentPerformance, getBurndown, etc.) for validated responses.
+ * Get analytics by metric name via the generic `/:metric` endpoint.
+ * Response is untyped (`unknown`) — prefer the typed methods for validated responses.
+ *
+ * @param client - HTTP client instance
+ * @param metric - One of: agent_performance, resolution_rates, cross_project_patterns, file_hotspots, regression_analysis, trend_summary, cost_analysis, taxonomy_distribution
+ * @param query - Optional: project, days
+ * @returns Unvalidated response data
+ * @throws {Error} If metric is not in ANALYTICS_METRICS
  */
 export async function getByMetric(client, metric, query) {
     if (!isValidMetric(metric)) {
-        throw new Error(`Invalid analytics metric: "${metric}". Valid metrics: ${ANALYTICS_METRICS.join(', ')}`);
+        throw new InputValidationError(`Invalid analytics metric: "${metric}". Valid metrics: ${ANALYTICS_METRICS.join(', ')}`, [{ code: 'custom', path: ['metric'], message: `must be one of: ${ANALYTICS_METRICS.join(', ')}` }]);
     }
     return client.get(`/analytics/${metric}`, toApiQuery(query));
 }
-// Backwards-compatible aliases
-/** @deprecated Use getAgentPerformance instead */
-export const getValidatorPerformance = getAgentPerformance;
-/** @deprecated Use getAgentReliability instead */
-export const getValidatorReliability = getAgentReliability;
-/** @deprecated Use getAgentMatrix instead */
-export const getValidatorMatrix = getAgentMatrix;
-/** @deprecated Use listAgents instead */
-export const listValidators = listAgents;
 //# sourceMappingURL=analytics.js.map

package/dist/operations/analytics.js.map

@@ -1 +1 @@
-{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/operations/analytics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../src/operations/analytics.ts"],"names":[],"mappings":"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"}

package/dist/operations/auth.d.ts

@@ -2,15 +2,30 @@ import type { OpsHttpClient } from '../http/http-client.js';
 import type { RegisterInput, LoginInput, LoginResponse, RegisterResponse, UpdateProfileInput, ChangePasswordInput, ResetPasswordInput, CreateApiKeyInput, ApiKeyCreatedResponse, PublicApiKey, PublicSession, AuthUser, PublicUser } from '../types/auth.js';
 import type { MessageResponse } from '../types/responses.js';
 /**
- * Register a new user
+ * Register a new user account. Does not require authentication.
+ *
+ * @param client - HTTP client instance
+ * @param input - `{ email, password }` — password requires 8-128 chars, uppercase + lowercase + digit
+ * @returns `{ user, token }` — the token can be used for immediate session auth
+ * @throws {InputValidationError} If email invalid or password doesn't meet requirements
  */
 export declare function register(client: OpsHttpClient, input: RegisterInput): Promise<RegisterResponse>;
 /**
- * Login with email and password
+ * Login with email and password. Does not require authentication.
+ * Returns a session token — use `OpsClient.login()` instead for auto-install.
+ *
+ * @param client - HTTP client instance
+ * @param input - `{ email, password }`
+ * @returns `{ user, sessionToken }` — token must be manually installed on the client
+ * @throws {InputValidationError} If email or password is missing
+ * @throws {UnauthorizedError} If credentials are invalid
  */
 export declare function login(client: OpsHttpClient, input: LoginInput): Promise<LoginResponse>;
 /**
- * Logout all sessions for the current user
+ * Revoke all sessions for the current user (not just the current session).
+ *
+ * @param client - HTTP client instance
+ * @returns `{ sessionsRevoked: number }`
  */
 export declare function logoutAll(client: OpsHttpClient): Promise<{
     sessionsRevoked: number;
@@ -24,11 +39,21 @@ export declare function forgotPassword(client: OpsHttpClient, email: string): Pr
  */
 export declare function resetPassword(client: OpsHttpClient, input: ResetPasswordInput): Promise<MessageResponse>;
 /**
- * Change password (requires current password)
+ * Change the current user's password. Requires knowing the current password.
+ *
+ * @param client - HTTP client instance
+ * @param input - `{ currentPassword, newPassword }` — new password must meet requirements
+ * @returns Success message
+ * @throws {InputValidationError} If new password doesn't meet requirements
+ * @throws {UnauthorizedError} If current password is incorrect
  */
 export declare function changePassword(client: OpsHttpClient, input: ChangePasswordInput): Promise<MessageResponse>;
 /**
- * Set password (first time, no current password)
+ * Set password for the first time (accounts created without one, e.g. OAuth or admin-created).
+ *
+ * @param client - HTTP client instance
+ * @param password - New password
+ * @returns Success message
  */
 export declare function setPassword(client: OpsHttpClient, password: string): Promise<MessageResponse>;
 /**
@@ -42,13 +67,21 @@ export declare function getProfile(client: OpsHttpClient): Promise<{
     user: PublicUser;
 }>;
 /**
- * Update current user's profile
+ * Update the current user's profile. At least one field must be provided.
+ *
+ * @param client - HTTP client instance
+ * @param input - Profile fields: username, name, bio, timezone, websiteUrl, avatar (base64), avatarMimeType
+ * @returns `{ user }` with updated profile
+ * @throws {InputValidationError} If no fields provided or constraints violated
  */
 export declare function updateProfile(client: OpsHttpClient, input: UpdateProfileInput): Promise<{
     user: PublicUser;
 }>;
 /**
- * Get current user's avatar (returns binary data)
+ * Get the current user's avatar image as binary data.
+ *
+ * @param client - HTTP client instance
+ * @returns `{ data: ArrayBuffer, contentType: string }` — contentType is e.g. 'image/png'
  */
 export declare function getAvatar(client: OpsHttpClient): Promise<{
     data: ArrayBuffer;
@@ -63,7 +96,12 @@ export declare function deleteAvatar(client: OpsHttpClient): Promise<void>;
  */
 export declare function listApiKeys(client: OpsHttpClient): Promise<PublicApiKey[]>;
 /**
- * Create a new API key
+ * Create a new API key. The full key is only returned once — store it securely.
+ *
+ * @param client - HTTP client instance
+ * @param input - Optional: `{ name?, expiresAt? }`
+ * @returns `{ id, name, key }` — key starts with `ulr_` prefix
+ * @throws {InputValidationError} If name exceeds 100 chars
  */
 export declare function createApiKey(client: OpsHttpClient, input?: CreateApiKeyInput): Promise<ApiKeyCreatedResponse>;
 /**

package/dist/operations/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/operations/auth.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/operations/auth.ts"],"names":[],"mappings":"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"}