@lightsage/mcp 0.3.1 → 0.4.0

package/src/models/updatev2evalconfigurationrequest.ts

@@ -4,6 +4,10 @@
  */
 
 import * as z from "zod";
+import {
+  SearchGroundingMode,
+  SearchGroundingMode$zodSchema,
+} from "./searchgroundingmode.js";
 
 export type UpdateV2EvalConfigurationRequest = {
   name?: string | undefined;
@@ -14,6 +18,7 @@ export type UpdateV2EvalConfigurationRequest = {
   skill_ids?: Array<string> | null | undefined;
   skills?: Array<string> | null | undefined;
   include_docs?: boolean | undefined;
+  search_grounding?: SearchGroundingMode | null | undefined;
 };
 
 export const UpdateV2EvalConfigurationRequest$zodSchema: z.ZodType<
@@ -25,6 +30,10 @@ export const UpdateV2EvalConfigurationRequest$zodSchema: z.ZodType<
   mcp_server_ids: z.array(z.string()).nullable().optional(),
   name: z.string().optional(),
   repository_id: z.string().optional(),
+  search_grounding: SearchGroundingMode$zodSchema.nullable().optional()
+    .describe(
+      "Replacement web-retrieval policy. Omit it to keep the saved value.",
+    ),
   skill_ids: z.array(z.string()).nullable().optional(),
   skills: z.array(z.string()).nullable().optional().describe(
     "Public skill packages saved with this configuration, using GitHub `owner/repository` references.",

package/src/models/updatev2evalrequest.ts

@@ -5,31 +5,18 @@
 
 import * as z from "zod";
 import {
-  V2InlineCliReference,
-  V2InlineCliReference$zodSchema,
-} from "./v2inlineclireference.js";
+  SearchGroundingMode,
+  SearchGroundingMode$zodSchema,
+} from "./searchgroundingmode.js";
 import {
   V2InlineMcpDefinition,
   V2InlineMcpDefinition$zodSchema,
 } from "./v2inlinemcpdefinition.js";
-import {
-  V2SavedCliReference,
-  V2SavedCliReference$zodSchema,
-} from "./v2savedclireference.js";
 import {
   V2SavedMcpReference,
   V2SavedMcpReference$zodSchema,
 } from "./v2savedmcpreference.js";
 
-export type UpdateV2EvalRequestCli = V2SavedCliReference | V2InlineCliReference;
-
-export const UpdateV2EvalRequestCli$zodSchema: z.ZodType<
-  UpdateV2EvalRequestCli
-> = z.union([
-  V2SavedCliReference$zodSchema,
-  V2InlineCliReference$zodSchema,
-]);
-
 export type UpdateV2EvalRequestMcp =
   | V2InlineMcpDefinition
   | V2SavedMcpReference;
@@ -47,8 +34,11 @@ export type UpdateV2EvalRequest = {
   judges?: Array<string> | null | undefined;
   agent?: Array<string> | null | undefined;
   persona?: string | undefined;
-  clis?: Array<V2SavedCliReference | V2InlineCliReference> | null | undefined;
+  clis?: Array<string> | null | undefined;
   mcps?: Array<V2InlineMcpDefinition | V2SavedMcpReference> | null | undefined;
+  setup_commands?: Array<string> | null | undefined;
+  cleanup_commands?: Array<string> | null | undefined;
+  search_grounding?: SearchGroundingMode | null | undefined;
   runs?: number | undefined;
   tags?: Array<string> | null | undefined;
 };
@@ -56,10 +46,12 @@ export type UpdateV2EvalRequest = {
 export const UpdateV2EvalRequest$zodSchema: z.ZodType<UpdateV2EvalRequest> = z
   .object({
     agent: z.array(z.string()).nullable().optional(),
-    clis: z.array(z.union([
-      V2SavedCliReference$zodSchema,
-      V2InlineCliReference$zodSchema,
-    ])).nullable().optional(),
+    cleanup_commands: z.array(z.string()).nullable().optional().describe(
+      "Replacement cleanup commands. Pass an empty array to clear all saved cleanup commands.",
+    ),
+    clis: z.array(z.string()).nullable().optional().describe(
+      "Replacement saved CLI IDs or shell installation commands. UUID values resolve saved CLIs; every other value is an installation command. Pass an empty array to clear all CLIs.",
+    ),
     judges: z.array(z.string()).nullable().optional().describe(
       "Replacement success criteria for the eval.",
     ),
@@ -73,6 +65,13 @@ export const UpdateV2EvalRequest$zodSchema: z.ZodType<UpdateV2EvalRequest> = z
     ),
     prompts: z.array(z.string()).nullable().optional(),
     runs: z.int().optional(),
+    search_grounding: SearchGroundingMode$zodSchema.nullable().optional()
+      .describe(
+        "Replacement web-retrieval policy. Omit it to keep the saved value.",
+      ),
+    setup_commands: z.array(z.string()).nullable().optional().describe(
+      "Replacement setup commands. Pass an empty array to clear all saved setup commands.",
+    ),
     tags: z.array(z.string()).nullable().optional().describe(
       "Replacement labels for the eval. Pass an empty array to clear all tags.",
     ),

package/src/models/v2eval.ts

@@ -4,6 +4,10 @@
  */
 
 import * as z from "zod";
+import {
+  SearchGroundingMode,
+  SearchGroundingMode$zodSchema,
+} from "./searchgroundingmode.js";
 import {
   V2InlineCliReference,
   V2InlineCliReference$zodSchema,
@@ -21,9 +25,9 @@ import {
   V2SavedMcpReference$zodSchema,
 } from "./v2savedmcpreference.js";
 
-export type V2EvalCli = V2SavedCliReference | V2InlineCliReference;
+export type Cli = V2SavedCliReference | V2InlineCliReference;
 
-export const V2EvalCli$zodSchema: z.ZodType<V2EvalCli> = z.union([
+export const Cli$zodSchema: z.ZodType<Cli> = z.union([
   V2SavedCliReference$zodSchema,
   V2InlineCliReference$zodSchema,
 ]);
@@ -44,6 +48,9 @@ export type V2Eval = {
   persona?: string | null | undefined;
   clis?: Array<V2SavedCliReference | V2InlineCliReference> | undefined;
   mcps?: Array<V2InlineMcpDefinition | V2SavedMcpReference> | undefined;
+  setup_commands?: Array<string> | undefined;
+  cleanup_commands?: Array<string> | undefined;
+  search_grounding?: SearchGroundingMode | undefined;
   runs?: number | undefined;
   tags?: Array<string> | undefined;
   created_at?: string | null | undefined;
@@ -52,6 +59,7 @@ export type V2Eval = {
 
 export const V2Eval$zodSchema: z.ZodType<V2Eval> = z.object({
   agent: z.array(z.string()).optional(),
+  cleanup_commands: z.array(z.string()).optional(),
   clis: z.array(z.union([
     V2SavedCliReference$zodSchema,
     V2InlineCliReference$zodSchema,
@@ -67,6 +75,10 @@ export const V2Eval$zodSchema: z.ZodType<V2Eval> = z.object({
   persona: z.string().nullable().optional(),
   prompts: z.array(z.string()).optional(),
   runs: z.int().default(1),
+  search_grounding: SearchGroundingMode$zodSchema.optional().describe(
+    "Requested web-retrieval behavior for an eval run.",
+  ),
+  setup_commands: z.array(z.string()).optional(),
   tags: z.array(z.string()).optional(),
   updated_at: z.string().nullable().optional(),
 });

package/src/models/v2evalconfiguration.ts

@@ -4,6 +4,10 @@
  */
 
 import * as z from "zod";
+import {
+  SearchGroundingMode,
+  SearchGroundingMode$zodSchema,
+} from "./searchgroundingmode.js";
 
 export type V2EvalConfiguration = {
   id: string;
@@ -16,6 +20,7 @@ export type V2EvalConfiguration = {
   skill_ids?: Array<string> | undefined;
   skills?: Array<string> | undefined;
   include_docs?: boolean | undefined;
+  search_grounding?: SearchGroundingMode | undefined;
   created_at?: string | null | undefined;
   updated_at?: string | null | undefined;
 };
@@ -31,6 +36,9 @@ export const V2EvalConfiguration$zodSchema: z.ZodType<V2EvalConfiguration> = z
     mcp_server_ids: z.array(z.string()).optional(),
     name: z.string(),
     repository_id: z.string().nullable().optional(),
+    search_grounding: SearchGroundingMode$zodSchema.optional().describe(
+      "Requested web-retrieval behavior for an eval run.",
+    ),
     skill_ids: z.array(z.string()).optional(),
     skills: z.array(z.string()).optional().describe(
       "Public GitHub `owner/repository` skill packages installed for this configuration.",

package/src/models/v2evalresultsummary.ts

@@ -4,6 +4,18 @@
  */
 
 import * as z from "zod";
+import {
+  PublicEvalRunEnvironment,
+  PublicEvalRunEnvironment$zodSchema,
+} from "./publicevalrunenvironment.js";
+import {
+  PublicGraderResult,
+  PublicGraderResult$zodSchema,
+} from "./publicgraderresult.js";
+import {
+  SearchGroundingMode,
+  SearchGroundingMode$zodSchema,
+} from "./searchgroundingmode.js";
 
 export type V2EvalResultSummary = {
   id: string;
@@ -15,8 +27,15 @@ export type V2EvalResultSummary = {
   passed?: boolean | null | undefined;
   score?: number | null | undefined;
   failure_reasons?: Array<string> | null | undefined;
+  grader_results?: Array<PublicGraderResult> | undefined;
   latency_ms?: number | null | undefined;
+  search_grounding?: SearchGroundingMode | null | undefined;
+  web_retrieval_observed?: boolean | null | undefined;
+  search_observed?: boolean | null | undefined;
+  grounding_qualified?: boolean | null | undefined;
+  grounding_qualification_reason?: string | null | undefined;
   created_at?: string | null | undefined;
+  environment?: PublicEvalRunEnvironment | null | undefined;
 };
 
 export const V2EvalResultSummary$zodSchema: z.ZodType<V2EvalResultSummary> = z
@@ -25,8 +44,21 @@ export const V2EvalResultSummary$zodSchema: z.ZodType<V2EvalResultSummary> = z
       "Runnable agent combining the harness and model.",
     ),
     created_at: z.string().nullable().optional(),
+    environment: PublicEvalRunEnvironment$zodSchema.nullable().optional()
+      .describe(
+        "The environment this attempt used, without secret values. Null when the attempt had no environment.",
+      ),
     eval_id: z.string().nullable().optional(),
-    failure_reasons: z.array(z.string()).nullable().optional(),
+    failure_reasons: z.array(z.string()).nullable().optional().describe(
+      "Checks that failed, listed even when the result passed overall. Deductions from checks that passed are in `grader_results[].deductions`, not here.",
+    ),
+    grader_results: z.array(PublicGraderResult$zodSchema).optional().describe(
+      "Per-check verdicts behind `score`, including deductions recorded by passing checks.",
+    ),
+    grounding_qualification_reason: z.string().nullable().optional(),
+    grounding_qualified: z.boolean().nullable().optional().describe(
+      "Whether the attempt satisfied the requested grounding experiment. Null means the default mode was used or isolation could not be proven.",
+    ),
     id: z.string().describe("Result ID, not an eval job ID."),
     latency_ms: z.int().nullable().optional(),
     passed: z.boolean().nullable().optional(),
@@ -34,4 +66,7 @@ export const V2EvalResultSummary$zodSchema: z.ZodType<V2EvalResultSummary> = z
     prompt_index: z.int().default(0),
     repeat_index: z.int().default(0),
     score: z.number().nullable().optional().describe("Score from 0 to 1."),
+    search_grounding: SearchGroundingMode$zodSchema.nullable().optional(),
+    search_observed: z.boolean().nullable().optional(),
+    web_retrieval_observed: z.boolean().nullable().optional(),
   });

package/src/models/v2evalrun.ts

@@ -64,5 +64,7 @@ export const V2EvalRun$zodSchema: z.ZodType<V2EvalRun> = z.object({
   ),
   stage: z.string().nullable().optional(),
   started_at: z.string().nullable().optional(),
-  status: z.string(),
+  status: z.string().describe(
+    "Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`.",
+  ),
 });

package/src/models/v2evalrundetail.ts

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a4eb73f4b2a9
+ */
+
+import * as z from "zod";
+import {
+  PublicEvalRunProgress,
+  PublicEvalRunProgress$zodSchema,
+} from "./publicevalrunprogress.js";
+import {
+  V2EvalResultSummary,
+  V2EvalResultSummary$zodSchema,
+} from "./v2evalresultsummary.js";
+import {
+  V2EvalRunAnalysis,
+  V2EvalRunAnalysis$zodSchema,
+} from "./v2evalrunanalysis.js";
+
+export type V2EvalRunDetail = {
+  id: string;
+  job_id: string;
+  eval_id?: string | null | undefined;
+  eval_name?: string | null | undefined;
+  configuration_id?: string | null | undefined;
+  persona?: string | null | undefined;
+  agent?: Array<string> | undefined;
+  prompt_count?: number | undefined;
+  runs?: number | undefined;
+  attempt_count?: number | undefined;
+  status: string;
+  stage?: string | null | undefined;
+  dispatch_id?: string | null | undefined;
+  progress?: PublicEvalRunProgress | undefined;
+  estimated_cost?: number | null | undefined;
+  error?: string | null | undefined;
+  created_at?: string | null | undefined;
+  started_at?: string | null | undefined;
+  completed_at?: string | null | undefined;
+  results?: Array<V2EvalResultSummary> | undefined;
+  analysis?: Array<V2EvalRunAnalysis> | undefined;
+  results_truncated?: boolean | undefined;
+};
+
+export const V2EvalRunDetail$zodSchema: z.ZodType<V2EvalRunDetail> = z.object({
+  agent: z.array(z.string()).optional().describe(
+    "Runnable agents selected for this simulation.",
+  ),
+  analysis: z.array(V2EvalRunAnalysis$zodSchema).optional().describe(
+    "Per-attempt analysis for this run. Empty until an attempt has been analyzed.",
+  ),
+  attempt_count: z.int().default(1).describe(
+    "Total concrete attempts after all fan-out dimensions.",
+  ),
+  completed_at: z.string().nullable().optional(),
+  configuration_id: z.string().nullable().optional(),
+  created_at: z.string().nullable().optional(),
+  dispatch_id: z.string().nullable().optional(),
+  error: z.string().nullable().optional(),
+  estimated_cost: z.number().nullable().optional(),
+  eval_id: z.string().nullable().optional().describe(
+    "Saved eval definition ID, including one created by a direct run.",
+  ),
+  eval_name: z.string().nullable().optional().describe(
+    "Display name captured for the eval when the run was created.",
+  ),
+  id: z.string().describe("Run ID to use when polling eval-run status."),
+  job_id: z.string().describe("Alias of `id` for the durable parent job."),
+  persona: z.string().nullable().optional().describe(
+    "Perspective applied to every attempt in this simulation.",
+  ),
+  progress: PublicEvalRunProgress$zodSchema.optional(),
+  prompt_count: z.int().default(1).describe(
+    "Number of prompts included in the simulation.",
+  ),
+  results: z.array(V2EvalResultSummary$zodSchema).optional().describe(
+    "Per-attempt outcomes for this run. Empty while the run is active; populated as attempts finish.",
+  ),
+  results_truncated: z.boolean().default(false).describe(
+    "True when the run produced more results than the inline cap. The remaining results are not included in this response.",
+  ),
+  runs: z.int().default(1).describe(
+    "Independent attempts requested for every prompt-agent pair.",
+  ),
+  stage: z.string().nullable().optional(),
+  started_at: z.string().nullable().optional(),
+  status: z.string().describe(
+    "Terminal values: `completed`, `failed`, and `cancelled`. Recoverable interruptions are reported as `running` with stage `retrying`.",
+  ),
+});

package/src/models/v2evalrunscancelop.ts

@@ -0,0 +1,70 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 15553511dcfe
+ */
+
+import * as z from "zod";
+import {
+  HTTPValidationError,
+  HTTPValidationError$zodSchema,
+} from "./httpvalidationerror.js";
+import { V2EvalRun, V2EvalRun$zodSchema } from "./v2evalrun.js";
+
+export type V2EvalRunsCancelRequest = { run_id: string };
+
+export const V2EvalRunsCancelRequest$zodSchema: z.ZodType<
+  V2EvalRunsCancelRequest
+> = z.object({
+  run_id: z.string(),
+});
+
+/**
+ * Eval run cancellation is temporarily unavailable.
+ */
+export type V2EvalRunsCancelServiceUnavailableResponseBody = { detail: string };
+
+export const V2EvalRunsCancelServiceUnavailableResponseBody$zodSchema:
+  z.ZodType<V2EvalRunsCancelServiceUnavailableResponseBody> = z.object({
+    detail: z.string(),
+  }).describe("Eval run cancellation is temporarily unavailable.");
+
+/**
+ * The eval run has already completed or failed.
+ */
+export type V2EvalRunsCancelConflictResponseBody = { detail: string };
+
+export const V2EvalRunsCancelConflictResponseBody$zodSchema: z.ZodType<
+  V2EvalRunsCancelConflictResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe("The eval run has already completed or failed.");
+
+/**
+ * Eval run not found. Use the run ID returned when you started the eval.
+ */
+export type V2EvalRunsCancelNotFoundResponseBody = { detail: string };
+
+export const V2EvalRunsCancelNotFoundResponseBody$zodSchema: z.ZodType<
+  V2EvalRunsCancelNotFoundResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe(
+  "Eval run not found. Use the run ID returned when you started the eval.",
+);
+
+export type V2EvalRunsCancelResponse =
+  | V2EvalRun
+  | V2EvalRunsCancelNotFoundResponseBody
+  | V2EvalRunsCancelConflictResponseBody
+  | V2EvalRunsCancelServiceUnavailableResponseBody
+  | HTTPValidationError;
+
+export const V2EvalRunsCancelResponse$zodSchema: z.ZodType<
+  V2EvalRunsCancelResponse
+> = z.union([
+  V2EvalRun$zodSchema,
+  z.lazy(() => V2EvalRunsCancelNotFoundResponseBody$zodSchema),
+  z.lazy(() => V2EvalRunsCancelConflictResponseBody$zodSchema),
+  z.lazy(() => V2EvalRunsCancelServiceUnavailableResponseBody$zodSchema),
+  HTTPValidationError$zodSchema,
+]);

package/src/models/v2evalrunscreateop.ts

@@ -13,25 +13,63 @@ import { V2EvalRun, V2EvalRun$zodSchema } from "./v2evalrun.js";
 /**
  * The requested coding agent is unavailable on the organization's current plan.
  */
-export type V2EvalRunsCreateResponseBody = { detail: string };
+export type V2EvalRunsCreateForbiddenResponseBody = { detail: string };
 
-export const V2EvalRunsCreateResponseBody$zodSchema: z.ZodType<
-  V2EvalRunsCreateResponseBody
+export const V2EvalRunsCreateForbiddenResponseBody$zodSchema: z.ZodType<
+  V2EvalRunsCreateForbiddenResponseBody
 > = z.object({
   detail: z.string(),
 }).describe(
   "The requested coding agent is unavailable on the organization's current plan.",
 );
 
+export type Detail = { error: string; required: number; balance: number };
+
+export const Detail$zodSchema: z.ZodType<Detail> = z.object({
+  balance: z.number().describe("The organization's current credit balance."),
+  error: z.string(),
+  required: z.number().describe("Usage-based credits the requested run needs."),
+});
+
+/**
+ * The organization does not currently have enough credits for the requested run.
+ */
+export type V2EvalRunsCreatePaymentRequiredResponseBody = { detail: Detail };
+
+export const V2EvalRunsCreatePaymentRequiredResponseBody$zodSchema: z.ZodType<
+  V2EvalRunsCreatePaymentRequiredResponseBody
+> = z.object({
+  detail: z.lazy(() => Detail$zodSchema),
+}).describe(
+  "The organization does not currently have enough credits for the requested run.",
+);
+
+/**
+ * The saved/direct mode fields, referenced resource, or environment credentials are invalid.
+ */
+export type V2EvalRunsCreateBadRequestResponseBody = { detail: string };
+
+export const V2EvalRunsCreateBadRequestResponseBody$zodSchema: z.ZodType<
+  V2EvalRunsCreateBadRequestResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe(
+  "The saved/direct mode fields, referenced resource, or environment credentials are invalid.",
+);
+
 export type V2EvalRunsCreateResponse =
   | V2EvalRun
-  | V2EvalRunsCreateResponseBody
+  | V2EvalRunsCreateBadRequestResponseBody
+  | V2EvalRunsCreatePaymentRequiredResponseBody
+  | V2EvalRunsCreateForbiddenResponseBody
   | HTTPValidationError;
 
 export const V2EvalRunsCreateResponse$zodSchema: z.ZodType<
   V2EvalRunsCreateResponse
 > = z.union([
   V2EvalRun$zodSchema,
-  z.lazy(() => V2EvalRunsCreateResponseBody$zodSchema),
+  z.lazy(() => V2EvalRunsCreateBadRequestResponseBody$zodSchema),
+  z.lazy(() => V2EvalRunsCreatePaymentRequiredResponseBody$zodSchema),
+  z.lazy(() => V2EvalRunsCreateForbiddenResponseBody$zodSchema),
   HTTPValidationError$zodSchema,
 ]);

package/src/models/v2evalrunsretrieveop.ts

@@ -8,7 +8,10 @@ import {
   HTTPValidationError,
   HTTPValidationError$zodSchema,
 } from "./httpvalidationerror.js";
-import { V2EvalRun, V2EvalRun$zodSchema } from "./v2evalrun.js";
+import {
+  V2EvalRunDetail,
+  V2EvalRunDetail$zodSchema,
+} from "./v2evalrundetail.js";
 
 export type V2EvalRunsRetrieveRequest = { run_id: string };
 
@@ -18,11 +21,28 @@ export const V2EvalRunsRetrieveRequest$zodSchema: z.ZodType<
   run_id: z.string(),
 });
 
-export type V2EvalRunsRetrieveResponse = V2EvalRun | HTTPValidationError;
+/**
+ * Eval run not found. Use the run ID returned when you started the eval.
+ */
+export type V2EvalRunsRetrieveResponseBody = { detail: string };
+
+export const V2EvalRunsRetrieveResponseBody$zodSchema: z.ZodType<
+  V2EvalRunsRetrieveResponseBody
+> = z.object({
+  detail: z.string(),
+}).describe(
+  "Eval run not found. Use the run ID returned when you started the eval.",
+);
+
+export type V2EvalRunsRetrieveResponse =
+  | V2EvalRunDetail
+  | V2EvalRunsRetrieveResponseBody
+  | HTTPValidationError;
 
 export const V2EvalRunsRetrieveResponse$zodSchema: z.ZodType<
   V2EvalRunsRetrieveResponse
 > = z.union([
-  V2EvalRun$zodSchema,
+  V2EvalRunDetail$zodSchema,
+  z.lazy(() => V2EvalRunsRetrieveResponseBody$zodSchema),
   HTTPValidationError$zodSchema,
 ]);

package/src/models/v2evalruntraceevent.ts

@@ -41,5 +41,7 @@ export const V2EvalRunTraceEvent$zodSchema: z.ZodType<V2EvalRunTraceEvent> = z
     repeat_index: z.int().default(0),
     run_id: z.string(),
     timestamp: z.string().nullable().optional(),
-    type: z.string(),
+    type: z.string().describe(
+      "Event type. Events are not tool invocations: one invocation usually emits a `tool_call` event and a `tool_result` event, and can emit extra `tool_call` updates as its arguments stream. Count invocations with the result's `tool_calls`, not with trace events.",
+    ),
   });

package/src/models/v2promptrundetail.ts

@@ -52,12 +52,18 @@ export type V2PromptRunDetail = {
   response?: string | null | undefined;
   mentions?: Array<V2PromptRunMention> | undefined;
   citations?: Array<V2PromptRunCitation> | undefined;
+  tool_calls?: Array<{ [k: string]: any }> | undefined;
+  conversation_turns?: Array<{ [k: string]: any }> | undefined;
 };
 
 export const V2PromptRunDetail$zodSchema: z.ZodType<V2PromptRunDetail> = z
   .object({
     citation_count: z.int().default(0),
     citations: z.array(V2PromptRunCitation$zodSchema).optional(),
+    conversation_turns: z.array(z.record(z.string(), z.any())).optional()
+      .describe(
+        "Sanitized interleaved text and tool-call trace captured for this run. It interleaves the agent's `text` turns with `tool_call` turns, so its length is not a tool-call count; use `tool_calls` or `tool_call_count`.",
+      ),
     created_at: z.string().nullable().optional(),
     harness: z.string().nullable().optional().describe(
       "Coding-agent harness for agent runs; otherwise the answer platform identifier.",
@@ -75,5 +81,10 @@ export const V2PromptRunDetail$zodSchema: z.ZodType<V2PromptRunDetail> = z
     response_preview: z.string().nullable().optional(),
     run_date: z.string(),
     target_kind: V2PromptRunDetailTargetKind$zodSchema.nullable().optional(),
-    tool_call_count: z.int().nullable().optional(),
+    tool_call_count: z.int().nullable().optional().describe(
+      "Coding-agent tool invocations, counting a call and its result once. Matches the length of `tool_calls` on the detail response; null for answer-engine runs.",
+    ),
+    tool_calls: z.array(z.record(z.string(), z.any())).optional().describe(
+      "Sanitized coding-agent tool invocations captured for this run, one entry per invocation with its result merged in.",
+    ),
   });

package/src/models/v2promptrunsummary.ts

@@ -61,5 +61,7 @@ export const V2PromptRunSummary$zodSchema: z.ZodType<V2PromptRunSummary> = z
     response_preview: z.string().nullable().optional(),
     run_date: z.string(),
     target_kind: V2PromptRunSummaryTargetKind$zodSchema.nullable().optional(),
-    tool_call_count: z.int().nullable().optional(),
+    tool_call_count: z.int().nullable().optional().describe(
+      "Coding-agent tool invocations, counting a call and its result once. Matches the length of `tool_calls` on the detail response; null for answer-engine runs.",
+    ),
   });

package/src/models/v2publictask.ts

@@ -20,7 +20,7 @@ export type V2PublicTask = {
   execution_prompt: string;
   reasoning?: string | null | undefined;
   evidence?: { [k: string]: any } | undefined;
-  score: number;
+  score?: number | null | undefined;
   effort: string;
   priority?: string | null | undefined;
   status: string;
@@ -28,7 +28,7 @@ export type V2PublicTask = {
   function_area?: string | null | undefined;
   action_type?: string | null | undefined;
   source?: string | null | undefined;
-  source_type: string;
+  source_type?: string | null | undefined;
   source_refs?: { [k: string]: any } | undefined;
   metadata?: { [k: string]: any } | undefined;
   created_at?: string | null | undefined;
@@ -63,7 +63,9 @@ export const V2PublicTask$zodSchema: z.ZodType<V2PublicTask> =
         "Sort order within the batch, ascending; values need not start at 1.",
       ),
       reasoning: z.string().nullable().optional(),
-      score: z.number(),
+      score: z.number().nullable().optional().describe(
+        "Planner impact score; manually created tasks may be unscored.",
+      ),
       source: z.string().nullable().optional(),
       source_key: z.string().describe(
         "A finding key namespaced by source, such as `api_perf:https://example.com/docs/cli`.",
@@ -71,8 +73,8 @@ export const V2PublicTask$zodSchema: z.ZodType<V2PublicTask> =
       source_refs: z.record(z.string(), z.any()).optional().describe(
         "Source references needed to understand or execute the task.",
       ),
-      source_type: z.string().describe(
-        "A free-form source type such as `api_performance`; this field is not an enum.",
+      source_type: z.string().nullable().optional().describe(
+        "A free-form source type such as `api_performance`; manually created tasks may not have a source.",
       ),
       status: z.string().describe(
         "The workflow status. New tasks start as `new`; `added_to_sheet` and `snoozed` tasks are listed only when `status=all`.",
@@ -106,11 +108,11 @@ export const V2PublicTask$zodSchemaOutbound: z.ZodType<any> = z.object({
   priority: z.nullable(z.string()).optional(),
   rank: z.int(),
   reasoning: z.nullable(z.string()).optional(),
-  score: z.number(),
+  score: z.nullable(z.number()).optional(),
   source: z.nullable(z.string()).optional(),
   source_key: z.string(),
   source_refs: z.record(z.string(), z.any()).optional(),
-  source_type: z.string(),
+  source_type: z.nullable(z.string()).optional(),
   status: z.string(),
   task_type: z.string(),
   title: z.string(),