@uluops/ops-sdk 1.8.3 → 1.8.4

package/dist/operations/projects.js

@@ -4,47 +4,77 @@ import { ProjectResponseSchema, ProjectSummaryResponseSchema, ProjectTrendsRespo
 import { validateCreateProjectInput, validateDeleteProjectInput, validateRenameProjectInput, } from '../config/validators.js';
 import { buildIssueListParams } from './query-utils.js';
 /**
- * List all projects for the current user
+ * List all projects accessible to the current user.
+ *
+ * @param client - HTTP client instance
+ * @returns Array of projects with metadata (runCount, issueCount, etc.)
  */
 export async function list(client) {
     return client.get('/projects', undefined, { schema: z.array(ProjectResponseSchema) });
 }
 /**
- * Get a single project by ID or name
+ * Get a project by UUID or name.
+ *
+ * @param client - HTTP client instance
+ * @param idOrName - Project UUID or name string
+ * @returns Project record
+ * @throws {NotFoundError} If project does not exist
  */
 export async function get(client, idOrName) {
     return client.get(`/projects/${encodeURIComponent(idOrName)}`, undefined, { schema: ProjectResponseSchema });
 }
 /**
- * Create a new project
+ * Create a new project.
+ *
+ * @param client - HTTP client instance
+ * @param input - Project data: `{ name: string }` (1-200 chars, unique)
+ * @returns Created project
+ * @throws {InputValidationError} If name is empty or exceeds 200 chars
+ * @throws {ConflictError} If a project with that name already exists
  */
 export async function create(client, input) {
     validateCreateProjectInput(input);
     return client.post('/projects', input, { schema: ProjectResponseSchema });
 }
 /**
- * Update a project
+ * Update a project's mutable fields (name, description).
+ * Unlike create/delete, does not run client-side Zod validation — input is validated server-side only.
+ *
+ * @param client - HTTP client instance
+ * @param idOrName - Project UUID or name
+ * @param input - Fields to update
+ * @returns Updated project
  */
 export async function update(client, idOrName, input) {
     return client.patch(`/projects/${encodeURIComponent(idOrName)}`, input, { schema: ProjectResponseSchema });
 }
 /**
- * Hard delete a project (requires confirmation)
+ * Permanently delete a project. Irreversible — use softDelete for recoverable removal.
+ *
+ * @param client - HTTP client instance
+ * @param idOrName - Project UUID or name
+ * @param input - Confirmation: `{ confirm: true, confirmationPhrase: string }`
+ * @returns `{ deleted: true }`
+ * @throws {InputValidationError} If confirm is not `true` or phrase is missing
  */
 export async function deleteProject(client, idOrName, input) {
-    validateDeleteProjectInput(input);
-    await client.delete(`/projects/${encodeURIComponent(idOrName)}`, {
-        confirm: input.confirm,
-        confirmationPhrase: input.confirmationPhrase,
-    });
-    return { deleted: true };
+    return deleteWithConfirmation(client, `/projects/${encodeURIComponent(idOrName)}`, input);
 }
 /**
- * Soft delete a project (can be restored)
+ * Soft delete a project. Can be restored via `restore()`.
+ *
+ * @param client - HTTP client instance
+ * @param idOrName - Project UUID or name
+ * @param input - Confirmation: `{ confirm: true, confirmationPhrase: string }`
+ * @returns `{ deleted: true }`
+ * @throws {InputValidationError} If confirm is not `true` or phrase is missing
  */
 export async function softDelete(client, idOrName, input) {
+    return deleteWithConfirmation(client, `/projects/${encodeURIComponent(idOrName)}/soft`, input);
+}
+async function deleteWithConfirmation(client, path, input) {
     validateDeleteProjectInput(input);
-    await client.delete(`/projects/${encodeURIComponent(idOrName)}/soft`, {
+    await client.delete(path, {
         confirm: input.confirm,
         confirmationPhrase: input.confirmationPhrase,
     });
@@ -57,7 +87,12 @@ export async function restore(client, idOrName) {
     return client.post(`/projects/${encodeURIComponent(idOrName)}/restore`, undefined, { schema: ProjectResponseSchema });
 }
 /**
- * Rename a project by name
+ * Rename a project by name.
+ *
+ * @param client - HTTP client instance
+ * @param input - `{ oldName: string, newName: string }` (newName 1-200 chars)
+ * @returns Renamed project
+ * @throws {InputValidationError} If names are empty or newName exceeds 200 chars
  */
 export async function rename(client, input) {
     validateRenameProjectInput(input);
@@ -87,9 +122,16 @@ export async function listIssues(client, idOrName, query) {
 /**
  * List issues in a project with count (preserves pagination count from API envelope).
  *
+ * @remarks
  * Uses `requestRaw` to access the `count` field outside the `data` envelope.
- * Note: `requestRaw` does not include automatic retry or token refresh.
+ * This bypasses automatic retry, token refresh, and Zod schema validation.
  * For retry-safe access without count, use {@link listIssues}.
+ * For retry-safe pagination count, call `getSummary()` separately for `totalIssues`.
+ *
+ * @param client - HTTP client instance
+ * @param idOrName - Project UUID or name
+ * @param query - Optional filters: status, priority, agent, limit, offset
+ * @returns `{ issues, count }` — count reflects total matching issues for pagination
  */
 export async function listIssuesWithCount(client, idOrName, query) {
     const response = await client.requestRaw('GET', `/projects/${encodeURIComponent(idOrName)}/issues`, buildIssueListParams(query));
@@ -99,13 +141,23 @@ export async function listIssuesWithCount(client, idOrName, query) {
     return { issues: response.data ?? [], count: response.count ?? response.data?.length ?? 0 };
 }
 /**
- * Bulk update issue statuses in a project
+ * Bulk update issue statuses within a project. Each item may succeed or fail independently.
+ *
+ * @param client - HTTP client instance
+ * @param idOrName - Project UUID or name
+ * @param updates - Array of `{ issueId, status, reason? }`
+ * @returns Per-item results with success/failure status
  */
 export async function bulkUpdateIssueStatus(client, idOrName, updates) {
     return client.patch(`/projects/${encodeURIComponent(idOrName)}/issues/status`, { updates }, { schema: BulkStatusUpdateResultResponseSchema });
 }
 /**
- * Merge multiple issues into one
+ * Merge duplicate issues into a target issue. Source issues are closed.
+ *
+ * @param client - HTTP client instance
+ * @param idOrName - Project UUID or name
+ * @param input - `{ targetIssueId, sourceIssueIds, strategy? }` — strategy: 'keep_target' or 'keep_highest_priority'
+ * @returns Merge result with counts
  */
 export async function mergeIssues(client, idOrName, input) {
     return client.post(`/projects/${encodeURIComponent(idOrName)}/issues/merge`, {

package/dist/operations/projects.js.map

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

package/dist/operations/runs.d.ts

@@ -4,70 +4,154 @@ import type { Run, SaveRunInput, SaveRunResponse, ValidateRunResponse, RunDiffQu
 import type { DeleteResult } from '../types/responses.js';
 import { RunSummaryResponseSchema, RunAnalysisResponseSchema, ProjectAnalysisListResponseSchema, AnalysisRecordsListResponseSchema, AgentRunsAnalysisResponseSchema } from '../types/response-schemas.js';
 /**
- * Save validation run results (save_run)
+ * Save a validation run with agent scores and recommendations.
+ * Input is validated client-side via Zod before the network request.
  *
- * Sends SDK input directly in camelCase. The API accepts both
- * camelCase and snake_case via normalizeKeys().
+ * @param client - HTTP client instance
+ * @param input - Run data (project, workflowType, agents, recommendations required)
+ * @returns Save result with run metadata and issue correlation (new/recurring/regressions)
+ * @throws {InputValidationError} If input fails client-side Zod validation
+ * @throws {ConflictError} If idempotencyKey was already used
+ * @example
+ * ```typescript
+ * const result = await client.runs.save({
+ *   project: 'my-project',
+ *   workflowType: 'post-implementation',
+ *   agents: [{ name: 'code-validator', score: 85, decision: 'PASS' }],
+ *   recommendations: [{ agent: 'code-validator', title: 'Missing null check', priority: 'suggested', failure_code: 'SEM-VAL/M' }],
+ * });
+ * console.log(result.run.runNumber, result.correlation.newIssues);
+ * ```
  */
 export declare function save(client: OpsHttpClient, input: SaveRunInput): Promise<SaveRunResponse>;
 /**
- * Validate run data without saving (preview)
+ * Preview what a save would produce without persisting. Returns projected
+ * issue correlation (what would be created, updated, regressed).
  *
- * Similar to save() but the API validates data and returns what
- * would be created/updated without actually persisting anything.
+ * @param client - HTTP client instance
+ * @param input - Same shape as save() input
+ * @returns Preview with projected new/recurring/regression counts
+ * @throws {InputValidationError} If input fails client-side Zod validation
  */
 export declare function validate(client: OpsHttpClient, input: SaveRunInput): Promise<ValidateRunResponse>;
 /**
- * Compare two runs (diff)
+ * Compare two runs to see fixed, new, and unchanged issues.
+ *
+ * @param client - HTTP client instance
+ * @param query - Diff parameters: project, baseRun number, compareRun number
+ * @returns Diff result with fixed/new/unchanged issues and agent score changes
  */
 export declare function diff(client: OpsHttpClient, query: RunDiffQuery): Promise<RunDiffResult>;
 /**
- * Archive old runs
+ * Archive old runs by run number, date, or retention count.
+ *
+ * @param client - HTTP client instance
+ * @param input - Archive criteria: project (required), plus beforeRunNumber, beforeDate, keepLast, reason
+ * @returns Archive result with count of archived runs
+ * @throws {InputValidationError} If input fails client-side Zod validation
  */
 export declare function archive(client: OpsHttpClient, input: ArchiveRunsInput): Promise<ArchiveRunsResult>;
 /**
- * Update run metadata by project and run number
+ * Update run metadata by project and run number. Supports post-hoc
+ * enrichment with analysis records and summaries.
+ *
+ * @param client - HTTP client instance
+ * @param input - Update payload with project + runNumber identifier
+ * @returns Updated run
  */
 export declare function update(client: OpsHttpClient, input: UpdateRunByNumberInput): Promise<Run>;
 /**
- * List runs for a project
+ * List runs for a project with optional filters.
+ *
+ * @param client - HTTP client instance
+ * @param projectId - Project ID or name
+ * @param query - Optional filters: workflowType, limit, offset
+ * @returns Array of run summaries
  */
 export declare function listByProject(client: OpsHttpClient, projectId: string, query?: ListRunsQuery): Promise<z.infer<typeof RunSummaryResponseSchema>[]>;
 /**
- * Get the latest run for a project
+ * Get the most recent run for a project, optionally filtered by workflow type.
+ *
+ * @param client - HTTP client instance
+ * @param projectId - Project ID or name
+ * @param workflowType - Optional workflow type filter (e.g. 'post-implementation')
+ * @returns Latest run
+ * @throws {NotFoundError} If no runs exist for the project/workflow
  */
 export declare function getLatest(client: OpsHttpClient, projectId: string, workflowType?: string): Promise<Run>;
 /**
- * Get full run details with recommendations
+ * Get full run details including agents, recommendations, and analysis data.
+ *
+ * @param client - HTTP client instance
+ * @param projectId - Project ID or name
+ * @param runNumber - Specific run number (omit for latest)
+ * @returns Run details with nested agents and recommendations arrays
  */
 export declare function getDetails(client: OpsHttpClient, projectId: string, runNumber?: number): Promise<RunDetails>;
 /**
- * Get a run by ID
+ * Get a run by its UUID.
+ *
+ * @param client - HTTP client instance
+ * @param runId - Run UUID
+ * @returns Run record
+ * @throws {NotFoundError} If run does not exist
  */
 export declare function get(client: OpsHttpClient, runId: string): Promise<Run>;
 /**
- * Update a run by ID
+ * Update run metadata by UUID. Supports post-hoc enrichment with
+ * analysis records, summaries, and exploration maps.
+ *
+ * @param client - HTTP client instance
+ * @param runId - Run UUID
+ * @param input - Fields to update (all optional except identifier)
+ * @returns Updated run
  */
 export declare function updateById(client: OpsHttpClient, runId: string, input: UpdateRunInput): Promise<Run>;
 /**
- * Delete a run (requires confirmation header)
+ * Permanently delete a run. Requires the run ID as a confirmation header.
+ *
+ * @param client - HTTP client instance
+ * @param runId - Run UUID (also sent as X-Confirm-Delete header)
+ * @returns `{ deleted: true }` on success
  */
 export declare function deleteRun(client: OpsHttpClient, runId: string): Promise<DeleteResult>;
 /**
- * Get analysis records and summaries for a specific run
+ * Get structured analysis records and summaries for a specific run.
+ * Includes convention inventories, tension maps, decay vectors, exploration maps, etc.
+ *
+ * @param client - HTTP client instance
+ * @param runId - Run UUID
+ * @returns Analysis data with records and summaries arrays
  */
 export declare function getAnalysis(client: OpsHttpClient, runId: string): Promise<z.infer<typeof RunAnalysisResponseSchema>>;
 /**
- * Get analysis summaries for a project over time
+ * Get analysis summaries for a project over time. Filter by agent name,
+ * agent type, or decision to track specific analytical trajectories.
+ *
+ * @param client - HTTP client instance
+ * @param projectId - Project ID or name
+ * @param query - Optional filters: agentName, agentType, decision, limit, offset
+ * @returns Paginated analysis summaries with `{ data, total }`
  */
 export declare function getProjectAnalysis(client: OpsHttpClient, projectId: string, query?: ProjectAnalysisQuery): Promise<z.infer<typeof ProjectAnalysisListResponseSchema>>;
 /**
- * Query analysis records across projects with filters
+ * Query analysis records across projects. Filter by record type
+ * (convention, tension, decay_vector), classification, agent, or severity.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: recordType, classification, agentName, severity, limit, offset
+ * @returns Paginated analysis records with `{ data, total }`
  */
 export declare function queryAnalysisRecords(client: OpsHttpClient, query?: AnalysisRecordsQuery): Promise<z.infer<typeof AnalysisRecordsListResponseSchema>>;
 /**
  * Get analysis summaries with run context for a specific agent.
- * Returns the unwrapped data array (SDK auto-unwraps { data } envelope).
+ * Returns decision, score, category scores alongside run metadata
+ * (run number, timestamp, workflow type, snapshot score).
+ *
+ * @param client - HTTP client instance
+ * @param agentName - Agent name (e.g. 'epictetus-validator')
+ * @param query - Query with required `project`, optional `decision`, `limit`, `offset`
+ * @returns `{ items: AgentRunSummary[], total: number }`
  */
 export declare function getAgentRunsAnalysis(client: OpsHttpClient, agentName: string, query: AgentRunsAnalysisQuery): Promise<z.infer<typeof AgentRunsAnalysisResponseSchema>>;
 //# sourceMappingURL=runs.d.ts.map

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

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

package/dist/operations/runs.js

@@ -1,15 +1,32 @@
+import { randomUUID } from 'node:crypto';
 import { z } from 'zod';
 import { toApiQuery } from '../http/http-client.js';
 import { RunResponseSchema, RunSummaryResponseSchema, SaveRunResponseSchema, ValidateRunResponseSchema, RunDiffResultResponseSchema, ArchiveRunsResultResponseSchema, DeleteResultResponseSchema, RunDetailsResponseSchema, RunAnalysisResponseSchema, ProjectAnalysisListResponseSchema, AnalysisRecordsListResponseSchema, AgentRunsAnalysisResponseSchema, } from '../types/response-schemas.js';
 import { validateSaveRunInput, validateArchiveRunsInput, } from '../config/validators.js';
 /**
- * Save validation run results (save_run)
+ * Save a validation run with agent scores and recommendations.
+ * Input is validated client-side via Zod before the network request.
  *
- * Sends SDK input directly in camelCase. The API accepts both
- * camelCase and snake_case via normalizeKeys().
+ * @param client - HTTP client instance
+ * @param input - Run data (project, workflowType, agents, recommendations required)
+ * @returns Save result with run metadata and issue correlation (new/recurring/regressions)
+ * @throws {InputValidationError} If input fails client-side Zod validation
+ * @throws {ConflictError} If idempotencyKey was already used
+ * @example
+ * ```typescript
+ * const result = await client.runs.save({
+ *   project: 'my-project',
+ *   workflowType: 'post-implementation',
+ *   agents: [{ name: 'code-validator', score: 85, decision: 'PASS' }],
+ *   recommendations: [{ agent: 'code-validator', title: 'Missing null check', priority: 'suggested', failure_code: 'SEM-VAL/M' }],
+ * });
+ * console.log(result.run.runNumber, result.correlation.newIssues);
+ * ```
  */
 export async function save(client, input) {
     validateSaveRunInput(input);
+    // Generate idempotency key if not provided — prevents duplicate runs on retry
+    const idempotencyKey = input.idempotencyKey ?? randomUUID();
     return client.post('/runs', {
         project: input.project,
         workflowType: input.workflowType,
@@ -18,7 +35,7 @@ export async function save(client, input) {
         timestamp: input.timestamp,
         rawMarkdown: input.rawMarkdown,
         summary: input.summary,
-        idempotencyKey: input.idempotencyKey,
+        idempotencyKey,
         definitionType: input.definitionType,
         definitionName: input.definitionName,
         definitionVersion: input.definitionVersion,
@@ -30,10 +47,13 @@ export async function save(client, input) {
     }, { retryMutations: true, schema: SaveRunResponseSchema });
 }
 /**
- * Validate run data without saving (preview)
+ * Preview what a save would produce without persisting. Returns projected
+ * issue correlation (what would be created, updated, regressed).
  *
- * Similar to save() but the API validates data and returns what
- * would be created/updated without actually persisting anything.
+ * @param client - HTTP client instance
+ * @param input - Same shape as save() input
+ * @returns Preview with projected new/recurring/regression counts
+ * @throws {InputValidationError} If input fails client-side Zod validation
  */
 export async function validate(client, input) {
     validateSaveRunInput(input);
@@ -45,7 +65,11 @@ export async function validate(client, input) {
     }, { schema: ValidateRunResponseSchema });
 }
 /**
- * Compare two runs (diff)
+ * Compare two runs to see fixed, new, and unchanged issues.
+ *
+ * @param client - HTTP client instance
+ * @param query - Diff parameters: project, baseRun number, compareRun number
+ * @returns Diff result with fixed/new/unchanged issues and agent score changes
  */
 export async function diff(client, query) {
     return client.get('/runs/diff', toApiQuery({
@@ -55,7 +79,12 @@ export async function diff(client, query) {
     }), { schema: RunDiffResultResponseSchema });
 }
 /**
- * Archive old runs
+ * Archive old runs by run number, date, or retention count.
+ *
+ * @param client - HTTP client instance
+ * @param input - Archive criteria: project (required), plus beforeRunNumber, beforeDate, keepLast, reason
+ * @returns Archive result with count of archived runs
+ * @throws {InputValidationError} If input fails client-side Zod validation
  */
 export async function archive(client, input) {
     validateArchiveRunsInput(input);
@@ -68,7 +97,12 @@ export async function archive(client, input) {
     }, { schema: ArchiveRunsResultResponseSchema });
 }
 /**
- * Update run metadata by project and run number
+ * Update run metadata by project and run number. Supports post-hoc
+ * enrichment with analysis records and summaries.
+ *
+ * @param client - HTTP client instance
+ * @param input - Update payload with project + runNumber identifier
+ * @returns Updated run
  */
 export async function update(client, input) {
     return client.patch('/runs/update', {
@@ -87,31 +121,58 @@ export async function update(client, input) {
     }, { schema: RunResponseSchema });
 }
 /**
- * List runs for a project
+ * List runs for a project with optional filters.
+ *
+ * @param client - HTTP client instance
+ * @param projectId - Project ID or name
+ * @param query - Optional filters: workflowType, limit, offset
+ * @returns Array of run summaries
  */
 export async function listByProject(client, projectId, query) {
     return client.get(`/runs/project/${encodeURIComponent(projectId)}`, toApiQuery(query), { schema: z.array(RunSummaryResponseSchema) });
 }
 /**
- * Get the latest run for a project
+ * Get the most recent run for a project, optionally filtered by workflow type.
+ *
+ * @param client - HTTP client instance
+ * @param projectId - Project ID or name
+ * @param workflowType - Optional workflow type filter (e.g. 'post-implementation')
+ * @returns Latest run
+ * @throws {NotFoundError} If no runs exist for the project/workflow
  */
 export async function getLatest(client, projectId, workflowType) {
     return client.get(`/runs/project/${encodeURIComponent(projectId)}/latest`, workflowType ? toApiQuery({ workflowType }) : undefined, { schema: RunResponseSchema });
 }
 /**
- * Get full run details with recommendations
+ * Get full run details including agents, recommendations, and analysis data.
+ *
+ * @param client - HTTP client instance
+ * @param projectId - Project ID or name
+ * @param runNumber - Specific run number (omit for latest)
+ * @returns Run details with nested agents and recommendations arrays
  */
 export async function getDetails(client, projectId, runNumber) {
     return client.get(`/runs/project/${encodeURIComponent(projectId)}/details`, runNumber !== undefined ? toApiQuery({ runNumber }) : undefined, { schema: RunDetailsResponseSchema });
 }
 /**
- * Get a run by ID
+ * Get a run by its UUID.
+ *
+ * @param client - HTTP client instance
+ * @param runId - Run UUID
+ * @returns Run record
+ * @throws {NotFoundError} If run does not exist
  */
 export async function get(client, runId) {
     return client.get(`/runs/${encodeURIComponent(runId)}`, undefined, { schema: RunResponseSchema });
 }
 /**
- * Update a run by ID
+ * Update run metadata by UUID. Supports post-hoc enrichment with
+ * analysis records, summaries, and exploration maps.
+ *
+ * @param client - HTTP client instance
+ * @param runId - Run UUID
+ * @param input - Fields to update (all optional except identifier)
+ * @returns Updated run
  */
 export async function updateById(client, runId, input) {
     return client.patch(`/runs/${encodeURIComponent(runId)}`, {
@@ -128,7 +189,11 @@ export async function updateById(client, runId, input) {
     }, { schema: RunResponseSchema });
 }
 /**
- * Delete a run (requires confirmation header)
+ * Permanently delete a run. Requires the run ID as a confirmation header.
+ *
+ * @param client - HTTP client instance
+ * @param runId - Run UUID (also sent as X-Confirm-Delete header)
+ * @returns `{ deleted: true }` on success
  */
 export async function deleteRun(client, runId) {
     return client.request('DELETE', `/runs/${encodeURIComponent(runId)}`, undefined, {
@@ -140,26 +205,48 @@ export async function deleteRun(client, runId) {
 // Analysis Operations (v1.4.0)
 // ─────────────────────────────────────────────────────────────────
 /**
- * Get analysis records and summaries for a specific run
+ * Get structured analysis records and summaries for a specific run.
+ * Includes convention inventories, tension maps, decay vectors, exploration maps, etc.
+ *
+ * @param client - HTTP client instance
+ * @param runId - Run UUID
+ * @returns Analysis data with records and summaries arrays
  */
 export async function getAnalysis(client, runId) {
     return client.get(`/runs/${encodeURIComponent(runId)}/analysis`, undefined, { schema: RunAnalysisResponseSchema });
 }
 /**
- * Get analysis summaries for a project over time
+ * Get analysis summaries for a project over time. Filter by agent name,
+ * agent type, or decision to track specific analytical trajectories.
+ *
+ * @param client - HTTP client instance
+ * @param projectId - Project ID or name
+ * @param query - Optional filters: agentName, agentType, decision, limit, offset
+ * @returns Paginated analysis summaries with `{ data, total }`
  */
 export async function getProjectAnalysis(client, projectId, query) {
     return client.get(`/projects/${encodeURIComponent(projectId)}/analysis`, toApiQuery(query), { schema: ProjectAnalysisListResponseSchema });
 }
 /**
- * Query analysis records across projects with filters
+ * Query analysis records across projects. Filter by record type
+ * (convention, tension, decay_vector), classification, agent, or severity.
+ *
+ * @param client - HTTP client instance
+ * @param query - Optional filters: recordType, classification, agentName, severity, limit, offset
+ * @returns Paginated analysis records with `{ data, total }`
  */
 export async function queryAnalysisRecords(client, query) {
     return client.get('/analysis/records', toApiQuery(query), { schema: AnalysisRecordsListResponseSchema });
 }
 /**
  * Get analysis summaries with run context for a specific agent.
- * Returns the unwrapped data array (SDK auto-unwraps { data } envelope).
+ * Returns decision, score, category scores alongside run metadata
+ * (run number, timestamp, workflow type, snapshot score).
+ *
+ * @param client - HTTP client instance
+ * @param agentName - Agent name (e.g. 'epictetus-validator')
+ * @param query - Query with required `project`, optional `decision`, `limit`, `offset`
+ * @returns `{ items: AgentRunSummary[], total: number }`
  */
 export async function getAgentRunsAnalysis(client, agentName, query) {
     return client.get(`/agents/${encodeURIComponent(agentName)}/runs-analysis`, toApiQuery(query), { schema: AgentRunsAnalysisResponseSchema });

package/dist/operations/runs.js.map

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